@takeshape/schema 11.99.2 → 11.102.0

package/dist/agents.d.ts

@@ -8,12 +8,7 @@ export declare const END_AGENT_EXECUTION = "END";
  * Special history strategy ID that indicates the history should be cleared.
  */
 export declare const CLEAR_HISTORY_STRATEGY_ID = "clearHistory";
-export type AgentEndTransition = {
-    type: 'done' | 'progress';
-    originStateId: string;
-};
-export declare const getAgentEndTransitions: (agent: AgentJSON, includeSuspend?: boolean) => AgentEndTransition[];
-export declare const getAgentEndStates: (agent: AgentJSON, includeSuspend?: boolean) => Set<string>;
+export declare function getAgentEndStates(agent: AgentJSON, includeSuspend?: boolean): Set<string>;
 export declare const getInspectAgentSessionQueryName: (agentName: string) => string;
 export declare function getAgentQueries(agents: AgentMap): Pick<ProjectSchemaJSON, 'queries' | 'mutations'>;
 export declare function isValidAgentMutation(projectSchema: ProjectSchemaJSON, name: string): boolean;

package/dist/agents.js

@@ -11,11 +11,12 @@ export const END_AGENT_EXECUTION = 'END';
  * Special history strategy ID that indicates the history should be cleared.
  */
 export const CLEAR_HISTORY_STRATEGY_ID = 'clearHistory';
