octoflow-core 1.0.0

package/dist/runtime/bridge/quickstart-types.d.ts

@@ -0,0 +1,35 @@
+import type { BackendName } from '../../domain/core-client.js';
+import type { BridgeOptions } from '../sessions/bridge-options.js';
+export interface QuickStartOptions {
+    /**
+     * Read `OCTOFLOW_PROFILE` / `OCTOFLOW_BACKENDS` /
+     * `OCTOFLOW_VERBOSE` / `OCTOFLOW_STORAGE`. Default: true.
+     */
+    fromEnv?: boolean;
+    /** Explicit profile override (takes precedence over env). */
+    profile?: string;
+    /** Explicit backend priority override (takes precedence over env). */
+    backends?: readonly BackendName[];
+    /**
+     * Attach verbose event listeners
+     * (`backend:retry` / `backend:error` / `backend:fallback`).
+     * Default: value of `OCTOFLOW_VERBOSE` when `fromEnv`, else `false`.
+     */
+    verbose?: boolean;
+    /**
+     * Enable persistent task storage. Maps to `BridgeOptions.storage`.
+     * Default: value of `OCTOFLOW_STORAGE` when `fromEnv`, else unset.
+     */
+    storage?: boolean;
+    /** Anything else forwarded to `createBridge()` - e.g. `systemPrompt`, `plugins`. */
+    bridge?: Partial<BridgeOptions>;
+}
+/** @internal Resolved shape consumed by `quickStart`. Exposed for tests. */
+export interface ResolvedQuickStartOptions {
+    profile: string;
+    priority: BackendName[] | undefined;
+    verbose: boolean;
+    storage: boolean | undefined;
+    bridge: Partial<BridgeOptions> | undefined;
+}
+//# sourceMappingURL=quickstart-types.d.ts.map

package/dist/runtime/bridge/quickstart-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart-types.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/quickstart-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAClC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oFAAoF;IACpF,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACjC;AAED,4EAA4E;AAC5E,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;CAC5C"}

package/dist/runtime/bridge/quickstart-types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=quickstart-types.js.map

package/dist/runtime/bridge/quickstart-types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/runtime/bridge/quickstart.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `Bridge.quickStart({ fromEnv: true })` — the one-line happy-path bootstrap.
+ *
+ * Collapses the ~25-LOC ceremony of
+ *   `parseBackendPriority` / `createTemplateConfig` / `createBridge` /
+ *   `attachVerboseListeners`
+ * copy-pasted across ~50 templates into a single call.
+ *
+ * Semantics:
+ *   - explicit options win over env
+ *   - env wins over defaults
+ *   - defaults: profile='local-trusted', verbose=false, storage=undefined
+ *   - `fromEnv: false` disables env reading (useful for embedded callers)
+ *   - `verbose: true` attaches the canonical listener set via
+ *     `attachVerboseListeners`
+ *   - everything under `opts.bridge` is forwarded verbatim to `createBridge`
+ */
+import type { Bridge } from './bridge.js';
+import type { QuickStartOptions, ResolvedQuickStartOptions } from './quickstart-types.js';
+export type { QuickStartOptions, ResolvedQuickStartOptions, } from './quickstart-types.js';
+/**
+ * Pure option resolver. Split from `quickStart` so tests can exercise the
+ * env-precedence matrix without paying the cost of `createBridge()`.
+ */
+export declare function resolveQuickStartOptions(opts: QuickStartOptions, env: NodeJS.ProcessEnv): ResolvedQuickStartOptions;
+/**
+ * Implementation of `Bridge.quickStart()`. Lives in its own module to keep
+ * `bridge.ts` focused on the Bridge class and to avoid an import cycle with
+ * `create-bridge.ts`.
+ */
+export declare function quickStart(opts?: QuickStartOptions): Promise<Bridge>;
+//# sourceMappingURL=quickstart.d.ts.map

package/dist/runtime/bridge/quickstart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/quickstart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAUH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EACV,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,yBAAyB,CAgC3B;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAajB"}

package/dist/runtime/bridge/quickstart.js

@@ -0,0 +1,48 @@
+import {
+  parseBackendPriority,
+  readEnvBool,
+  readOptionalEnvBool
+} from "../../config/env-priority.js";
+import { attachVerboseListeners } from "../../observability/verbose-listeners.js";
+import { createBridge } from "./create-bridge.js";
+function resolveQuickStartOptions(opts, env) {
+  const fromEnv = opts.fromEnv ?? true;
+  const profile = opts.profile ?? (fromEnv ? env.OCTOFLOW_PROFILE : void 0) ?? "local-trusted";
+  let priority;
+  if (opts.backends) {
+    priority = [...opts.backends];
+  } else if (fromEnv && env.OCTOFLOW_BACKENDS != null) {
+    priority = parseBackendPriority(env.OCTOFLOW_BACKENDS);
+  }
+  const verbose = opts.verbose ?? (fromEnv ? readEnvBool("OCTOFLOW_VERBOSE", env) : false);
+  let storage;
+  if (opts.storage !== void 0) {
+    storage = opts.storage;
+  } else if (fromEnv) {
+    storage = readOptionalEnvBool("OCTOFLOW_STORAGE", env);
+  }
+  return {
+    profile,
+    priority,
+    verbose,
+    storage,
+    bridge: opts.bridge
+  };
+}
+async function quickStart(opts = {}) {
+  const resolved = resolveQuickStartOptions(opts, process.env);
+  const bridgeOpts = {
+    profile: resolved.profile,
+    ...resolved.priority ? { priority: resolved.priority } : {},
+    ...resolved.storage !== void 0 ? { storage: resolved.storage } : {},
+    ...resolved.bridge ?? {}
+  };
+  const bridge = await createBridge(bridgeOpts);
+  if (resolved.verbose) attachVerboseListeners(bridge);
+  return bridge;
+}
+export {
+  quickStart,
+  resolveQuickStartOptions
+};
+//# sourceMappingURL=quickstart.js.map

