@a5c-ai/tula 5.0.1-staging.daf8e165bc4a

package/dist/cli/commands/mcpServe.d.ts

@@ -0,0 +1,18 @@
+/**
+ * start-server command - Launch the babysitter MCP server on stdio or WebSocket transport.
+ *
+ * stdout is reserved for MCP protocol messages; all logging goes to stderr.
+ */
+export declare function handleMcpServe(args: {
+    json: boolean;
+    transport?: string;
+    port?: number;
+    host?: string;
+    authToken?: string;
+    wsOptions?: {
+        pingIntervalMs?: number;
+        maxMessagesPerSecond?: number;
+        sessionGracePeriodMs?: number;
+    };
+}): Promise<number>;
+//# sourceMappingURL=mcpServe.d.ts.map

package/dist/cli/commands/mcpServe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpServe.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mcpServe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE;QACV,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;CACH,GAAG,OAAO,CAAC,MAAM,CAAC,CAwDlB"}

package/dist/cli/commands/mcpServe.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * start-server command - Launch the babysitter MCP server on stdio or WebSocket transport.
+ *
+ * stdout is reserved for MCP protocol messages; all logging goes to stderr.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleMcpServe = handleMcpServe;
+const babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+const transport_1 = require("@a5c-ai/agent-platform/mcp/transport");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+function installShutdownHandlers(shutdownFn) {
+    process.on("SIGINT", () => void shutdownFn());
+    process.on("SIGTERM", () => void shutdownFn());
+}
+async function handleMcpServe(args) {
+    const transportType = args.transport ?? "stdio";
+    if (transportType === "ws" || transportType === "websocket") {
+        const wsTransport = await (0, transport_1.createWebSocketTransport)({
+            port: args.port ?? 9600,
+            host: args.host ?? "127.0.0.1",
+            authToken: args.authToken,
+            pingIntervalMs: args.wsOptions?.pingIntervalMs,
+            maxMessagesPerSecond: args.wsOptions?.maxMessagesPerSecond,
+            sessionGracePeriodMs: args.wsOptions?.sessionGracePeriodMs,
+        });
+        // Each new WebSocket connection gets its own McpServer instance
+        wsTransport.onconnection = (connectionTransport) => {
+            const server = (0, babysitter_sdk_1.createBabysitterMcpServer)();
+            void server.connect(connectionTransport);
+        };
+        process.stderr.write(args.json
+            ? JSON.stringify({
+                status: "running",
+                transport: "websocket",
+                port: wsTransport.port,
+            }) + "\n"
+            : `Babysitter MCP server running on WebSocket port ${wsTransport.port}\n`);
+        installShutdownHandlers(async () => {
+            process.stderr.write("Shutting down MCP server...\n");
+            await wsTransport.close();
+            process.exit(0);
+        });
+        return await new Promise(() => { });
+    }
+    // Default: stdio transport
+    const server = (0, babysitter_sdk_1.createBabysitterMcpServer)();
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write(args.json
+        ? JSON.stringify({ status: "running", transport: "stdio" }) + "\n"
+        : "Babysitter MCP server running on stdio\n");
+    installShutdownHandlers(async () => {
+        process.stderr.write("Shutting down MCP server...\n");
+        await server.close();
+        process.exit(0);
+    });
+    return await new Promise(() => { });
+}

package/dist/cli/commands/session/history.d.ts

@@ -0,0 +1,14 @@
+/**
+ * session:history command — Browse session history (GAP-SESSION-002).
+ *
+ * Displays accumulated decisions, run summaries, and context snapshots
+ * for a session. Supports --json and --run-id filtering.
+ */
+export interface SessionHistoryArgs {
+    sessionId: string;
+    stateDir: string;
+    json?: boolean;
+    runId?: string;
+}
+export declare function handleSessionHistory(args: SessionHistoryArgs): Promise<number>;
+//# sourceMappingURL=history.d.ts.map

package/dist/cli/commands/session/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/session/history.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BpF"}

