@bbyqtbean/taco-helper 0.1.3 → 0.2.1

package/dist/ipc-server.js

@@ -0,0 +1,210 @@
+/**
+ * IPC server — Unix socket interface for MCP shims.
+ *
+ * The daemon listens on ~/.taco/daemon.sock.
+ * Each shim connects, registers its CWD, and proxies tool calls.
+ *
+ * Protocol: newline-delimited JSON.
+ *
+ * See: daemon-mcp-strategy.md §IPC Protocol
+ */
+import { createServer } from 'net';
+import { existsSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { randomBytes } from 'crypto';
+import { TACO_DIR } from './sqlite-store.js';
+import { getPortForWorkspace, listProjects } from './project-registry.js';
+const SOCKET_PATH = join(TACO_DIR, 'daemon.sock');
+/** Active shim connections */
+const shims = new Map();
+/**
+ * Handle an incoming IPC message from a shim.
+ */
+function handleMessage(raw, socket, store, onBroadcast) {
+    let msg;
+    try {
+        msg = JSON.parse(raw);
+    }
+    catch {
+        socket.write(JSON.stringify({ event: 'error', message: 'Invalid JSON' }) + '\n');
+        return;
+    }
+    const event = msg.event;
+    // ── connect: shim registers itself ─────────────────────────
+    if (event === 'connect') {
+        const shimId = randomBytes(6).toString('hex');
+        const conn = {
+            shimId,
+            cwd: msg.cwd ?? process.cwd(),
+            pid: msg.pid ?? 0,
+            agent: msg.agent ?? 'unknown',
+            socket,
+        };
+        shims.set(shimId, conn);
+        // Store shimId on the socket for disconnect cleanup
+        socket.__shimId = shimId;
+        console.error(`🌮 [IPC] Shim connected: ${shimId} (cwd: ${conn.cwd}, agent: ${conn.agent})`);
+        socket.write(JSON.stringify({ event: 'connected', shimId }) + '\n');
+        // Broadcast updated workspace list to SSE clients (for onboarding project cards)
+        onBroadcast('workspace-list', { workspaces: listProjects() });
+        return;
+    }
+    // ── tool_call: shim proxies a tool call ────────────────────
+    if (event === 'tool_call') {
+        const shimId = msg.shimId;
+        const conn = shims.get(shimId);
+        if (!conn) {
+            socket.write(JSON.stringify({
+                event: 'tool_result',
+                shimId,
+                error: 'Unknown shimId. Send a connect event first.',
+            }) + '\n');
+            return;
+        }
+        const tool = msg.tool;
+        const args = msg.args ?? {};
+        let result;
+        try {
+            switch (tool) {
+                case 'get_comments': {
+                    const port = getPortForWorkspace(conn.cwd);
+                    if (port === undefined) {
+                        result = {
+                            comments: [],
+                            note: 'No project registered for this workspace. Run taco-helper setup first.',
+                        };
+                    }
+                    else {
+                        result = { comments: store.getComments({ port, includeResolved: false }) };
+                    }
+                    break;
+                }
+                case 'get_all_comments': {
+                    const port = getPortForWorkspace(conn.cwd);
+                    const includeResolved = args.include_resolved ?? true;
+                    if (port === undefined) {
+                        result = {
+                            comments: [],
+                            note: 'No project registered for this workspace. Run taco-helper setup first.',
+                        };
+                    }
+                    else {
+                        result = { comments: store.getComments({ port, includeResolved }) };
+                    }
+                    break;
+                }
+                case 'resolve_comment': {
+                    const success = store.markResolved(args.id);
+                    result = success
+                        ? { success: true, message: `Comment ${args.id} marked as resolved.` }
+                        : { success: false, message: `Comment ${args.id} not found.` };
+                    break;
+                }
+                case 'action_comment': {
+                    const success = store.markActioned(args.id);
+                    result = success
+                        ? { success: true, message: `Comment ${args.id} marked as actioned.` }
+                        : { success: false, message: `Comment ${args.id} not found.` };
+                    break;
+                }
+                case 'list_projects': {
+                    result = { projects: listProjects() };
+                    break;
+                }
+                default:
+                    result = { error: `Unknown tool: ${tool}` };
+            }
+        }
+        catch (err) {
+            result = { error: err.message ?? 'Internal error' };
+        }
+        socket.write(JSON.stringify({ event: 'tool_result', shimId, result }) + '\n');
+        return;
+    }
+    // ── disconnect: shim is shutting down ──────────────────────
+    if (event === 'disconnect') {
+        const shimId = msg.shimId;
+        if (shims.has(shimId)) {
+            console.error(`🌮 [IPC] Shim disconnected: ${shimId}`);
+            shims.delete(shimId);
+        }
+        return;
+    }
+    // Unknown event
+    socket.write(JSON.stringify({ event: 'error', message: `Unknown event: ${event}` }) + '\n');
+}
+/**
+ * Start the IPC server on the Unix socket.
+ * Returns the server instance for cleanup.
+ */
+export function startIpcServer(store, onBroadcast) {
+    // Remove stale socket file
+    if (existsSync(SOCKET_PATH)) {
+        try {
+            unlinkSync(SOCKET_PATH);
+        }
+        catch {
+            // ignore
+        }
+    }
+    const server = createServer((socket) => {
+        let buffer = '';
+        socket.on('data', (data) => {
+            buffer += data.toString();
+            // Process complete newline-delimited messages
+            let newlineIdx;
+            while ((newlineIdx = buffer.indexOf('\n')) !== -1) {
+                const line = buffer.slice(0, newlineIdx).trim();
+                buffer = buffer.slice(newlineIdx + 1);
+                if (line.length > 0) {
+                    handleMessage(line, socket, store, onBroadcast);
+                }
+            }
+        });
+        socket.on('close', () => {
+            // Clean up shim connection on socket close
+            const shimId = socket.__shimId;
+            if (shimId && shims.has(shimId)) {
+                console.error(`🌮 [IPC] Shim disconnected (socket closed): ${shimId}`);
+                shims.delete(shimId);
+            }
+        });
+        socket.on('error', (err) => {
+            console.error('🌮 [IPC] Socket error:', err.message);
+        });
+    });
+    server.listen(SOCKET_PATH, () => {
+        console.error(`🌮 [IPC] Listening on ${SOCKET_PATH}`);
+    });
+    server.on('error', (err) => {
+        console.error('🌮 [IPC] Server error:', err);
+    });
+    return server;
+}
+/**
+ * Send a message to a specific shim by shimId.
+ * Used for daemon-initiated messages (e.g. sampling trigger).
+ */
+export function sendToShim(shimId, message) {
+    const conn = shims.get(shimId);
+    if (!conn)
+        return false;
+    conn.socket.write(JSON.stringify(message) + '\n');
+    return true;
+}
+/**
+ * Send a message to all connected shims.
+ */
+export function broadcastToShims(message) {
+    const data = JSON.stringify(message) + '\n';
+    for (const conn of shims.values()) {
+        conn.socket.write(data);
+    }
+}
+/**
+ * Get a list of all connected shim IDs.
+ */
+export function getConnectedShims() {
+    return Array.from(shims.keys());
+}
+//# sourceMappingURL=ipc-server.js.map

package/dist/ipc-server.js.map

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

package/dist/ipc.d.ts

@@ -0,0 +1,55 @@
+/**
+ * IPC Protocol — shared types for shim ↔ daemon communication.
+ * Messages are newline-delimited JSON over a Unix socket at ~/.taco/daemon.sock.
+ *
+ * See daemon-mcp-strategy.md (IPC Protocol section) for the full spec.
+ */
+export declare const TACO_DIR: string;
+export declare const SOCKET_PATH: string;
+export declare const LOCK_PATH: string;
+export declare const PROJECTS_PATH: string;
+export declare const CONFIG_PATH: string;
+export declare const DB_PATH: string;
+export interface ConnectMessage {
+    event: 'connect';
+    cwd: string;
+    pid: number;
+    agent: string;
+}
+export interface DisconnectMessage {
+    event: 'disconnect';
+    shimId: string;
+}
+export interface ToolCallMessage {
+    event: 'tool_call';
+    shimId: string;
+    tool: string;
+    args: Record<string, unknown>;
+}
+export type ShimToDaemonMessage = ConnectMessage | DisconnectMessage | ToolCallMessage;
+export interface ConnectedMessage {
+    event: 'connected';
+    shimId: string;
+}
+export interface ToolResultMessage {
+    event: 'tool_result';
+    shimId: string;
+    result: unknown;
+    error?: string;
+}
+export interface SampleMessage {
+    event: 'sample';
+}
+export type DaemonToShimMessage = ConnectedMessage | ToolResultMessage | SampleMessage;
+/**
+ * Encode a message as newline-delimited JSON.
+ */
+export declare function encodeMessage(msg: unknown): string;
+/**
+ * Parse newline-delimited JSON buffer. Returns parsed messages and any remaining partial data.
+ */
+export declare function parseMessages(buffer: string): {
+    messages: any[];
+    remainder: string;
+};
+//# sourceMappingURL=ipc.d.ts.map

package/dist/ipc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.d.ts","sourceRoot":"","sources":["../src/ipc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,eAAO,MAAM,QAAQ,QAA2B,CAAC;AACjD,eAAO,MAAM,WAAW,QAAgC,CAAC;AACzD,eAAO,MAAM,SAAS,QAAgC,CAAC;AACvD,eAAO,MAAM,aAAa,QAAkC,CAAC;AAC7D,eAAO,MAAM,WAAW,QAAgC,CAAC;AACzD,eAAO,MAAM,OAAO,QAAgC,CAAC;AAIrD,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAIvF,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,aAAa,CAAC;AAIvF;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAgBpF"}

package/dist/ipc.js

@@ -0,0 +1,43 @@
+/**
+ * IPC Protocol — shared types for shim ↔ daemon communication.
+ * Messages are newline-delimited JSON over a Unix socket at ~/.taco/daemon.sock.
+ *
+ * See daemon-mcp-strategy.md (IPC Protocol section) for the full spec.
+ */
+import { join } from 'path';
+import { homedir } from 'os';
+// ─── Paths ──────────────────────────────────────────────────────────
+export const TACO_DIR = join(homedir(), '.taco');
+export const SOCKET_PATH = join(TACO_DIR, 'daemon.sock');
+export const LOCK_PATH = join(TACO_DIR, 'daemon.lock');
+export const PROJECTS_PATH = join(TACO_DIR, 'projects.json');
+export const CONFIG_PATH = join(TACO_DIR, 'config.json');
+export const DB_PATH = join(TACO_DIR, 'comments.db');
+// ─── Helpers ────────────────────────────────────────────────────────
+/**
+ * Encode a message as newline-delimited JSON.
+ */
+export function encodeMessage(msg) {
+    return JSON.stringify(msg) + '\n';
+}
+/**
+ * Parse newline-delimited JSON buffer. Returns parsed messages and any remaining partial data.
+ */
+export function parseMessages(buffer) {
+    const messages = [];
+    const lines = buffer.split('\n');
+    const remainder = lines.pop() ?? ''; // last element is either empty or partial
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            messages.push(JSON.parse(trimmed));
+        }
+        catch {
+            console.error('🌮 [IPC] Failed to parse message:', trimmed);
+        }
+    }
+    return { messages, remainder };
+}
+//# sourceMappingURL=ipc.js.map

