@krischoichoi/channel-harness 0.6.0

package/lib/model-selection.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Thin channel adapter for Harness model selection.
+ *
+ * Harness owns the default model and the Web Host owns the session RPC. The
+ * channel only bridges `/model` to those official surfaces. In headless mode
+ * it uses the official Agent-scoped `ModelSelectionRef` required to affect the
+ * current Session. There is no per-Agent owner pin, host identity cache,
+ * first-turn prepare, or fallback state machine.
+ *
+ * Host transport: the official `ctx.sessionController`
+ * (`@deepseek-ai/dsh-api-session-controller`), which the Web profile mounts as
+ * the session business API. Selection goes through
+ * `sessionController.selectModel()`; the current-selection read is a
+ * best-effort local chain (a Web-side selection that is pending but not yet
+ * used by a request is not visible here — the official controller does not
+ * expose a host-side current-selection read).
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent, ModelSelection, ModelSelectionRef } from '@deepseek-ai/dsh-agent';
+import type { SessionController } from '@deepseek-ai/dsh-api-session-controller';
+export type ChannelModelSelectionRef = ModelSelectionRef;
+export type ChannelModelSelectionMode = 'host' | 'local';
+/**
+ * Narrow channel view over the official Host session business API — only the
+ * model surface this bridge consumes, derived from
+ * `@deepseek-ai/dsh-api-session-controller` instead of a local duplicate.
+ */
+export type ChannelHostSessionController = Pick<SessionController, 'selectModel'>;
+export declare class ChannelModelSelectionController {
+    private readonly rootCtx;
+    private readonly refs;
+    /**
+     * The owner strategy is fixed when the Agent scope is installed. The Host
+     * service itself is resolved live so HMR can replace its implementation
+     * without changing ownership of an existing Agent.
+     */
+    private readonly strategies;
+    constructor(rootCtx: Context);
+    get mode(): ChannelModelSelectionMode;
+    /** Install only the headless hook; Web Host owns it when sessionController is present. */
+    install(agentCtx: Context): () => void;
+    current(agent: Agent): Promise<ModelSelection | undefined>;
+    selectionForStep(agent: Agent): Promise<ModelSelection | undefined>;
+    select(agent: Agent, selection: ModelSelection): Promise<void>;
+    private hostSessionController;
+    /**
+     * Agents configured through the bridge always have a recorded strategy.
+     * Keep the deployment-wide mode as a compatibility fallback for direct
+     * controller callers that have not installed the Agent-scoped hook.
+     */
+    private strategyFor;
+    private readLocal;
+}
+//# sourceMappingURL=model-selection.d.ts.map

package/lib/model-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-selection.d.ts","sourceRoot":"","sources":["../src/model-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAIvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAEjF,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;AACzD,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzD;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,GAAG,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;AAElF,qBAAa,+BAA+B;IAS9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IARpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoD;IACzE;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqD;gBAEnD,OAAO,EAAE,OAAO;IAE7C,IAAI,IAAI,IAAI,yBAAyB,CAEpC;IAED,0FAA0F;IAC1F,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,IAAI;IAkBhC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAI1D,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAQnE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BpE,OAAO,CAAC,qBAAqB;IAI7B;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,SAAS;CAqBlB"}

package/lib/model-selection.js

