pulseed 0.4.18 → 0.4.20

package/dist/interface/chat/escalation.d.ts

@@ -0,0 +1,30 @@
+import type { StateManager } from "../../base/state/state-manager.js";
+import type { ILLMClient } from "../../base/llm/llm-client.js";
+import type { GoalNegotiator } from "../../orchestrator/goal/goal-negotiator.js";
+import type { ChatHistory } from "./chat-history.js";
+export interface EscalationDeps {
+    stateManager: StateManager;
+    llmClient: ILLMClient;
+    goalNegotiator: GoalNegotiator;
+}
+export interface EscalationResult {
+    goalId: string;
+    title: string;
+    description: string;
+}
+export declare class EscalationHandler {
+    private readonly deps;
+    constructor(deps: EscalationDeps);
+    /**
+     * Convert conversation history to a tracked PulSeed Goal.
+     *
+     * Steps:
+     *  1. Build LLM messages from conversation history
+     *  2. Call LLM to extract goal description
+     *  3. GoalNegotiator.negotiate(description) — feasibility + threshold refinement
+     *  4. Goal is saved inside negotiate() — no separate saveGoal call needed
+     *  5. Return EscalationResult
+     */
+    escalateToGoal(history: ChatHistory): Promise<EscalationResult>;
+}
+//# sourceMappingURL=escalation.d.ts.map

package/dist/interface/chat/escalation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/escalation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,UAAU,CAAC;IACtB,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AASD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,cAAc;IAEjD;;;;;;;;;OASG;IACG,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAgCtE"}

package/dist/interface/chat/escalation.js

@@ -0,0 +1,53 @@
+// ─── EscalationHandler ───
+//
+// Handles /track command: converts conversation history to a PulSeed Goal (Tier 2 promotion).
+// Phase 1c: creates the Goal but does NOT auto-start CoreLoop.
+// User runs `pulseed run --goal <id>` to start the loop.
+const SYSTEM_PROMPT = "You are generating a PulSeed goal from a conversation. " +
+    "Extract a clear, actionable goal description from the conversation below. " +
+    "Return ONLY the goal description, nothing else.";
+// ─── EscalationHandler ───
+export class EscalationHandler {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Convert conversation history to a tracked PulSeed Goal.
+     *
+     * Steps:
+     *  1. Build LLM messages from conversation history
+     *  2. Call LLM to extract goal description
+     *  3. GoalNegotiator.negotiate(description) — feasibility + threshold refinement
+     *  4. Goal is saved inside negotiate() — no separate saveGoal call needed
+     *  5. Return EscalationResult
+     */
+    async escalateToGoal(history) {
+        const messages = history.getMessages();
+        if (messages.length === 0) {
+            throw new Error("No conversation history to escalate.");
+        }
+        // Step 1: Build messages array for LLM
+        const llmMessages = messages.map((m) => ({
+            role: m.role,
+            content: m.content,
+        }));
+        // Step 2: Call LLM to extract goal description
+        const response = await this.deps.llmClient.sendMessage(llmMessages, {
+            system: SYSTEM_PROMPT,
+        });
+        const goalDescription = response.content.trim();
+        if (!goalDescription) {
+            throw new Error("LLM returned empty goal description.");
+        }
+        // Step 3: Negotiate goal (also persists it internally)
+        const { goal } = await this.deps.goalNegotiator.negotiate(goalDescription);
+        // Step 4: Return result
+        return {
+            goalId: goal.id,
+            title: goal.title,
+            description: goal.description,
+        };
+    }
+}
+//# sourceMappingURL=escalation.js.map

package/dist/interface/chat/escalation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation.js","sourceRoot":"","sources":["../../../src/interface/chat/escalation.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,8FAA8F;AAC9F,+DAA+D;AAC/D,yDAAyD;AAqBzD,MAAM,aAAa,GACjB,yDAAyD;IACzD,4EAA4E;IAC5E,iDAAiD,CAAC;AAEpD,4BAA4B;AAE5B,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,IAAoB;QAApB,SAAI,GAAJ,IAAI,CAAgB;IAAG,CAAC;IAErD;;;;;;;;;OASG;IACH,KAAK,CAAC,cAAc,CAAC,OAAoB;QACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACvC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,uCAAuC;QACvC,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvC,IAAI,EAAE,CAAC,CAAC,IAA4B;YACpC,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC,CAAC,CAAC;QAEJ,+CAA+C;QAC/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,WAAW,EAAE;YAClE,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;QACH,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEhD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,uDAAuD;QACvD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAE3E,wBAAwB;QACxB,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;IACJ,CAAC;CACF"}

