octoflow-core 1.0.0

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

@@ -0,0 +1,94 @@
+import { OctoFlowError } from "../../domain/errors/base.js";
+const RESERVED_PREFIX_PERMISSIONS = /* @__PURE__ */ new Map([
+  ["bridge.", /* @__PURE__ */ new Set(["bridge-runtime"])],
+  ["task.", /* @__PURE__ */ new Set(["bridge-runtime", "tool"])],
+  ["pack.", /* @__PURE__ */ new Set(["bridge-runtime", "pack"])],
+  ["mesh.", /* @__PURE__ */ new Set(["bridge-runtime", "mesh"])]
+]);
+class TopicPayloadError extends OctoFlowError {
+  constructor(topic, size, max) {
+    super(
+      "TOPIC_PAYLOAD",
+      `Payload for topic '${topic}' is ${size} bytes, exceeding limit of ${max}`,
+      { topic, size, max }
+    );
+    this.name = "TopicPayloadError";
+  }
+}
+class TopicRateLimitError extends OctoFlowError {
+  constructor(topic) {
+    super("TOPIC_RATE_LIMIT", `Rate limit exceeded for topic '${topic}'`, {
+      topic
+    });
+    this.name = "TopicRateLimitError";
+  }
+}
+class TopicReservedError extends OctoFlowError {
+  topic;
+  publisher;
+  constructor(topic, publisher) {
+    super(
+      "TOPIC_RESERVED",
+      `Publisher '${publisher}' is not allowed to publish to reserved topic '${topic}'`,
+      { topic, publisher }
+    );
+    this.name = "TopicReservedError";
+    this.topic = topic;
+    this.publisher = publisher;
+  }
+}
+class TopicTimeoutError extends OctoFlowError {
+  topic;
+  waitedMs;
+  constructor(topic, waitedMs) {
+    super(
+      "TOPIC_TIMEOUT",
+      `Timed out waiting for topic '${topic}' after ${waitedMs}ms`,
+      { topic, waitedMs }
+    );
+    this.name = "TopicTimeoutError";
+    this.topic = topic;
+    this.waitedMs = waitedMs;
+  }
+}
+class TopicReplayDisabledError extends OctoFlowError {
+  constructor(topic) {
+    super(
+      "TOPIC_REPLAY_DISABLED",
+      `Replay is disabled; cannot read buffer for topic '${topic}'`,
+      { topic }
+    );
+    this.name = "TopicReplayDisabledError";
+  }
+}
+class TopicSchemaError extends OctoFlowError {
+  topic;
+  issues;
+  constructor(topic, issues) {
+    super(
+      "TOPIC_SCHEMA",
+      `Schema validation failed for topic '${topic}': ${issues.join("; ")}`,
+      { topic, issues }
+    );
+    this.name = "TopicSchemaError";
+    this.topic = topic;
+    this.issues = issues;
+  }
+}
+class TopicChannelClosedError extends OctoFlowError {
+  constructor() {
+    super("TOPIC_CHANNEL_CLOSED", "TopicChannel has been closed");
+    this.name = "TopicChannelClosedError";
+  }
+}
+export {
+  RESERVED_PREFIX_PERMISSIONS,
+  TopicChannelClosedError,
+  TopicPayloadError,
+  TopicRateLimitError,
+  TopicReplayDisabledError,
+  TopicReservedError,
+  TopicSchemaError,
+  TopicTimeoutError
+};
+//# sourceMappingURL=topic-types.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/topic-types.ts"],
+  "sourcesContent": ["/**\n * Types and error classes for the TopicChannel generic pub/sub layer.\n *\n * TopicChannel is a separate, open coordination bus adjacent to the sealed\n * BridgeEventEmitter. See for design rationale.\n */\n\nimport { OctoFlowError } from '../../domain/errors/base.js';\n\nexport type JsonValue =\n  | null\n  | boolean\n  | number\n  | string\n  | JsonValue[]\n  | { [k: string]: JsonValue };\n\nexport type TopicScope = 'bridge' | 'pack' | 'task';\n\nexport type TopicPublisher =\n  | 'user'\n  | 'tool'\n  | 'pack'\n  | 'plugin'\n  | 'bridge-runtime'\n  | 'mesh';\n\n/**\n * Which publishers are allowed to write to each reserved prefix.\n *\n * `bridge.*`  \u2014 only `bridge-runtime`\n * `task.*`    \u2014 only `bridge-runtime` and `tool`\n * `pack.*`    \u2014 only `bridge-runtime` and `pack`\n * `mesh.*`    \u2014 only `bridge-runtime` and `mesh` (AgentMesh runtime)\n *\n * Unreserved prefixes (`tool.*`, `user.*`, `agent.*`, `plugin.*`, `webhook.*`)\n * are open to all publishers \u2014 naming is by convention.\n */\nexport const RESERVED_PREFIX_PERMISSIONS: ReadonlyMap<\n  string,\n  ReadonlySet<TopicPublisher>\n> = new Map([\n  ['bridge.', new Set<TopicPublisher>(['bridge-runtime'])],\n  ['task.', new Set<TopicPublisher>(['bridge-runtime', 'tool'])],\n  ['pack.', new Set<TopicPublisher>(['bridge-runtime', 'pack'])],\n  ['mesh.', new Set<TopicPublisher>(['bridge-runtime', 'mesh'])],\n]);\n\nexport interface TopicMeta {\n  readonly publishedAtMs: number;\n  readonly publisher: TopicPublisher;\n  readonly correlationId?: string;\n  readonly scopeId?: string;\n  /** Reserved for v2 propagation \u2014 always undefined in v1. */\n  readonly hopLimit?: number;\n  /** Reserved for v2 propagation \u2014 always undefined in v1. */\n  readonly causationId?: string;\n  /** Reserved for v2 propagation \u2014 always undefined in v1. */\n  readonly originBridgeId?: string;\n}\n\nexport interface TopicEvent {\n  readonly id: string;\n  readonly topic: string;\n  readonly payload: JsonValue;\n  readonly meta: TopicMeta;\n}\n\nexport type TopicHandler = (\n  event: Readonly<TopicEvent>\n) => void | Promise<void>;\n\nexport interface TopicEmitOptions {\n  /** Publisher attribution. Default: `'user'`. Runtime sets this automatically for elevated callers. */\n  publisher?: TopicPublisher;\n  correlationId?: string;\n}\n\nexport interface PublishAndWaitOptions extends TopicEmitOptions {\n  timeoutMs?: number;\n}\n\nexport interface TopicWaitForOptions {\n  timeoutMs?: number;\n}\n\nexport interface PublishResult {\n  ok: boolean;\n  handlerCount: number;\n  errors: Array<{ handler: string; error: unknown }>;\n}\n\nexport type TopicDiagnosticKind =\n  | 'rate-limited'\n  | 'reentrancy-dropped'\n  | 'handler-error'\n  | 'queue-overflow'\n  | 'replay-evicted';\n\nexport interface TopicDiagnostic {\n  kind: TopicDiagnosticKind;\n  topic: string;\n  detail: string;\n  timestamp: number;\n}\n\nexport interface TopicChannelOptions {\n  /** Maximum payload size in bytes (JSON.stringify length). Default: 65536. */\n  maxPayloadBytes?: number;\n  /** Rate limiting configuration. */\n  rateLimit?: { publishesPerSec?: number; bytesPerSec?: number };\n  /** Replay buffer. Default: disabled (false). */\n  replay?: false | { maxEvents?: number; maxBytes?: number; maxAgeMs?: number };\n  /** Handler delivery mode. Default: 'parallel'. */\n  delivery?: 'parallel' | 'serial-per-topic';\n  /** Overflow strategy for rate-limited events. Default: `{ strategy: 'drop' }`. */\n  overflow?: { strategy: 'drop' | 'queue'; maxQueueSize?: number };\n  /** Structured diagnostic callback for monitoring rate limits, errors, drops. */\n  onDiagnostic?: (event: TopicDiagnostic) => void;\n  /** Pre-registered Zod-compatible schemas keyed by topic. */\n  schemas?: Map<string, TopicSchema>;\n}\n\n/**\n * Minimal Zod-compatible shape accepted by TopicChannel schema validation.\n * Avoids a hard runtime dependency on Zod for users who don't use schemas.\n * Any Zod schema satisfies this interface.\n */\nexport interface TopicSchema {\n  safeParse(\n    data: unknown\n  ):\n    | { success: true; data: unknown }\n    | { success: false; error: { issues: Array<{ message: string }> } };\n}\n\nexport class TopicPayloadError extends OctoFlowError {\n  constructor(topic: string, size: number, max: number) {\n    super(\n      'TOPIC_PAYLOAD',\n      `Payload for topic '${topic}' is ${size} bytes, exceeding limit of ${max}`,\n      { topic, size, max }\n    );\n    this.name = 'TopicPayloadError';\n  }\n}\n\nexport class TopicRateLimitError extends OctoFlowError {\n  constructor(topic: string) {\n    super('TOPIC_RATE_LIMIT', `Rate limit exceeded for topic '${topic}'`, {\n      topic,\n    });\n    this.name = 'TopicRateLimitError';\n  }\n}\n\nexport class TopicReservedError extends OctoFlowError {\n  readonly topic: string;\n  readonly publisher: TopicPublisher;\n  constructor(topic: string, publisher: TopicPublisher) {\n    super(\n      'TOPIC_RESERVED',\n      `Publisher '${publisher}' is not allowed to publish to reserved topic '${topic}'`,\n      { topic, publisher }\n    );\n    this.name = 'TopicReservedError';\n    this.topic = topic;\n    this.publisher = publisher;\n  }\n}\n\nexport class TopicTimeoutError extends OctoFlowError {\n  readonly topic: string;\n  readonly waitedMs: number;\n  constructor(topic: string, waitedMs: number) {\n    super(\n      'TOPIC_TIMEOUT',\n      `Timed out waiting for topic '${topic}' after ${waitedMs}ms`,\n      { topic, waitedMs }\n    );\n    this.name = 'TopicTimeoutError';\n    this.topic = topic;\n    this.waitedMs = waitedMs;\n  }\n}\n\nexport class TopicReplayDisabledError extends OctoFlowError {\n  constructor(topic: string) {\n    super(\n      'TOPIC_REPLAY_DISABLED',\n      `Replay is disabled; cannot read buffer for topic '${topic}'`,\n      { topic }\n    );\n    this.name = 'TopicReplayDisabledError';\n  }\n}\n\nexport class TopicSchemaError extends OctoFlowError {\n  readonly topic: string;\n  readonly issues: string[];\n  constructor(topic: string, issues: string[]) {\n    super(\n      'TOPIC_SCHEMA',\n      `Schema validation failed for topic '${topic}': ${issues.join('; ')}`,\n      { topic, issues }\n    );\n    this.name = 'TopicSchemaError';\n    this.topic = topic;\n    this.issues = issues;\n  }\n}\n\nexport class TopicChannelClosedError extends OctoFlowError {\n  constructor() {\n    super('TOPIC_CHANNEL_CLOSED', 'TopicChannel has been closed');\n    this.name = 'TopicChannelClosedError';\n  }\n}\n"],
+  "mappings": "AAOA,SAAS,qBAAqB;AA+BvB,MAAM,8BAGT,oBAAI,IAAI;AAAA,EACV,CAAC,WAAW,oBAAI,IAAoB,CAAC,gBAAgB,CAAC,CAAC;AAAA,EACvD,CAAC,SAAS,oBAAI,IAAoB,CAAC,kBAAkB,MAAM,CAAC,CAAC;AAAA,EAC7D,CAAC,SAAS,oBAAI,IAAoB,CAAC,kBAAkB,MAAM,CAAC,CAAC;AAAA,EAC7D,CAAC,SAAS,oBAAI,IAAoB,CAAC,kBAAkB,MAAM,CAAC,CAAC;AAC/D,CAAC;AA0FM,MAAM,0BAA0B,cAAc;AAAA,EACnD,YAAY,OAAe,MAAc,KAAa;AACpD;AAAA,MACE;AAAA,MACA,sBAAsB,KAAK,QAAQ,IAAI,8BAA8B,GAAG;AAAA,MACxE,EAAE,OAAO,MAAM,IAAI;AAAA,IACrB;AACA,SAAK,OAAO;AAAA,EACd;AACF;AAEO,MAAM,4BAA4B,cAAc;AAAA,EACrD,YAAY,OAAe;AACzB,UAAM,oBAAoB,kCAAkC,KAAK,KAAK;AAAA,MACpE;AAAA,IACF,CAAC;AACD,SAAK,OAAO;AAAA,EACd;AACF;AAEO,MAAM,2BAA2B,cAAc;AAAA,EAC3C;AAAA,EACA;AAAA,EACT,YAAY,OAAe,WAA2B;AACpD;AAAA,MACE;AAAA,MACA,cAAc,SAAS,kDAAkD,KAAK;AAAA,MAC9E,EAAE,OAAO,UAAU;AAAA,IACrB;AACA,SAAK,OAAO;AACZ,SAAK,QAAQ;AACb,SAAK,YAAY;AAAA,EACnB;AACF;AAEO,MAAM,0BAA0B,cAAc;AAAA,EAC1C;AAAA,EACA;AAAA,EACT,YAAY,OAAe,UAAkB;AAC3C;AAAA,MACE;AAAA,MACA,gCAAgC,KAAK,WAAW,QAAQ;AAAA,MACxD,EAAE,OAAO,SAAS;AAAA,IACpB;AACA,SAAK,OAAO;AACZ,SAAK,QAAQ;AACb,SAAK,WAAW;AAAA,EAClB;AACF;AAEO,MAAM,iCAAiC,cAAc;AAAA,EAC1D,YAAY,OAAe;AACzB;AAAA,MACE;AAAA,MACA,qDAAqD,KAAK;AAAA,MAC1D,EAAE,MAAM;AAAA,IACV;AACA,SAAK,OAAO;AAAA,EACd;AACF;AAEO,MAAM,yBAAyB,cAAc;AAAA,EACzC;AAAA,EACA;AAAA,EACT,YAAY,OAAe,QAAkB;AAC3C;AAAA,MACE;AAAA,MACA,uCAAuC,KAAK,MAAM,OAAO,KAAK,IAAI,CAAC;AAAA,MACnE,EAAE,OAAO,OAAO;AAAA,IAClB;AACA,SAAK,OAAO;AACZ,SAAK,QAAQ;AACb,SAAK,SAAS;AAAA,EAChB;AACF;AAEO,MAAM,gCAAgC,cAAc;AAAA,EACzD,cAAc;AACZ,UAAM,wBAAwB,8BAA8B;AAC5D,SAAK,OAAO;AAAA,EACd;AACF;",
+  "names": []
+}