package/dist/runtime/bridge/quickstart.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/quickstart.ts"],
+  "sourcesContent": ["/**\n * `Bridge.quickStart({ fromEnv: true })` \u2014 the one-line happy-path bootstrap.\n *\n * Collapses the ~25-LOC ceremony of\n *   `parseBackendPriority` / `createTemplateConfig` / `createBridge` /\n *   `attachVerboseListeners`\n * copy-pasted across ~50 templates into a single call.\n *\n * Semantics:\n *   - explicit options win over env\n *   - env wins over defaults\n *   - defaults: profile='local-trusted', verbose=false, storage=undefined\n *   - `fromEnv: false` disables env reading (useful for embedded callers)\n *   - `verbose: true` attaches the canonical listener set via\n *     `attachVerboseListeners`\n *   - everything under `opts.bridge` is forwarded verbatim to `createBridge`\n */\n\nimport {\n  parseBackendPriority,\n  readEnvBool,\n  readOptionalEnvBool,\n} from '../../config/env-priority.js';\nimport type { BackendName } from '../../domain/core-client.js';\nimport { attachVerboseListeners } from '../../observability/verbose-listeners.js';\nimport type { BridgeOptions } from '../sessions/bridge-options.js';\nimport type { Bridge } from './bridge.js';\nimport { createBridge } from './create-bridge.js';\nimport type {\n  QuickStartOptions,\n  ResolvedQuickStartOptions,\n} from './quickstart-types.js';\n\nexport type {\n  QuickStartOptions,\n  ResolvedQuickStartOptions,\n} from './quickstart-types.js';\n\n/**\n * Pure option resolver. Split from `quickStart` so tests can exercise the\n * env-precedence matrix without paying the cost of `createBridge()`.\n */\nexport function resolveQuickStartOptions(\n  opts: QuickStartOptions,\n  env: NodeJS.ProcessEnv\n): ResolvedQuickStartOptions {\n  const fromEnv = opts.fromEnv ?? true;\n\n  const profile =\n    opts.profile ??\n    (fromEnv ? env.OCTOFLOW_PROFILE : undefined) ??\n    'local-trusted';\n\n  let priority: BackendName[] | undefined;\n  if (opts.backends) {\n    priority = [...opts.backends];\n  } else if (fromEnv && env.OCTOFLOW_BACKENDS != null) {\n    priority = parseBackendPriority(env.OCTOFLOW_BACKENDS);\n  }\n\n  const verbose =\n    opts.verbose ?? (fromEnv ? readEnvBool('OCTOFLOW_VERBOSE', env) : false);\n\n  let storage: boolean | undefined;\n  if (opts.storage !== undefined) {\n    storage = opts.storage;\n  } else if (fromEnv) {\n    storage = readOptionalEnvBool('OCTOFLOW_STORAGE', env);\n  }\n\n  return {\n    profile,\n    priority,\n    verbose,\n    storage,\n    bridge: opts.bridge,\n  };\n}\n\n/**\n * Implementation of `Bridge.quickStart()`. Lives in its own module to keep\n * `bridge.ts` focused on the Bridge class and to avoid an import cycle with\n * `create-bridge.ts`.\n */\nexport async function quickStart(\n  opts: QuickStartOptions = {}\n): Promise<Bridge> {\n  const resolved = resolveQuickStartOptions(opts, process.env);\n\n  const bridgeOpts: BridgeOptions = {\n    profile: resolved.profile,\n    ...(resolved.priority ? { priority: resolved.priority } : {}),\n    ...(resolved.storage !== undefined ? { storage: resolved.storage } : {}),\n    ...(resolved.bridge ?? {}),\n  };\n\n  const bridge = await createBridge(bridgeOpts);\n  if (resolved.verbose) attachVerboseListeners(bridge);\n  return bridge;\n}\n"],
+  "mappings": "AAkBA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,8BAA8B;AAGvC,SAAS,oBAAoB;AAetB,SAAS,yBACd,MACA,KAC2B;AAC3B,QAAM,UAAU,KAAK,WAAW;AAEhC,QAAM,UACJ,KAAK,YACJ,UAAU,IAAI,mBAAmB,WAClC;AAEF,MAAI;AACJ,MAAI,KAAK,UAAU;AACjB,eAAW,CAAC,GAAG,KAAK,QAAQ;AAAA,EAC9B,WAAW,WAAW,IAAI,qBAAqB,MAAM;AACnD,eAAW,qBAAqB,IAAI,iBAAiB;AAAA,EACvD;AAEA,QAAM,UACJ,KAAK,YAAY,UAAU,YAAY,oBAAoB,GAAG,IAAI;AAEpE,MAAI;AACJ,MAAI,KAAK,YAAY,QAAW;AAC9B,cAAU,KAAK;AAAA,EACjB,WAAW,SAAS;AAClB,cAAU,oBAAoB,oBAAoB,GAAG;AAAA,EACvD;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ,KAAK;AAAA,EACf;AACF;AAOA,eAAsB,WACpB,OAA0B,CAAC,GACV;AACjB,QAAM,WAAW,yBAAyB,MAAM,QAAQ,GAAG;AAE3D,QAAM,aAA4B;AAAA,IAChC,SAAS,SAAS;AAAA,IAClB,GAAI,SAAS,WAAW,EAAE,UAAU,SAAS,SAAS,IAAI,CAAC;AAAA,IAC3D,GAAI,SAAS,YAAY,SAAY,EAAE,SAAS,SAAS,QAAQ,IAAI,CAAC;AAAA,IACtE,GAAI,SAAS,UAAU,CAAC;AAAA,EAC1B;AAEA,QAAM,SAAS,MAAM,aAAa,UAAU;AAC5C,MAAI,SAAS,QAAS,wBAAuB,MAAM;AACnD,SAAO;AACT;",
+  "names": []
+}