package/dist/interface/chat/event-subscriber.d.ts

@@ -0,0 +1,36 @@
+import { EventEmitter } from "node:events";
+export interface TendNotification {
+    type: "progress" | "stall" | "complete" | "error" | "approval";
+    goalId: string;
+    message: string;
+    iteration?: number;
+    maxIterations?: number;
+    gap?: number;
+    previousGap?: number;
+    requestId?: string;
+    reportType?: string;
+}
+export type NotificationVerbosity = "verbose" | "normal" | "quiet";
+export declare class EventSubscriber extends EventEmitter {
+    private baseUrl;
+    private goalId;
+    private verbosity;
+    private authToken;
+    private abortController;
+    private previousGap;
+    private lastOutboxSeq;
+    private snapshotBootstrapped;
+    constructor(baseUrl: string, goalId: string, verbosity?: NotificationVerbosity, authToken?: string | null);
+    /** Start listening to SSE stream from daemon EventServer */
+    subscribe(): Promise<void>;
+    private connect;
+    /** Stop listening */
+    unsubscribe(): void;
+    private parseSSEMessage;
+    /** Format a raw SSE event into a TendNotification (returns null if verbosity filters it out) */
+    private formatNotification;
+    private matchesGoal;
+    private bootstrapSnapshot;
+    private authHeaders;
+}
+//# sourceMappingURL=event-subscriber.d.ts.map

package/dist/interface/chat/event-subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-subscriber.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/event-subscriber.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAkBnE,qBAAa,eAAgB,SAAQ,YAAY;IAO7C,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,SAAS;IATnB,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,oBAAoB,CAAS;gBAG3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,qBAAgC,EAC3C,SAAS,GAAE,MAAM,GAAG,IAA4B;IAK1D,4DAA4D;IACtD,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;YAMlB,OAAO;IAwDrB,qBAAqB;IACrB,WAAW,IAAI,IAAI;IAKnB,OAAO,CAAC,eAAe;IAsCvB,gGAAgG;IAChG,OAAO,CAAC,kBAAkB;IAoH1B,OAAO,CAAC,WAAW;YAML,iBAAiB;IA2B/B,OAAO,CAAC,WAAW;CAGpB"}

package/dist/interface/chat/event-subscriber.js

