opencode-workspace-mailbox 0.0.0-stage → 0.1.0

package/dist/mailbox.js

@@ -0,0 +1,80 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { messageHash } from "./hash.js";
+import { isOpen, parseMailbox } from "./parser.js";
+import { isSafeRecipient, mailboxFile, PathSafetyError } from "./paths.js";
+function pad2(n) {
+    return String(n).padStart(2, "0");
+}
+function buildHeader(to, from, now) {
+    const date = `${now.getFullYear()}-${pad2(now.getMonth() + 1)}-${pad2(now.getDate())}`;
+    const time = `${pad2(now.getHours())}:${pad2(now.getMinutes())}`;
+    return `${date} ${time} — from ${from} → to ${to}`;
+}
+export function sendMessage(req) {
+    if (!isSafeRecipient(req.to)) {
+        throw new PathSafetyError(`Invalid recipient "${req.to}"`);
+    }
+    const topic = (req.topic ?? "").replace(/\r?\n/g, " ").trim();
+    if (!topic)
+        throw new Error("topic is required");
+    const body = (req.body ?? "").trim();
+    const file = mailboxFile(req.mailboxDir, req.to);
+    mkdirSync(path.dirname(file), { recursive: true });
+    const status = req.status ?? "OPEN";
+    const header = buildHeader(req.to, req.from, req.now ?? new Date());
+    const block = `### ${header}\n**Status:** ${status}\n**Topic:** ${topic}\n${body}\n`;
+    const preamble = `# ${req.to} mailbox\n\nMessages addressed to \`${req.to}\`. Append-only.\n`;
+    if (!existsSync(file)) {
+        writeFileSync(file, preamble, "utf8");
+        appendFileSync(file, `\n${block}`, "utf8");
+    }
+    else {
+        const existing = readFileSync(file, "utf8");
+        const sep = existing.endsWith("\n") ? "\n" : "\n\n";
+        appendFileSync(file, `${sep}${block}`, "utf8");
+    }
+    const hash = messageHash({ header, topic, body });
+    return { file, header, hash, text: block };
+}
+export function readMailbox(file) {
+    if (!existsSync(file))
+        return { file, exists: false, messages: [], open: [] };
+    const text = readFileSync(file, "utf8");
+    const messages = parseMailbox(text);
+    return { file, exists: true, messages, open: messages.filter(isOpen) };
+}
+export function ackMessage(req) {
+    const hasHash = typeof req.hash === "string" && req.hash.length > 0;
+    const hasHeader = typeof req.header === "string" && req.header.length > 0;
+    if ((hasHash ? 1 : 0) + (hasHeader ? 1 : 0) !== 1) {
+        return { changed: false, reason: "missing-args" };
+    }
+    if (!existsSync(req.file))
+        return { changed: false, reason: "not-found" };
+    const text = readFileSync(req.file, "utf8");
+    const messages = parseMailbox(text);
+    const matches = messages.filter((m) => {
+        if (hasHash)
+            return m.hash === req.hash;
+        return m.header.trim().toLowerCase() === req.header.trim().toLowerCase();
+    });
+    if (matches.length === 0)
+        return { changed: false, reason: "not-found" };
+    if (matches.length > 1)
+        return { changed: false, reason: "ambiguous" };
+    const message = matches[0];
+    if (message.status === "DONE")
+        return { changed: false, message, reason: "already-done" };
+    if (message.statusStart < 0 || message.statusEnd < 0)
+        return { changed: false, reason: "not-found" };
+    // Replace the whole status-line content, not just the first word: real
+    // messages carry annotations like `OPEN (confirm one detail)` and flipping the
+    // token alone would leave a nonsensical `DONE (confirm one detail)`.
+    const lineEnd = message.statusLineEnd >= message.statusEnd ? message.statusLineEnd : message.statusEnd;
+    const next = text.slice(0, message.statusStart) + "DONE" + text.slice(lineEnd);
+    writeFileSync(req.file, next, "utf8");
+    const updated = parseMailbox(next).find((m) => m.hash === message.hash) ?? message;
+    return { changed: true, message: updated };
+}
+//# sourceMappingURL=mailbox.js.map

