cimux-mcp 0.1.0

package/dist/model/context-package.js

@@ -0,0 +1,153 @@
+import { z } from "zod";
+// A mailbox is addressed by the harness plus a local working name.
+// Examples: codex/feature-login, claude/auth-repro, cursor/fix-nav.
+export const mailboxNameSchema = z
+    .string()
+    .min(3)
+    .max(140)
+    .regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]*\/[a-zA-Z0-9][a-zA-Z0-9._-]*$/, {
+    message: "Mailbox name must use harness/name format, for example codex/feature-checkout-ui"
+});
+export const mailboxSchema = z.object({
+    name: mailboxNameSchema,
+    createdAt: z.string().datetime(),
+    lastSeenAt: z.string().datetime().nullable()
+});
+// Artifacts are pointers that help the receiving agent find the relevant work.
+// They are not meant to replace the full repository, diff, or external system.
+export const fileArtifactSchema = z.object({
+    path: z.string().min(1),
+    repo: z.string().optional(),
+    lineStart: z.number().int().positive().optional(),
+    lineEnd: z.number().int().positive().optional(),
+    note: z.string().optional()
+});
+export const functionArtifactSchema = z.object({
+    name: z.string().min(1),
+    file: z.string().optional(),
+    signature: z.string().optional(),
+    note: z.string().optional()
+});
+export const commitArtifactSchema = z.object({
+    sha: z.string().min(1),
+    repo: z.string().optional(),
+    message: z.string().optional()
+});
+export const pullRequestArtifactSchema = z.object({
+    id: z.string().min(1).optional(),
+    url: z.string().url().optional(),
+    title: z.string().optional()
+});
+export const urlArtifactSchema = z.object({
+    url: z.string().url(),
+    title: z.string().optional()
+});
+export const codeSnippetArtifactSchema = z.object({
+    language: z.string().optional(),
+    label: z.string().optional(),
+    code: z.string().min(1)
+});
+export const artifactsSchema = z
+    .object({
+    files: z.array(fileArtifactSchema).default([]),
+    functions: z.array(functionArtifactSchema).default([]),
+    commits: z.array(commitArtifactSchema).default([]),
+    pullRequests: z.array(pullRequestArtifactSchema).default([]),
+    urls: z.array(urlArtifactSchema).default([]),
+    codeSnippets: z.array(codeSnippetArtifactSchema).default([])
+})
+    .default({});
+// Ack means "the receiver saw or loaded this", not "the work is complete".
+export const ackStateSchema = z.object({
+    status: z.enum(["pending", "acknowledged"]),
+    ackAt: z.string().datetime().nullable(),
+    ackBy: mailboxNameSchema.nullable(),
+    note: z.string().nullable()
+});
+// This is the shape a sender provides. Server-managed fields such as id,
+// createdAt, readAt, and ack are added later by the storage/service layer.
+export const createContextPackageInputSchema = z.object({
+    fromMailbox: mailboxNameSchema,
+    toMailbox: mailboxNameSchema,
+    title: z.string().min(1).max(500),
+    summary: z.string().min(1).max(4000),
+    body: z.string().min(1),
+    tags: z.array(z.string().min(1).max(80)).default([]),
+    artifacts: artifactsSchema.default({}),
+    payload: z.record(z.unknown()).default({})
+});
+// This is the durable object Cimux stores and returns from read_context.
+export const contextPackageSchema = createContextPackageInputSchema.extend({
+    id: z.string().min(1),
+    createdAt: z.string().datetime(),
+    readAt: z.string().datetime().nullable(),
+    ack: ackStateSchema
+});
+// Inbox previews are deliberately smaller than full packages. They let an agent
+// decide whether to call read_context without dumping body text, code snippets,
+// artifact details, or payload values into context.
+export const contextPackagePreviewSchema = z.object({
+    id: z.string().min(1),
+    fromMailbox: mailboxNameSchema,
+    toMailbox: mailboxNameSchema,
+    title: z.string(),
+    summary: z.string(),
+    tags: z.array(z.string()),
+    createdAt: z.string().datetime(),
+    readAt: z.string().datetime().nullable(),
+    ack: ackStateSchema,
+    artifactCounts: z.object({
+        files: z.number().int().nonnegative(),
+        functions: z.number().int().nonnegative(),
+        commits: z.number().int().nonnegative(),
+        pullRequests: z.number().int().nonnegative(),
+        urls: z.number().int().nonnegative(),
+        codeSnippets: z.number().int().nonnegative()
+    }),
+    payloadKeys: z.array(z.string())
+});
+export const DEFAULT_INBOX_PREVIEW_LIMIT = 20;
+export const MAX_INBOX_PREVIEW_LIMIT = 50;
+export const PREVIEW_TITLE_MAX_LENGTH = 180;
+export const PREVIEW_SUMMARY_MAX_LENGTH = 280;
+export const PREVIEW_TAG_MAX_COUNT = 5;
+export function createContextPackagePreview(contextPackage) {
+    // The preview is the safe shape for check_inbox: enough metadata to decide
+    // whether to read, but no body text, snippet code, or payload values.
+    return contextPackagePreviewSchema.parse({
+        id: contextPackage.id,
+        fromMailbox: contextPackage.fromMailbox,
+        toMailbox: contextPackage.toMailbox,
+        title: truncate(contextPackage.title, PREVIEW_TITLE_MAX_LENGTH),
+        summary: truncate(contextPackage.summary, PREVIEW_SUMMARY_MAX_LENGTH),
+        tags: contextPackage.tags.slice(0, PREVIEW_TAG_MAX_COUNT),
+        createdAt: contextPackage.createdAt,
+        readAt: contextPackage.readAt,
+        ack: contextPackage.ack,
+        artifactCounts: {
+            files: contextPackage.artifacts.files.length,
+            functions: contextPackage.artifacts.functions.length,
+            commits: contextPackage.artifacts.commits.length,
+            pullRequests: contextPackage.artifacts.pullRequests.length,
+            urls: contextPackage.artifacts.urls.length,
+            codeSnippets: contextPackage.artifacts.codeSnippets.length
+        },
+        payloadKeys: Object.keys(contextPackage.payload)
+    });
+}
+export function normalizeInboxPreviewLimit(limit) {
+    if (limit === undefined) {
+        return DEFAULT_INBOX_PREVIEW_LIMIT;
+    }
+    if (!Number.isFinite(limit)) {
+        return DEFAULT_INBOX_PREVIEW_LIMIT;
+    }
+    return Math.min(Math.max(Math.trunc(limit), 1), MAX_INBOX_PREVIEW_LIMIT);
+}
+function truncate(value, maxLength) {
+    if (value.length <= maxLength) {
+        return value;
+    }
+    return value.slice(0, maxLength);
+}
+//# sourceMappingURL=context-package.js.map

