@takeshape/schema 11.121.4 → 11.121.9

package/examples/latest/{agent-schema.json → generate-agent-schema.json}

@@ -1,20 +1,10 @@
 {
-  "projectId": "1c0dc45d-695e-4a87-ac52-13db5e1fd781",
+  "projectId": "generate-agent-schema-project-id",
   "defaultLocale": "en-us",
   "locales": [
     "en-us"
   ],
   "queries": {
-    "dogDelegate": {
-      "resolver": {
-        "name": "delegate",
-        "to": "getDogList",
-        "options": {
-          "selectionSet": "{items {name}}"
-        }
-      },
-      "shape": "JSON"
-    },
     "getDog": {
       "shape": "Dog",
       "resolver": {
@@ -32,7 +22,7 @@
         "service": "shapedb",
         "shapeName": "Dog"
       },
-      "description": "Returns a list Dog in natural order.",
+      "description": "Returns a list Dog in natural order..",
       "args": "TSListArgs<Dog>"
     }
   },
@@ -127,6 +117,26 @@
           "message"
         ]
       }
+    },
+    "FindDogColorSessionMemory": {
+      "id": "NhJxAX3PQ",
+      "name": "FindDogColorSessionMemory",
+      "title": "Find Dog Color Session Memory",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "queryResult": {
+            "@mapping": "shapedb:FindDogColorSessionMemory.vwYz10HDl",
+            "title": "Query Result",
+            "@ref": "Dog"
+          },
+          "answerResult": {
+            "@mapping": "shapedb:FindDogColorSessionMemory._E6AKVHKy",
+            "type": "string",
+            "title": "Answer"
+          }
+        }
+      }
     }
   },
   "workflows": {},
@@ -146,39 +156,21 @@
           "color"
         ]
       }
-    }
-  },
-  "schemaVersion": "3.59.0",
-  "apiVersion": "2",
-  "services": {
-    "openai": {
-      "id": "openai",
-      "title": "OpenAI",
-      "namespace": "OpenAI",
-      "provider": "openai",
-      "serviceType": "openapi",
-      "authenticationType": "bearer",
-      "options": {
-        "endpoint": "https://api.openai.com/v1/",
-        "spec": "https://raw.githubusercontent.com/takeshape/openapi-specs/813784d8fcac5b3fd4e468ce6f715b89c9fcb73f/specs/openai/v2.yml",
-        "transformVersion": "2.0.0",
-        "introspectedAt": "2024-10-17T21:21:59.009Z"
-      },
-      "authentication": "secret"
     },
-    "rick": {
-      "id": "rick",
-      "title": "Rick",
-      "namespace": "Rick",
-      "provider": "graphql",
-      "serviceType": "graphql",
-      "authenticationType": "none",
-      "options": {
-        "endpoint": "https://rickandmortyapi.com/graphql",
-        "introspectedAt": "2024-10-21T17:07:18.028Z"
-      },
-      "healthCheck": {
-        "checkName": "graphqlIntrospection"
+    "FindDogColorSessionMemory": {
+      "default": {
+        "properties": {
+          "queryResult": {
+            "widget": "shapeObject"
+          },
+          "answerResult": {
+            "widget": "singleLineText"
+          }
+        },
+        "order": [
+          "queryResult",
+          "answerResult"
+        ]
       }
     }
   },
@@ -188,24 +180,26 @@
       "api": {
         "inputs": [
           {
-            "name": "findDogColor",
             "type": "mutation",
+            "name": "findDogColor",
             "args": "TSGenerateArgs"
           }
         ]
       },
+      "memory": {
+        "sessionMemory": {
+          "shape": "FindDogColorSessionMemory"
+        }
+      },
       "start": {
         "transitions": [
           {
             "type": "suspend",
-            "input": "findDogColor",
-            "destination": "bbb"
+            "destination": "bbb",
+            "input": "findDogColor"
           }
         ]
       },
-      "memory": {
-        "sessionMemory": {}
-      },
       "states": {
         "bbb": {
           "name": "query",
@@ -213,9 +207,6 @@
             {
               "name": "input",
               "steps": [
-                {
-                  "expression": "stateOutputs['ccc'].dogName"
-                },
                 {
                   "expression": "args.input"
                 }
@@ -230,7 +221,13 @@
           "transitions": [
             {
               "type": "immediate",
-              "destination": "ccc"
+              "destination": "ccc",
+              "sessionMemory": [
+                {
+                  "expression": "currentStateOutput",
+                  "memoryPath": "queryResult"
+                }
+              ]
             }
           ]
         },
@@ -249,7 +246,7 @@
               "name": "results",
               "steps": [
                 {
-                  "expression": "previousStateOutput"
+                  "expression": "sessionMemory.queryResult"
                 }
               ]
             }
@@ -267,8 +264,14 @@
           "transitions": [
             {
               "type": "immediate",
-              "condition": "stateOutputs['ccc'].answered",
-              "destination": "ddd"
+              "condition": "currentStateOutput.answered",
+              "destination": "ddd",
+              "sessionMemory": [
+                {
+                  "memoryPath": "answerResult",
+                  "expression": "currentStateOutput.message"
+                }
+              ]
             },
             {
               "type": "immediate",
@@ -277,7 +280,13 @@
             },
             {
               "type": "immediate",
-              "destination": "eee"
+              "destination": "eee",
+              "sessionMemory": [
+                {
+                  "memoryPath": "answerResult",
+                  "expression": "currentStateOutput.message"
+                }
+              ]
             }
           ]
         },
@@ -288,7 +297,7 @@
               "name": "results",
               "steps": [
                 {
-                  "expression": "previousStateOutput.message"
+                  "expression": "sessionMemory.answerResult"
                 }
               ]
             }
@@ -311,7 +320,7 @@
               "name": "results",
               "steps": [
                 {
-                  "expression": "previousStateOutput.message"
+                  "expression": "sessionMemory.answerResult"
                 }
               ]
             }
@@ -329,53 +338,24 @@
         }
       },
       "historyStrategies": {}
