@richhardry/codor 0.10.0

package/node_modules/@codor/protocol/dist/adapter.d.ts

@@ -0,0 +1,118 @@
+import { z } from 'zod';
+import type { WireEvent } from './events.js';
+import type { AgentLimit, AgentUsage } from './member.js';
+export declare const PolicySchema: z.ZodEnum<{
+    "read-only": "read-only";
+    "workspace-write": "workspace-write";
+    "full-access": "full-access";
+}>;
+export type Policy = z.infer<typeof PolicySchema>;
+/** Legacy choices for thinking-capable third-party adapters without an exact declaration. */
+export declare const DEFAULT_THINKING_LEVELS: readonly ["low", "medium", "high"];
+export declare const ThinkingLevelSchema: z.ZodEnum<{
+    low: "low";
+    medium: "medium";
+    high: "high";
+    xhigh: "xhigh";
+    max: "max";
+    ultra: "ultra";
+    ultracode: "ultracode";
+}>;
+export type ThinkingLevel = z.infer<typeof ThinkingLevelSchema>;
+/** Harness-native session/rollout id — the resume token and identity anchor. */
+export type SessionRef = string;
+/**
+ * A live handle on a harness session. Adapters may carry more state
+ * internally; this is the shape the switchboard sees. `session_ref` is
+ * undefined only between `spawn()` and the harness first reporting its id
+ * (claude: `system/init.session_id`; codex: `thread.started.thread_id`).
+ */
+export interface Session {
+    harness: string;
+    session_ref?: SessionRef;
+    cwd: string;
+    model?: string;
+    policy?: string;
+    thinking?: ThinkingLevel;
+    env?: Record<string, string>;
+}
+export interface SpawnOpts {
+    cwd: string;
+    model?: string;
+    policy?: string;
+    thinking?: ThinkingLevel;
+}
+export interface AdapterCapabilities {
+    resume: boolean;
+    discover: boolean;
+    interactiveAttach: boolean;
+    ask: boolean;
+    approvals: 'runtime' | 'spawn-time';
+    extensions: boolean;
+    thinking: boolean;
+    /** Exact accepted values. Absent preserves low/medium/high for older adapters. */
+    thinking_levels?: readonly ThinkingLevel[];
+    policies: Record<Policy, string | null>;
+    live_inbox?: boolean;
+}
+/** Durable lifecycle facts reported while a turn is still in progress. */
+/**
+ * The models a harness will accept. `discovered` means the adapter asked the
+ * harness itself (its own listing command, run locally, zero spend); `curated`
+ * means the CLI offers no listing command, so the ids are cited in that
+ * adapter's NOTES.md. Model ids churn — the web must never hardcode one.
+ */
+export interface ModelCatalog {
+    models: string[];
+    source: 'discovered' | 'curated';
+}
+export interface AdapterTurnHooks {
+    /** Called after the adapter runtime accepts the turn; a retained provider process may repeat its pid. */
+    onStarted?(process: {
+        pid?: number;
+        process_group_id?: number;
+    }): void;
+    /** Called as soon as provider output or an RPC response reveals the native resume token. */
+    onSessionRef?(session_ref: SessionRef): void;
+}
+/**
+ * Adapters normalize one harness turn at a time. A driver may supervise a
+ * per-turn CLI subprocess or retain a provider-owned streaming runtime across
+ * deliver() calls; either way one deliver() call still yields exactly one turn.
+ */
+export interface HarnessAdapter {
+    id: string;
+    capabilities: AdapterCapabilities;
+    spawn(opts: SpawnOpts): Session;
+    attach(session_ref: SessionRef): Session;
+    /**
+     * Optional: estimate a session's current context from the harness's own
+     * on-disk artifacts WITHOUT running a turn. Returns an AgentUsage flagged
+     * estimated, or undefined when artifacts are missing/unreadable. The
+     * artifact is the only source that reflects out-of-band activity (e.g. an
+     * interactive /compact), so implementations must read it, never a cache.
+     */
+    peekContextUsage?(session_ref: SessionRef): Promise<AgentUsage | undefined>;
+    /**
+     * The models this harness accepts. Omitted when the harness cannot say.
+     * Never called on a request path — the daemon discovers in the background.
+     */
+    listModels?(): Promise<ModelCatalog>;
+    /** Account-level rate-limit windows reported by the harness provider. */
+    probeLimits?(): Promise<AgentLimit[] | undefined>;
+    deliver(session: Session, payload: string, hooks?: AdapterTurnHooks): AsyncIterable<WireEvent>;
+    /** Resolves on adapter acknowledgement (the interaction is truly answered). */
+    respondInteraction(session: Session, interaction_id: string, answer: unknown): Promise<void>;
+    interrupt(session: Session): void;
+    /**
+     * Optional: compact this session's context using the harness's OWN
+     * compaction — an unwrapped slash command for a persistent SDK session, a
+     * native RPC for an app server. Codor never calls this on its own: it exists
+     * so an operator watching the ring can ask, and only for an idle session.
+     * Resolves with the engine's re-baselined usage when it reports one, so the
+     * ring updates without waiting for the next turn; undefined when it does not.
+     */
+    compactSession?(session: Session): Promise<AgentUsage | undefined>;
+    discoverSessions(): SessionRef[];
+}
+//# sourceMappingURL=adapter.d.ts.map

