@krischoichoi/channel-harness 0.6.0

package/lib/agent-router.js

@@ -0,0 +1,33 @@
+/** Compare two routes structurally (used to detect binding route drift). */
+export function routesEqual(a, b) {
+    if (a === b)
+        return true;
+    if (!a || !b)
+        return false;
+    return (a.preset === b.preset &&
+        a.provider === b.provider &&
+        a.model === b.model &&
+        a.maxTokens === b.maxTokens);
+}
+export class AgentRouter {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    resolve(input) {
+        const overrides = this.config.routing.overrides;
+        if (overrides) {
+            const conversationAgent = overrides.conversation?.[input.conversationId];
+            if (conversationAgent)
+                return conversationAgent;
+            const accountAgent = overrides.account?.[input.accountId];
+            if (accountAgent)
+                return accountAgent;
+            const channelAgent = overrides.channel?.[input.channelId];
+            if (channelAgent)
+                return channelAgent;
+        }
+        return this.config.agent.default;
+    }
+}
+//# sourceMappingURL=agent-router.js.map

package/lib/agent-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-router.js","sourceRoot":"","sources":["../src/agent-router.ts"],"names":[],"mappings":"AAgCA,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,CAA6B,EAAE,CAA6B;IACtF,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3B,OAAO,CACL,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QACrB,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;QACzB,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QACnB,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,CAC5B,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE/C,OAAO,CAAC,KAAsB;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;QAChD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,iBAAiB,GAAG,SAAS,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACzE,IAAI,iBAAiB;gBAAE,OAAO,iBAAiB,CAAC;YAChD,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAC1D,IAAI,YAAY;gBAAE,OAAO,YAAY,CAAC;YACtC,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAC1D,IAAI,YAAY;gBAAE,OAAO,YAAY,CAAC;QACxC,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;IACnC,CAAC;CACF"}

package/lib/bind-support.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Fail-closed support behind the `/bind` command (issue #6).
+ *
+ * Resolution NEVER mutates: it resolves the query against the persisted
+ * session universe (exact id first, then a unique prefix of at least
+ * {@link MIN_BIND_QUERY_LENGTH} characters) and reports the two refusal
+ * conditions — a target already bound to a different conversation, and a
+ * persisted Agent preset that conflicts with the conversation's route (which
+ * would make the next resume throw, per the official resume semantics).
+ * `confirmBindTarget` re-runs the full resolution at confirm time (guarding
+ * against races) and only then re-points the durable binding.
+ */
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { HarnessAgentGateway } from './agent-manager.js';
+import type { ChannelBindResolution } from './commands/index.js';
+import type { SessionBindingStore } from './binding-store.js';
+/** Minimum prefix length before a non-exact query is even considered. */
+export declare const MIN_BIND_QUERY_LENGTH = 4;
+/** Resolve one `/bind` query against persisted sessions without mutating. */
+export declare function resolveBindTarget(gateway: HarnessAgentGateway, bindingStore: SessionBindingStore, agent: Agent, query: string): Promise<ChannelBindResolution>;
+/** Re-resolve and re-point the current conversation's binding at `sessionId`. */
+export declare function confirmBindTarget(gateway: HarnessAgentGateway, bindingStore: SessionBindingStore, agent: Agent, sessionId: string): Promise<void>;
+//# sourceMappingURL=bind-support.d.ts.map

package/lib/bind-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind-support.d.ts","sourceRoot":"","sources":["../src/bind-support.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,yEAAyE;AACzE,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,6EAA6E;AAC7E,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,mBAAmB,EAC5B,YAAY,EAAE,mBAAmB,EACjC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,qBAAqB,CAAC,CAgBhC;AAED,iFAAiF;AACjF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,mBAAmB,EAC5B,YAAY,EAAE,mBAAmB,EACjC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/lib/bind-support.js

