octoflow-core 1.0.0

package/dist/runtime/bridge/bridge-core-services.d.ts

@@ -0,0 +1,25 @@
+import type { ApprovalStore } from '../../adapters/data/approval-store/types.js';
+import { CostAccumulator } from '../../adapters/data/budget/cost-accumulator.js';
+import type { SessionStore } from '../../adapters/data/session-store/types.js';
+import type { TaskStore } from '../../adapters/data/task-store/index.js';
+import type { AuthStore } from '../../auth/types.js';
+import type { CapabilityMiddleware } from '../../capabilities/types.js';
+import type { BridgeMiddleware, SessionBackendMobilityOptions } from '../../domain/bridge-api.js';
+import { BridgeObservabilityAdapter } from '../../observability/bridge-adapter.js';
+import { CircuitBreakerRegistry } from '../../resilience/circuit-breaker.js';
+import type { BridgeOptions } from '../sessions/context-manager.js';
+import type { BridgeEventEmitter } from './events.js';
+interface BridgeCoreServices {
+    authStore?: AuthStore;
+    mobilityOptions: Required<SessionBackendMobilityOptions>;
+    sessionStore?: SessionStore;
+    approvalStore?: ApprovalStore;
+    approvalGcTimer?: ReturnType<typeof setInterval>;
+    costAccumulator?: CostAccumulator;
+    circuitBreaker?: CircuitBreakerRegistry;
+    middleware: Array<BridgeMiddleware | CapabilityMiddleware>;
+    observabilityAdapter?: BridgeObservabilityAdapter;
+}
+export declare function initializeBridgeCoreServices(opts: BridgeOptions, store: TaskStore, events?: BridgeEventEmitter): BridgeCoreServices;
+export {};
+//# sourceMappingURL=bridge-core-services.d.ts.map

package/dist/runtime/bridge/bridge-core-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-core-services.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/bridge-core-services.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EACV,gBAAgB,EAChB,6BAA6B,EAC9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAGpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,UAAU,kBAAkB;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,eAAe,EAAE,QAAQ,CAAC,6BAA6B,CAAC,CAAC;IACzD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,eAAe,CAAC,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IACjD,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,UAAU,EAAE,KAAK,CAAC,gBAAgB,GAAG,oBAAoB,CAAC,CAAC;IAC3D,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;CACnD;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,SAAS,EAChB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,kBAAkB,CAqGpB"}

package/dist/runtime/bridge/bridge-core-services.js

@@ -0,0 +1,95 @@
+import { createApprovalStore } from "../../adapters/data/approval-store/factory.js";
+import { CostAccumulator } from "../../adapters/data/budget/cost-accumulator.js";
+import { createSessionStore } from "../../adapters/data/session-store/factory.js";
+import { BridgeObservabilityAdapter } from "../../observability/bridge-adapter.js";
+import { CircuitBreakerRegistry } from "../../resilience/circuit-breaker.js";
+import { getConfiguredWorkspace } from "../sessions/context-manager.js";
+import { resolveAuthStore } from "./auth-helpers.js";
+import { rehydrateBudget } from "./internals.js";
+function initializeBridgeCoreServices(opts, store, events) {
+  const authStore = resolveAuthStore(opts);
+  if (authStore && opts.auth && !opts.auth.store) {
+    opts.auth.store = authStore;
+  }
+  const mobility = opts.sessionBackendMobility ?? {};
+  const mobilityOptions = {
+    enabled: mobility.enabled ?? false,
+    mode: mobility.mode ?? "on-failure",
+    maxSwitchesPerContext: mobility.maxSwitchesPerContext ?? 2,
+    allowCrossFamilySwitch: mobility.allowCrossFamilySwitch ?? true
+  };
+  let sessionStore;
+  if (opts.dynamicSession) {
+    sessionStore = opts.sessionStore ?? createSessionStore({
+      // `storage: false` → ephemeral in-memory session store, matching the
+      // task-store/approval-store shorthand. Explicit `sessionStore` always
+      // wins; durable mode is the default otherwise. See RFC_brain.md
+      // §Persistence consistency.
+      type: opts.storage === false ? "memory" : "sqlite",
+      workspace: getConfiguredWorkspace(opts) ?? process.cwd()
+    });
+  }
+  if (sessionStore && opts.dynamicSession) {
+    const gc = opts.sessionGc ?? {};
+    if (gc.enabled !== false) {
+      const ttl = gc.ttlMs ?? 864e5;
+      const interval = gc.intervalMs ?? 3e5;
+      sessionStore.startGc?.(ttl, interval);
+    }
+  }
+  let approvalStore;
+  let approvalGcTimer;
+  if (opts.approval?.enabled) {
+    const workspace = getConfiguredWorkspace(opts) ?? process.cwd();
+    approvalStore = opts.approvalStore ?? createApprovalStore({
+      config: { kind: opts.storage !== false ? "sqlite" : "memory" },
+      workspace
+    });
+    if (approvalStore.deleteExpired && (opts.sessionGc?.enabled ?? true)) {
+      const ttl = opts.sessionGc?.approvalTtlMs ?? 6048e5;
+      const interval = opts.sessionGc?.intervalMs ?? 3e5;
+      approvalGcTimer = setInterval(() => {
+        void approvalStore.deleteExpired(
+          new Date(Date.now() - ttl).toISOString()
+        ).catch(
+          (error) => process.stderr.write(
+            `[octoflow] approval GC error: ${error instanceof Error ? error.message : String(error)}
+`
+          )
+        );
+      }, interval);
+      if (typeof approvalGcTimer === "object" && approvalGcTimer !== null && "unref" in approvalGcTimer) {
+        approvalGcTimer.unref();
+      }
+    }
+  }
+  let costAccumulator;
+  if (opts.budget?.enabled) {
+    costAccumulator = new CostAccumulator(opts.budget);
+    if (opts.budget.durable) {
+      rehydrateBudget(store, costAccumulator).catch(
+        (error) => process.stderr.write(
+          `[octoflow] budget rehydration error: ${error instanceof Error ? error.message : String(error)}
+`
+        )
+      );
+    }
+  }
+  const circuitBreaker = opts.circuitBreaker ? new CircuitBreakerRegistry(opts.circuitBreaker) : void 0;
+  const observabilityAdapter = opts.observability && events ? new BridgeObservabilityAdapter(events, opts.observability) : void 0;
+  return {
+    authStore,
+    mobilityOptions,
+    sessionStore,
+    approvalStore,
+    approvalGcTimer,
+    costAccumulator,
+    circuitBreaker,
+    middleware: opts.middleware ?? [],
+    observabilityAdapter
+  };
+}
+export {
+  initializeBridgeCoreServices
+};
+//# sourceMappingURL=bridge-core-services.js.map