package/dist/runtime/bridge/verbose-logger.d.ts

@@ -0,0 +1,7 @@
+import type { BridgeEventEmitter } from './events.js';
+type BridgeVerboseMode = 'actions' | 'all';
+type StderrWriter = (chunk: string) => void;
+export declare function resolveBridgeVerboseMode(verbose: boolean | BridgeVerboseMode | undefined, envValue?: string | undefined): BridgeVerboseMode | undefined;
+export declare function attachVerboseLogger(events: Pick<BridgeEventEmitter, 'on'>, mode: BridgeVerboseMode, writer?: StderrWriter): () => void;
+export {};
+//# sourceMappingURL=verbose-logger.d.ts.map

package/dist/runtime/bridge/verbose-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbose-logger.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/verbose-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,KAAK,iBAAiB,GAAG,SAAS,GAAG,KAAK,CAAC;AAE3C,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAkB5C,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,EAChD,QAAQ,qBAA6B,GACpC,iBAAiB,GAAG,SAAS,CA6B/B;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,EACtC,IAAI,EAAE,iBAAiB,EACvB,MAAM,GAAE,YAEP,GACA,MAAM,IAAI,CA4DZ"}

package/dist/runtime/bridge/verbose-logger.js

@@ -0,0 +1,100 @@
+function formatArgs(args) {
+  return JSON.stringify(args);
+}
+function formatDuration(durationMs) {
+  if (durationMs >= 1e3) {
+    return `${(durationMs / 1e3).toFixed(1)}s`;
+  }
+  return `${durationMs}ms`;
+}
+function writeLine(writer, line) {
+  writer(`${line}
+`);
+}
+function resolveBridgeVerboseMode(verbose, envValue = process.env.BRIDGE_VERBOSE) {
+  if (verbose === false) {
+    return void 0;
+  }
+  if (verbose === true || verbose === "actions") {
+    return "actions";
+  }
+  if (verbose === "all") {
+    return "all";
+  }
+  const normalized = envValue?.trim().toLowerCase();
+  if (normalized == null || normalized === "" || normalized === "0" || normalized === "false" || normalized === "off") {
+    return void 0;
+  }
+  if (normalized === "all") {
+    return "all";
+  }
+  if (normalized === "1" || normalized === "true" || normalized === "actions") {
+    return "actions";
+  }
+  return void 0;
+}
+function attachVerboseLogger(events, mode, writer = (chunk) => {
+  process.stderr.write(chunk);
+}) {
+  const unsubs = [];
+  if (mode === "all") {
+    unsubs.push(
+      events.on("backend:selected", (event) => {
+        writeLine(
+          writer,
+          `[bridge] backend:selected -> ${event.backend} (context: ${event.contextId})`
+        );
+      })
+    );
+    unsubs.push(
+      events.on("tool:delivered", (event) => {
+        writeLine(
+          writer,
+          `[bridge] tool:delivered -> ${event.strategy} (${event.toolCount} tools, task: ${event.taskId})`
+        );
+      })
+    );
+    unsubs.push(
+      events.on("tool:degraded", (event) => {
+        writeLine(
+          writer,
+          `[bridge] tool:degraded -> ${event.reason} (${event.tools.join(", ")}) [task: ${event.taskId}]`
+        );
+      })
+    );
+  }
+  unsubs.push(
+    events.on("action:invoked", (event) => {
+      writeLine(
+        writer,
+        `[bridge] action:invoked -> ${event.actionName}(${formatArgs(event.args)}) [task: ${event.taskId}]`
+      );
+    })
+  );
+  unsubs.push(
+    events.on("action:result", (event) => {
+      writeLine(
+        writer,
+        `[bridge] action:result -> ${event.actionName} (${formatDuration(event.durationMs)}) [task: ${event.taskId}]`
+      );
+    })
+  );
+  unsubs.push(
+    events.on("action:error", (event) => {
+      writeLine(
+        writer,
+        `[bridge] action:error -> ${event.actionName}: ${event.error.message} (${formatDuration(event.durationMs)}) [task: ${event.taskId}]`
+      );
+    })
+  );
+  return () => {
+    for (const unsub of unsubs) {
+      unsub();
+    }
+  };
+}
+export {
+  attachVerboseLogger,
+  resolveBridgeVerboseMode
+};
+//# sourceMappingURL=verbose-logger.js.map

