pulseed 0.1.3 → 0.1.5

package/dist/chat/self-knowledge-tools.d.ts

@@ -0,0 +1,22 @@
+import type { StateManager } from "../state/state-manager.js";
+import type { ToolDefinition } from "../llm/llm-client.js";
+export type { ToolDefinition };
+export interface SelfKnowledgeDeps {
+    stateManager: StateManager;
+    trustManager?: {
+        getBalance(domain: string): Promise<{
+            balance: number;
+        }>;
+    };
+    pluginLoader?: {
+        loadAll(): Promise<Array<{
+            name: string;
+            type?: string;
+            enabled?: boolean;
+        }>>;
+    };
+    homeDir: string;
+}
+export declare function getSelfKnowledgeToolDefinitions(): ToolDefinition[];
+export declare function handleSelfKnowledgeToolCall(toolName: string, args: Record<string, unknown>, deps: SelfKnowledgeDeps): Promise<string>;
+//# sourceMappingURL=self-knowledge-tools.d.ts.map

package/dist/chat/self-knowledge-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-knowledge-tools.d.ts","sourceRoot":"","sources":["../../src/chat/self-knowledge-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,cAAc,EAAE,CAAC;AAI/B,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,CAAC,EAAE;QAAE,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAC5E,YAAY,CAAC,EAAE;QAAE,OAAO,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,CAAA;KAAE,CAAC;IACjG,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,wBAAgB,+BAA+B,IAAI,cAAc,EAAE,CAsFlE;AAwKD,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,MAAM,CAAC,CAiBjB"}

package/dist/chat/self-knowledge-tools.js