package/dist/model/context-package.js.map

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

package/dist/registration/mailbox-registration.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import type { Mailbox } from "../model/context-package.js";
+import type { MailboxStore } from "../storage/mailbox-store.js";
+export declare const registerMailboxInputSchema: z.ZodObject<{
+    harness: z.ZodString;
+    explicitMailbox: z.ZodOptional<z.ZodString>;
+    branchName: z.ZodOptional<z.ZodString>;
+    taskName: z.ZodOptional<z.ZodString>;
+    folderName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    harness: string;
+    explicitMailbox?: string | undefined;
+    branchName?: string | undefined;
+    taskName?: string | undefined;
+    folderName?: string | undefined;
+}, {
+    harness: string;
+    explicitMailbox?: string | undefined;
+    branchName?: string | undefined;
+    taskName?: string | undefined;
+    folderName?: string | undefined;
+}>;
+export type RegisterMailboxInput = z.input<typeof registerMailboxInputSchema>;
+export type RegisterMailboxResult = {
+    mailbox: Mailbox;
+    mailboxes: Mailbox[];
+    inferred: boolean;
+};
+export declare function registerMailbox(store: MailboxStore, input: RegisterMailboxInput): Promise<RegisterMailboxResult>;
+export declare function inferMailboxName(input: RegisterMailboxInput): string;