package/dist/runtime/bridge/verbose-logger.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/verbose-logger.ts"],
+  "sourcesContent": ["import type { BridgeEventEmitter } from './events.js';\n\ntype BridgeVerboseMode = 'actions' | 'all';\n\ntype StderrWriter = (chunk: string) => void;\n\nfunction formatArgs(args: Record<string, unknown>): string {\n  return JSON.stringify(args);\n}\n\nfunction formatDuration(durationMs: number): string {\n  if (durationMs >= 1_000) {\n    return `${(durationMs / 1_000).toFixed(1)}s`;\n  }\n\n  return `${durationMs}ms`;\n}\n\nfunction writeLine(writer: StderrWriter, line: string): void {\n  writer(`${line}\\n`);\n}\n\nexport function resolveBridgeVerboseMode(\n  verbose: boolean | BridgeVerboseMode | undefined,\n  envValue = process.env.BRIDGE_VERBOSE\n): BridgeVerboseMode | undefined {\n  if (verbose === false) {\n    return undefined;\n  }\n  if (verbose === true || verbose === 'actions') {\n    return 'actions';\n  }\n  if (verbose === 'all') {\n    return 'all';\n  }\n\n  const normalized = envValue?.trim().toLowerCase();\n  if (\n    normalized == null ||\n    normalized === '' ||\n    normalized === '0' ||\n    normalized === 'false' ||\n    normalized === 'off'\n  ) {\n    return undefined;\n  }\n  if (normalized === 'all') {\n    return 'all';\n  }\n  if (normalized === '1' || normalized === 'true' || normalized === 'actions') {\n    return 'actions';\n  }\n\n  return undefined;\n}\n\nexport function attachVerboseLogger(\n  events: Pick<BridgeEventEmitter, 'on'>,\n  mode: BridgeVerboseMode,\n  writer: StderrWriter = (chunk) => {\n    process.stderr.write(chunk);\n  }\n): () => void {\n  const unsubs: Array<() => void> = [];\n\n  if (mode === 'all') {\n    unsubs.push(\n      events.on('backend:selected', (event) => {\n        writeLine(\n          writer,\n          `[bridge] backend:selected -> ${event.backend} (context: ${event.contextId})`\n        );\n      })\n    );\n    unsubs.push(\n      events.on('tool:delivered', (event) => {\n        writeLine(\n          writer,\n          `[bridge] tool:delivered -> ${event.strategy} (${event.toolCount} tools, task: ${event.taskId})`\n        );\n      })\n    );\n    unsubs.push(\n      events.on('tool:degraded', (event) => {\n        writeLine(\n          writer,\n          `[bridge] tool:degraded -> ${event.reason} (${event.tools.join(', ')}) [task: ${event.taskId}]`\n        );\n      })\n    );\n  }\n\n  unsubs.push(\n    events.on('action:invoked', (event) => {\n      writeLine(\n        writer,\n        `[bridge] action:invoked -> ${event.actionName}(${formatArgs(event.args)}) [task: ${event.taskId}]`\n      );\n    })\n  );\n  unsubs.push(\n    events.on('action:result', (event) => {\n      writeLine(\n        writer,\n        `[bridge] action:result -> ${event.actionName} (${formatDuration(event.durationMs)}) [task: ${event.taskId}]`\n      );\n    })\n  );\n  unsubs.push(\n    events.on('action:error', (event) => {\n      writeLine(\n        writer,\n        `[bridge] action:error -> ${event.actionName}: ${event.error.message} (${formatDuration(event.durationMs)}) [task: ${event.taskId}]`\n      );\n    })\n  );\n\n  return () => {\n    for (const unsub of unsubs) {\n      unsub();\n    }\n  };\n}\n"],
+  "mappings": "AAMA,SAAS,WAAW,MAAuC;AACzD,SAAO,KAAK,UAAU,IAAI;AAC5B;AAEA,SAAS,eAAe,YAA4B;AAClD,MAAI,cAAc,KAAO;AACvB,WAAO,IAAI,aAAa,KAAO,QAAQ,CAAC,CAAC;AAAA,EAC3C;AAEA,SAAO,GAAG,UAAU;AACtB;AAEA,SAAS,UAAU,QAAsB,MAAoB;AAC3D,SAAO,GAAG,IAAI;AAAA,CAAI;AACpB;AAEO,SAAS,yBACd,SACA,WAAW,QAAQ,IAAI,gBACQ;AAC/B,MAAI,YAAY,OAAO;AACrB,WAAO;AAAA,EACT;AACA,MAAI,YAAY,QAAQ,YAAY,WAAW;AAC7C,WAAO;AAAA,EACT;AACA,MAAI,YAAY,OAAO;AACrB,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,UAAU,KAAK,EAAE,YAAY;AAChD,MACE,cAAc,QACd,eAAe,MACf,eAAe,OACf,eAAe,WACf,eAAe,OACf;AACA,WAAO;AAAA,EACT;AACA,MAAI,eAAe,OAAO;AACxB,WAAO;AAAA,EACT;AACA,MAAI,eAAe,OAAO,eAAe,UAAU,eAAe,WAAW;AAC3E,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEO,SAAS,oBACd,QACA,MACA,SAAuB,CAAC,UAAU;AAChC,UAAQ,OAAO,MAAM,KAAK;AAC5B,GACY;AACZ,QAAM,SAA4B,CAAC;AAEnC,MAAI,SAAS,OAAO;AAClB,WAAO;AAAA,MACL,OAAO,GAAG,oBAAoB,CAAC,UAAU;AACvC;AAAA,UACE;AAAA,UACA,gCAAgC,MAAM,OAAO,cAAc,MAAM,SAAS;AAAA,QAC5E;AAAA,MACF,CAAC;AAAA,IACH;AACA,WAAO;AAAA,MACL,OAAO,GAAG,kBAAkB,CAAC,UAAU;AACrC;AAAA,UACE;AAAA,UACA,8BAA8B,MAAM,QAAQ,KAAK,MAAM,SAAS,iBAAiB,MAAM,MAAM;AAAA,QAC/F;AAAA,MACF,CAAC;AAAA,IACH;AACA,WAAO;AAAA,MACL,OAAO,GAAG,iBAAiB,CAAC,UAAU;AACpC;AAAA,UACE;AAAA,UACA,6BAA6B,MAAM,MAAM,KAAK,MAAM,MAAM,KAAK,IAAI,CAAC,YAAY,MAAM,MAAM;AAAA,QAC9F;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,GAAG,kBAAkB,CAAC,UAAU;AACrC;AAAA,QACE;AAAA,QACA,8BAA8B,MAAM,UAAU,IAAI,WAAW,MAAM,IAAI,CAAC,YAAY,MAAM,MAAM;AAAA,MAClG;AAAA,IACF,CAAC;AAAA,EACH;AACA,SAAO;AAAA,IACL,OAAO,GAAG,iBAAiB,CAAC,UAAU;AACpC;AAAA,QACE;AAAA,QACA,6BAA6B,MAAM,UAAU,KAAK,eAAe,MAAM,UAAU,CAAC,YAAY,MAAM,MAAM;AAAA,MAC5G;AAAA,IACF,CAAC;AAAA,EACH;AACA,SAAO;AAAA,IACL,OAAO,GAAG,gBAAgB,CAAC,UAAU;AACnC;AAAA,QACE;AAAA,QACA,4BAA4B,MAAM,UAAU,KAAK,MAAM,MAAM,OAAO,KAAK,eAAe,MAAM,UAAU,CAAC,YAAY,MAAM,MAAM;AAAA,MACnI;AAAA,IACF,CAAC;AAAA,EACH;AAEA,SAAO,MAAM;AACX,eAAW,SAAS,QAAQ;AAC1B,YAAM;AAAA,IACR;AAAA,EACF;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,20 @@
+export declare const BRIDGE_WARNING_CODES: {
+    readonly FLOW_CONTEXT_TRUNCATED: "FLOW_CONTEXT_TRUNCATED";
+    readonly AGENT_LOOP_AUTO_ENABLED: "AGENT_LOOP_AUTO_ENABLED";
+    readonly APPROVAL_CALLBACK_WILL_NOT_FIRE: "APPROVAL_CALLBACK_WILL_NOT_FIRE";
+    readonly BROAD_TOOL_SURFACE: "BROAD_TOOL_SURFACE";
+    readonly CACHE_PREFIX_UNSTABLE: "CACHE_PREFIX_UNSTABLE";
+    readonly CONTEXT_SECTIONS_OVERFLOW: "CONTEXT_SECTIONS_OVERFLOW";
+    readonly CONTEXT_SUMMARY_FAILED: "CONTEXT_SUMMARY_FAILED";
+    readonly INVALID_MCP_SERVER: "INVALID_MCP_SERVER";
+    readonly LIKELY_MISSING_CREDENTIALS: "LIKELY_MISSING_CREDENTIALS";
+    readonly LOOP_DEFAULT_APPLIED: "LOOP_DEFAULT_APPLIED";
+    readonly MCP_SERVERS_DROPPED: "MCP_SERVERS_DROPPED";
+    readonly NO_BACKENDS_CONFIGURED: "NO_BACKENDS_CONFIGURED";
+    readonly PERMISSION_PRESET_WILL_NOT_FIRE: "PERMISSION_PRESET_WILL_NOT_FIRE";
+    readonly SKILL_UNKNOWN_ACTIONS: "SKILL_UNKNOWN_ACTIONS";
+    readonly TIKTOKEN_UNAVAILABLE: "TIKTOKEN_UNAVAILABLE";
+    readonly TOOLS_MAY_NOT_BE_SUPPORTED: "TOOLS_MAY_NOT_BE_SUPPORTED";
+    readonly UNSUPPORTED_FEATURE_FOR_BACKEND: "UNSUPPORTED_FEATURE_FOR_BACKEND";
+};
+//# sourceMappingURL=warnings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/warnings.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;CAkBvB,CAAC"}

