forge-openclaw-plugin 0.3.11 → 0.3.12

package/dist/openclaw/tools.js

@@ -173,6 +173,7 @@ const lifeForceRouteSpecs = {
 const workbenchRouteSpecs = {
     boxCatalog: { method: "GET", path: "/api/v1/workbench/catalog/boxes" },
     listFlows: { method: "GET", path: "/api/v1/workbench/flows" },
+    flowDetail: { method: "GET", path: "/api/v1/workbench/flows/:id" },
     flowById: { method: "GET", path: "/api/v1/workbench/flows/:id" },
     flowBySlug: {
         method: "GET",
@@ -212,6 +213,7 @@ const workbenchRouteSpecs = {
         method: "GET",
         path: "/api/v1/workbench/flows/:id/output"
     },
+    runHistory: { method: "GET", path: "/api/v1/workbench/flows/:id/runs" },
     runs: { method: "GET", path: "/api/v1/workbench/flows/:id/runs" },
     runDetail: {
         method: "GET",

package/dist/server/server/migrations/071_agent_runtime_claude_identity.sql

@@ -0,0 +1,49 @@
+INSERT OR IGNORE INTO users (
+  id, kind, handle, display_name, description, accent_color, created_at, updated_at
+) VALUES (
+  'user_agent_claude',
+  'bot',
+  'claude',
+  'Claude Code',
+  'Claude Code runtime actor linked to Forge agent identity and Kanban ownership.',
+  '#f97316',
+  datetime('now'),
+  datetime('now')
+);
+
+UPDATE users
+SET kind = 'bot',
+    handle = 'claude',
+    display_name = 'Claude Code',
+    description = 'Claude Code runtime actor linked to Forge agent identity and Kanban ownership.',
+    accent_color = '#f97316',
+    updated_at = datetime('now')
+WHERE id = 'user_agent_claude';
+
+UPDATE agent_identities
+SET label = 'Forge Claude Code',
+    agent_type = 'claude',
+    provider = 'claude',
+    identity_key = COALESCE(identity_key, 'runtime:claude:legacy:default'),
+    machine_key = COALESCE(machine_key, 'legacy'),
+    persona_key = COALESCE(persona_key, 'default'),
+    description = 'Forge Claude Code runtime agent with stable Forge identity and linked Kanban user.',
+    updated_at = datetime('now')
+WHERE lower(agent_type) = 'claude'
+   OR lower(label) IN ('forge claude', 'forge claude code', 'claude', 'claude code');
+
+INSERT OR IGNORE INTO agent_identity_users (
+  agent_id, user_id, role, created_at, updated_at
+)
+SELECT id, 'user_agent_claude', 'primary', datetime('now'), datetime('now')
+FROM agent_identities
+WHERE provider = 'claude';
+
+UPDATE agent_runtime_sessions
+SET agent_label = 'Forge Claude Code',
+    agent_type = 'claude',
+    provider = 'claude',
+    updated_at = datetime('now')
+WHERE provider = 'claude'
+   OR lower(agent_type) = 'claude'
+   OR lower(agent_label) IN ('forge claude', 'forge claude code', 'claude', 'claude code');

package/dist/server/server/src/app.js

@@ -5134,9 +5134,11 @@ function buildAgentOnboardingPayload(request) {
                     summary: "Dedicated graph-flow API. Use it for flow catalog reads, flow CRUD, execution, run history, published outputs, node results, and latest successful node outputs.",
                     routeKeys: [
                         "listFlows",
+                        "flowDetail",
                         "flowById",
                         "flowBySlug",
                         "publishedOutput",
+                        "runHistory",
                         "runs",
                         "runDetail",
                         "runNodes",
@@ -5160,9 +5162,11 @@ function buildAgentOnboardingPayload(request) {
                     ],
                     methodRoutes: {
                         listFlows: "GET /api/v1/workbench/flows",
+                        flowDetail: "GET /api/v1/workbench/flows/:id",
                         flowById: "GET /api/v1/workbench/flows/:id",
                         flowBySlug: "GET /api/v1/workbench/flows/by-slug/:slug",
                         publishedOutput: "GET /api/v1/workbench/flows/:id/output",
+                        runHistory: "GET /api/v1/workbench/flows/:id/runs",
                         runs: "GET /api/v1/workbench/flows/:id/runs",
                         runDetail: "GET /api/v1/workbench/flows/:id/runs/:runId",
                         runNodes: "GET /api/v1/workbench/flows/:id/runs/:runId/nodes",
@@ -5178,9 +5182,11 @@ function buildAgentOnboardingPayload(request) {
                     },
                     readRoutes: {
                         listFlows: "/api/v1/workbench/flows",
+                        flowDetail: "/api/v1/workbench/flows/:id",
                         flowById: "/api/v1/workbench/flows/:id",
                         flowBySlug: "/api/v1/workbench/flows/by-slug/:slug",
                         publishedOutput: "/api/v1/workbench/flows/:id/output",
+                        runHistory: "/api/v1/workbench/flows/:id/runs",
                         runs: "/api/v1/workbench/flows/:id/runs",
                         runDetail: "/api/v1/workbench/flows/:id/runs/:runId",
                         runNodes: "/api/v1/workbench/flows/:id/runs/:runId/nodes",
@@ -5199,6 +5205,7 @@ function buildAgentOnboardingPayload(request) {
                     notes: [
                         "Workbench is a dedicated execution surface, not a batch CRUD entity family.",
                         "Route-selection questions are internal. User-facing questions should ask whether the user needs the saved flow, its input contract, one run, one node, or the public result instead of reciting Workbench route keys.",
+                        "`flowDetail` is the plain saved-flow detail route-key alias for `flowById`, and `runHistory` is the plain run-history route-key alias for `runs`. Keep the older keys valid for existing agents, but prefer the clearer aliases in new examples and guidance.",
                         "Use the flow routes when the agent needs stable public input contracts, published outputs, node-level results, or reusable execution history.",
                         "If the user is still figuring out inputs or editable structure, read flow detail or box catalog before asking them to reconstruct structured inputs from memory.",
                         "For flow creation, clarify what the flow should reliably produce, which input contract it should accept, and which first node or box anchors the flow before asking for structured input details.",
@@ -5305,6 +5312,25 @@ function buildAgentOnboardingPayload(request) {
                     "Use a distinct actor label such as Albert (codex) so Codex-originated work stays readable in Forge history.",
                     "The Forge MCP bridge now self-registers as a live agent session and heartbeats while the MCP server process stays alive."
                 ]
+            },
+            claude: {
+                label: "Claude Code",
+                installSteps: [
+                    "Install Claude Code, then run npx forge-memory configure and select Claude Code.",
+                    "Keep Claude pointed at the same Forge origin, port, and shared data root used by the rest of the local runtime.",
+                    "Restart the Claude Code session after MCP configuration changes so the Forge MCP server starts cleanly."
+                ],
+                verifyCommands: [
+                    "claude mcp list",
+                    "claude mcp get forge",
+                    "claude",
+                    `curl -s ${origin}/api/v1/health`
+                ],
+                configNotes: [
+                    "Forge Memory writes one user-scope Claude MCP server named forge in ~/.claude.json.",
+                    "The Claude MCP server command is npx forge-memory mcp, so Claude shares the same Forge runtime and data root as OpenClaw, Hermes, and Codex.",
+                    "Use a distinct actor label such as Albert (claude) so Claude-originated work stays readable in Forge history."
+                ]
             }
         },
         verificationPaths: {
@@ -5340,8 +5366,10 @@ function buildAgentOnboardingPayload(request) {
             movementTripPointDelete: "/api/v1/movement/trips/:id/points/:pointId",
             workbenchBoxCatalog: "/api/v1/workbench/catalog/boxes",
             workbenchFlows: "/api/v1/workbench/flows",
+            workbenchFlowDetail: "/api/v1/workbench/flows/:id",
             workbenchFlowBySlug: "/api/v1/workbench/flows/by-slug/:slug",
             workbenchPublishedOutput: "/api/v1/workbench/flows/:id/output",
+            workbenchRunHistory: "/api/v1/workbench/flows/:id/runs",
             workbenchRuns: "/api/v1/workbench/flows/:id/runs",
             workbenchRunDetail: "/api/v1/workbench/flows/:id/runs/:runId",
             workbenchNodeResult: "/api/v1/workbench/flows/:id/runs/:runId/nodes/:nodeId",
@@ -5510,10 +5538,12 @@ function buildAgentOnboardingPayload(request) {
                 lifeForceWeekdayTemplate: '{"routeKey":"weekdayTemplate","pathParams":{"weekday":"monday"},"body":{"points":[{"hour":13,"freeAp":-4}]}}',
                 lifeForceFatigueSignal: '{"routeKey":"fatigueSignal","body":{"signal":"tired","intensity":7,"note":"Sharp post-lunch dip after clinic admin."}}',
                 workbenchFlowCatalog: '{"routeKey":"listFlows","query":{"includeArchived":false}}',
+                workbenchFlowDetail: '{"routeKey":"flowDetail","pathParams":{"id":"flow_research_digest"}}',
                 workbenchBoxCatalog: '{"routeKey":"boxCatalog"}',
                 workbenchCreateFlow: '{"routeKey":"createFlow","body":{"title":"Research digest","slug":"research-digest","description":"Turn a topic into a cited digest with a stable published summary.","nodes":[],"edges":[]}}',
                 workbenchUpdateFlow: '{"routeKey":"updateFlow","pathParams":{"id":"flow_research_digest"},"body":{"description":"Keep the same input contract but add a stronger evidence-check node."}}',
                 workbenchDeleteFlow: '{"routeKey":"deleteFlow","pathParams":{"id":"flow_research_digest"}}',
+                workbenchRunHistory: '{"routeKey":"runHistory","pathParams":{"id":"flow_research_digest"},"query":{"limit":10}}',
                 workbenchRunDetail: '{"routeKey":"runDetail","pathParams":{"id":"flow_research_digest","runId":"run_123"}}',
                 workbenchRunNodes: '{"routeKey":"runNodes","pathParams":{"id":"flow_research_digest","runId":"run_123"}}',
                 workbenchNodeResult: '{"routeKey":"nodeResult","pathParams":{"id":"flow_research_digest","runId":"run_123","nodeId":"node_summary"}}',

package/dist/server/server/src/openapi.js

@@ -2380,7 +2380,7 @@ export function buildOpenApiDocument() {
             identityKey: nullable({ type: "string" }),
             provider: nullable({
                 type: "string",
-                enum: ["openclaw", "hermes", "codex"]
+                enum: ["openclaw", "hermes", "codex", "claude"]
             }),
             machineKey: nullable({ type: "string" }),
             personaKey: nullable({ type: "string" }),
@@ -2488,7 +2488,10 @@ export function buildOpenApiDocument() {
             agentId: nullable({ type: "string" }),
             agentLabel: { type: "string" },
             agentType: { type: "string" },
-            provider: { type: "string", enum: ["openclaw", "hermes", "codex"] },
+            provider: {
+                type: "string",
+                enum: ["openclaw", "hermes", "codex", "claude"]
+            },
             sessionKey: { type: "string" },
             sessionLabel: { type: "string" },
             actorLabel: { type: "string" },

package/dist/server/server/src/repositories/agent-runtime-sessions.js

@@ -49,6 +49,21 @@ function toReconnectPlan(row) {
             automationSupported: false
         });
     }
+    if (row.provider === "claude") {
+        return agentRuntimeReconnectPlanSchema.parse({
+            summary: "Restart or resume Claude Code so the Forge MCP server starts again and reconnects to the shared Forge runtime.",
+            commands: [
+                "claude mcp list",
+                "claude mcp get forge",
+                `curl -s ${forgeBaseUrl}/api/v1/health`
+            ],
+            notes: [
+                "Forge Memory configures Claude through a user-scope MCP server named forge that runs npx forge-memory mcp.",
+                "If Forge is local, keep Claude pointed at the same Forge origin, port, and shared data root."
+            ],
+            automationSupported: false
+        });
+    }
     return agentRuntimeReconnectPlanSchema.parse({
         summary: "Restart or resume the Codex session so the Forge MCP bridge launches again and re-registers with Forge.",
         commands: [
@@ -229,6 +244,9 @@ function canonicalRuntimeAgentLabel(provider) {
     if (provider === "hermes") {
         return "Forge Hermes";
     }
+    if (provider === "claude") {
+        return "Forge Claude Code";
+    }
     return "Forge Codex";
 }
 function canonicalRuntimeDescription(provider) {
@@ -253,6 +271,15 @@ function canonicalAgentUserSpec(provider) {
             accentColor: "#a78bfa"
         };
     }
+    if (provider === "claude") {
+        return {
+            id: "user_agent_claude",
+            handle: "claude",
+            displayName: "Claude Code",
+            description: "Claude Code runtime actor linked to Forge agent identity and Kanban ownership.",
+            accentColor: "#f97316"
+        };
+    }
     return {
         id: "user_agent_codex",
         handle: "codex",

package/dist/server/server/src/repositories/settings.js

@@ -415,7 +415,8 @@ function runtimeProviderFromAgentType(agentType) {
     const normalized = normalizeAgentIdentityPart(agentType);
     if (normalized === "openclaw" ||
         normalized === "hermes" ||
-        normalized === "codex") {
+        normalized === "codex" ||
+        normalized === "claude") {
         return normalized;
     }
     return null;

package/dist/server/server/src/types.js

@@ -289,7 +289,8 @@ export const defaultAgentScopePolicy = {
 export const agentRuntimeProviderSchema = z.enum([
     "openclaw",
     "hermes",
-    "codex"
+    "codex",
+    "claude"
 ]);
 export const agentRuntimeConnectionModeSchema = z.enum([
     "operator_session",

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "forge-openclaw-plugin",
   "name": "Forge",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
-  "version": "0.3.11",
+  "version": "0.3.12",
   "activation": {
     "onStartup": true,
     "onCapabilities": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-openclaw-plugin",
-  "version": "0.3.11",
+  "version": "0.3.12",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
   "type": "module",
   "license": "Apache-2.0",

package/server/migrations/071_agent_runtime_claude_identity.sql

@@ -0,0 +1,49 @@
+INSERT OR IGNORE INTO users (
+  id, kind, handle, display_name, description, accent_color, created_at, updated_at
+) VALUES (
+  'user_agent_claude',
+  'bot',
+  'claude',
+  'Claude Code',
+  'Claude Code runtime actor linked to Forge agent identity and Kanban ownership.',
+  '#f97316',
+  datetime('now'),
+  datetime('now')
+);
+
+UPDATE users
+SET kind = 'bot',
+    handle = 'claude',
+    display_name = 'Claude Code',
+    description = 'Claude Code runtime actor linked to Forge agent identity and Kanban ownership.',
+    accent_color = '#f97316',
+    updated_at = datetime('now')
+WHERE id = 'user_agent_claude';
+
+UPDATE agent_identities
+SET label = 'Forge Claude Code',
+    agent_type = 'claude',
+    provider = 'claude',
+    identity_key = COALESCE(identity_key, 'runtime:claude:legacy:default'),
+    machine_key = COALESCE(machine_key, 'legacy'),
+    persona_key = COALESCE(persona_key, 'default'),
+    description = 'Forge Claude Code runtime agent with stable Forge identity and linked Kanban user.',
+    updated_at = datetime('now')
+WHERE lower(agent_type) = 'claude'
+   OR lower(label) IN ('forge claude', 'forge claude code', 'claude', 'claude code');
+
+INSERT OR IGNORE INTO agent_identity_users (
+  agent_id, user_id, role, created_at, updated_at
+)
+SELECT id, 'user_agent_claude', 'primary', datetime('now'), datetime('now')
+FROM agent_identities
+WHERE provider = 'claude';
+
+UPDATE agent_runtime_sessions
+SET agent_label = 'Forge Claude Code',
+    agent_type = 'claude',
+    provider = 'claude',
+    updated_at = datetime('now')
+WHERE provider = 'claude'
+   OR lower(agent_type) = 'claude'
+   OR lower(agent_label) IN ('forge claude', 'forge claude code', 'claude', 'claude code');

package/skills/forge-openclaw/SKILL.md

@@ -145,6 +145,8 @@ Concrete route-key examples for internal use:
   `{"routeKey":"fatigueSignal","body":{"signal":"tired","intensity":7,"note":"Sharp post-lunch dip after clinic admin."}}`
 - Workbench flow catalog:
   `{"routeKey":"listFlows","query":{"includeArchived":false}}`
+- Workbench flow detail:
+  `{"routeKey":"flowDetail","pathParams":{"id":"flow_research_digest"}}`
 - Workbench box catalog:
   `{"routeKey":"boxCatalog"}`
 - Workbench flow creation:
@@ -153,6 +155,8 @@ Concrete route-key examples for internal use:
   `{"routeKey":"updateFlow","pathParams":{"id":"flow_research_digest"},"body":{"description":"Keep the same input contract but add a stronger evidence-check node."}}`
 - Workbench flow deletion:
   `{"routeKey":"deleteFlow","pathParams":{"id":"flow_research_digest"}}`
+- Workbench run history:
+  `{"routeKey":"runHistory","pathParams":{"id":"flow_research_digest"},"query":{"limit":10}}`
 - Workbench run detail:
   `{"routeKey":"runDetail","pathParams":{"id":"flow_research_digest","runId":"run_123"}}`
 - Workbench run nodes:

package/skills/forge-openclaw/entity_conversation_playbooks.md

@@ -2221,6 +2221,8 @@ Lane-to-route map:
 
 - discover or inspect flows:
   `/api/v1/workbench/flows`, `/api/v1/workbench/flows/:id`, or `/api/v1/workbench/flows/by-slug/:slug`
+  Use route key `flowDetail` for saved-flow detail by id; `flowById` remains valid
+  for older agents.
 - create, update, or delete a flow:
   `POST /api/v1/workbench/flows`, then `PATCH /api/v1/workbench/flows/:id` or
   `DELETE /api/v1/workbench/flows/:id` for an existing saved flow
@@ -2232,6 +2234,8 @@ Lane-to-route map:
   `POST /api/v1/workbench/flows/:id/chat`
 - inspect published output or run history:
   `/api/v1/workbench/flows/:id/output` or `/api/v1/workbench/flows/:id/runs`
+  Use route key `runHistory` for the run-history read; `runs` remains valid for
+  older agents.
 - inspect one run or node result:
   `/api/v1/workbench/flows/:id/runs/:runId`,
   `/api/v1/workbench/flows/:id/runs/:runId/nodes`,