openhorse 0.2.22 → 0.2.24

package/dist/tools/goal.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * openhorse — Goal Model Tools
+ *
+ * create_goal / update_goal / get_goal tools per v0.2.24-target-mode-plan section 11.
+ * These tools let the model report goal completion or blocking through the
+ * same tool interface as all other tools, keeping the goal lifecycle
+ * inside the agent loop rather than requiring out-of-band signals.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GOAL_MODEL_TOOLS = exports.updateGoalTool = exports.createGoalTool = exports.getGoalTool = void 0;
+exports.setGoalCoordinator = setGoalCoordinator;
+exports.getGoalCoordinator = getGoalCoordinator;
+const tool_1 = require("../framework/tool");
+const tool_state_1 = require("../framework/tool-state");
+// ============================================================================
+// Shared coordinator access (set by runtime at session init)
+// ============================================================================
+let sharedCoordinator = null;
+function setGoalCoordinator(coordinator) {
+    sharedCoordinator = coordinator;
+}
+function getGoalCoordinator() {
+    return sharedCoordinator;
+}
+// ============================================================================
+// Model tool definitions
+// ============================================================================
+exports.getGoalTool = (0, tool_1.buildTool)({
+    name: 'get_goal',
+    description: `Get the current persistent goal/target for this session.
+Returns the goal's objective, status, progress, and accounting information.`,
+    parameters: {
+        type: 'object',
+        properties: {},
+    },
+    execute: async () => {
+        if (!sharedCoordinator) {
+            return { success: true, output: 'No active goal system available.' };
+        }
+        const goal = sharedCoordinator.getState();
+        if (!goal) {
+            return { success: true, output: 'No goal is currently set. Use /target to create one.' };
+        }
+        return {
+            success: true,
+            output: [
+                `Goal ID: ${goal.goalId}`,
+                `Status: ${goal.status}`,
+                `Objective: ${goal.objective}`,
+                goal.tokenBudget ? `Budget: ${goal.tokenBudget} tokens` : 'Budget: unlimited',
+                `Turns: ${goal.accounting.turnCount}`,
+                `Tokens: ${goal.accounting.promptTokens}P + ${goal.accounting.completionTokens}C`,
+                `Cost: $${goal.accounting.cost.toFixed(4)}`,
+                goal.blocked ? `Blocked: ${goal.blocked.reason} (${goal.blocked.consecutiveTurns} turns)` : '',
+            ].filter(Boolean).join('\n'),
+        };
+    },
+    isReadOnly: () => true,
+    isConcurrencySafe: () => true,
+    checkPermissions: () => ({ behavior: 'allow', reason: 'Reading goal state is always safe' }),
+    userFacingName: () => 'Get goal',
+});
+exports.createGoalTool = (0, tool_1.buildTool)({
+    name: 'create_goal',
+    description: `Create a new persistent goal/target for this session.
+Only use this when the user explicitly asks to create a goal. Do NOT create goals for
+ordinary questions or tasks — goals are for multi-turn, persistent objectives that
+the agent should pursue autonomously across multiple turns.
+
+A session can only have ONE active or paused goal at a time.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            objective: {
+                type: 'string',
+                description: 'The goal objective text. Will be treated as the root objective for all goal turns.',
+            },
+            token_budget: {
+                type: 'number',
+                description: 'Optional token budget limit for the goal. Only set when the user explicitly requests it.',
+            },
+        },
+        required: ['objective'],
+    },
+    execute: async (args) => {
+        if (!sharedCoordinator) {
+            return { success: false, output: '', error: 'Goal system not available.' };
+        }
+        const objective = args.objective;
+        if (typeof objective !== 'string' || !objective.trim()) {
+            return { success: false, output: '', error: 'Objective must be a non-empty string.' };
+        }
+        try {
+            const budget = typeof args.token_budget === 'number' ? args.token_budget : null;
+            const goal = sharedCoordinator.create(objective.trim(), budget);
+            (0, tool_state_1.setToolState)({ goalActive: true, goalId: goal.goalId, goalStatus: goal.status });
+            return {
+                success: true,
+                output: `Goal created: ${goal.goalId}\nStatus: ${goal.status}\nObjective: ${goal.objective}`,
+            };
+        }
+        catch (err) {
+            return { success: false, output: '', error: String(err) };
+        }
+    },
+    isReadOnly: () => false,
+    checkPermissions: () => ({ behavior: 'allow', reason: 'Goal creation is a user-driven control action' }),
+    userFacingName: () => 'Create goal',
+});
+exports.updateGoalTool = (0, tool_1.buildTool)({
+    name: 'update_goal',
+    description: `Update the current goal's status. Use this to:
+- mark the goal as complete (with requirement-by-requirement audit evidence)
+- mark the goal as blocked (with the blocking reason)
+A goal can only be marked complete when ALL requirements are
+verified — do not mark complete if any requirement is unmet or unverified.
+A goal should only be marked blocked after the same blocker occurs across multiple turns.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                description: 'The action to perform: "complete" or "block"',
+                enum: ['complete', 'block'],
+            },
+            summary: {
+                type: 'string',
+                description: 'Summary of what was accomplished or what is blocking.',
+            },
+            requirements: {
+                type: 'array',
+                description: 'For complete: requirement-by-requirement audit. Each item must have requirement, met, and evidence.',
+            },
+            reason: {
+                type: 'string',
+                description: 'For block: the reason the goal is blocked.',
+            },
+        },
+        required: ['action'],
+    },
+    execute: async (args) => {
+        if (!sharedCoordinator) {
+            return { success: false, output: '', error: 'Goal system not available.' };
+        }
+        const goal = sharedCoordinator.getState();
+        if (!goal) {
+            return { success: false, output: '', error: 'No goal is currently set.' };
+        }
+        const action = args.action;
+        if (action === 'complete') {
+            const summary = args.summary || '';
+            const requirements = args.requirements || [];
+            const allMet = requirements.every(r => r.met);
+            if (!allMet) {
+                return {
+                    success: false,
+                    output: '',
+                    error: 'Cannot mark goal as complete: not all requirements are met. Address unmet requirements first.',
+                };
+            }
+            if (requirements.length === 0) {
+                return {
+                    success: false,
+                    output: '',
+                    error: 'Cannot mark goal as complete: provide at least one requirement with evidence.',
+                };
+            }
+            const evidence = {
+                requirements,
+                summary,
+                proposedAt: Date.now(),
+            };
+            sharedCoordinator.markComplete(evidence);
+            (0, tool_state_1.setToolState)({ goalStatus: 'complete' });
+            return { success: true, output: `Goal marked as complete.\n${summary}` };
+        }
+        if (action === 'block') {
+            const reason = args.reason || 'Unspecified blocking reason';
+            sharedCoordinator.markBlocked(reason);
+            (0, tool_state_1.setToolState)({ goalStatus: 'blocked' });
+            return { success: true, output: `Goal marked as blocked: ${reason}` };
+        }
+        return { success: false, output: '', error: `Unknown action: ${action}. Use "complete" or "block".` };
+    },
+    isReadOnly: () => false,
+    checkPermissions: () => ({ behavior: 'allow', reason: 'Goal status updates are model-driven control actions' }),
+    userFacingName: () => 'Update goal',
+});
+exports.GOAL_MODEL_TOOLS = [exports.getGoalTool, exports.createGoalTool, exports.updateGoalTool];
+//# sourceMappingURL=goal.js.map

package/dist/tools/goal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal.js","sourceRoot":"","sources":["../../src/tools/goal.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EAAa,KAAK,aAAa,EAAmB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA6DrG,eAAO,MAAM,KAAK,EAAE,aAAa,EA2uBhC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,aAAa,EAAE,CAEjD;AAmXD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;CACvB;AAioBD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,CAAC,EAAE,WAAW,EACzB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,MAAM,CAAC,CAmDjB;AAUD;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAGD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gCAAgC,EAChC,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,KAAK,cAAc,EACnB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH,OAAO,EAEL,KAAK,aAAa,EAElB,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAsD3B,eAAO,MAAM,KAAK,EAAE,aAAa,EAmxBhC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,aAAa,EAAE,CAEjD;AAqZD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;CACvB;AAmrBD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,CAAC,EAAE,WAAW,EACzB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,MAAM,CAAC,CAmDjB;AAcD;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAIrC;AAGD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gCAAgC,EAChC,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,KAAK,cAAc,EACnB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC"}