forgeos 0.1.0-alpha.2 → 0.1.0-alpha.3

package/src/forge/_generated/makeRegistry.ts

@@ -1,15 +1,16 @@
-// @forge-generated generator=0.1.0-alpha.2 input=2ce189e4d3555acfca07eb3bb3d103b22a8da52f3c26f9ac2197254f0563234f content=ac7e00509f59ee0543d9795b37cbf863448d161671f87a35c39f8d3f7b402d05
+// @forge-generated generator=0.1.0-alpha.3 input=c6d07cc92a729a46f2ff02a05c005e7fe0d71a3a5800be6f670a3fca2db04d6f content=dde1c607540ce0e2bbe022af128639deef1eb84a01e094935fa3ac7e193f6ea6
 export const makeRegistry = {
   "commands": [
     "forge make list --json",
     "forge make explain <primitive> --json",
     "forge make ui --framework vite --dry-run --json",
+    "forge make ai-chat support --dry-run --json",
     "forge make resource <name> --fields title:text,status:enum(open,closed) --dry-run --json",
     "forge make resource <name> --fields title:text --with-ui --yes",
     "forge make apply <planId>",
     "forge make rollback <planId>"
   ],
-  "generatorVersion": "0.1.0-alpha.2",
+  "generatorVersion": "0.1.0-alpha.3",
   "planDirectory": ".forge/make-plans",
   "primitives": [
     {
@@ -139,6 +140,19 @@ export const makeRegistry = {
       "name": "ui",
       "summary": "Add a Vite React frontend shell with ForgeProvider devAuth and a generated client bridge."
     },
+    {
+      "creates": [
+        "src/ai/<name>Agent.ts",
+        "web/components/<Name>AiChat.tsx",
+        "web/app/<name>-ai/page.tsx when web/app exists"
+      ],
+      "examples": [
+        "forge make ai-chat support --yes"
+      ],
+      "modifies": [],
+      "name": "ai-chat",
+      "summary": "Add a Forge AI agent and React chat component backed by /ai/agents/run."
+    },
     {
       "creates": [
         "src/commands/*",

package/src/forge/_generated/makeTemplates.json

@@ -1,2 +1,2 @@
-// @forge-generated generator=0.1.0-alpha.2 input=2ce189e4d3555acfca07eb3bb3d103b22a8da52f3c26f9ac2197254f0563234f content=3ded5d373abd46034055220ea12a715a71c2f706cf4a87a75e7d66d72bf79f33
-{"schemaVersion":"0.1.0","templates":[{"name":"schema-table","outputPattern":"src/forge/schema.ts","sourceKind":"schema"},{"name":"policy","outputPattern":"src/policies.ts","sourceKind":"policy"},{"name":"command","outputPattern":"src/commands/<name>.ts","sourceKind":"runtime"},{"name":"query","outputPattern":"src/queries/<name>.ts","sourceKind":"runtime"},{"name":"livequery","outputPattern":"src/queries/live<Name>.ts","sourceKind":"runtime"},{"name":"action","outputPattern":"src/actions/<name>.ts","sourceKind":"runtime"},{"name":"workflow","outputPattern":"src/workflows/<name>.ts","sourceKind":"runtime"},{"name":"component","outputPattern":"web/components/<name>.tsx","sourceKind":"frontend"},{"name":"page","outputPattern":"web/app/<route>/page.tsx","sourceKind":"frontend"},{"name":"ui","outputPattern":"web/src/App.tsx","sourceKind":"frontend"},{"name":"placeholder-test","outputPattern":"tests/make-generated/<name>.test.ts","sourceKind":"test"}]}
+// @forge-generated generator=0.1.0-alpha.3 input=c6d07cc92a729a46f2ff02a05c005e7fe0d71a3a5800be6f670a3fca2db04d6f content=10dbc136889e8edfea67f3f41e7820590b0c52914b15184dfab1d58579353bd9
+{"schemaVersion":"0.1.0","templates":[{"name":"schema-table","outputPattern":"src/forge/schema.ts","sourceKind":"schema"},{"name":"policy","outputPattern":"src/policies.ts","sourceKind":"policy"},{"name":"command","outputPattern":"src/commands/<name>.ts","sourceKind":"runtime"},{"name":"query","outputPattern":"src/queries/<name>.ts","sourceKind":"runtime"},{"name":"livequery","outputPattern":"src/queries/live<Name>.ts","sourceKind":"runtime"},{"name":"action","outputPattern":"src/actions/<name>.ts","sourceKind":"runtime"},{"name":"workflow","outputPattern":"src/workflows/<name>.ts","sourceKind":"runtime"},{"name":"component","outputPattern":"web/components/<name>.tsx","sourceKind":"frontend"},{"name":"page","outputPattern":"web/app/<route>/page.tsx","sourceKind":"frontend"},{"name":"ui","outputPattern":"web/src/App.tsx","sourceKind":"frontend"},{"name":"ai-chat","outputPattern":"web/components/<name>AiChat.tsx","sourceKind":"frontend"},{"name":"placeholder-test","outputPattern":"tests/make-generated/<name>.test.ts","sourceKind":"test"}]}

package/src/forge/_generated/makeTemplates.ts

@@ -1,4 +1,4 @@
-// @forge-generated generator=0.1.0-alpha.2 input=2ce189e4d3555acfca07eb3bb3d103b22a8da52f3c26f9ac2197254f0563234f content=bec3e76f4a2feb0f6a1f4e3fb74d038a13ce13c7da0796fe16f4567ca0594f6e
+// @forge-generated generator=0.1.0-alpha.3 input=c6d07cc92a729a46f2ff02a05c005e7fe0d71a3a5800be6f670a3fca2db04d6f content=d77484c9887220010cac51e14aaa010154cd261244eea7bf22a2aaaedca6afb4
 export const makeTemplates = {
   "schemaVersion": "0.1.0",
   "templates": [
@@ -52,6 +52,11 @@ export const makeTemplates = {
       "outputPattern": "web/src/App.tsx",
       "sourceKind": "frontend"
     },
+    {
+      "name": "ai-chat",
+      "outputPattern": "web/components/<name>AiChat.tsx",
+      "sourceKind": "frontend"
+    },
     {
       "name": "placeholder-test",
       "outputPattern": "tests/make-generated/<name>.test.ts",

package/src/forge/_generated/mockMap.json

@@ -1,2 +1,2 @@
-// @forge-generated generator=0.1.0-alpha.2 input=2ce189e4d3555acfca07eb3bb3d103b22a8da52f3c26f9ac2197254f0563234f content=ce79e45d4228d202a492670aa76f238986b5500c8bb53774b328c216a1ccc6d8
+// @forge-generated generator=0.1.0-alpha.3 input=c6d07cc92a729a46f2ff02a05c005e7fe0d71a3a5800be6f670a3fca2db04d6f content=ce79e45d4228d202a492670aa76f238986b5500c8bb53774b328c216a1ccc6d8
 {"entries":[{"mockFile":"src/forge/_generated/testkits/ai.anthropic.mock.ts","packageName":"@ai-sdk/anthropic"},{"mockFile":"src/forge/_generated/testkits/ai.openai.mock.ts","packageName":"@ai-sdk/openai"},{"mockFile":"src/forge/_generated/testkits/ai.gateway.mock.ts","packageName":"ai"},{"mockFile":"src/forge/_generated/testkits/zod.mock.ts","packageName":"zod"}]}

package/src/forge/_generated/mockMap.ts

@@ -1,4 +1,4 @@
-// @forge-generated generator=0.1.0-alpha.2 input=2ce189e4d3555acfca07eb3bb3d103b22a8da52f3c26f9ac2197254f0563234f content=4c569da5df387f6bb7fe7fd94d42b4cc6b05f5218ab0bc129d9637c184625057
+// @forge-generated generator=0.1.0-alpha.3 input=c6d07cc92a729a46f2ff02a05c005e7fe0d71a3a5800be6f670a3fca2db04d6f content=4c569da5df387f6bb7fe7fd94d42b4cc6b05f5218ab0bc129d9637c184625057
 export const mockMap = {
   "@ai-sdk/anthropic": "src/forge/_generated/testkits/ai.anthropic.mock.ts",
   "@ai-sdk/openai": "src/forge/_generated/testkits/ai.openai.mock.ts",

package/src/forge/_generated/operationPlaybooks.md

@@ -1,4 +1,4 @@
-// @forge-generated generator=0.1.0-alpha.2 input=2ce189e4d3555acfca07eb3bb3d103b22a8da52f3c26f9ac2197254f0563234f content=462309a5bbe9b5c87581faf1755900bdfac7a1b938a89a5dc90472dff9de4340
+// @forge-generated generator=0.1.0-alpha.3 input=c6d07cc92a729a46f2ff02a05c005e7fe0d71a3a5800be6f670a3fca2db04d6f content=58dad7f03d9e378e327fddb0676d079950c8f000752667cffb022f3b7e217265
 # Operation Playbooks
 
 ## Choose the right workflow
@@ -39,6 +39,24 @@
 4. Check that _forge_live_invalidations has revisions newer than the last sent snapshot.
 5. Reconnect with Last-Event-ID or ?lastRevision=<revision> to verify resume behavior.
 
+## Add an AI tool
+
+1. Add a server-only file under src/ai or src/tools.
+2. Export aiTool({ description, inputSchema, outputSchema, risk, needsApproval, handler }).
+3. Use zod schemas for inputSchema and outputSchema.
+4. Access secrets through the tool context, not process.env.
+5. Mark destructive or external side effects with risk and needsApproval.
+6. Run forge generate and inspect src/forge/_generated/aiRegistry.json.
+
+## Add an agent
+
+1. Export agent({ provider, model, instructions, tools, stopWhen }) from server-only source.
+2. Prefer AI SDK ToolLoopAgent semantics through ctx.agent.run or ctx.ai.runAgent instead of custom loops.
+3. Use stopWhen with stepCount or terminal tool calls to prevent unbounded loops.
+4. Run agents only in actions, workflows, endpoints, or server code.
+5. Run forge inspect all --json and confirm agentContract.ai.agents lists the agent.
+6. Use forge ai trace <traceId> --json to inspect agent runs and tool calls.
+
 ## Add a table
 
 1. Edit src/forge/schema.ts.
@@ -67,13 +85,14 @@
 ## Safely refactor a feature
 
 1. Run forge refactor rename field <table.field> <table.field> --dry-run --json.
-2. Rename codemods are AST-aware for extract-action, rename field, and rename table.
-3. Field renames are scoped to the target table, so tickets.priority only rewrites references linked to tickets.
-4. Review filesToModify, migrationPlan, diagnostics, and risk.
-5. Use --allow-high-risk only for intentional high-risk refactors.
-6. Apply with forge refactor rename field <table.field> <table.field> --yes.
-7. Run forge generate.
-8. Run forge verify --strict.
+2. Run forge refactor rename command <oldName> <newName> --dry-run --json when renaming runtime entrypoints.
+3. Rename codemods are AST-aware for extract-action, rename command, rename field, and rename table.
+4. Field renames are scoped to the target table, so tickets.priority only rewrites references linked to tickets.
+5. Review filesToModify, migrationPlan, diagnostics, and risk.
+6. Use --allow-high-risk only for intentional high-risk refactors.
+7. Apply with forge refactor rename field <table.field> <table.field> --yes.
+8. Run forge generate.
+9. Run forge verify --strict.
 
 ## Plan impact-based tests
 
@@ -126,12 +145,13 @@
 ## Add or update frontend
 
 1. Run forge make ui --framework vite --dry-run --json when the app does not have a web root.
-2. Use web/lib/forge.ts as the generated client bridge.
-3. Mount ForgeProvider once in the web app provider/layout layer; use devAuth for local development.
-4. Use useQuery, useCommand, and useLiveQuery instead of raw /commands or /queries fetches.
-5. Run forge generate so frontendGraph and agentContract include routes and bindings.
-6. Run forge inspect capabilities --json to confirm UI actions map to runtime capabilities.
-7. Run forge dev --once --json and forge doctor --json.
+2. Run forge make ai-chat support --dry-run --json to add a chat surface backed by /ai/agents/chat streaming and /ai/agents/run JSON automation.
+3. Use web/lib/forge.ts as the generated client bridge.
+4. Mount ForgeProvider once in the web app provider/layout layer; use devAuth for local development.
+5. Use useQuery, useCommand, and useLiveQuery instead of raw /commands or /queries fetches.
+6. Run forge generate so frontendGraph and agentContract include routes and bindings.
+7. Run forge inspect capabilities --json to confirm UI actions map to runtime capabilities.
+8. Run forge dev --once --json and forge doctor --json.
 
 ## Self-host