package/dist/registration/mailbox-registration.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { mailboxNameSchema } from "../model/context-package.js";
+export const registerMailboxInputSchema = z.object({
+    harness: z.string().min(1),
+    explicitMailbox: mailboxNameSchema.optional(),
+    branchName: z.string().min(1).optional(),
+    taskName: z.string().min(1).optional(),
+    folderName: z.string().min(1).optional()
+});
+export async function registerMailbox(store, input) {
+    const parsed = registerMailboxInputSchema.parse(input);
+    const inferredName = inferMailboxName(parsed);
+    const mailbox = await store.createMailbox(inferredName);
+    const mailboxes = await store.listMailboxes();
+    return {
+        mailbox,
+        mailboxes,
+        inferred: !parsed.explicitMailbox
+    };
+}
+export function inferMailboxName(input) {
+    if (input.explicitMailbox) {
+        return mailboxNameSchema.parse(input.explicitMailbox);
+    }
+    const harness = slugify(input.harness);
+    const localName = 
+    // Branch is preferred because it usually maps to the actual workstream.
+    slugify(input.branchName) ||
+        // Task names are useful when there is no branch yet.
+        slugify(input.taskName) ||
+        // Folder name is the final stable local fallback.
+        slugify(input.folderName) ||
+        "default";
+    return mailboxNameSchema.parse(`${harness}/${localName}`);
+}
+function slugify(value) {
+    if (!value) {
+        return "";
+    }
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^[^a-z0-9]+/, "")
+        .replace(/[^a-z0-9]+$/, "")
+        .slice(0, 80);
+}
+//# sourceMappingURL=mailbox-registration.js.map

package/dist/registration/mailbox-registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-registration.js","sourceRoot":"","sources":["../../src/registration/mailbox-registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAIhE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,eAAe,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IAC7C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAUH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAmB,EACnB,KAA2B;IAE3B,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,aAAa,EAAE,CAAC;IAE9C,OAAO;QACL,OAAO;QACP,SAAS;QACT,QAAQ,EAAE,CAAC,MAAM,CAAC,eAAe;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAA2B;IAC1D,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,OAAO,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,SAAS;IACb,wEAAwE;IACxE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;QACzB,qDAAqD;QACrD,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QACvB,kDAAkD;QAClD,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;QACzB,SAAS,CAAC;IAEZ,OAAO,iBAAiB,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,KAAK;SACT,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/runtime/mailbox-runtime.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export declare const runtimeMailboxInputSchema: z.ZodObject<{
+    harness: z.ZodOptional<z.ZodString>;
+    explicitMailbox: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    cwd: string;
+    harness?: string | undefined;
+    explicitMailbox?: string | undefined;
+}, {
+    harness?: string | undefined;
+    explicitMailbox?: string | undefined;
+    cwd?: string | undefined;
+}>;
+export type RuntimeMailboxInput = z.input<typeof runtimeMailboxInputSchema>;
+export type RuntimeMailboxResult = {
+    mailbox: string;
+    inferredFrom: "explicit" | "branch" | "folder";
+    branchName: string | null;
+    folderName: string;
+};
+export declare function resolveRuntimeMailbox(input?: RuntimeMailboxInput): RuntimeMailboxResult;

package/dist/runtime/mailbox-runtime.js