package/dist/runtime/bridge/registry-facade.d.ts

@@ -0,0 +1,23 @@
+import type { ActionRegistry } from '../../actions/registry.js';
+import type { ActionDefinition } from '../../actions/types.js';
+import type { SkillRegistry } from '../../capabilities/skill-registry.js';
+import type { SkillDefinition } from '../../capabilities/skill-types.js';
+interface RegistryFacadeDeps {
+    actionRegistry: ActionRegistry;
+    skillRegistry: SkillRegistry;
+}
+export declare class BridgeRegistryFacade {
+    private readonly actionRegistry;
+    private readonly skillRegistry;
+    constructor(deps: RegistryFacadeDeps);
+    registerAction(action: ActionDefinition): void;
+    unregisterAction(name: string): boolean;
+    listActions(): ActionDefinition[];
+    getAction(name: string): ActionDefinition | undefined;
+    registerSkill(skill: SkillDefinition): void;
+    unregisterSkill(name: string): boolean;
+    listSkills(): SkillDefinition[];
+    getSkill(name: string): SkillDefinition | undefined;
+}
+export {};
+//# sourceMappingURL=registry-facade.d.ts.map

package/dist/runtime/bridge/registry-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-facade.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/registry-facade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE,UAAU,kBAAkB;IAC1B,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAElC,IAAI,EAAE,kBAAkB;IAKpC,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAG9C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAGvC,WAAW,IAAI,gBAAgB,EAAE;IAGjC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIrD,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAG3C,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAGtC,UAAU,IAAI,eAAe,EAAE;IAG/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;CAGpD"}

package/dist/runtime/bridge/registry-facade.js

@@ -0,0 +1,36 @@
+class BridgeRegistryFacade {
+  actionRegistry;
+  skillRegistry;
+  constructor(deps) {
+    this.actionRegistry = deps.actionRegistry;
+    this.skillRegistry = deps.skillRegistry;
+  }
+  registerAction(action) {
+    this.actionRegistry.register(action);
+  }
+  unregisterAction(name) {
+    return this.actionRegistry.unregister(name);
+  }
+  listActions() {
+    return this.actionRegistry.all();
+  }
+  getAction(name) {
+    return this.actionRegistry.get(name);
+  }
+  registerSkill(skill) {
+    this.skillRegistry.register(skill);
+  }
+  unregisterSkill(name) {
+    return this.skillRegistry.unregister(name);
+  }
+  listSkills() {
+    return this.skillRegistry.all();
+  }
+  getSkill(name) {
+    return this.skillRegistry.get(name);
+  }
+}
+export {
+  BridgeRegistryFacade
+};
+//# sourceMappingURL=registry-facade.js.map

package/dist/runtime/bridge/registry-facade.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/registry-facade.ts"],
+  "sourcesContent": ["import type { ActionRegistry } from '../../actions/registry.js';\nimport type { ActionDefinition } from '../../actions/types.js';\nimport type { SkillRegistry } from '../../capabilities/skill-registry.js';\nimport type { SkillDefinition } from '../../capabilities/skill-types.js';\n\ninterface RegistryFacadeDeps {\n  actionRegistry: ActionRegistry;\n  skillRegistry: SkillRegistry;\n}\n\nexport class BridgeRegistryFacade {\n  private readonly actionRegistry: ActionRegistry;\n  private readonly skillRegistry: SkillRegistry;\n\n  constructor(deps: RegistryFacadeDeps) {\n    this.actionRegistry = deps.actionRegistry;\n    this.skillRegistry = deps.skillRegistry;\n  }\n\n  registerAction(action: ActionDefinition): void {\n    this.actionRegistry.register(action);\n  }\n  unregisterAction(name: string): boolean {\n    return this.actionRegistry.unregister(name);\n  }\n  listActions(): ActionDefinition[] {\n    return this.actionRegistry.all();\n  }\n  getAction(name: string): ActionDefinition | undefined {\n    return this.actionRegistry.get(name);\n  }\n\n  registerSkill(skill: SkillDefinition): void {\n    this.skillRegistry.register(skill);\n  }\n  unregisterSkill(name: string): boolean {\n    return this.skillRegistry.unregister(name);\n  }\n  listSkills(): SkillDefinition[] {\n    return this.skillRegistry.all();\n  }\n  getSkill(name: string): SkillDefinition | undefined {\n    return this.skillRegistry.get(name);\n  }\n}\n"],
+  "mappings": "AAUO,MAAM,qBAAqB;AAAA,EACf;AAAA,EACA;AAAA,EAEjB,YAAY,MAA0B;AACpC,SAAK,iBAAiB,KAAK;AAC3B,SAAK,gBAAgB,KAAK;AAAA,EAC5B;AAAA,EAEA,eAAe,QAAgC;AAC7C,SAAK,eAAe,SAAS,MAAM;AAAA,EACrC;AAAA,EACA,iBAAiB,MAAuB;AACtC,WAAO,KAAK,eAAe,WAAW,IAAI;AAAA,EAC5C;AAAA,EACA,cAAkC;AAChC,WAAO,KAAK,eAAe,IAAI;AAAA,EACjC;AAAA,EACA,UAAU,MAA4C;AACpD,WAAO,KAAK,eAAe,IAAI,IAAI;AAAA,EACrC;AAAA,EAEA,cAAc,OAA8B;AAC1C,SAAK,cAAc,SAAS,KAAK;AAAA,EACnC;AAAA,EACA,gBAAgB,MAAuB;AACrC,WAAO,KAAK,cAAc,WAAW,IAAI;AAAA,EAC3C;AAAA,EACA,aAAgC;AAC9B,WAAO,KAAK,cAAc,IAAI;AAAA,EAChC;AAAA,EACA,SAAS,MAA2C;AAClD,WAAO,KAAK,cAAc,IAAI,IAAI;AAAA,EACpC;AACF;",
+  "names": []
+}