package/dist/cli/commands/session/history.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * session:history command — Browse session history (GAP-SESSION-002).
+ *
+ * Displays accumulated decisions, run summaries, and context snapshots
+ * for a session. Supports --json and --run-id filtering.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSessionHistory = handleSessionHistory;
+const session_1 = require("@a5c-ai/agent-platform/session");
+async function handleSessionHistory(args) {
+    const { sessionId, stateDir } = args;
+    if (!sessionId) {
+        console.error("[session:history] --session-id is required");
+        return 1;
+    }
+    if (!stateDir) {
+        console.error("[session:history] --state-dir is required");
+        return 1;
+    }
+    const history = await (0, session_1.getSessionHistory)(stateDir, sessionId);
+    // Apply run-id filter if requested
+    const filtered = args.runId ? filterByRunId(history, args.runId) : history;
+    if (args.json) {
+        console.log(JSON.stringify(filtered, null, 2));
+        return 0;
+    }
+    // Text mode
+    renderTextHistory(filtered);
+    return 0;
+}
+function filterByRunId(history, runId) {
+    return {
+        notes: history.notes,
+        sharedKnowledge: history.sharedKnowledge,
+        worktree: history.worktree,
+        decisions: history.decisions.filter((d) => d.runId === runId),
+        runSummaries: history.runSummaries.filter((r) => r.runId === runId),
+        contextSnapshots: history.contextSnapshots.filter((s) => s.runId === runId),
+    };
+}
+function renderTextHistory(history) {
+    console.log("=== Session Context ===");
+    if (history.worktree?.workspacePath) {
+        const parts = [`workspace ${history.worktree.workspacePath}`];
+        if (history.worktree.currentPath)
+            parts.push(`current ${history.worktree.currentPath}`);
+        if (history.worktree.mode)
+            parts.push(`mode ${history.worktree.mode}`);
+        if (history.worktree.repoAlias)
+            parts.push(`repo ${history.worktree.repoAlias}`);
+        if (history.worktree.branch)
+            parts.push(`branch ${history.worktree.branch}`);
+        console.log(`  ${parts.join(" | ")}`);
+    }
+    else {
+        console.log("(no worktree metadata)");
+    }
+    console.log("");
+    console.log("=== Decisions ===");
+    if (history.decisions.length === 0) {
+        console.log("(none)");
+    }
+    else {
+        for (const d of history.decisions) {
+            const runPart = d.runId ? ` [${d.runId}]` : "";
+            const ratPart = d.rationale ? ` — ${d.rationale}` : "";
+            console.log(`  ${d.timestamp}${runPart}: ${d.description}${ratPart}`);
+        }
+    }
+    console.log("");
+    console.log("=== Run Summaries ===");
+    if (history.runSummaries.length === 0) {
+        console.log("(none)");
+    }
+    else {
+        for (const r of history.runSummaries) {
+            const parts = [`${r.runId} (${r.processId})`, r.status, `started ${r.startedAt}`];
+            if (r.completedAt)
+                parts.push(`completed ${r.completedAt}`);
+            if (r.outcome)
+                parts.push(r.outcome);
+            if (r.score !== undefined)
+                parts.push(`score: ${r.score}`);
+            console.log(`  ${parts.join(" | ")}`);
+        }
+    }
+    console.log("");
+    console.log("=== Context Snapshots ===");
+    if (history.contextSnapshots.length === 0) {
+        console.log("(none)");
+    }
+    else {
+        for (const s of history.contextSnapshots) {
+            const keys = Object.keys(s.snapshot).length;
+            const runPart = s.runId ? ` [${s.runId}]` : "";
+            console.log(`  ${s.timestamp}${runPart}: ${keys} key(s)`);
+        }
+    }
+}

package/dist/cli/commands/tui.d.ts

@@ -0,0 +1,23 @@
+/**
+ * tui command -- stub redirecting to agent-mux TUI with babysitter plugins.
+ *
+ * The tula dashboard uses the agent-mux TUI
+ * with babysitter-tui-plugins instead (packages/babysitter-tui-plugins/).
+ *
+ * `babysitter tui --json` still works as a non-interactive JSON fallback
+ * for run listing / detail inspection.
+ */
+interface TuiArgs {
+    runsDir: string;
+    json?: boolean;
+    verbose?: boolean;
+    positional?: string[];
+    harness?: string;
+    workspace?: string;
+    prompt?: string;
+    runId?: string;
+    verbosity?: string;
+}
+export declare function handleTui(args: TuiArgs): Promise<number>;
+export {};
+//# sourceMappingURL=tui.d.ts.map

package/dist/cli/commands/tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/tui.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,UAAU,OAAO;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgJD,wBAAsB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAe9D"}