package/node_modules/@codor/protocol/dist/adapter.d.ts.map

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

package/node_modules/@codor/protocol/dist/adapter.js

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+// harn:assume canonical-spawn-controls-enforced ref=canonical-policy-thinking-enforcement
+export const PolicySchema = z.enum(['read-only', 'workspace-write', 'full-access']);
+// harn:assume harness-declares-supported-thinking-levels ref=adapter-thinking-level-contract
+/** Legacy choices for thinking-capable third-party adapters without an exact declaration. */
+export const DEFAULT_THINKING_LEVELS = ['low', 'medium', 'high'];
+export const ThinkingLevelSchema = z.enum([
+    ...DEFAULT_THINKING_LEVELS,
+    'xhigh',
+    'max',
+    'ultra',
+    'ultracode',
+]);
+// harn:end claude-agent-sdk-query-is-the-session-runtime
+//# sourceMappingURL=adapter.js.map

package/node_modules/@codor/protocol/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,0FAA0F;AAC1F,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC;AAGpF,6FAA6F;AAC7F,6FAA6F;AAC7F,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC;IACxC,GAAG,uBAAuB;IAC1B,OAAO;IACP,KAAK;IACL,OAAO;IACP,WAAW;CACZ,CAAC,CAAC;AA0IH,yDAAyD"}

package/node_modules/@codor/protocol/dist/body.d.ts

@@ -0,0 +1,14 @@
+import { type Member } from './member.js';
+import type { MentionSpan } from './message.js';
+export interface ParsedBody {
+    mentions: MentionSpan[];
+    refs: number[];
+    ledger_refs: string[];
+    /** Handle-shaped tokens that matched no member (misaddressing signal). */
+    unresolved: string[];
+}
+/** A member the grammar can address: humans and agents in any state. */
+export declare function isAddressable(member: Member): boolean;
+/** The single PROTOCOL SS3 body grammar used by routing and destination preview. */
+export declare function parseBody(body: string, members: Member[]): ParsedBody;
+//# sourceMappingURL=body.d.ts.map

package/node_modules/@codor/protocol/dist/body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body.d.ts","sourceRoot":"","sources":["../src/body.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAID,wEAAwE;AAExE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAUD,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CAgCrE"}

package/node_modules/@codor/protocol/dist/body.js