@@ -0,0 +1,63 @@
+import { bindingKey } from './session-router.js';
+/** Minimum prefix length before a non-exact query is even considered. */
+export const MIN_BIND_QUERY_LENGTH = 4;
+/** Resolve one `/bind` query against persisted sessions without mutating. */
+export async function resolveBindTarget(gateway, bindingStore, agent, query) {
+    const currentBinding = await requireCurrentBinding(bindingStore, agent);
+    const ids = await gateway.listPersistedSessionIds();
+    let matches = ids.filter((id) => id === query);
+    if (matches.length === 0 && query.length >= MIN_BIND_QUERY_LENGTH) {
+        matches = ids.filter((id) => id.startsWith(query));
+    }
+    if (matches.length === 0)
+        return { kind: 'missing' };
+    if (matches.length > 1)
+        return { kind: 'ambiguous', candidates: matches.slice(0, 6) };
+    const target = matches[0];
+    const boundElsewhere = await isBoundElsewhere(bindingStore, currentBinding, target);
+    const preset = await gateway.persistedPresetOf(target);
+    const routePreset = currentBinding.route.preset;
+    const conflict = preset !== undefined && routePreset !== undefined && routePreset !== preset;
+    return { kind: 'resolved', sessionId: target, preset, boundElsewhere, conflict };
+}
+/** Re-resolve and re-point the current conversation's binding at `sessionId`. */
+export async function confirmBindTarget(gateway, bindingStore, agent, sessionId) {
+    const currentBinding = await requireCurrentBinding(bindingStore, agent);
+    if (sessionId === String(agent.id)) {
+        throw new Error('this conversation is already bound to that session');
+    }
+    // Race guard: the full resolution re-runs at confirm time; any changed
+    // condition fails the rebind instead of producing a broken binding.
+    const resolution = await resolveBindTarget(gateway, bindingStore, agent, sessionId);
+    if (resolution.kind !== 'resolved' || resolution.sessionId !== sessionId) {
+        throw new Error('bind target is no longer uniquely resolvable; refused');
+    }
+    if (resolution.boundElsewhere) {
+        throw new Error('target session is bound to another conversation; refused');
+    }
+    if (resolution.conflict) {
+        throw new Error('target session preset conflicts with this conversation route; refused');
+    }
+    await bindingStore.put({
+        ...currentBinding,
+        sessionId,
+        // Persisted composition wins, exactly like the official resume path: the
+        // next message resumes under the target's recorded preset.
+        route: resolution.preset
+            ? { ...currentBinding.route, preset: resolution.preset }
+            : currentBinding.route,
+        updatedAt: Date.now(),
+    });
+}
+async function requireCurrentBinding(bindingStore, agent) {
+    const binding = await bindingStore.findBySessionId(String(agent.id));
+    if (!binding) {
+        throw new Error(`no session binding for '${String(agent.id)}'`);
+    }
+    return binding;
+}
+async function isBoundElsewhere(bindingStore, currentBinding, targetSessionId) {
+    const existing = await bindingStore.findBySessionId(targetSessionId);
+    return !!existing && bindingKey(existing) !== bindingKey(currentBinding);
+}
+//# sourceMappingURL=bind-support.js.map

package/lib/bind-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind-support.js","sourceRoot":"","sources":["../src/bind-support.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,UAAU,EAAuB,MAAM,qBAAqB,CAAC;AAItE,yEAAyE;AACzE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAA4B,EAC5B,YAAiC,EACjC,KAAY,EACZ,KAAa;IAEb,MAAM,cAAc,GAAG,MAAM,qBAAqB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC;IACpD,IAAI,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,qBAAqB,EAAE,CAAC;QAClE,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACrD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAEtF,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;IAC3B,MAAM,cAAc,GAAG,MAAM,gBAAgB,CAAC,YAAY,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IACpF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC;IAChD,MAAM,QAAQ,GAAG,MAAM,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,MAAM,CAAC;IAC7F,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AACnF,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAA4B,EAC5B,YAAiC,EACjC,KAAY,EACZ,SAAiB;IAEjB,MAAM,cAAc,GAAG,MAAM,qBAAqB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACxE,IAAI,SAAS,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,uEAAuE;IACvE,oEAAoE;IACpE,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACpF,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU,IAAI,UAAU,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,YAAY,CAAC,GAAG,CAAC;QACrB,GAAG,cAAc;QACjB,SAAS;QACT,yEAAyE;QACzE,2DAA2D;QAC3D,KAAK,EAAE,UAAU,CAAC,MAAM;YACtB,CAAC,CAAC,EAAE,GAAG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE;YACxD,CAAC,CAAC,cAAc,CAAC,KAAK;QACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,YAAiC,EACjC,KAAY;IAEZ,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,YAAiC,EACjC,cAA8B,EAC9B,eAAuB;IAEvB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;IACrE,OAAO,CAAC,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,UAAU,CAAC,cAAc,CAAC,CAAC;AAC3E,CAAC"}

package/lib/binding-store.d.ts