@@ -0,0 +1,261 @@
+import * as fs from "fs";
+import * as path from "path";
+// ─── Tool Definitions ───
+export function getSelfKnowledgeToolDefinitions() {
+    return [
+        {
+            type: "function",
+            function: {
+                name: "get_goals",
+                description: "Returns detailed information about all goals: title, description, thresholds, status, loop_status, confidence, current_state, and gap_score.",
+                parameters: {
+                    type: "object",
+                    properties: {},
+                    required: [],
+                },
+            },
+        },
+        {
+            type: "function",
+            function: {
+                name: "get_sessions",
+                description: "Returns recent session history including goal_id, adapter, status, duration, and created_at.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        limit: {
+                            type: "number",
+                            description: "Number of recent sessions to return (default: 5)",
+                        },
+                    },
+                    required: [],
+                },
+            },
+        },
+        {
+            type: "function",
+            function: {
+                name: "get_trust_state",
+                description: "Returns the current trust state: trust_score, balance range, delta_success, delta_failure, high_trust_threshold, ethics_gate_level, and execution_boundary.",
+                parameters: {
+                    type: "object",
+                    properties: {},
+                    required: [],
+                },
+            },
+        },
+        {
+            type: "function",
+            function: {
+                name: "get_config",
+                description: "Returns runtime configuration: provider, model, default_adapter, and pulseed_home_dir.",
+                parameters: {
+                    type: "object",
+                    properties: {},
+                    required: [],
+                },
+            },
+        },
+        {
+            type: "function",
+            function: {
+                name: "get_plugins",
+                description: "Returns the list of installed plugins with name, type, and enabled status.",
+                parameters: {
+                    type: "object",
+                    properties: {},
+                    required: [],
+                },
+            },
+        },
+        {
+            type: "function",
+            function: {
+                name: "get_architecture",
+                description: "Returns a static description of PulSeed architecture, layer structure, core loop, 4-element model, and execution boundary.",
+                parameters: {
+                    type: "object",
+                    properties: {},
+                    required: [],
+                },
+            },
+        },
+    ];
+}
+// ─── Handlers ───
+async function handleGetGoals(deps) {
+    const goalIds = await deps.stateManager.listGoalIds();
+    if (goalIds.length === 0) {
+        return JSON.stringify({ goals: [], message: "No goals found." });
+    }
+    const goals = await Promise.all(goalIds.map(async (id) => {
+        const goal = await deps.stateManager.loadGoal(id);
+        if (!goal)
+            return null;
+        return {
+            id: goal.id,
+            title: goal.title,
+            description: goal.description,
+            status: goal.status,
+            loop_status: goal.loop_status,
+            dimensions: goal.dimensions.map((d) => ({
+                name: d.name,
+                label: d.label,
+                current_value: d.current_value,
+                threshold: d.threshold,
+                confidence: d.confidence,
+            })),
+        };
+    }));
+    return JSON.stringify({ goals: goals.filter(Boolean) });
+}
+async function handleGetSessions(args, deps) {
+    const limit = typeof args.limit === "number" ? args.limit : 5;
+    const sessionsDir = path.join(deps.homeDir, ".pulseed", "sessions");
+    try {
+        if (!fs.existsSync(sessionsDir)) {
+            return JSON.stringify({ message: "No session information available.", sessions: [] });
+        }
+        const files = fs
+            .readdirSync(sessionsDir)
+            .filter((f) => f.endsWith(".json"))
+            .sort()
+            .slice(-limit);
+        const sessions = files.map((f) => {
+            try {
+                const raw = fs.readFileSync(path.join(sessionsDir, f), "utf-8");
+                return JSON.parse(raw);
+            }
+            catch {
+                return { file: f, error: "Failed to parse" };
+            }
+        });
+        return JSON.stringify({ sessions });
+    }
+    catch {
+        return JSON.stringify({ message: "No session information available.", sessions: [] });
+    }
+}
+async function handleGetTrustState(deps) {
+    let trustScore = "unavailable";
+    if (deps.trustManager) {
+        try {
+            const balance = await deps.trustManager.getBalance("default");
+            trustScore = balance.balance;
+        }
+        catch {
+            trustScore = "unavailable";
+        }
+    }
+    return JSON.stringify({
+        trust_score: trustScore,
+        trust_balance_range: [-100, 100],
+        delta_success: 3,
+        delta_failure: -10,
+        high_trust_threshold: 20,
+        ethics_gate_level: "L1",
+        execution_boundary: "PulSeed always delegates. Direct actions are LLM calls (for thinking) and state read/write only.",
+    });
+}
+async function handleGetConfig(deps) {
+    const providerPath = path.join(deps.homeDir, ".pulseed", "provider.json");
+    const defaults = {
+        provider: "unknown",
+        model: "unknown",
+        default_adapter: "claude-code-cli",
+        pulseed_home_dir: path.join(deps.homeDir, ".pulseed"),
+    };
+    try {
+        if (!fs.existsSync(providerPath)) {
+            return JSON.stringify(defaults);
+        }
+        const raw = fs.readFileSync(providerPath, "utf-8");
+        const config = JSON.parse(raw);
+        return JSON.stringify({
+            provider: config["provider"] ?? defaults.provider,
+            model: config["model"] ?? defaults.model,
+            default_adapter: config["default_adapter"] ?? defaults.default_adapter,
+            pulseed_home_dir: defaults.pulseed_home_dir,
+        });
+    }
+    catch {
+        return JSON.stringify(defaults);
+    }
+}
+async function handleGetPlugins(deps) {
+    if (!deps.pluginLoader) {
+        return JSON.stringify({ message: "Plugin information is not available.", plugins: [] });
+    }
+    try {
+        const pluginStates = await deps.pluginLoader.loadAll();
+        const plugins = pluginStates.map((p) => ({
+            name: p.name,
+            type: p.type ?? "unknown",
+            enabled: p.enabled ?? true,
+        }));
+        return JSON.stringify({ plugins });
+    }
+    catch {
+        return JSON.stringify({ message: "Failed to load plugin information.", plugins: [] });
+    }
+}
+function handleGetArchitecture() {
+    const text = `PulSeed Architecture
+
+## Core Concept
+4-element model: Goal (with thresholds) -> Current State (observation + confidence) -> Gap -> Constraints
+Core loop: observe -> gap -> score -> task -> execute -> verify (NEVER STOP)
+Execution boundary: PulSeed always delegates. Direct actions are LLM calls (for thinking) and state read/write only.
+
+## Layer Structure
+- Layer 0:  StateManager, AdapterLayer (no dependencies)
+- Layer 1:  GapCalculator, DriveSystem, TrustManager
+- Layer 2:  ObservationEngine, DriveScorer, SatisficingJudge, StallDetector
+- Layer 3:  SessionManager, GoalNegotiator, StrategyManager
+- Layer 4:  TaskLifecycle
+- Layer 5:  CoreLoop, ReportingEngine
+- Layer 6:  CLIRunner
+- Layer 7:  TUI (Ink/React dashboard, approval UI, chat)
+- Layer 8:  KnowledgeManager (cross-cutting)
+- Layer 9:  PortfolioManager
+- Layer 10: DaemonRunner, PIDManager, Logger, EventServer, NotificationDispatcher, MemoryLifecycleManager
+- Layer 11: CuriosityEngine, CharacterConfigManager
+- Layer 12: EmbeddingClient, VectorIndex, KnowledgeGraph, GoalDependencyGraph
+- Layer 13: CapabilityDetector, DataSourceAdapter
+- Layer 14: GoalTreeManager, StateAggregator, TreeLoopOrchestrator, CrossGoalPortfolio, StrategyTemplateRegistry, LearningPipeline, KnowledgeTransfer
+- Layer 15: PluginLoader, NotifierRegistry, INotifier (plugin architecture)
+
+## Module Responsibilities (summary)
+- StateManager: persistent goal/session state (file-based JSON)
+- GapCalculator: computes gap score from current state vs. thresholds
+- DriveSystem: converts gap into drive intensity
+- TrustManager: asymmetric trust scoring [-100,+100]
+- ObservationEngine: LLM-powered state observation with 3-tier fallback
+- SatisficingJudge: decides "good enough" to stop pursuing a goal
+- StallDetector: detects stall conditions (repetition, timeout, loop)
+- SessionManager: manages agent session lifecycle
+- TaskLifecycle: task selection, execution delegation, verification
+- CoreLoop: the main orchestration loop (observe->gap->score->task->execute->verify)
+- EthicsGate: L1 mechanical safety checks before irreversible actions`;
+    return JSON.stringify({ architecture: text });
+}
+// ─── Dispatcher ───
+export async function handleSelfKnowledgeToolCall(toolName, args, deps) {
+    switch (toolName) {
+        case "get_goals":
+            return handleGetGoals(deps);
+        case "get_sessions":
+            return handleGetSessions(args, deps);
+        case "get_trust_state":
+            return handleGetTrustState(deps);
+        case "get_config":
+            return handleGetConfig(deps);
+        case "get_plugins":
+            return handleGetPlugins(deps);
+        case "get_architecture":
+            return handleGetArchitecture();
+        default:
+            return JSON.stringify({ error: `Unknown tool: ${toolName}` });
+    }
+}
+//# sourceMappingURL=self-knowledge-tools.js.map