@@ -0,0 +1,50 @@
+import { HANDLE_REGEX } from './member.js';
+const RESERVED_TOKENS = new Set(['all', 'switchboard']);
+/** A member the grammar can address: humans and agents in any state. */
+// harn:assume extensions-not-addressable-v1 ref=extension-addressability-filter
+export function isAddressable(member) {
+    return member.kind === 'human' || member.kind === 'agent';
+}
+// harn:end extensions-not-addressable-v1
+/** Replaces fenced blocks and inline code with spaces while preserving offsets. */
+function blankCodeSpans(body) {
+    const blank = (match) => match.replace(/[^\n]/g, ' ');
+    return body.replace(/```[\s\S]*?(```|$)/g, blank).replace(/`[^`\n]*`/g, blank);
+}
+// harn:assume body-parser-shared-across-router-and-web ref=shared-body-parser
+/** The single PROTOCOL SS3 body grammar used by routing and destination preview. */
+export function parseBody(body, members) {
+    const byHandle = new Map(members.map((member) => [member.handle, member]));
+    const scan = blankCodeSpans(body);
+    const mentions = [];
+    const unresolved = [];
+    const mentionRe = /(^|[^\w`@])@([a-z0-9][a-z0-9-]*)/g;
+    for (const match of scan.matchAll(mentionRe)) {
+        const handle = match[2];
+        const start = match.index + match[1].length;
+        if (!HANDLE_REGEX.test(handle) || RESERVED_TOKENS.has(handle))
+            continue;
+        const member = byHandle.get(handle);
+        if (member && isAddressable(member)) {
+            mentions.push({ member_id: member.id, start, end: start + handle.length + 1 });
+        }
+        else if (!member) {
+            unresolved.push(handle);
+        }
+    }
+    const refs = [];
+    for (const match of scan.matchAll(/(^|[^\w#])#(\d+)/g)) {
+        const id = Number(match[2]);
+        if (id > 0 && !refs.includes(id))
+            refs.push(id);
+    }
+    const ledger_refs = [];
+    for (const match of scan.matchAll(/\[\[([^\[\]\n]+)\]\]/g)) {
+        const name = match[1].trim();
+        if (name !== '' && !ledger_refs.includes(name))
+            ledger_refs.push(name);
+    }
+    return { mentions, refs, ledger_refs, unresolved: [...new Set(unresolved)] };
+}
+// harn:end body-parser-shared-across-router-and-web
+//# sourceMappingURL=body.js.map

package/node_modules/@codor/protocol/dist/body.js.map

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

package/node_modules/@codor/protocol/dist/changelog.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+/**
+ * The per-room change log records EVERY insert and in-place update of any
+ * client-visible entity — messages (incl. run finalization), members, human
+ * inbox records, meters, room config. `seq` is the ONLY delta-sync cursor:
+ * clients reconnect with `since_seq` and hydrate changed rows from the log
+ * (message-id cursors cannot express in-place run finalizations).
+ */
+export declare const ChangeEntitySchema: z.ZodEnum<{
+    message: "message";
+    member: "member";
+    room: "room";
+    inbox: "inbox";
+    meter: "meter";
+}>;
+export type ChangeEntity = z.infer<typeof ChangeEntitySchema>;
+export declare const ChangeLogEntrySchema: z.ZodObject<{
+    room: z.ZodString;
+    seq: z.ZodNumber;
+    entity: z.ZodEnum<{
+        message: "message";
+        member: "member";
+        room: "room";
+        inbox: "inbox";
+        meter: "meter";
+    }>;
+    entity_id: z.ZodString;
+}, z.core.$strip>;
+export type ChangeLogEntry = z.infer<typeof ChangeLogEntrySchema>;
+//# sourceMappingURL=changelog.d.ts.map

package/node_modules/@codor/protocol/dist/changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../src/changelog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;;;;EAA0D,CAAC;AAC1F,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,oBAAoB;;;;;;;;;;;iBAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/node_modules/@codor/protocol/dist/changelog.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { RoomIdSchema, SeqSchema } from './ids.js';
+// harn:assume changelog-is-sync-cursor ref=changelog-entry-schema
+/**
+ * The per-room change log records EVERY insert and in-place update of any
+ * client-visible entity — messages (incl. run finalization), members, human
+ * inbox records, meters, room config. `seq` is the ONLY delta-sync cursor:
+ * clients reconnect with `since_seq` and hydrate changed rows from the log
+ * (message-id cursors cannot express in-place run finalizations).
+ */
+export const ChangeEntitySchema = z.enum(['message', 'member', 'inbox', 'meter', 'room']);
+export const ChangeLogEntrySchema = z.object({
+    room: RoomIdSchema,
+    seq: SeqSchema,
+    entity: ChangeEntitySchema,
+    entity_id: z.string().min(1), // stringified: message id, member ulid, delivery id, …
+});
+// harn:end changelog-is-sync-cursor
+//# sourceMappingURL=changelog.js.map

package/node_modules/@codor/protocol/dist/changelog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.js","sourceRoot":"","sources":["../src/changelog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEnD,kEAAkE;AAClE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAG1F,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,SAAS;IACd,MAAM,EAAE,kBAAkB;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,uDAAuD;CACtF,CAAC,CAAC;AAEH,oCAAoC"}

package/node_modules/@codor/protocol/dist/default-recipient.d.ts

@@ -0,0 +1,8 @@
+import type { Member } from './member.js';
+export interface EffectiveDefaultAgentContext {
+    members: readonly Member[];
+    latestFinalizedAgentId?: string;
+    startingAgentHandle?: string;
+}
+export declare function effectiveDefaultAgent(context: EffectiveDefaultAgentContext): Member | undefined;
+//# sourceMappingURL=default-recipient.d.ts.map

package/node_modules/@codor/protocol/dist/default-recipient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-recipient.d.ts","sourceRoot":"","sources":["../src/default-recipient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AASD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,MAAM,GAAG,SAAS,CAcpB"}

package/node_modules/@codor/protocol/dist/default-recipient.js

@@ -0,0 +1,19 @@
+const activeAgent = (member) => member.kind === 'agent' && member.removed_ts === undefined;
+const liveAgent = (member) => activeAgent(member) && member.state !== 'dead';
+// harn:assume default-recipient-fallback-chain ref=effective-default-agent
+export function effectiveDefaultAgent(context) {
+    if (context.latestFinalizedAgentId !== undefined) {
+        const latest = context.members.find((member) => member.id === context.latestFinalizedAgentId && activeAgent(member));
+        if (latest)
+            return latest;
+    }
+    const live = context.members.filter(liveAgent);
+    if (context.startingAgentHandle !== undefined) {
+        const starting = live.find((member) => member.handle === context.startingAgentHandle);
+        if (starting)
+            return starting;
+    }
+    return live.length === 1 ? live[0] : undefined;
+}
+// harn:end default-recipient-fallback-chain
+//# sourceMappingURL=default-recipient.js.map

package/node_modules/@codor/protocol/dist/default-recipient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-recipient.js","sourceRoot":"","sources":["../src/default-recipient.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,GAAG,CAAC,MAAc,EAAW,EAAE,CAC9C,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC;AAE7D,MAAM,SAAS,GAAG,CAAC,MAAc,EAAW,EAAE,CAC5C,WAAW,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC;AAEjD,2EAA2E;AAC3E,MAAM,UAAU,qBAAqB,CACnC,OAAqC;IAErC,IAAI,OAAO,CAAC,sBAAsB,KAAK,SAAS,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CACjC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,OAAO,CAAC,sBAAsB,IAAI,WAAW,CAAC,MAAM,CAAC,CAChF,CAAC;QACF,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACtF,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC;AACD,4CAA4C"}

package/node_modules/@codor/protocol/dist/delivery.d.ts

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+/**
+ * Per-member FIFO inbox record. Exactly-once-or-held (PROTOCOL §3):
+ *
+ *   queued     — waiting for the recipient to go idle (or be revived)
+ *   delivering — attempt WAL: bound to `run_msg_id` BEFORE the turn spawns
+ *   consumed   — run.completed landed (agents) / inbox record created (humans)
+ *   held       — ambiguous crash reconcile or brake breach; operator releases
+ *
+ * Human recipients never get turns: their delivery is an inbox record whose
+ * read lifecycle is `read_ts` (+ the `mark_read` act).
+ */
+export declare const DeliveryStateSchema: z.ZodEnum<{
+    queued: "queued";
+    delivering: "delivering";
+    consumed: "consumed";
+    held: "held";
+}>;
+export type DeliveryState = z.infer<typeof DeliveryStateSchema>;
+export declare const DeliverySchema: z.ZodObject<{
+    id: z.ZodString;
+    room: z.ZodString;
+    message_id: z.ZodNumber;
+    recipient: z.ZodULID;
+    state: z.ZodEnum<{
+        queued: "queued";
+        delivering: "delivering";
+        consumed: "consumed";
+        held: "held";
+    }>;
+    hop_count: z.ZodOptional<z.ZodNumber>;
+    attempt_count: z.ZodDefault<z.ZodNumber>;
+    batch_id: z.ZodOptional<z.ZodString>;
+    run_msg_id: z.ZodOptional<z.ZodNumber>;
+    read_ts: z.ZodOptional<z.ZodISODateTime>;
+    interaction_resolved_ts: z.ZodOptional<z.ZodISODateTime>;
+    group_id: z.ZodOptional<z.ZodString>;
+    group_round: z.ZodOptional<z.ZodNumber>;
+    ts: z.ZodISODateTime;
+}, z.core.$strip>;
+export type Delivery = z.infer<typeof DeliverySchema>;
+//# sourceMappingURL=delivery.d.ts.map

package/node_modules/@codor/protocol/dist/delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../src/delivery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB;;;;;EAAuD,CAAC;AACxF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;iBA4BzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/node_modules/@codor/protocol/dist/delivery.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { MemberIdSchema, MessageIdSchema, RoomIdSchema, TimestampSchema } from './ids.js';
+/**
+ * Per-member FIFO inbox record. Exactly-once-or-held (PROTOCOL §3):
+ *
+ *   queued     — waiting for the recipient to go idle (or be revived)
+ *   delivering — attempt WAL: bound to `run_msg_id` BEFORE the turn spawns
+ *   consumed   — run.completed landed (agents) / inbox record created (humans)
+ *   held       — ambiguous crash reconcile or brake breach; operator releases
+ *
+ * Human recipients never get turns: their delivery is an inbox record whose
+ * read lifecycle is `read_ts` (+ the `mark_read` act).
+ */
+export const DeliveryStateSchema = z.enum(['queued', 'delivering', 'consumed', 'held']);
+export const DeliverySchema = z.object({
+    id: z.string().min(1),
+    room: RoomIdSchema,
+    message_id: MessageIdSchema, // the routed message
+    recipient: MemberIdSchema,
+    state: DeliveryStateSchema,
+    hop_count: z.number().int().nonnegative().optional(),
+    attempt_count: z.number().int().nonnegative().default(0),
+    batch_id: z.string().min(1).optional(), // set when drained as part of a batched turn
+    run_msg_id: MessageIdSchema.optional(), // attempt WAL: the run message this attempt feeds
+    read_ts: TimestampSchema.optional(), // human inbox read lifecycle
+    // harn:assume approval-deliveries-project-resolution-separately ref=approval-delivery-resolution-schema
+    // Approval resolution is lifecycle state, not evidence that a notification was read.
+    interaction_resolved_ts: TimestampSchema.optional(),
+    // harn:end approval-deliveries-project-resolution-separately
+    // harn:assume collaboration-groups-are-durable-state ref=collaboration-delivery-association-schema
+    group_id: z.string().min(1).optional(),
+    group_round: z.number().int().positive().optional(),
+    // harn:end collaboration-groups-are-durable-state
+    ts: TimestampSchema,
+}).superRefine((delivery, ctx) => {
+    if ((delivery.group_id === undefined) !== (delivery.group_round === undefined)) {
+        ctx.addIssue({
+            code: 'custom',
+            path: [delivery.group_id === undefined ? 'group_id' : 'group_round'],
+            message: 'group_id and group_round must be provided together',
+        });
+    }
+});
+//# sourceMappingURL=delivery.js.map

package/node_modules/@codor/protocol/dist/delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.js","sourceRoot":"","sources":["../src/delivery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE1F;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAGxF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,YAAY;IAClB,UAAU,EAAE,eAAe,EAAE,qBAAqB;IAClD,SAAS,EAAE,cAAc;IACzB,KAAK,EAAE,mBAAmB;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACpD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,6CAA6C;IACrF,UAAU,EAAE,eAAe,CAAC,QAAQ,EAAE,EAAE,kDAAkD;IAC1F,OAAO,EAAE,eAAe,CAAC,QAAQ,EAAE,EAAE,6BAA6B;IAClE,wGAAwG;IACxG,qFAAqF;IACrF,uBAAuB,EAAE,eAAe,CAAC,QAAQ,EAAE;IACnD,6DAA6D;IAC7D,mGAAmG;IACnG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACnD,kDAAkD;IAClD,EAAE,EAAE,eAAe;CACpB,CAAC,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;IAC/B,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,EAAE,CAAC;QAC/E,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC;YACpE,OAAO,EAAE,oDAAoD;SAC9D,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC"}