package/dist/runtime/bridge/warnings.js

@@ -0,0 +1,23 @@
+const BRIDGE_WARNING_CODES = {
+  FLOW_CONTEXT_TRUNCATED: "FLOW_CONTEXT_TRUNCATED",
+  AGENT_LOOP_AUTO_ENABLED: "AGENT_LOOP_AUTO_ENABLED",
+  APPROVAL_CALLBACK_WILL_NOT_FIRE: "APPROVAL_CALLBACK_WILL_NOT_FIRE",
+  BROAD_TOOL_SURFACE: "BROAD_TOOL_SURFACE",
+  CACHE_PREFIX_UNSTABLE: "CACHE_PREFIX_UNSTABLE",
+  CONTEXT_SECTIONS_OVERFLOW: "CONTEXT_SECTIONS_OVERFLOW",
+  CONTEXT_SUMMARY_FAILED: "CONTEXT_SUMMARY_FAILED",
+  INVALID_MCP_SERVER: "INVALID_MCP_SERVER",
+  LIKELY_MISSING_CREDENTIALS: "LIKELY_MISSING_CREDENTIALS",
+  LOOP_DEFAULT_APPLIED: "LOOP_DEFAULT_APPLIED",
+  MCP_SERVERS_DROPPED: "MCP_SERVERS_DROPPED",
+  NO_BACKENDS_CONFIGURED: "NO_BACKENDS_CONFIGURED",
+  PERMISSION_PRESET_WILL_NOT_FIRE: "PERMISSION_PRESET_WILL_NOT_FIRE",
+  SKILL_UNKNOWN_ACTIONS: "SKILL_UNKNOWN_ACTIONS",
+  TIKTOKEN_UNAVAILABLE: "TIKTOKEN_UNAVAILABLE",
+  TOOLS_MAY_NOT_BE_SUPPORTED: "TOOLS_MAY_NOT_BE_SUPPORTED",
+  UNSUPPORTED_FEATURE_FOR_BACKEND: "UNSUPPORTED_FEATURE_FOR_BACKEND"
+};
+export {
+  BRIDGE_WARNING_CODES
+};
+//# sourceMappingURL=warnings.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/warnings.ts"],
+  "sourcesContent": ["export const BRIDGE_WARNING_CODES = {\n  FLOW_CONTEXT_TRUNCATED: 'FLOW_CONTEXT_TRUNCATED',\n  AGENT_LOOP_AUTO_ENABLED: 'AGENT_LOOP_AUTO_ENABLED',\n  APPROVAL_CALLBACK_WILL_NOT_FIRE: 'APPROVAL_CALLBACK_WILL_NOT_FIRE',\n  BROAD_TOOL_SURFACE: 'BROAD_TOOL_SURFACE',\n  CACHE_PREFIX_UNSTABLE: 'CACHE_PREFIX_UNSTABLE',\n  CONTEXT_SECTIONS_OVERFLOW: 'CONTEXT_SECTIONS_OVERFLOW',\n  CONTEXT_SUMMARY_FAILED: 'CONTEXT_SUMMARY_FAILED',\n  INVALID_MCP_SERVER: 'INVALID_MCP_SERVER',\n  LIKELY_MISSING_CREDENTIALS: 'LIKELY_MISSING_CREDENTIALS',\n  LOOP_DEFAULT_APPLIED: 'LOOP_DEFAULT_APPLIED',\n  MCP_SERVERS_DROPPED: 'MCP_SERVERS_DROPPED',\n  NO_BACKENDS_CONFIGURED: 'NO_BACKENDS_CONFIGURED',\n  PERMISSION_PRESET_WILL_NOT_FIRE: 'PERMISSION_PRESET_WILL_NOT_FIRE',\n  SKILL_UNKNOWN_ACTIONS: 'SKILL_UNKNOWN_ACTIONS',\n  TIKTOKEN_UNAVAILABLE: 'TIKTOKEN_UNAVAILABLE',\n  TOOLS_MAY_NOT_BE_SUPPORTED: 'TOOLS_MAY_NOT_BE_SUPPORTED',\n  UNSUPPORTED_FEATURE_FOR_BACKEND: 'UNSUPPORTED_FEATURE_FOR_BACKEND',\n} as const;\n"],
+  "mappings": "AAAO,MAAM,uBAAuB;AAAA,EAClC,wBAAwB;AAAA,EACxB,yBAAyB;AAAA,EACzB,iCAAiC;AAAA,EACjC,oBAAoB;AAAA,EACpB,uBAAuB;AAAA,EACvB,2BAA2B;AAAA,EAC3B,wBAAwB;AAAA,EACxB,oBAAoB;AAAA,EACpB,4BAA4B;AAAA,EAC5B,sBAAsB;AAAA,EACtB,qBAAqB;AAAA,EACrB,wBAAwB;AAAA,EACxB,iCAAiC;AAAA,EACjC,uBAAuB;AAAA,EACvB,sBAAsB;AAAA,EACtB,4BAA4B;AAAA,EAC5B,iCAAiC;AACnC;",
+  "names": []
+}