-    },
-    "chat": {
-      "api": {
-        "inputs": [
-          {
-            "name": "chat",
-            "type": "mutation",
-            "args": "TSChatArgs"
-          }
-        ]
-      },
-      "start": {
-        "transitions": [
-          {
-            "type": "suspend",
-            "input": "chat",
-            "destination": "3pjuyB47X"
-          }
-        ]
-      },
-      "states": {
-        "3pjuyB47X": {
-          "name": "chat",
-          "execution": {
-            "type": "chat",
-            "service": "openai",
-            "model": "gpt-4o",
-            "input": {
-              "type": "arg"
-            },
-            "systemPrompt": "You are a helpful assistant. If the user says they have no further questions, end your response with the string ALL_DONE."
-          },
-          "transitions": [
-            {
-              "type": "immediate",
-              "condition": "contains(currentStateOutput.content, 'ALL_DONE')",
-              "destination": "END"
-            },
-            {
-              "type": "suspend",
-              "destination": "3pjuyB47X",
-              "input": "chat"
-            }
-          ]
-        }
-      },
-      "historyStrategies": {}
     }
-  }
+  },
+  "services": {
+    "openai": {
+      "id": "openai",
+      "title": "OpenAI",
+      "namespace": "OpenAI",
+      "provider": "openai",
+      "serviceType": "openapi",
+      "authenticationType": "bearer",
+      "options": {
+        "endpoint": "https://api.openai.com/v1/",
+        "spec": "https://raw.githubusercontent.com/takeshape/openapi-specs/813784d8fcac5b3fd4e468ce6f715b89c9fcb73f/specs/openai/v2.yml",
+        "transformVersion": "2.0.0",
+        "introspectedAt": "2025-08-26T20:52:22.324Z"
+      }
+    }
+  },
+  "schemaVersion": "3.59.0",
+  "apiVersion": "2"
 }

