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

package/dist/extension.js

@@ -0,0 +1,281 @@
+import { buildSessionContext, } from '@earendil-works/pi-coding-agent';
+import { loadSettings, resolveConfig, } from './config.js';
+import { deriveCondition } from './derive.js';
+import { evaluateCondition } from './evaluate.js';
+import { GoalState, isClearKeyword, MAX_CONDITION_LENGTH } from './goal-state.js';
+import { buildActivationMessage, buildContinueMessage } from './prompts.js';
+import { buildTranscript, buildTranscriptWithMeta } from './transcript.js';
+const STATUS_KEY = 'pi-goal';
+/**
+ * Evaluate the active goal against the transcript and either stop (achieved /
+ * impossible / limited) or inject a continuation message. Idempotent guard: the
+ * caller must ensure only one invocation runs at a time (see extension wiring).
+ */
+export async function runGoalEngine(deps, messages) {
+    const { state, config, registry } = deps;
+    const goal = state.get();
+    if (!goal || goal.status !== 'active')
+        return 'skipped';
+    if (!config.model)
+        return 'skipped'; // engine disabled without a model
+    const { text: transcript, omitted } = buildTranscriptWithMeta(messages, config.transcriptMaxChars);
+    if (!transcript)
+        return 'skipped';
+    const verdict = await evaluateCondition({
+        registry,
+        modelConfig: config.model,
+        condition: goal.condition,
+        transcript,
+        omittedCount: omitted,
+        ...(deps.signal ? { signal: deps.signal } : {}),
+    });
+    // Model unavailable / call failed: do nothing this round (degrade quietly).
+    if (verdict === null)
+        return 'skipped';
+    if (verdict.impossible) {
+        state.markImpossible(verdict.reason);
+        deps.notify(`Goal deemed unreachable: ${verdict.reason}`, 'warning');
+        deps.setStatus(formatStatus(state.get()));
+        return 'impossible';
+    }
+    if (verdict.ok) {
+        state.markAchieved(verdict.reason);
+        deps.notify(`Goal achieved: ${verdict.reason}`, 'info');
+        deps.setStatus(formatStatus(state.get()));
+        return 'achieved';
+    }
+    // Not yet met — apply guards before continuing.
+    const estimate = deps.estimateTokens ?? ((t) => Math.ceil(t.length / 4));
+    const tokensUsed = goal.tokensUsed + estimate(transcript);
+    state.recordIteration(verdict.reason, tokensUsed);
+    const current = state.get();
+    if (!current)
+        return 'skipped';
+    if (current.iterations >= config.maxIterations) {
+        state.markIterationLimited(verdict.reason);
+        deps.notify(`Goal paused after ${current.iterations} rounds (max reached). Last check: ${verdict.reason}`, 'warning');
+        deps.setStatus(formatStatus(state.get()));
+        return 'iteration_limited';
+    }
+    if (config.tokenBudget && tokensUsed >= config.tokenBudget) {
+        state.markBudgetLimited(verdict.reason);
+        deps.notify(`Goal paused: token budget reached. Last check: ${verdict.reason}`, 'warning');
+        deps.setStatus(formatStatus(state.get()));
+        return 'budget_limited';
+    }
+    deps.setStatus(formatStatus(current));
+    deps.sendUserMessage(buildContinueMessage(current.condition, verdict.reason));
+    return 'continued';
+}
+export default function goalExtension(pi, injectedConfig) {
+    const state = new GoalState();
+    let config = resolveConfig(injectedConfig);
+    let registry;
+    let engineRunning = false;
+    // Set when `--goal` was passed with an empty value: derivation is deferred to
+    // the first before_agent_start, where the user's prompt is available. At
+    // session_start there is no transcript yet, so deriving there yields nothing.
+    let pendingDerive = false;
+    pi.on('session_start', async (_event, ctx) => {
+        const fileConfig = loadSettings(ctx.cwd);
+        config = resolveConfig({ ...fileConfig, ...injectedConfig });
+        registry = ctx.modelRegistry;
+        ctx.ui.setStatus(STATUS_KEY, config.model ? 'goal: none' : 'goal: disabled (no model)');
+        // --goal <condition> flag: set the goal at startup (print mode can't dispatch
+        // the /goal slash command, so the flag is the CLI entry point). An empty
+        // string (bare --goal) defers derivation to before_agent_start, where the
+        // user's prompt for the turn is available to derive from.
+        const flagValue = pi.getFlag('goal');
+        if (typeof flagValue === 'string') {
+            const condition = flagValue.trim();
+            if (condition && !isClearKeyword(condition)) {
+                setExplicitGoal(condition, ctx);
+            }
+            else if (!condition) {
+                pendingDerive = true;
+            }
+        }
+    });
+    // First user prompt: if a --goal derivation is pending, derive the condition
+    // now — event.prompt carries what the user wants this turn, which is the
+    // signal to derive from. Fires once per prompt; we clear the flag after.
+    pi.on('before_agent_start', async (event, ctx) => {
+        if (!pendingDerive)
+            return;
+        pendingDerive = false;
+        const evt = event;
+        const prompt = typeof evt.prompt === 'string' ? evt.prompt : '';
+        // activate=false: the agent is about to run this prompt, so don't inject an
+        // activation message (it would throw "already processing"). The run reaches
+        // agent_end on its own, where the engine evaluates the goal.
+        await deriveAndSet(ctx, prompt, false);
+    });
+    pi.on('agent_end', async (event, ctx) => {
+        if (!state.isActive() || !config.model || !registry)
+            return;
+        if (engineRunning)
+            return; // re-entrancy guard: our own sendUserMessage re-triggers agent_end
+        const evt = event;
+        const messages = Array.isArray(evt.messages) ? evt.messages : [];
+        engineRunning = true;
+        try {
+            await runGoalEngine({
+                state,
+                config,
+                registry,
+                sendUserMessage: (content) => pi.sendUserMessage(content),
+                notify: (message, level) => ctx.ui.notify(message, level),
+                setStatus: (text) => ctx.ui.setStatus(STATUS_KEY, text),
+                ...(ctx.signal ? { signal: ctx.signal } : {}),
+            }, messages);
+        }
+        catch (err) {
+            console.error(`[pi-goal] engine error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            engineRunning = false;
+        }
+    });
+    pi.on('session_shutdown', async () => {
+        state.clear();
+        registry = undefined;
+        pendingDerive = false;
+    });
+    pi.registerFlag('goal', {
+        description: 'Set a goal at startup — Pi keeps working until the condition is met. Pass a condition, or an empty string to derive one from context.',
+        type: 'string',
+    });
+    pi.registerCommand('goal', {
+        description: 'Set a goal — Pi keeps working until the condition is met. Usage: /goal [<condition> | clear]. With no argument, derives a goal from the conversation.',
+        getArgumentCompletions: (prefix) => {
+            const options = ['clear'];
+            const matches = options.filter((o) => o.startsWith(prefix.trim().toLowerCase()));
+            return matches.map((o) => ({ label: o, value: o }));
+        },
+        handler: async (args, ctx) => {
+            const arg = args.trim();
+            // Clear
+            if (isClearKeyword(arg)) {
+                const cleared = state.clear();
+                ctx.ui.setStatus(STATUS_KEY, config.model ? 'goal: none' : 'goal: disabled (no model)');
+                ctx.ui.notify(cleared ? `Goal cleared: ${cleared.condition}` : 'No goal was set.', 'info');
+                return;
+            }
+            // Explicit condition
+            if (arg) {
+                setExplicitGoal(arg, ctx);
+                return;
+            }
+            // No argument: show status if a goal exists, else derive
+            const existing = state.get();
+            if (existing && existing.status === 'active') {
+                ctx.ui.notify(formatDetail(existing), 'info');
+                return;
+            }
+            // Interactive /goal with no arg: derive from the session's conversation
+            // history (read from the session manager, the authoritative source).
+            await deriveAndSet(ctx, '', true, readSessionMessages(ctx));
+        },
+    });
+    /** Resolved conversation messages from the session, or [] if unavailable. */
+    function readSessionMessages(ctx) {
+        try {
+            const sm = ctx.sessionManager;
+            if (!sm)
+                return [];
+            const context = buildSessionContext(sm.getEntries(), sm.getLeafId());
+            return context.messages ?? [];
+        }
+        catch {
+            return [];
+        }
+    }
+    function setExplicitGoal(condition, ctx) {
+        if (condition.length > MAX_CONDITION_LENGTH) {
+            ctx.ui.notify(`Goal condition is limited to ${MAX_CONDITION_LENGTH} characters.`, 'error');
+            return;
+        }
+        try {
+            const goal = state.set(condition, 'explicit', tokenBudgetOpts());
+            ctx.ui.setStatus(STATUS_KEY, formatStatus(goal));
+            if (config.model) {
+                pi.sendUserMessage(buildActivationMessage(goal.condition));
+            }
+            else {
+                ctx.ui.notify('Goal set, but no evaluator model is configured — auto-continuation is disabled.', 'warning');
+            }
+        }
+        catch (err) {
+            ctx.ui.notify(err instanceof Error ? err.message : 'Failed to set goal.', 'error');
+        }
+    }
+    async function deriveAndSet(ctx, extraContext = '', activate = true, history = []) {
+        if (!config.model || !registry) {
+            ctx.ui.notify('No evaluator model configured. Set `pi-goal.model` in settings, or use `/goal <condition>`.', 'warning');
+            return;
+        }
+        ctx.ui.notify('Deriving a goal from the conversation…', 'info');
+        // Fold the current turn's prompt (when derivation was triggered by --goal
+        // before any turn has run) into the conversation history, so there is
+        // always something to derive from even on a fresh session.
+        const buffered = buildTranscript(history, config.transcriptMaxChars);
+        const extra = extraContext.trim() ? `[user] ${extraContext.trim()}` : '';
+        const transcript = [buffered, extra].filter(Boolean).join('\n\n');
+        const condition = await deriveCondition({
+            registry,
+            modelConfig: config.model,
+            transcript,
+            ...(ctx.signal ? { signal: ctx.signal } : {}),
+        });
+        if (!condition) {
+            ctx.ui.notify('Could not derive a clear goal from the conversation. Try `/goal <condition>`.', 'warning');
+            return;
+        }
+        if (config.requireConfirmForDerived && ctx.hasUI) {
+            const approved = await ctx.ui.confirm('Set this goal?', `Pi will keep working until:\n\n${condition}`);
+            if (!approved) {
+                ctx.ui.notify('Goal not set.', 'info');
+                return;
+            }
+        }
+        try {
+            const goal = state.set(condition, 'derived', tokenBudgetOpts());
+            ctx.ui.setStatus(STATUS_KEY, formatStatus(goal));
+            // Only inject the activation nudge when the agent is idle (interactive
+            // /goal). When deriving at before_agent_start, the agent is already about
+            // to run the user's prompt — injecting here throws "Agent is already
+            // processing a prompt". That run naturally reaches agent_end, where the
+            // engine evaluates the goal.
+            if (activate) {
+                pi.sendUserMessage(buildActivationMessage(goal.condition));
+            }
+        }
+        catch (err) {
+            ctx.ui.notify(err instanceof Error ? err.message : 'Failed to set goal.', 'error');
+        }
+    }
+    function tokenBudgetOpts() {
+        return config.tokenBudget ? { tokenBudget: config.tokenBudget } : {};
+    }
+}
+function formatStatus(goal) {
+    if (!goal)
+        return 'goal: none';
+    if (goal.status === 'active')
+        return `goal: active (${goal.iterations})`;
+    return `goal: ${goal.status}`;
+}
+function formatDetail(goal) {
+    const lines = [
+        `Goal (${goal.origin}): ${goal.condition}`,
+        `Status: ${goal.status}`,
+        `Rounds: ${goal.iterations}`,
+    ];
+    if (goal.tokenBudget)
+        lines.push(`Tokens: ~${goal.tokensUsed} / ${goal.tokenBudget}`);
+    if (goal.lastReason)
+        lines.push(`Last check: ${goal.lastReason}`);
+    lines.push('/goal clear to stop early');
+    return lines.join('\n');
+}
+//# sourceMappingURL=extension.js.map

package/dist/extension.js.map

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

package/dist/goal-state.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Session-scoped goal state. A single active goal per session, held in memory
+ * (mirrors Claude Code's session-level activeGoal — no cross-session persistence).
+ */
+export type GoalStatus = 'active' | 'achieved' | 'impossible' | 'budget_limited' | 'iteration_limited' | 'cleared';
+export type GoalOrigin = 'derived' | 'explicit';
+export interface ActiveGoal {
+    condition: string;
+    origin: GoalOrigin;
+    status: GoalStatus;
+    iterations: number;
+    setAt: number;
+    lastReason?: string;
+    tokenBudget?: number;
+    tokensUsed: number;
+}
+/** Max length of a goal condition, matching Claude Code's 4000-char cap. */
+export declare const MAX_CONDITION_LENGTH = 4000;
+/** Keywords that clear an active goal (matches Claude Code's clear-keyword set). */
+export declare const CLEAR_KEYWORDS: Set<string>;
+export declare function isClearKeyword(arg: string): boolean;
+/**
+ * Holds the single active goal for a session. Instantiated per-session in the
+ * extension; not shared across sessions.
+ */
+export declare class GoalState {
+    private goal;
+    get(): ActiveGoal | undefined;
+    isActive(): boolean;
+    /**
+     * Set (or replace) the active goal. Throws on an empty or over-long condition
+     * so callers can surface a sanitized error to the user.
+     */
+    set(condition: string, origin: GoalOrigin, options?: {
+        tokenBudget?: number;
+    }): ActiveGoal;
+    clear(): ActiveGoal | undefined;
+    /** Record a not-yet-met round: bump iterations, store the evaluator's reason. */
+    recordIteration(reason: string, tokensUsed: number): ActiveGoal | undefined;
+    markAchieved(reason: string): ActiveGoal | undefined;
+    markImpossible(reason: string): ActiveGoal | undefined;
+    markBudgetLimited(reason?: string): ActiveGoal | undefined;
+    markIterationLimited(reason?: string): ActiveGoal | undefined;
+    private transition;
+}
+//# sourceMappingURL=goal-state.d.ts.map

package/dist/goal-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-state.d.ts","sourceRoot":"","sources":["../src/goal-state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,gBAAgB,GAChB,mBAAmB,GACnB,SAAS,CAAC;AAEd,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,oFAAoF;AACpF,eAAO,MAAM,cAAc,aAA+D,CAAC;AAE3F,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAyB;IAErC,GAAG,IAAI,UAAU,GAAG,SAAS;IAI7B,QAAQ,IAAI,OAAO;IAInB;;;OAGG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,UAAU;IAuB9F,KAAK,IAAI,UAAU,GAAG,SAAS;IAS/B,iFAAiF;IACjF,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAQ3E,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIpD,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAItD,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI1D,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI7D,OAAO,CAAC,UAAU;CAQnB"}

package/dist/goal-state.js

@@ -0,0 +1,89 @@
+/**
+ * Session-scoped goal state. A single active goal per session, held in memory
+ * (mirrors Claude Code's session-level activeGoal — no cross-session persistence).
+ */
+/** Max length of a goal condition, matching Claude Code's 4000-char cap. */
+export const MAX_CONDITION_LENGTH = 4000;
+/** Keywords that clear an active goal (matches Claude Code's clear-keyword set). */
+export const CLEAR_KEYWORDS = new Set(['clear', 'stop', 'off', 'reset', 'none', 'cancel']);
+export function isClearKeyword(arg) {
+    return CLEAR_KEYWORDS.has(arg.trim().toLowerCase());
+}
+/**
+ * Holds the single active goal for a session. Instantiated per-session in the
+ * extension; not shared across sessions.
+ */
+export class GoalState {
+    goal;
+    get() {
+        return this.goal;
+    }
+    isActive() {
+        return this.goal?.status === 'active';
+    }
+    /**
+     * Set (or replace) the active goal. Throws on an empty or over-long condition
+     * so callers can surface a sanitized error to the user.
+     */
+    set(condition, origin, options = {}) {
+        const trimmed = condition.trim();
+        if (!trimmed) {
+            throw new Error('Goal condition cannot be empty');
+        }
+        if (trimmed.length > MAX_CONDITION_LENGTH) {
+            throw new Error(`Goal condition is limited to ${MAX_CONDITION_LENGTH} characters`);
+        }
+        const goal = {
+            condition: trimmed,
+            origin,
+            status: 'active',
+            iterations: 0,
+            setAt: Date.now(),
+            tokensUsed: 0,
+        };
+        if (typeof options.tokenBudget === 'number' && options.tokenBudget > 0) {
+            goal.tokenBudget = options.tokenBudget;
+        }
+        this.goal = goal;
+        return goal;
+    }
+    clear() {
+        const previous = this.goal;
+        if (previous) {
+            previous.status = 'cleared';
+        }
+        this.goal = undefined;
+        return previous;
+    }
+    /** Record a not-yet-met round: bump iterations, store the evaluator's reason. */
+    recordIteration(reason, tokensUsed) {
+        if (!this.goal)
+            return undefined;
+        this.goal.iterations += 1;
+        this.goal.lastReason = reason;
+        this.goal.tokensUsed = tokensUsed;
+        return this.goal;
+    }
+    markAchieved(reason) {
+        return this.transition('achieved', reason);
+    }
+    markImpossible(reason) {
+        return this.transition('impossible', reason);
+    }
+    markBudgetLimited(reason) {
+        return this.transition('budget_limited', reason);
+    }
+    markIterationLimited(reason) {
+        return this.transition('iteration_limited', reason);
+    }
+    transition(status, reason) {
+        if (!this.goal)
+            return undefined;
+        this.goal.status = status;
+        if (reason !== undefined) {
+            this.goal.lastReason = reason;
+        }
+        return this.goal;
+    }
+}
+//# sourceMappingURL=goal-state.js.map

package/dist/goal-state.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { DEFAULTS, type GoalModelConfig, loadSettings, type PiGoalConfig, type ResolvedGoalConfig, resolveConfig, } from './config.js';
+export { type DeriveOptions, deriveCondition } from './derive.js';
+export { type EvaluateOptions, evaluateCondition, type GoalVerdict, parseVerdict, } from './evaluate.js';
+export { default, type GoalEngineDeps, type PiGoalExtensionConfig, runGoalEngine, } from './extension.js';
+export { type ActiveGoal, CLEAR_KEYWORDS, type GoalOrigin, GoalState, type GoalStatus, isClearKeyword, MAX_CONDITION_LENGTH, } from './goal-state.js';
+export { completeOnce, type GoalModelRegistry } from './llm.js';
+export { buildActivationMessage, buildContinueMessage, buildDeriveUserPrompt, buildEvaluateUserPrompt, buildTruncationNote, DERIVE_SYSTEM_PROMPT, EVALUATE_SYSTEM_PROMPT, } from './prompts.js';
+export { buildTranscript, buildTranscriptWithMeta, extractText, type TranscriptResult, } from './transcript.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EACL,KAAK,eAAe,EACpB,iBAAiB,EACjB,KAAK,WAAW,EAChB,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,UAAU,EACf,cAAc,EACd,KAAK,UAAU,EACf,SAAS,EACT,KAAK,UAAU,EACf,cAAc,EACd,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,WAAW,EACX,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { DEFAULTS, loadSettings, resolveConfig, } from './config.js';
+export { deriveCondition } from './derive.js';
+export { evaluateCondition, parseVerdict, } from './evaluate.js';
+export { default, runGoalEngine, } from './extension.js';
+export { CLEAR_KEYWORDS, GoalState, isClearKeyword, MAX_CONDITION_LENGTH, } from './goal-state.js';
+export { completeOnce } from './llm.js';
+export { buildActivationMessage, buildContinueMessage, buildDeriveUserPrompt, buildEvaluateUserPrompt, buildTruncationNote, DERIVE_SYSTEM_PROMPT, EVALUATE_SYSTEM_PROMPT, } from './prompts.js';
+export { buildTranscript, buildTranscriptWithMeta, extractText, } from './transcript.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAER,YAAY,EAGZ,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAsB,eAAe,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAEL,iBAAiB,EAEjB,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,OAAO,EAGP,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,cAAc,EAEd,SAAS,EAET,cAAc,EACd,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAA0B,MAAM,UAAU,CAAC;AAChE,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,WAAW,GAEZ,MAAM,iBAAiB,CAAC"}

package/dist/llm.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Single-turn, tool-less LLM completion helper shared by the derive and
+ * evaluate steps. Wraps pi-agent-core's Agent + pi-ai's streamSimple, the same
+ * primitives pi-memory uses for background work.
+ */
+import type { GoalModelConfig } from './config.js';
+/** Minimal slice of ctx.modelRegistry we depend on (kept narrow for testability). */
+export interface GoalModelRegistry {
+    find(provider: string, model: string): unknown;
+    getApiKeyAndHeaders(model: unknown): Promise<{
+        ok: boolean;
+        apiKey?: string;
+        headers?: Record<string, string>;
+        error?: string;
+    }>;
+}
+/**
+ * Run one system+user prompt through the model and return the assistant's text.
+ * Returns null on any resolution/auth failure so callers can degrade gracefully
+ * (never throws for expected failures).
+ */
+export declare function completeOnce(registry: GoalModelRegistry, modelConfig: GoalModelConfig, systemPrompt: string, userPrompt: string, signal?: AbortSignal): Promise<string | null>;
+//# sourceMappingURL=llm.d.ts.map

package/dist/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,qFAAqF;AACrF,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/C,mBAAmB,CACjB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChG;AAOD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,EAAE,eAAe,EAC5B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsCxB"}

package/dist/llm.js

@@ -0,0 +1,79 @@
+/**
+ * Single-turn, tool-less LLM completion helper shared by the derive and
+ * evaluate steps. Wraps pi-agent-core's Agent + pi-ai's streamSimple, the same
+ * primitives pi-memory uses for background work.
+ */
+import { Agent } from '@earendil-works/pi-agent-core';
+import { streamSimple } from '@earendil-works/pi-ai/compat';
+/**
+ * Run one system+user prompt through the model and return the assistant's text.
+ * Returns null on any resolution/auth failure so callers can degrade gracefully
+ * (never throws for expected failures).
+ */
+export async function completeOnce(registry, modelConfig, systemPrompt, userPrompt, signal) {
+    const model = registry.find(modelConfig.provider, modelConfig.model);
+    if (!model)
+        return null;
+    const auth = await registry.getApiKeyAndHeaders(model);
+    if (!auth.ok)
+        return null;
+    const agent = new Agent({
+        initialState: {
+            systemPrompt,
+            model: model,
+            tools: [],
+        },
+        streamFn: (m, c, streamOpts) => {
+            const merged = { ...(streamOpts ?? {}) };
+            if (auth.apiKey)
+                merged.apiKey = auth.apiKey;
+            if (auth.headers)
+                merged.headers = auth.headers;
+            const existingSignal = streamOpts?.signal;
+            if (!existingSignal && signal)
+                merged.signal = signal;
+            return streamSimple(m, c, merged);
+        },
+        convertToLlm: (msgs) => msgs,
+    });
+    // Tool-less: a single assistant turn ends the run. Guard against runaway anyway.
+    agent.subscribe((event) => {
+        if (event.type === 'turn_end') {
+            void agent.abort();
+        }
+    });
+    try {
+        await agent.prompt(userPrompt);
+    }
+    catch {
+        return null;
+    }
+    return lastAssistantText(agent.state.messages);
+}
+function lastAssistantText(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (msg?.role !== 'assistant')
+            continue;
+        const text = extractText(msg.content);
+        if (text)
+            return text;
+    }
+    return null;
+}
+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=llm.js.map

package/dist/llm.js.map

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

package/dist/prompts.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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 declare const DERIVE_SYSTEM_PROMPT = "You infer a single, concrete completion condition from a coding conversation.\n\nGiven 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.\n\nRules:\n- Output ONLY the condition text \u2014 no preamble, no quotes, no markdown, no trailing explanation.\n- 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\").\n- Base it on the user's most recent intent, not incidental side-quests.\n- Keep it under 300 characters.\n- If the conversation has no actionable objective, output exactly: NONE";
+export declare function buildDeriveUserPrompt(transcript: string): string;
+/**
+ * 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 declare 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.\n\nYour response must be a JSON object with one of these shapes:\n- {\"ok\": true, \"reason\": \"<quote evidence from the transcript that satisfies the condition>\"}\n- {\"ok\": false, \"reason\": \"<quote what is missing or what blocks the condition>\"}\n- {\"ok\": false, \"impossible\": true, \"reason\": \"<explain why the condition can never be satisfied>\"}\n\nAlways 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\"}.\n\nOnly use {\"ok\": false, \"impossible\": true} when the condition is genuinely unachievable in this session \u2014 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 \u2014 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 declare function buildTruncationNote(omittedCount: number): string;
+export declare function buildEvaluateUserPrompt(condition: string, transcript: string, omittedCount?: number): string;
+/**
+ * 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 declare function buildActivationMessage(condition: string): string;
+/** Injected after a not-yet-met evaluation to drive the next round of work. */
+export declare function buildContinueMessage(condition: string, reason: string): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,oBAAoB,qwBASuC,CAAC;AAEzE,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,w9CAS0pB,CAAC;AAE9rB;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,YAAY,SAAI,GACf,MAAM,CAGR;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9E"}