@krischoichoi/channel-harness 0.6.0

package/lib/agent-manager.js

@@ -0,0 +1,603 @@
+/**
+ * AgentManager — the single place that touches `ctx.agents`.
+ *
+ * Ownership model (doc H0.4/H0.7):
+ * - `ctx.agents.get()` returns a live agent the bridge does NOT own — it is
+ *   never disposed here.
+ * - `ctx.agents.create()` / `ctx.agents.resume()` return an `AgentHandle`;
+ *   the bridge MUST hold every handle it created/resumed and dispose it on
+ *   plugin unload. Owned handles live in `owned` and are disposed exactly
+ *   once by `disposeAll()`.
+ *
+ * Routing is expressed as an `AgentRouteSpec`, never an `agentId` (the
+ * Harness Agent identity is the `SessionId`). `create` and `resume` receive
+ * the SAME route so provider/model/maxTokens stay identical on both paths
+ * (doc H0.5 route parity).
+ *
+ * Create-vs-resume is decided by the CALLER (the bridge), not by error-regex
+ * fallback. Persistence is an OPTIONAL capability resolved LIVE at the use
+ * site: `canResume()` tells the caller whether a sessionPersistence service
+ * is currently mounted, `exists()` probes membership via the live service,
+ * and `probePersisted()` answers the atomic unavailable/present/missing
+ * question in one resolver call (no canResume/exists TOCTOU across a
+ * persistence HMR) — corruption / unsupported-format / backend failures
+ * propagate loudly rather than being misread as "no persistence".
+ *
+ * Global concurrency gate: at most `maxConcurrency` `create()`/`resume()` calls
+ * are in flight at once across all sessions; `get()` (a live lookup) is never
+ * limited.
+ */
+import { SessionId } from '@deepseek-ai/dsh-session';
+import { agentPresetProjectionDefinition, } from '@deepseek-ai/dsh-agent-preset-registry';
+/** Persistence was configured for the binding, but is unavailable right now. */
+export class PersistenceUnavailableError extends Error {
+    sessionId;
+    bindingKey;
+    constructor(sessionId, bindingKey) {
+        super(`persistence is temporarily unavailable for session '${sessionId}'` +
+            (bindingKey ? ` (binding '${bindingKey}')` : '') +
+            '; refusing to recreate a durable channel session');
+        this.sessionId = sessionId;
+        this.bindingKey = bindingKey;
+        this.name = 'PersistenceUnavailableError';
+    }
+}
+/**
+ * A durable binding references a persisted session that no longer exists
+ * (session-not-found, aligned with the official Host's
+ * "persisted identity missing -> session-not-found"). With a
+ * sessionPersistence service mounted, a missing persisted session behind an
+ * existing binding is a binding/session durability inconsistency — NEVER a
+ * first create — so resolution fails loudly instead of silently
+ * blank-recreating the same session id. Deployments WITHOUT persistence
+ * explicitly ephemeral bindings never throw this: they recreate on the recorded id.
+ */
+export class SessionNotFoundError extends Error {
+    sessionId;
+    bindingKey;
+    constructor(sessionId, bindingKey) {
+        super(`session '${sessionId}' not found in persistence: the binding` +
+            (bindingKey ? ` '${bindingKey}'` : '') +
+            ` references a durable session that no longer exists (binding/session ` +
+            `durability inconsistency); refusing to silently recreate it. Restore ` +
+            `the session or clear/repair the binding.`);
+        this.sessionId = sessionId;
+        this.bindingKey = bindingKey;
+        this.name = 'SessionNotFoundError';
+    }
+}
+/** Filter out undefined optional agentOptions fields (route parity helper). */
+export function optionsFor(route) {
+    const options = {};
+    if (route.provider)
+        options.provider = route.provider;
+    if (route.model)
+        options.model = route.model;
+    if (route.maxTokens !== undefined)
+        options.maxTokens = route.maxTokens;
+    return Object.keys(options).length > 0 ? options : undefined;
+}
+/**
+ * Resolve a route's provider/model, falling back to Harness's default model
+ * selection when the route leaves the model unset.
+ *
+ * `{{model}}` (the persona variable that fails with "prompt variable has no
+ * value") depends only on `model`, so a route that already pins a model —
+ * with or without a provider — is left untouched. Only a missing model is
+ * filled from the default (and the default's provider rides along when the
+ * route also left provider unset).
+ *
+ * The default model is read live (per agent creation), so new channel sessions
+ * follow the user's Harness-wide default while sessions pinned to an explicit
+ * route keep their own provider/model.
+ */
+export function resolveRoute(route, defaultSelection) {
+    if (route.model)
+        return route;
+    if (!defaultSelection?.model)
+        return route;
+    return {
+        ...route,
+        model: defaultSelection.model,
+        provider: route.provider ?? defaultSelection.provider,
+    };
+}
+/**
+ * Probe a persisted session's existence through the persistence service's
+ * `list()` membership. A session that is absent returns `false`; any backend
+ * failure (corruption, unsupported format, connectivity) propagates loudly.
+ *
+ * The persistence service is resolved LIVE on every call (a resolver, not a
+ * startup snapshot): a sessionPersistence mounted/unmounted/replaced after
+ * the bridge started is observed on the next probe — reversible Cordis
+ * lifecycle parity, since `ctx.get` only returns currently active providers.
+ */
+export class PersistenceMembershipProbe {
+    resolvePersistence;
+    constructor(resolvePersistence) {
+        this.resolvePersistence = resolvePersistence;
+    }
+    async exists(sessionId) {
+        const persistence = this.resolvePersistence();
+        if (!persistence)
+            return false;
+        const headers = await persistence.list();
+        const target = sessionId;
+        return headers.some((header) => persistedSessionId(header) === target);
+    }
+    /** Atomic probe: the live capability is resolved exactly once per call. */
+    async probe(sessionId) {
+        const persistence = this.resolvePersistence();
+        if (!persistence)
+            return 'unavailable';
+        const headers = await persistence.list();
+        return headers.some((header) => persistedSessionId(header) === sessionId) ? 'present' : 'missing';
+    }
+}
+/**
+ * Session V3 persistence `list()` always returns snapshots. Identity lives in
+ * the snapshot header; the bridge intentionally does not retain the removed
+ * pre-V3 bare-header compatibility path.
+ */
+function persistedSessionId(entry) {
+    return String(entry.header.id);
+}
+/**
+ * Read one durable V3 session through the public read handle. A channel bridge
+ * never depends on an implementation-specific persistence reader.
+ */
+export async function resolvePersistedInspection(persistence, sessionId) {
+    const handle = await persistence.open(sessionId, 'read');
+    try {
+        return {
+            meta: handle.header,
+            events: (await handle.read()).events,
+        };
+    }
+    finally {
+        await handle.close();
+    }
+}
+/**
+ * Reconstruct the preset a persisted session actually runs, from its durable
+ * inspection: the creation header's `agentPreset` advanced by every
+ * `agent-preset/selected` event via the official
+ * `agentPresetProjectionDefinition` fold.
+ */
+function resolvePersistedPreset(header, events) {
+    let state = agentPresetProjectionDefinition.init(header);
+    for (const event of events) {
+        state = agentPresetProjectionDefinition.apply(state, event);
+    }
+    return state ?? undefined;
+}
+/**
+ * Real gateway over `ctx.agents`. This is the only Harness import surface in
+ * the bridge (besides the `session/event` feed consumed by ReplyRouter).
+ *
+ * Persistence is an OPTIONAL capability resolved LIVE at the use site: the
+ * caller passes a resolver (`() => ctx.get('sessionPersistence')`), so
+ * `canResume()` and the existence probe reflect the service's CURRENT
+ * presence — mounting, unmounting, or replacing the service after the bridge
+ * started is observed on the next probe (never a startup snapshot).
+ */
+export class HarnessAgentGateway {
+    ctx;
+    probe;
+    resolvePersistence;
+    /**
+     * All persisted session ids (shape-tolerant, issue #8) — the `/bind`
+     * resolution universe. Empty when no persistence is mounted.
+     */
+    async listPersistedSessionIds() {
+        const persistence = this.resolvePersistence();
+        if (!persistence)
+            return [];
+        const rows = await persistence.list();
+        return rows.map((row) => persistedSessionId(row));
+    }
+    /**
+     * The persisted Agent preset of one session (issue #6 route parity): the
+     * official `agentPresetProjectionDefinition` fold over the durable
+     * inspection. Undefined when no persistence / no recorded preset.
+     */
+    async persistedPresetOf(sessionId) {
+        const persistence = this.resolvePersistence();
+        if (!persistence)
+            return undefined;
+        const inspection = await resolvePersistedInspection(persistence, SessionId(sessionId));
+        return inspection ? resolvePersistedPreset(inspection.meta, inspection.events) : undefined;
+    }
+    constructor(ctx, resolvePersistence) {
+        this.ctx = ctx;
+        this.resolvePersistence = resolvePersistence ?? (() => undefined);
+        this.probe = new PersistenceMembershipProbe(this.resolvePersistence);
+    }
+    get(sessionId) {
+        const agent = this.ctx.agents.get(SessionId(sessionId));
+        if (!agent)
+            return undefined;
+        return {
+            id: agent.id,
+            agent,
+            followup: (message) => agent.followup(message),
+            whenIdle: () => agent.whenIdle(),
+        };
+    }
+    canResume() {
+        // Only a currently mounted sessionPersistence service enables resume.
+        return this.resolvePersistence() !== undefined;
+    }
+    async exists(sessionId) {
+        return this.probe.exists(sessionId);
+    }
+    async probePersisted(sessionId) {
+        return this.probe.probe(sessionId);
+    }
+    /** Read Harness's live default-model selection (undefined when absent). */
+    defaultSelection() {
+        const service = this.ctx.get('agentDefaultModel');
+        return service?.currentSelection();
+    }
+    /**
+     * Resolve and mount the official Agent preset before publication, matching
+     * the Harness Host's create/resume composition boundary. Without this join,
+     * preset-scoped tools such as `ask_user_question` are invisible to the Agent.
+     */
+    async composePreset(presetId, setup) {
+        const presets = this.ctx.get('agentPresets');
+        // Test/minimal hosts without the optional roster retain the historical
+        // metadata behavior; the official runtime always provides this service.
+        if (!presets)
+            return { agentPreset: presetId, setup };
+        const resolvedId = (await presets.resolve(presetId)).id;
+        return {
+            agentPreset: resolvedId,
+            setup: async (agentCtx, agent) => {
+                await presets.mount(agentCtx, resolvedId);
+                return setup?.(agentCtx, agent);
+            },
+        };
+    }
+    async create(sessionId, route, setup, meta) {
+        const resolved = resolveRoute(route, this.defaultSelection());
+        const composition = await this.composePreset(resolved.preset, setup);
+        const handle = await this.ctx.agents.create({
+            sessionId: SessionId(sessionId),
+            // `{{cwd}}` reads `session.header.cwd`, and `dsh-workspace` groups the
+            // session under the workspace whose path matches that cwd. The cwd is
+            // decided by the CALLER (the bridge) and passed through `meta.cwd` —
+            // `HarnessAgentGateway` only creates the session with the given cwd and
+            // never falls back to `process.cwd()`. This must be set at creation —
+            // `resume` has no `meta` and cannot add it later.
+            meta: {
+                ...(meta?.cwd ? { cwd: meta.cwd } : {}),
+                ...(composition.agentPreset ? { agentPreset: composition.agentPreset } : {}),
+            },
+            agentOptions: optionsFor(resolved),
+            setup: composition.setup,
+        });
+        return this.wrap(handle);
+    }
+    async resume(sessionId, route, setup) {
+        // Route parity (doc H0.5): resume uses the SAME optionsFor(resolveRoute(...))
+        // as create. NEVER `model ?? agentId`.
+        const resolved = resolveRoute(route, this.defaultSelection());
+        const persistence = this.resolvePersistence();
+        const inspected = persistence
+            ? await resolvePersistedInspection(persistence, SessionId(sessionId))
+            : undefined;
+        const persistedPreset = inspected
+            ? resolvePersistedPreset(inspected.meta, inspected.events)
+            : undefined;
+        if (persistedPreset && resolved.preset && persistedPreset !== resolved.preset) {
+            throw new AgentPresetConflictError(sessionId, resolved.preset, persistedPreset);
+        }
+        // Persisted composition wins. Sessions created before Agent presets were
+        // recorded have no value, so they intentionally adopt the current default.
+        const composition = await this.composePreset(persistedPreset ?? resolved.preset, setup);
+        const handle = await this.ctx.agents.resume({
+            resumeSessionId: SessionId(sessionId),
+            agentOptions: optionsFor(resolved),
+            setup: composition.setup,
+        });
+        return this.wrap(handle);
+    }
+    wrap(handle) {
+        return {
+            id: handle.agent.id,
+            agent: handle.agent,
+            followup: (message) => handle.agent.followup(message),
+            whenIdle: () => handle.agent.whenIdle(),
+            dispose: () => handle.dispose(),
+        };
+    }
+}
+export class AgentManager {
+    gateway;
+    logger;
+    inFlight = new Map();
+    /** Handles this manager created/resumed — the ones it must dispose. */
+    owned = new Map();
+    /** Resolved refs, kept for drain (`whenIdle`) lookups. */
+    refs = new Map();
+    /** Agents that already received the one-time channel-command setup. */
+    configuredAgents = new WeakSet();
+    /** sessionId -> binding, the reverse lookup used by the ReplyRouter. */
+    bindings = new Map();
+    maxConcurrency;
+    active = 0;
+    /** Waiters queued for a free concurrency slot. */
+    waiters = [];
+    closed = false;
+    constructor(gateway, logger, maxConcurrency = 4) {
+        this.gateway = gateway;
+        this.logger = logger;
+        this.maxConcurrency = Math.max(1, maxConcurrency);
+    }
+    /** Whether a sessionPersistence service enables `resume`. */
+    canResume() {
+        return this.gateway.canResume();
+    }
+    /** Probe whether a persisted session exists. Backend failures propagate. */
+    exists(sessionId) {
+        return this.gateway.exists(sessionId);
+    }
+    /**
+     * Atomic persistence probe: resolves the LIVE capability once and answers
+     * `unavailable` / `present` / `missing` — the bridge's single decision
+     * point for recreate-vs-resume-vs-fail, immune to a persistence HMR between
+     * `canResume()` and `exists()`.
+     */
+    async probePersisted(sessionId) {
+        if (this.gateway.probePersisted)
+            return this.gateway.probePersisted(sessionId);
+        // Fallback for minimal test gateways without the atomic probe: two live
+        // lookups (deterministic in tests).
+        if (!this.gateway.canResume())
+            return 'unavailable';
+        return (await this.gateway.exists(sessionId)) ? 'present' : 'missing';
+    }
+    /**
+     * Create a NEW agent for a session (no prior binding). Calls
+     * `gateway.create` directly (under the concurrency slot), owns the handle,
+     * and returns the ref. Never resumes — the caller already decided this is a
+     * fresh conversation. Single-flight per session id.
+     */
+    create(sessionId, route, setup, meta) {
+        if (this.closed) {
+            return Promise.reject(new Error(`AgentManager is closed; cannot create '${sessionId}'`));
+        }
+        const pending = this.inFlight.get(sessionId);
+        if (pending)
+            return pending;
+        const run = this.doCreate(sessionId, route, setup, meta);
+        this.inFlight.set(sessionId, run);
+        void run.then(() => {
+            this.inFlight.delete(sessionId);
+        }, () => {
+            this.inFlight.delete(sessionId);
+        });
+        return run;
+    }
+    /**
+     * Resolve an agent for an EXISTING, persisted session: live `get` first; on
+     * a miss, `gateway.resume(route)`. A resume failure propagates loudly
+     * (throws) — never falls back to create and never sniffs error messages.
+     * Single-flight per session id.
+     */
+    resolve(sessionId, route, setup) {
+        if (this.closed) {
+            return Promise.reject(new Error(`AgentManager is closed; cannot resolve '${sessionId}'`));
+        }
+        const pending = this.inFlight.get(sessionId);
+        if (pending)
+            return pending;
+        const run = this.doResolve(sessionId, route, setup);
+        this.inFlight.set(sessionId, run);
+        void run.then(() => {
+            this.inFlight.delete(sessionId);
+        }, () => {
+            this.inFlight.delete(sessionId);
+        });
+        return run;
+    }
+    /**
+     * Borrow the LIVE agent for a session, when one is loaded in this process.
+     * Returns `undefined` when there is no live agent — the caller (the Session
+     * factory, for channel-session lifecycle decisions) decides what to do next
+     * (resume, or a cwd/workspace-aware recreate). Never creates or resumes and
+     * never takes ownership (the borrowed agent is never disposed here). Runs
+     * the one-time setup against a borrowed agent, exactly once.
+     */
+    borrowIfLive(sessionId, route, setup) {
+        if (this.closed) {
+            return Promise.reject(new Error(`AgentManager is closed; cannot borrow '${sessionId}'`));
+        }
+        return this.doBorrowIfLive(sessionId, route, setup);
+    }
+    /** Register the binding associated with a session (reverse reply routing). */
+    registerBinding(binding) {
+        this.bindings.set(binding.sessionId, binding);
+    }
+    /** Reverse lookup for the ReplyRouter. */
+    bindingFor(sessionId) {
+        return this.bindings.get(sessionId);
+    }
+    /**
+     * Live agent lookup for the /stop fast path (spec §8). Returns the raw
+     * Agent when it is currently live in this process — NEVER creates or
+     * resumes a session just to answer this probe.
+     */
+    getLiveAgent(sessionId) {
+        return this.gateway.get(sessionId)?.agent;
+    }
+    /** Resolved ref for drain purposes, if any. */
+    refFor(sessionId) {
+        return this.refs.get(sessionId);
+    }
+    /** Session ids that currently have an active turn (for drain). */
+    activeSessions() {
+        return [...this.bindings.keys()];
+    }
+    /**
+     * Dispose every owned handle exactly once and clear all tracking. Agents
+     * obtained via `gateway.get()` (not owned) are never disposed.
+     */
+    async disposeAll() {
+        this.closed = true;
+        const waiters = this.waiters.splice(0);
+        for (const wake of waiters)
+            wake();
+        const handles = [...this.owned.values()];
+        this.owned.clear();
+        this.refs.clear();
+        this.bindings.clear();
+        const results = await Promise.allSettled(handles.map((handle) => handle.dispose()));
+        for (const result of results) {
+            if (result.status === 'rejected') {
+                this.logger.error(`failed to dispose an owned agent handle`, result.reason);
+            }
+        }
+    }
+    /**
+     * Dispose a single owned handle (used to roll back a create whose binding
+     * write failed afterward). No-op for handles the manager does not own.
+     */
+    async disposeSession(sessionId) {
+        const handle = this.owned.get(sessionId);
+        if (!handle)
+            return;
+        this.owned.delete(sessionId);
+        this.refs.delete(sessionId);
+        this.bindings.delete(sessionId);
+        try {
+            await handle.dispose();
+        }
+        catch (error) {
+            this.logger.error(`failed to dispose owned agent handle for '${sessionId}'`, error);
+        }
+    }
+    /**
+     * Retire a session's reference and reverse binding and dispose it ONLY if the
+     * manager owns the handle. Borrowed / unknown agents are released
+     * from local tracking but NEVER disposed. Retiring never touches persisted
+     * history — the old session keeps its durable log.
+     */
+    async retireSession(sessionId) {
+        this.refs.delete(sessionId);
+        this.bindings.delete(sessionId);
+        const handle = this.owned.get(sessionId);
+        if (!handle)
+            return;
+        this.owned.delete(sessionId);
+        try {
+            await handle.dispose();
+        }
+        catch (error) {
+            this.logger.error(`failed to dispose owned agent handle for '${sessionId}'`, error);
+        }
+    }
+    /**
+     * One-time channel-command setup for a BORROWED live agent. A
+     * borrowed agent never went through create/resume, so its setup could not
+     * have run at publication; run it here exactly once against the agent's
+     * scoped context. Setup failure propagates to the caller. The borrowed
+     * agent is never disposed here.
+     */
+    async ensureBorrowedSetup(agent, setup) {
+        if (!setup)
+            return;
+        if (this.configuredAgents.has(agent.agent))
+            return;
+        const commit = await setup(agent.agent.ctx, agent.agent);
+        commit?.commit();
+        this.configuredAgents.add(agent.agent);
+    }
+    async doCreate(sessionId, route, setup, meta) {
+        return this.withSlot(async () => {
+            const handle = await this.gateway.create(sessionId, route, setup, meta);
+            this.owned.set(sessionId, handle);
+            if (setup)
+                this.configuredAgents.add(handle.agent);
+            return this.makeRef(sessionId, route, handle);
+        });
+    }
+    async doResolve(sessionId, route, setup) {
+        const live = this.gateway.get(sessionId);
+        if (live) {
+            await this.ensureBorrowedSetup(live, setup);
+            return this.makeRef(sessionId, route, live);
+        }
+        return this.withSlot(async () => {
+            const handle = await this.gateway.resume(sessionId, route, setup);
+            this.owned.set(sessionId, handle);
+            if (setup)
+                this.configuredAgents.add(handle.agent);
+            return this.makeRef(sessionId, route, handle);
+        });
+    }
+    async doBorrowIfLive(sessionId, route, setup) {
+        const live = this.gateway.get(sessionId);
+        if (!live)
+            return undefined;
+        await this.ensureBorrowedSetup(live, setup);
+        return this.makeRef(sessionId, route, live);
+    }
+    async withSlot(fn) {
+        await this.acquireSlot();
+        try {
+            return await fn();
+        }
+        finally {
+            this.releaseSlot();
+        }
+    }
+    async acquireSlot() {
+        while (true) {
+            if (this.closed) {
+                throw new Error(`AgentManager is closed; cannot resolve a session`);
+            }
+            if (this.active < this.maxConcurrency) {
+                this.active += 1;
+                return;
+            }
+            await new Promise((resolve) => this.waiters.push(resolve));
+        }
+    }
+    releaseSlot() {
+        this.active -= 1;
+        const next = this.waiters.shift();
+        if (next)
+            next();
+    }
+    makeRef(sessionId, route, agent) {
+        const ref = {
+            sessionId,
+            route,
+            agent: agent.agent,
+            followup: (message) => agent.followup(message),
+            whenIdle: () => agent.whenIdle(),
+            release: () => {
+                // Simple ownership: release is a marker; actual disposal happens once
+                // in disposeAll() for handles this manager owns.
+            },
+        };
+        this.refs.set(sessionId, ref);
+        return ref;
+    }
+}
+/** A durable session cannot be silently recomposed under a different preset. */
+export class AgentPresetConflictError extends Error {
+    sessionId;
+    requested;
+    persisted;
+    constructor(sessionId, requested, persisted) {
+        super(`session '${sessionId}' uses Agent preset '${persisted}', but route requested '${requested}'`);
+        this.sessionId = sessionId;
+        this.requested = requested;
+        this.persisted = persisted;
+        this.name = 'AgentPresetConflictError';
+    }
+}
+//# sourceMappingURL=agent-manager.js.map

