wyrm-mcp 7.3.2 → 7.4.0

package/dist/handlers/goals.js

@@ -1,4 +1,296 @@
-import{TOOL_ANNOTATIONS as u}from"../tool-annotations.js";import{renderResult as l,withGlyph as p}from"../render.js";const _=[{name:"wyrm_goal_set",description:"Set a persistent goal Wyrm will pursue across sessions. Goals carry title, success_criteria, deadline, priority, and a max_iterations cap. The wyrm-loop daemon picks the highest-priority active goal each tick.",inputSchema:{type:"object",properties:{title:{type:"string",description:"Short, action-oriented title"},description:{type:"string",description:"Longer context"},success_criteria:{type:"string",description:"How Wyrm knows when the goal is done \u2014 checked each iteration"},deadline:{type:"string",description:"Optional ISO timestamp (YYYY-MM-DD or full)"},priority:{type:"string",enum:["critical","high","medium","low"],description:"Default: medium"},max_iterations:{type:"number",description:"Cap on OODA iterations (default 20, max 200) \u2014 guard against infinite spinning"},projectPath:{type:"string",description:"Scope to a project (optional)"}},required:["title"]},outputSchema:{type:"object",properties:{id:{type:"integer"},title:{type:"string"},priority:{type:"string",enum:["critical","high","medium","low"]},status:{type:"string",enum:["active","paused","completed","abandoned"]},project_id:{type:["integer","null"]}},required:["id","title","priority","status","project_id"]},annotations:u.wyrm_goal_set,aliases:[],handler:(o,{projects:n,goals:i})=>{const t=o,a=t.projectPath?n.getProject(t.projectPath):null,e=i.set({project_id:a?.id??null,title:t.title,description:t.description,success_criteria:t.success_criteria,deadline:t.deadline,priority:t.priority,max_iterations:t.max_iterations});return l({id:e.id,title:e.title,priority:e.priority,status:e.status,project_id:e.project_id},(d,r)=>p(r.brand,`Goal #${d.id} set [${d.priority}]: ${d.title}`))}},{name:"wyrm_goal_list",description:"List goals, optionally filtered by status / project. Default: active goals, prioritized.",inputSchema:{type:"object",properties:{status:{type:"string",enum:["active","paused","completed","abandoned"]},projectPath:{type:"string"},limit:{type:"number"}}},outputSchema:{type:"object",properties:{count:{type:"integer"},goals:{type:"array",items:{type:"object",properties:{id:{type:"integer"},title:{type:"string"},priority:{type:"string",enum:["critical","high","medium","low"]},status:{type:"string",enum:["active","paused","completed","abandoned"]},iterations_count:{type:"integer"},max_iterations:{type:"integer"},progress_pct:{type:"integer",minimum:0},last_outcome:{type:["string","null"]}},required:["id","title","priority","status","iterations_count","max_iterations","progress_pct","last_outcome"]}}},required:["count","goals"]},annotations:u.wyrm_goal_list,aliases:[],handler:(o,{projects:n,goals:i})=>{const t=o,a=t.projectPath?n.getProject(t.projectPath):null,e=i.list({status:t.status,project_id:a?.id,limit:t.limit}),d={count:e.length,goals:e.map(r=>({id:r.id,title:r.title,priority:r.priority,status:r.status,iterations_count:r.iterations_count,max_iterations:r.max_iterations,progress_pct:Math.round(100*r.iterations_count/Math.max(1,r.max_iterations)),last_outcome:r.last_outcome}))};return l(d,(r,c)=>{if(r.count===0)return p(c.brand,"No goals.");const m=r.goals.map(s=>`${c.bullet} #${s.id} [${s.priority}/${s.status}] ${s.title} -- ${s.iterations_count}/${s.max_iterations} iter (${s.progress_pct}%)`+(s.last_outcome?` last:${s.last_outcome}`:""));return`${p(c.brand,`${r.count} goal(s):`)}
-${m.join(`
-`)}`})}},{name:"wyrm_goal_complete",description:"Manually mark a goal completed (e.g. when the agent reports done or the operator finishes it).",inputSchema:{type:"object",properties:{id:{type:"number"},note:{type:"string",description:"Final outcome note"}},required:["id"]},outputSchema:{type:"object",properties:{id:{type:"integer"},title:{type:"string"},status:{type:"string",enum:["completed"]}},required:["id","title","status"]},annotations:u.wyrm_goal_complete,aliases:[],handler:(o,{goals:n})=>{const i=o,t=n.complete(i.id,i.note);return t?l({id:t.id,title:t.title,status:"completed"},(a,e)=>p(e.ok,`Goal #${a.id} completed.`)):{content:[{type:"text",text:`Goal #${i.id} not found.`}],isError:!0}}},{name:"wyrm_goal_pause",description:"Pause a goal \u2014 wyrm-loop will skip it until resumed.",inputSchema:{type:"object",properties:{id:{type:"number"}},required:["id"]},outputSchema:{type:"object",properties:{id:{type:"integer"},title:{type:"string"},status:{type:"string",enum:["paused"]}},required:["id","title","status"]},annotations:u.wyrm_goal_pause,aliases:[],handler:(o,{goals:n})=>{const i=o,t=n.pause(i.id);return t?l({id:t.id,title:t.title,status:"paused"},(a,e)=>p(e.paused,`Goal #${a.id} paused.`)):{content:[{type:"text",text:`Goal #${i.id} not found.`}],isError:!0}}},{name:"wyrm_goal_resume",description:"Resume a paused goal.",inputSchema:{type:"object",properties:{id:{type:"number"}},required:["id"]},outputSchema:{type:"object",properties:{id:{type:"integer"},title:{type:"string"},status:{type:"string",enum:["active"]}},required:["id","title","status"]},annotations:u.wyrm_goal_resume,aliases:[],handler:(o,{goals:n})=>{const i=o,t=n.resume(i.id);return t?l({id:t.id,title:t.title,status:"active"},(a,e)=>p(e.resumed,`Goal #${a.id} resumed.`)):{content:[{type:"text",text:`Goal #${i.id} not found.`}],isError:!0}}},{name:"wyrm_goal_abandon",description:"Abandon a goal (won't be auto-pursued; record kept for audit).",inputSchema:{type:"object",properties:{id:{type:"number"},reason:{type:"string"}},required:["id"]},outputSchema:{type:"object",properties:{id:{type:"integer"},title:{type:"string"},status:{type:"string",enum:["abandoned"]}},required:["id","title","status"]},annotations:u.wyrm_goal_abandon,aliases:[],handler:(o,{goals:n})=>{const i=o,t=n.abandon(i.id,i.reason);return t?l({id:t.id,title:t.title,status:"abandoned"},(a,e)=>p(e.brand,`Goal #${a.id} abandoned.`)):{content:[{type:"text",text:`Goal #${i.id} not found.`}],isError:!0}}},{name:"wyrm_goal_iterations",description:"List the OODA iterations Wyrm has run for a goal \u2014 what it observed, decided, and resulted.",inputSchema:{type:"object",properties:{goal_id:{type:"number"},limit:{type:"number"}},required:["goal_id"]},outputSchema:{type:"object",properties:{goal_id:{type:"integer"},count:{type:"integer"},iterations:{type:"array",items:{type:"object",properties:{id:{type:"integer"},iteration_num:{type:"integer"},observe_summary:{type:["string","null"]},decided_action:{type:["string","null"]},action_result:{type:["string","null"]},outcome:{type:"string",enum:["progressed","blocked","done","error"]},ran_at:{type:"string"}},required:["id","iteration_num","outcome","ran_at"]}}},required:["goal_id","count","iterations"]},annotations:u.wyrm_goal_iterations,aliases:[],handler:(o,{goals:n})=>{const i=o,t=n.iterationsFor(i.goal_id,Math.min(100,i.limit??20)),a={goal_id:i.goal_id,count:t.length,iterations:t};return l(a,(e,d)=>e.count===0?p(d.brand,`Goal #${e.goal_id} has no iterations yet.`):`${p(d.brand,`${e.count} iteration(s) for goal #${e.goal_id}:`)}
-${JSON.stringify(e.iterations,null,2)}`)}}];export{_ as goalToolSpecs};
+/**
+ * Goals domain — ToolSpec contract v2 (v7 F3 T018, the proof-of-contract
+ * migration; originally extracted verbatim from the index.ts dispatch switch
+ * in v7 A2 slice 1).
+ *
+ * Each tool is ONE ToolSpec: the advertised definition (name/description/
+ * inputSchema — moved here VERBATIM from buildAllTools(), byte-identical on
+ * the wire) and the handler live on the same object, so the surface and the
+ * behavior cannot drift. Handlers are typed against the narrow GoalsContext
+ * slice ({projects, goals}) — NOT the WyrmDB god-object.
+ *
+ * v7 F3 (T019): the domain is the first consumer of the single dual-emit
+ * renderer (src/render.ts) — every success response carries a canonical
+ * `structuredContent` body validated by the declared `outputSchema`, and
+ * `content[0].text` is DERIVED from that body by a pure template (plain
+ * ASCII by default, brand glyphs behind WYRM_FANCY=1). The 6.x prose
+ * reformats accordingly (spec §6: text persists but reformats; the glyph
+ * decoration moved behind WYRM_FANCY). Not-found responses stay plain
+ * `isError` text — error responses are exempt from outputSchema per MCP
+ * convention (SEP-1303 bodies are T020's, domain not-founds are 6.x prose).
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd.
+ * @license Proprietary — (c) 2026 Ghost Protocol (Pvt) Ltd. All rights reserved. See LICENSE.
+ */
+import { TOOL_ANNOTATIONS } from '../tool-annotations.js';
+import { renderResult, withGlyph } from '../render.js';
+export const goalToolSpecs = [
+    {
+        name: "wyrm_goal_set",
+        description: "Set a persistent goal Wyrm will pursue across sessions. Goals carry title, success_criteria, deadline, priority, and a max_iterations cap. The wyrm-loop daemon picks the highest-priority active goal each tick.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                title: { type: "string", description: "Short, action-oriented title" },
+                description: { type: "string", description: "Longer context" },
+                success_criteria: { type: "string", description: "How Wyrm knows when the goal is done — checked each iteration" },
+                deadline: { type: "string", description: "Optional ISO timestamp (YYYY-MM-DD or full)" },
+                priority: { type: "string", enum: ["critical", "high", "medium", "low"], description: "Default: medium" },
+                max_iterations: { type: "number", description: "Cap on OODA iterations (default 20, max 200) — guard against infinite spinning" },
+                projectPath: { type: "string", description: "Scope to a project (optional)" },
+            },
+            required: ["title"],
+        },
+        outputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                title: { type: "string" },
+                priority: { type: "string", enum: ["critical", "high", "medium", "low"] },
+                status: { type: "string", enum: ["active", "paused", "completed", "abandoned"] },
+                project_id: { type: ["integer", "null"] },
+            },
+            required: ["id", "title", "priority", "status", "project_id"],
+        },
+        annotations: TOOL_ANNOTATIONS.wyrm_goal_set,
+        aliases: [],
+        handler: (args, { projects, goals }) => {
+            const a = args;
+            const project = a.projectPath ? projects.getProject(a.projectPath) : null;
+            const goal = goals.set({
+                project_id: project?.id ?? null,
+                title: a.title,
+                description: a.description,
+                success_criteria: a.success_criteria,
+                deadline: a.deadline,
+                priority: a.priority,
+                max_iterations: a.max_iterations,
+            });
+            return renderResult({ id: goal.id, title: goal.title, priority: goal.priority, status: goal.status, project_id: goal.project_id }, (b, g) => withGlyph(g.brand, `Goal #${b.id} set [${b.priority}]: ${b.title}`));
+        },
+    },
+    {
+        name: "wyrm_goal_list",
+        description: "List goals, optionally filtered by status / project. Default: active goals, prioritized.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                status: { type: "string", enum: ["active", "paused", "completed", "abandoned"] },
+                projectPath: { type: "string" },
+                limit: { type: "number" },
+            },
+        },
+        outputSchema: {
+            type: "object",
+            properties: {
+                count: { type: "integer" },
+                goals: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            id: { type: "integer" },
+                            title: { type: "string" },
+                            priority: { type: "string", enum: ["critical", "high", "medium", "low"] },
+                            status: { type: "string", enum: ["active", "paused", "completed", "abandoned"] },
+                            iterations_count: { type: "integer" },
+                            max_iterations: { type: "integer" },
+                            progress_pct: { type: "integer", minimum: 0 },
+                            last_outcome: { type: ["string", "null"] },
+                        },
+                        required: ["id", "title", "priority", "status", "iterations_count", "max_iterations", "progress_pct", "last_outcome"],
+                    },
+                },
+            },
+            required: ["count", "goals"],
+        },
+        annotations: TOOL_ANNOTATIONS.wyrm_goal_list,
+        aliases: [],
+        handler: (args, { projects, goals }) => {
+            const a = args;
+            const project = a.projectPath ? projects.getProject(a.projectPath) : null;
+            const rows = goals.list({ status: a.status, project_id: project?.id, limit: a.limit });
+            const body = {
+                count: rows.length,
+                goals: rows.map((row) => ({
+                    id: row.id,
+                    title: row.title,
+                    priority: row.priority,
+                    status: row.status,
+                    iterations_count: row.iterations_count,
+                    max_iterations: row.max_iterations,
+                    progress_pct: Math.round(100 * row.iterations_count / Math.max(1, row.max_iterations)),
+                    last_outcome: row.last_outcome,
+                })),
+            };
+            return renderResult(body, (b, g) => {
+                if (b.count === 0)
+                    return withGlyph(g.brand, 'No goals.');
+                const lines = b.goals.map((row) => `${g.bullet} #${row.id} [${row.priority}/${row.status}] ${row.title} -- ${row.iterations_count}/${row.max_iterations} iter (${row.progress_pct}%)` +
+                    (row.last_outcome ? ` last:${row.last_outcome}` : ''));
+                return `${withGlyph(g.brand, `${b.count} goal(s):`)}\n${lines.join('\n')}`;
+            });
+        },
+    },
+    {
+        name: "wyrm_goal_complete",
+        description: "Manually mark a goal completed (e.g. when the agent reports done or the operator finishes it).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number" },
+                note: { type: "string", description: "Final outcome note" },
+            },
+            required: ["id"],
+        },
+        outputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                title: { type: "string" },
+                status: { type: "string", enum: ["completed"] },
+            },
+            required: ["id", "title", "status"],
+        },
+        annotations: TOOL_ANNOTATIONS.wyrm_goal_complete,
+        aliases: [],
+        handler: (args, { goals }) => {
+            const a = args;
+            const row = goals.complete(a.id, a.note);
+            if (!row)
+                return { content: [{ type: "text", text: `Goal #${a.id} not found.` }], isError: true };
+            return renderResult({ id: row.id, title: row.title, status: 'completed' }, (b, g) => withGlyph(g.ok, `Goal #${b.id} completed.`));
+        },
+    },
+    {
+        name: "wyrm_goal_pause",
+        description: "Pause a goal — wyrm-loop will skip it until resumed.",
+        inputSchema: {
+            type: "object",
+            properties: { id: { type: "number" } },
+            required: ["id"],
+        },
+        outputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                title: { type: "string" },
+                status: { type: "string", enum: ["paused"] },
+            },
+            required: ["id", "title", "status"],
+        },
+        annotations: TOOL_ANNOTATIONS.wyrm_goal_pause,
+        aliases: [],
+        handler: (args, { goals }) => {
+            const a = args;
+            const row = goals.pause(a.id);
+            if (!row)
+                return { content: [{ type: "text", text: `Goal #${a.id} not found.` }], isError: true };
+            return renderResult({ id: row.id, title: row.title, status: 'paused' }, (b, g) => withGlyph(g.paused, `Goal #${b.id} paused.`));
+        },
+    },
+    {
+        name: "wyrm_goal_resume",
+        description: "Resume a paused goal.",
+        inputSchema: {
+            type: "object",
+            properties: { id: { type: "number" } },
+            required: ["id"],
+        },
+        outputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                title: { type: "string" },
+                status: { type: "string", enum: ["active"] },
+            },
+            required: ["id", "title", "status"],
+        },
+        annotations: TOOL_ANNOTATIONS.wyrm_goal_resume,
+        aliases: [],
+        handler: (args, { goals }) => {
+            const a = args;
+            const row = goals.resume(a.id);
+            if (!row)
+                return { content: [{ type: "text", text: `Goal #${a.id} not found.` }], isError: true };
+            return renderResult({ id: row.id, title: row.title, status: 'active' }, (b, g) => withGlyph(g.resumed, `Goal #${b.id} resumed.`));
+        },
+    },
+    {
+        name: "wyrm_goal_abandon",
+        description: "Abandon a goal (won't be auto-pursued; record kept for audit).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number" },
+                reason: { type: "string" },
+            },
+            required: ["id"],
+        },
+        outputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "integer" },
+                title: { type: "string" },
+                status: { type: "string", enum: ["abandoned"] },
+            },
+            required: ["id", "title", "status"],
+        },
+        annotations: TOOL_ANNOTATIONS.wyrm_goal_abandon,
+        aliases: [],
+        handler: (args, { goals }) => {
+            const a = args;
+            const row = goals.abandon(a.id, a.reason);
+            if (!row)
+                return { content: [{ type: "text", text: `Goal #${a.id} not found.` }], isError: true };
+            return renderResult({ id: row.id, title: row.title, status: 'abandoned' }, (b, g) => withGlyph(g.brand, `Goal #${b.id} abandoned.`));
+        },
+    },
+    {
+        name: "wyrm_goal_iterations",
+        description: "List the OODA iterations Wyrm has run for a goal — what it observed, decided, and resulted.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                goal_id: { type: "number" },
+                limit: { type: "number" },
+            },
+            required: ["goal_id"],
+        },
+        outputSchema: {
+            type: "object",
+            properties: {
+                goal_id: { type: "integer" },
+                count: { type: "integer" },
+                iterations: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            id: { type: "integer" },
+                            iteration_num: { type: "integer" },
+                            observe_summary: { type: ["string", "null"] },
+                            decided_action: { type: ["string", "null"] },
+                            action_result: { type: ["string", "null"] },
+                            outcome: { type: "string", enum: ["progressed", "blocked", "done", "error"] },
+                            ran_at: { type: "string" },
+                        },
+                        required: ["id", "iteration_num", "outcome", "ran_at"],
+                    },
+                },
+            },
+            required: ["goal_id", "count", "iterations"],
+        },
+        annotations: TOOL_ANNOTATIONS.wyrm_goal_iterations,
+        aliases: [],
+        handler: (args, { goals }) => {
+            const a = args;
+            const rows = goals.iterationsFor(a.goal_id, Math.min(100, a.limit ?? 20));
+            const body = { goal_id: a.goal_id, count: rows.length, iterations: rows };
+            return renderResult(body, (b, g) => b.count === 0
+                ? withGlyph(g.brand, `Goal #${b.goal_id} has no iterations yet.`)
+                : `${withGlyph(g.brand, `${b.count} iteration(s) for goal #${b.goal_id}:`)}\n${JSON.stringify(b.iterations, null, 2)}`);
+        },
+    },
+];
+//# sourceMappingURL=goals.js.map

package/dist/handlers/intelligence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intelligence.d.ts","sourceRoot":"","sources":["../../src/handlers/intelligence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAkBzE,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAwtB5E,CAAC"}
+{"version":3,"file":"intelligence.d.ts","sourceRoot":"","sources":["../../src/handlers/intelligence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAkBzE,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAkuB5E,CAAC"}