@kingcrab/pi-imessage 0.0.1

package/dist/cli.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point — handles launchd service management and foreground run.
+ *
+ * Usage:
+ *   pi-imessage              Run in foreground
+ *   pi-imessage install      Install + start launchd service (auto-starts on boot)
+ *   pi-imessage uninstall    Stop + remove launchd service
+ *   pi-imessage start        Start the service
+ *   pi-imessage stop         Stop the service
+ *   pi-imessage restart      Restart the service
+ *   pi-imessage logs         Tail service logs
+ */
+import { execSync, fork } from "node:child_process";
+import { existsSync, mkdirSync, unlinkSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const LABEL = "com.kingcrab.pi-imessage";
+const PLIST_PATH = join(homedir(), "Library", "LaunchAgents", `${LABEL}.plist`);
+const WORKING_DIR = process.env.WORKING_DIR || join(homedir(), ".pi", "imessage");
+const LOG_DIR = join(WORKING_DIR, "logs");
+const MAIN_JS = join(import.meta.dirname, "main.js");
+function getNodePath() {
+    try {
+        return execSync("which node", { encoding: "utf-8" }).trim();
+    }
+    catch {
+        return "/usr/local/bin/node";
+    }
+}
+function buildPlist() {
+    const nodePath = getNodePath();
+    const stdoutLog = join(LOG_DIR, "stdout.log");
+    const stderrLog = join(LOG_DIR, "stderr.log");
+    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>${LABEL}</string>
+	<key>ProgramArguments</key>
+	<array>
+		<string>${nodePath}</string>
+		<string>${MAIN_JS}</string>
+	</array>
+	<key>RunAtLoad</key>
+	<true/>
+	<key>KeepAlive</key>
+	<true/>
+	<key>StandardOutPath</key>
+	<string>${stdoutLog}</string>
+	<key>StandardErrorPath</key>
+	<string>${stderrLog}</string>
+	<key>EnvironmentVariables</key>
+	<dict>
+		<key>PATH</key>
+		<string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
+		<key>WORKING_DIR</key>
+		<string>${WORKING_DIR}</string>
+	</dict>
+</dict>
+</plist>`;
+}
+function isLoaded() {
+    try {
+        execSync(`launchctl list ${LABEL}`, { stdio: "pipe" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function install() {
+    mkdirSync(LOG_DIR, { recursive: true });
+    writeFileSync(PLIST_PATH, buildPlist(), "utf-8");
+    console.log(`[pi-imessage] Wrote ${PLIST_PATH}`);
+    if (isLoaded()) {
+        execSync(`launchctl unload ${PLIST_PATH}`, { stdio: "inherit" });
+    }
+    execSync(`launchctl load ${PLIST_PATH}`, { stdio: "inherit" });
+    console.log("[pi-imessage] Service installed and started (auto-starts on boot)");
+}
+function uninstall() {
+    if (isLoaded()) {
+        execSync(`launchctl unload ${PLIST_PATH}`, { stdio: "inherit" });
+        console.log("[pi-imessage] Service stopped");
+    }
+    if (existsSync(PLIST_PATH)) {
+        unlinkSync(PLIST_PATH);
+        console.log(`[pi-imessage] Removed ${PLIST_PATH}`);
+    }
+    console.log("[pi-imessage] Service uninstalled");
+}
+function start() {
+    if (!existsSync(PLIST_PATH)) {
+        console.error("[pi-imessage] Service not installed. Run 'pi-imessage install' first.");
+        process.exit(1);
+    }
+    if (!isLoaded()) {
+        execSync(`launchctl load ${PLIST_PATH}`, { stdio: "inherit" });
+    }
+    execSync(`launchctl start ${LABEL}`, { stdio: "inherit" });
+    console.log("[pi-imessage] Service started");
+}
+function stop() {
+    if (!isLoaded()) {
+        console.log("[pi-imessage] Service is not running");
+        return;
+    }
+    execSync(`launchctl stop ${LABEL}`, { stdio: "inherit" });
+    console.log("[pi-imessage] Service stopped");
+}
+function restart() {
+    stop();
+    start();
+}
+function logs() {
+    const stdoutLog = join(LOG_DIR, "stdout.log");
+    const stderrLog = join(LOG_DIR, "stderr.log");
+    if (!existsSync(stdoutLog) && !existsSync(stderrLog)) {
+        console.error("[pi-imessage] No logs found. Is the service installed?");
+        process.exit(1);
+    }
+    console.log("[pi-imessage] Tailing logs (Ctrl+C to stop)…\n");
+    const files = [stdoutLog, stderrLog].filter((f) => existsSync(f));
+    execSync(`tail -f ${files.join(" ")}`, { stdio: "inherit" });
+}
+function runForeground() {
+    // Fork main.js as a child so cli.ts doesn't need to import the full bot.
+    const child = fork(MAIN_JS, { stdio: "inherit" });
+    child.on("exit", (code) => process.exit(code ?? 0));
+}
+function help() {
+    console.log(`Usage: pi-imessage [command]
+
+Commands:
+  (none)       Run in foreground
+  install      Install + start launchd service (auto-starts on boot)
+  uninstall    Stop + remove launchd service
+  start        Start the service
+  stop         Stop the service
+  restart      Restart the service
+  logs         Tail service logs
+  help         Show this help message`);
+}
+const command = process.argv[2];
+switch (command) {
+    case "install":
+        install();
+        break;
+    case "uninstall":
+        uninstall();
+        break;
+    case "start":
+        start();
+        break;
+    case "stop":
+        stop();
+        break;
+    case "restart":
+        restart();
+        break;
+    case "logs":
+        logs();
+        break;
+    case "help":
+    case "--help":
+    case "-h":
+        help();
+        break;
+    case undefined:
+        runForeground();
+        break;
+    default:
+        console.error(`Unknown command: ${command}\n`);
+        help();
+        process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/imessage.d.ts

@@ -0,0 +1,32 @@
+/**
+ * iMessage bot — pulls IncomingMessage objects from a queue (fed by the
+ * watcher) and runs them through the pipeline (before → start → end).
+ *
+ *   watcher → queue → pipeline.process()
+ *
+ * Message ordering: every pulled message is immediately dispatched to the
+ * pipeline (fire-and-forget). Different chats run concurrently. For the
+ * same chat, the agent's steering mode (streamingBehavior: "steer") handles
+ * rapid messages: if the agent is mid-run, a new message interrupts it as
+ * a steering prompt rather than queuing behind the previous run.
+ */
+import type { AgentManager } from "./agent.js";
+import type { DigestLogger } from "./logger.js";
+import type { AsyncQueue } from "./queue.js";
+import type { MessageSender } from "./send.js";
+import type { Settings } from "./settings.js";
+import type { ChatStore } from "./store.js";
+import type { IncomingMessage } from "./types.js";
+export interface IMessageBotConfig {
+    queue: AsyncQueue<IncomingMessage>;
+    agent: AgentManager;
+    sender: MessageSender;
+    store: ChatStore;
+    getSettings: () => Settings;
+    digestLogger: DigestLogger;
+}
+export declare function createIMessageBot(config: IMessageBotConfig): {
+    start(): void;
+    stop(): void;
+};
+//# sourceMappingURL=imessage.d.ts.map

package/dist/imessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imessage.d.ts","sourceRoot":"","sources":["../src/imessage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAc5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,EAAE,MAAM,QAAQ,CAAC;IAC5B,YAAY,EAAE,YAAY,CAAC;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB;;;EAqD1D"}

package/dist/imessage.js

@@ -0,0 +1,65 @@
+/**
+ * iMessage bot — pulls IncomingMessage objects from a queue (fed by the
+ * watcher) and runs them through the pipeline (before → start → end).
+ *
+ *   watcher → queue → pipeline.process()
+ *
+ * Message ordering: every pulled message is immediately dispatched to the
+ * pipeline (fire-and-forget). Different chats run concurrently. For the
+ * same chat, the agent's steering mode (streamingBehavior: "steer") handles
+ * rapid messages: if the agent is mid-run, a new message interrupts it as
+ * a steering prompt rather than queuing behind the previous run.
+ */
+import { createMessagePipeline } from "./pipeline.js";
+import { QueueClosedError } from "./queue.js";
+import { createSelfEchoFilter } from "./self-echo.js";
+import { createCallAgentTask, createCheckReplyEnabledTask, createCommandHandlerTask, createDownloadImagesTask, createDropSelfEchoTask, createLogIncomingTask, createLogOutgoingTask, createResizeImagesTask, createSendReplyTask, createStoreIncomingTask, createStoreOutgoingTask, } from "./tasks.js";
+export function createIMessageBot(config) {
+    const { queue, agent, sender, store, getSettings, digestLogger } = config;
+    const echoFilter = createSelfEchoFilter();
+    const pipeline = createMessagePipeline();
+    // ── Pipeline tasks ─────────────────────────────────────────────────────────
+    //
+    //   before -> start ──┬── yield reply -> end
+    //                     ├── yield reply -> end
+    //                     └── ...done
+    // before
+    pipeline.before(createLogIncomingTask(digestLogger));
+    pipeline.before(createDropSelfEchoTask(echoFilter));
+    pipeline.before(createStoreIncomingTask(store));
+    pipeline.before(createCheckReplyEnabledTask(getSettings));
+    pipeline.before(createDownloadImagesTask());
+    pipeline.before(createResizeImagesTask());
+    // start
+    pipeline.start(createCommandHandlerTask(agent));
+    pipeline.start(createCallAgentTask(agent));
+    // end
+    pipeline.end(createSendReplyTask(echoFilter, sender));
+    pipeline.end(createLogOutgoingTask(digestLogger));
+    pipeline.end(createStoreOutgoingTask(store));
+    return {
+        start() {
+            async function loop() {
+                while (true) {
+                    const msg = await queue.pull();
+                    // Fire-and-forget — steering handles same-guid concurrency
+                    pipeline.process(msg).catch((error) => {
+                        console.error(`[sid] failed to process message from ${msg.sender}:`, error);
+                    });
+                }
+            }
+            loop().catch((error) => {
+                if (error instanceof QueueClosedError) {
+                    console.log("[sid] Queue closed, consumer stopped");
+                }
+                else {
+                    console.error("[sid] Consumer crashed:", error);
+                }
+            });
+        },
+        stop() {
+            queue.close();
+        },
+    };
+}
+//# sourceMappingURL=imessage.js.map

package/dist/imessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imessage.js","sourceRoot":"","sources":["../src/imessage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAItD,OAAO,EACN,mBAAmB,EACnB,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,GACvB,MAAM,YAAY,CAAC;AAcpB,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IAC1D,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAC1E,MAAM,UAAU,GAAG,oBAAoB,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;IAEzC,8EAA8E;IAC9E,EAAE;IACF,6CAA6C;IAC7C,6CAA6C;IAC7C,kCAAkC;IAElC,SAAS;IACT,QAAQ,CAAC,MAAM,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,MAAM,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,MAAM,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,2BAA2B,CAAC,WAAW,CAAC,CAAC,CAAC;IAC1D,QAAQ,CAAC,MAAM,CAAC,wBAAwB,EAAE,CAAC,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAE1C,QAAQ;IACR,QAAQ,CAAC,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;IAE3C,MAAM;IACN,QAAQ,CAAC,GAAG,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,GAAG,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,GAAG,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC;IAE7C,OAAO;QACN,KAAK;YACJ,KAAK,UAAU,IAAI;gBAClB,OAAO,IAAI,EAAE,CAAC;oBACb,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;oBAE/B,2DAA2D;oBAC3D,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;wBAC9C,OAAO,CAAC,KAAK,CAAC,wCAAwC,GAAG,CAAC,MAAM,GAAG,EAAE,KAAK,CAAC,CAAC;oBAC7E,CAAC,CAAC,CAAC;gBACJ,CAAC;YACF,CAAC;YAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAC/B,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;oBACvC,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;gBACrD,CAAC;qBAAM,CAAC;oBACP,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;gBACjD,CAAC;YACF,CAAC,CAAC,CAAC;QACJ,CAAC;QACD,IAAI;YACH,KAAK,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,33 @@
+/**
+ * File-based logger with size-based rotation.
+ *
+ * Two log destinations:
+ *   app.log    — receives ALL console output (log / warn / error / info)
+ *   diget.log  — receives only incoming/outgoing digest lines
+ *
+ * Rotation strategy:
+ *   - Rotate when the active file reaches MAX_BYTES (default 10 MB)
+ *   - Keep up to MAX_FILES rotated copies (default 5)
+ *   - On rotation: .5 is deleted, .4→.5, …, .1→.2, active→.1, new active created
+ */
+export interface AppLogger {
+    /** Restore original console methods and close the file stream. */
+    close(): void;
+}
+export declare function createAppLogger(workingDir: string, options?: {
+    maxBytes?: number;
+    maxFiles?: number;
+}): AppLogger;
+export interface DigestLogger {
+    /**
+     * Write a digest line to diget.log and forward to console.log
+     * (which in turn lands in app.log via the app logger patch).
+     */
+    log(msg: string): void;
+    close(): void;
+}
+export declare function createDigestLogger(workingDir: string, options?: {
+    maxBytes?: number;
+    maxFiles?: number;
+}): DigestLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAmEH,MAAM,WAAW,SAAS;IACzB,kEAAkE;IAClE,KAAK,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,SAAS,CA+BrH;AAID,MAAM,WAAW,YAAY;IAC5B;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,kBAAkB,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,YAAY,CAkBd"}

package/dist/logger.js

@@ -0,0 +1,103 @@
+/**
+ * File-based logger with size-based rotation.
+ *
+ * Two log destinations:
+ *   app.log    — receives ALL console output (log / warn / error / info)
+ *   diget.log  — receives only incoming/outgoing digest lines
+ *
+ * Rotation strategy:
+ *   - Rotate when the active file reaches MAX_BYTES (default 10 MB)
+ *   - Keep up to MAX_FILES rotated copies (default 5)
+ *   - On rotation: .5 is deleted, .4→.5, …, .1→.2, active→.1, new active created
+ */
+import { createWriteStream, existsSync, renameSync, statSync } from "node:fs";
+import { join } from "node:path";
+const DEFAULT_MAX_BYTES = 10 * 1024 * 1024; // 10 MB
+const DEFAULT_MAX_FILES = 5;
+// ── Rotating file writer ──────────────────────────────────────────────────────
+class RotatingFileWriter {
+    filePath;
+    maxBytes;
+    maxFiles;
+    stream;
+    currentSize;
+    constructor(filePath, maxBytes, maxFiles) {
+        this.filePath = filePath;
+        this.maxBytes = maxBytes;
+        this.maxFiles = maxFiles;
+        this.currentSize = existsSync(filePath) ? statSync(filePath).size : 0;
+        this.stream = createWriteStream(filePath, { flags: "a" });
+    }
+    write(line) {
+        const byteLength = Buffer.byteLength(line, "utf8");
+        if (this.currentSize + byteLength > this.maxBytes) {
+            this.rotate();
+        }
+        this.stream.write(line);
+        this.currentSize += byteLength;
+    }
+    rotate() {
+        this.stream.end();
+        // Shift rotated files: .maxFiles deleted, …, .1 → .2, active → .1
+        for (let index = this.maxFiles - 1; index >= 1; index--) {
+            const from = `${this.filePath}.${index}`;
+            const to = `${this.filePath}.${index + 1}`;
+            if (existsSync(from))
+                renameSync(from, to);
+        }
+        if (existsSync(this.filePath)) {
+            renameSync(this.filePath, `${this.filePath}.1`);
+        }
+        this.stream = createWriteStream(this.filePath, { flags: "a" });
+        this.currentSize = 0;
+    }
+    close() {
+        this.stream.end();
+    }
+}
+// ── Timestamp helper ──────────────────────────────────────────────────────────
+function timestamp() {
+    return new Date().toISOString();
+}
+function formatLine(args) {
+    return `[${timestamp()}] ${args.map(String).join(" ")}\n`;
+}
+export function createAppLogger(workingDir, options = {}) {
+    const writer = new RotatingFileWriter(join(workingDir, "app.log"), options.maxBytes ?? DEFAULT_MAX_BYTES, options.maxFiles ?? DEFAULT_MAX_FILES);
+    const originalLog = console.log.bind(console);
+    const originalWarn = console.warn.bind(console);
+    const originalError = console.error.bind(console);
+    const originalInfo = console.info.bind(console);
+    function writeAndForward(original, args) {
+        writer.write(formatLine(args));
+        original(...args);
+    }
+    console.log = (...args) => writeAndForward(originalLog, args);
+    console.warn = (...args) => writeAndForward(originalWarn, args);
+    console.error = (...args) => writeAndForward(originalError, args);
+    console.info = (...args) => writeAndForward(originalInfo, args);
+    return {
+        close() {
+            console.log = originalLog;
+            console.warn = originalWarn;
+            console.error = originalError;
+            console.info = originalInfo;
+            writer.close();
+        },
+    };
+}
+export function createDigestLogger(workingDir, options = {}) {
+    const writer = new RotatingFileWriter(join(workingDir, "diget.log"), options.maxBytes ?? DEFAULT_MAX_BYTES, options.maxFiles ?? DEFAULT_MAX_FILES);
+    return {
+        log(msg) {
+            writer.write(formatLine([msg]));
+            // Forward to console.log so the line also appears in app.log
+            // (and on stdout for live monitoring).
+            console.log(msg);
+        },
+        close() {
+            writer.close();
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Sid — iMessage friend entry point.
+ */
+import "dotenv/config";
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,eAAe,CAAC"}

package/dist/main.js

@@ -0,0 +1,66 @@
+/**
+ * Sid — iMessage friend entry point.
+ */
+import "dotenv/config";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { createAgentManager } from "./agent.js";
+import { createIMessageBot } from "./imessage.js";
+import { createAppLogger, createDigestLogger } from "./logger.js";
+import { createAsyncQueue } from "./queue.js";
+import { checkEnvironment, createMessageSender } from "./send.js";
+import { readSettings, writeSettings } from "./settings.js";
+import { createChatStore } from "./store.js";
+import { createWatcher } from "./watch.js";
+import { createWebServer } from "./web/index.js";
+async function main() {
+    const webHost = process.env.WEB_HOST || "localhost";
+    const webPort = Number.parseInt(process.env.WEB_PORT || "7750", 10);
+    const workingDir = process.env.WORKING_DIR || join(homedir(), ".pi", "imessage");
+    // Loggers must be created before anything else so all console output is captured.
+    const appLogger = createAppLogger(workingDir);
+    const digestLogger = createDigestLogger(workingDir);
+    // Pre-flight: ensure Messages.app is running and iMessage is active.
+    await checkEnvironment();
+    const sender = createMessageSender();
+    let settings = readSettings(workingDir);
+    const getSettings = () => {
+        settings = readSettings(workingDir);
+        return settings;
+    };
+    const agent = await createAgentManager({ workingDir });
+    const store = createChatStore({ workingDir });
+    const queue = createAsyncQueue();
+    const watcher = createWatcher({ queue });
+    const setSettings = (updated) => {
+        settings = updated;
+        writeSettings(workingDir, updated);
+    };
+    const bot = createIMessageBot({ queue, agent, sender, store, getSettings, digestLogger });
+    const web = createWebServer({ workingDir, host: webHost, port: webPort, getSettings, setSettings });
+    console.log(`[sid] workspace:  ${workingDir}`);
+    watcher.start();
+    bot.start();
+    web.start();
+    let shuttingDown = false;
+    async function shutdown() {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        console.log("[sid] Shutting down…");
+        watcher.stop();
+        bot.stop();
+        await web.stop();
+        digestLogger.close();
+        appLogger.close();
+        console.log("[sid] Shutdown complete");
+        process.exit(0);
+    }
+    process.on("SIGINT", () => shutdown());
+    process.on("SIGTERM", () => shutdown());
+}
+main().catch((error) => {
+    console.error("[sid] Fatal:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/pipeline.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Message pipeline — lifecycle-based processing for incoming messages.
+ *
+ *   before (× 1) ──► start ──┬── dispatch reply ──► end (× 1)
+ *                            ├── dispatch reply ──► end (× 1)
+ *                            └── ...done
+ *
+ *   before : Filter & prepare. Runs once. Sets shouldContinue=false to drop.
+ *   start  : Calls agent. Invokes dispatch() for each reply produced.
+ *            Sets shouldContinue=false on outgoing to skip remaining start tasks.
+ *   end    : Runs once per dispatched reply (send, log, store).
+ */
+import type { IncomingMessage, OutgoingMessage } from "./types.js";
+export type BeforeTask = (incoming: IncomingMessage, outgoing: OutgoingMessage) => Promise<OutgoingMessage> | OutgoingMessage;
+/** dispatch() runs the full end phase for one reply. */
+export type DispatchFn = (outgoing: OutgoingMessage) => Promise<void>;
+export type StartTask = (incoming: IncomingMessage, outgoing: OutgoingMessage, dispatch: DispatchFn) => Promise<void>;
+export type EndTask = (incoming: IncomingMessage, outgoing: OutgoingMessage) => Promise<OutgoingMessage> | OutgoingMessage;
+export interface MessagePipeline {
+    before(task: BeforeTask): void;
+    start(task: StartTask): void;
+    end(task: EndTask): void;
+    process(incoming: IncomingMessage): Promise<OutgoingMessage>;
+}
+export declare function createMessagePipeline(): MessagePipeline;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGnE,MAAM,MAAM,UAAU,GAAG,CACxB,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,eAAe,KACrB,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAC;AAEhD,wDAAwD;AACxD,MAAM,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AACtE,MAAM,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtH,MAAM,MAAM,OAAO,GAAG,CACrB,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,eAAe,KACrB,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC/B,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7D;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CAoCvD"}

package/dist/pipeline.js

@@ -0,0 +1,48 @@
+/**
+ * Message pipeline — lifecycle-based processing for incoming messages.
+ *
+ *   before (× 1) ──► start ──┬── dispatch reply ──► end (× 1)
+ *                            ├── dispatch reply ──► end (× 1)
+ *                            └── ...done
+ *
+ *   before : Filter & prepare. Runs once. Sets shouldContinue=false to drop.
+ *   start  : Calls agent. Invokes dispatch() for each reply produced.
+ *            Sets shouldContinue=false on outgoing to skip remaining start tasks.
+ *   end    : Runs once per dispatched reply (send, log, store).
+ */
+import { createOutgoingMessage } from "./types.js";
+export function createMessagePipeline() {
+    const beforeTasks = [];
+    const startTasks = [];
+    const endTasks = [];
+    async function runEndTasks(incoming, outgoing) {
+        let result = outgoing;
+        for (const task of endTasks) {
+            result = await task(incoming, result);
+            if (!result.shouldContinue)
+                return;
+        }
+    }
+    async function process(incoming) {
+        let outgoing = createOutgoingMessage();
+        for (const task of beforeTasks) {
+            outgoing = await task(incoming, outgoing);
+            if (!outgoing.shouldContinue)
+                return outgoing;
+        }
+        const dispatch = (out) => runEndTasks(incoming, out);
+        for (const task of startTasks) {
+            await task(incoming, outgoing, dispatch);
+            if (!outgoing.shouldContinue)
+                break;
+        }
+        return outgoing;
+    }
+    return {
+        before: (task) => beforeTasks.push(task),
+        start: (task) => startTasks.push(task),
+        end: (task) => endTasks.push(task),
+        process,
+    };
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAuBnD,MAAM,UAAU,qBAAqB;IACpC,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,KAAK,UAAU,WAAW,CAAC,QAAyB,EAAE,QAAyB;QAC9E,IAAI,MAAM,GAAG,QAAQ,CAAC;QACtB,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,cAAc;gBAAE,OAAO;QACpC,CAAC;IACF,CAAC;IAED,KAAK,UAAU,OAAO,CAAC,QAAyB;QAC/C,IAAI,QAAQ,GAAG,qBAAqB,EAAE,CAAC;QAEvC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAChC,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC1C,IAAI,CAAC,QAAQ,CAAC,cAAc;gBAAE,OAAO,QAAQ,CAAC;QAC/C,CAAC;QAED,MAAM,QAAQ,GAAe,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACjE,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACzC,IAAI,CAAC,QAAQ,CAAC,cAAc;gBAAE,MAAM;QACrC,CAAC;QAED,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,OAAO;QACN,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QACxC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;QACtC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAClC,OAAO;KACP,CAAC;AACH,CAAC"}

package/dist/queue.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generic unbounded async queue.
+ *
+ * push() never blocks; pull() returns a promise that resolves when an item
+ * is available. close() rejects all pending waiters and future pull() calls.
+ */
+export declare class QueueClosedError extends Error {
+    constructor();
+}
+export interface AsyncQueue<T> {
+    push(item: T): void;
+    pull(): Promise<T>;
+    close(): void;
+}
+export declare function createAsyncQueue<T>(): AsyncQueue<T>;
+//# sourceMappingURL=queue.d.ts.map

package/dist/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,gBAAiB,SAAQ,KAAK;;CAK1C;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACpB,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IACnB,KAAK,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,gBAAgB,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAgCnD"}