package/dist/chat/self-knowledge-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-knowledge-tools.js","sourceRoot":"","sources":["../../src/chat/self-knowledge-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAc7B,2BAA2B;AAE3B,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL;YACE,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,WAAW;gBACjB,WAAW,EACT,8IAA8I;gBAChJ,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;oBACd,QAAQ,EAAE,EAAE;iBACb;aACF;SACF;QACD;YACE,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,cAAc;gBACpB,WAAW,EACT,8FAA8F;gBAChG,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,kDAAkD;yBAChE;qBACF;oBACD,QAAQ,EAAE,EAAE;iBACb;aACF;SACF;QACD;YACE,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EACT,6JAA6J;gBAC/J,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;oBACd,QAAQ,EAAE,EAAE;iBACb;aACF;SACF;QACD;YACE,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,YAAY;gBAClB,WAAW,EACT,wFAAwF;gBAC1F,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;oBACd,QAAQ,EAAE,EAAE;iBACb;aACF;SACF;QACD;YACE,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,aAAa;gBACnB,WAAW,EACT,4EAA4E;gBAC9E,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;oBACd,QAAQ,EAAE,EAAE;iBACb;aACF;SACF;QACD;YACE,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,kBAAkB;gBACxB,WAAW,EACT,4HAA4H;gBAC9H,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;oBACd,QAAQ,EAAE,EAAE;iBACb;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED,mBAAmB;AAEnB,KAAK,UAAU,cAAc,CAAC,IAAuB;IACnD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,aAAa,EAAE,CAAC,CAAC,aAAa;gBAC9B,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,UAAU,EAAE,CAAC,CAAC,UAAU;aACzB,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,IAA6B,EAC7B,IAAuB;IAEvB,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IACpE,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,mCAAmC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,MAAM,KAAK,GAAG,EAAE;aACb,WAAW,CAAC,WAAW,CAAC;aACxB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;aAClC,IAAI,EAAE;aACN,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;QACjB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC/B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBAChE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;YAC/C,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,mCAAmC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,IAAuB;IACxD,IAAI,UAAU,GAAoB,aAAa,CAAC;IAChD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YAC9D,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,GAAG,aAAa,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,WAAW,EAAE,UAAU;QACvB,mBAAmB,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC;QAChC,aAAa,EAAE,CAAC;QAChB,aAAa,EAAE,CAAC,EAAE;QAClB,oBAAoB,EAAE,EAAE;QACxB,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAChB,kGAAkG;KACrG,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAuB;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG;QACf,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,SAAS;QAChB,eAAe,EAAE,iBAAiB;QAClC,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;KACtD,CAAC;IACF,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QAC1D,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,QAAQ;YACjD,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,KAAK;YACxC,eAAe,EAAE,MAAM,CAAC,iBAAiB,CAAC,IAAI,QAAQ,CAAC,eAAe;YACtE,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;SAC5C,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,IAAuB;IACrD,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,sCAAsC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QACvD,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,SAAS;YACzB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;SAC3B,CAAC,CAAC,CAAC;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB;IAC5B,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sEAoCuD,CAAC;IACrE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,qBAAqB;AAErB,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,QAAgB,EAChB,IAA6B,EAC7B,IAAuB;IAEvB,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW;YACd,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;QAC9B,KAAK,cAAc;YACjB,OAAO,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvC,KAAK,iBAAiB;YACpB,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACnC,KAAK,YAAY;YACf,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/B,KAAK,aAAa;YAChB,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAChC,KAAK,kBAAkB;YACrB,OAAO,qBAAqB,EAAE,CAAC;QACjC;YACE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,iBAAiB,QAAQ,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/cli/cli-command-registry 2.d.ts