package/lib/agent-manager.js.map

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

package/lib/agent-router.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Agent routing (doc H0.1/H0.2 / §30): turn a channel conversation into an
+ * `AgentRouteSpec` — a routing snapshot, NOT an identity.
+ *
+ * Harness Agent identity is the `SessionId` (shared between the agent and its
+ * session), so there is no runtime `agentId` parallel to it. A route only
+ * describes how to drive the session's agent: an optional Harness preset
+ * (`meta.agentPreset`) and/or provider/model/maxTokens (`agentOptions`).
+ *
+ * Resolution priority: routing override (conversation > account > channel) >
+ * `config.agent.default`.
+ */
+import type { Config } from './config.js';
+/** How a session's agent should be driven. Never an identity. */
+export interface AgentRouteSpec {
+    /** Harness Agent preset, composed into the session's world — NOT identity. */
+    preset?: string;
+    /** Optional provider route. */
+    provider?: string;
+    /** Optional model id interpreted by the provider adapter. */
+    model?: string;
+    /** Optional max output tokens per request. */
+    maxTokens?: number;
+}
+export interface AgentRouteInput {
+    channelId: string;
+    accountId: string;
+    conversationId: string;
+}
+/** Compare two routes structurally (used to detect binding route drift). */
+export declare function routesEqual(a: AgentRouteSpec | undefined, b: AgentRouteSpec | undefined): boolean;
+export declare class AgentRouter {
+    private readonly config;
+    constructor(config: Config);
+    resolve(input: AgentRouteInput): AgentRouteSpec;
+}
+//# sourceMappingURL=agent-router.d.ts.map

package/lib/agent-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-router.d.ts","sourceRoot":"","sources":["../src/agent-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,CAAC,EAAE,cAAc,GAAG,SAAS,EAAE,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,CASjG;AAED,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE3C,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc;CAYhD"}