@richhardry/codor 0.10.0

package/node_modules/@codor/switchboard/dist/router.d.ts

@@ -0,0 +1,120 @@
+import { type Member, type Message, type ParsedBody, type RoomConfig } from '@codor/protocol';
+export { isAddressable, parseBody } from '@codor/protocol';
+export type { ParsedBody } from '@codor/protocol';
+/**
+ * The pure router — PROTOCOL §3 as functions over (message, room state).
+ * No IO, no store: the daemon feeds it context and materializes its output.
+ */
+export interface EligibilityContext {
+    /** The room member row for the message author. */
+    author: Member | undefined;
+    /** The message this one replies to, when reply_to is set. */
+    repliedTo?: Message;
+}
+/**
+ * Routing eligibility comes FIRST. Routed: `chat` authored by a human,
+ * agent, or bridge member, and FINALIZED `run` messages. Never routed:
+ * `system` messages, `ask`/`approval` cards, anything authored by the
+ * system member, and chat replies to a card (audit replies) — none of
+ * these may ever trigger an agent turn. A finalized run with an EMPTY body
+ * (interrupted turn, or a model deliberately replying with nothing) is not
+ * routable either: an empty body can mention nobody, so routing it could
+ * only fire the untagged default — which live-looped two agents through
+ * endless empty acknowledgment turns (found in M0 acceptance).
+ */
+export declare function isRoutable(message: Message, ctx: EligibilityContext): boolean;
+export interface RoutingContext extends EligibilityContext {
+    /** Full room roster. */
+    members: Member[];
+    /** Current channel metadata used by the fresh-channel default chain. */
+    roomConfig: RoomConfig;
+    /** Author id of the latest FINALIZED agent message, if any ever finished. */
+    latestFinalizedAgentAuthor?: string;
+    /**
+     * For agent-authored messages: author of the delivery that triggered the
+     * run (for a batched turn, the author of the LAST delivery in the batch).
+     */
+    triggerAuthor?: string;
+}
+export interface RouteResult {
+    routable: boolean;
+    parsed: ParsedBody;
+    /** Agent recipients — each becomes a queued delivery feeding a turn. */
+    agents: Member[];
+    /** Human recipients — inbox records only, never turns. */
+    humans: Member[];
+    /** True when nothing resolves: room commentary, delivered to nobody. */
+    commentary: boolean;
+    /** Finalized agent message contained unresolvable handle-shaped tokens. */
+    misaddressed: boolean;
+}
+/**
+ * Mentions select recipients; content is never split. The recipient set is
+ * the union of valid mentions (duplicates collapse, self-mentions ignored);
+ * a mentionless message falls back to the default recipient rule.
+ */
+export declare function resolveRecipients(message: Message, ctx: RoutingContext): RouteResult;
+export interface ResolvedRef {
+    id: number;
+    author_handle: string;
+    ts: string;
+    body: string;
+}
+export interface DeliveryBriefingContext {
+    /** Omitted for grouped rounds, where unmentioned final results close the group. */
+    conventions?: {
+        untaggedGoesTo?: string;
+        ledger?: boolean;
+        liveInbox?: boolean;
+    };
+    roster?: {
+        handle: string;
+        kind: Member['kind'];
+        purpose?: string;
+    }[];
+}
+export interface PayloadContext extends DeliveryBriefingContext {
+    room: string;
+    message: Message;
+    authorHandle: string;
+    authorKind: Member['kind'];
+    /** All recipient handles, mention order — identical on every delivery. */
+    toHandles: string[];
+    refs: ResolvedRef[];
+    ledgerRefs?: {
+        name: string;
+        body: string;
+    }[];
+    awaitingReply?: boolean;
+}
+export declare function composeDeliveryBriefing(ctx: DeliveryBriefingContext): string;
+/**
+ * The exact bytes a recipient session receives — pinned by goldens in
+ * router.spec.ts. Keep payloads lean: sessions pay tokens for every byte.
+ */
+export declare function composePayload(ctx: PayloadContext, you: string): string;
+/**
+ * Fan-out: one payload per recipient, byte-identical except the `you=`
+ * field — the whole body plus all resolved refs, never per-mention slices.
+ */
+export declare function composeDeliveryPayloads(ctx: PayloadContext, recipients: Member[]): Map<string, string>;
+export interface BrakeStats {
+    /** Consecutive agent→agent deliveries since the last human message. */
+    consecutiveAgentDeliveries: number;
+    /** Cost accumulated today from cost-reporting members. */
+    spendTodayUsd: number;
+}
+export type BrakeVerdict = {
+    hold: false;
+} | {
+    hold: true;
+    reason: 'turn_brake' | 'spend_brake';
+};
+/**
+ * Opt-in brakes (PROTOCOL §3): with the default null config NOTHING holds —
+ * chains run until the work is done. A configured turn brake holds the next
+ * delivery once the agent→agent chain reaches the limit; a spend brake
+ * holds once today's cost reaches the threshold.
+ */
+export declare function evaluateBrakes(config: RoomConfig, stats: BrakeStats): BrakeVerdict;
+//# sourceMappingURL=router.d.ts.map

