Interface: ParamDef<T>¶
The definition of a formula parameter.
Extended by¶
Type Parameters¶
| Type Parameter |
|---|
T extends UnionType |
Properties¶
autocomplete?¶
optionalautocomplete:MetadataFormula
A MetadataFormula that returns valid values for this parameter, optionally matching a search query. This can be useful both if there are a fixed number of valid values for the parameter, or if the valid values from the parameter can be looked up from some API. Use makeMetadataFormula to wrap a function that implements your autocomplete logic. Typically once you have fetched the list of matching values, you'll use autocompleteSearchObjects to handle searching over those values. If you have a hardcoded list of valid values, you would only need to use makeSimpleAutocompleteMetadataFormula.
crawlStrategy?¶
optionalcrawlStrategy:CrawlStrategy
Enables crawling for this parameter, where its values are populated from the results of another sync table. Crawling can simplify the user setup when a sync table has a required parameter that can be sourced from another sync.
Crawling is only implemented for sync tables and only during indexing in Superhuman Go.
Example¶
makeParameter({
type: ParameterType.String,
name: "project",
description: "The ID of the project containing the tasks."",
// Use the project IDs that come from the ID column in the Projects table.
crawlStrategy: {
parentTable: {
tableName: "Projects",
propertyKey: "id",
},
},
}),
See¶
defaultValue?¶
optionaldefaultValue:SuggestedValueType<T>
Deprecated¶
This will be removed in a future version of the SDK. Use ParamDef.suggestedValue instead.
description¶
description:
string
A brief description of what this parameter is used for, shown to the user when invoking the formula.
ingestionSuggestedValue?¶
optionalingestionSuggestedValue:SuggestedValueType<T>
The suggested value to be prepopulated for this parameter when used in an ingestion (sync table indexing). This value overrides ParamDef.suggestedValue if set.
Useful in situations where the existing suggested value is used to scope down the synced data to what would fit within Superhuman Docs's row limits, but during indexing you'd want to include a larger scope of data.
instructions?¶
optionalinstructions:string
Instructions for LLMs on how to use this parameter, overrides the description for LLMs if set.
name¶
name:
string
The name of the parameter, which will be shown to the user when invoking this formula.
optional?¶
optionaloptional:boolean
Whether this parameter can be omitted when invoking the formula. All optional parameters must come after all non-optional parameters.
suggestedValue?¶
optionalsuggestedValue:SuggestedValueType<T>
The suggested value to be prepopulated for this parameter if it is not specified by the user.
supportsIncrementalSync?¶
optionalsupportsIncrementalSync:boolean
Whether this parameter is compatible with incremental sync. If not, it will be hidden from the Superhuman Go setup UI.
type¶
type:
T
The data type of this parameter (string, number, etc).