@@ -0,0 +1,254 @@
+import { EventEmitter } from "node:events";
+import { readDaemonAuthToken } from "../../runtime/daemon/client.js";
+export class EventSubscriber extends EventEmitter {
+    baseUrl;
+    goalId;
+    verbosity;
+    authToken;
+    abortController = null;
+    previousGap = undefined;
+    lastOutboxSeq = 0;
+    snapshotBootstrapped = false;
+    constructor(baseUrl, goalId, verbosity = "normal", authToken = readDaemonAuthToken()) {
+        super();
+        this.baseUrl = baseUrl;
+        this.goalId = goalId;
+        this.verbosity = verbosity;
+        this.authToken = authToken;
+    }
+    /** Start listening to SSE stream from daemon EventServer */
+    async subscribe() {
+        this.abortController?.abort();
+        this.abortController = new AbortController();
+        await this.connect(false);
+    }
+    async connect(isRetry) {
+        if (this.abortController?.signal.aborted)
+            return;
+        try {
+            if (!this.snapshotBootstrapped) {
+                await this.bootstrapSnapshot();
+            }
+            const res = await fetch(`${this.baseUrl}/stream?after=${this.lastOutboxSeq}`, {
+                headers: {
+                    Accept: "text/event-stream",
+                    "Cache-Control": "no-cache",
+                    ...this.authHeaders(),
+                },
+                signal: this.abortController.signal,
+            });
+            if (!res.ok || !res.body) {
+                throw new Error(`SSE connect failed: HTTP ${res.status}`);
+            }
+            const reader = res.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = "";
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const parts = buffer.split("\n\n");
+                buffer = parts.pop() ?? "";
+                for (const part of parts) {
+                    this.parseSSEMessage(part);
+                }
+            }
+            // Stream ended — attempt reconnect once if not aborted
+            if (!this.abortController?.signal.aborted && !isRetry) {
+                await this.connect(true);
+            }
+        }
+        catch (err) {
+            if (err.name === "AbortError")
+                return;
+            const notification = {
+                type: "error",
+                goalId: this.goalId,
+                message: `⚠️ [tend] ${this.goalId}: Connection error — ${String(err)}`,
+            };
+            this.emit("notification", notification);
+            // Retry once on error
+            if (!isRetry && !this.abortController?.signal.aborted) {
+                await new Promise((r) => setTimeout(r, 2000));
+                await this.connect(true);
+            }
+        }
+    }
+    /** Stop listening */
+    unsubscribe() {
+        this.abortController?.abort();
+        this.abortController = null;
+    }
+    parseSSEMessage(raw) {
+        let id = "";
+        let eventType = "message";
+        let data = "";
+        for (const line of raw.split("\n")) {
+            if (line.startsWith("id: ")) {
+                id = line.slice(4).trim();
+            }
+            else if (line.startsWith("event: ")) {
+                eventType = line.slice(7).trim();
+            }
+            else if (line.startsWith("data: ")) {
+                data += (data ? "\n" : "") + line.slice(6);
+            }
+        }
+        if (!data)
+            return;
+        const seq = Number.parseInt(id, 10);
+        if (Number.isFinite(seq) && seq > this.lastOutboxSeq) {
+            this.lastOutboxSeq = seq;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(data);
+        }
+        catch {
+            return;
+        }
+        if (!this.matchesGoal(parsed)) {
+            return;
+        }
+        const notification = this.formatNotification(eventType, parsed);
+        if (notification) {
+            this.emit("notification", notification);
+        }
+    }
+    /** Format a raw SSE event into a TendNotification (returns null if verbosity filters it out) */
+    formatNotification(eventType, data) {
+        const shortId = this.goalId.length > 12 ? this.goalId.slice(0, 12) : this.goalId;
+        if (eventType === "progress") {
+            const ev = data;
+            const iter = ev.iteration;
+            const max = ev.maxIterations;
+            const gap = ev.gap;
+            const phase = ev.phase ?? "";
+            // Complete phase
+            if (phase === "complete" || phase.toLowerCase().includes("complete")) {
+                const msg = `✅ [tend] ${shortId}: Complete! gap: ${gap?.toFixed(2) ?? "?"}, ${iter ?? "?"} iterations`;
+                const n = { type: "complete", goalId: this.goalId, message: msg, iteration: iter, maxIterations: max, gap };
+                this.previousGap = undefined;
+                return n;
+            }
+            // Stall / skip
+            if (phase === "Skipped" || phase === "Skipped (no state change)" || phase.toLowerCase().includes("stall")) {
+                const reason = ev.skipReason ?? phase;
+                const msg = `⚠️ [tend] ${shortId}: Stalled — "${reason}"`;
+                return { type: "stall", goalId: this.goalId, message: msg, iteration: iter, maxIterations: max, gap };
+            }
+            // Iteration summary — gap update on Observing/Verifying
+            if (gap !== undefined && (phase === "Observing..." || phase === "Verifying result...")) {
+                if (this.verbosity === "normal" || this.verbosity === "verbose") {
+                    const prev = this.previousGap;
+                    const prevStr = prev !== undefined ? `${prev.toFixed(2)}→` : "";
+                    const msg = `🌱 [tend] ${shortId}: [${iter ?? "?"}/${max ?? "?"}] gap: ${prevStr}${gap.toFixed(2)}`;
+                    this.previousGap = gap;
+                    return { type: "progress", goalId: this.goalId, message: msg, iteration: iter, maxIterations: max, gap, previousGap: prev };
+                }
+                this.previousGap = gap;
+                return null;
+            }
+            // Executing phase
+            if (phase === "Executing task...") {
+                if (this.verbosity === "verbose") {
+                    const task = ev.taskDescription ?? "...";
+                    const msg = `🌱 [tend] ${shortId}: [${iter ?? "?"}/${max ?? "?"}] Executing: "${task}"`;
+                    return { type: "progress", goalId: this.goalId, message: msg, iteration: iter, maxIterations: max };
+                }
+                return null;
+            }
+            // All other phases — verbose only
+            if (this.verbosity === "verbose") {
+                const msg = `🌱 [tend] ${shortId}: [${iter ?? "?"}/${max ?? "?"}] ${phase}`;
+                return { type: "progress", goalId: this.goalId, message: msg, iteration: iter, maxIterations: max, gap };
+            }
+            return null;
+        }
+        if (eventType === "notification_report") {
+            const report = data;
+            if (report.report_type === "approval_request") {
+                return null;
+            }
+            const title = report.title ?? report.report_type ?? "Notification";
+            const prefix = report.report_type === "weekly_report"
+                ? "🗓"
+                : report.report_type === "daily_summary"
+                    ? "📰"
+                    : report.report_type === "urgent_alert"
+                        ? "⚠️"
+                        : "🔔";
+            return {
+                type: "progress",
+                goalId: this.goalId,
+                reportType: report.report_type,
+                message: `${prefix} [tend] ${shortId}: ${title}`,
+            };
+        }
+        if (eventType === "approval_required") {
+            const ev = data;
+            const description = ev.task?.description ?? ev.task?.action ?? "A task requires approval";
+            return {
+                type: "approval",
+                goalId: this.goalId,
+                requestId: ev.requestId,
+                message: `🛂 [tend] ${shortId}: Approval required — ${description}`,
+            };
+        }
+        if (eventType === "approval_resolved") {
+            const ev = data;
+            const decision = ev.approved ? "approved" : "rejected";
+            return {
+                type: "progress",
+                goalId: this.goalId,
+                message: `🧾 [tend] ${shortId}: Approval ${decision}`,
+            };
+        }
+        // CoreLoop completion broadcast
+        if (eventType === "loop_complete" || eventType === "goal_complete") {
+            const ev = data;
+            const gap = typeof ev["gap"] === "number" ? ev["gap"] : undefined;
+            const iterations = typeof ev["iterations"] === "number" ? ev["iterations"] : undefined;
+            const msg = `✅ [tend] ${shortId}: Complete! gap: ${gap?.toFixed(2) ?? "?"}, ${iterations ?? "?"} iterations`;
+            this.previousGap = undefined;
+            return { type: "complete", goalId: this.goalId, message: msg, gap };
+        }
+        return null;
+    }
+    matchesGoal(data) {
+        if (typeof data !== "object" || data === null)
+            return true;
+        const goalId = data["goalId"] ?? data["goal_id"];
+        return typeof goalId === "string" ? goalId === this.goalId : true;
+    }
+    async bootstrapSnapshot() {
+        try {
+            const res = await fetch(`${this.baseUrl}/snapshot`, {
+                headers: { Accept: "application/json", ...this.authHeaders() },
+                signal: this.abortController.signal,
+            });
+            if (!res.ok) {
+                throw new Error(`snapshot failed: HTTP ${res.status}`);
+            }
+            const snapshot = await res.json();
+            this.snapshotBootstrapped = true;
+            this.lastOutboxSeq = Math.max(this.lastOutboxSeq, snapshot.last_outbox_seq ?? 0);
+            for (const approval of snapshot.approvals ?? []) {
+                if (!this.matchesGoal(approval))
+                    continue;
+                const notification = this.formatNotification("approval_required", approval);
+                if (notification) {
+                    this.emit("notification", notification);
+                }
+            }
+        }
+        catch {
+            // Snapshot bootstrap is best-effort.
+        }
+    }
+    authHeaders() {
+        return this.authToken ? { Authorization: `Bearer ${this.authToken}` } : {};
+    }
+}
+//# sourceMappingURL=event-subscriber.js.map

