@amaster.ai/pi-goal 0.1.2-beta.42

package/dist/prompts.js

@@ -0,0 +1,64 @@
+/**
+ * Prompt templates for the goal engine.
+ *
+ * The evaluator and activation prompts are adapted almost verbatim from Claude
+ * Code's own stop-hook prompts (agent-prompt-hook-condition-evaluator-stop,
+ * system-reminder-session-stop-hook-active), tuned only where pi's mechanics
+ * differ (a `/goal` command instead of CC's). The derive prompt has no CC
+ * analogue — CC always takes an explicit condition — so it is ours.
+ */
+export const DERIVE_SYSTEM_PROMPT = `You infer a single, concrete completion condition from a coding conversation.
+
+Given the recent transcript, output ONE line describing the measurable outcome that would mean the user's current objective is fully handled. This condition will later be used to judge whether the agent may stop working.
+
+Rules:
+- Output ONLY the condition text — no preamble, no quotes, no markdown, no trailing explanation.
+- Make it measurable and verifiable (e.g. "All tests pass and \`pnpm lint\` reports no errors", "The /login endpoint returns 200 for valid credentials and 401 otherwise").
+- Base it on the user's most recent intent, not incidental side-quests.
+- Keep it under 300 characters.
+- If the conversation has no actionable objective, output exactly: NONE`;
+export function buildDeriveUserPrompt(transcript) {
+    return `## Recent conversation\n\n${transcript}\n\n---\nInfer the single measurable completion condition, or output NONE.`;
+}
+/**
+ * Stop-condition evaluator. Adapted from Claude Code's
+ * `agent-prompt-hook-condition-evaluator-stop` — the quote-evidence
+ * requirement, the "insufficient evidence in transcript" fallback, and the
+ * impossible-judgment discipline all come from CC's original wording.
+ */
+export const EVALUATE_SYSTEM_PROMPT = `You are evaluating a stop-condition hook. Read the conversation transcript carefully, then judge whether the user-provided condition is satisfied.
+
+Your response must be a JSON object with one of these shapes:
+- {"ok": true, "reason": "<quote evidence from the transcript that satisfies the condition>"}
+- {"ok": false, "reason": "<quote what is missing or what blocks the condition>"}
+- {"ok": false, "impossible": true, "reason": "<explain why the condition can never be satisfied>"}
+
+Always include a "reason" field, quoting specific text from the transcript whenever possible. If the transcript does not contain clear evidence that the condition is satisfied, return {"ok": false, "reason": "insufficient evidence in transcript"}.
+
+Only use {"ok": false, "impossible": true} when the condition is genuinely unachievable in this session — for example: the condition is self-contradictory, it depends on a resource or capability that is unavailable, or the assistant has explicitly tried, exhausted reasonable approaches, and stated it cannot be done. Apply your own judgment when deciding this — the assistant claiming the goal is impossible is evidence, not proof; independently confirm the condition is genuinely unachievable rather than deferring to the assistant's self-assessment. Do not use it just because the goal has not been reached yet or because progress is slow. When in doubt, return {"ok": false} without "impossible".`;
+/**
+ * Note prepended to the transcript when older messages were dropped to fit the
+ * evaluator's char cap. Adapted from CC's
+ * `system-prompt-hook-evaluator-truncated-transcript-note`: if the evidence
+ * might be in the omitted prefix, the evaluator should return insufficient
+ * evidence rather than guess.
+ */
+export function buildTruncationNote(omittedCount) {
+    return `[Earlier conversation truncated to fit the evaluator's context window — ${omittedCount} earlier message(s) omitted. Evaluate the condition against the recent transcript below; if the required evidence may be in the omitted prefix, return {"ok": false, "reason": "insufficient evidence in transcript"}.]`;
+}
+export function buildEvaluateUserPrompt(condition, transcript, omittedCount = 0) {
+    const note = omittedCount > 0 ? `${buildTruncationNote(omittedCount)}\n\n` : '';
+    return `## Conversation transcript\n\n${note}${transcript}\n\n## Condition\n\n${condition}\n\n---\nHas the condition been satisfied? Reply with the JSON verdict only.`;
+}
+/**
+ * Injected once when a goal is set, so the main agent starts working toward it.
+ * Adapted from CC's `system-reminder-session-stop-hook-active`.
+ */
+export function buildActivationMessage(condition) {
+    return `A goal is now active with condition: "${condition}". Briefly acknowledge the goal, then immediately start (or continue) working toward it — treat the condition itself as your directive and do not pause to ask the user what to do. Work will be blocked from stopping until the condition holds. It auto-clears once the condition is met — do not tell the user to run \`/goal clear\` after success; that's only for clearing a goal early.`;
+}
+/** Injected after a not-yet-met evaluation to drive the next round of work. */
+export function buildContinueMessage(condition, reason) {
+    return `The goal condition is not yet met: "${condition}". ${reason} Continue working toward the condition now — do not stop until it holds.`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;wEASoC,CAAC;AAEzE,MAAM,UAAU,qBAAqB,CAAC,UAAkB;IACtD,OAAO,6BAA6B,UAAU,4EAA4E,CAAC;AAC7H,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;6rBASupB,CAAC;AAE9rB;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,OAAO,2EAA2E,YAAY,yNAAyN,CAAC;AAC1T,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,SAAiB,EACjB,UAAkB,EAClB,YAAY,GAAG,CAAC;IAEhB,MAAM,IAAI,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAChF,OAAO,iCAAiC,IAAI,GAAG,UAAU,uBAAuB,SAAS,8EAA8E,CAAC;AAC1K,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,OAAO,yCAAyC,SAAS,gYAAgY,CAAC;AAC5b,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,MAAc;IACpE,OAAO,uCAAuC,SAAS,MAAM,MAAM,0EAA0E,CAAC;AAChJ,CAAC"}

package/dist/transcript.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Build a compact text transcript from agent messages for derive/evaluate.
+ * Works backwards from the newest message so the most recent context survives
+ * the char cap (same approach as pi-memory's serializer).
+ */
+export interface TranscriptResult {
+    /** Formatted transcript, oldest included message first. */
+    text: string;
+    /** Count of text-bearing messages dropped because of the char cap. */
+    omitted: number;
+}
+/**
+ * Build the transcript and report how many text-bearing messages were dropped
+ * to fit the cap. The evaluator uses `omitted` to decide whether to warn that
+ * evidence may live in the truncated prefix (see buildTruncationNote).
+ */
+export declare function buildTranscriptWithMeta(messages: unknown[], maxChars: number): TranscriptResult;
+export declare function buildTranscript(messages: unknown[], maxChars: number): string;
+export declare function extractText(content: unknown): string;
+//# sourceMappingURL=transcript.d.ts.map

package/dist/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../src/transcript.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAuB/F;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAgBpD"}

package/dist/transcript.js

@@ -0,0 +1,53 @@
+/**
+ * Build a compact text transcript from agent messages for derive/evaluate.
+ * Works backwards from the newest message so the most recent context survives
+ * the char cap (same approach as pi-memory's serializer).
+ */
+/**
+ * Build the transcript and report how many text-bearing messages were dropped
+ * to fit the cap. The evaluator uses `omitted` to decide whether to warn that
+ * evidence may live in the truncated prefix (see buildTruncationNote).
+ */
+export function buildTranscriptWithMeta(messages, maxChars) {
+    const lines = [];
+    let total = 0;
+    let included = 0;
+    let textMessages = 0;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (!msg || typeof msg.role !== 'string')
+            continue;
+        const text = extractText(msg.content);
+        if (!text)
+            continue;
+        textMessages += 1;
+        const line = `[${msg.role}] ${text}`;
+        if (total + line.length > maxChars && lines.length > 0) {
+            // Cap hit: this and every older text message is omitted.
+            continue;
+        }
+        lines.unshift(line);
+        total += line.length;
+        included += 1;
+    }
+    return { text: lines.join('\n\n'), omitted: Math.max(0, textMessages - included) };
+}
+export function buildTranscript(messages, maxChars) {
+    return buildTranscriptWithMeta(messages, maxChars).text;
+}
+export function extractText(content) {
+    if (typeof content === 'string')
+        return content.trim();
+    if (Array.isArray(content)) {
+        return content
+            .filter((c) => !!c &&
+            typeof c === 'object' &&
+            c.type === 'text' &&
+            typeof c.text === 'string')
+            .map((c) => c.text)
+            .join('\n')
+            .trim();
+    }
+    return '';
+}
+//# sourceMappingURL=transcript.js.map

package/dist/transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../src/transcript.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAmB,EAAE,QAAgB;IAC3E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAA4B,CAAC;QACnD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,SAAS;QACnD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,YAAY,IAAI,CAAC,CAAC;QAClB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACrC,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvD,yDAAyD;YACzD,SAAS;QACX,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpB,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC;QACrB,QAAQ,IAAI,CAAC,CAAC;IAChB,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC,EAAE,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAmB,EAAE,QAAgB;IACnE,OAAO,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IACvD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO;aACX,MAAM,CACL,CAAC,CAAC,EAAuC,EAAE,CACzC,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,KAAK,QAAQ;YACpB,CAAwB,CAAC,IAAI,KAAK,MAAM;YACzC,OAAQ,CAAwB,CAAC,IAAI,KAAK,QAAQ,CACrD;aACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,CAAC,IAAI,CAAC;aACV,IAAI,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@amaster.ai/pi-goal",
+  "version": "0.1.2-beta.42",
+  "description": "Pi extension that derives a goal from the conversation and keeps the agent working until the condition is met",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "extension",
+    "goal",
+    "autonomous",
+    "stop-condition"
+  ],
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./extension": {
+      "types": "./dist/extension.d.ts",
+      "default": "./dist/extension.js"
+    },
+    "./package.json": {
+      "default": "./package.json"
+    }
+  },
+  "pi": {
+    "image": "https://raw.githubusercontent.com/TGYD-helige/pi/master/packages/pi-goal/preview.png",
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "files": [
+    "dist",
+    "preview.png",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TGYD-helige/pi.git",
+    "directory": "packages/pi-goal"
+  },
+  "dependencies": {
+    "@amaster.ai/pi-shared": "0.1.2-beta.42"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-agent-core": ">=0.74.0",
+    "@earendil-works/pi-ai": ">=0.80.10",
+    "@earendil-works/pi-coding-agent": ">=0.74.0",
+    "typebox": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-agent-core": {
+      "optional": true
+    },
+    "@earendil-works/pi-ai": {
+      "optional": true
+    },
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "typebox": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@earendil-works/pi-agent-core": "0.80.10",
+    "@earendil-works/pi-ai": "0.80.10",
+    "@earendil-works/pi-coding-agent": "0.80.10",
+    "typebox": "*",
+    "vitest": "^4.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b --pretty false",
+    "test": "vitest run"
+  }
+}