package/examples/source/chat-agent-schema.json

@@ -0,0 +1,59 @@
+{
+  "projectId": "chat-agent-schema-project-id",
+  "defaultLocale": "en-us",
+  "locales": ["en-us"],
+  "queries": {},
+  "mutations": {},
+  "shapes": {},
+  "workflows": {},
+  "forms": {},
+  "agents": {
+    "chat": {
+      "api": {
+        "inputs": [{ "name": "chat", "type": "mutation", "args": "TSChatArgs" }]
+      },
+      "start": {
+        "transitions": [{ "type": "suspend", "input": "chat", "destination": "3pjuyB47X" }]
+      },
+      "states": {
+        "3pjuyB47X": {
+          "name": "chat",
+          "execution": {
+            "type": "chat",
+            "service": "openai",
+            "model": "gpt-4o",
+            "input": { "type": "arg" },
+            "systemPrompt": "You are a helpful assistant. If the user says they have no further questions, end your response with the string ALL_DONE."
+          },
+          "transitions": [
+            {
+              "type": "immediate",
+              "condition": "contains(currentStateOutput.content, 'ALL_DONE')",
+              "destination": "END"
+            },
+            { "type": "suspend", "destination": "3pjuyB47X", "input": "chat" }
+          ]
+        }
+      },
+      "historyStrategies": {}
+    }
+  },
+  "services": {
+    "openai": {
+      "id": "openai",
+      "title": "OpenAI",
+      "namespace": "OpenAI",
+      "provider": "openai",
+      "serviceType": "openapi",
+      "authenticationType": "bearer",
+      "options": {
+        "endpoint": "https://api.openai.com/v1/",
+        "spec": "https://raw.githubusercontent.com/takeshape/openapi-specs/813784d8fcac5b3fd4e468ce6f715b89c9fcb73f/specs/openai/v2.yml",
+        "transformVersion": "2.0.0",
+        "introspectedAt": "2025-08-26T20:52:22.324Z"
+      }
+    }
+  },
+  "schemaVersion": "3.59.0",
+  "apiVersion": "2"
+}

package/examples/source/generate-agent-schema.json