package/dist/runtime/bridge/remote-brain.d.ts

@@ -0,0 +1,55 @@
+import { OctoFlowError } from '../../domain/errors/base.js';
+import type { CognitiveMemoryLike } from './brain-contract.js';
+export type RemoteBrainOperation = 'remember' | 'recall' | 'digest' | 'consolidate' | 'feedback' | 'resolveContradiction' | 'audit' | 'replay' | 'prune' | 'close';
+export interface RemoteBrainResponseLike {
+    readonly ok: boolean;
+    readonly status: number;
+    readonly statusText?: string;
+    json(): Promise<unknown>;
+    text(): Promise<string>;
+}
+export type RemoteBrainFetch = (url: string, init: {
+    body?: string;
+    headers?: Record<string, string>;
+    method: 'POST';
+    signal?: AbortSignal;
+}) => Promise<RemoteBrainResponseLike>;
+export type RemoteBrainIdempotencyKey = string | ((input: {
+    attempt: number;
+    body: unknown;
+    operation: RemoteBrainOperation;
+}) => string | undefined);
+export interface RemoteBrainOptions {
+    baseUrl: string;
+    authToken?: string;
+    closeEndpoint?: boolean | string;
+    contractVersion?: number;
+    enabled?: boolean;
+    fetch?: RemoteBrainFetch;
+    headers?: Record<string, string>;
+    idempotencyKey?: RemoteBrainIdempotencyKey;
+    retries?: number;
+    retryDelayMs?: number;
+    timeoutMs?: number;
+}
+export declare class RemoteBrainError extends OctoFlowError {
+    readonly attempts: number;
+    readonly body?: unknown;
+    readonly operation: RemoteBrainOperation;
+    readonly status?: number;
+    constructor(opts: {
+        attempts: number;
+        body?: unknown;
+        cause?: unknown;
+        message?: string;
+        operation: RemoteBrainOperation;
+        status?: number;
+    });
+}
+export declare class RemoteBrainDisabledError extends OctoFlowError {
+    readonly operation: RemoteBrainOperation;
+    constructor(operation: RemoteBrainOperation);
+}
+export declare function createRemoteBrain(options: RemoteBrainOptions): CognitiveMemoryLike;
+export declare const remoteBrain: typeof createRemoteBrain;
+//# sourceMappingURL=remote-brain.d.ts.map

package/dist/runtime/bridge/remote-brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-brain.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/remote-brain.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,MAAM,MAAM,oBAAoB,GAC5B,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,UAAU,GACV,sBAAsB,GACtB,OAAO,GACP,QAAQ,GACR,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IACJ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,KACE,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAEtC,MAAM,MAAM,yBAAyB,GACjC,MAAM,GACN,CAAC,CAAC,KAAK,EAAE;IACP,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,oBAAoB,CAAC;CACjC,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;AAE9B,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,yBAAyB,CAAC;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAqBD,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,IAAI,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,oBAAoB,CAAC;QAChC,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;CAmBF;AAED,qBAAa,wBAAyB,SAAQ,aAAa;IACzD,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;gBAE7B,SAAS,EAAE,oBAAoB;CAS5C;AAiGD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,mBAAmB,CAyHrB;AAED,eAAO,MAAM,WAAW,0BAAoB,CAAC"}

package/dist/runtime/bridge/remote-brain.js