package/dist/ipc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.js","sourceRoot":"","sources":["../src/ipc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE7B,uEAAuE;AAEvE,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AACjD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AACzD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AACzD,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AA6CrD,uEAAuE;AAEvE;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IACxC,MAAM,QAAQ,GAAU,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,0CAA0C;IAE/E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,OAAO,CAAC,CAAC;QAChE,CAAC;IACL,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACnC,CAAC"}

package/dist/launchd.d.ts

@@ -0,0 +1,23 @@
+/**
+ * launchd integration — macOS daemon persistence.
+ *
+ * Registers the taco daemon with launchd so it auto-starts on login
+ * and restarts if it crashes.
+ *
+ * See: daemon-mcp-strategy.md §launchd, taco-helper-package-spec.md §CLI
+ */
+/**
+ * Register the daemon with launchd.
+ * Writes the plist file and loads it.
+ */
+export declare function registerLaunchd(): void;
+/**
+ * Unregister the daemon from launchd.
+ * Unloads and removes the plist file.
+ */
+export declare function unregisterLaunchd(): void;
+/**
+ * Check if the daemon is registered with launchd.
+ */
+export declare function isLaunchdRegistered(): boolean;
+//# sourceMappingURL=launchd.d.ts.map

package/dist/launchd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launchd.d.ts","sourceRoot":"","sources":["../src/launchd.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8CH;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAiBtC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAkBxC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C"}