package/dist/runtime/bridge/workflow-cleanup.d.ts

@@ -0,0 +1,20 @@
+import type { BridgeSendMessageParams, BridgeSendResult } from '../../domain/bridge-api.js';
+import { type WorkflowCronOptions, type WorkflowHandle } from './workflows/index.js';
+interface CreateWorkflowRegistryOptions {
+    sender: (params: BridgeSendMessageParams) => Promise<BridgeSendResult>;
+}
+interface AddBridgeWorkflowOptions {
+    context: string;
+    schedule: number | WorkflowCronOptions;
+    sender: (params: BridgeSendMessageParams) => Promise<BridgeSendResult>;
+    workflows: Set<WorkflowHandle>;
+}
+export interface WorkflowRegistry {
+    add(context: string, schedule: number | WorkflowCronOptions): WorkflowHandle;
+    stopAll(): Promise<void>;
+}
+export declare function createWorkflowRegistry(options: CreateWorkflowRegistryOptions): WorkflowRegistry;
+export declare function addBridgeWorkflow(options: AddBridgeWorkflowOptions): WorkflowHandle;
+export declare function stopBridgeWorkflows(workflows: Set<WorkflowHandle>): Promise<void>;
+export {};
+//# sourceMappingURL=workflow-cleanup.d.ts.map