package/dist/runtime/bridge/bridge-core-services.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/bridge-core-services.ts"],
+  "sourcesContent": ["import { createApprovalStore } from '../../adapters/data/approval-store/factory.js';\nimport type { ApprovalStore } from '../../adapters/data/approval-store/types.js';\nimport { CostAccumulator } from '../../adapters/data/budget/cost-accumulator.js';\nimport { createSessionStore } from '../../adapters/data/session-store/factory.js';\nimport type { SessionStore } from '../../adapters/data/session-store/types.js';\nimport type { TaskStore } from '../../adapters/data/task-store/index.js';\nimport type { AuthStore } from '../../auth/types.js';\nimport type { CapabilityMiddleware } from '../../capabilities/types.js';\nimport type {\n  BridgeMiddleware,\n  SessionBackendMobilityOptions,\n} from '../../domain/bridge-api.js';\nimport { BridgeObservabilityAdapter } from '../../observability/bridge-adapter.js';\nimport { CircuitBreakerRegistry } from '../../resilience/circuit-breaker.js';\nimport type { BridgeOptions } from '../sessions/context-manager.js';\nimport { getConfiguredWorkspace } from '../sessions/context-manager.js';\nimport { resolveAuthStore } from './auth-helpers.js';\nimport type { BridgeEventEmitter } from './events.js';\nimport { rehydrateBudget } from './internals.js';\n\ninterface BridgeCoreServices {\n  authStore?: AuthStore;\n  mobilityOptions: Required<SessionBackendMobilityOptions>;\n  sessionStore?: SessionStore;\n  approvalStore?: ApprovalStore;\n  approvalGcTimer?: ReturnType<typeof setInterval>;\n  costAccumulator?: CostAccumulator;\n  circuitBreaker?: CircuitBreakerRegistry;\n  middleware: Array<BridgeMiddleware | CapabilityMiddleware>;\n  observabilityAdapter?: BridgeObservabilityAdapter;\n}\n\nexport function initializeBridgeCoreServices(\n  opts: BridgeOptions,\n  store: TaskStore,\n  events?: BridgeEventEmitter\n): BridgeCoreServices {\n  const authStore = resolveAuthStore(opts);\n  if (authStore && opts.auth && !opts.auth.store) {\n    opts.auth.store = authStore;\n  }\n\n  const mobility = opts.sessionBackendMobility ?? {};\n  const mobilityOptions: Required<SessionBackendMobilityOptions> = {\n    enabled: mobility.enabled ?? false,\n    mode: mobility.mode ?? 'on-failure',\n    maxSwitchesPerContext: mobility.maxSwitchesPerContext ?? 2,\n    allowCrossFamilySwitch: mobility.allowCrossFamilySwitch ?? true,\n  };\n\n  let sessionStore: SessionStore | undefined;\n  if (opts.dynamicSession) {\n    sessionStore =\n      opts.sessionStore ??\n      createSessionStore({\n        // `storage: false` \u2192 ephemeral in-memory session store, matching the\n        // task-store/approval-store shorthand. Explicit `sessionStore` always\n        // wins; durable mode is the default otherwise. See RFC_brain.md\n        // \u00A7Persistence consistency.\n        type: opts.storage === false ? 'memory' : 'sqlite',\n        workspace: getConfiguredWorkspace(opts) ?? process.cwd(),\n      });\n  }\n\n  if (sessionStore && opts.dynamicSession) {\n    const gc = opts.sessionGc ?? {};\n    if (gc.enabled !== false) {\n      const ttl = gc.ttlMs ?? 86_400_000;\n      const interval = gc.intervalMs ?? 300_000;\n      sessionStore.startGc?.(ttl, interval);\n    }\n  }\n\n  let approvalStore: ApprovalStore | undefined;\n  let approvalGcTimer: ReturnType<typeof setInterval> | undefined;\n  if (opts.approval?.enabled) {\n    const workspace = getConfiguredWorkspace(opts) ?? process.cwd();\n    approvalStore =\n      opts.approvalStore ??\n      createApprovalStore({\n        config: { kind: opts.storage !== false ? 'sqlite' : 'memory' },\n        workspace,\n      });\n    if (approvalStore.deleteExpired && (opts.sessionGc?.enabled ?? true)) {\n      const ttl = opts.sessionGc?.approvalTtlMs ?? 604_800_000;\n      const interval = opts.sessionGc?.intervalMs ?? 300_000;\n      approvalGcTimer = setInterval(() => {\n        void approvalStore!.deleteExpired!(\n          new Date(Date.now() - ttl).toISOString()\n        ).catch((error: unknown) =>\n          process.stderr.write(\n            `[octoflow] approval GC error: ${error instanceof Error ? error.message : String(error)}\\n`\n          )\n        );\n      }, interval);\n      if (\n        typeof approvalGcTimer === 'object' &&\n        approvalGcTimer !== null &&\n        'unref' in approvalGcTimer\n      ) {\n        (approvalGcTimer as { unref(): void }).unref();\n      }\n    }\n  }\n\n  let costAccumulator: CostAccumulator | undefined;\n  if (opts.budget?.enabled) {\n    costAccumulator = new CostAccumulator(opts.budget);\n    if (opts.budget.durable) {\n      rehydrateBudget(store, costAccumulator).catch((error: unknown) =>\n        process.stderr.write(\n          `[octoflow] budget rehydration error: ${error instanceof Error ? error.message : String(error)}\\n`\n        )\n      );\n    }\n  }\n\n  const circuitBreaker = opts.circuitBreaker\n    ? new CircuitBreakerRegistry(opts.circuitBreaker)\n    : undefined;\n\n  const observabilityAdapter =\n    opts.observability && events\n      ? new BridgeObservabilityAdapter(events, opts.observability)\n      : undefined;\n\n  return {\n    authStore,\n    mobilityOptions,\n    sessionStore,\n    approvalStore,\n    approvalGcTimer,\n    costAccumulator,\n    circuitBreaker,\n    middleware: opts.middleware ?? [],\n    observabilityAdapter,\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,2BAA2B;AAEpC,SAAS,uBAAuB;AAChC,SAAS,0BAA0B;AASnC,SAAS,kCAAkC;AAC3C,SAAS,8BAA8B;AAEvC,SAAS,8BAA8B;AACvC,SAAS,wBAAwB;AAEjC,SAAS,uBAAuB;AAczB,SAAS,6BACd,MACA,OACA,QACoB;AACpB,QAAM,YAAY,iBAAiB,IAAI;AACvC,MAAI,aAAa,KAAK,QAAQ,CAAC,KAAK,KAAK,OAAO;AAC9C,SAAK,KAAK,QAAQ;AAAA,EACpB;AAEA,QAAM,WAAW,KAAK,0BAA0B,CAAC;AACjD,QAAM,kBAA2D;AAAA,IAC/D,SAAS,SAAS,WAAW;AAAA,IAC7B,MAAM,SAAS,QAAQ;AAAA,IACvB,uBAAuB,SAAS,yBAAyB;AAAA,IACzD,wBAAwB,SAAS,0BAA0B;AAAA,EAC7D;AAEA,MAAI;AACJ,MAAI,KAAK,gBAAgB;AACvB,mBACE,KAAK,gBACL,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAAA,MAKjB,MAAM,KAAK,YAAY,QAAQ,WAAW;AAAA,MAC1C,WAAW,uBAAuB,IAAI,KAAK,QAAQ,IAAI;AAAA,IACzD,CAAC;AAAA,EACL;AAEA,MAAI,gBAAgB,KAAK,gBAAgB;AACvC,UAAM,KAAK,KAAK,aAAa,CAAC;AAC9B,QAAI,GAAG,YAAY,OAAO;AACxB,YAAM,MAAM,GAAG,SAAS;AACxB,YAAM,WAAW,GAAG,cAAc;AAClC,mBAAa,UAAU,KAAK,QAAQ;AAAA,IACtC;AAAA,EACF;AAEA,MAAI;AACJ,MAAI;AACJ,MAAI,KAAK,UAAU,SAAS;AAC1B,UAAM,YAAY,uBAAuB,IAAI,KAAK,QAAQ,IAAI;AAC9D,oBACE,KAAK,iBACL,oBAAoB;AAAA,MAClB,QAAQ,EAAE,MAAM,KAAK,YAAY,QAAQ,WAAW,SAAS;AAAA,MAC7D;AAAA,IACF,CAAC;AACH,QAAI,cAAc,kBAAkB,KAAK,WAAW,WAAW,OAAO;AACpE,YAAM,MAAM,KAAK,WAAW,iBAAiB;AAC7C,YAAM,WAAW,KAAK,WAAW,cAAc;AAC/C,wBAAkB,YAAY,MAAM;AAClC,aAAK,cAAe;AAAA,UAClB,IAAI,KAAK,KAAK,IAAI,IAAI,GAAG,EAAE,YAAY;AAAA,QACzC,EAAE;AAAA,UAAM,CAAC,UACP,QAAQ,OAAO;AAAA,YACb,iCAAiC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA;AAAA,UACzF;AAAA,QACF;AAAA,MACF,GAAG,QAAQ;AACX,UACE,OAAO,oBAAoB,YAC3B,oBAAoB,QACpB,WAAW,iBACX;AACA,QAAC,gBAAsC,MAAM;AAAA,MAC/C;AAAA,IACF;AAAA,EACF;AAEA,MAAI;AACJ,MAAI,KAAK,QAAQ,SAAS;AACxB,sBAAkB,IAAI,gBAAgB,KAAK,MAAM;AACjD,QAAI,KAAK,OAAO,SAAS;AACvB,sBAAgB,OAAO,eAAe,EAAE;AAAA,QAAM,CAAC,UAC7C,QAAQ,OAAO;AAAA,UACb,wCAAwC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA;AAAA,QAChG;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,QAAM,iBAAiB,KAAK,iBACxB,IAAI,uBAAuB,KAAK,cAAc,IAC9C;AAEJ,QAAM,uBACJ,KAAK,iBAAiB,SAClB,IAAI,2BAA2B,QAAQ,KAAK,aAAa,IACzD;AAEN,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAY,KAAK,cAAc,CAAC;AAAA,IAChC;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/runtime/bridge/bridge-instance-api.d.ts

@@ -0,0 +1,37 @@
+import type { ListSessionsOptions, SessionListResult, SessionRecord } from '../../adapters/data/session-store/types.js';
+import type { LocalContextResult } from '../../capabilities/local-context/types.js';
+import type { McpConnection } from '../../capabilities/mcp/connection.js';
+import type { McpConnectionPool } from '../../capabilities/mcp/pool.js';
+import type { AgentSkillMetadata } from '../../capabilities/skills/types.js';
+import type { AgentStatus, BridgeConversation, BridgeConversationSnapshotOptions, BridgeListConversationsOptions, BridgeListConversationsResult, BridgeListTasksOptions, BridgeListTasksResult, BridgeSendMessageParams, BridgeSendResult, BridgeSubscriptionEvent, BridgeTaskSnapshotOptions, BridgeTaskSubscriptionOptions, GetAllSessionsOptions, SessionSummary } from '../../domain/bridge-api.js';
+import type { Task } from '../../domain/core-task.js';
+import type { BridgeRunParams, BridgeRunResult, RunEvent } from '../orchestration/run/types.js';
+import type { Bridge } from './bridge-class.js';
+import type { BridgePlugin } from './plugins.js';
+import { BridgeSession } from './session.js';
+export declare function listAgentSkills(this: Bridge): AgentSkillMetadata[];
+export declare function getAgentSkill(this: Bridge, name: string): AgentSkillMetadata | undefined;
+export declare function activateAgentSkill(this: Bridge, name: string): Promise<string>;
+export declare function getMcpPool(this: Bridge): McpConnectionPool | undefined;
+export declare function getMcpConnection(this: Bridge, n: string): McpConnection | undefined;
+export declare function getLocalContextResult(this: Bridge): LocalContextResult | undefined;
+export declare function sendMessage(this: Bridge, params: BridgeSendMessageParams): Promise<BridgeSendResult>;
+export declare function getTask(this: Bridge, taskId: string, options?: BridgeTaskSnapshotOptions): Promise<Task>;
+export declare function listTasks(this: Bridge, options?: BridgeListTasksOptions): Promise<BridgeListTasksResult>;
+export declare function getConversation(this: Bridge, contextId: string, options?: BridgeConversationSnapshotOptions): Promise<BridgeConversation>;
+export declare function listConversations(this: Bridge, options?: BridgeListConversationsOptions): Promise<BridgeListConversationsResult>;
+export declare function cancelTask(this: Bridge, taskId: string, options?: Pick<BridgeTaskSnapshotOptions, 'contextId' | 'tenant' | 'subject'>): Promise<Task>;
+export declare function subscribeToTask(this: Bridge, taskId: string, options?: BridgeTaskSubscriptionOptions): Promise<AsyncIterable<BridgeSubscriptionEvent>>;
+export declare function stream(this: Bridge, params: BridgeSendMessageParams): AsyncGenerator<BridgeSubscriptionEvent>;
+export declare function run(this: Bridge, params: BridgeRunParams): Promise<BridgeRunResult>;
+export declare function runStream(this: Bridge, params: BridgeRunParams): AsyncGenerator<RunEvent>;
+export declare function use(this: Bridge, plugin: BridgePlugin): Promise<void>;
+export declare function session(this: Bridge, contextId?: string, options?: {
+    tenant?: string;
+}): BridgeSession;
+export declare function resumeSession(this: Bridge, sessionId: string): BridgeSession;
+export declare function getSessionRecord(this: Bridge, sessionId: string): Promise<SessionRecord | undefined>;
+export declare function listSessions(this: Bridge, options?: ListSessionsOptions): Promise<SessionListResult>;
+export declare function getAllSessions(this: Bridge, opts?: GetAllSessionsOptions): Promise<SessionSummary[]>;
+export declare function getStatus(this: Bridge): Promise<AgentStatus>;
+//# sourceMappingURL=bridge-instance-api.d.ts.map

package/dist/runtime/bridge/bridge-instance-api.d.ts.map

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

package/dist/runtime/bridge/bridge-instance-api.js

@@ -0,0 +1,296 @@
+import crypto from "node:crypto";
+import { BACKEND_METADATA } from "../../adapters/agents/backends/shared.js";
+import { isTerminalTaskState } from "../../adapters/data/task-store/index.js";
+import {
+  SessionNotFoundError,
+  TaskNotFoundError
+} from "../../domain/errors/index.js";
+import { executeSendMessage } from "./bridge-send.js";
+import { emitAgentRunEvent } from "./events.js";
+import { assertTaskAccess, buildAllSessions } from "./internals.js";
+import {
+  assertConversationPolicy,
+  assertTaskPolicy,
+  filterConversationsByPolicy,
+  filterTasksByPolicy
+} from "./policy-helpers.js";
+import { bridgeRun, bridgeRunStream } from "./run-support.js";
+import { useBridgePlugin } from "./runtime-plugin-support.js";
+import { BridgeSession } from "./session.js";
+function listAgentSkills() {
+  return [...this._agentSkills];
+}
+function getAgentSkill(name) {
+  return this._agentSkills.find((s) => s.name === name);
+}
+async function activateAgentSkill(name) {
+  const meta = this.getAgentSkill(name);
+  if (!meta) throw new Error(`Unknown agent skill "${name}"`);
+  const { activateSkill, renderSkillBody } = await import("../../capabilities/skills/activator.js");
+  return renderSkillBody(await activateSkill({ meta }));
+}
+function getMcpPool() {
+  return this._mcpPool;
+}
+function getMcpConnection(n) {
+  return this._mcpPool?.getConnection(n);
+}
+function getLocalContextResult() {
+  return this._localContextResult;
+}
+async function sendMessage(params) {
+  if (this.destroyed) throw new Error("Bridge is destroyed");
+  return executeSendMessage(
+    {
+      approvalStore: this.approvalStore,
+      bridgeOptions: this.bridgeOptions,
+      contextManager: this.contextManager,
+      events: this.events,
+      getTask: (taskId, options) => this.getTask(taskId, options),
+      middleware: this.middleware,
+      mobilityOptions: this.mobilityOptions,
+      prepareAuth: () => this.prepareAuth(),
+      sessionStore: this.sessionStore,
+      store: this.store,
+      taskRunner: this.taskRunner
+    },
+    params
+  );
+}
+async function getTask(taskId, options = {}) {
+  const task = await this.store.getTask(taskId, options);
+  if (!task) throw new TaskNotFoundError(taskId);
+  assertTaskAccess(task, options);
+  await assertTaskPolicy({
+    action: "task.read",
+    task,
+    snapshotOptions: options,
+    policy: this.bridgeOptions.policy,
+    defaultSubject: this.bridgeOptions.policySubject,
+    emitEvent: this.events.emit.bind(this.events)
+  });
+  return task;
+}
+async function listTasks(options = {}) {
+  return filterTasksByPolicy(
+    await this.store.listTasks(options),
+    options,
+    this.bridgeOptions.policy,
+    this.bridgeOptions.policySubject,
+    this.events.emit.bind(this.events)
+  );
+}
+async function getConversation(contextId, options = {}) {
+  const conversation = await this.store.getConversation(contextId, {
+    includeHistory: options.includeHistory ?? true,
+    includeTasks: options.includeTasks ?? true,
+    ...options
+  });
+  if (!conversation) throw new Error(`Conversation not found: ${contextId}`);
+  await assertConversationPolicy({
+    conversation,
+    snapshotOptions: options,
+    policy: this.bridgeOptions.policy,
+    defaultSubject: this.bridgeOptions.policySubject,
+    emitEvent: this.events.emit.bind(this.events)
+  });
+  return conversation;
+}
+async function listConversations(options = {}) {
+  const result = await this.store.listConversations({
+    includeHistory: options.includeHistory ?? false,
+    includeTasks: options.includeTasks ?? false,
+    ...options
+  });
+  return filterConversationsByPolicy(
+    result,
+    options,
+    this.bridgeOptions.policy,
+    this.bridgeOptions.policySubject,
+    this.events.emit.bind(this.events)
+  );
+}
+async function cancelTask(taskId, options = {}) {
+  const task = await this.getTask(taskId, options);
+  await assertTaskPolicy({
+    action: "task.cancel",
+    task,
+    snapshotOptions: options,
+    policy: this.bridgeOptions.policy,
+    defaultSubject: this.bridgeOptions.policySubject,
+    emitEvent: this.events.emit.bind(this.events)
+  });
+  if (!isTerminalTaskState(task.status.state)) {
+    const context = this.contextManager.get(task.contextId, task.tenant);
+    await this.taskRunner.cancel(taskId, task, context);
+  }
+  return this.getTask(taskId, options);
+}
+async function subscribeToTask(taskId, options = {}) {
+  const task = await this.getTask(taskId, options);
+  await assertTaskPolicy({
+    action: "task.subscribe",
+    task,
+    snapshotOptions: options,
+    policy: this.bridgeOptions.policy,
+    defaultSubject: this.bridgeOptions.policySubject,
+    emitEvent: this.events.emit.bind(this.events)
+  });
+  return this.store.subscribe(taskId, { after: options.after });
+}
+async function* stream(params) {
+  const result = await this.sendMessage({
+    ...params,
+    returnImmediately: true
+  });
+  if (result.kind !== "task") return;
+  const subscription = await this.subscribeToTask(result.taskId, {
+    contextId: result.contextId ?? void 0,
+    subject: params.subject,
+    tenant: params.tenant
+  });
+  yield* subscription;
+}
+function withFlowWarn(params) {
+  if (!params.flow || params.flow.onWarn) return params;
+  const emit = this.events.emit.bind(this.events);
+  return {
+    ...params,
+    flow: {
+      ...params.flow,
+      onWarn: (code, message) => {
+        void emit("bridge:warn", { code, message });
+      }
+    }
+  };
+}
+async function run(params) {
+  return bridgeRun(
+    (p) => this.sendMessage(p),
+    this.bridgeOptions.loop,
+    this.bridgeOptions.tasks,
+    withFlowWarn.call(this, params),
+    this,
+    (event) => emitAgentRunEvent(this.events, event)
+  );
+}
+async function* runStream(params) {
+  yield* bridgeRunStream(
+    (p) => this.sendMessage(p),
+    this.bridgeOptions.loop,
+    this.bridgeOptions.tasks,
+    withFlowWarn.call(this, params),
+    this,
+    (event) => emitAgentRunEvent(this.events, event)
+  );
+}
+async function use(plugin) {
+  await useBridgePlugin(
+    {
+      _plugins: this._plugins,
+      actionRegistry: this.actionRegistry,
+      bridgeOptions: this.bridgeOptions,
+      events: this.events,
+      middleware: this.middleware,
+      on: this.on,
+      once: this.once,
+      off: this.off,
+      targetBridge: this,
+      getTask: this.getTask.bind(this),
+      listTasks: this.listTasks.bind(this),
+      sendMessage: this.sendMessage.bind(this),
+      budget: {
+        checkBudget: this.budget.checkBudget.bind(this.budget),
+        getSpend: this.budget.getSpend.bind(this.budget)
+      },
+      registry: {
+        registerAction: this.registry.registerAction.bind(this.registry),
+        unregisterAction: this.registry.unregisterAction.bind(this.registry),
+        registerSkill: this.registry.registerSkill.bind(this.registry),
+        unregisterSkill: this.registry.unregisterSkill.bind(this.registry)
+      }
+    },
+    plugin
+  );
+}
+function session(contextId = crypto.randomUUID(), options = {}) {
+  return new BridgeSession(this, contextId, options.tenant);
+}
+function resumeSession(sessionId) {
+  if (!this.sessionStore) throw new SessionNotFoundError(sessionId);
+  return new BridgeSession(this, "", void 0, sessionId);
+}
+async function getSessionRecord(sessionId) {
+  return this.sessionStore?.getSession(sessionId);
+}
+async function listSessions(options) {
+  if (!this.sessionStore) {
+    return { sessions: [], nextCursor: null, pageSize: 50, totalSize: 0 };
+  }
+  return this.sessionStore.listSessions(options);
+}
+async function getAllSessions(opts = {}) {
+  return buildAllSessions(
+    this.sessionStore,
+    this.store,
+    opts,
+    this.costAccumulator
+  );
+}
+async function getStatus() {
+  const inspections = await this.inspectBackends();
+  const selected = inspections.find((b) => b.selected && b.ready) ?? null;
+  const backends = inspections.map((entry) => {
+    const meta = BACKEND_METADATA[entry.backend];
+    return {
+      name: entry.backend,
+      displayName: meta?.displayName ?? entry.backend,
+      provider: entry.provider ?? null,
+      backendType: entry.backendType,
+      available: entry.ready,
+      selected: entry.selected,
+      reason: entry.reason,
+      version: entry.version,
+      model: entry.model ?? null,
+      models: meta?.models ?? [],
+      protocol: entry.protocol ?? "custom",
+      circuitState: entry.circuitState ?? null
+    };
+  });
+  const sessions = await this.getAllSessions({ includeMessages: false });
+  const budget = this.budget.getTotalSpend();
+  return {
+    ready: selected !== null,
+    backend: selected ? backends.find((b) => b.name === selected.backend) ?? null : null,
+    backends,
+    sessions: { total: sessions.length },
+    budget,
+    uptimeMs: Date.now() - this._startTime
+  };
+}
+export {
+  activateAgentSkill,
+  cancelTask,
+  getAgentSkill,
+  getAllSessions,
+  getConversation,
+  getLocalContextResult,
+  getMcpConnection,
+  getMcpPool,
+  getSessionRecord,
+  getStatus,
+  getTask,
+  listAgentSkills,
+  listConversations,
+  listSessions,
+  listTasks,
+  resumeSession,
+  run,
+  runStream,
+  sendMessage,
+  session,
+  stream,
+  subscribeToTask,
+  use
+};
+//# sourceMappingURL=bridge-instance-api.js.map

package/dist/runtime/bridge/bridge-instance-api.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/bridge-instance-api.ts"],
+  "sourcesContent": ["import crypto from 'node:crypto';\n\nimport { BACKEND_METADATA } from '../../adapters/agents/backends/shared.js';\nimport type {\n  ListSessionsOptions,\n  SessionListResult,\n  SessionRecord,\n} from '../../adapters/data/session-store/types.js';\nimport { isTerminalTaskState } from '../../adapters/data/task-store/index.js';\nimport type { LocalContextResult } from '../../capabilities/local-context/types.js';\nimport type { McpConnection } from '../../capabilities/mcp/connection.js';\nimport type { McpConnectionPool } from '../../capabilities/mcp/pool.js';\nimport type { AgentSkillMetadata } from '../../capabilities/skills/types.js';\nimport type {\n  AgentStatus,\n  BridgeConversation,\n  BridgeConversationSnapshotOptions,\n  BridgeListConversationsOptions,\n  BridgeListConversationsResult,\n  BridgeListTasksOptions,\n  BridgeListTasksResult,\n  BridgeSendMessageParams,\n  BridgeSendResult,\n  BridgeSubscriptionEvent,\n  BridgeTaskSnapshotOptions,\n  BridgeTaskSubscriptionOptions,\n  GetAllSessionsOptions,\n  SessionSummary,\n} from '../../domain/bridge-api.js';\nimport type { Task } from '../../domain/core-task.js';\nimport {\n  SessionNotFoundError,\n  TaskNotFoundError,\n} from '../../domain/errors/index.js';\nimport type {\n  BridgeRunParams,\n  BridgeRunResult,\n  RunEvent,\n} from '../orchestration/run/types.js';\nimport type { Bridge } from './bridge-class.js';\nimport { executeSendMessage } from './bridge-send.js';\nimport { emitAgentRunEvent } from './events.js';\nimport type { FabricAccessor } from './fabric-types.js';\nimport { assertTaskAccess, buildAllSessions } from './internals.js';\nimport type { BridgePlugin } from './plugins.js';\nimport {\n  assertConversationPolicy,\n  assertTaskPolicy,\n  filterConversationsByPolicy,\n  filterTasksByPolicy,\n} from './policy-helpers.js';\nimport { bridgeRun, bridgeRunStream } from './run-support.js';\nimport { useBridgePlugin } from './runtime-plugin-support.js';\nimport { BridgeSession } from './session.js';\n\nexport function listAgentSkills(this: Bridge): AgentSkillMetadata[] {\n  return [...this._agentSkills];\n}\n\nexport function getAgentSkill(\n  this: Bridge,\n  name: string\n): AgentSkillMetadata | undefined {\n  return this._agentSkills.find((s) => s.name === name);\n}\n\nexport async function activateAgentSkill(\n  this: Bridge,\n  name: string\n): Promise<string> {\n  const meta = this.getAgentSkill(name);\n  if (!meta) throw new Error(`Unknown agent skill \"${name}\"`);\n  const { activateSkill, renderSkillBody } =\n    await import('../../capabilities/skills/activator.js');\n  return renderSkillBody(await activateSkill({ meta }));\n}\n\nexport function getMcpPool(this: Bridge): McpConnectionPool | undefined {\n  return this._mcpPool;\n}\n\nexport function getMcpConnection(\n  this: Bridge,\n  n: string\n): McpConnection | undefined {\n  return this._mcpPool?.getConnection(n);\n}\n\nexport function getLocalContextResult(\n  this: Bridge\n): LocalContextResult | undefined {\n  return this._localContextResult;\n}\n\nexport async function sendMessage(\n  this: Bridge,\n  params: BridgeSendMessageParams\n): Promise<BridgeSendResult> {\n  if (this.destroyed) throw new Error('Bridge is destroyed');\n  return executeSendMessage(\n    {\n      approvalStore: this.approvalStore,\n      bridgeOptions: this.bridgeOptions,\n      contextManager: this.contextManager,\n      events: this.events,\n      getTask: (taskId, options) => this.getTask(taskId, options),\n      middleware: this.middleware,\n      mobilityOptions: this.mobilityOptions,\n      prepareAuth: () => this.prepareAuth(),\n      sessionStore: this.sessionStore,\n      store: this.store,\n      taskRunner: this.taskRunner,\n    },\n    params\n  );\n}\n\nexport async function getTask(\n  this: Bridge,\n  taskId: string,\n  options: BridgeTaskSnapshotOptions = {}\n): Promise<Task> {\n  const task = await this.store.getTask(taskId, options);\n  if (!task) throw new TaskNotFoundError(taskId);\n  assertTaskAccess(task, options);\n  await assertTaskPolicy({\n    action: 'task.read',\n    task,\n    snapshotOptions: options,\n    policy: this.bridgeOptions.policy,\n    defaultSubject: this.bridgeOptions.policySubject,\n    emitEvent: this.events.emit.bind(this.events),\n  });\n  return task;\n}\n\nexport async function listTasks(\n  this: Bridge,\n  options: BridgeListTasksOptions = {}\n): Promise<BridgeListTasksResult> {\n  return filterTasksByPolicy(\n    await this.store.listTasks(options),\n    options,\n    this.bridgeOptions.policy,\n    this.bridgeOptions.policySubject,\n    this.events.emit.bind(this.events)\n  );\n}\n\nexport async function getConversation(\n  this: Bridge,\n  contextId: string,\n  options: BridgeConversationSnapshotOptions = {}\n): Promise<BridgeConversation> {\n  const conversation = await this.store.getConversation(contextId, {\n    includeHistory: options.includeHistory ?? true,\n    includeTasks: options.includeTasks ?? true,\n    ...options,\n  });\n  if (!conversation) throw new Error(`Conversation not found: ${contextId}`);\n  await assertConversationPolicy({\n    conversation,\n    snapshotOptions: options,\n    policy: this.bridgeOptions.policy,\n    defaultSubject: this.bridgeOptions.policySubject,\n    emitEvent: this.events.emit.bind(this.events),\n  });\n  return conversation;\n}\n\nexport async function listConversations(\n  this: Bridge,\n  options: BridgeListConversationsOptions = {}\n): Promise<BridgeListConversationsResult> {\n  const result = await this.store.listConversations({\n    includeHistory: options.includeHistory ?? false,\n    includeTasks: options.includeTasks ?? false,\n    ...options,\n  });\n  return filterConversationsByPolicy(\n    result,\n    options,\n    this.bridgeOptions.policy,\n    this.bridgeOptions.policySubject,\n    this.events.emit.bind(this.events)\n  );\n}\n\nexport async function cancelTask(\n  this: Bridge,\n  taskId: string,\n  options: Pick<\n    BridgeTaskSnapshotOptions,\n    'contextId' | 'tenant' | 'subject'\n  > = {}\n): Promise<Task> {\n  const task = await this.getTask(taskId, options);\n  await assertTaskPolicy({\n    action: 'task.cancel',\n    task,\n    snapshotOptions: options,\n    policy: this.bridgeOptions.policy,\n    defaultSubject: this.bridgeOptions.policySubject,\n    emitEvent: this.events.emit.bind(this.events),\n  });\n  if (!isTerminalTaskState(task.status.state)) {\n    const context = this.contextManager.get(task.contextId, task.tenant);\n    await this.taskRunner.cancel(taskId, task, context);\n  }\n  return this.getTask(taskId, options);\n}\n\nexport async function subscribeToTask(\n  this: Bridge,\n  taskId: string,\n  options: BridgeTaskSubscriptionOptions = {}\n): Promise<AsyncIterable<BridgeSubscriptionEvent>> {\n  const task = await this.getTask(taskId, options);\n  await assertTaskPolicy({\n    action: 'task.subscribe',\n    task,\n    snapshotOptions: options,\n    policy: this.bridgeOptions.policy,\n    defaultSubject: this.bridgeOptions.policySubject,\n    emitEvent: this.events.emit.bind(this.events),\n  });\n  return this.store.subscribe(taskId, { after: options.after });\n}\n\nexport async function* stream(\n  this: Bridge,\n  params: BridgeSendMessageParams\n): AsyncGenerator<BridgeSubscriptionEvent> {\n  const result = await this.sendMessage({\n    ...params,\n    returnImmediately: true,\n  });\n  if (result.kind !== 'task') return;\n  const subscription = await this.subscribeToTask(result.taskId, {\n    contextId: result.contextId ?? undefined,\n    subject: params.subject,\n    tenant: params.tenant,\n  });\n  yield* subscription as AsyncGenerator<BridgeSubscriptionEvent>;\n}\n\n/** Injects `flow.onWarn \u2192 bridge:warn` when the caller hasn't provided one. */\nfunction withFlowWarn(this: Bridge, params: BridgeRunParams): BridgeRunParams {\n  if (!params.flow || params.flow.onWarn) return params;\n  const emit = this.events.emit.bind(this.events);\n  return {\n    ...params,\n    flow: {\n      ...params.flow,\n      onWarn: (code, message) => {\n        void emit('bridge:warn', { code, message });\n      },\n    },\n  };\n}\n\nexport async function run(\n  this: Bridge,\n  params: BridgeRunParams\n): Promise<BridgeRunResult> {\n  return bridgeRun(\n    (p) => this.sendMessage(p),\n    this.bridgeOptions.loop,\n    this.bridgeOptions.tasks,\n    withFlowWarn.call(this, params),\n    this as unknown as Bridge & { fabric: FabricAccessor },\n    (event) => emitAgentRunEvent(this.events, event)\n  );\n}\n\nexport async function* runStream(\n  this: Bridge,\n  params: BridgeRunParams\n): AsyncGenerator<RunEvent> {\n  yield* bridgeRunStream(\n    (p) => this.sendMessage(p),\n    this.bridgeOptions.loop,\n    this.bridgeOptions.tasks,\n    withFlowWarn.call(this, params),\n    this as unknown as Bridge & { fabric: FabricAccessor },\n    (event) => emitAgentRunEvent(this.events, event)\n  );\n}\n\nexport async function use(this: Bridge, plugin: BridgePlugin): Promise<void> {\n  await useBridgePlugin(\n    {\n      _plugins: this._plugins,\n      actionRegistry: this.actionRegistry,\n      bridgeOptions: this.bridgeOptions,\n      events: this.events,\n      middleware: this.middleware,\n      on: this.on,\n      once: this.once,\n      off: this.off,\n      targetBridge: this,\n      getTask: this.getTask.bind(this),\n      listTasks: this.listTasks.bind(this),\n      sendMessage: this.sendMessage.bind(this),\n      budget: {\n        checkBudget: this.budget.checkBudget.bind(this.budget),\n        getSpend: this.budget.getSpend.bind(this.budget),\n      },\n      registry: {\n        registerAction: this.registry.registerAction.bind(this.registry),\n        unregisterAction: this.registry.unregisterAction.bind(this.registry),\n        registerSkill: this.registry.registerSkill.bind(this.registry),\n        unregisterSkill: this.registry.unregisterSkill.bind(this.registry),\n      },\n    },\n    plugin\n  );\n}\n\nexport function session(\n  this: Bridge,\n  contextId: string = crypto.randomUUID(),\n  options: { tenant?: string } = {}\n): BridgeSession {\n  return new BridgeSession(this, contextId, options.tenant);\n}\n\nexport function resumeSession(this: Bridge, sessionId: string): BridgeSession {\n  if (!this.sessionStore) throw new SessionNotFoundError(sessionId);\n  return new BridgeSession(this, '', undefined, sessionId);\n}\n\nexport async function getSessionRecord(\n  this: Bridge,\n  sessionId: string\n): Promise<SessionRecord | undefined> {\n  return this.sessionStore?.getSession(sessionId);\n}\n\nexport async function listSessions(\n  this: Bridge,\n  options?: ListSessionsOptions\n): Promise<SessionListResult> {\n  if (!this.sessionStore) {\n    return { sessions: [], nextCursor: null, pageSize: 50, totalSize: 0 };\n  }\n  return this.sessionStore.listSessions(options);\n}\n\nexport async function getAllSessions(\n  this: Bridge,\n  opts: GetAllSessionsOptions = {}\n): Promise<SessionSummary[]> {\n  return buildAllSessions(\n    this.sessionStore,\n    this.store,\n    opts,\n    this.costAccumulator\n  );\n}\n\nexport async function getStatus(this: Bridge): Promise<AgentStatus> {\n  const inspections = await this.inspectBackends();\n  const selected = inspections.find((b) => b.selected && b.ready) ?? null;\n  const backends = inspections.map((entry) => {\n    const meta = (\n      BACKEND_METADATA as Record<\n        string,\n        { displayName?: string; models?: string[] }\n      >\n    )[entry.backend];\n    return {\n      name: entry.backend,\n      displayName: meta?.displayName ?? entry.backend,\n      provider: entry.provider ?? null,\n      backendType: entry.backendType,\n      available: entry.ready,\n      selected: entry.selected,\n      reason: entry.reason,\n      version: entry.version,\n      model: entry.model ?? null,\n      models: meta?.models ?? [],\n      protocol: entry.protocol ?? 'custom',\n      circuitState: entry.circuitState ?? null,\n    };\n  });\n  const sessions = await this.getAllSessions({ includeMessages: false });\n  const budget = this.budget.getTotalSpend();\n  return {\n    ready: selected !== null,\n    backend: selected\n      ? (backends.find((b) => b.name === selected.backend) ?? null)\n      : null,\n    backends,\n    sessions: { total: sessions.length },\n    budget,\n    uptimeMs: Date.now() - this._startTime,\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/bridge/bridge-lifecycle.d.ts

@@ -0,0 +1,43 @@
+import type { ApprovalStore } from '../../adapters/data/approval-store/types.js';
+import type { SessionStore } from '../../adapters/data/session-store/types.js';
+import type { TaskStore } from '../../adapters/data/task-store/index.js';
+import type { McpConnectionPool } from '../../capabilities/mcp/pool.js';
+import type { AgentSkillMetadata } from '../../capabilities/skills/types.js';
+import type { BridgeObservabilityAdapter } from '../../observability/bridge-adapter.js';
+import type { BridgeEventEmitter } from './events.js';
+import type { StoredPlugin } from './plugins.js';
+import type { BridgeRegistryFacade } from './registry-facade.js';
+import type { TopicChannel } from './topic-channel.js';
+interface BeginBridgeShutdownOptions {
+    abortAllTasks(): void;
+    awaitWorkflowStop: boolean;
+    clearContexts(): void;
+    isDestroyed(): boolean;
+    markDestroyed(): void;
+    stopWorkflows(): Promise<void>;
+}
+interface BeginBridgeCloseOptions {
+    agentSkills: AgentSkillMetadata[];
+    approvalGcTimer?: ReturnType<typeof setInterval>;
+    approvalStore?: ApprovalStore;
+    events: BridgeEventEmitter;
+    localContextResultRef: {
+        clear(): void;
+    };
+    mcpPool?: McpConnectionPool;
+    mcpPoolRef: {
+        clear(): void;
+    };
+    observabilityAdapter?: BridgeObservabilityAdapter;
+    plugins: StoredPlugin[];
+    registry: BridgeRegistryFacade;
+    sessionStore?: SessionStore;
+    store: TaskStore;
+    topics?: TopicChannel;
+    verboseLoggerDispose?: () => void;
+    clearVerboseLogger(): void;
+}
+export declare function beginBridgeShutdown(options: BeginBridgeShutdownOptions): Promise<void>;
+export declare function beginBridgeClose(options: BeginBridgeCloseOptions): Promise<void>;
+export {};
+//# sourceMappingURL=bridge-lifecycle.d.ts.map

package/dist/runtime/bridge/bridge-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/bridge-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AACxF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,UAAU,0BAA0B;IAClC,aAAa,IAAI,IAAI,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,IAAI,IAAI,CAAC;IACtB,WAAW,IAAI,OAAO,CAAC;IACvB,aAAa,IAAI,IAAI,CAAC;IACtB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED,UAAU,uBAAuB;IAC/B,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,eAAe,CAAC,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IACjD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qBAAqB,EAAE;QAAE,KAAK,IAAI,IAAI,CAAA;KAAE,CAAC;IACzC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,UAAU,EAAE;QAAE,KAAK,IAAI,IAAI,CAAA;KAAE,CAAC;IAC9B,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAC;IAClC,kBAAkB,IAAI,IAAI,CAAC;CAC5B;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/runtime/bridge/bridge-lifecycle.js

@@ -0,0 +1,43 @@
+import { closeBridgeRuntime } from "./runtime-plugin-support.js";
+async function beginBridgeShutdown(options) {
+  if (options.isDestroyed()) return;
+  options.markDestroyed();
+  const workflowStop = options.stopWorkflows();
+  if (options.awaitWorkflowStop) {
+    await workflowStop;
+  } else {
+    void workflowStop;
+  }
+  options.abortAllTasks();
+  options.clearContexts();
+}
+function beginBridgeClose(options) {
+  options.verboseLoggerDispose?.();
+  options.clearVerboseLogger();
+  return closeBridgeRuntime({
+    _agentSkills: options.agentSkills,
+    _localContextResult: void 0,
+    _mcpPool: options.mcpPool,
+    _plugins: options.plugins,
+    _topics: options.topics,
+    approvalGcTimer: options.approvalGcTimer,
+    approvalStore: options.approvalStore,
+    emitDestroy: () => options.events.emit("bridge:destroy", { contextIds: [] }),
+    events: options.events,
+    observabilityAdapter: options.observabilityAdapter,
+    registry: {
+      unregisterSkill: options.registry.unregisterSkill.bind(options.registry)
+    },
+    sessionStore: options.sessionStore,
+    store: options.store
+  }).finally(() => {
+    options.mcpPoolRef.clear();
+    options.localContextResultRef.clear();
+    options.agentSkills.length = 0;
+  });
+}
+export {
+  beginBridgeClose,
+  beginBridgeShutdown
+};
+//# sourceMappingURL=bridge-lifecycle.js.map

package/dist/runtime/bridge/bridge-lifecycle.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/bridge-lifecycle.ts"],
+  "sourcesContent": ["import type { ApprovalStore } from '../../adapters/data/approval-store/types.js';\nimport type { SessionStore } from '../../adapters/data/session-store/types.js';\nimport type { TaskStore } from '../../adapters/data/task-store/index.js';\nimport type { McpConnectionPool } from '../../capabilities/mcp/pool.js';\nimport type { AgentSkillMetadata } from '../../capabilities/skills/types.js';\nimport type { BridgeObservabilityAdapter } from '../../observability/bridge-adapter.js';\nimport type { BridgeEventEmitter } from './events.js';\nimport type { StoredPlugin } from './plugins.js';\nimport type { BridgeRegistryFacade } from './registry-facade.js';\nimport { closeBridgeRuntime } from './runtime-plugin-support.js';\nimport type { TopicChannel } from './topic-channel.js';\n\ninterface BeginBridgeShutdownOptions {\n  abortAllTasks(): void;\n  awaitWorkflowStop: boolean;\n  clearContexts(): void;\n  isDestroyed(): boolean;\n  markDestroyed(): void;\n  stopWorkflows(): Promise<void>;\n}\n\ninterface BeginBridgeCloseOptions {\n  agentSkills: AgentSkillMetadata[];\n  approvalGcTimer?: ReturnType<typeof setInterval>;\n  approvalStore?: ApprovalStore;\n  events: BridgeEventEmitter;\n  localContextResultRef: { clear(): void };\n  mcpPool?: McpConnectionPool;\n  mcpPoolRef: { clear(): void };\n  observabilityAdapter?: BridgeObservabilityAdapter;\n  plugins: StoredPlugin[];\n  registry: BridgeRegistryFacade;\n  sessionStore?: SessionStore;\n  store: TaskStore;\n  topics?: TopicChannel;\n  verboseLoggerDispose?: () => void;\n  clearVerboseLogger(): void;\n}\n\nexport async function beginBridgeShutdown(\n  options: BeginBridgeShutdownOptions\n): Promise<void> {\n  if (options.isDestroyed()) return;\n\n  options.markDestroyed();\n  const workflowStop = options.stopWorkflows();\n  if (options.awaitWorkflowStop) {\n    await workflowStop;\n  } else {\n    void workflowStop;\n  }\n  options.abortAllTasks();\n  options.clearContexts();\n}\n\nexport function beginBridgeClose(\n  options: BeginBridgeCloseOptions\n): Promise<void> {\n  options.verboseLoggerDispose?.();\n  options.clearVerboseLogger();\n\n  return closeBridgeRuntime({\n    _agentSkills: options.agentSkills,\n    _localContextResult: undefined,\n    _mcpPool: options.mcpPool,\n    _plugins: options.plugins,\n    _topics: options.topics,\n    approvalGcTimer: options.approvalGcTimer,\n    approvalStore: options.approvalStore,\n    emitDestroy: () =>\n      options.events.emit('bridge:destroy', { contextIds: [] }),\n    events: options.events,\n    observabilityAdapter: options.observabilityAdapter,\n    registry: {\n      unregisterSkill: options.registry.unregisterSkill.bind(options.registry),\n    },\n    sessionStore: options.sessionStore,\n    store: options.store,\n  }).finally(() => {\n    options.mcpPoolRef.clear();\n    options.localContextResultRef.clear();\n    options.agentSkills.length = 0;\n  });\n}\n"],
+  "mappings": "AASA,SAAS,0BAA0B;AA8BnC,eAAsB,oBACpB,SACe;AACf,MAAI,QAAQ,YAAY,EAAG;AAE3B,UAAQ,cAAc;AACtB,QAAM,eAAe,QAAQ,cAAc;AAC3C,MAAI,QAAQ,mBAAmB;AAC7B,UAAM;AAAA,EACR,OAAO;AACL,SAAK;AAAA,EACP;AACA,UAAQ,cAAc;AACtB,UAAQ,cAAc;AACxB;AAEO,SAAS,iBACd,SACe;AACf,UAAQ,uBAAuB;AAC/B,UAAQ,mBAAmB;AAE3B,SAAO,mBAAmB;AAAA,IACxB,cAAc,QAAQ;AAAA,IACtB,qBAAqB;AAAA,IACrB,UAAU,QAAQ;AAAA,IAClB,UAAU,QAAQ;AAAA,IAClB,SAAS,QAAQ;AAAA,IACjB,iBAAiB,QAAQ;AAAA,IACzB,eAAe,QAAQ;AAAA,IACvB,aAAa,MACX,QAAQ,OAAO,KAAK,kBAAkB,EAAE,YAAY,CAAC,EAAE,CAAC;AAAA,IAC1D,QAAQ,QAAQ;AAAA,IAChB,sBAAsB,QAAQ;AAAA,IAC9B,UAAU;AAAA,MACR,iBAAiB,QAAQ,SAAS,gBAAgB,KAAK,QAAQ,QAAQ;AAAA,IACzE;AAAA,IACA,cAAc,QAAQ;AAAA,IACtB,OAAO,QAAQ;AAAA,EACjB,CAAC,EAAE,QAAQ,MAAM;AACf,YAAQ,WAAW,MAAM;AACzB,YAAQ,sBAAsB,MAAM;AACpC,YAAQ,YAAY,SAAS;AAAA,EAC/B,CAAC;AACH;",
+  "names": []
+}