Enrichment Tables / TypeScript SDK
Execute external table cells
Execute configured AI Generation or Prospector cells with your native external-agent research and reasoning. begin claims up to 100 rows and returns resolved prompts, typed outputs and a 15-minute token. complete validates and commits all results with normal cell states and actual agent attribution; fail records a real error. No hosted inference, cascade, provider impersonation or sends. Use this instead of raw row writes for enrichment execution. Resume with the saved claim token; completed identical submissions replay safely.
pipeline.executeExternalTableCellsDeterministic operationParameters
workspaceIdOptional · string- See the input schema for this field.
tableIdRequired · string- See the input schema for this field.
columnIdRequired · string- See the input schema for this field.
operationRequired · string- See the input schema for this field.begin · complete · fail
rowIdsOptional · array- See the input schema for this field.
idempotencyKeyOptional · string- See the input schema for this field.
agentOptional · string- See the input schema for this field.Codex · Claude Code · External agent
runIdOptional · string- See the input schema for this field.
claimTokenOptional · string- See the input schema for this field.
resultsOptional · array- See the input schema for this field.
errorOptional · string- See the input schema for this field.
await pipeline.executeExternalTableCells({
"tableId": "00000000-0000-4000-8000-000000000000",
"columnId": "00000000-0000-4000-8000-000000000000",
"operation": "begin",
"rowIds": [
"00000000-0000-4000-8000-000000000000"
],
"idempotencyKey": "example"
})Full input schema
{
"type": "object",
"properties": {
"workspaceId": {
"type": "string",
"minLength": 1
},
"tableId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"columnId": {
"type": "string",
"minLength": 1
},
"operation": {
"type": "string",
"enum": [
"begin",
"complete",
"fail"
]
},
"rowIds": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"agent": {
"type": "string",
"enum": [
"Codex",
"Claude Code",
"External agent"
]
},
"runId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"claimToken": {
"type": "string",
"minLength": 1
},
"results": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"rowId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"output": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"sources": {
"default": [],
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
}
},
"required": [
"rowId",
"output"
],
"additionalProperties": false
}
},
"error": {
"type": "string",
"minLength": 1,
"maxLength": 1000
}
},
"required": [
"tableId",
"columnId",
"operation"
],
"additionalProperties": false,
"oneOf": [
{
"type": "object",
"properties": {
"tableId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"columnId": {
"type": "string",
"minLength": 1
},
"operation": {
"type": "string",
"const": "begin"
},
"rowIds": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"agent": {
"default": "Codex",
"type": "string",
"enum": [
"Codex",
"Claude Code",
"External agent"
]
},
"workspaceId": {
"type": "string",
"minLength": 1
}
},
"required": [
"tableId",
"columnId",
"operation",
"rowIds",
"idempotencyKey"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"tableId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"columnId": {
"type": "string",
"minLength": 1
},
"operation": {
"type": "string",
"const": "complete"
},
"runId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"claimToken": {
"type": "string",
"minLength": 1
},
"results": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"rowId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"output": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"sources": {
"default": [],
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
}
},
"required": [
"rowId",
"output"
],
"additionalProperties": false
}
},
"workspaceId": {
"type": "string",
"minLength": 1
}
},
"required": [
"tableId",
"columnId",
"operation",
"runId",
"claimToken",
"results"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"tableId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"columnId": {
"type": "string",
"minLength": 1
},
"operation": {
"type": "string",
"const": "fail"
},
"runId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"claimToken": {
"type": "string",
"minLength": 1
},
"error": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"workspaceId": {
"type": "string",
"minLength": 1
}
},
"required": [
"tableId",
"columnId",
"operation",
"runId",
"claimToken",
"error"
],
"additionalProperties": false
}
]
}