package/dist/runtime/bridge/workflow-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-cleanup.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/workflow-cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAE9B,UAAU,6BAA6B;IACrC,MAAM,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACxE;AAED,UAAU,wBAAwB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACvC,MAAM,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvE,SAAS,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,cAAc,CAAC;IAC7E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,6BAA6B,GACrC,gBAAgB,CAgBlB;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,cAAc,CAWhB;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,GAAG,CAAC,cAAc,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/runtime/bridge/workflow-cleanup.js

@@ -0,0 +1,44 @@
+import {
+  createWorkflow
+} from "./workflows/index.js";
+function createWorkflowRegistry(options) {
+  const workflows = /* @__PURE__ */ new Set();
+  return {
+    add(context, schedule) {
+      return addBridgeWorkflow({
+        context,
+        schedule,
+        sender: options.sender,
+        workflows
+      });
+    },
+    stopAll() {
+      return stopBridgeWorkflows(workflows);
+    }
+  };
+}
+function addBridgeWorkflow(options) {
+  const workflow = createWorkflow({
+    context: options.context,
+    schedule: options.schedule,
+    sender: options.sender,
+    onStop: (stopped) => {
+      options.workflows.delete(stopped);
+    }
+  });
+  options.workflows.add(workflow);
+  return workflow;
+}
+function stopBridgeWorkflows(workflows) {
+  const active = [...workflows];
+  workflows.clear();
+  return Promise.all(active.map((workflow) => workflow.stop())).then(
+    () => void 0
+  );
+}
+export {
+  addBridgeWorkflow,
+  createWorkflowRegistry,
+  stopBridgeWorkflows
+};
+//# sourceMappingURL=workflow-cleanup.js.map

package/dist/runtime/bridge/workflow-cleanup.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/workflow-cleanup.ts"],
+  "sourcesContent": ["import type {\n  BridgeSendMessageParams,\n  BridgeSendResult,\n} from '../../domain/bridge-api.js';\nimport {\n  createWorkflow,\n  type WorkflowCronOptions,\n  type WorkflowHandle,\n} from './workflows/index.js';\n\ninterface CreateWorkflowRegistryOptions {\n  sender: (params: BridgeSendMessageParams) => Promise<BridgeSendResult>;\n}\n\ninterface AddBridgeWorkflowOptions {\n  context: string;\n  schedule: number | WorkflowCronOptions;\n  sender: (params: BridgeSendMessageParams) => Promise<BridgeSendResult>;\n  workflows: Set<WorkflowHandle>;\n}\n\nexport interface WorkflowRegistry {\n  add(context: string, schedule: number | WorkflowCronOptions): WorkflowHandle;\n  stopAll(): Promise<void>;\n}\n\nexport function createWorkflowRegistry(\n  options: CreateWorkflowRegistryOptions\n): WorkflowRegistry {\n  const workflows = new Set<WorkflowHandle>();\n\n  return {\n    add(context, schedule) {\n      return addBridgeWorkflow({\n        context,\n        schedule,\n        sender: options.sender,\n        workflows,\n      });\n    },\n    stopAll() {\n      return stopBridgeWorkflows(workflows);\n    },\n  };\n}\n\nexport function addBridgeWorkflow(\n  options: AddBridgeWorkflowOptions\n): WorkflowHandle {\n  const workflow = createWorkflow({\n    context: options.context,\n    schedule: options.schedule,\n    sender: options.sender,\n    onStop: (stopped) => {\n      options.workflows.delete(stopped);\n    },\n  });\n  options.workflows.add(workflow);\n  return workflow;\n}\n\nexport function stopBridgeWorkflows(\n  workflows: Set<WorkflowHandle>\n): Promise<void> {\n  const active = [...workflows];\n  workflows.clear();\n  return Promise.all(active.map((workflow) => workflow.stop())).then(\n    () => undefined\n  );\n}\n"],
+  "mappings": "AAIA;AAAA,EACE;AAAA,OAGK;AAkBA,SAAS,uBACd,SACkB;AAClB,QAAM,YAAY,oBAAI,IAAoB;AAE1C,SAAO;AAAA,IACL,IAAI,SAAS,UAAU;AACrB,aAAO,kBAAkB;AAAA,QACvB;AAAA,QACA;AAAA,QACA,QAAQ,QAAQ;AAAA,QAChB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IACA,UAAU;AACR,aAAO,oBAAoB,SAAS;AAAA,IACtC;AAAA,EACF;AACF;AAEO,SAAS,kBACd,SACgB;AAChB,QAAM,WAAW,eAAe;AAAA,IAC9B,SAAS,QAAQ;AAAA,IACjB,UAAU,QAAQ;AAAA,IAClB,QAAQ,QAAQ;AAAA,IAChB,QAAQ,CAAC,YAAY;AACnB,cAAQ,UAAU,OAAO,OAAO;AAAA,IAClC;AAAA,EACF,CAAC;AACD,UAAQ,UAAU,IAAI,QAAQ;AAC9B,SAAO;AACT;AAEO,SAAS,oBACd,WACe;AACf,QAAM,SAAS,CAAC,GAAG,SAAS;AAC5B,YAAU,MAAM;AAChB,SAAO,QAAQ,IAAI,OAAO,IAAI,CAAC,aAAa,SAAS,KAAK,CAAC,CAAC,EAAE;AAAA,IAC5D,MAAM;AAAA,EACR;AACF;",
+  "names": []
+}

package/dist/runtime/bridge/workflows/controller.d.ts

@@ -0,0 +1,11 @@
+import type { WorkflowCronOptions, WorkflowHandle, WorkflowSender } from './types.js';
+type WorkflowScheduleInput = number | WorkflowCronOptions;
+interface WorkflowControllerOptions {
+    context: string;
+    schedule: WorkflowScheduleInput;
+    sender: WorkflowSender;
+    onStop?: (workflow: WorkflowHandle) => void;
+}
+export declare function createWorkflow(options: WorkflowControllerOptions): WorkflowHandle;
+export {};
+//# sourceMappingURL=controller.d.ts.map

package/dist/runtime/bridge/workflows/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../src/runtime/bridge/workflows/controller.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EAEd,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,KAAK,qBAAqB,GAAG,MAAM,GAAG,mBAAmB,CAAC;AAE1D,UAAU,yBAAyB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;CAC7C;AA+MD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,yBAAyB,GACjC,cAAc,CAEhB"}