package/dist/cli/commands/tui.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * tui command -- stub redirecting to agent-mux TUI with babysitter plugins.
+ *
+ * The tula dashboard uses the agent-mux TUI
+ * with babysitter-tui-plugins instead (packages/babysitter-tui-plugins/).
+ *
+ * `babysitter tui --json` still works as a non-interactive JSON fallback
+ * for run listing / detail inspection.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleTui = handleTui;
+const path = __importStar(require("node:path"));
+const node_fs_1 = require("node:fs");
+const babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+async function scanRunsForJson(runsDir) {
+    const resolvedDir = path.resolve(runsDir);
+    let entries;
+    try {
+        entries = await node_fs_1.promises.readdir(resolvedDir);
+    }
+    catch {
+        return [];
+    }
+    const summaries = [];
+    for (const entry of entries) {
+        const runDir = path.join(resolvedDir, entry);
+        const metadataPath = path.join(runDir, "run.json");
+        try {
+            await node_fs_1.promises.access(metadataPath);
+        }
+        catch {
+            continue;
+        }
+        try {
+            const metadata = await (0, babysitter_sdk_1.readRunMetadata)(runDir);
+            let journal = [];
+            try {
+                journal = await (0, babysitter_sdk_1.loadJournal)(runDir);
+            }
+            catch {
+                // Journal may not exist yet
+            }
+            const lastLifecycleType = [...journal].reverse().find((e) => e.type === "RUN_COMPLETED" || e.type === "RUN_FAILED")?.type;
+            const pendingCount = journal.filter((e) => e.type === "EFFECT_REQUESTED").length
+                - journal.filter((e) => e.type === "EFFECT_RESOLVED").length;
+            let state;
+            if (lastLifecycleType === "RUN_COMPLETED")
+                state = "completed";
+            else if (lastLifecycleType === "RUN_FAILED")
+                state = "failed";
+            else if (pendingCount > 0)
+                state = "waiting";
+            else
+                state = "created";
+            summaries.push({
+                runId: metadata.runId ?? entry,
+                state,
+                processId: metadata.processId ?? "unknown",
+                createdAt: metadata.createdAt ?? "",
+                eventCount: journal.length,
+                pendingCount: Math.max(0, pendingCount),
+                prompt: metadata.prompt,
+            });
+        }
+        catch {
+            // Skip malformed runs
+        }
+    }
+    summaries.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    return summaries;
+}
+async function handleJsonMode(args) {
+    const runIdArg = args.runId ?? args.positional?.[0];
+    if (runIdArg) {
+        const runDir = (0, babysitter_sdk_1.getRunDir)(args.runsDir, runIdArg);
+        try {
+            const metadata = await (0, babysitter_sdk_1.readRunMetadata)(runDir);
+            const journal = await (0, babysitter_sdk_1.loadJournal)(runDir);
+            const index = await (0, babysitter_sdk_1.buildEffectIndex)({ runDir, events: journal });
+            const lastLifecycleType = [...journal].reverse().find((e) => e.type === "RUN_COMPLETED" || e.type === "RUN_FAILED")?.type;
+            const pendingCount = journal.filter((e) => e.type === "EFFECT_REQUESTED").length
+                - journal.filter((e) => e.type === "EFFECT_RESOLVED").length;
+            let state;
+            if (lastLifecycleType === "RUN_COMPLETED")
+                state = "completed";
+            else if (lastLifecycleType === "RUN_FAILED")
+                state = "failed";
+            else if (pendingCount > 0)
+                state = "waiting";
+            else
+                state = "created";
+            const allEffects = index.listEffects();
+            const effects = allEffects.map((rec) => ({
+                effectId: rec.effectId,
+                kind: rec.kind ?? "unknown",
+                status: rec.status === "resolved_ok" || rec.status === "resolved_error"
+                    ? "completed" : rec.status === "requested" ? "pending" : "running",
+                title: rec.taskId ?? rec.effectId,
+            }));
+            console.log(JSON.stringify({
+                runId: runIdArg,
+                state,
+                processId: metadata.processId,
+                createdAt: metadata.createdAt,
+                events: journal.map((e) => ({
+                    type: e.type,
+                    recordedAt: e.recordedAt,
+                    seq: e.seq,
+                })),
+                effects,
+                pendingCount: Math.max(0, pendingCount),
+            }, null, 2));
+        }
+        catch (err) {
+            console.error(`[tui] unable to read run ${runIdArg}: ${err.message}`);
+            return 1;
+        }
+        return 0;
+    }
+    const runs = await scanRunsForJson(args.runsDir);
+    console.log(JSON.stringify({
+        runs: runs.map((r) => ({
+            runId: r.runId,
+            state: r.state,
+            processId: r.processId,
+            createdAt: r.createdAt,
+            eventCount: r.eventCount,
+            pendingCount: r.pendingCount,
+            prompt: r.prompt,
+        })),
+    }, null, 2));
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Main handler
+// ---------------------------------------------------------------------------
+async function handleTui(args) {
+    // JSON mode: non-interactive listing (retained for backward compat)
+    if (args.json) {
+        return handleJsonMode(args);
+    }
+    // Interactive TUI: redirect to agent-mux TUI
+    console.error("The tula TUI delegates to agent-mux.\n" +
+        "Use agent-mux TUI with babysitter plugins instead:\n" +
+        "  npx agent-mux tui --workspace .\n" +
+        "\n" +
+        "For non-interactive run listing, use: tula tui --json");
+    return 1;
+}

package/dist/cli/dispatch.d.ts

@@ -0,0 +1,4 @@
+import type { HarnessParsedArgs } from "./args";
+export declare function formatAgentHelp(_surface: "agent" | "human"): string;
+export declare function executeAgentCliCommand(parsed: HarnessParsedArgs): Promise<number>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/cli/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/cli/dispatch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAuBhD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAkCnE;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsHvF"}