wyrm-mcp 7.2.0 → 7.2.2

package/dist/handlers/goals.js

@@ -1,296 +1,4 @@
-/**
- * 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 AGPL-3.0-or-later
- */
-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
+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};