package/dist/runtime/bridge/workflows/controller.js

@@ -0,0 +1,178 @@
+import crypto from "node:crypto";
+import { mergeMetadata } from "../../../utils/metadata.js";
+import { nextCronDate, parseCronExpression } from "./schedule.js";
+function deferred() {
+  let resolve;
+  let reject;
+  const promise = new Promise((res, rej) => {
+    resolve = res;
+    reject = rej;
+  });
+  return { promise, reject, resolve };
+}
+function workflowMetadata(existing, input) {
+  return mergeMetadata(existing, {
+    workflow: {
+      id: input.id,
+      schedule: input.schedule,
+      cron: input.cron,
+      runNumber: input.runNumber
+    }
+  }) ?? {};
+}
+class WorkflowController {
+  id = crypto.randomUUID();
+  context;
+  schedule;
+  cron;
+  done;
+  firstRun = deferred();
+  onStop;
+  sender;
+  timeoutMs;
+  contextId;
+  tenant;
+  metadata;
+  onError;
+  timer;
+  inFlightController = null;
+  stopped = false;
+  firstRunSettled = false;
+  inFlight = null;
+  _lastTaskId = null;
+  _lastRunAt = null;
+  _nextRunAt = null;
+  _runCount = 0;
+  constructor(options) {
+    this.context = options.context;
+    this.sender = options.sender;
+    this.onStop = options.onStop;
+    this.done = this.firstRun.promise;
+    if (typeof options.schedule === "number") {
+      this.schedule = "once";
+      this.cron = null;
+      this.timeoutMs = options.schedule;
+      void this.runNow().catch(() => void 0);
+      return;
+    }
+    parseCronExpression(options.schedule.cron);
+    this.schedule = "cron";
+    this.cron = options.schedule.cron;
+    this.timeoutMs = options.schedule.timeoutMs;
+    this.contextId = options.schedule.contextId;
+    this.tenant = options.schedule.tenant;
+    this.metadata = options.schedule.metadata;
+    this.onError = options.schedule.onError;
+    if (options.schedule.immediate) {
+      void this.runNow().catch(() => void 0);
+    }
+    this.armNextCronRun();
+  }
+  get lastTaskId() {
+    return this._lastTaskId;
+  }
+  get lastRunAt() {
+    return this._lastRunAt;
+  }
+  get nextRunAt() {
+    return this._nextRunAt;
+  }
+  get runCount() {
+    return this._runCount;
+  }
+  async runNow() {
+    if (this.stopped) {
+      throw new Error(`Workflow ${this.id} is stopped`);
+    }
+    if (this.inFlight) {
+      return this.inFlight;
+    }
+    const runNumber = this._runCount + 1;
+    this._lastRunAt = (/* @__PURE__ */ new Date()).toISOString();
+    const controller = new AbortController();
+    this.inFlightController = controller;
+    this.inFlight = this.sender({
+      message: this.context,
+      timeoutMs: this.timeoutMs,
+      contextId: this.contextId,
+      tenant: this.tenant,
+      metadata: workflowMetadata(this.metadata, {
+        cron: this.cron,
+        id: this.id,
+        runNumber,
+        schedule: this.schedule
+      }),
+      onError: this.onError,
+      signal: controller.signal
+    }).then((result) => {
+      this._runCount = runNumber;
+      this._lastTaskId = result.kind === "task" ? result.taskId : null;
+      if (!this.firstRunSettled) {
+        this.firstRunSettled = true;
+        this.firstRun.resolve(result);
+      }
+      return result;
+    }).catch((error) => {
+      if (!this.firstRunSettled) {
+        this.firstRunSettled = true;
+        this.firstRun.reject(error);
+      }
+      throw error;
+    }).finally(() => {
+      this.inFlight = null;
+      if (this.inFlightController === controller) {
+        this.inFlightController = null;
+      }
+      if (!this.stopped && this.schedule === "cron") {
+        this.armNextCronRun();
+      }
+    });
+    return this.inFlight;
+  }
+  async stop() {
+    if (this.stopped) {
+      await this.waitForInFlight();
+      return;
+    }
+    this.stopped = true;
+    this.inFlightController?.abort(
+      new Error(`Workflow ${this.id} was stopped`)
+    );
+    if (this.timer) {
+      clearTimeout(this.timer);
+      this.timer = void 0;
+    }
+    this._nextRunAt = null;
+    this.onStop?.(this);
+    await this.waitForInFlight();
+  }
+  async waitForInFlight() {
+    if (!this.inFlight) return;
+    try {
+      await this.inFlight;
+    } catch {
+    }
+  }
+  armNextCronRun() {
+    if (this.stopped || this.schedule !== "cron" || !this.cron) return;
+    if (this.timer) {
+      clearTimeout(this.timer);
+      this.timer = void 0;
+    }
+    const next = nextCronDate(this.cron);
+    this._nextRunAt = next.toISOString();
+    const delayMs = Math.max(0, next.getTime() - Date.now());
+    this.timer = setTimeout(() => {
+      this.timer = void 0;
+      void this.runNow().catch(() => {
+      });
+    }, delayMs);
+  }
+}
+function createWorkflow(options) {
+  return new WorkflowController(options);
+}
+export {
+  createWorkflow
+};
+//# sourceMappingURL=controller.js.map