@@ -0,0 +1,116 @@
+import { installModelSelection } from '@deepseek-ai/dsh-agent';
+import { ReasoningEffortId } from '@deepseek-ai/dsh-llm';
+export class ChannelModelSelectionController {
+    rootCtx;
+    refs = new WeakMap();
+    /**
+     * The owner strategy is fixed when the Agent scope is installed. The Host
+     * service itself is resolved live so HMR can replace its implementation
+     * without changing ownership of an existing Agent.
+     */
+    strategies = new WeakMap();
+    constructor(rootCtx) {
+        this.rootCtx = rootCtx;
+    }
+    get mode() {
+        return this.hostSessionController() ? 'host' : 'local';
+    }
+    /** Install only the headless hook; Web Host owns it when sessionController is present. */
+    install(agentCtx) {
+        const strategy = this.mode;
+        this.strategies.set(agentCtx, strategy);
+        if (strategy === 'host') {
+            return () => {
+                if (this.strategies.get(agentCtx) === strategy)
+                    this.strategies.delete(agentCtx);
+            };
+        }
+        const ref = { current: undefined, assembled: undefined };
+        const dispose = installModelSelection(agentCtx, ref);
+        this.refs.set(agentCtx, ref);
+        return () => {
+            dispose();
+            if (this.refs.get(agentCtx) === ref)
+                this.refs.delete(agentCtx);
+            if (this.strategies.get(agentCtx) === strategy)
+                this.strategies.delete(agentCtx);
+        };
+    }
+    async current(agent) {
+        return this.readLocal(agent);
+    }
+    async selectionForStep(agent) {
+        if (this.strategyFor(agent) === 'local') {
+            const ref = this.refs.get(agent.ctx);
+            if (ref?.assembled)
+                return ref.assembled;
+        }
+        return this.current(agent);
+    }
+    async select(agent, selection) {
+        if (this.strategyFor(agent) === 'host') {
+            const controller = this.hostSessionController();
+            if (!controller) {
+                throw new Error('host model selection is unavailable: sessionController is not mounted');
+            }
+            try {
+                await controller.selectModel({
+                    sessionId: agent.id,
+                    provider: selection.provider,
+                    model: selection.model,
+                    ...(selection.reasoningEffort ? { reasoningEffort: String(selection.reasoningEffort) } : {}),
+                });
+            }
+            catch (error) {
+                throw new Error(`model selection was rejected: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            return;
+        }
+        const ref = this.refs.get(agent.ctx);
+        if (!ref)
+            throw new Error(`model selection is not installed for session '${String(agent.id)}'`);
+        ref.current = selection;
+        try {
+            await this.rootCtx.get('agentDefaultModel')?.saveSelection(selection);
+        }
+        catch {
+            // The current-session switch already holds; default persistence is best effort.
+        }
+    }
+    hostSessionController() {
+        return this.rootCtx.get('sessionController');
+    }
+    /**
+     * Agents configured through the bridge always have a recorded strategy.
+     * Keep the deployment-wide mode as a compatibility fallback for direct
+     * controller callers that have not installed the Agent-scoped hook.
+     */
+    strategyFor(agent) {
+        return this.strategies.get(agent.ctx) ?? this.mode;
+    }
+    readLocal(agent) {
+        const picked = this.refs.get(agent.ctx)?.current;
+        if (picked)
+            return picked;
+        const headerConfig = agent.session.requestHeader?.()?.config;
+        if (headerConfig?.provider && headerConfig.model) {
+            return {
+                provider: headerConfig.provider,
+                model: headerConfig.model,
+                ...(headerConfig.reasoningEffort ? { reasoningEffort: ReasoningEffortId(String(headerConfig.reasoningEffort)) } : {}),
+            };
+        }
+        const { provider, model } = agent.options;
+        if (provider && model)
+            return { provider, model };
+        const defaults = agent.ctx.get('agentDefaultModel')?.currentSelection();
+        if (!defaults?.provider || !defaults.model)
+            return undefined;
+        return {
+            provider: defaults.provider,
+            model: defaults.model,
+            ...(defaults.reasoningEffort ? { reasoningEffort: defaults.reasoningEffort } : {}),
+        };
+    }
+}
+//# sourceMappingURL=model-selection.js.map

package/lib/model-selection.js.map

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

package/lib/outbox/binding-resolver.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Durable Binding Authority.
+ *
+ * Outbox authorization comes from the DURABLE `SessionBindingStore`, NEVER from
+ * the in-memory `AgentManager` cache. `AgentManager.bindingFor()` is only a
+ * hint used by the reply pipeline; a send MUST re-resolve through
+ * `findBySessionId` so it sees the current durable binding — including after a
+ * `/new`, at which point the retired session's durable binding is gone and the
+ * send must fail closed (from the binding update onward, session A's
+ * outbox has lost authority).
+ *
+ * `findBySessionId` fails closed with `AmbiguousBindingError`
+ * (OUTBOX_AMBIGUOUS_BINDING) when one session id maps to more than one current
+ * binding; here it is surfaced as the typed `OutboxError` with the same code.
+ */
+import { type SessionBindingStore } from '../binding-store.js';
+import type { SessionBinding } from '../session-router.js';
+/**
+ * Resolve the single current durable binding for a session.
+ * Never consults an in-memory cache.
+ */
+export declare function resolveBindingForSession(sessionId: string, bindingStore: SessionBindingStore): Promise<SessionBinding>;
+//# sourceMappingURL=binding-resolver.d.ts.map

package/lib/outbox/binding-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-resolver.d.ts","sourceRoot":"","sources":["../../src/outbox/binding-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAyB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,cAAc,CAAC,CAsBzB"}

package/lib/outbox/binding-resolver.js

@@ -0,0 +1,38 @@
+/**
+ * Durable Binding Authority.
+ *
+ * Outbox authorization comes from the DURABLE `SessionBindingStore`, NEVER from
+ * the in-memory `AgentManager` cache. `AgentManager.bindingFor()` is only a
+ * hint used by the reply pipeline; a send MUST re-resolve through
+ * `findBySessionId` so it sees the current durable binding — including after a
+ * `/new`, at which point the retired session's durable binding is gone and the
+ * send must fail closed (from the binding update onward, session A's
+ * outbox has lost authority).
+ *
+ * `findBySessionId` fails closed with `AmbiguousBindingError`
+ * (OUTBOX_AMBIGUOUS_BINDING) when one session id maps to more than one current
+ * binding; here it is surfaced as the typed `OutboxError` with the same code.
+ */
+import { AmbiguousBindingError } from '../binding-store.js';
+import { OutboxError } from './types.js';
+/**
+ * Resolve the single current durable binding for a session.
+ * Never consults an in-memory cache.
+ */
+export async function resolveBindingForSession(sessionId, bindingStore) {
+    let binding;
+    try {
+        binding = await bindingStore.findBySessionId(sessionId);
+    }
+    catch (error) {
+        if (error instanceof AmbiguousBindingError) {
+            throw new OutboxError('OUTBOX_AMBIGUOUS_BINDING', "session '" + sessionId + "' maps to more than one current channel binding; failing closed", { sessionId, cause: error });
+        }
+        throw error;
+    }
+    if (!binding) {
+        throw new OutboxError('OUTBOX_NO_BINDING', "no current channel binding for session '" + sessionId + "'", { sessionId });
+    }
+    return binding;
+}
+//# sourceMappingURL=binding-resolver.js.map

package/lib/outbox/binding-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-resolver.js","sourceRoot":"","sources":["../../src/outbox/binding-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,qBAAqB,EAA4B,MAAM,qBAAqB,CAAC;AAEtF,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,SAAiB,EACjB,YAAiC;IAEjC,IAAI,OAAmC,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;YAC3C,MAAM,IAAI,WAAW,CACnB,0BAA0B,EAC1B,WAAW,GAAG,SAAS,GAAG,iEAAiE,EAC3F,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAC5B,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,WAAW,CACnB,mBAAmB,EACnB,0CAA0C,GAAG,SAAS,GAAG,GAAG,EAC5D,EAAE,SAAS,EAAE,CACd,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/lib/outbox/capabilities.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Outbox capability resolution.
+ *
+ * Proactive (outbound, unsolicited) sends are a distinct capability from the
+ * transport flags in `ChannelAdapter.capabilities`. An adapter declares its
+ * proactive support via an optional `outboxCapabilities` getter/field (e.g.
+ * DingTalk will add it in M7C once its official proactive API is wired). When
+ * the adapter exposes none, capability DERIVES from the transport flags.
+ *
+ * Fail-closed rule (cannot pretend support): `proactiveText` is
+ * true for adapters exposing the field; otherwise the conservative default
+ * assumes text is available but media is only available when the adapter
+ * transports image, file, audio, or video. A capability of `false` means the
+ * outbox must refuse the send (fail closed), never fabricate support.
+ */
+/**
+ * Outbox (proactive-send) capability set.
+ *
+ * - `proactiveText` — the adapter can proactively send plain text to an
+ *   arbitrary target (not just a reply).
+ * - `proactiveMedia` — the adapter can proactively send an image, file,
+ *   audio, or video part to an arbitrary target.
+ */
+export interface OutboxCapabilities {
+    proactiveText: boolean;
+    proactiveMedia: boolean;
+}
+/**
+ * Optional adapter-declared outbox capabilities. Adapters that complete their
+ * proactive path attach this field; when absent the caller derives a default.
+ */
+export interface OutboxCapabilitySource {
+    readonly outboxCapabilities?: OutboxCapabilities;
+    readonly capabilities?: {
+        image?: boolean;
+        file?: boolean;
+        audio?: boolean;
+        video?: boolean;
+    };
+}
+/**
+ * Resolve an adapter's proactive outbox capabilities. Uses an
+ * explicitly declared `outboxCapabilities` when present; otherwise derives
+ * `proactiveText = true` and `proactiveMedia` from the transport
+ * image/file/audio/video flags. Capability `false` always means fail closed.
+ */
+export declare function resolveOutboxCapabilities(adapter: OutboxCapabilitySource): OutboxCapabilities;
+//# sourceMappingURL=capabilities.d.ts.map

package/lib/outbox/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/outbox/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE;QACtB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;CACH;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,sBAAsB,GAAG,kBAAkB,CAY7F"}

package/lib/outbox/capabilities.js

@@ -0,0 +1,35 @@
+/**
+ * Outbox capability resolution.
+ *
+ * Proactive (outbound, unsolicited) sends are a distinct capability from the
+ * transport flags in `ChannelAdapter.capabilities`. An adapter declares its
+ * proactive support via an optional `outboxCapabilities` getter/field (e.g.
+ * DingTalk will add it in M7C once its official proactive API is wired). When
+ * the adapter exposes none, capability DERIVES from the transport flags.
+ *
+ * Fail-closed rule (cannot pretend support): `proactiveText` is
+ * true for adapters exposing the field; otherwise the conservative default
+ * assumes text is available but media is only available when the adapter
+ * transports image, file, audio, or video. A capability of `false` means the
+ * outbox must refuse the send (fail closed), never fabricate support.
+ */
+/**
+ * Resolve an adapter's proactive outbox capabilities. Uses an
+ * explicitly declared `outboxCapabilities` when present; otherwise derives
+ * `proactiveText = true` and `proactiveMedia` from the transport
+ * image/file/audio/video flags. Capability `false` always means fail closed.
+ */
+export function resolveOutboxCapabilities(adapter) {
+    if (adapter.outboxCapabilities) {
+        return {
+            proactiveText: adapter.outboxCapabilities.proactiveText,
+            proactiveMedia: adapter.outboxCapabilities.proactiveMedia,
+        };
+    }
+    const caps = adapter.capabilities;
+    return {
+        proactiveText: true,
+        proactiveMedia: Boolean(caps?.image || caps?.file || caps?.audio || caps?.video),
+    };
+}
+//# sourceMappingURL=capabilities.js.map

package/lib/outbox/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/outbox/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA6BH;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAA+B;IACvE,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAC/B,OAAO;YACL,aAAa,EAAE,OAAO,CAAC,kBAAkB,CAAC,aAAa;YACvD,cAAc,EAAE,OAAO,CAAC,kBAAkB,CAAC,cAAc;SAC1D,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC;IAClC,OAAO;QACL,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,CAAC;KACjF,CAAC;AACJ,CAAC"}

package/lib/outbox/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Durable Channel Outbox.
+ *
+ * Public surface of the outbox module: the request + error types, the durable
+ * binding/target/attachment resolvers, the proactive capability resolver, the
+ * `ChannelOutboxService`, and the `send_channel_message` tool registration.
+ */
+export * from './types.js';
+export * from './target.js';
+export * from './binding-resolver.js';
+export * from './capabilities.js';
+export * from './service.js';
+export * from './tool-send.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/outbox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/outbox/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/lib/outbox/index.js

@@ -0,0 +1,14 @@
+/**
+ * Durable Channel Outbox.
+ *
+ * Public surface of the outbox module: the request + error types, the durable
+ * binding/target/attachment resolvers, the proactive capability resolver, the
+ * `ChannelOutboxService`, and the `send_channel_message` tool registration.
+ */
+export * from './types.js';
+export * from './target.js';
+export * from './binding-resolver.js';
+export * from './capabilities.js';
+export * from './service.js';
+export * from './tool-send.js';
+//# sourceMappingURL=index.js.map

package/lib/outbox/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/outbox/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/lib/outbox/service.d.ts

@@ -0,0 +1,48 @@
+/**
+ * ChannelOutboxService — the durable outbox.
+ *
+ * One `send` call walks the full outbound path:
+ *
+ * ```
+ * sessionId
+ *   → resolveBindingForSession (durable authority)
+ *   → targetFromBinding
+ *   → build OutboundMessage (text / attachment bytes)
+ *   → proactive capability gate (fail closed)
+ *   → adapter.send(target, message)
+ * ```
+ *
+ * The binding authority is the DURABLE store — never an in-memory agent cache.
+ * Send errors are NEVER swallowed: they propagate to the tool caller after a
+ * diagnostic log.
+ */
+import type { ChannelAdapter, ChannelLogger, SendResult } from '@krischoichoi/channel-core';
+import type { SessionBindingStore } from '../binding-store.js';
+import type { ResolvedChannelAttachment } from '../file-provider.js';
+import type { ChannelOutboundRequest } from './types.js';
+export interface ChannelOutboxServiceOptions {
+    bindingStore: SessionBindingStore;
+    getAdapter(channelId: string): ChannelAdapter | undefined;
+    /** Optional extension resolver; attachment sends are disabled without it. */
+    attachmentResolver?: ChannelAttachmentResolver;
+    logger: ChannelLogger;
+}
+export interface ChannelOutboxSendOptions {
+    signal?: AbortSignal;
+}
+export type ChannelAttachmentResolver = (attachmentId: string, sessionId: string) => Promise<ResolvedChannelAttachment>;
+export declare class ChannelOutboxService {
+    private readonly bindingStore;
+    private readonly getAdapter;
+    private readonly attachmentResolver;
+    private readonly logger;
+    constructor(options: ChannelOutboxServiceOptions);
+    /**
+     * Send a proactive channel message on behalf of `sessionId`. Resolves the
+     * durable binding, builds the outbound message, gates on proactive
+     * capability (fail closed), and delivers through the adapter. Returns the
+     * adapter's `SendResult`.
+     */
+    send(sessionId: string, request: ChannelOutboundRequest, options?: ChannelOutboxSendOptions): Promise<SendResult>;
+}
+//# sourceMappingURL=service.d.ts.map

package/lib/outbox/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/outbox/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAIb,UAAU,EACX,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAMzD,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,mBAAmB,CAAC;IAClC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAC1D,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;IAC/C,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,yBAAyB,CAAC,CAAC;AAExC,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoD;IAC/E,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAwC;IAC3E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,OAAO,EAAE,2BAA2B;IAOhD;;;;;OAKG;IACG,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,sBAAsB,EAC/B,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,UAAU,CAAC;CA4EvB"}

package/lib/outbox/service.js

@@ -0,0 +1,74 @@
+import { resolveBindingForSession } from './binding-resolver.js';
+import { targetFromBinding } from './target.js';
+import { resolveOutboxCapabilities } from './capabilities.js';
+import { OutboxError } from './types.js';
+export class ChannelOutboxService {
+    bindingStore;
+    getAdapter;
+    attachmentResolver;
+    logger;
+    constructor(options) {
+        this.bindingStore = options.bindingStore;
+        this.getAdapter = options.getAdapter;
+        this.attachmentResolver = options.attachmentResolver;
+        this.logger = options.logger;
+    }
+    /**
+     * Send a proactive channel message on behalf of `sessionId`. Resolves the
+     * durable binding, builds the outbound message, gates on proactive
+     * capability (fail closed), and delivers through the adapter. Returns the
+     * adapter's `SendResult`.
+     */
+    async send(sessionId, request, options = {}) {
+        const signal = options.signal;
+        if (signal?.aborted) {
+            const err = new Error('channel outbox send aborted for session ' + sessionId);
+            err.name = 'AbortError';
+            throw err;
+        }
+        const binding = await resolveBindingForSession(sessionId, this.bindingStore);
+        const target = targetFromBinding(binding);
+        const adapter = this.getAdapter(binding.channelId);
+        if (!adapter) {
+            throw new OutboxError('OUTBOX_CAPABILITY_UNAVAILABLE', "no channel adapter for channel '" + binding.channelId + "'", { sessionId });
+        }
+        const caps = resolveOutboxCapabilities(adapter);
+        const hasText = !!request.text;
+        const hasAttachment = !!request.attachmentId;
+        if (!hasText && !hasAttachment) {
+            throw new OutboxError('OUTBOX_CAPABILITY_UNAVAILABLE', 'a channel outbound send requires text and/or an attachment', { sessionId });
+        }
+        if (hasText && !caps.proactiveText) {
+            throw new OutboxError('OUTBOX_CAPABILITY_UNAVAILABLE', "channel '" + binding.channelId + "' cannot proactively send text (proactiveText=false)", { sessionId });
+        }
+        if (hasAttachment && !caps.proactiveMedia) {
+            throw new OutboxError('OUTBOX_CAPABILITY_UNAVAILABLE', "channel '" + binding.channelId + "' cannot proactively send media (proactiveMedia=false)", { sessionId });
+        }
+        const message = { text: request.text };
+        if (hasAttachment) {
+            if (!this.attachmentResolver) {
+                throw new OutboxError('OUTBOX_CAPABILITY_UNAVAILABLE', 'outbound attachments require a private asset store that is not configured', { sessionId });
+            }
+            const asset = await this.attachmentResolver(request.attachmentId, sessionId);
+            if (!adapter.capabilities[asset.kind]) {
+                throw new OutboxError('OUTBOX_CAPABILITY_UNAVAILABLE', "channel '" + binding.channelId + "' cannot send " + asset.kind
+                    + ' attachments (' + asset.kind + '=false)', { sessionId });
+            }
+            message.parts = [resolvedAttachmentPart(asset)];
+        }
+        this.logger.info("[channel-harness] outbox send session='" + sessionId + "' channel='" + binding.channelId
+            + "' text=" + hasText + ' attachment=' + hasAttachment);
+        const result = await adapter.send(target, message);
+        this.logger.debug("[channel-harness] outbox sent session='" + sessionId + "' delivered=" + result.delivered);
+        return result;
+    }
+}
+function resolvedAttachmentPart(asset) {
+    return {
+        type: asset.kind,
+        localData: asset.data,
+        name: asset.name,
+        ...(asset.mimeType ? { mimeType: asset.mimeType } : {}),
+    };
+}
+//# sourceMappingURL=service.js.map

package/lib/outbox/service.js.map

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

package/lib/outbox/target.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Durable outbox target derivation.
+ *
+ * `targetFromBinding` maps a durable `SessionBinding`'s stable identity onto
+ * the `ChannelTarget` the adapter sends to. The binding is the durable
+ * authority, so the target comes from the STORE-resolved binding,
+ * never from an in-memory agent cache and never from the incoming message.
+ */
+import type { ChannelTarget } from '@krischoichoi/channel-core';
+import type { SessionBinding } from '../session-router.js';
+/**
+ * Derive the outbound `ChannelTarget` for a durable binding.
+ * Spreads `threadId` only when present; `conversationType` is always carried
+ * because the binding requires it (v3).
+ */
+export declare function targetFromBinding(binding: SessionBinding): ChannelTarget;
+//# sourceMappingURL=target.d.ts.map

package/lib/outbox/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/outbox/target.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAQxE"}

package/lib/outbox/target.js

@@ -0,0 +1,15 @@
+/**
+ * Derive the outbound `ChannelTarget` for a durable binding.
+ * Spreads `threadId` only when present; `conversationType` is always carried
+ * because the binding requires it (v3).
+ */
+export function targetFromBinding(binding) {
+    return {
+        channelId: binding.channelId,
+        accountId: binding.accountId,
+        conversationId: binding.conversationId,
+        conversationType: binding.conversationType,
+        ...(binding.threadId ? { threadId: binding.threadId } : {}),
+    };
+}
+//# sourceMappingURL=target.js.map

package/lib/outbox/target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.js","sourceRoot":"","sources":["../../src/outbox/target.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAuB;IACvD,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAuC;QAC1D,SAAS,EAAE,OAAO,CAAC,SAAuC;QAC1D,cAAc,EAAE,OAAO,CAAC,cAAiD;QACzE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAqC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzF,CAAC;AACJ,CAAC"}

package/lib/outbox/tool-send.d.ts

@@ -0,0 +1,19 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { ChannelOutboxService } from './service.js';
+export interface RegisterSendChannelMessageToolOptions {
+    /** The durable outbox service backing the tool. */
+    outbox: ChannelOutboxService;
+}
+/** Rendered confirmation of a successful send. */
+export interface SendChannelMessageResult {
+    delivered: boolean;
+    messageId?: string;
+}
+/**
+ * The tool definition, ready to register on an Agent scope. Parameters are
+ * type-level guaranteed to be only `{ text?, attachment_id? }`.
+ */
+export declare function registerSendChannelMessageTool(options: RegisterSendChannelMessageToolOptions): import("@deepseek-ai/dsh-tools").ToolDefinition;
+/** Install the tool on an Agent scoped context (Agent-scoped registration). */
+export declare function installSendChannelMessageTool(agentCtx: Context, options: RegisterSendChannelMessageToolOptions): Promise<void>;
+//# sourceMappingURL=tool-send.d.ts.map

package/lib/outbox/tool-send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-send.d.ts","sourceRoot":"","sources":["../../src/outbox/tool-send.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,WAAW,qCAAqC;IACpD,mDAAmD;IACnD,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,qCAAqC,mDA2D/C;AAED,+EAA+E;AAC/E,wBAAsB,6BAA6B,CACjD,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,qCAAqC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAKf"}