@@ -0,0 +1,225 @@
+import { OctoFlowError } from "../../domain/errors/base.js";
+import { COGNITIVE_MEMORY_CONTRACT_VERSION } from "./brain-contract.js";
+const DEFAULT_TIMEOUT_MS = 1e4;
+const ENDPOINTS = {
+  audit: "audit",
+  close: "close",
+  consolidate: "consolidate",
+  digest: "digest",
+  feedback: "feedback",
+  prune: "prune",
+  recall: "recall",
+  remember: "remember",
+  replay: "replay",
+  resolveContradiction: "resolve-contradiction"
+};
+class RemoteBrainError extends OctoFlowError {
+  attempts;
+  body;
+  operation;
+  status;
+  constructor(opts) {
+    const context = {
+      attempts: opts.attempts,
+      operation: opts.operation
+    };
+    if (opts.status != null) context.status = opts.status;
+    if (opts.body != null) context.body = opts.body;
+    super(
+      "REMOTE_BRAIN_ERROR",
+      opts.message ?? remoteBrainErrorMessage(opts.operation, opts.status),
+      context
+    );
+    this.name = "RemoteBrainError";
+    this.attempts = opts.attempts;
+    this.body = opts.body;
+    this.operation = opts.operation;
+    this.status = opts.status;
+    if (opts.cause) this.cause = opts.cause;
+  }
+}
+class RemoteBrainDisabledError extends OctoFlowError {
+  operation;
+  constructor(operation) {
+    super(
+      "REMOTE_BRAIN_DISABLED",
+      `remote brain is disabled; cannot run ${operation}().`,
+      { operation }
+    );
+    this.name = "RemoteBrainDisabledError";
+    this.operation = operation;
+  }
+}
+function remoteBrainErrorMessage(operation, status) {
+  return status == null ? `remote brain ${operation} request failed` : `remote brain ${operation} request failed with HTTP ${status}`;
+}
+function delay(ms) {
+  if (ms <= 0) return Promise.resolve();
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function fetchImpl(options) {
+  if (options.fetch) return options.fetch;
+  const nativeFetch = globalThis.fetch;
+  if (typeof nativeFetch !== "function") {
+    throw new RemoteBrainError({
+      attempts: 0,
+      message: "remote brain requires a fetch implementation.",
+      operation: "recall"
+    });
+  }
+  return (url, init) => nativeFetch(url, init);
+}
+function cleanBaseUrl(baseUrl) {
+  const trimmed = baseUrl.trim();
+  return trimmed.endsWith("/") ? trimmed.slice(0, -1) : trimmed;
+}
+function endpointUrl(baseUrl, endpoint) {
+  return `${baseUrl}/${endpoint.replace(/^\/+/, "")}`;
+}
+function idempotencyHeader(key, input) {
+  if (typeof key === "function") return key(input);
+  return key;
+}
+async function errorResponseBody(res) {
+  try {
+    return await res.json();
+  } catch {
+    const text = await res.text().catch(() => "");
+    return text || void 0;
+  }
+}
+async function successResponseBody(res, operation, attempts) {
+  try {
+    return await res.json();
+  } catch (error) {
+    throw new RemoteBrainError({
+      attempts,
+      cause: error,
+      message: `remote brain ${operation} response was not valid JSON`,
+      operation,
+      status: res.status
+    });
+  }
+}
+function disabledBrain(contractVersion) {
+  const reject = (operation) => Promise.reject(new RemoteBrainDisabledError(operation));
+  return {
+    contractVersion,
+    audit: () => reject("audit"),
+    close: () => Promise.resolve(),
+    consolidate: () => reject("consolidate"),
+    digest: () => reject("digest"),
+    feedback: () => reject("feedback"),
+    prune: () => reject("prune"),
+    recall: () => reject("recall"),
+    remember: () => reject("remember"),
+    replay: () => reject("replay"),
+    resolveContradiction: () => reject("resolveContradiction")
+  };
+}
+function createRemoteBrain(options) {
+  const contractVersion = options.contractVersion ?? COGNITIVE_MEMORY_CONTRACT_VERSION;
+  if (options.enabled === false) return disabledBrain(contractVersion);
+  const baseUrl = cleanBaseUrl(options.baseUrl);
+  if (!baseUrl) {
+    throw new RemoteBrainError({
+      attempts: 0,
+      message: "remote brain requires a non-empty baseUrl.",
+      operation: "recall"
+    });
+  }
+  const doFetch = fetchImpl(options);
+  const retries = Math.max(0, options.retries ?? 0);
+  const retryDelayMs = Math.max(0, options.retryDelayMs ?? 50);
+  const timeoutMs = Math.max(1, options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+  const request = async (operation, body, requestOptions = {}) => {
+    const endpoint = requestOptions.endpoint ?? ENDPOINTS[operation];
+    const url = endpointUrl(baseUrl, endpoint);
+    let lastError;
+    for (let attempt = 1; attempt <= retries + 1; attempt += 1) {
+      const controller = new AbortController();
+      const timer = setTimeout(() => controller.abort(), timeoutMs);
+      try {
+        const headers = {
+          accept: "application/json",
+          "content-type": "application/json",
+          ...options.headers ?? {}
+        };
+        if (options.authToken) {
+          headers.authorization = `Bearer ${options.authToken}`;
+        }
+        if (requestOptions.idempotent) {
+          const key = idempotencyHeader(options.idempotencyKey, {
+            attempt,
+            body,
+            operation
+          });
+          if (key) headers["idempotency-key"] = key;
+        }
+        const res = await doFetch(url, {
+          body: JSON.stringify(body ?? {}),
+          headers,
+          method: "POST",
+          signal: controller.signal
+        });
+        if (!res.ok) {
+          const parsed2 = await errorResponseBody(res);
+          throw new RemoteBrainError({
+            attempts: attempt,
+            body: parsed2,
+            operation,
+            status: res.status
+          });
+        }
+        const parsed = await successResponseBody(res, operation, attempt);
+        return parsed;
+      } catch (error) {
+        lastError = error;
+        if (attempt > retries) {
+          if (error instanceof RemoteBrainError) throw error;
+          throw new RemoteBrainError({
+            attempts: attempt,
+            cause: error,
+            message: error instanceof Error && error.name === "AbortError" ? `remote brain ${operation} request timed out after ${timeoutMs}ms` : void 0,
+            operation
+          });
+        }
+        await delay(retryDelayMs);
+      } finally {
+        clearTimeout(timer);
+      }
+    }
+    throw new RemoteBrainError({
+      attempts: retries + 1,
+      cause: lastError,
+      operation
+    });
+  };
+  return {
+    contractVersion,
+    audit: (input) => request("audit", input),
+    close: async () => {
+      if (!options.closeEndpoint) return;
+      const endpoint = typeof options.closeEndpoint === "string" ? options.closeEndpoint : ENDPOINTS.close;
+      await request("close", {}, { endpoint });
+    },
+    consolidate: (input) => request("consolidate", input, { idempotent: true }),
+    digest: (input) => request("digest", input, { idempotent: true }),
+    feedback: (input) => request("feedback", input, { idempotent: true }),
+    prune: (input) => request("prune", input, { idempotent: true }),
+    recall: (input) => request("recall", input),
+    remember: (input) => request("remember", input, { idempotent: true }),
+    replay: (input) => request("replay", input, { idempotent: true }),
+    resolveContradiction: (input) => request("resolveContradiction", input, {
+      idempotent: true
+    })
+  };
+}
+const remoteBrain = createRemoteBrain;
+export {
+  RemoteBrainDisabledError,
+  RemoteBrainError,
+  createRemoteBrain,
+  remoteBrain
+};
+//# sourceMappingURL=remote-brain.js.map

package/dist/runtime/bridge/remote-brain.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/remote-brain.ts"],
+  "sourcesContent": ["import type {\n  AuditInput,\n  AuditResult,\n  ConsolidateInput,\n  ConsolidateResult,\n  DigestInput,\n  DigestResult,\n  FeedbackInput,\n  FeedbackResult,\n  PruneInput,\n  PruneResult,\n  RecallInput,\n  RecallResult,\n  RememberInput,\n  RememberResult,\n  ReplayCycleResult,\n  ReplayInput,\n  ResolveContradictionInput,\n  ResolveContradictionResult,\n} from 'octoflow-protocols';\n\nimport { OctoFlowError } from '../../domain/errors/base.js';\nimport type { CognitiveMemoryLike } from './brain-contract.js';\nimport { COGNITIVE_MEMORY_CONTRACT_VERSION } from './brain-contract.js';\n\nexport type RemoteBrainOperation =\n  | 'remember'\n  | 'recall'\n  | 'digest'\n  | 'consolidate'\n  | 'feedback'\n  | 'resolveContradiction'\n  | 'audit'\n  | 'replay'\n  | 'prune'\n  | 'close';\n\nexport interface RemoteBrainResponseLike {\n  readonly ok: boolean;\n  readonly status: number;\n  readonly statusText?: string;\n  json(): Promise<unknown>;\n  text(): Promise<string>;\n}\n\nexport type RemoteBrainFetch = (\n  url: string,\n  init: {\n    body?: string;\n    headers?: Record<string, string>;\n    method: 'POST';\n    signal?: AbortSignal;\n  }\n) => Promise<RemoteBrainResponseLike>;\n\nexport type RemoteBrainIdempotencyKey =\n  | string\n  | ((input: {\n      attempt: number;\n      body: unknown;\n      operation: RemoteBrainOperation;\n    }) => string | undefined);\n\nexport interface RemoteBrainOptions {\n  baseUrl: string;\n  authToken?: string;\n  closeEndpoint?: boolean | string;\n  contractVersion?: number;\n  enabled?: boolean;\n  fetch?: RemoteBrainFetch;\n  headers?: Record<string, string>;\n  idempotencyKey?: RemoteBrainIdempotencyKey;\n  retries?: number;\n  retryDelayMs?: number;\n  timeoutMs?: number;\n}\n\ninterface RequestOptions {\n  endpoint?: string;\n  idempotent?: boolean;\n}\n\nconst DEFAULT_TIMEOUT_MS = 10_000;\nconst ENDPOINTS: Record<RemoteBrainOperation, string> = {\n  audit: 'audit',\n  close: 'close',\n  consolidate: 'consolidate',\n  digest: 'digest',\n  feedback: 'feedback',\n  prune: 'prune',\n  recall: 'recall',\n  remember: 'remember',\n  replay: 'replay',\n  resolveContradiction: 'resolve-contradiction',\n};\n\nexport class RemoteBrainError extends OctoFlowError {\n  readonly attempts: number;\n  readonly body?: unknown;\n  readonly operation: RemoteBrainOperation;\n  readonly status?: number;\n\n  constructor(opts: {\n    attempts: number;\n    body?: unknown;\n    cause?: unknown;\n    message?: string;\n    operation: RemoteBrainOperation;\n    status?: number;\n  }) {\n    const context: Record<string, unknown> = {\n      attempts: opts.attempts,\n      operation: opts.operation,\n    };\n    if (opts.status != null) context.status = opts.status;\n    if (opts.body != null) context.body = opts.body;\n    super(\n      'REMOTE_BRAIN_ERROR',\n      opts.message ?? remoteBrainErrorMessage(opts.operation, opts.status),\n      context\n    );\n    this.name = 'RemoteBrainError';\n    this.attempts = opts.attempts;\n    this.body = opts.body;\n    this.operation = opts.operation;\n    this.status = opts.status;\n    if (opts.cause) (this as { cause?: unknown }).cause = opts.cause;\n  }\n}\n\nexport class RemoteBrainDisabledError extends OctoFlowError {\n  readonly operation: RemoteBrainOperation;\n\n  constructor(operation: RemoteBrainOperation) {\n    super(\n      'REMOTE_BRAIN_DISABLED',\n      `remote brain is disabled; cannot run ${operation}().`,\n      { operation }\n    );\n    this.name = 'RemoteBrainDisabledError';\n    this.operation = operation;\n  }\n}\n\nfunction remoteBrainErrorMessage(\n  operation: RemoteBrainOperation,\n  status: number | undefined\n): string {\n  return status == null\n    ? `remote brain ${operation} request failed`\n    : `remote brain ${operation} request failed with HTTP ${status}`;\n}\n\nfunction delay(ms: number): Promise<void> {\n  if (ms <= 0) return Promise.resolve();\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nfunction fetchImpl(options: RemoteBrainOptions): RemoteBrainFetch {\n  if (options.fetch) return options.fetch;\n  const nativeFetch = globalThis.fetch;\n  if (typeof nativeFetch !== 'function') {\n    throw new RemoteBrainError({\n      attempts: 0,\n      message: 'remote brain requires a fetch implementation.',\n      operation: 'recall',\n    });\n  }\n  return (url, init) => nativeFetch(url, init);\n}\n\nfunction cleanBaseUrl(baseUrl: string): string {\n  const trimmed = baseUrl.trim();\n  return trimmed.endsWith('/') ? trimmed.slice(0, -1) : trimmed;\n}\n\nfunction endpointUrl(baseUrl: string, endpoint: string): string {\n  return `${baseUrl}/${endpoint.replace(/^\\/+/, '')}`;\n}\n\nfunction idempotencyHeader(\n  key: RemoteBrainIdempotencyKey | undefined,\n  input: {\n    attempt: number;\n    body: unknown;\n    operation: RemoteBrainOperation;\n  }\n): string | undefined {\n  if (typeof key === 'function') return key(input);\n  return key;\n}\n\nasync function errorResponseBody(\n  res: RemoteBrainResponseLike\n): Promise<unknown> {\n  try {\n    return await res.json();\n  } catch {\n    const text = await res.text().catch(() => '');\n    return text || undefined;\n  }\n}\n\nasync function successResponseBody(\n  res: RemoteBrainResponseLike,\n  operation: RemoteBrainOperation,\n  attempts: number\n): Promise<unknown> {\n  try {\n    return await res.json();\n  } catch (error) {\n    throw new RemoteBrainError({\n      attempts,\n      cause: error,\n      message: `remote brain ${operation} response was not valid JSON`,\n      operation,\n      status: res.status,\n    });\n  }\n}\n\nfunction disabledBrain(contractVersion: number): CognitiveMemoryLike {\n  const reject = <T>(operation: RemoteBrainOperation): Promise<T> =>\n    Promise.reject(new RemoteBrainDisabledError(operation));\n  return {\n    contractVersion,\n    audit: () => reject('audit'),\n    close: () => Promise.resolve(),\n    consolidate: () => reject('consolidate'),\n    digest: () => reject('digest'),\n    feedback: () => reject('feedback'),\n    prune: () => reject('prune'),\n    recall: () => reject('recall'),\n    remember: () => reject('remember'),\n    replay: () => reject('replay'),\n    resolveContradiction: () => reject('resolveContradiction'),\n  };\n}\n\nexport function createRemoteBrain(\n  options: RemoteBrainOptions\n): CognitiveMemoryLike {\n  const contractVersion =\n    options.contractVersion ?? COGNITIVE_MEMORY_CONTRACT_VERSION;\n  if (options.enabled === false) return disabledBrain(contractVersion);\n\n  const baseUrl = cleanBaseUrl(options.baseUrl);\n  if (!baseUrl) {\n    throw new RemoteBrainError({\n      attempts: 0,\n      message: 'remote brain requires a non-empty baseUrl.',\n      operation: 'recall',\n    });\n  }\n  const doFetch = fetchImpl(options);\n  const retries = Math.max(0, options.retries ?? 0);\n  const retryDelayMs = Math.max(0, options.retryDelayMs ?? 50);\n  const timeoutMs = Math.max(1, options.timeoutMs ?? DEFAULT_TIMEOUT_MS);\n\n  const request = async <T>(\n    operation: RemoteBrainOperation,\n    body: unknown,\n    requestOptions: RequestOptions = {}\n  ): Promise<T> => {\n    const endpoint = requestOptions.endpoint ?? ENDPOINTS[operation];\n    const url = endpointUrl(baseUrl, endpoint);\n    let lastError: unknown;\n\n    for (let attempt = 1; attempt <= retries + 1; attempt += 1) {\n      const controller = new AbortController();\n      const timer = setTimeout(() => controller.abort(), timeoutMs);\n      try {\n        const headers: Record<string, string> = {\n          accept: 'application/json',\n          'content-type': 'application/json',\n          ...(options.headers ?? {}),\n        };\n        if (options.authToken) {\n          headers.authorization = `Bearer ${options.authToken}`;\n        }\n        if (requestOptions.idempotent) {\n          const key = idempotencyHeader(options.idempotencyKey, {\n            attempt,\n            body,\n            operation,\n          });\n          if (key) headers['idempotency-key'] = key;\n        }\n\n        const res = await doFetch(url, {\n          body: JSON.stringify(body ?? {}),\n          headers,\n          method: 'POST',\n          signal: controller.signal,\n        });\n        if (!res.ok) {\n          const parsed = await errorResponseBody(res);\n          throw new RemoteBrainError({\n            attempts: attempt,\n            body: parsed,\n            operation,\n            status: res.status,\n          });\n        }\n        const parsed = await successResponseBody(res, operation, attempt);\n        return parsed as T;\n      } catch (error) {\n        lastError = error;\n        if (attempt > retries) {\n          if (error instanceof RemoteBrainError) throw error;\n          throw new RemoteBrainError({\n            attempts: attempt,\n            cause: error,\n            message:\n              error instanceof Error && error.name === 'AbortError'\n                ? `remote brain ${operation} request timed out after ${timeoutMs}ms`\n                : undefined,\n            operation,\n          });\n        }\n        await delay(retryDelayMs);\n      } finally {\n        clearTimeout(timer);\n      }\n    }\n\n    throw new RemoteBrainError({\n      attempts: retries + 1,\n      cause: lastError,\n      operation,\n    });\n  };\n\n  return {\n    contractVersion,\n    audit: (input?: AuditInput) => request<AuditResult>('audit', input),\n    close: async () => {\n      if (!options.closeEndpoint) return;\n      const endpoint =\n        typeof options.closeEndpoint === 'string'\n          ? options.closeEndpoint\n          : ENDPOINTS.close;\n      await request<void>('close', {}, { endpoint });\n    },\n    consolidate: (input?: ConsolidateInput) =>\n      request<ConsolidateResult>('consolidate', input, { idempotent: true }),\n    digest: (input?: DigestInput) =>\n      request<DigestResult>('digest', input, { idempotent: true }),\n    feedback: (input: FeedbackInput) =>\n      request<FeedbackResult>('feedback', input, { idempotent: true }),\n    prune: (input?: PruneInput) =>\n      request<PruneResult>('prune', input, { idempotent: true }),\n    recall: (input: RecallInput) => request<RecallResult>('recall', input),\n    remember: (input: RememberInput) =>\n      request<RememberResult>('remember', input, { idempotent: true }),\n    replay: (input?: number | ReplayInput) =>\n      request<ReplayCycleResult>('replay', input, { idempotent: true }),\n    resolveContradiction: (input: ResolveContradictionInput) =>\n      request<ResolveContradictionResult>('resolveContradiction', input, {\n        idempotent: true,\n      }),\n  };\n}\n\nexport const remoteBrain = createRemoteBrain;\n"],
+  "mappings": "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",
+  "names": ["parsed"]
+}

package/dist/runtime/bridge/run-support.d.ts

@@ -0,0 +1,9 @@
+import type { BridgeSendMessageParams, BridgeSendResult } from '../../domain/bridge-api.js';
+import type { BridgeRunParams, BridgeRunResult, LoopConfig, RunEvent, TaskConfig } from '../orchestration/run/types.js';
+import type { BridgeWithFabric } from './fabric-bridge-types.js';
+type SendFn = (params: BridgeSendMessageParams) => Promise<BridgeSendResult>;
+type RunEventSink = (event: RunEvent) => void | Promise<void>;
+export declare function bridgeRun(sendFn: SendFn, bridgeLoop: LoopConfig | undefined, bridgeTasks: TaskConfig | undefined, params: BridgeRunParams, fabricBridge?: BridgeWithFabric, onRunEvent?: RunEventSink): Promise<BridgeRunResult>;
+export declare function bridgeRunStream(sendFn: SendFn, bridgeLoop: LoopConfig | undefined, bridgeTasks: TaskConfig | undefined, params: BridgeRunParams, fabricBridge?: BridgeWithFabric, onRunEvent?: RunEventSink): AsyncGenerator<RunEvent>;
+export {};
+//# sourceMappingURL=run-support.d.ts.map

package/dist/runtime/bridge/run-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-support.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/run-support.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AAWpC,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAGf,UAAU,EACV,QAAQ,EAGR,UAAU,EACX,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,KAAK,MAAM,GAAG,CAAC,MAAM,EAAE,uBAAuB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAC7E,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AA2I9D,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,WAAW,EAAE,UAAU,GAAG,SAAS,EACnC,MAAM,EAAE,eAAe,EACvB,YAAY,CAAC,EAAE,gBAAgB,EAC/B,UAAU,CAAC,EAAE,YAAY,GACxB,OAAO,CAAC,eAAe,CAAC,CAsB1B;AAED,wBAAuB,eAAe,CACpC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,WAAW,EAAE,UAAU,GAAG,SAAS,EACnC,MAAM,EAAE,eAAe,EACvB,YAAY,CAAC,EAAE,gBAAgB,EAC/B,UAAU,CAAC,EAAE,YAAY,GACxB,cAAc,CAAC,QAAQ,CAAC,CAoB1B"}