package/dist/launchd.js

@@ -0,0 +1,102 @@
+/**
+ * launchd integration — macOS daemon persistence.
+ *
+ * Registers the taco daemon with launchd so it auto-starts on login
+ * and restarts if it crashes.
+ *
+ * See: daemon-mcp-strategy.md §launchd, taco-helper-package-spec.md §CLI
+ */
+import { writeFileSync, existsSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { execSync } from 'child_process';
+const PLIST_NAME = 'com.taco.daemon.plist';
+const LAUNCH_AGENTS_DIR = join(homedir(), 'Library', 'LaunchAgents');
+const PLIST_PATH = join(LAUNCH_AGENTS_DIR, PLIST_NAME);
+/**
+ * Generate the launchd plist XML.
+ * Uses npx to run the daemon, so it always uses the latest version.
+ */
+function generatePlist() {
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.taco.daemon</string>
+
+    <key>ProgramArguments</key>
+    <array>
+        <string>npx</string>
+        <string>-y</string>
+        <string>@bbyqtbean/taco-helper@latest</string>
+        <string>daemon</string>
+    </array>
+
+    <key>RunAtLoad</key>
+    <true/>
+
+    <key>KeepAlive</key>
+    <true/>
+
+    <key>StandardErrorPath</key>
+    <string>${join(homedir(), '.taco', 'daemon.log')}</string>
+
+    <key>StandardOutPath</key>
+    <string>${join(homedir(), '.taco', 'daemon.log')}</string>
+</dict>
+</plist>`;
+}
+/**
+ * Register the daemon with launchd.
+ * Writes the plist file and loads it.
+ */
+export function registerLaunchd() {
+    // Write plist
+    writeFileSync(PLIST_PATH, generatePlist(), 'utf-8');
+    console.error(`🌮 Wrote launchd plist: ${PLIST_PATH}`);
+    // Load it
+    try {
+        execSync(`launchctl load ${PLIST_PATH}`, { stdio: 'pipe' });
+        console.error('🌮 Registered daemon with launchd');
+    }
+    catch (err) {
+        // Already loaded is fine
+        if (err?.stderr?.toString()?.includes('already loaded')) {
+            console.error('🌮 Daemon already registered with launchd');
+        }
+        else {
+            throw err;
+        }
+    }
+}
+/**
+ * Unregister the daemon from launchd.
+ * Unloads and removes the plist file.
+ */
+export function unregisterLaunchd() {
+    if (!existsSync(PLIST_PATH)) {
+        console.error('🌮 No launchd plist found — nothing to unregister');
+        return;
+    }
+    try {
+        execSync(`launchctl unload ${PLIST_PATH}`, { stdio: 'pipe' });
+    }
+    catch {
+        // May not be loaded — that's fine
+    }
+    try {
+        unlinkSync(PLIST_PATH);
+        console.error(`🌮 Removed launchd plist: ${PLIST_PATH}`);
+    }
+    catch {
+        // File may not exist — that's fine
+    }
+}
+/**
+ * Check if the daemon is registered with launchd.
+ */
+export function isLaunchdRegistered() {
+    return existsSync(PLIST_PATH);
+}
+//# sourceMappingURL=launchd.js.map

package/dist/launchd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launchd.js","sourceRoot":"","sources":["../src/launchd.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,UAAU,GAAG,uBAAuB,CAAC;AAC3C,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;AACrE,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;AAEvD;;;GAGG;AACH,SAAS,aAAa;IAClB,OAAO;;;;;;;;;;;;;;;;;;;;;;cAsBG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,YAAY,CAAC;;;cAGtC,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,YAAY,CAAC;;SAE3C,CAAC;AACV,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC3B,cAAc;IACd,aAAa,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,OAAO,CAAC,CAAC;IACpD,OAAO,CAAC,KAAK,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC;IAEvD,UAAU;IACV,IAAI,CAAC;QACD,QAAQ,CAAC,kBAAkB,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAChB,yBAAyB;QACzB,IAAI,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACtD,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACJ,MAAM,GAAG,CAAC;QACd,CAAC;IACL,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC7B,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,QAAQ,CAAC,oBAAoB,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACL,kCAAkC;IACtC,CAAC;IAED,IAAI,CAAC;QACD,UAAU,CAAC,UAAU,CAAC,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,6BAA6B,UAAU,EAAE,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACL,mCAAmC;IACvC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IAC/B,OAAO,UAAU,CAAC,UAAU,CAAC,CAAC;AAClC,CAAC"}

package/dist/mcp-shim.d.ts

@@ -0,0 +1,15 @@
+/**
+ * MCP Shim — lightweight proxy between the AI agent and the daemon.
+ *
+ * Speaks MCP stdio to the agent, proxies tool calls to the daemon
+ * over a Unix socket (~/.taco/daemon.sock).
+ *
+ * See: taco-helper-package-spec.md §MCP Shim, §D, §E
+ * See: daemon-mcp-strategy.md §2 (MCP Shim)
+ */
+/**
+ * Start the MCP shim.
+ * This is the main entry point for `npx taco-helper mcp`.
+ */
+export declare function startMcpShim(): Promise<void>;
+//# sourceMappingURL=mcp-shim.d.ts.map

package/dist/mcp-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-shim.d.ts","sourceRoot":"","sources":["../src/mcp-shim.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2QH;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAiQlD"}