@takeshape/schema 11.85.2 → 11.87.0

package/dist/migration/types.d.ts

@@ -1,4 +1,4 @@
-import type { AgentJSON, FormConfig, GuardJSON, ProjectSchemaJSON, QueryJSON, ServiceConfigJSON, ShapeJSON, Workflow } from '../project-schema/index.ts';
+import type { AgentJSON, FormConfig, GuardJSON, ProjectSchemaJSON, QueryJSON, ServiceConfigJSON, ShapeJSON, ToolJSON, Workflow } from '../project-schema/index.ts';
 import type { EncryptFn, SafeDecryptFn } from '../services/types.ts';
 export type ProjectSchemaMigrationContext = {
     generateDataKeyFn: () => Promise<string>;
@@ -11,6 +11,7 @@ export type ProjectSchemaUpdate = {
     shapes?: Record<string, ShapeJSON | null>;
     'ai-experimental.agents'?: Record<string, AgentJSON | null>;
     'ai-experimental.guards'?: Record<string, GuardJSON | null>;
+    'ai-experimental.tools'?: Record<string, ToolJSON | null>;
     forms?: Record<string, FormConfig | null>;
     workflows?: Record<string, Workflow | null>;
     services?: Record<string, ServiceConfigJSON | null>;

package/dist/project-schema/latest.d.ts

@@ -293,7 +293,19 @@ export type InteractionTimeoutMilliseconds1 = number;
 export type Variables = AgentVariable[];
 export type AgentExecution = AgentExecutionGraphQL | AgentExecutionGenerate | AgentExecutionChat;
 export type AgentAIStateInput = AgentAIStateInputArgument | AgentAIStateInputTemplate;
-export type AgentToolConfigArg = AgentToolConfigArgAgent | AgentToolConfigArgVariable;
+export type AgentToolConfigArg = AgentControlled | VariableValue;
+/**
+ * The argument name that will be exposed by the tool for the LLM to use.
+ */
+export type ToolArgumentName = string;
+/**
+ * Name of argument to pass value to. This prevents the LLM from setting the argument.
+ */
+export type ToolArgumentName1 = string;
+/**
+ * Name of variable to pull value from.
+ */
+export type StateVariableName = string;
 export type History1 = boolean;
 /**
  * Maximum number of tokens to generate. Defaults to 1024
@@ -454,6 +466,7 @@ export type Filter1 = {
     type: Type;
     threshold: Threshold;
 }[];
+export type ToolArg = AgentControlled;
 /**
  * Human-readable id for use in the UI
  */
@@ -1840,33 +1853,20 @@ export interface AgentAIStateInputTemplate {
     type: 'template';
     inputTemplate: string;
 }
-/**
- * This interface was referenced by `ToolMap`'s JSON-Schema definition
- * via the `patternProperty` "^[0-9A-Za-z_]+$".
- */
 export interface AgentToolConfig {
     ref: string;
     description?: string;
     args?: AgentToolConfigArg[];
     selectionSet?: string;
 }
-export interface AgentToolConfigArgAgent {
+export interface AgentControlled {
     type: 'agent';
-    /**
-     * The argument name that will be exposed by the tool for the LLM to use.
-     */
-    argName: string;
+    argName: ToolArgumentName;
 }
-export interface AgentToolConfigArgVariable {
+export interface VariableValue {
     type: 'variable';
-    /**
-     * Name of argument to pass value to. This prevents the LLM from setting the argument.
-     */
-    argName: string;
-    /**
-     * Name of variable to pull value from.
-     */
-    variableName: string;
+    argName: ToolArgumentName1;
+    variableName: StateVariableName;
 }
 export interface AgentGenerateOptions {
     history?: History1;
@@ -1986,7 +1986,17 @@ export interface ContextualGroundingPolicy {
     filtersConfig: Filter1;
 }
 export interface ToolMap {
-    [k: string]: AgentToolConfig;
+    [k: string]: ToolJSON;
+}
+/**
+ * This interface was referenced by `ToolMap`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface ToolJSON {
+    ref: string;
+    description?: string;
+    args?: ToolArg[];
+    selectionSet?: string;
 }
 /**
  * This interface was referenced by `ProjectSchemaJSON`'s JSON-Schema

package/dist/project-schema/v3.48.0.d.ts

@@ -268,7 +268,19 @@ export type InteractionTimeoutMillisecondsV3_48_01 = number;
 export type VariablesV3_48_0 = AgentVariableV3_48_0[];
 export type AgentExecutionV3_48_0 = AgentExecutionGraphQLV3_48_0 | AgentExecutionGenerateV3_48_0 | AgentExecutionChatV3_48_0;
 export type AgentAIStateInputV3_48_0 = AgentAIStateInputArgumentV3_48_0 | AgentAIStateInputTemplateV3_48_0;
-export type AgentToolConfigArgV3_48_0 = AgentToolConfigArgAgentV3_48_0 | AgentToolConfigArgVariableV3_48_0;
+export type AgentToolConfigArgV3_48_0 = AgentControlledV3_48_0 | VariableValueV3_48_0;
+/**
+ * The argument name that will be exposed by the tool for the LLM to use.
+ */
+export type ToolArgumentNameV3_48_0 = string;
+/**
+ * Name of argument to pass value to. This prevents the LLM from setting the argument.
+ */
+export type ToolArgumentNameV3_48_01 = string;
+/**
+ * Name of variable to pull value from.
+ */
+export type StateVariableNameV3_48_0 = string;
 export type HistoryV3_48_01 = boolean;
 /**
  * Maximum number of tokens to generate. Defaults to 1024
@@ -429,6 +441,7 @@ export type FilterV3_48_01 = {
     type: TypeV3_48_0;
     threshold: ThresholdV3_48_0;
 }[];
+export type ToolArgV3_48_0 = AgentControlledV3_48_0;
 /**
  * Human-readable id for use in the UI
  */
@@ -1688,33 +1701,20 @@ export interface AgentAIStateInputTemplateV3_48_0 {
     type: 'template';
     inputTemplate: string;
 }
-/**
- * This interface was referenced by `ToolMapV3_48_0`'s JSON-Schema definition
- * via the `patternProperty` "^[0-9A-Za-z_]+$".
- */
 export interface AgentToolConfigV3_48_0 {
     ref: string;
     description?: string;
     args?: AgentToolConfigArgV3_48_0[];
     selectionSet?: string;
 }
-export interface AgentToolConfigArgAgentV3_48_0 {
+export interface AgentControlledV3_48_0 {
     type: 'agent';
-    /**
-     * The argument name that will be exposed by the tool for the LLM to use.
-     */
-    argName: string;
+    argName: ToolArgumentNameV3_48_0;
 }
-export interface AgentToolConfigArgVariableV3_48_0 {
+export interface VariableValueV3_48_0 {
     type: 'variable';
-    /**
-     * Name of argument to pass value to. This prevents the LLM from setting the argument.
-     */
-    argName: string;
-    /**
-     * Name of variable to pull value from.
-     */
-    variableName: string;
+    argName: ToolArgumentNameV3_48_01;
+    variableName: StateVariableNameV3_48_0;
 }
 export interface AgentGenerateOptionsV3_48_0 {
     history?: HistoryV3_48_01;
@@ -1834,7 +1834,17 @@ export interface ContextualGroundingPolicyV3_48_0 {
     filtersConfig: FilterV3_48_01;
 }
 export interface ToolMapV3_48_0 {
-    [k: string]: AgentToolConfigV3_48_0;
+    [k: string]: ToolJSONV3_48_0;
+}
+/**
+ * This interface was referenced by `ToolMapV3_48_0`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface ToolJSONV3_48_0 {
+    ref: string;
+    description?: string;
+    args?: ToolArgV3_48_0[];
+    selectionSet?: string;
 }
 /**
  * This interface was referenced by `ProjectSchemaJSONV3_48_0`'s JSON-Schema

package/dist/project-schema/v3.49.0.d.ts

@@ -268,7 +268,19 @@ export type InteractionTimeoutMillisecondsV3_49_01 = number;
 export type VariablesV3_49_0 = AgentVariableV3_49_0[];
 export type AgentExecutionV3_49_0 = AgentExecutionGraphQLV3_49_0 | AgentExecutionGenerateV3_49_0 | AgentExecutionChatV3_49_0;
 export type AgentAIStateInputV3_49_0 = AgentAIStateInputArgumentV3_49_0 | AgentAIStateInputTemplateV3_49_0;
-export type AgentToolConfigArgV3_49_0 = AgentToolConfigArgAgentV3_49_0 | AgentToolConfigArgVariableV3_49_0;
+export type AgentToolConfigArgV3_49_0 = AgentControlledV3_49_0 | VariableValueV3_49_0;
+/**
+ * The argument name that will be exposed by the tool for the LLM to use.
+ */
+export type ToolArgumentNameV3_49_0 = string;
+/**
+ * Name of argument to pass value to. This prevents the LLM from setting the argument.
+ */
+export type ToolArgumentNameV3_49_01 = string;
+/**
+ * Name of variable to pull value from.
+ */
+export type StateVariableNameV3_49_0 = string;
 export type HistoryV3_49_01 = boolean;
 /**
  * Maximum number of tokens to generate. Defaults to 1024
@@ -429,6 +441,7 @@ export type FilterV3_49_01 = {
     type: TypeV3_49_0;
     threshold: ThresholdV3_49_0;
 }[];
+export type ToolArgV3_49_0 = AgentControlledV3_49_0;
 /**
  * Human-readable id for use in the UI
  */
@@ -1688,33 +1701,20 @@ export interface AgentAIStateInputTemplateV3_49_0 {
     type: 'template';
     inputTemplate: string;
 }
-/**
- * This interface was referenced by `ToolMapV3_49_0`'s JSON-Schema definition
- * via the `patternProperty` "^[0-9A-Za-z_]+$".
- */
 export interface AgentToolConfigV3_49_0 {
     ref: string;
     description?: string;
     args?: AgentToolConfigArgV3_49_0[];
     selectionSet?: string;
 }
-export interface AgentToolConfigArgAgentV3_49_0 {
+export interface AgentControlledV3_49_0 {
     type: 'agent';
-    /**
-     * The argument name that will be exposed by the tool for the LLM to use.
-     */
-    argName: string;
+    argName: ToolArgumentNameV3_49_0;
 }
-export interface AgentToolConfigArgVariableV3_49_0 {
+export interface VariableValueV3_49_0 {
     type: 'variable';
-    /**
-     * Name of argument to pass value to. This prevents the LLM from setting the argument.
-     */
-    argName: string;
-    /**
-     * Name of variable to pull value from.
-     */
-    variableName: string;
+    argName: ToolArgumentNameV3_49_01;
+    variableName: StateVariableNameV3_49_0;
 }
 export interface AgentGenerateOptionsV3_49_0 {
     history?: HistoryV3_49_01;
@@ -1834,7 +1834,17 @@ export interface ContextualGroundingPolicyV3_49_0 {
     filtersConfig: FilterV3_49_01;
 }
 export interface ToolMapV3_49_0 {
-    [k: string]: AgentToolConfigV3_49_0;
+    [k: string]: ToolJSONV3_49_0;
+}
+/**
+ * This interface was referenced by `ToolMapV3_49_0`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface ToolJSONV3_49_0 {
+    ref: string;
+    description?: string;
+    args?: ToolArgV3_49_0[];
+    selectionSet?: string;
 }
 /**
  * This interface was referenced by `ProjectSchemaJSONV3_49_0`'s JSON-Schema

package/dist/project-schema/v3.50.0.d.ts

@@ -280,7 +280,19 @@ export type InteractionTimeoutMillisecondsV3_50_01 = number;
 export type VariablesV3_50_0 = AgentVariableV3_50_0[];
 export type AgentExecutionV3_50_0 = AgentExecutionGraphQLV3_50_0 | AgentExecutionGenerateV3_50_0 | AgentExecutionChatV3_50_0;
 export type AgentAIStateInputV3_50_0 = AgentAIStateInputArgumentV3_50_0 | AgentAIStateInputTemplateV3_50_0;
-export type AgentToolConfigArgV3_50_0 = AgentToolConfigArgAgentV3_50_0 | AgentToolConfigArgVariableV3_50_0;
+export type AgentToolConfigArgV3_50_0 = AgentControlledV3_50_0 | VariableValueV3_50_0;
+/**
+ * The argument name that will be exposed by the tool for the LLM to use.
+ */
+export type ToolArgumentNameV3_50_0 = string;
+/**
+ * Name of argument to pass value to. This prevents the LLM from setting the argument.
+ */
+export type ToolArgumentNameV3_50_01 = string;
+/**
+ * Name of variable to pull value from.
+ */
+export type StateVariableNameV3_50_0 = string;
 export type HistoryV3_50_01 = boolean;
 /**
  * Maximum number of tokens to generate. Defaults to 1024
@@ -441,6 +453,7 @@ export type FilterV3_50_01 = {
     type: TypeV3_50_0;
     threshold: ThresholdV3_50_0;
 }[];
+export type ToolArgV3_50_0 = AgentControlledV3_50_0;
 /**
  * Human-readable id for use in the UI
  */
@@ -1740,33 +1753,20 @@ export interface AgentAIStateInputTemplateV3_50_0 {
     type: 'template';
     inputTemplate: string;
 }
-/**
- * This interface was referenced by `ToolMapV3_50_0`'s JSON-Schema definition
- * via the `patternProperty` "^[0-9A-Za-z_]+$".
- */
 export interface AgentToolConfigV3_50_0 {
     ref: string;
     description?: string;
     args?: AgentToolConfigArgV3_50_0[];
     selectionSet?: string;
 }
-export interface AgentToolConfigArgAgentV3_50_0 {
+export interface AgentControlledV3_50_0 {
     type: 'agent';
-    /**
-     * The argument name that will be exposed by the tool for the LLM to use.
-     */
-    argName: string;
+    argName: ToolArgumentNameV3_50_0;
 }
-export interface AgentToolConfigArgVariableV3_50_0 {
+export interface VariableValueV3_50_0 {
     type: 'variable';
-    /**
-     * Name of argument to pass value to. This prevents the LLM from setting the argument.
-     */
-    argName: string;
-    /**
-     * Name of variable to pull value from.
-     */
-    variableName: string;
+    argName: ToolArgumentNameV3_50_01;
+    variableName: StateVariableNameV3_50_0;
 }
 export interface AgentGenerateOptionsV3_50_0 {
     history?: HistoryV3_50_01;
@@ -1886,7 +1886,17 @@ export interface ContextualGroundingPolicyV3_50_0 {
     filtersConfig: FilterV3_50_01;
 }
 export interface ToolMapV3_50_0 {
-    [k: string]: AgentToolConfigV3_50_0;
+    [k: string]: ToolJSONV3_50_0;
+}
+/**
+ * This interface was referenced by `ToolMapV3_50_0`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface ToolJSONV3_50_0 {
+    ref: string;
+    description?: string;
+    args?: ToolArgV3_50_0[];
+    selectionSet?: string;
 }
 /**
  * This interface was referenced by `ProjectSchemaJSONV3_50_0`'s JSON-Schema

package/dist/project-schema/v3.51.0.d.ts

@@ -280,7 +280,19 @@ export type InteractionTimeoutMillisecondsV3_51_01 = number;
 export type VariablesV3_51_0 = AgentVariableV3_51_0[];
 export type AgentExecutionV3_51_0 = AgentExecutionGraphQLV3_51_0 | AgentExecutionGenerateV3_51_0 | AgentExecutionChatV3_51_0;
 export type AgentAIStateInputV3_51_0 = AgentAIStateInputArgumentV3_51_0 | AgentAIStateInputTemplateV3_51_0;
-export type AgentToolConfigArgV3_51_0 = AgentToolConfigArgAgentV3_51_0 | AgentToolConfigArgVariableV3_51_0;
+export type AgentToolConfigArgV3_51_0 = AgentControlledV3_51_0 | VariableValueV3_51_0;
+/**
+ * The argument name that will be exposed by the tool for the LLM to use.
+ */
+export type ToolArgumentNameV3_51_0 = string;
+/**
+ * Name of argument to pass value to. This prevents the LLM from setting the argument.
+ */
+export type ToolArgumentNameV3_51_01 = string;
+/**
+ * Name of variable to pull value from.
+ */
+export type StateVariableNameV3_51_0 = string;
 export type HistoryV3_51_01 = boolean;
 /**
  * Maximum number of tokens to generate. Defaults to 1024
@@ -441,6 +453,7 @@ export type FilterV3_51_01 = {
     type: TypeV3_51_0;
     threshold: ThresholdV3_51_0;
 }[];
+export type ToolArgV3_51_0 = AgentControlledV3_51_0;
 /**
  * Human-readable id for use in the UI
  */
@@ -1740,33 +1753,20 @@ export interface AgentAIStateInputTemplateV3_51_0 {
     type: 'template';
     inputTemplate: string;
 }
-/**
- * This interface was referenced by `ToolMapV3_51_0`'s JSON-Schema definition
- * via the `patternProperty` "^[0-9A-Za-z_]+$".
- */
 export interface AgentToolConfigV3_51_0 {
     ref: string;
     description?: string;
     args?: AgentToolConfigArgV3_51_0[];
     selectionSet?: string;
 }
-export interface AgentToolConfigArgAgentV3_51_0 {
+export interface AgentControlledV3_51_0 {
     type: 'agent';
-    /**
-     * The argument name that will be exposed by the tool for the LLM to use.
-     */
-    argName: string;
+    argName: ToolArgumentNameV3_51_0;
 }
-export interface AgentToolConfigArgVariableV3_51_0 {
+export interface VariableValueV3_51_0 {
     type: 'variable';
-    /**
-     * Name of argument to pass value to. This prevents the LLM from setting the argument.
-     */
-    argName: string;
-    /**
-     * Name of variable to pull value from.
-     */
-    variableName: string;
+    argName: ToolArgumentNameV3_51_01;
+    variableName: StateVariableNameV3_51_0;
 }
 export interface AgentGenerateOptionsV3_51_0 {
     history?: HistoryV3_51_01;
@@ -1886,7 +1886,17 @@ export interface ContextualGroundingPolicyV3_51_0 {
     filtersConfig: FilterV3_51_01;
 }
 export interface ToolMapV3_51_0 {
-    [k: string]: AgentToolConfigV3_51_0;
+    [k: string]: ToolJSONV3_51_0;
+}
+/**
+ * This interface was referenced by `ToolMapV3_51_0`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface ToolJSONV3_51_0 {
+    ref: string;
+    description?: string;
+    args?: ToolArgV3_51_0[];
+    selectionSet?: string;
 }
 /**
  * This interface was referenced by `ProjectSchemaJSONV3_51_0`'s JSON-Schema

package/dist/project-schema/v3.52.0.d.ts

@@ -280,7 +280,19 @@ export type InteractionTimeoutMillisecondsV3_52_01 = number;
 export type VariablesV3_52_0 = AgentVariableV3_52_0[];
 export type AgentExecutionV3_52_0 = AgentExecutionGraphQLV3_52_0 | AgentExecutionGenerateV3_52_0 | AgentExecutionChatV3_52_0;
 export type AgentAIStateInputV3_52_0 = AgentAIStateInputArgumentV3_52_0 | AgentAIStateInputTemplateV3_52_0;
-export type AgentToolConfigArgV3_52_0 = AgentToolConfigArgAgentV3_52_0 | AgentToolConfigArgVariableV3_52_0;
+export type AgentToolConfigArgV3_52_0 = AgentControlledV3_52_0 | VariableValueV3_52_0;
+/**
+ * The argument name that will be exposed by the tool for the LLM to use.
+ */
+export type ToolArgumentNameV3_52_0 = string;
+/**
+ * Name of argument to pass value to. This prevents the LLM from setting the argument.
+ */
+export type ToolArgumentNameV3_52_01 = string;
+/**
+ * Name of variable to pull value from.
+ */
+export type StateVariableNameV3_52_0 = string;
 export type HistoryV3_52_01 = boolean;
 /**
  * Maximum number of tokens to generate. Defaults to 1024
@@ -441,6 +453,7 @@ export type FilterV3_52_01 = {
     type: TypeV3_52_0;
     threshold: ThresholdV3_52_0;
 }[];
+export type ToolArgV3_52_0 = AgentControlledV3_52_0;
 /**
  * Human-readable id for use in the UI
  */
@@ -1740,33 +1753,20 @@ export interface AgentAIStateInputTemplateV3_52_0 {
     type: 'template';
     inputTemplate: string;
 }
-/**
- * This interface was referenced by `ToolMapV3_52_0`'s JSON-Schema definition
- * via the `patternProperty` "^[0-9A-Za-z_]+$".
- */
 export interface AgentToolConfigV3_52_0 {
     ref: string;
     description?: string;
     args?: AgentToolConfigArgV3_52_0[];
     selectionSet?: string;
 }
-export interface AgentToolConfigArgAgentV3_52_0 {
+export interface AgentControlledV3_52_0 {
     type: 'agent';
-    /**
-     * The argument name that will be exposed by the tool for the LLM to use.
-     */
-    argName: string;
+    argName: ToolArgumentNameV3_52_0;
 }
-export interface AgentToolConfigArgVariableV3_52_0 {
+export interface VariableValueV3_52_0 {
     type: 'variable';
-    /**
-     * Name of argument to pass value to. This prevents the LLM from setting the argument.
-     */
-    argName: string;
-    /**
-     * Name of variable to pull value from.
-     */
-    variableName: string;
+    argName: ToolArgumentNameV3_52_01;
+    variableName: StateVariableNameV3_52_0;
 }
 export interface AgentGenerateOptionsV3_52_0 {
     history?: HistoryV3_52_01;
@@ -1886,7 +1886,17 @@ export interface ContextualGroundingPolicyV3_52_0 {
     filtersConfig: FilterV3_52_01;
 }
 export interface ToolMapV3_52_0 {
-    [k: string]: AgentToolConfigV3_52_0;
+    [k: string]: ToolJSONV3_52_0;
+}
+/**
+ * This interface was referenced by `ToolMapV3_52_0`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface ToolJSONV3_52_0 {
+    ref: string;
+    description?: string;
+    args?: ToolArgV3_52_0[];
+    selectionSet?: string;
 }
 /**
  * This interface was referenced by `ProjectSchemaJSONV3_52_0`'s JSON-Schema

package/dist/project-schema/v3.53.0.d.ts

@@ -289,7 +289,19 @@ export type InteractionTimeoutMillisecondsV3_53_01 = number;
 export type VariablesV3_53_0 = AgentVariableV3_53_0[];
 export type AgentExecutionV3_53_0 = AgentExecutionGraphQLV3_53_0 | AgentExecutionGenerateV3_53_0 | AgentExecutionChatV3_53_0;
 export type AgentAIStateInputV3_53_0 = AgentAIStateInputArgumentV3_53_0 | AgentAIStateInputTemplateV3_53_0;
-export type AgentToolConfigArgV3_53_0 = AgentToolConfigArgAgentV3_53_0 | AgentToolConfigArgVariableV3_53_0;
+export type AgentToolConfigArgV3_53_0 = AgentControlledV3_53_0 | VariableValueV3_53_0;
+/**
+ * The argument name that will be exposed by the tool for the LLM to use.
+ */
+export type ToolArgumentNameV3_53_0 = string;
+/**
+ * Name of argument to pass value to. This prevents the LLM from setting the argument.
+ */
+export type ToolArgumentNameV3_53_01 = string;
+/**
+ * Name of variable to pull value from.
+ */
+export type StateVariableNameV3_53_0 = string;
 export type HistoryV3_53_01 = boolean;
 /**
  * Maximum number of tokens to generate. Defaults to 1024
@@ -450,6 +462,7 @@ export type FilterV3_53_01 = {
     type: TypeV3_53_0;
     threshold: ThresholdV3_53_0;
 }[];
+export type ToolArgV3_53_0 = AgentControlledV3_53_0;
 /**
  * Human-readable id for use in the UI
  */
@@ -1821,33 +1834,20 @@ export interface AgentAIStateInputTemplateV3_53_0 {
     type: 'template';
     inputTemplate: string;
 }
-/**
- * This interface was referenced by `ToolMapV3_53_0`'s JSON-Schema definition
- * via the `patternProperty` "^[0-9A-Za-z_]+$".
- */
 export interface AgentToolConfigV3_53_0 {
     ref: string;
     description?: string;
     args?: AgentToolConfigArgV3_53_0[];
     selectionSet?: string;
 }
-export interface AgentToolConfigArgAgentV3_53_0 {
+export interface AgentControlledV3_53_0 {
     type: 'agent';
-    /**
-     * The argument name that will be exposed by the tool for the LLM to use.
-     */
-    argName: string;
+    argName: ToolArgumentNameV3_53_0;
 }
-export interface AgentToolConfigArgVariableV3_53_0 {
+export interface VariableValueV3_53_0 {
     type: 'variable';
-    /**
-     * Name of argument to pass value to. This prevents the LLM from setting the argument.
-     */
-    argName: string;
-    /**
-     * Name of variable to pull value from.
-     */
-    variableName: string;
+    argName: ToolArgumentNameV3_53_01;
+    variableName: StateVariableNameV3_53_0;
 }
 export interface AgentGenerateOptionsV3_53_0 {
     history?: HistoryV3_53_01;
@@ -1967,7 +1967,17 @@ export interface ContextualGroundingPolicyV3_53_0 {
     filtersConfig: FilterV3_53_01;
 }
 export interface ToolMapV3_53_0 {
-    [k: string]: AgentToolConfigV3_53_0;
+    [k: string]: ToolJSONV3_53_0;
+}
+/**
+ * This interface was referenced by `ToolMapV3_53_0`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface ToolJSONV3_53_0 {
+    ref: string;
+    description?: string;
+    args?: ToolArgV3_53_0[];
+    selectionSet?: string;
 }
 /**
  * This interface was referenced by `ProjectSchemaJSONV3_53_0`'s JSON-Schema

package/dist/project-schema/v3.54.0.d.ts

@@ -293,7 +293,19 @@ export type InteractionTimeoutMillisecondsV3_54_01 = number;
 export type VariablesV3_54_0 = AgentVariableV3_54_0[];
 export type AgentExecutionV3_54_0 = AgentExecutionGraphQLV3_54_0 | AgentExecutionGenerateV3_54_0 | AgentExecutionChatV3_54_0;
 export type AgentAIStateInputV3_54_0 = AgentAIStateInputArgumentV3_54_0 | AgentAIStateInputTemplateV3_54_0;
-export type AgentToolConfigArgV3_54_0 = AgentToolConfigArgAgentV3_54_0 | AgentToolConfigArgVariableV3_54_0;
+export type AgentToolConfigArgV3_54_0 = AgentControlledV3_54_0 | VariableValueV3_54_0;
+/**
+ * The argument name that will be exposed by the tool for the LLM to use.
+ */
+export type ToolArgumentNameV3_54_0 = string;
+/**
+ * Name of argument to pass value to. This prevents the LLM from setting the argument.
+ */
+export type ToolArgumentNameV3_54_01 = string;
+/**
+ * Name of variable to pull value from.
+ */
+export type StateVariableNameV3_54_0 = string;
 export type HistoryV3_54_01 = boolean;
 /**
  * Maximum number of tokens to generate. Defaults to 1024
@@ -454,6 +466,7 @@ export type FilterV3_54_01 = {
     type: TypeV3_54_0;
     threshold: ThresholdV3_54_0;
 }[];
+export type ToolArgV3_54_0 = AgentControlledV3_54_0;
 /**
  * Human-readable id for use in the UI
  */
@@ -1840,33 +1853,20 @@ export interface AgentAIStateInputTemplateV3_54_0 {
     type: 'template';
     inputTemplate: string;
 }
-/**
- * This interface was referenced by `ToolMapV3_54_0`'s JSON-Schema definition
- * via the `patternProperty` "^[0-9A-Za-z_]+$".
- */
 export interface AgentToolConfigV3_54_0 {
     ref: string;
     description?: string;
     args?: AgentToolConfigArgV3_54_0[];
     selectionSet?: string;
 }
-export interface AgentToolConfigArgAgentV3_54_0 {
+export interface AgentControlledV3_54_0 {
     type: 'agent';
-    /**
-     * The argument name that will be exposed by the tool for the LLM to use.
-     */
-    argName: string;
+    argName: ToolArgumentNameV3_54_0;
 }
-export interface AgentToolConfigArgVariableV3_54_0 {
+export interface VariableValueV3_54_0 {
     type: 'variable';
-    /**
-     * Name of argument to pass value to. This prevents the LLM from setting the argument.
-     */
-    argName: string;
-    /**
-     * Name of variable to pull value from.
-     */
-    variableName: string;
+    argName: ToolArgumentNameV3_54_01;
+    variableName: StateVariableNameV3_54_0;
 }
 export interface AgentGenerateOptionsV3_54_0 {
     history?: HistoryV3_54_01;
@@ -1986,7 +1986,17 @@ export interface ContextualGroundingPolicyV3_54_0 {
     filtersConfig: FilterV3_54_01;
 }
 export interface ToolMapV3_54_0 {
-    [k: string]: AgentToolConfigV3_54_0;
+    [k: string]: ToolJSONV3_54_0;
+}
+/**
+ * This interface was referenced by `ToolMapV3_54_0`'s JSON-Schema definition
+ * via the `patternProperty` "^[0-9A-Za-z_]+$".
+ */
+export interface ToolJSONV3_54_0 {
+    ref: string;
+    description?: string;
+    args?: ToolArgV3_54_0[];
+    selectionSet?: string;
 }
 /**
  * This interface was referenced by `ProjectSchemaJSONV3_54_0`'s JSON-Schema

package/dist/schemas/project-schema/experimental.json

@@ -35,6 +35,41 @@
       "required": ["start", "states", "api"],
       "additionalProperties": false
     },
+    "tool": {
+      "title": "Tool JSON",
+      "type": "object",
+      "properties": {
+        "ref": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "args": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/toolArg"
+          }
+        },
+        "selectionSet": {
+          "type": "string"
+        }
+      },
+      "required": ["ref"],
+      "additionalProperties": false
+    },
+    "toolArg": {
+      "title": "Tool Arg",
+      "type": "object",
+      "discriminator": {
+        "propertyName": "type"
+      },
+      "oneOf": [
+        {
+          "$ref": "#/definitions/agentToolConfigArgAgent"
+        }
+      ]
+    },
     "agentApi": {
       "title": "Agent API",
       "discriminator": {
@@ -527,13 +562,14 @@
       ]
     },
     "agentToolConfigArgAgent": {
-      "title": "Agent Tool Config Arg Agent",
+      "title": "Agent-Controlled",
       "type": "object",
       "properties": {
         "type": {
           "enum": ["agent"]
         },
         "argName": {
+          "title": "Tool Argument Name",
           "type": "string",
           "description": "The argument name that will be exposed by the tool for the LLM to use."
         }
@@ -542,17 +578,19 @@
       "additionalProperties": false
     },
     "agentToolConfigArgVariable": {
-      "title": "Agent Tool Config Arg Variable",
+      "title": "Variable Value",
       "type": "object",
       "properties": {
         "type": {
           "enum": ["variable"]
         },
         "argName": {
+          "title": "Tool Argument Name",
           "type": "string",
           "description": "Name of argument to pass value to. This prevents the LLM from setting the argument."
         },
         "variableName": {
+          "title": "State Variable Name",
           "type": "string",
           "description": "Name of variable to pull value from."
         }
@@ -723,7 +761,7 @@
       "type": "object",
       "patternProperties": {
         "^[0-9A-Za-z_]+$": {
-          "$ref": "#/definitions/agentToolConfig"
+          "$ref": "#/definitions/tool"
         }
       },
       "additionalProperties": false

package/dist/util/patch-schema.js

@@ -13,7 +13,8 @@ const schemaUpdateMergedKeys = [
     'forms',
     'services',
     'ai-experimental.agents',
-    'ai-experimental.guards'
+    'ai-experimental.guards',
+    'ai-experimental.tools'
 ];
 function shallowMerge(original, update) {
     const result = { ...original };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takeshape/schema",
-  "version": "11.85.2",
+  "version": "11.87.0",
   "description": "TakeShape Schema",
   "homepage": "https://www.takeshape.io",
   "repository": {
@@ -57,9 +57,9 @@
     "p-reduce": "^2.1.0",
     "semver": "^7.3.2",
     "tiny-invariant": "^1.2.0",
-    "@takeshape/errors": "11.85.2",
-    "@takeshape/json-schema": "11.85.2",
-    "@takeshape/util": "11.85.2"
+    "@takeshape/json-schema": "11.87.0",
+    "@takeshape/errors": "11.87.0",
+    "@takeshape/util": "11.87.0"
   },
   "devDependencies": {
     "@takeshape/json-schema-to-typescript": "^11.0.0",
@@ -76,7 +76,7 @@
     "json-schema-to-ts": "^3.1.1",
     "meow": "^9.0.0",
     "shortid": "^2.2.15",
-    "@takeshape/infra": "11.85.2"
+    "@takeshape/infra": "11.87.0"
   },
   "engines": {
     "node": ">=20"