-const transitionCanEnd = (transition, includeSuspend = false) => {
-    if (!transition || transition.length === 0) {
+function canEndOnState(state, includeSuspend = false) {
+    const { transitions } = state;
+    if (!transitions?.length) {
         return true;
     }
-    for (const step of transition) {
+    for (const step of transitions) {
         if (includeSuspend && step.type === 'suspend') {
             return true;
         }
@@ -27,22 +28,16 @@ const transitionCanEnd = (transition, includeSuspend = false) => {
         }
     }
     return true;
-};
-export const getAgentEndTransitions = (agent, includeSuspend = false) => {
-    return Object.entries(agent.states).reduce((acc, [stateId, state]) => {
-        const endConditions = [];
-        if (transitionCanEnd(state.transition, includeSuspend)) {
-            endConditions.push({ type: 'done', originStateId: stateId });
+}
+export function getAgentEndStates(agent, includeSuspend = false) {
+    const endStates = new Set();
+    for (const [stateId, state] of Object.entries(agent.states)) {
+        if (canEndOnState(state, includeSuspend)) {
+            endStates.add(stateId);
         }
-        return [...acc, ...endConditions];
-    }, []);
-};
-export const getAgentEndStates = (agent, includeSuspend = false) => {
-    return getAgentEndTransitions(agent, includeSuspend).reduce((acc, { originStateId }) => {
-        acc.add(originStateId);
-        return acc;
-    }, new Set());
-};
+    }
+    return endStates;
+}
 export const getInspectAgentSessionQueryName = (agentName) => {
     return `inspect${upperFirst(agentName)}`;
 };

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

@@ -1792,7 +1792,7 @@ export interface AgentSessionMemory {
  * Configuration for the start of an agent's execution
  */
 export interface AgentStart {
-    transition: AgentTransitionSuspend[];
+    transitions: AgentTransitionSuspend[];
 }
 export interface AgentTransitionSuspend {
     type: 'suspend';
@@ -1823,7 +1823,7 @@ export interface AgentState {
     name: string;
     variables?: Variables;
     execution: AgentExecution;
-    transition?: AgentTransition[];
+    transitions?: AgentTransition[];
 }
 export interface AgentVariable {
     name: string;

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

@@ -1640,7 +1640,7 @@ export interface AgentSessionMemoryV3_48_0 {
  * Configuration for the start of an agent's execution
  */
 export interface AgentStartV3_48_0 {
-    transition: AgentTransitionSuspendV3_48_0[];
+    transitions: AgentTransitionSuspendV3_48_0[];
 }
 export interface AgentTransitionSuspendV3_48_0 {
     type: 'suspend';
@@ -1671,7 +1671,7 @@ export interface AgentStateV3_48_0 {
     name: string;
     variables?: VariablesV3_48_0;
     execution: AgentExecutionV3_48_0;
-    transition?: AgentTransitionV3_48_0[];
+    transitions?: AgentTransitionV3_48_0[];
 }
 export interface AgentVariableV3_48_0 {
     name: string;

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

@@ -1640,7 +1640,7 @@ export interface AgentSessionMemoryV3_49_0 {
  * Configuration for the start of an agent's execution
  */
 export interface AgentStartV3_49_0 {
-    transition: AgentTransitionSuspendV3_49_0[];
+    transitions: AgentTransitionSuspendV3_49_0[];
 }
 export interface AgentTransitionSuspendV3_49_0 {
     type: 'suspend';
@@ -1671,7 +1671,7 @@ export interface AgentStateV3_49_0 {
     name: string;
     variables?: VariablesV3_49_0;
     execution: AgentExecutionV3_49_0;
-    transition?: AgentTransitionV3_49_0[];
+    transitions?: AgentTransitionV3_49_0[];
 }
 export interface AgentVariableV3_49_0 {
     name: string;

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

@@ -1692,7 +1692,7 @@ export interface AgentSessionMemoryV3_50_0 {
  * Configuration for the start of an agent's execution
  */
 export interface AgentStartV3_50_0 {
-    transition: AgentTransitionSuspendV3_50_0[];
+    transitions: AgentTransitionSuspendV3_50_0[];
 }
 export interface AgentTransitionSuspendV3_50_0 {
     type: 'suspend';
@@ -1723,7 +1723,7 @@ export interface AgentStateV3_50_0 {
     name: string;
     variables?: VariablesV3_50_0;
     execution: AgentExecutionV3_50_0;
-    transition?: AgentTransitionV3_50_0[];
+    transitions?: AgentTransitionV3_50_0[];
 }
 export interface AgentVariableV3_50_0 {
     name: string;

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

@@ -1692,7 +1692,7 @@ export interface AgentSessionMemoryV3_51_0 {
  * Configuration for the start of an agent's execution
  */
 export interface AgentStartV3_51_0 {
-    transition: AgentTransitionSuspendV3_51_0[];
+    transitions: AgentTransitionSuspendV3_51_0[];
 }
 export interface AgentTransitionSuspendV3_51_0 {
     type: 'suspend';
@@ -1723,7 +1723,7 @@ export interface AgentStateV3_51_0 {
     name: string;
     variables?: VariablesV3_51_0;
     execution: AgentExecutionV3_51_0;
-    transition?: AgentTransitionV3_51_0[];
+    transitions?: AgentTransitionV3_51_0[];
 }
 export interface AgentVariableV3_51_0 {
     name: string;

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

@@ -1692,7 +1692,7 @@ export interface AgentSessionMemoryV3_52_0 {
  * Configuration for the start of an agent's execution
  */
 export interface AgentStartV3_52_0 {
-    transition: AgentTransitionSuspendV3_52_0[];
+    transitions: AgentTransitionSuspendV3_52_0[];
 }
 export interface AgentTransitionSuspendV3_52_0 {
     type: 'suspend';
@@ -1723,7 +1723,7 @@ export interface AgentStateV3_52_0 {
     name: string;
     variables?: VariablesV3_52_0;
     execution: AgentExecutionV3_52_0;
-    transition?: AgentTransitionV3_52_0[];
+    transitions?: AgentTransitionV3_52_0[];
 }
 export interface AgentVariableV3_52_0 {
     name: string;

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

@@ -1773,7 +1773,7 @@ export interface AgentSessionMemoryV3_53_0 {
  * Configuration for the start of an agent's execution
  */
 export interface AgentStartV3_53_0 {
-    transition: AgentTransitionSuspendV3_53_0[];
+    transitions: AgentTransitionSuspendV3_53_0[];
 }
 export interface AgentTransitionSuspendV3_53_0 {
     type: 'suspend';
@@ -1804,7 +1804,7 @@ export interface AgentStateV3_53_0 {
     name: string;
     variables?: VariablesV3_53_0;
     execution: AgentExecutionV3_53_0;
-    transition?: AgentTransitionV3_53_0[];
+    transitions?: AgentTransitionV3_53_0[];
 }
 export interface AgentVariableV3_53_0 {
     name: string;

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

@@ -1792,7 +1792,7 @@ export interface AgentSessionMemoryV3_54_0 {
  * Configuration for the start of an agent's execution
  */
 export interface AgentStartV3_54_0 {
-    transition: AgentTransitionSuspendV3_54_0[];
+    transitions: AgentTransitionSuspendV3_54_0[];
 }
 export interface AgentTransitionSuspendV3_54_0 {
     type: 'suspend';
@@ -1823,7 +1823,7 @@ export interface AgentStateV3_54_0 {
     name: string;
     variables?: VariablesV3_54_0;
     execution: AgentExecutionV3_54_0;
-    transition?: AgentTransitionV3_54_0[];
+    transitions?: AgentTransitionV3_54_0[];
 }
 export interface AgentVariableV3_54_0 {
     name: string;

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

@@ -1792,7 +1792,7 @@ export interface AgentSessionMemoryV3_55_0 {
  * Configuration for the start of an agent's execution
  */
 export interface AgentStartV3_55_0 {
-    transition: AgentTransitionSuspendV3_55_0[];
+    transitions: AgentTransitionSuspendV3_55_0[];
 }
 export interface AgentTransitionSuspendV3_55_0 {
     type: 'suspend';
@@ -1823,7 +1823,7 @@ export interface AgentStateV3_55_0 {
     name: string;
     variables?: VariablesV3_55_0;
     execution: AgentExecutionV3_55_0;
-    transition?: AgentTransitionV3_55_0[];
+    transitions?: AgentTransitionV3_55_0[];
 }
 export interface AgentVariableV3_55_0 {
     name: string;

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

@@ -264,14 +264,14 @@
       "description": "Configuration for the start of an agent's execution",
       "type": "object",
       "properties": {
-        "transition": {
+        "transitions": {
           "type": "array",
           "items": {
             "$ref": "#/definitions/agentTransitionSuspend"
           }
         }
       },
-      "required": ["transition"],
+      "required": ["transitions"],
       "additionalProperties": false
     },
     "agentStateMap": {
@@ -304,7 +304,7 @@
         "execution": {
           "$ref": "#/definitions/agentExecution"
         },
-        "transition": {
+        "transitions": {
           "type": "array",
           "items": {
             "$ref": "#/definitions/agentTransition"

package/dist/validate/ai.js

@@ -87,7 +87,7 @@ export function validateAgents(projectSchema) {
                 });
             }
         }
-        pushErrors(errors, validateAgentTransitions([...agentPath, 'start', 'transition'], inputNames, agent.start.transition));
+        pushErrors(errors, validateAgentTransitions([...agentPath, 'start', 'transitions'], inputNames, agent.start.transitions));
         for (const [stateId, state] of Object.entries(agent.states)) {
             const statePath = [...agentPath, 'states', stateId];
             if (stateNames.has(state.name)) {
@@ -125,8 +125,8 @@ export function validateAgents(projectSchema) {
                     });
                 });
             }
-            if (state.transition) {
-                errors.push(...validateAgentTransitions([...statePath, 'transition'], inputNames, state.transition));
+            if (state.transitions) {
+                errors.push(...validateAgentTransitions([...statePath, 'transitions'], inputNames, state.transitions));
             }
             if (state.execution.type === 'generate' || state.execution.type === 'chat') {
                 if (!state.execution.tools) {

package/examples/latest/agent-schema.json

@@ -1,9 +1,7 @@
 {
   "projectId": "1c0dc45d-695e-4a87-ac52-13db5e1fd781",
   "defaultLocale": "en-us",
-  "locales": [
-    "en-us"
-  ],
+  "locales": ["en-us"],
   "queries": {
     "dogDelegate": {
       "resolver": {
@@ -122,10 +120,7 @@
             "type": "string"
           }
         },
-        "required": [
-          "answered",
-          "message"
-        ]
+        "required": ["answered", "message"]
       }
     }
   },
@@ -141,10 +136,7 @@
             "widget": "singleLineText"
           }
         },
-        "order": [
-          "name",
-          "color"
-        ]
+        "order": ["name", "color"]
       }
     }
   },
@@ -196,7 +188,7 @@
           ]
         },
         "start": {
-          "transition": [
+          "transitions": [
             {
               "type": "suspend",
               "input": "findDogColor",
@@ -228,7 +220,7 @@
               "query": "query ($input: String!) {\n  getDogList(terms: $input) {\n    items {\n      name\n      color\n    }\n  }\n}\n",
               "path": "getDogList.items[0]"
             },
-            "transition": [
+            "transitions": [
               {
                 "type": "immediate",
                 "destination": "ccc"
@@ -265,7 +257,7 @@
               },
               "outputShape": "AnswerResponse"
             },
-            "transition": [
+            "transitions": [
               {
                 "type": "immediate",
                 "condition": "stateOutputs['ccc'].answered",
@@ -303,7 +295,7 @@
                 "inputTemplate": "Please summarize this information:\n\n{{results}}"
               }
             },
-            "transition": []
+            "transitions": []
           },
           "eee": {
             "name": "apologize",
@@ -326,7 +318,7 @@
                 "inputTemplate": "Please provide a generic polite apology that there were no search results."
               }
             },
-            "transition": []
+            "transitions": []
           }
         },
         "historyStrategies": {}
@@ -342,7 +334,7 @@
           ]
         },
         "start": {
-          "transition": [
+          "transitions": [
             {
               "type": "suspend",
               "input": "chat",
@@ -362,7 +354,7 @@
               },
               "systemPrompt": "You are a helpful assistant. If the user says they have no further questions, end your response with the string ALL_DONE."
             },
-            "transition": [
+            "transitions": [
               {
                 "type": "immediate",
                 "condition": "contains(currentStateOutput.content, 'ALL_DONE')",

package/examples/source/agent-schema.json

@@ -178,7 +178,7 @@
           ]
         },
         "start": {
-          "transition": [
+          "transitions": [
             {
               "type": "suspend",
               "input": "findDogColor",
@@ -210,7 +210,7 @@
               "query": "query ($input: String!) {\n  getDogList(terms: $input) {\n    items {\n      name\n      color\n    }\n  }\n}\n",
               "path": "getDogList.items[0]"
             },
-            "transition": [
+            "transitions": [
               {
                 "type": "immediate",
                 "destination": "ccc"
@@ -247,7 +247,7 @@
               },
               "outputShape": "AnswerResponse"
             },
-            "transition": [
+            "transitions": [
               {
                 "type": "immediate",
                 "condition": "stateOutputs['ccc'].answered",
@@ -285,7 +285,7 @@
                 "inputTemplate": "Please summarize this information:\n\n{{results}}"
               }
             },
-            "transition": []
+            "transitions": []
           },
           "eee": {
             "name": "apologize",
@@ -308,7 +308,7 @@
                 "inputTemplate": "Please provide a generic polite apology that there were no search results."
               }
             },
-            "transition": []
+            "transitions": []
           }
         },
         "historyStrategies": {}
@@ -324,7 +324,7 @@
           ]
         },
         "start": {
-          "transition": [
+          "transitions": [
             {
               "type": "suspend",
               "input": "chat",
@@ -344,7 +344,7 @@
               },
               "systemPrompt": "You are a helpful assistant. If the user says they have no further questions, end your response with the string ALL_DONE."
             },
-            "transition": [
+            "transitions": [
               {
                 "type": "immediate",
                 "condition": "contains(currentStateOutput.content, 'ALL_DONE')",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takeshape/schema",
-  "version": "11.99.2",
+  "version": "11.102.0",
   "description": "TakeShape Schema",
   "homepage": "https://www.takeshape.io",
   "repository": {
@@ -58,9 +58,9 @@
     "p-reduce": "^2.1.0",
     "semver": "^7.3.2",
     "tiny-invariant": "^1.2.0",
-    "@takeshape/errors": "11.99.2",
-    "@takeshape/json-schema": "11.99.2",
-    "@takeshape/util": "11.99.2"
+    "@takeshape/errors": "11.102.0",
+    "@takeshape/json-schema": "11.102.0",
+    "@takeshape/util": "11.102.0"
   },
   "devDependencies": {
     "@takeshape/json-schema-to-typescript": "^11.0.0",
@@ -76,10 +76,10 @@
     "glob": "^7.1.6",
     "json-schema-to-ts": "^3.1.1",
     "shortid": "^2.2.15",
-    "@takeshape/infra": "11.99.2"
+    "@takeshape/infra": "11.102.0"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "scripts": {
     "build": "tsc --project tsconfig.build.json",
@@ -92,9 +92,9 @@
     "deploy:ci": "pnpm run deploy",
     "json2ts": "node scripts/json-schema-to-typescript.mjs",
     "lint": "trap 'RC=1' ERR; pnpm lint:biome; pnpm lint:eslint; exit $RC",
-    "lint:biome": "biome check",
+    "lint:biome": "biome check ./",
     "lint:eslint": "eslint src -c ../../eslint.config.mjs",
-    "lint:ci:biome": "mkdir -p \"${GITHUB_WORKSPACE}/test-results/${npm_package_name#*\\/}\" && biome check --diagnostic-level error --reporter=junit > \"${GITHUB_WORKSPACE}/test-results/${npm_package_name#*\\/}/biome-results.xml\"",
+    "lint:ci:biome": "mkdir -p \"${GITHUB_WORKSPACE}/test-results/${npm_package_name#*\\/}\" && biome check ./ --diagnostic-level error --reporter=junit > \"${GITHUB_WORKSPACE}/test-results/${npm_package_name#*\\/}/biome-results.xml\"",
     "lint:ci:eslint": "ESLINT_SUITE_NAME=${npm_package_name} ESLINT_JUNIT_OUTPUT=\"${GITHUB_WORKSPACE}/test-results/${npm_package_name#*\\/}/eslint-results.xml\" pnpm lint:eslint --quiet --format ../../node_modules/eslint-junit/index.js",
     "test": "TZ=UTC vitest run",
     "test-changed": "pnpm run test --changedSince=master",