@@ -0,0 +1,104 @@
+import { type SessionBinding } from './session-router.js';
+import type { AgentRouteSpec } from './agent-router.js';
+export interface SessionBindingStore {
+    get(key: string): Promise<SessionBinding | undefined>;
+    put(binding: SessionBinding): Promise<void>;
+    delete(key: string): Promise<void>;
+    /** Resolve the single current binding for a session id. */
+    findBySessionId(sessionId: string): Promise<SessionBinding | undefined>;
+}
+/** The v1 binding shape that must be migrated (never used as-is). */
+export interface SessionBindingV1 {
+    channelId: string;
+    accountId: string;
+    conversationId: string;
+    threadId?: string;
+    agentId?: string;
+    sessionId: string;
+    createdAt: number;
+    updatedAt: number;
+}
+/** The v2 binding shape that must be promoted to v3 (never used as-is). */
+export interface SessionBindingV2 {
+    channelId: string;
+    accountId: string;
+    conversationId: string;
+    threadId?: string;
+    sessionId: string;
+    route: AgentRouteSpec;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Raised by `findBySessionId` when one session id maps to more than one
+ * CURRENT binding. The durable binding authority fails closed
+ * rather than guessing which conversation "owns" the session.
+ */
+export declare class AmbiguousBindingError extends Error {
+    static readonly code: "OUTBOX_AMBIGUOUS_BINDING";
+    readonly code: "OUTBOX_AMBIGUOUS_BINDING";
+    readonly sessionId: string;
+    readonly bindingCount: number;
+    constructor(sessionId: string, bindingCount: number);
+}
+/** Whether a raw stored value is a v1 binding needing migration. */
+export declare function isV1Binding(value: unknown): value is SessionBindingV1;
+/**
+ * Whether a raw stored value is a v2 binding needing promotion to v3: a
+ * current binding carrying `route` + `sessionId` but NO `conversationType`
+ * (v2 never modeled group vs dm). A v3 entry always has `conversationType`,
+ * so it is never misread as v2.
+ */
+export declare function isV2Binding(value: unknown): value is SessionBindingV2;
+/**
+ * Normalize any stored binding into the current v3 shape.
+ *
+ * - v1 -> migrate to v2 (`route: { model: agentId }`, drop `agentId`), then
+ *   chain into v3;
+ * - v2 -> promote to v3 with the documented legacy default
+ *   `conversationType: 'dm'` and no `senderId`.
+ *
+ * Already-v3 values are returned unchanged (same reference). Migration NEVER
+ * reinterprets `agentId` as the new identity, and never fabricates a
+ * conversation type for an entry that already carries one.
+ */
+export declare function migrateBinding(value: unknown): SessionBinding;
+export declare class MemoryBindingStore implements SessionBindingStore {
+    private readonly store;
+    /** sessionId -> bindable key index. */
+    private readonly bySession;
+    get(key: string): Promise<SessionBinding | undefined>;
+    put(binding: SessionBinding): Promise<void>;
+    delete(key: string): Promise<void>;
+    findBySessionId(sessionId: string): Promise<SessionBinding | undefined>;
+    private index;
+}
+/**
+ * Single-file JSON binding store. Loads once into memory; writes are
+ * serialized through a promise chain and land atomically (temp + rename).
+ * On load, any v1/v2 entries are migrated to v3 (in memory) and the migrated
+ * file is re-persisted immediately. A `sessionId -> key` index is built
+ * alongside the cache for `findBySessionId`.
+ */
+export declare class FileBindingStore implements SessionBindingStore {
+    private readonly filePath;
+    private readonly cache;
+    /** sessionId -> bindable key index. */
+    private readonly bySession;
+    private loaded;
+    private writeChain;
+    constructor(filePath: string);
+    private index;
+    private load;
+    get(key: string): Promise<SessionBinding | undefined>;
+    put(binding: SessionBinding): Promise<void>;
+    delete(key: string): Promise<void>;
+    findBySessionId(sessionId: string): Promise<SessionBinding | undefined>;
+    private persist;
+}
+/** Build the store selected by configuration (file without a path falls back to the default). */
+export declare function createBindingStore(config: {
+    type: 'memory' | 'file';
+    path?: string;
+}): SessionBindingStore;
+//# sourceMappingURL=binding-store.d.ts.map

package/lib/binding-store.d.ts.map

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

package/lib/binding-store.js

@@ -0,0 +1,354 @@
+/**
+ * Session binding persistence (doc H0.3 / §32).
+ *
+ * Adapters never touch this store; only the bridge does. The store carries a
+ * schema version (`SessionBinding.schemaVersion: 3`) and performs a one-time
+ * migration on load:
+ *
+ * - a v1 entry (no `schemaVersion`, has `agentId`) is converted to v2 by
+ *   mapping `agentId` -> `route: { model: agentId }`, then chained to v3;
+ * - a v2 entry (has `route` + `sessionId`, no `conversationType`) is converted
+ *   to v3 by adding the documented legacy default `conversationType: 'dm'`
+ *   (v2 did not model group vs dm) and leaving `senderId` unset, then stamped
+ *   `schemaVersion: 3` and logged. Bindings without the later optional
+ *   `durability` policy are treated as durable by the bridge (fail closed).
+ *
+ * Old fields are NEVER silently reinterpreted as the new semantics: `agentId`
+ * is explicitly carried into `route.model` (never onto the identity), and a v2
+ * binding is only ever promoted from an entry that truly lacks a
+ * `conversationType`.
+ *
+ * `FileBindingStore` is the default (persists a plain JSON file, written
+ * atomically via a temp file + rename and read once into a cache map) and
+ * persists the migrated file after a load-time migration. `MemoryBindingStore`
+ * is opt-in for non-persistent deployments and applies the same migration on
+ * get/put.
+ *
+ * §59: both stores expose `findBySessionId` so a durable channel can resolve
+ * the "WHERE does a reply to session S go" question from the binding
+ * authority. When more than one CURRENT binding maps to the same session, they
+ * fail CLOSED with `AmbiguousBindingError` (code `OUTBOX_AMBIGUOUS_BINDING`)
+ * instead of guessing.
+ */
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { z } from 'zod';
+import { resolveDefaultBindingStorePath } from './dsh-home.js';
+import { bindingKey, SESSION_BINDING_SCHEMA_VERSION } from './session-router.js';
+/**
+ * Raised by `findBySessionId` when one session id maps to more than one
+ * CURRENT binding. The durable binding authority fails closed
+ * rather than guessing which conversation "owns" the session.
+ */
+export class AmbiguousBindingError extends Error {
+    static code = 'OUTBOX_AMBIGUOUS_BINDING';
+    code = AmbiguousBindingError.code;
+    sessionId;
+    bindingCount;
+    constructor(sessionId, bindingCount) {
+        super("session '" + sessionId + "' maps to " + bindingCount
+            + " current channel bindings; expected exactly one (OUTBOX_AMBIGUOUS_BINDING)");
+        this.name = 'AmbiguousBindingError';
+        this.sessionId = sessionId;
+        this.bindingCount = bindingCount;
+    }
+}
+/**
+ * Structural v1 shape used to detect a legacy stored binding: it carries
+ * `agentId` + `sessionId`, and `schemaVersion` is absent (or explicitly
+ * undefined). A v2/v3 entry fails this schema, so it is never misread as v1.
+ */
+const V1_BINDING_SCHEMA = z.object({
+    channelId: z.string(),
+    accountId: z.string(),
+    conversationId: z.string(),
+    threadId: z.string().optional(),
+    agentId: z.string(),
+    sessionId: z.string(),
+    createdAt: z.number(),
+    updatedAt: z.number(),
+    schemaVersion: z.undefined().optional(),
+}).loose();
+/** Whether a raw stored value is a v1 binding needing migration. */
+export function isV1Binding(value) {
+    return V1_BINDING_SCHEMA.safeParse(value).success;
+}
+// Reused record guard (zod/TS-safe).
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Whether a raw stored value is a v2 binding needing promotion to v3: a
+ * current binding carrying `route` + `sessionId` but NO `conversationType`
+ * (v2 never modeled group vs dm). A v3 entry always has `conversationType`,
+ * so it is never misread as v2.
+ */
+export function isV2Binding(value) {
+    if (!isRecord(value) || isV1Binding(value))
+        return false;
+    if (value.conversationType !== undefined)
+        return false;
+    if (typeof value.sessionId !== 'string')
+        return false;
+    if (!isRecord(value.route))
+        return false;
+    return typeof value.channelId === 'string' && typeof value.accountId === 'string'
+        && typeof value.conversationId === 'string';
+}
+/**
+ * Normalize any stored binding into the current v3 shape.
+ *
+ * - v1 -> migrate to v2 (`route: { model: agentId }`, drop `agentId`), then
+ *   chain into v3;
+ * - v2 -> promote to v3 with the documented legacy default
+ *   `conversationType: 'dm'` and no `senderId`.
+ *
+ * Already-v3 values are returned unchanged (same reference). Migration NEVER
+ * reinterprets `agentId` as the new identity, and never fabricates a
+ * conversation type for an entry that already carries one.
+ */
+export function migrateBinding(value) {
+    if (isV1Binding(value)) {
+        const v1 = value;
+        // v1 only knew an agent id, used as the model — carry that meaning forward.
+        const v2 = {
+            channelId: v1.channelId,
+            accountId: v1.accountId,
+            conversationId: v1.conversationId,
+            ...(typeof v1.threadId === 'string' ? { threadId: v1.threadId } : {}),
+            sessionId: v1.sessionId,
+            route: { model: v1.agentId },
+            createdAt: v1.createdAt,
+            updatedAt: v1.updatedAt,
+        };
+        return promoteV2ToV3(v2);
+    }
+    if (isV2Binding(value)) {
+        return promoteV2ToV3(value);
+    }
+    return value;
+}
+/** v2 -> v3: add the legacy-default dm conversation type. */
+function promoteV2ToV3(v2) {
+    const migrated = {
+        channelId: v2.channelId,
+        accountId: v2.accountId,
+        conversationId: v2.conversationId,
+        // Legacy default: v2 did not model dm vs group, so a promoted entry is a
+        // DM unless the caller later upgrades it. Documented in the plan.
+        conversationType: 'dm',
+        ...(typeof v2.threadId === 'string' ? { threadId: v2.threadId } : {}),
+        sessionId: v2.sessionId,
+        route: v2.route,
+        schemaVersion: SESSION_BINDING_SCHEMA_VERSION,
+        createdAt: v2.createdAt,
+        updatedAt: v2.updatedAt,
+    };
+    return migrated;
+}
+function migratedNotice(sessionId, from) {
+    const origin = from === 'v1' ? 'v1 (agentId) -> v2 (route.model) -> v3' : 'v2 -> v3 (dm default)';
+    // Overriding console is intentional: no logger is injected and the migration
+    // must be visible (doc H0.3: "log a migration notice").
+    // eslint-disable-next-line no-console
+    console.error("[channel-harness] binding for session '" + sessionId + "' migrated from " + origin);
+}
+export class MemoryBindingStore {
+    store = new Map();
+    /** sessionId -> bindable key index. */
+    bySession = new Map();
+    get(key) {
+        const raw = this.store.get(key);
+        if (!raw)
+            return Promise.resolve(undefined);
+        const migrated = migrateBinding(raw);
+        if (migrated !== raw) {
+            migratedNotice(migrated.sessionId, isV1Binding(raw) ? 'v1' : 'v2');
+            this.index(migrated);
+            this.store.set(key, migrated);
+        }
+        return Promise.resolve(migrated);
+    }
+    async put(binding) {
+        const key = bindingKey(binding);
+        const value = migrateBinding(binding);
+        // If this key previously held a DIFFERENT session's binding, drop that
+        // session's stale reverse mapping before re-pointing it.
+        const prev = this.store.get(key);
+        if (prev && prev.sessionId !== value.sessionId && this.bySession.get(prev.sessionId) === key) {
+            this.bySession.delete(prev.sessionId);
+        }
+        this.bySession.set(value.sessionId, key);
+        this.store.set(key, value);
+    }
+    async delete(key) {
+        const binding = this.store.get(key);
+        if (binding && this.bySession.get(binding.sessionId) === key) {
+            this.bySession.delete(binding.sessionId);
+        }
+        this.store.delete(key);
+    }
+    async findBySessionId(sessionId) {
+        const keys = new Set();
+        if (this.bySession.has(sessionId)) {
+            const k = this.bySession.get(sessionId);
+            if (this.store.has(k))
+                keys.add(k);
+        }
+        for (const [key, binding] of this.store) {
+            if (binding.sessionId === sessionId)
+                keys.add(key);
+        }
+        if (keys.size === 0)
+            return undefined;
+        if (keys.size > 1)
+            throw new AmbiguousBindingError(sessionId, keys.size);
+        const key = Array.from(keys)[0];
+        const raw = this.store.get(key);
+        const migrated = migrateBinding(raw);
+        if (migrated !== raw) {
+            migratedNotice(migrated.sessionId, isV1Binding(raw) ? 'v1' : 'v2');
+            this.bySession.set(migrated.sessionId, bindingKey(migrated));
+            this.store.set(key, migrated);
+        }
+        return migrated;
+    }
+    index(binding) {
+        this.bySession.set(binding.sessionId, bindingKey(binding));
+    }
+}
+/**
+ * Single-file JSON binding store. Loads once into memory; writes are
+ * serialized through a promise chain and land atomically (temp + rename).
+ * On load, any v1/v2 entries are migrated to v3 (in memory) and the migrated
+ * file is re-persisted immediately. A `sessionId -> key` index is built
+ * alongside the cache for `findBySessionId`.
+ */
+export class FileBindingStore {
+    filePath;
+    cache = new Map();
+    /** sessionId -> bindable key index. */
+    bySession = new Map();
+    loaded = false;
+    writeChain = Promise.resolve();
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    index(key, binding) {
+        this.cache.set(key, binding);
+        this.bySession.set(binding.sessionId, key);
+    }
+    async load() {
+        if (this.loaded)
+            return;
+        this.loaded = true;
+        let text;
+        try {
+            text = await readFile(this.filePath, 'utf8');
+        }
+        catch {
+            // No file yet — empty store.
+            return;
+        }
+        let migratedAny = false;
+        try {
+            const parsed = JSON.parse(text);
+            if (parsed && typeof parsed === 'object') {
+                for (const [key, value] of Object.entries(parsed)) {
+                    if (value && typeof value === 'object') {
+                        const migrated = migrateBinding(value);
+                        this.index(key, migrated);
+                        if (migrated !== value) {
+                            migratedAny = true;
+                            migratedNotice(migrated.sessionId, isV1Binding(value) ? 'v1' : 'v2');
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Corrupt file — start fresh; the single-file store has no better recovery.
+        }
+        // Persist the migrated file so a later load does not re-run migration.
+        if (migratedAny) {
+            await this.persist();
+        }
+    }
+    async get(key) {
+        await this.load();
+        const raw = this.cache.get(key);
+        if (!raw)
+            return undefined;
+        const migrated = migrateBinding(raw);
+        if (migrated !== raw) {
+            migratedNotice(migrated.sessionId, isV1Binding(raw) ? 'v1' : 'v2');
+            this.index(key, migrated);
+            await this.persist();
+        }
+        return migrated;
+    }
+    async put(binding) {
+        await this.load();
+        const key = bindingKey(binding);
+        const value = migrateBinding(binding);
+        const prev = this.cache.get(key);
+        if (prev && prev.sessionId !== value.sessionId && this.bySession.get(prev.sessionId) === key) {
+            this.bySession.delete(prev.sessionId);
+        }
+        this.index(key, value);
+        await this.persist();
+    }
+    async delete(key) {
+        await this.load();
+        const binding = this.cache.get(key);
+        if (binding && this.bySession.get(binding.sessionId) === key) {
+            this.bySession.delete(binding.sessionId);
+        }
+        if (this.cache.delete(key)) {
+            await this.persist();
+        }
+    }
+    async findBySessionId(sessionId) {
+        await this.load();
+        const keys = new Set();
+        if (this.bySession.has(sessionId)) {
+            const k = this.bySession.get(sessionId);
+            if (this.cache.has(k))
+                keys.add(k);
+        }
+        for (const [key, binding] of this.cache) {
+            if (binding.sessionId === sessionId)
+                keys.add(key);
+        }
+        if (keys.size === 0)
+            return undefined;
+        if (keys.size > 1)
+            throw new AmbiguousBindingError(sessionId, keys.size);
+        const key = Array.from(keys)[0];
+        const raw = this.cache.get(key);
+        const migrated = migrateBinding(raw);
+        if (migrated !== raw) {
+            migratedNotice(migrated.sessionId, isV1Binding(raw) ? 'v1' : 'v2');
+            this.index(key, migrated);
+            await this.persist();
+        }
+        return migrated;
+    }
+    persist() {
+        this.writeChain = this.writeChain.then(async () => {
+            await mkdir(dirname(this.filePath), { recursive: true });
+            const tmp = this.filePath + '.' + process.pid + '.' + Date.now() + '.tmp';
+            await writeFile(tmp, JSON.stringify(Object.fromEntries(this.cache), null, 2), 'utf8');
+            await rename(tmp, this.filePath);
+        });
+        return this.writeChain;
+    }
+}
+/** Build the store selected by configuration (file without a path falls back to the default). */
+export function createBindingStore(config) {
+    if (config.type === 'file') {
+        return new FileBindingStore(config.path ?? resolveDefaultBindingStorePath());
+    }
+    return new MemoryBindingStore();
+}
+//# sourceMappingURL=binding-store.js.map

package/lib/binding-store.js.map

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