@@ -0,0 +1,16 @@
+import { StateManager } from "../state/state-manager.js";
+import { CharacterConfigManager } from "../traits/character-config.js";
+import type { CoreLoop } from "../loop/core-loop.js";
+/**
+ * @description Dispatches a PulSeed CLI subcommand and returns an exit code.
+ * @param {string[]} argv Filtered arguments (--yes/-y already removed), first element is the subcommand.
+ * @param {boolean} globalYes Whether --yes/-y was present globally.
+ * @param {StateManager} stateManager Initialised state manager instance.
+ * @param {CharacterConfigManager} characterConfigManager Character config manager instance.
+ * @param {{ value: CoreLoop | null }} activeCoreLoopRef Mutable ref updated by cmdRun.
+ * @returns {Promise<number>} Exit code: 0 for success, 1 for errors, 2 for stall escalation.
+ */
+export declare function dispatchCommand(argv: string[], globalYes: boolean, stateManager: StateManager, characterConfigManager: CharacterConfigManager, activeCoreLoopRef: {
+    value: CoreLoop | null;
+}): Promise<number>;
+//# sourceMappingURL=cli-command-registry%202.d.ts.map

package/dist/cli/cli-command-registry 2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-registry 2.d.ts","sourceRoot":"","sources":["../../src/cli/cli-command-registry 2.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAmCrD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,OAAO,EAClB,YAAY,EAAE,YAAY,EAC1B,sBAAsB,EAAE,sBAAsB,EAC9C,iBAAiB,EAAE;IAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAA;CAAE,GAC5C,OAAO,CAAC,MAAM,CAAC,CAwcjB"}