package/dist/runtime/bridge/workflows/controller.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/runtime/bridge/workflows/controller.ts"],
+  "sourcesContent": ["import crypto from 'node:crypto';\n\nimport type {\n  BridgeSendMessageParams,\n  BridgeSendResult,\n} from '../../../domain/bridge-api.js';\nimport type { BridgeMetadata } from '../../../domain/core-task.js';\nimport { mergeMetadata } from '../../../utils/metadata.js';\nimport { nextCronDate, parseCronExpression } from './schedule.js';\nimport type {\n  WorkflowCronOptions,\n  WorkflowHandle,\n  WorkflowSchedule,\n  WorkflowSender,\n} from './types.js';\n\ntype WorkflowScheduleInput = number | WorkflowCronOptions;\n\ninterface WorkflowControllerOptions {\n  context: string;\n  schedule: WorkflowScheduleInput;\n  sender: WorkflowSender;\n  onStop?: (workflow: WorkflowHandle) => void;\n}\n\ninterface Deferred<T> {\n  promise: Promise<T>;\n  reject(error: unknown): void;\n  resolve(value: T): void;\n}\n\nfunction deferred<T>(): Deferred<T> {\n  let resolve!: (value: T) => void;\n  let reject!: (error: unknown) => void;\n  const promise = new Promise<T>((res, rej) => {\n    resolve = res;\n    reject = rej;\n  });\n  return { promise, reject, resolve };\n}\n\nfunction workflowMetadata(\n  existing: BridgeMetadata | undefined,\n  input: {\n    cron: string | null;\n    id: string;\n    runNumber: number;\n    schedule: WorkflowSchedule;\n  }\n): BridgeMetadata {\n  return (\n    mergeMetadata(existing, {\n      workflow: {\n        id: input.id,\n        schedule: input.schedule,\n        cron: input.cron,\n        runNumber: input.runNumber,\n      },\n    }) ?? {}\n  );\n}\n\nclass WorkflowController implements WorkflowHandle {\n  readonly id = crypto.randomUUID();\n  readonly context: string;\n  readonly schedule: WorkflowSchedule;\n  readonly cron: string | null;\n  readonly done: Promise<BridgeSendResult>;\n  private readonly firstRun = deferred<BridgeSendResult>();\n  private readonly onStop?: (workflow: WorkflowHandle) => void;\n  private readonly sender: WorkflowSender;\n  private readonly timeoutMs?: number;\n  private readonly contextId?: string;\n  private readonly tenant?: string;\n  private readonly metadata?: BridgeMetadata;\n  private readonly onError?: BridgeSendMessageParams['onError'];\n  private timer?: ReturnType<typeof setTimeout>;\n  private inFlightController: AbortController | null = null;\n  private stopped = false;\n  private firstRunSettled = false;\n  private inFlight: Promise<BridgeSendResult> | null = null;\n  private _lastTaskId: string | null = null;\n  private _lastRunAt: string | null = null;\n  private _nextRunAt: string | null = null;\n  private _runCount = 0;\n\n  constructor(options: WorkflowControllerOptions) {\n    this.context = options.context;\n    this.sender = options.sender;\n    this.onStop = options.onStop;\n    this.done = this.firstRun.promise;\n\n    if (typeof options.schedule === 'number') {\n      this.schedule = 'once';\n      this.cron = null;\n      this.timeoutMs = options.schedule;\n      void this.runNow().catch(() => undefined);\n      return;\n    }\n\n    parseCronExpression(options.schedule.cron);\n    this.schedule = 'cron';\n    this.cron = options.schedule.cron;\n    this.timeoutMs = options.schedule.timeoutMs;\n    this.contextId = options.schedule.contextId;\n    this.tenant = options.schedule.tenant;\n    this.metadata = options.schedule.metadata;\n    this.onError = options.schedule.onError;\n\n    if (options.schedule.immediate) {\n      void this.runNow().catch(() => undefined);\n    }\n    this.armNextCronRun();\n  }\n\n  get lastTaskId(): string | null {\n    return this._lastTaskId;\n  }\n  get lastRunAt(): string | null {\n    return this._lastRunAt;\n  }\n  get nextRunAt(): string | null {\n    return this._nextRunAt;\n  }\n  get runCount(): number {\n    return this._runCount;\n  }\n\n  async runNow(): Promise<BridgeSendResult> {\n    if (this.stopped) {\n      throw new Error(`Workflow ${this.id} is stopped`);\n    }\n    if (this.inFlight) {\n      return this.inFlight;\n    }\n\n    const runNumber = this._runCount + 1;\n    this._lastRunAt = new Date().toISOString();\n    const controller = new AbortController();\n    this.inFlightController = controller;\n\n    this.inFlight = this.sender({\n      message: this.context,\n      timeoutMs: this.timeoutMs,\n      contextId: this.contextId,\n      tenant: this.tenant,\n      metadata: workflowMetadata(this.metadata, {\n        cron: this.cron,\n        id: this.id,\n        runNumber,\n        schedule: this.schedule,\n      }),\n      onError: this.onError,\n      signal: controller.signal,\n    })\n      .then((result) => {\n        this._runCount = runNumber;\n        this._lastTaskId = result.kind === 'task' ? result.taskId : null;\n        if (!this.firstRunSettled) {\n          this.firstRunSettled = true;\n          this.firstRun.resolve(result);\n        }\n        return result;\n      })\n      .catch((error) => {\n        if (!this.firstRunSettled) {\n          this.firstRunSettled = true;\n          this.firstRun.reject(error);\n        }\n        throw error;\n      })\n      .finally(() => {\n        this.inFlight = null;\n        if (this.inFlightController === controller) {\n          this.inFlightController = null;\n        }\n        if (!this.stopped && this.schedule === 'cron') {\n          this.armNextCronRun();\n        }\n      });\n\n    return this.inFlight;\n  }\n\n  async stop(): Promise<void> {\n    if (this.stopped) {\n      await this.waitForInFlight();\n      return;\n    }\n    this.stopped = true;\n    this.inFlightController?.abort(\n      new Error(`Workflow ${this.id} was stopped`)\n    );\n    if (this.timer) {\n      clearTimeout(this.timer);\n      this.timer = undefined;\n    }\n    this._nextRunAt = null;\n    this.onStop?.(this);\n    await this.waitForInFlight();\n  }\n\n  private async waitForInFlight(): Promise<void> {\n    if (!this.inFlight) return;\n    try {\n      await this.inFlight;\n    } catch {\n      // stop() is cleanup; the workflow's done/runNow promise carries failures.\n    }\n  }\n\n  private armNextCronRun(): void {\n    if (this.stopped || this.schedule !== 'cron' || !this.cron) return;\n    if (this.timer) {\n      clearTimeout(this.timer);\n      this.timer = undefined;\n    }\n\n    const next = nextCronDate(this.cron);\n    this._nextRunAt = next.toISOString();\n    const delayMs = Math.max(0, next.getTime() - Date.now());\n    this.timer = setTimeout(() => {\n      this.timer = undefined;\n      void this.runNow().catch(() => {\n        // The first-run promise and onError callback carry failures to callers.\n      });\n    }, delayMs);\n  }\n}\n\nexport function createWorkflow(\n  options: WorkflowControllerOptions\n): WorkflowHandle {\n  return new WorkflowController(options);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/bridge/workflows/index.d.ts

@@ -0,0 +1,4 @@
+export { createWorkflow } from './controller.js';
+export { nextCronDate, parseCronExpression } from './schedule.js';
+export type { WorkflowCronOptions, WorkflowHandle, WorkflowRunSnapshot, WorkflowSchedule, WorkflowSender, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/bridge/workflows/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/bridge/workflows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAClE,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/runtime/bridge/workflows/index.js

@@ -0,0 +1,8 @@
+import { createWorkflow } from "./controller.js";
+import { nextCronDate, parseCronExpression } from "./schedule.js";
+export {
+  createWorkflow,
+  nextCronDate,
+  parseCronExpression
+};
+//# sourceMappingURL=index.js.map

package/dist/runtime/bridge/workflows/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/runtime/bridge/workflows/index.ts"],
+  "sourcesContent": ["export { createWorkflow } from './controller.js';\nexport { nextCronDate, parseCronExpression } from './schedule.js';\nexport type {\n  WorkflowCronOptions,\n  WorkflowHandle,\n  WorkflowRunSnapshot,\n  WorkflowSchedule,\n  WorkflowSender,\n} from './types.js';\n"],
+  "mappings": "AAAA,SAAS,sBAAsB;AAC/B,SAAS,cAAc,2BAA2B;",
+  "names": []
+}