@@ -0,0 +1,50 @@
+import { execFileSync } from "node:child_process";
+import path from "node:path";
+import { z } from "zod";
+import { inferMailboxName } from "../registration/mailbox-registration.js";
+import { mailboxNameSchema } from "../model/context-package.js";
+export const runtimeMailboxInputSchema = z.object({
+    harness: z.string().min(1).optional(),
+    explicitMailbox: mailboxNameSchema.optional(),
+    cwd: z.string().min(1).default(process.cwd())
+});
+export function resolveRuntimeMailbox(input = {}) {
+    const parsed = runtimeMailboxInputSchema.parse(input);
+    const folderName = path.basename(parsed.cwd);
+    if (parsed.explicitMailbox) {
+        return {
+            mailbox: parsed.explicitMailbox,
+            inferredFrom: "explicit",
+            branchName: null,
+            folderName
+        };
+    }
+    const branchName = readGitBranch(parsed.cwd);
+    const mailbox = inferMailboxName({
+        harness: parsed.harness ?? "codex",
+        branchName: branchName ?? undefined,
+        folderName
+    });
+    return {
+        mailbox,
+        inferredFrom: branchName ? "branch" : "folder",
+        branchName,
+        folderName
+    };
+}
+function readGitBranch(cwd) {
+    try {
+        // Hooks run from the active session cwd. Asking git directly keeps mailbox
+        // naming aligned with the real workstream without requiring user setup.
+        const output = execFileSync("git", ["branch", "--show-current"], {
+            cwd,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"]
+        }).trim();
+        return output || null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=mailbox-runtime.js.map

package/dist/runtime/mailbox-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-runtime.js","sourceRoot":"","sources":["../../src/runtime/mailbox-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrC,eAAe,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IAC7C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;CAC9C,CAAC,CAAC;AAWH,MAAM,UAAU,qBAAqB,CAAC,QAA6B,EAAE;IACnE,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAE7C,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,eAAe;YAC/B,YAAY,EAAE,UAAU;YACxB,UAAU,EAAE,IAAI;YAChB,UAAU;SACX,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,gBAAgB,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO;QAClC,UAAU,EAAE,UAAU,IAAI,SAAS;QACnC,UAAU;KACX,CAAC,CAAC;IAEH,OAAO;QACL,OAAO;QACP,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;QAC9C,UAAU;QACV,UAAU;KACX,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,CAAC;QACH,2EAA2E;QAC3E,wEAAwE;QACxE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC,EAAE;YAC/D,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,OAAO,MAAM,IAAI,IAAI,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/service/cimux-mailbox-service.d.ts

@@ -0,0 +1,87 @@
+import { z } from "zod";
+import type { ContextPackage, ContextPackagePreview, CreateContextPackageInput } from "../model/context-package.js";
+import { type RegisterMailboxInput, type RegisterMailboxResult } from "../registration/mailbox-registration.js";
+import type { ContextPackageStore, MailboxStore } from "../storage/mailbox-store.js";
+export declare const checkInboxInputSchema: z.ZodObject<{
+    mailbox: z.ZodString;
+    unreadOnly: z.ZodDefault<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    mailbox: string;
+    unreadOnly: boolean;
+    limit?: number | undefined;
+}, {
+    mailbox: string;
+    unreadOnly?: boolean | undefined;
+    limit?: number | undefined;
+}>;
+export declare const readContextInputSchema: z.ZodObject<{
+    mailbox: z.ZodString;
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    mailbox: string;
+}, {
+    id: string;
+    mailbox: string;
+}>;
+export declare const ackContextInputSchema: z.ZodObject<{
+    mailbox: z.ZodString;
+    id: z.ZodString;
+} & {
+    note: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    mailbox: string;
+    note?: string | undefined;
+}, {
+    id: string;
+    mailbox: string;
+    note?: string | undefined;
+}>;
+export declare const inboxNotificationInputSchema: z.ZodObject<{
+    mailbox: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    mailbox: string;
+    limit: number;
+}, {
+    mailbox: string;
+    limit?: number | undefined;
+}>;
+export type CimuxStore = MailboxStore & ContextPackageStore;
+export type CheckInboxInput = z.input<typeof checkInboxInputSchema>;
+export type ReadContextInput = z.input<typeof readContextInputSchema>;
+export type AckContextInput = z.input<typeof ackContextInputSchema>;
+export type InboxNotificationInput = z.input<typeof inboxNotificationInputSchema>;
+export type SendContextResult = {
+    contextPackage: ContextPackage;
+};
+export type CheckInboxResult = {
+    mailbox: string;
+    previews: ContextPackagePreview[];
+};
+export type ReadContextResult = {
+    contextPackage: ContextPackage;
+};
+export type AckContextResult = {
+    contextPackage: ContextPackage;
+};
+export type InboxNotificationResult = {
+    message: string | null;
+};
+export declare class MailboxAccessError extends Error {
+    readonly mailbox: string;
+    readonly contextPackageId: string;
+    constructor(mailbox: string, contextPackageId: string);
+}
+export declare class ContextPackageNotFoundError extends Error {
+    readonly contextPackageId: string;
+    constructor(contextPackageId: string);
+}
+export declare function registerSession(store: MailboxStore, input: RegisterMailboxInput): Promise<RegisterMailboxResult>;
+export declare function sendContext(store: CimuxStore, input: CreateContextPackageInput): Promise<SendContextResult>;
+export declare function checkInbox(store: CimuxStore, input: CheckInboxInput): Promise<CheckInboxResult>;
+export declare function readContext(store: CimuxStore, input: ReadContextInput): Promise<ReadContextResult>;
+export declare function ackContext(store: CimuxStore, input: AckContextInput): Promise<AckContextResult>;
+export declare function createInboxNotification(store: CimuxStore, input: InboxNotificationInput): Promise<InboxNotificationResult>;

package/dist/service/cimux-mailbox-service.js

@@ -0,0 +1,126 @@
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+import { contextPackageSchema, createContextPackageInputSchema, mailboxNameSchema } from "../model/context-package.js";
+import { registerMailbox } from "../registration/mailbox-registration.js";
+export const checkInboxInputSchema = z.object({
+    mailbox: mailboxNameSchema,
+    unreadOnly: z.boolean().default(true),
+    limit: z.number().int().positive().optional()
+});
+export const readContextInputSchema = z.object({
+    mailbox: mailboxNameSchema,
+    id: z.string().min(1)
+});
+export const ackContextInputSchema = readContextInputSchema.extend({
+    note: z.string().max(1000).optional()
+});
+export const inboxNotificationInputSchema = z.object({
+    mailbox: mailboxNameSchema,
+    limit: z.number().int().positive().max(10).default(10)
+});
+export class MailboxAccessError extends Error {
+    mailbox;
+    contextPackageId;
+    constructor(mailbox, contextPackageId) {
+        super(`Context Package ${contextPackageId} is not addressed to ${mailbox}`);
+        this.mailbox = mailbox;
+        this.contextPackageId = contextPackageId;
+        this.name = "MailboxAccessError";
+    }
+}
+export class ContextPackageNotFoundError extends Error {
+    contextPackageId;
+    constructor(contextPackageId) {
+        super(`Unknown Context Package: ${contextPackageId}`);
+        this.contextPackageId = contextPackageId;
+        this.name = "ContextPackageNotFoundError";
+    }
+}
+export async function registerSession(store, input) {
+    return registerMailbox(store, input);
+}
+export async function sendContext(store, input) {
+    const parsed = createContextPackageInputSchema.parse(input);
+    // The sender supplies the handoff content. Cimux adds the durable bookkeeping
+    // fields so every stored package has consistent read/ack state.
+    const contextPackage = contextPackageSchema.parse({
+        ...parsed,
+        id: createContextPackageId(),
+        createdAt: new Date().toISOString(),
+        readAt: null,
+        ack: {
+            status: "pending",
+            ackAt: null,
+            ackBy: null,
+            note: null
+        }
+    });
+    return {
+        contextPackage: await store.createContextPackage(contextPackage)
+    };
+}
+export async function checkInbox(store, input) {
+    const parsed = checkInboxInputSchema.parse(input);
+    return {
+        mailbox: parsed.mailbox,
+        previews: await store.listInboxPreviews(parsed.mailbox, {
+            unreadOnly: parsed.unreadOnly,
+            ...(parsed.limit === undefined ? {} : { limit: parsed.limit })
+        })
+    };
+}
+export async function readContext(store, input) {
+    const parsed = readContextInputSchema.parse(input);
+    await assertPackageBelongsToMailbox(store, parsed.id, parsed.mailbox);
+    const contextPackage = await store.readContextPackage(parsed.id);
+    if (!contextPackage) {
+        throw new ContextPackageNotFoundError(parsed.id);
+    }
+    return { contextPackage };
+}
+export async function ackContext(store, input) {
+    const parsed = ackContextInputSchema.parse(input);
+    await assertPackageBelongsToMailbox(store, parsed.id, parsed.mailbox);
+    const contextPackage = await store.ackContextPackage(parsed.id, {
+        ackBy: parsed.mailbox,
+        ...(parsed.note === undefined ? {} : { note: parsed.note })
+    });
+    if (!contextPackage) {
+        throw new ContextPackageNotFoundError(parsed.id);
+    }
+    return { contextPackage };
+}
+export async function createInboxNotification(store, input) {
+    const parsed = inboxNotificationInputSchema.parse(input);
+    const previews = await store.listInboxPreviews(parsed.mailbox, {
+        unreadOnly: true,
+        limit: parsed.limit
+    });
+    if (previews.length === 0) {
+        return { message: null };
+    }
+    const senders = [...new Set(previews.map((preview) => preview.fromMailbox))];
+    const senderText = senders.slice(0, 3).join(", ");
+    const extraSenderCount = Math.max(senders.length - 3, 0);
+    const suffix = extraSenderCount > 0 ? ` and ${extraSenderCount} more` : "";
+    // This is the hook-safe output: one short line, no message body, no snippets,
+    // and no payload values. Empty inboxes return null so the hook emits nothing.
+    return {
+        message: `Cimux: ${previews.length} unread context package(s) for ${parsed.mailbox} from ${senderText}${suffix}. Call check_inbox to preview.`
+    };
+}
+async function assertPackageBelongsToMailbox(store, id, mailbox) {
+    const contextPackage = await store.getContextPackage(id);
+    if (!contextPackage) {
+        throw new ContextPackageNotFoundError(id);
+    }
+    // This is the local privacy boundary for the MCP tools: anyone may send to a
+    // mailbox, but reading and acknowledging require naming the recipient mailbox.
+    if (contextPackage.toMailbox !== mailbox) {
+        throw new MailboxAccessError(mailbox, id);
+    }
+}
+function createContextPackageId() {
+    return `ctx_${randomUUID()}`;
+}
+//# sourceMappingURL=cimux-mailbox-service.js.map

package/dist/service/cimux-mailbox-service.js.map

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

package/dist/storage/mailbox-store.d.ts

@@ -0,0 +1,22 @@
+import type { ContextPackage, ContextPackagePreview, Mailbox } from "../model/context-package.js";
+export type MailboxStore = {
+    createMailbox(name: string): Promise<Mailbox>;
+    getMailbox(name: string): Promise<Mailbox | null>;
+    listMailboxes(): Promise<Mailbox[]>;
+    close(): void;
+};
+export type AckContextPackageOptions = {
+    ackBy: string;
+    note?: string;
+};
+export type ListInboxPreviewsOptions = {
+    unreadOnly?: boolean;
+    limit?: number;
+};
+export type ContextPackageStore = {
+    createContextPackage(contextPackage: ContextPackage): Promise<ContextPackage>;
+    listInboxPreviews(mailboxName: string, options?: ListInboxPreviewsOptions): Promise<ContextPackagePreview[]>;
+    getContextPackage(id: string): Promise<ContextPackage | null>;
+    readContextPackage(id: string): Promise<ContextPackage | null>;
+    ackContextPackage(id: string, options: AckContextPackageOptions): Promise<ContextPackage | null>;
+};

package/dist/storage/mailbox-store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mailbox-store.js.map

package/dist/storage/mailbox-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-store.js","sourceRoot":"","sources":["../../src/storage/mailbox-store.ts"],"names":[],"mappings":""}

package/dist/storage/sqlite-cimux-store.d.ts

@@ -0,0 +1,21 @@
+import type { ContextPackage, ContextPackagePreview, Mailbox } from "../model/context-package.js";
+import type { AckContextPackageOptions, ContextPackageStore, ListInboxPreviewsOptions, MailboxStore } from "./mailbox-store.js";
+export declare class SQLiteCimuxStore implements MailboxStore, ContextPackageStore {
+    private readonly db;
+    constructor(databasePath: string);
+    createMailbox(name: string): Promise<Mailbox>;
+    getMailbox(name: string): Promise<Mailbox | null>;
+    listMailboxes(): Promise<Mailbox[]>;
+    createContextPackage(contextPackage: ContextPackage): Promise<ContextPackage>;
+    listInboxPreviews(mailboxName: string, options?: ListInboxPreviewsOptions): Promise<ContextPackagePreview[]>;
+    readContextPackage(id: string): Promise<ContextPackage | null>;
+    getContextPackage(id: string): Promise<ContextPackage | null>;
+    ackContextPackage(id: string, options: AckContextPackageOptions): Promise<ContextPackage | null>;
+    close(): void;
+    private assertMailboxExists;
+    private migrate;
+}
+export declare class UnknownMailboxError extends Error {
+    readonly mailboxName: string;
+    constructor(mailboxName: string);
+}