package/node_modules/@codor/switchboard/dist/router.d.ts.map

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

package/node_modules/@codor/switchboard/dist/router.js

@@ -0,0 +1,198 @@
+import { effectiveDefaultAgent, isAddressable, parseBody, } from '@codor/protocol';
+export { isAddressable, parseBody } from '@codor/protocol';
+// harn:assume substantive-routing-excludes-acknowledgements ref=substantive-run-eligibility
+/**
+ * Routing eligibility comes FIRST. Routed: `chat` authored by a human,
+ * agent, or bridge member, and FINALIZED `run` messages. Never routed:
+ * `system` messages, `ask`/`approval` cards, anything authored by the
+ * system member, and chat replies to a card (audit replies) — none of
+ * these may ever trigger an agent turn. A finalized run with an EMPTY body
+ * (interrupted turn, or a model deliberately replying with nothing) is not
+ * routable either: an empty body can mention nobody, so routing it could
+ * only fire the untagged default — which live-looped two agents through
+ * endless empty acknowledgment turns (found in M0 acceptance).
+ */
+export function isRoutable(message, ctx) {
+    if (!ctx.author)
+        return false;
+    if (ctx.author.kind === 'system' || ctx.author.kind === 'extension')
+        return false;
+    if (message.kind === 'system' || message.kind === 'ask' || message.kind === 'approval') {
+        return false;
+    }
+    if (message.kind === 'run') {
+        return (message.ack !== true &&
+            message.run !== undefined &&
+            message.run.status !== 'running' &&
+            message.body.trim() !== '');
+    }
+    // chat: audit replies on cards never route
+    if (message.reply_to !== undefined &&
+        ctx.repliedTo !== undefined &&
+        (ctx.repliedTo.kind === 'ask' || ctx.repliedTo.kind === 'approval')) {
+        return false;
+    }
+    return true;
+}
+const NO_ROUTE = {
+    routable: false,
+    agents: [],
+    humans: [],
+    commentary: false,
+    misaddressed: false,
+};
+/**
+ * Mentions select recipients; content is never split. The recipient set is
+ * the union of valid mentions (duplicates collapse, self-mentions ignored);
+ * a mentionless message falls back to the default recipient rule.
+ */
+export function resolveRecipients(message, ctx) {
+    const parsed = message.ack === true
+        ? { mentions: [], refs: [], ledger_refs: [], unresolved: [] }
+        : parseBody(message.body, ctx.members);
+    if (!isRoutable(message, ctx))
+        return { ...NO_ROUTE, parsed };
+    const byId = new Map(ctx.members.map((m) => [m.id, m]));
+    const recipients = [];
+    for (const span of parsed.mentions) {
+        if (span.member_id === message.author)
+            continue; // self-mentions ignored
+        const member = byId.get(span.member_id);
+        if (member && !recipients.some((r) => r.id === member.id))
+            recipients.push(member);
+    }
+    // harn:assume default-recipient-fallback-chain ref=substantive-default-recipient
+    // Zero valid mentions → human/bridge messages default to the author of the
+    // latest FINALIZED agent message, then the live configured starting agent,
+    // then a sole live agent (running placeholders never become "latest");
+    // agent messages default to whoever triggered the run (last delivery of a
+    // batch). No candidate → room commentary, delivered to nobody.
+    if (recipients.length === 0) {
+        const authorKind = ctx.author.kind;
+        const fallback = authorKind === 'agent'
+            ? (ctx.triggerAuthor === undefined ? undefined : byId.get(ctx.triggerAuthor))
+            : effectiveDefaultAgent({
+                members: ctx.members,
+                latestFinalizedAgentId: ctx.latestFinalizedAgentAuthor,
+                startingAgentHandle: ctx.roomConfig.starting_agent_handle,
+            });
+        if (fallback && fallback.id !== message.author && isAddressable(fallback)) {
+            recipients.push(fallback);
+        }
+    }
+    // harn:end default-recipient-fallback-chain
+    // harn:assume human-deliveries-are-inbox-records ref=recipient-split
+    // Humans never get turns: the daemon materializes the humans list as inbox
+    // records (read_ts lifecycle, WS inbox frames); only agents produce
+    // queued deliveries that feed adapter turns.
+    const agents = recipients.filter((r) => r.kind === 'agent');
+    const humans = recipients.filter((r) => r.kind === 'human');
+    // harn:end human-deliveries-are-inbox-records
+    const misaddressed = ctx.author.kind === 'agent' &&
+        (message.kind !== 'run' || message.run?.status !== 'running') &&
+        parsed.unresolved.length > 0;
+    return {
+        routable: true,
+        parsed,
+        agents,
+        humans,
+        commentary: recipients.length === 0,
+        misaddressed,
+    };
+}
+const minuteUtc = (ts) => `${ts.slice(0, 16)}Z`;
+// harn:assume roster-briefing-refreshes-on-membership ref=roster-payload-block
+export function composeDeliveryBriefing(ctx) {
+    let payload = '';
+    if (ctx.roster) {
+        payload += '\n[roster:\n';
+        for (const member of ctx.roster) {
+            payload += `@${member.handle} (${member.kind}${member.purpose ? `, ${member.purpose}` : ''})\n`;
+        }
+        payload += ']\n';
+    }
+    if (ctx.conventions) {
+        // harn:assume collaboration-briefing-is-capability-aware ref=collaboration-conventions
+        // harn:assume agent-briefings-distinguish-invocation-from-discussion ref=explicit-invocation-conventions
+        const untagged = ctx.conventions.untaggedGoesTo === undefined
+            ? ''
+            : ` An untagged reply goes to @${ctx.conventions.untaggedGoesTo}.`;
+        payload +=
+            `\n[conventions: your normal final reply posts to the channel automatically. ` +
+                `An @mention invokes that member and auto-sends your message; write the member's ` +
+                `plain name without @ when merely discussing them.${untagged} ` +
+                `Reference messages as #N.${ctx.conventions.ledger ? ' Cite ledger notes as [[name]].' : ''} ` +
+                `Use codor post only for interim updates and --wait when a direct reply is required; ` +
+                `on timeout, check codor status and renew while the peer is active. ` +
+                `${ctx.conventions.liveInbox ? '' : 'During long tasks, check codor inbox --new. '}` +
+                `Use codor search --runs before asking about unseen referenced context. ` +
+                `Use <ACK_OK> as your entire reply only when a message needs no action and no answer; ` +
+                `never append it after doing work or as a sign-off.]\n`;
+        // harn:end agent-briefings-distinguish-invocation-from-discussion
+        // harn:end collaboration-briefing-is-capability-aware
+    }
+    return payload;
+}
+// harn:end roster-briefing-refreshes-on-membership
+// harn:assume ledger-home-only-refs-travel ref=ledger-aware-payload
+/**
+ * The exact bytes a recipient session receives — pinned by goldens in
+ * router.spec.ts. Keep payloads lean: sessions pay tokens for every byte.
+ */
+export function composePayload(ctx, you) {
+    const to = ctx.toHandles.map((h) => `@${h}`).join(' ');
+    // harn:assume codor-delivery-header-identifies-channel ref=delivery-header-template
+    // harn:assume awaiting-reply-marker-is-delivery-context ref=awaiting-reply-header
+    const headerKind = ctx.awaitingReply ? 'chat, awaiting reply' : ctx.authorKind;
+    let payload = `[codor channel=${ctx.room} msg=#${ctx.message.id} from=@${ctx.authorHandle} (${headerKind})\n` +
+        ` to=${to} · you=@${you}]\n` +
+        `\n` +
+        `${ctx.message.body}\n`;
+    // harn:end awaiting-reply-marker-is-delivery-context
+    // harn:end codor-delivery-header-identifies-channel
+    for (const ref of ctx.refs) {
+        payload +=
+            `\n--- referenced #${ref.id} · @${ref.author_handle} · ${minuteUtc(ref.ts)} ---\n` +
+                `${ref.body}\n` +
+                `--- end reference ---\n`;
+    }
+    for (const ref of ctx.ledgerRefs ?? []) {
+        payload +=
+            `\n--- ledger [[${ref.name}]] ---\n` +
+                `${ref.body}\n` +
+                `--- end ledger note ---\n`;
+    }
+    payload += composeDeliveryBriefing(ctx);
+    return payload;
+}
+// harn:end ledger-home-only-refs-travel
+// harn:assume whole-message-delivery ref=payload-fanout
+/**
+ * Fan-out: one payload per recipient, byte-identical except the `you=`
+ * field — the whole body plus all resolved refs, never per-mention slices.
+ */
+export function composeDeliveryPayloads(ctx, recipients) {
+    const payloads = new Map();
+    for (const recipient of recipients) {
+        payloads.set(recipient.id, composePayload(ctx, recipient.handle));
+    }
+    return payloads;
+}
+// harn:assume brakes-opt-in-hold ref=brake-evaluation
+/**
+ * Opt-in brakes (PROTOCOL §3): with the default null config NOTHING holds —
+ * chains run until the work is done. A configured turn brake holds the next
+ * delivery once the agent→agent chain reaches the limit; a spend brake
+ * holds once today's cost reaches the threshold.
+ */
+export function evaluateBrakes(config, stats) {
+    if (config.turn_brake !== null && stats.consecutiveAgentDeliveries >= config.turn_brake) {
+        return { hold: true, reason: 'turn_brake' };
+    }
+    if (config.spend_brake_usd !== null && stats.spendTodayUsd >= config.spend_brake_usd) {
+        return { hold: true, reason: 'spend_brake' };
+    }
+    return { hold: false };
+}
+// harn:end brakes-opt-in-hold
+//# sourceMappingURL=router.js.map