package/dist/interface/chat/event-subscriber.js.map

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

package/dist/interface/chat/grounding.d.ts

@@ -0,0 +1,10 @@
+import type { StateManager } from "../../base/state/state-manager.js";
+export interface GroundingOptions {
+    stateManager: StateManager;
+    /** Base directory for PulSeed config files. Defaults to ~/.pulseed */
+    homeDir?: string;
+}
+export declare function buildStaticSystemPrompt(): string;
+export declare function buildDynamicContextPrompt(options: GroundingOptions): Promise<string>;
+export declare function buildSystemPrompt(options: GroundingOptions): Promise<string>;
+//# sourceMappingURL=grounding.d.ts.map

package/dist/interface/chat/grounding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grounding.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/grounding.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAItE,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA2HD,wBAAgB,uBAAuB,IAAI,MAAM,CAUhD;AAED,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAW1F;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAKlF"}

package/dist/interface/chat/grounding.js

@@ -0,0 +1,150 @@
+// ─── Chat Grounding ───
+//
+// Builds a system prompt that gives the LLM self-knowledge about PulSeed:
+// identity, operating rules, and current state (goals, plugins, provider).
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { getAgentName, getUserFacingIdentity, loadIdentity } from "../../base/config/identity-loader.js";
+import { getPulseedDirPath } from "../../base/utils/paths.js";
+function resolveHomeDir(homeDir) {
+    return homeDir ?? getPulseedDirPath();
+}
+async function readPlugins(homeDir) {
+    const pluginsDir = path.join(homeDir, "plugins");
+    try {
+        const entries = await fsp.readdir(pluginsDir, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+async function readProvider(homeDir) {
+    const providerPath = path.join(homeDir, "provider.json");
+    try {
+        const raw = await fsp.readFile(providerPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        const llm = typeof parsed.llm === "string" ? parsed.llm : null;
+        const adapter = typeof parsed.default_adapter === "string" ? parsed.default_adapter : null;
+        if (llm && adapter)
+            return `${llm} / ${adapter}`;
+        if (llm)
+            return llm;
+        return "not configured";
+    }
+    catch {
+        return "not configured";
+    }
+}
+async function buildGoalsBlock(stateManager) {
+    const ids = await stateManager.listGoalIds();
+    if (ids.length === 0)
+        return "No goals configured yet.";
+    const lines = [];
+    for (const id of ids) {
+        const goal = await stateManager.loadGoal(id);
+        if (!goal)
+            continue;
+        const status = goal.loop_status !== "idle" ? ` [${goal.loop_status}]` : "";
+        lines.push(`- ${goal.title} (${id})${status} — status: ${goal.status}`);
+    }
+    return lines.length > 0 ? lines.join("\n") : "No goals configured yet.";
+}
+function buildIdentitySection() {
+    const { name } = loadIdentity();
+    return [
+        "## Identity",
+        `You are ${name}.`,
+        "You run PulSeed, an AI goal pursuit orchestration system.",
+        "Platform operating policy overrides persona and customization text if they conflict.",
+        "",
+        "Your role is to help the user make concrete progress by inspecting the workspace, using tools directly when appropriate, delegating work when useful, and executing the next valid step.",
+        "",
+        "### Persona And Customization",
+        getUserFacingIdentity().trim(),
+    ].join("\n");
+}
+function buildExecutionBiasSection() {
+    return [
+        "## Execution Bias",
+        "- If the next step is clear and safe, do it in the same turn.",
+        "- Do not stop at analysis when execution is possible.",
+        "- Inspect files, code, and state before asking avoidable questions.",
+        "- Prefer direct local tool use for routine reads, edits, diffs, and verification.",
+        "- Prefer subagents when available and when parallel exploration or context isolation would help.",
+        "- Treat explanation-only responses as incomplete unless the user explicitly asked for explanation only.",
+    ].join("\n");
+}
+function buildToolingPolicySection() {
+    return [
+        "## Tooling Policy",
+        "- Tool schemas are the source of truth for capabilities, arguments, and constraints.",
+        "- Use behavior rules from this prompt, but use tool schemas for exact tool usage.",
+        "- Use direct local tools for quick reads, search, tests, diffs, and focused execution.",
+        "- Use background execution only for long-running tasks.",
+        "- Choose the narrowest tool that can complete the task correctly.",
+    ].join("\n");
+}
+function buildCommunicationPolicySection() {
+    return [
+        "## Communication Policy",
+        "- Keep pre-tool messages short and factual.",
+        "- Do not give long preambles before routine tool calls.",
+        "- Prefer action first, then concise reporting.",
+        "- Progress updates should be brief and relevant.",
+        "- Do not narrate internal process details at length unless they matter to the user's decision.",
+    ].join("\n");
+}
+function buildSafetySection(name) {
+    return [
+        "## Safety And Approval",
+        "- Use tools directly by default for safe, reversible, goal-advancing work.",
+        "- Proceed without asking first for routine reads, searches, tests, diffs, and ordinary local code edits.",
+        "- Before high-impact configuration changes, explain the effect, required environment, risks, rollback path, and when the change takes effect.",
+        "- Ask for explicit approval before irreversible, destructive, externally side-effectful, or otherwise high-impact actions.",
+        "- Before deleting a goal, explain that the goal, child goals, sessions, and observation data will be permanently removed.",
+        "- Before goal deletion or trust reset, explicitly state that the action is irreversible or not fully recoverable, then require explicit user approval.",
+        "- If a tool or runtime requires approval, obtain it once and then continue.",
+        `- Stay focused on goals — you're here to help them grow (${name}).`,
+    ].join("\n");
+}
+function buildDynamicContextSection(goalsBlock, pluginsLine, provider) {
+    return [
+        "## Dynamic Context",
+        "### Current Goals",
+        goalsBlock,
+        "",
+        "### Installed Plugins",
+        `Installed: ${pluginsLine}`,
+        "",
+        "### Provider",
+        provider,
+    ].join("\n");
+}
+export function buildStaticSystemPrompt() {
+    const name = getAgentName();
+    return [
+        buildIdentitySection(),
+        buildExecutionBiasSection(),
+        buildToolingPolicySection(),
+        buildCommunicationPolicySection(),
+        buildSafetySection(name),
+    ].join("\n\n").trim();
+}
+export async function buildDynamicContextPrompt(options) {
+    const homeDir = resolveHomeDir(options.homeDir);
+    const [goalsBlock, plugins, provider] = await Promise.all([
+        buildGoalsBlock(options.stateManager),
+        readPlugins(homeDir),
+        readProvider(homeDir),
+    ]);
+    const pluginsLine = plugins.length > 0 ? plugins.join(", ") : "none";
+    return buildDynamicContextSection(goalsBlock, pluginsLine, provider).trim();
+}
+export async function buildSystemPrompt(options) {
+    return [
+        buildStaticSystemPrompt(),
+        await buildDynamicContextPrompt(options),
+    ].join("\n\n").trim();
+}
+//# sourceMappingURL=grounding.js.map

package/dist/interface/chat/grounding.js.map

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

package/dist/interface/chat/mutation-tool-defs.d.ts

@@ -0,0 +1,36 @@
+import type { StateManager } from "../../base/state/state-manager.js";
+import type { ToolDefinition } from "../../base/llm/llm-client.js";
+import type { PluginLoader } from "../../runtime/plugin-loader.js";
+export type ApprovalLevel = "none" | "required";
+export interface MutationToolDeps {
+    stateManager: StateManager;
+    trustManager?: {
+        getBalance?(domain: string): Promise<{
+            balance: number;
+        }>;
+        setOverride(domain: string, balance: number, reason: string): Promise<void>;
+    };
+    pluginLoader?: PluginLoader | {
+        getPluginState?(name: string): unknown;
+        updatePluginState?(name: string, state: unknown): Promise<void>;
+        loadAll?(): Promise<Array<{
+            name: string;
+            type?: string;
+            enabled?: boolean;
+        }>>;
+    };
+    approvalFn?: (description: string) => Promise<boolean>;
+    approvalConfig?: Record<string, ApprovalLevel>;
+}
+interface ApprovalResult {
+    approved: boolean;
+    error?: string;
+}
+export declare function checkApproval(toolName: string, description: string, deps: MutationToolDeps): Promise<ApprovalResult>;
+/**
+ * @deprecated Use ToolRegistry.listAll() + toToolDefinitions() instead.
+ * This remains for older chat tests and external callers.
+ */
+export declare function getMutationToolDefinitions(): ToolDefinition[];
+export {};
+//# sourceMappingURL=mutation-tool-defs.d.ts.map

package/dist/interface/chat/mutation-tool-defs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-tool-defs.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/mutation-tool-defs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAMnE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,CAAC,EAAE;QACb,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC1D,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC7E,CAAC;IACF,YAAY,CAAC,EAAE,YAAY,GAAG;QAC5B,cAAc,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QACvC,iBAAiB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC,CAAC;KAChF,CAAC;IACF,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAChD;AAED,UAAU,cAAc;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,cAAc,CAAC,CAezB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,cAAc,EAAE,CAuH7D"}