@@ -0,0 +1,292 @@
+{
+  "projectId": "generate-agent-schema-project-id",
+  "defaultLocale": "en-us",
+  "locales": ["en-us"],
+  "queries": {
+    "getDog": {
+      "shape": "Dog",
+      "resolver": {
+        "name": "shapedb:get",
+        "service": "shapedb",
+        "shapeName": "Dog"
+      },
+      "description": "Get a Dog by ID",
+      "args": "TSGetArgs<Dog>"
+    },
+    "getDogList": {
+      "shape": "PaginatedList<Dog>",
+      "resolver": {
+        "name": "shapedb:list",
+        "service": "shapedb",
+        "shapeName": "Dog"
+      },
+      "description": "Returns a list Dog in natural order..",
+      "args": "TSListArgs<Dog>"
+    }
+  },
+  "mutations": {
+    "updateDog": {
+      "shape": "UpdateResult<Dog>",
+      "resolver": {
+        "name": "shapedb:update",
+        "service": "shapedb",
+        "shapeName": "Dog"
+      },
+      "description": "Update Dog",
+      "args": "UpdateArgs<Dog>"
+    },
+    "createDog": {
+      "shape": "CreateResult<Dog>",
+      "resolver": {
+        "name": "shapedb:create",
+        "service": "shapedb",
+        "shapeName": "Dog"
+      },
+      "description": "Create Dog",
+      "args": "CreateArgs<Dog>"
+    },
+    "duplicateDog": {
+      "shape": "DuplicateResult<Dog>",
+      "resolver": {
+        "name": "shapedb:duplicate",
+        "service": "shapedb",
+        "shapeName": "Dog"
+      },
+      "description": "Duplicate Dog",
+      "args": "DuplicateArgs<Dog>"
+    },
+    "deleteDog": {
+      "shape": "DeleteResult<Dog>",
+      "resolver": {
+        "name": "shapedb:delete",
+        "service": "shapedb",
+        "shapeName": "Dog"
+      },
+      "description": "Delete Dog",
+      "args": "DeleteArgs<Dog>"
+    }
+  },
+  "shapes": {
+    "Dog": {
+      "id": "JXJvoPKf-",
+      "name": "Dog",
+      "title": "Dog",
+      "model": { "type": "multiple" },
+      "schema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "@mapping": "shapedb:Dog.tY4pFndjf",
+            "type": "string",
+            "title": "Name"
+          },
+          "color": {
+            "@mapping": "shapedb:Dog.yC42Im8Mq",
+            "type": "string",
+            "title": "Color"
+          }
+        }
+      }
+    },
+    "AnswerResponse": {
+      "id": "AnswerResponse",
+      "name": "AnswerResponse",
+      "title": "AnswerResponse",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "answered": {
+            "description": "Set to true if you were able to answer the question",
+            "type": "boolean"
+          },
+          "message": {
+            "description": "Put your response here",
+            "type": "string"
+          },
+          "dogName": {
+            "description": "If the question is not answered, set the value of `dogName` to a similar dog name, eg change Franky to Frank.",
+            "type": "string"
+          }
+        },
+        "required": ["answered", "message"]
+      }
+    },
+    "FindDogColorSessionMemory": {
+      "id": "NhJxAX3PQ",
+      "name": "FindDogColorSessionMemory",
+      "title": "Find Dog Color Session Memory",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "queryResult": {
+            "@mapping": "shapedb:FindDogColorSessionMemory.vwYz10HDl",
+            "title": "Query Result",
+            "@ref": "Dog"
+          },
+          "answerResult": {
+            "@mapping": "shapedb:FindDogColorSessionMemory._E6AKVHKy",
+            "type": "string",
+            "title": "Answer"
+          }
+        }
+      }
+    }
+  },
+  "workflows": {},
+  "forms": {
+    "Dog": {
+      "default": {
+        "properties": {
+          "name": { "widget": "singleLineText" },
+          "color": { "widget": "singleLineText" }
+        },
+        "order": ["name", "color"]
+      }
+    },
+    "FindDogColorSessionMemory": {
+      "default": {
+        "properties": {
+          "queryResult": { "widget": "shapeObject" },
+          "answerResult": { "widget": "singleLineText" }
+        },
+        "order": ["queryResult", "answerResult"]
+      }
+    }
+  },
+  "agents": {
+    "findDogColor": {
+      "description": "AI Agent finds a dog's color based on its name",
+      "api": {
+        "inputs": [{ "type": "mutation", "name": "findDogColor", "args": "TSGenerateArgs" }]
+      },
+      "memory": { "sessionMemory": { "shape": "FindDogColorSessionMemory" } },
+      "start": {
+        "transitions": [{ "type": "suspend", "destination": "bbb", "input": "findDogColor" }]
+      },
+      "states": {
+        "bbb": {
+          "name": "query",
+          "variables": [{ "name": "input", "steps": [{ "expression": "args.input" }] }],
+          "execution": {
+            "type": "graphql",
+            "query": "query ($input: String!) {\n  getDogList(terms: $input) {\n    items {\n      name\n      color\n    }\n  }\n}\n",
+            "path": "getDogList.items[0]"
+          },
+          "transitions": [
+            {
+              "type": "immediate",
+              "destination": "ccc",
+              "sessionMemory": [
+                {
+                  "expression": "currentStateOutput",
+                  "memoryPath": "queryResult"
+                }
+              ]
+            }
+          ]
+        },
+        "ccc": {
+          "name": "answer",
+          "variables": [
+            { "name": "input", "steps": [{ "expression": "args.input" }] },
+            {
+              "name": "results",
+              "steps": [{ "expression": "sessionMemory.queryResult" }]
+            }
+          ],
+          "execution": {
+            "type": "generate",
+            "service": "openai",
+            "model": "gpt-4o",
+            "input": {
+              "type": "template",
+              "inputTemplate": "Please respond with the color of this dog\n\n{{input}}\n\nif the answer is in this data:\n\n{{{json results}}}"
+            },
+            "outputShape": "AnswerResponse"
+          },
+          "transitions": [
+            {
+              "type": "immediate",
+              "condition": "currentStateOutput.answered",
+              "destination": "ddd",
+              "sessionMemory": [
+                {
+                  "memoryPath": "answerResult",
+                  "expression": "currentStateOutput.message"
+                }
+              ]
+            },
+            { "type": "immediate", "limit": 3, "destination": "bbb" },
+            {
+              "type": "immediate",
+              "destination": "eee",
+              "sessionMemory": [
+                {
+                  "memoryPath": "answerResult",
+                  "expression": "currentStateOutput.message"
+                }
+              ]
+            }
+          ]
+        },
+        "ddd": {
+          "name": "summarize",
+          "variables": [
+            {
+              "name": "results",
+              "steps": [{ "expression": "sessionMemory.answerResult" }]
+            }
+          ],
+          "execution": {
+            "type": "generate",
+            "service": "openai",
+            "model": "gpt-4o",
+            "input": {
+              "type": "template",
+              "inputTemplate": "Please summarize this information:\n\n{{results}}"
+            }
+          },
+          "transitions": []
+        },
+        "eee": {
+          "name": "apologize",
+          "variables": [
+            {
+              "name": "results",
+              "steps": [{ "expression": "sessionMemory.answerResult" }]
+            }
+          ],
+          "execution": {
+            "type": "generate",
+            "service": "openai",
+            "model": "gpt-4o",
+            "input": {
+              "type": "template",
+              "inputTemplate": "Please provide a generic polite apology that there were no search results."
+            }
+          },
+          "transitions": []
+        }
+      },
+      "historyStrategies": {}
+    }
+  },
+  "services": {
+    "openai": {
+      "id": "openai",
+      "title": "OpenAI",
+      "namespace": "OpenAI",
+      "provider": "openai",
+      "serviceType": "openapi",
+      "authenticationType": "bearer",
+      "options": {
+        "endpoint": "https://api.openai.com/v1/",
+        "spec": "https://raw.githubusercontent.com/takeshape/openapi-specs/813784d8fcac5b3fd4e468ce6f715b89c9fcb73f/specs/openai/v2.yml",
+        "transformVersion": "2.0.0",
+        "introspectedAt": "2025-08-26T20:52:22.324Z"
+      }
+    }
+  },
+  "schemaVersion": "3.59.0",
+  "apiVersion": "2"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takeshape/schema",
-  "version": "11.121.4",
+  "version": "11.121.9",
   "description": "TakeShape Schema",
   "homepage": "https://www.takeshape.io",
   "repository": {
@@ -56,9 +56,9 @@
     "p-reduce": "2.1.0",
     "semver": "7.7.2",
     "tiny-invariant": "1.3.3",
-    "@takeshape/json-schema": "11.121.4",
-    "@takeshape/errors": "11.121.4",
-    "@takeshape/util": "11.121.4"
+    "@takeshape/json-schema": "11.121.9",
+    "@takeshape/util": "11.121.9",
+    "@takeshape/errors": "11.121.9"
   },
   "devDependencies": {
     "@takeshape/json-schema-to-typescript": "11.0.0",
@@ -75,8 +75,8 @@
     "glob": "7.2.3",
     "json-schema-to-ts": "3.1.1",
     "shortid": "2.2.16",
-    "@takeshape/logger": "11.121.4",
-    "@takeshape/infra": "11.121.4"
+    "@takeshape/infra": "11.121.9",
+    "@takeshape/logger": "11.121.9"
   },
   "engines": {
     "node": ">=22"