package/node_modules/@codor/switchboard/dist/router.js.map

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

package/node_modules/@codor/switchboard/dist/server.d.ts

@@ -0,0 +1,50 @@
+import { type FastifyInstance } from 'fastify';
+import type { CryptoVault } from './crypto/pairing.js';
+import { type Daemon } from './daemon.js';
+import type { PushSubscriptionStore } from './push/subscriptions.js';
+export interface ServerOptions {
+    daemon: Daemon;
+    /** Single pairing token — the authenticated principal IS the room owner. */
+    token: string;
+    /** Optional pre-enrolled local principals; enrollment/directory service is out of scope. */
+    principals?: readonly {
+        token: string;
+        member_id: string;
+    }[];
+    host?: string;
+    port?: number;
+    /** Serve the built web SPA from this directory (the switchboard IS the web host). */
+    staticRoot?: string;
+    /** Local CLI transport; filesystem mode is 0600 and no bearer token crosses it. */
+    socketPath?: string;
+    /** Device enrollment and room-key authority for this switchboard. */
+    crypto?: CryptoVault;
+    /** Paired browser Web Push destinations; content remains on the switchboard. */
+    pushSubscriptions?: PushSubscriptionStore;
+    /** Public VAPID application-server key used by browser PushManager.subscribe. */
+    pushVapidPublicKey?: string;
+    /** True only when the producer has a validated relay destination. */
+    pushRelayEnabled?: boolean;
+    /** Trust Tailscale Serve's injected identity header for browser enrollment. */
+    trustTailscaleServe?: boolean;
+    /** Testable operator-home boundary; defaults to the process home. */
+    homeDir?: string;
+    /** Observe-only when omitted/zero; a positive value gates browser UI hydration. */
+    minimumBrowserProtocol?: number;
+    /** Test/operations hook fired when a browser reports a positive protocol epoch. */
+    onBrowserProtocolObserved?: (protocol: number) => void;
+}
+export interface RunningServer {
+    app: FastifyInstance;
+    port: number;
+    socketPath?: string;
+    observedBrowserProtocols(): number[];
+    close(): Promise<void>;
+}
+/**
+ * The API surface: one WebSocket (subscribe/post/act) + small REST (sync,
+ * blob fetch, room + member management). Everything served here has already
+ * passed the daemon's redaction projection.
+ */
+export declare function startServer(options: ServerOptions): Promise<RunningServer>;
+//# sourceMappingURL=server.d.ts.map

package/node_modules/@codor/switchboard/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAQA,OAAgB,EAAE,KAAK,eAAe,EAA0C,MAAM,SAAS,CAAC;AAqBhG,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,KAAK,MAAM,EAAwB,MAAM,aAAa,CAAC;AAGhE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,4FAA4F;IAC5F,UAAU,CAAC,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;IAC1C,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,mFAAmF;IACnF,yBAAyB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACxD;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,eAAe,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB,IAAI,MAAM,EAAE,CAAC;IACrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA0ED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAmzChF"}