package/dist/mailbox.js.map

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

package/dist/parser.d.ts

@@ -0,0 +1,17 @@
+export type MailboxMessage = {
+    header: string;
+    from: string;
+    to: string;
+    status: string;
+    topic: string;
+    body: string;
+    start: number;
+    end: number;
+    statusStart: number;
+    statusEnd: number;
+    /** Char offset of the end of the status line's content (before its line ending); -1 if absent. */
+    statusLineEnd: number;
+    hash: string;
+};
+export declare function parseMailbox(text: string): MailboxMessage[];
+export declare function isOpen(message: MailboxMessage): boolean;

package/dist/parser.js

@@ -0,0 +1,78 @@
+import { messageHash } from "./hash.js";
+function parseHeader(headerText) {
+    const s = headerText.trim();
+    const re = /(?:—|–|-)\s*from\s+(.+?)\s*(?:→|->|-->)\s*to\s+(.+)$/;
+    const m = s.match(re);
+    if (!m)
+        return { from: "", to: "" };
+    return { from: m[1].trim(), to: m[2].trim() };
+}
+const HEADER_DATE_RE = /^\d{4}-\d{2}-\d{2}/;
+/**
+ * A `###` line is a message header only when it carries a date or a
+ * `from ... to ...` shape. Anything else (`### Notes` inside a body) stays part
+ * of the previous message instead of splitting it.
+ */
+function looksLikeMessageHeader(header) {
+    const text = header.trim();
+    if (HEADER_DATE_RE.test(text))
+        return true;
+    const { from, to } = parseHeader(text);
+    return from.length > 0 && to.length > 0;
+}
+export function parseMailbox(text) {
+    const messages = [];
+    const starts = Array.from(text.matchAll(/^###[ \t]+/gm))
+        .map((match) => match.index)
+        .filter((index) => {
+        const nl = text.indexOf("\n", index);
+        const line = text.slice(index, nl === -1 ? text.length : nl).replace(/\r$/, "");
+        return looksLikeMessageHeader(line.replace(/^###[ \t]+/, ""));
+    });
+    for (let i = 0; i < starts.length; i++) {
+        const start = starts[i];
+        const end = i + 1 < starts.length ? starts[i + 1] : text.length;
+        let nl = text.indexOf("\n", start);
+        if (nl === -1 || nl >= end)
+            nl = end;
+        let headerLine = text.slice(start, nl);
+        if (headerLine.endsWith("\r"))
+            headerLine = headerLine.slice(0, -1);
+        const header = headerLine.replace(/^###[ \t]+/, "");
+        const { from, to } = parseHeader(header);
+        const regionStart = nl >= text.length ? nl : nl + 1;
+        const region = text.slice(regionStart, end);
+        let status = "";
+        let statusStart = -1;
+        let statusEnd = -1;
+        let statusLineEnd = -1;
+        const statusMatch = /\*\*Status:\*\*[ \t]*([^\r\n]*)/.exec(region);
+        if (statusMatch) {
+            const raw = statusMatch[1];
+            const word = raw.match(/\S+/);
+            if (word) {
+                status = word[0].toUpperCase();
+                const prefix = statusMatch[0].length - statusMatch[1].length;
+                statusStart = regionStart + statusMatch.index + prefix + (word.index ?? 0);
+                statusEnd = statusStart + word[0].length;
+            }
+            statusLineEnd = regionStart + statusMatch.index + statusMatch[0].length;
+        }
+        let topic = "";
+        let topicLineEnd = -1;
+        const topicMatch = /\*\*Topic:\*\*[ \t]*([^\r\n]*)/.exec(region);
+        if (topicMatch) {
+            topic = topicMatch[1].trim();
+            topicLineEnd = regionStart + topicMatch.index + topicMatch[0].length;
+        }
+        const bodyStart = Math.max(regionStart, statusLineEnd, topicLineEnd);
+        const body = text.slice(bodyStart, end).trim();
+        const hash = messageHash({ header, topic, body });
+        messages.push({ header, from, to, status, topic, body, start, end, statusStart, statusEnd, statusLineEnd, hash });
+    }
+    return messages;
+}
+export function isOpen(message) {
+    return message.status === "OPEN";
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,8 @@
+export declare const RECIPIENT_RE: RegExp;
+export declare class PathSafetyError extends Error {
+    constructor(message: string);
+}
+export declare function isSafeRecipient(name: unknown): name is string;
+export declare function resolveInside(baseDir: string, ...segments: string[]): string;
+export declare function mailboxFile(mailboxDir: string, recipient: string): string;
+export declare function assertInside(baseDir: string, candidate: string, label: string): string;

package/dist/paths.js

@@ -0,0 +1,34 @@
+import path from "node:path";
+export const RECIPIENT_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+export class PathSafetyError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PathSafetyError";
+    }
+}
+export function isSafeRecipient(name) {
+    return typeof name === "string" && RECIPIENT_RE.test(name);
+}
+export function resolveInside(baseDir, ...segments) {
+    const target = path.resolve(baseDir, ...segments);
+    const rel = path.relative(baseDir, target);
+    if (rel === "" || rel === ".." || rel.startsWith(".." + path.sep) || path.isAbsolute(rel)) {
+        throw new PathSafetyError(`Path escapes base directory: ${target}`);
+    }
+    return target;
+}
+export function mailboxFile(mailboxDir, recipient) {
+    if (!isSafeRecipient(recipient)) {
+        throw new PathSafetyError(`Invalid recipient "${recipient}"`);
+    }
+    return resolveInside(mailboxDir, recipient + ".md");
+}
+export function assertInside(baseDir, candidate, label) {
+    try {
+        return resolveInside(baseDir, candidate);
+    }
+    catch {
+        throw new PathSafetyError(`${label} must resolve inside the project directory: ${candidate}`);
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAA;AAExD,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC5D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,GAAG,QAAkB;IAClE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAA;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC1C,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,eAAe,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAA;IACrE,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,SAAiB;IAC/D,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,eAAe,CAAC,sBAAsB,SAAS,GAAG,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,aAAa,CAAC,UAAU,EAAE,SAAS,GAAG,KAAK,CAAC,CAAA;AACrD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,SAAiB,EAAE,KAAa;IAC5E,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,eAAe,CAAC,GAAG,KAAK,+CAA+C,SAAS,EAAE,CAAC,CAAA;IAC/F,CAAC;AACH,CAAC"}

package/dist/prompt.d.ts

@@ -0,0 +1,3 @@
+import type { MailboxMessage } from "./parser.js";
+export declare function buildIdlePrompt(project: string, messages: MailboxMessage[]): string;
+export declare function buildCapNotice(project: string, count: number, maxAutoRounds?: number): string;

package/dist/prompt.js

@@ -0,0 +1,15 @@
+function truncate(text, max) {
+    return text.length > max ? text.slice(0, max) : text;
+}
+export function buildIdlePrompt(project, messages) {
+    const n = messages.length;
+    const topics = messages.map((m) => `- ${truncate(m.topic || "(no topic)", 120)}`).join("\n");
+    return (`You have ${n} OPEN mailbox message(s) for this project.\n\n` +
+        `Load the \`workspace-mailbox\` skill, read \`handoffs/${project}.md\`, handle every OPEN message,\n` +
+        `flip each one to DONE (use \`mailbox_ack\`), and reply only if a decision is needed.\n\n` +
+        `Topics:\n${topics}`);
+}
+export function buildCapNotice(project, count, maxAutoRounds = 2) {
+    return `Mailbox: ${count} OPEN message(s) in ${project} — auto-handling stopped after ${maxAutoRounds} round(s); ask me to handle them.`;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAEA,SAAS,QAAQ,CAAC,IAAY,EAAE,GAAW;IACzC,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACtD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,QAA0B;IACzE,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAA;IACzB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,YAAY,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC5F,OAAO,CACL,YAAY,CAAC,gDAAgD;QAC7D,yDAAyD,OAAO,qCAAqC;QACrG,0FAA0F;QAC1F,YAAY,MAAM,EAAE,CACrB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,KAAa,EAAE,aAAa,GAAG,CAAC;IAC9E,OAAO,YAAY,KAAK,uBAAuB,OAAO,kCAAkC,aAAa,mCAAmC,CAAA;AAC1I,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,27 @@
+export type SessionState = {
+    autoRounds: number;
+    lastPromptAt: number;
+    lastNoticeAt?: number;
+    noticeKey?: string;
+    spawnsThisTurn?: number;
+};
+export type MailboxState = {
+    version: 1;
+    prompted: string[];
+    ownWrites: string[];
+    sessions: Record<string, SessionState>;
+    /** Session ids this plugin created (spawn-on-send). */
+    spawnedSessions: string[];
+    /** Message hashes that already triggered a spawn. */
+    spawnedHashes: string[];
+    lastSpawnAt?: number;
+};
+export declare function emptyState(): MailboxState;
+export declare class StateStore {
+    private file;
+    private now;
+    constructor(file: string, now?: () => number);
+    read(): MailboxState;
+    write(state: MailboxState): void;
+    update(mutator: (state: MailboxState) => void): MailboxState;
+}

package/dist/state.js

@@ -0,0 +1,94 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import path from "node:path";
+const MAX_ENTRIES = 500;
+export function emptyState() {
+    return { version: 1, prompted: [], ownWrites: [], sessions: {}, spawnedSessions: [], spawnedHashes: [] };
+}
+function finiteInt(value) {
+    return typeof value === "number" && Number.isFinite(value) ? Math.floor(value) : 0;
+}
+function asStringArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    const seen = new Set();
+    const out = [];
+    for (const entry of value) {
+        if (typeof entry === "string" && !seen.has(entry)) {
+            seen.add(entry);
+            out.push(entry);
+        }
+    }
+    return out.slice(-MAX_ENTRIES);
+}
+function coerceSession(value) {
+    const obj = value && typeof value === "object" ? value : {};
+    const session = {
+        autoRounds: finiteInt(obj.autoRounds),
+        lastPromptAt: finiteInt(obj.lastPromptAt),
+    };
+    if (typeof obj.lastNoticeAt === "number" && Number.isFinite(obj.lastNoticeAt)) {
+        session.lastNoticeAt = obj.lastNoticeAt;
+    }
+    if (typeof obj.noticeKey === "string") {
+        session.noticeKey = obj.noticeKey;
+    }
+    if (typeof obj.spawnsThisTurn === "number" && Number.isFinite(obj.spawnsThisTurn)) {
+        session.spawnsThisTurn = Math.max(0, Math.floor(obj.spawnsThisTurn));
+    }
+    return session;
+}
+function coerce(value) {
+    if (!value || typeof value !== "object")
+        return emptyState();
+    const obj = value;
+    const sessions = {};
+    if (obj.sessions && typeof obj.sessions === "object") {
+        for (const [key, entry] of Object.entries(obj.sessions)) {
+            sessions[key] = coerceSession(entry);
+        }
+    }
+    return {
+        version: 1,
+        prompted: asStringArray(obj.prompted),
+        ownWrites: asStringArray(obj.ownWrites),
+        sessions,
+        spawnedSessions: asStringArray(obj.spawnedSessions),
+        spawnedHashes: asStringArray(obj.spawnedHashes),
+        ...(typeof obj.lastSpawnAt === "number" && Number.isFinite(obj.lastSpawnAt)
+            ? { lastSpawnAt: obj.lastSpawnAt }
+            : {}),
+    };
+}
+export class StateStore {
+    file;
+    now;
+    constructor(file, now) {
+        this.file = file;
+        this.now = now ?? (() => Date.now());
+    }
+    read() {
+        if (!existsSync(this.file))
+            return emptyState();
+        try {
+            const raw = readFileSync(this.file, "utf8");
+            return coerce(JSON.parse(raw));
+        }
+        catch {
+            return emptyState();
+        }
+    }
+    write(state) {
+        const clean = coerce(state);
+        mkdirSync(path.dirname(this.file), { recursive: true });
+        const tmp = `${this.file}.tmp`;
+        writeFileSync(tmp, JSON.stringify(clean, null, 2), "utf8");
+        renameSync(tmp, this.file);
+    }
+    update(mutator) {
+        const state = this.read();
+        mutator(state);
+        this.write(state);
+        return state;
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,34 @@
+import { type AckResult, type SendResult } from "./mailbox.js";
+import type { MailboxMessage } from "./parser.js";
+export type MailboxFilter = {
+    status?: string;
+    topicContains?: string;
+    limit?: number;
+};
+export type AppendInput = {
+    from: string;
+    topic: string;
+    body: string;
+    status?: "OPEN" | "DONE";
+    now?: Date;
+};
+/**
+ * Storage contract. The file backend is the MVP; a SQLite backend only has to
+ * implement these five operations to replace it without touching the tools,
+ * the wake path, or spawn-on-send.
+ */
+export interface MailboxStore {
+    readonly kind: string;
+    readonly dir: string;
+    /** Create the project's mailbox file if it is missing; returns its path. */
+    ensure(project: string): string;
+    listOpen(project: string): MailboxMessage[];
+    read(project: string): MailboxMessage[];
+    append(project: string, input: AppendInput): SendResult;
+    ack(project: string, target: {
+        hash?: string;
+        header?: string;
+    }): AckResult;
+    query(project: string, filter?: MailboxFilter): MailboxMessage[];
+}
+export declare function createFileStore(dir: string): MailboxStore;

package/dist/store.js

@@ -0,0 +1,55 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { ackMessage, readMailbox, sendMessage } from "./mailbox.js";
+import { mailboxFile } from "./paths.js";
+export function createFileStore(dir) {
+    const root = path.resolve(dir);
+    const fileFor = (project) => mailboxFile(root, project);
+    return {
+        kind: "file",
+        dir: root,
+        ensure(project) {
+            const target = fileFor(project);
+            if (!existsSync(target)) {
+                mkdirSync(path.dirname(target), { recursive: true });
+                writeFileSync(target, `# ${project} mailbox\n\nMessages addressed to \`${project}\`. Append-only.\n`, "utf8");
+            }
+            return target;
+        },
+        listOpen(project) {
+            return readMailbox(fileFor(project)).open;
+        },
+        read(project) {
+            return readMailbox(fileFor(project)).messages;
+        },
+        append(project, input) {
+            return sendMessage({
+                mailboxDir: root,
+                to: project,
+                from: input.from,
+                topic: input.topic,
+                body: input.body,
+                status: input.status,
+                now: input.now,
+            });
+        },
+        ack(project, target) {
+            return ackMessage({ file: fileFor(project), hash: target.hash, header: target.header });
+        },
+        query(project, filter = {}) {
+            let list = readMailbox(fileFor(project)).messages;
+            if (filter.status) {
+                const wanted = filter.status.toUpperCase();
+                list = list.filter((message) => message.status === wanted);
+            }
+            if (filter.topicContains) {
+                const needle = filter.topicContains.toLowerCase();
+                list = list.filter((message) => message.topic.toLowerCase().includes(needle));
+            }
+            if (filter.limit && filter.limit > 0)
+                list = list.slice(-filter.limit);
+            return list;
+        },
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "opencode-workspace-mailbox",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "A per-project mailbox for OpenCode sessions — detect OPEN handoff messages on idle, prompt the agent to handle them, with loop guards",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mr-wolf-rsh/opencode-workspace-mailbox.git"
+  },
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "prepack": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "mailbox",
+    "handoff",
+    "agent",
+    "automation"
+  ],
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.0.0",
+    "@opencode-ai/sdk": ">=1.0.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.18.18",
+    "@opencode-ai/sdk": "^1.18.18",
+    "@types/node": "^22.10.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.8"
+  }
+}