omp-fabric 0.85.0

package/dist/runtime/guest-stack-map.d.ts

@@ -0,0 +1,11 @@
+interface GuestSourcePosition {
+    line: number;
+    column: number;
+}
+export interface GuestStackMap {
+    lookup(line: number, column: number): GuestSourcePosition | undefined;
+}
+export declare const createGuestStackMap: (sourceMapText: string | undefined) => GuestStackMap | undefined;
+export declare const remapGuestErrorText: (text: string, stackMap: GuestStackMap | undefined, guestLineCount?: number) => string;
+export {};
+//# sourceMappingURL=guest-stack-map.d.ts.map

package/dist/runtime/guest-stack-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guest-stack-map.d.ts","sourceRoot":"","sources":["../../src/runtime/guest-stack-map.ts"],"names":[],"mappings":"AAKA,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;CACvE;AAgED,eAAO,MAAM,mBAAmB,GAC9B,eAAe,MAAM,GAAG,SAAS,KAChC,aAAa,GAAG,SAmClB,CAAC;AAIF,eAAO,MAAM,mBAAmB,GAC9B,MAAM,MAAM,EACZ,UAAU,aAAa,GAAG,SAAS,EACnC,iBAAiB,MAAM,KACtB,MAWF,CAAC"}

package/dist/runtime/guest-types.d.ts

@@ -0,0 +1,35 @@
+import type { FabricDynamicGuestDeclarations } from "../protocol.js";
+export declare const OMP_CORE_COMPATIBILITY_ARGUMENT_TYPE_NAMES: {
+    readonly read: "OmpReadCompatibilityArgument";
+    readonly bash: "OmpBashCompatibilityArgument";
+    readonly edit: "OmpEditCompatibilityArgument";
+    readonly write: "OmpWriteCompatibilityArgument";
+    readonly grep: "OmpGrepCompatibilityArgument";
+    readonly find: "OmpFindCompatibilityArgument";
+    readonly ls: "OmpLsCompatibilityArgument";
+};
+export declare const OMP_CORE_NUMERIC_FIELDS: {
+    readonly read: readonly ["offset", "limit"];
+    readonly bash: readonly ["timeout"];
+    readonly edit: readonly [];
+    readonly write: readonly [];
+    readonly grep: readonly ["context", "limit"];
+    readonly find: readonly ["limit"];
+    readonly ls: readonly ["limit"];
+};
+export declare const GUEST_TYPE_DECLARATIONS = "\ntype JsonPrimitive = string | number | boolean | null;\ntype JsonValue = JsonPrimitive | JsonValue[] | { [key: string]: JsonValue };\ntype FabricTransport = \"auto\" | \"process\" | \"tmux\" | \"screen\" | \"localterm\" | \"herdr\";\ntype FabricAgentRunner = \"omp\" | \"claude\" | \"veda\";\ntype FabricThinking = \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\";\ninterface FabricActionEffect {\n  kind: \"none\" | \"scoped\" | \"transactional\" | \"emission\";\n  resources?: string[];\n  ordering?: \"commutative\" | \"ordered\" | \"unknown\";\n}\ninterface FabricAction {\n  ref: string;\n  provider: string;\n  name: string;\n  description: string;\n  inputSchema: Record<string, unknown>;\n  outputSchema?: Record<string, unknown>;\n  risk: \"read\" | \"write\" | \"execute\" | \"network\" | \"agent\";\n  namespace?: string;\n  effect?: FabricActionEffect;\n}\ninterface FabricAgentRequest {\n  task: string;\n  name?: string;\n  runner?: FabricAgentRunner;\n  transport?: FabricTransport;\n  model?: string;\n  persona?: string;\n  thinking?: FabricThinking;\n  tools?: string[];\n  timeoutMs?: number;\n  extensions?: boolean;\n  recursive?: boolean;\n  /** Filesystem execution directory; relative paths resolve from the parent agent cwd. */\n  cwd?: string;\n  worktree?: boolean;\n  schema?: Record<string, unknown>;\n  prompt?: string;\n  instructions?: string;\n  timeout_ms?: number;\n  residency?: FabricParticipantResidency;\n}\ninterface FabricHandoffCall {\n  readonly ref: string;\n}\ninterface FabricHandoffFacts {\n  readonly calls: readonly FabricHandoffCall[];\n  count(ref?: string | readonly string[]): number;\n}\ntype FabricHandoffPredicate = (facts: Readonly<FabricHandoffFacts>) => boolean;\ninterface FabricHandoffRequest {\n  model: string;\n  task?: string;\n  when?: FabricHandoffPredicate;\n  name?: string;\n  transport?: FabricTransport;\n  thinking?: FabricThinking;\n  tools?: string[];\n  timeoutMs?: number;\n  extensions?: boolean;\n  recursive?: boolean;\n  schema?: Record<string, unknown>;\n  prompt?: string;\n  instructions?: string;\n  timeout_ms?: number;\n}\ninterface FabricHandoffResult {\n  scheduled: true;\n  status: \"deferred\";\n  boundary: \"fabric_exec_end\";\n}\ninterface FabricMainAgentInfo {\n  id: string;\n  name: \"Main\";\n  kind: \"main\";\n  status: \"idle\" | \"running\" | \"remote\";\n  runner: \"omp\";\n  transport: \"host\";\n  cwd?: string;\n  sessionId?: string;\n  model?: string;\n  thinking?: string;\n  startedAt?: number;\n  updatedAt: number;\n  pendingMessages: boolean;\n  local: boolean;\n}\ninterface FabricPeerInfo {\n  id: string;\n  name: string;\n  kind: \"peer\";\n  status: \"idle\" | \"running\";\n  runner: \"omp\";\n  transport: \"host\";\n  cwd: string;\n  sessionId: string;\n  model?: string;\n  thinking?: string;\n  startedAt: number;\n  updatedAt: number;\n  pendingMessages: boolean;\n  local: false;\n}\ntype FabricParticipantKind = \"root\" | \"agent\" | \"actor\";\ntype FabricParticipantResidency = \"session\" | \"durable\";\ntype FabricParticipantScope = \"local\" | \"lineage\" | \"project\";\ntype FabricParticipantCapability = \"steer\" | \"followUp\" | \"stop\" | \"ask\" | \"actor-bindings\" | \"attach\" | \"fabric\";\ninterface FabricParticipantInfo {\n  format: 1;\n  id: string;\n  kind: FabricParticipantKind;\n  rootId: string;\n  ownerHostId: string;\n  ownerIdentityId: string;\n  parentId?: string;\n  name: string;\n  status: string;\n  runner: FabricAgentRunner;\n  transport: FabricTransport | \"host\";\n  capabilities: FabricParticipantCapability[];\n  cwd?: string;\n  sessionId?: string;\n  model?: string;\n  thinking?: string;\n  startedAt: number;\n  updatedAt: number;\n  finishedAt?: number;\n  pendingMessages?: boolean;\n  currentTool?: string;\n  turns?: number;\n  toolCalls?: number;\n  usage?: { input: number; output: number; cacheRead: number; cacheWrite: number; cost: number };\n  actorQueued?: number;\n  actorMessages?: number;\n  controlProtocol: \"v1\" | \"legacy\";\n  residency: FabricParticipantResidency;\n  local: boolean;\n  stale: boolean;\n}\ntype FabricLifecycleEventType =\n  | \"omp.input\"\n  | \"omp.agent_start\"\n  | \"omp.agent_end\"\n  | \"omp.turn_end\"\n  | \"omp.tool_error\"\n  | \"omp.session_compact\"\n  | \"run.completed\"\n  | \"run.failed\"\n  | \"run.stopped\"\n  | \"run.timed_out\"\n  | \"tokens.usage\"\n  | \"component.state\";\ntype FabricLifecycleDelivery = \"steer\" | \"followUp\";\ninterface FabricLifecycleSource {\n  id: string;\n  name: string;\n  kind: FabricParticipantKind;\n  rootId: string;\n  runner: FabricAgentRunner;\n  ownerHostId?: string;\n  ownerIdentityId?: string;\n}\ninterface FabricLifecycleEvent {\n  version: 1;\n  id: string;\n  sequence: number;\n  event: FabricLifecycleEventType;\n  source: FabricLifecycleSource;\n  occurredAt: number;\n  publishedAt: number;\n  runId?: string;\n  status?: string;\n  data?: unknown;\n}\ninterface FabricLifecycleSubscription {\n  format: 1;\n  id: string;\n  from: string;\n  events: FabricLifecycleEventType[];\n  to: string;\n  delivery: FabricLifecycleDelivery;\n  triggerTurn: boolean;\n  once: boolean;\n  afterSequence: number;\n  createdAt: number;\n  updatedAt: number;\n  createdBy: { id: string; name: string; kind: \"main\" | \"agent\" | \"actor\"; sessionId?: string };\n  lastDeliveredAt?: number;\n  lastEventId?: string;\n  lastError?: string;\n}\ninterface FabricAgentHandle {\n  id: string;\n  name: string;\n  status: string;\n  runner: FabricAgentRunner;\n  transport: FabricTransport;\n  cwd: string;\n  model?: string;\n  thinking?: FabricThinking;\n  actorId?: string;\n  actorName?: string;\n  sessionId?: string;\n  runnerSessionId?: string;\n  attachCommand?: string;\n  branch?: string;\n  worktree?: string;\n  text?: string;\n  value?: unknown;\n  error?: string;\n  logFile?: string;\n  residency?: FabricParticipantResidency;\n}\ninterface FabricRemoteControlResult {\n  queued: true;\n  messageId: string;\n  routed: \"mesh\";\n  acknowledged: true;\n}\ninterface FabricAgentResult extends FabricAgentHandle {\n  task: string;\n  startedAt: number;\n  finishedAt?: number;\n  turns: number;\n  toolCalls: number;\n  text: string;\n  value?: unknown;\n  error?: string;\n  usage: { input: number; output: number; cacheRead: number; cacheWrite: number; cost: number };\n  pendingMessages?: { steering: string[]; followUp: string[] };\n}\ninterface FabricModelInfo {\n  runner?: FabricAgentRunner;\n  provider: string;\n  id: string;\n  name: string;\n  key: string;\n  value?: string;\n  resolvedModel?: string;\n  displayName?: string;\n  description?: string;\n  supportsEffort?: boolean;\n  supportedEffortLevels?: string[];\n  supportsAdaptiveThinking?: boolean;\n  supportsFastMode?: boolean;\n  supportsAutoMode?: boolean;\n}\ninterface FabricLogLine {\n  index?: number;\n  offset: number;\n  raw: string;\n  parsed?: unknown;\n}\ninterface FabricAgentLog {\n  id: string;\n  runDirectory: string;\n  logFile: string;\n  status?: FabricAgentResult;\n  events: FabricLogLine[];\n  hasMore: boolean;\n  before?: number;\n}\ninterface FabricActorLog {\n  actorId: string;\n  actorName: string;\n  sessionFile: string;\n  logDir: string;\n  session: FabricLogLine[];\n  sessionHasMore: boolean;\n  sessionBefore?: number;\n  run?: {\n    runId: string;\n    eventsFile: string;\n    status?: FabricAgentResult;\n    events: FabricLogLine[];\n    hasMore: boolean;\n    before?: number;\n  };\n  retainedRuns: string[];\n}\ninterface FabricCapabilityActionHead {\n  key: string;\n  parentKey: string;\n  ref: string;\n  name: string;\n  description: string;\n  descriptorHash: string;\n  risk: \"read\" | \"write\" | \"execute\" | \"network\" | \"agent\";\n  namespace?: string;\n  effect?: FabricActionEffect;\n}\ninterface FabricCapabilityProviderHead {\n  key: string;\n  parentKey: string;\n  name: string;\n  description: string;\n  descriptorHash: string;\n  actions: FabricCapabilityActionHead[];\n}\ninterface FabricCapabilityCatalog {\n  kind: \"omp-fabric.capability-catalog\";\n  version: 1;\n  root: {\n    key: \"capability:fabric\";\n    name: \"Fabric capabilities\";\n    description: string;\n    descriptorHash: string;\n  };\n  providers: FabricCapabilityProviderHead[];\n  totalActions: number;\n  indexedActions: number;\n  complete: boolean;\n  reasons: string[];\n}\ninterface FabricToolsApi {\n  providers(): Promise<Array<{ name: string; description: string }>>;\n  catalog(args?: { provider?: string; limit?: number }): Promise<FabricCapabilityCatalog>;\n  list(args?: { provider?: string; namespace?: string; query?: string; limit?: number }): Promise<FabricAction[]>;\n  search(query: string): Promise<FabricAction[]>;\n  search(args: { query: string; limit?: number }): Promise<FabricAction[]>;\n  describe(args: { ref: string }): Promise<FabricAction>;\n  call(args: { ref: string; args?: Record<string, unknown> }): Promise<unknown>;\n  progress(args: { message: string }): Promise<void>;\n  models(): Promise<FabricModelInfo[]>;\n}\ninterface FabricCapturedToolResult {\n  content: Array<{ type: string; text?: string; [key: string]: unknown }>;\n  text: string;\n  details?: unknown;\n  isError: boolean;\n  terminate?: boolean;\n  source: { path: string; source: string; scope: string; origin: string; baseDir?: string };\n}\ninterface FabricCapturedTool {\n  (args?: Record<string, unknown>): Promise<FabricCapturedToolResult>;\n}\ntype FabricExtensionsApi = Record<string, FabricCapturedTool>;\n// String-primary tools (read/bash/grep/find/ls) accept a bare string; the\n// runtime proxy coerces it to { <primaryField>: string }. Lets the model write\n// the natural form (omp.bash(\"ls\")) instead of omp.bash({ command: \"ls\" }).\n// Return shapes differ by tool: read/grep/find/ls return their text as a bare\n// string (e.g. const src: string = await omp.read({ path })); shell/edit/write\n// return { ok, output, details } (e.g. const { output } = await omp.bash(...)).\n// Common alias keys (cmd\u2192command, query\u2192pattern, file\u2192path, dir\u2192path) and a\n// flat edit shape ({ path, oldText, newText }) are also accepted; the runtime\n// proxy normalizes them to the canonical form before the host validates args.\n// Bash timeout is measured in seconds; timeoutMs is converted from milliseconds.\n// Extended near-miss repairs: find's name/filename/glob \u2192 pattern, write's\n// data \u2192 content, ls's folder \u2192 path, bash's script \u2192 command; numeric option\n// fields (limit/offset/context/timeout) also accept numeric strings, coerced\n// at runtime (2322 diagnostics are suppressed by the type-checker by design).\n// String-primary tools also take a two-arg (primary, options) form \u2014\n// omp.read(\"index.ts\", { limit: 120 }) merges to { path, ...options } at\n// runtime, the positional string winning the primary field on conflict.\n// shell/edit/write envelopes are proxy-guarded so string-method access\n// (.trim(), .split(), iteration) fails with an actionable TypeError pointing\n// at .output instead of QuickJS's context-free \"not a function\" \u2014 property-\n// miss (2339) checks are suppressed by design, so the runtime gives the hint.\ntype OmpPathArgument = {\n  path?: string;\n  file?: string;\n  absolutePath?: string;\n  file_path?: string;\n  filePath?: string;\n  filepath?: string;\n  pathname?: string;\n  target_file?: string;\n  targetFile?: string;\n  absolute_path?: string;\n  fileAbsolutePath?: string;\n};\ntype OmpOptionalPathArgument = {\n  path?: string;\n  file?: string;\n  absolutePath?: string;\n  file_path?: string;\n  filePath?: string;\n  filepath?: string;\n  pathname?: string;\n  target_file?: string;\n  targetFile?: string;\n  absolute_path?: string;\n  fileAbsolutePath?: string;\n  dir?: string;\n  folder?: string;\n  directory?: string;\n  directoryPath?: string;\n};\ntype OmpOldTextArgument = {\n  oldText?: string;\n  old?: string;\n  old_string?: string;\n  oldString?: string;\n  old_str?: string;\n  oldStr?: string;\n  from?: string;\n  old_value?: string;\n  old_text?: string;\n  oldContent?: string;\n  old_content?: string;\n};\ntype OmpNewTextArgument = {\n  newText?: string;\n  new?: string;\n  replacement?: string;\n  new_string?: string;\n  newString?: string;\n  new_str?: string;\n  newStr?: string;\n  to?: string;\n  new_value?: string;\n  new_text?: string;\n  newContent?: string;\n  new_content?: string;\n};\ntype OmpEditOperation = OmpOldTextArgument & OmpNewTextArgument & { all?: boolean };\ntype OmpCommandArgument = { command?: string; cmd?: string; shell?: string; cmdline?: string; script?: string; commandLine?: string };\ntype OmpContentArgument = { content?: string; contents?: string; body?: string; text?: string; data?: string; fileContent?: string };\ntype OmpGrepPatternArgument = { pattern?: string; query?: string; regex?: string; search?: string; q?: string; expression?: string; text?: string };\ntype OmpFindPatternArgument = { pattern?: string; query?: string; regex?: string; search?: string; name?: string; filename?: string; glob?: string; expression?: string; include?: string };\n// Two-arg (primary, options) bags for the string-primary tools. Only option\n// aliases belong here (max/start/ctx/ic/...), never primary-field aliases \u2014\n// the primary field comes from the positional string.\ntype OmpReadOptions = { offset?: number; limit?: number; start?: number; max?: number };\n// cwd is honored per call by the omp provider, which binds the command to a\n// shell definition rooted there; relative paths resolve from the session cwd.\n// The alias spellings mirror the shell entries in __ompArgAliases: the\n// runtime repairs them, so the checker has to accept the same spellings or a\n// repairable call is rejected before it ever reaches the sandbox.\ntype OmpShellOptions = {\n  timeout?: number; timeoutMs?: number; settle?: boolean;\n  cwd?: string; workdir?: string; directory?: string; workingDirectory?: string;\n};\ntype OmpBashOptions = OmpShellOptions;\ntype OmpGrepOptions = { path?: string; glob?: string; globPattern?: string; ignoreCase?: boolean; ic?: boolean; caseInsensitive?: boolean; literal?: boolean; context?: number; ctx?: number; limit?: number; max?: number };\ntype OmpFindOptions = { path?: string; limit?: number; max?: number };\ntype OmpLsOptions = { limit?: number; max?: number };\ntype OmpReadArgument = string | (OmpPathArgument & OmpReadOptions);\ntype OmpBashArgument = string | (OmpCommandArgument & OmpBashOptions);\ntype OmpEditFlatArgument = OmpPathArgument & OmpOldTextArgument & OmpNewTextArgument & { all?: boolean };\ntype OmpEditArgument = OmpPathArgument & ({ edits: OmpEditOperation[]; all?: boolean } | OmpEditFlatArgument);\ntype OmpWriteArgument = string | (OmpPathArgument & OmpContentArgument);\ntype OmpGrepArgument = string | (OmpGrepPatternArgument & OmpGrepOptions);\ntype OmpFindArgument = string | (OmpFindPatternArgument & OmpFindOptions);\ntype OmpLsArgument = string | (OmpOptionalPathArgument & OmpLsOptions);\ntype OmpNumericString<T> = T extends number ? T | string : T;\ntype OmpNumericStringOptions<T> = { [K in keyof T]: OmpNumericString<T[K]> };\ntype OmpReadCompatibilityArgument = string | (OmpPathArgument & OmpNumericStringOptions<OmpReadOptions>);\ntype OmpBashCompatibilityArgument = string | (OmpCommandArgument & OmpNumericStringOptions<OmpBashOptions>);\ntype OmpEditCompatibilityArgument = OmpEditFlatArgument;\ntype OmpWriteCompatibilityArgument = OmpWriteArgument;\ntype OmpGrepCompatibilityArgument = string | (OmpGrepPatternArgument & OmpNumericStringOptions<OmpGrepOptions>);\ntype OmpFindCompatibilityArgument = string | (OmpFindPatternArgument & OmpNumericStringOptions<OmpFindOptions>);\ntype OmpLsCompatibilityArgument = string | (OmpOptionalPathArgument & OmpNumericStringOptions<OmpLsOptions>);\ninterface OmpToolsApi {\n  read(args: OmpReadArgument, options?: OmpReadOptions): Promise<string>;\n  bash(args: OmpBashArgument, options?: OmpBashOptions): Promise<{ ok: true; output: string; details: unknown } | { ok: false; output: string; details: null; exitCode: number; error: string }>;\n  edit(args: OmpEditArgument): Promise<{ ok: true; output: string; details: unknown }>;\n  edit(path: string, oldText: string, newText: string): Promise<{ ok: true; output: string; details: unknown }>;\n  write(args: OmpWriteArgument): Promise<{ ok: true; output: string; details: unknown }>;\n  write(path: string, content: string): Promise<{ ok: true; output: string; details: unknown }>;\n  grep(args: OmpGrepArgument): Promise<string>;\n  grep(pattern: string, path?: string | OmpGrepOptions, limit?: number): Promise<string>;\n  find(args: OmpFindArgument): Promise<string>;\n  find(pattern: string, path?: string | OmpFindOptions, limit?: number): Promise<string>;\n  ls(args?: OmpLsArgument, options?: OmpLsOptions): Promise<string>;\n}\ntype FabricActorHostEvent =\n  | \"resources_discover\"\n  | \"session_start\"\n  | \"session_before_switch\"\n  | \"session_switch\"\n  | \"session_before_branch\"\n  | \"session_branch\"\n  | \"session_before_compact\"\n  | \"session.compacting\"\n  | \"session_compact\"\n  | \"session_shutdown\"\n  | \"session_before_tree\"\n  | \"session_tree\"\n  | \"goal_updated\"\n  | \"input\"\n  | \"before_agent_start\"\n  | \"agent_start\"\n  | \"agent_end\"\n  | \"session_stop\"\n  | \"turn_start\"\n  | \"turn_end\"\n  | \"message_start\"\n  | \"message_update\"\n  | \"message_end\"\n  | \"context\"\n  | \"before_provider_request\"\n  | \"after_provider_response\"\n  | \"tool_execution_start\"\n  | \"tool_call\"\n  | \"tool_execution_update\"\n  | \"tool_result\"\n  | \"tool_execution_end\"\n  | \"user_bash\"\n  | \"tool_error\";\ntype FabricActorDelivery = \"mailbox\" | \"steer\" | \"followUp\" | \"nextTurn\";\ninterface FabricActorHostMediaDescriptor {\n  readonly type: \"image\";\n  readonly mediaIndex: number;\n  readonly mimeType: string;\n}\ninterface FabricActorHostSignal {\n  readonly payload: unknown;\n  readonly media?: readonly FabricActorHostMediaDescriptor[];\n  readonly idle: boolean;\n  readonly observedAt: number;\n}\ntype FabricActorActivation =\n  | { readonly kind: \"hostEvent\"; readonly id: string; readonly source: string; readonly sequence: number; readonly createdAt: number; readonly event: FabricActorHostEvent; readonly mainRevision: number; readonly taskRevision: number; readonly signal?: FabricActorHostSignal }\n  | { readonly kind: \"direct\"; readonly id: string; readonly source: string; readonly sequence: number; readonly createdAt: number }\n  | { readonly kind: \"mesh\"; readonly id: string; readonly source: string; readonly sequence: number; readonly createdAt: number; readonly topic: string };\ninterface FabricActorValidityFacts {\n  readonly activation: Readonly<FabricActorActivation>;\n  readonly current: Readonly<{ latestActivationSequence: number; mainRevision: number; taskRevision: number; idle: boolean; now: number }>;\n}\ntype FabricActorValidityDecision = boolean | { valid: boolean; reason?: string };\ntype FabricActorBindingScope = \"session\" | \"project\";\ninterface FabricActorRunBinding { model?: string; thinking?: FabricThinking }\ntype FabricActorValidWhile = (facts: Readonly<FabricActorValidityFacts>) => FabricActorValidityDecision;\ninterface FabricActorRequestBase {\n  scope?: \"session\" | \"project\" | \"global\";\n  name: string;\n  instructions: string;\n  events?: FabricActorHostEvent[];\n  topics?: string[];\n  responseMode?: \"text\" | \"directive\";\n  coalesce?: boolean;\n  runner?: FabricAgentRunner;\n  model?: string;\n  thinking?: FabricThinking;\n  tools?: string[];\n  transport?: FabricTransport;\n  timeoutMs?: number;\n  timeout_ms?: number;\n  extensions?: boolean;\n  requires?: Array<string | { ref: string; optional?: boolean }>;\n  validWhile?: FabricActorValidWhile;\n  residency?: FabricParticipantResidency;\n}\ntype FabricActorRequest = FabricActorRequestBase & (\n  | { delivery?: \"mailbox\"; triggerTurn?: false }\n  | { delivery: \"nextTurn\"; triggerTurn?: false }\n  | { delivery: \"steer\" | \"followUp\"; triggerTurn: boolean }\n);\ninterface FabricActorInfo {\n  id: string;\n  scope: \"session\" | \"project\";\n  name: string;\n  status: \"idle\" | \"queued\" | \"running\" | \"stopped\";\n  runner: FabricAgentRunner;\n  events: FabricActorHostEvent[];\n  topics: string[];\n  delivery: FabricActorDelivery;\n  responseMode: \"text\" | \"directive\";\n  triggerTurn: boolean;\n  coalesce: boolean;\n  model?: string;\n  thinking?: FabricThinking;\n  binding?: FabricActorRunBinding & { scope: \"session\"; sessionId: string; updatedAt?: number };\n  projectDefaults?: FabricActorRunBinding & { scope: \"project\" };\n  tools?: string[];\n  timeoutMs?: number;\n  extensions?: boolean;\n  requirements?: Array<{ ref: string; optional?: boolean }>;\n  capabilityDigest?: string;\n  missingCapabilities?: string[];\n  validWhile?: { version: 1; source: string };\n  residency: FabricParticipantResidency;\n  queued: number;\n  messages: number;\n  createdAt: number;\n  updatedAt: number;\n  lastRunId?: string;\n  lastError?: string;\n  sessionFile?: string;\n  logDir?: string;\n}\ninterface FabricModelSwitchRequest {\n  /** provider/id, a models.aliases name, or a search term; resolution tries aliases first, then exact matches, then the closest fuzzy match (recency from pi-model-sort breaks ties) against authenticated models. */\n  model: string;\n  /** Optional provider filter applied before matching (e.g. \"anthropic\"). */\n  provider?: string;\n}\ninterface FabricModelSwitchResult {\n  switched: boolean;\n  /** Active model as provider/id after the call (unchanged when reason is \"already-active\"). */\n  model: string;\n  name?: string;\n  /** Previously active provider/id when known. Absent for already-active results. */\n  previous?: string;\n  /** Set when the selector resolved through a configured models.aliases name. */\n  alias?: string;\n  /** How the selector resolved: the alias name, or one of closest/recent/latest for inexact picks. Absent for exact provider/id or bare-id matches. */\n  via?: string;\n  reason?: \"already-active\";\n}\ninterface FabricActorMessage {\n  id: string;\n  actorId: string;\n  actorName: string;\n  direction: \"in\" | \"out\";\n  source: string;\n  createdAt: number;\n  text?: string;\n  data?: unknown;\n  action?: \"silent\" | \"message\" | \"stop\";\n  runId?: string;\n  error?: string;\n  stale?: boolean;\n  reason?: string;\n}\n// agentId/agent_id spellings repair to id during agent arg normalization.\ntype FabricAgentTargetArgs = { id: string; agentId?: string; agent_id?: string };\ninterface FabricAgentsApi {\n  run(args: FabricAgentRequest): Promise<FabricAgentResult>;\n  handoff(args: FabricHandoffRequest): Promise<FabricHandoffResult>;\n  spawn(args: FabricAgentRequest): Promise<FabricAgentHandle>;\n  wait(args: FabricAgentTargetArgs): Promise<FabricAgentResult>;\n  status(args: FabricAgentTargetArgs): Promise<FabricAgentResult | FabricAgentHandle | FabricMainAgentInfo | FabricActorInfo | FabricParticipantInfo>;\n  list(args?: { scope?: FabricParticipantScope }): Promise<Array<FabricAgentResult | FabricAgentHandle | FabricParticipantInfo>>;\n  members(args?: { scope?: FabricParticipantScope; kinds?: FabricParticipantKind[]; includeStale?: boolean }): Promise<FabricParticipantInfo[]>;\n  self(): Promise<FabricParticipantInfo>;\n  main(): Promise<FabricMainAgentInfo>;\n  sessions(): Promise<FabricParticipantInfo[]>;\n  peers(): Promise<FabricPeerInfo[]>;\n  subscribe(args: {\n    from: string;\n    events: FabricLifecycleEventType[];\n    to?: string;\n    delivery: FabricLifecycleDelivery;\n    triggerTurn: boolean;\n    once?: boolean;\n  }): Promise<FabricLifecycleSubscription>;\n  subscriptions(args?: { from?: string; to?: string }): Promise<FabricLifecycleSubscription[]>;\n  unsubscribe(args: FabricAgentTargetArgs): Promise<{ removed: boolean }>;\n  models(args?: { runner?: FabricAgentRunner; refresh?: boolean }): Promise<FabricModelInfo[]>;\n  stop(args: FabricAgentTargetArgs): Promise<FabricAgentResult | FabricActorInfo | FabricRemoteControlResult>;\n  cleanup(args: FabricAgentTargetArgs & { deleteBranch?: boolean; delete_branch?: boolean }): Promise<{ cleaned: boolean }>;\n  create(args: FabricActorRequest): Promise<FabricActorInfo>;\n  setModel(args: { id: string; model?: string; scope?: FabricActorBindingScope }): Promise<FabricActorInfo>;\n  switchModel(args: FabricModelSwitchRequest): Promise<FabricModelSwitchResult>;\n  setThinking(args: { id: string; thinking?: FabricThinking; scope?: FabricActorBindingScope }): Promise<FabricActorInfo>;\n  setTools(args: { id: string; tools: string[]; scope?: \"project\" | \"global\" }): Promise<FabricActorInfo>;\n  setEvents(args: { id: string; events: FabricActorHostEvent[] }): Promise<FabricActorInfo>;\n  setDeliveryPolicy(args: {\n    id: string;\n    delivery: FabricActorDelivery;\n    triggerTurn: boolean;\n    scope?: \"project\" | \"global\";\n  }): Promise<FabricActorInfo>;\n  setInstructions(args: {\n    id: string;\n    instructions: string;\n    scope?: \"project\" | \"global\";\n  }): Promise<FabricActorInfo>;\n  ask(args: { id: string; message: string; data?: unknown; model?: string; thinking?: FabricThinking }): Promise<FabricActorMessage>;\n  tell(args: { id: string; message: string; data?: unknown; model?: string; thinking?: FabricThinking }): Promise<{ queued: true; messageId: string }>;\n  steer(args: { id: string; message: string; data?: unknown }): Promise<{ queued: true; messageId: string; routed?: \"local\" | \"main\" | \"mesh\"; acknowledged?: boolean }>;\n  followUp(args: { id: string; message: string; data?: unknown }): Promise<{ queued: true; messageId: string; routed?: \"local\" | \"main\" | \"mesh\"; acknowledged?: boolean }>;\n  setSteeringMode(args: { id: string; mode: \"all\" | \"one-at-a-time\" }): Promise<{ queued: true; messageId: string }>;\n  setFollowUpMode(args: { id: string; mode: \"all\" | \"one-at-a-time\" }): Promise<{ queued: true; messageId: string }>;\n  actorStatus(args: FabricAgentTargetArgs): Promise<FabricActorInfo>;\n  actors(): Promise<FabricActorInfo[]>;\n  messages(args: { id: string; limit?: number }): Promise<FabricActorMessage[]>;\n  remove(args: { id: string }): Promise<{ removed: boolean }>;\n  log(args: {\n    id: string;\n    type?: \"session\" | \"run\" | \"all\";\n    lines?: number;\n    before?: number;\n    runId?: string;\n  }): Promise<FabricActorLog | FabricAgentLog>;\n}\ninterface FabricMcpResult {\n  text: string;\n  content: unknown[];\n  structuredContent: unknown;\n}\ninterface FabricMcpTool {\n  (args?: Record<string, unknown>): Promise<FabricMcpResult | unknown>;\n}\ninterface FabricMcpServer {\n  [tool: string]: FabricMcpTool;\n}\n// Management verbs stay members of mcp even when the declare line below is\n// replaced by generated per-server declarations (see the dynamic option on\n// guestTypeDeclarations), so generated surfaces intersect with this type\n// rather than re-declaring them.\ninterface FabricMcpManagement {\n  servers(): Promise<Array<{ name: string; description: string | null; transport: \"http\" | \"stdio\" }>>;\n  reload(): Promise<{ servers: string[] }>;\n  register(args: {\n    name: string;\n    description?: string;\n    command?: string;\n    args?: string[];\n    cwd?: string;\n    baseUrl?: string;\n    headers?: Record<string, string>;\n    env?: Record<string, string>;\n    overwrite?: boolean;\n  }): Promise<{ registered: string }>;\n  call(args: { server: string; tool: string; args?: Record<string, unknown> }): Promise<unknown>;\n}\n// Loose static surface: any server/tool name compiles and argument shapes are\n// enforced at dispatch by the registry. With descriptor data available the\n// execution service replaces the declare-const-mcp line below with a\n// schema-typed rendering of the live cache (runtime/dynamic-guest-types.ts).\ntype FabricMcpApi = Record<string, FabricMcpServer> & FabricMcpManagement;\ninterface FabricCouncilRunOptions {\n  task: string;\n  roles: string[];\n  runner?: FabricAgentRunner;\n  transport?: FabricTransport;\n  model?: string;\n  thinking?: FabricThinking;\n  tools?: string[];\n  timeoutMs?: number;\n  /** Filesystem execution directory; relative paths resolve from the parent agent cwd. */\n  cwd?: string;\n  worktree?: boolean;\n}\ninterface FabricCouncilApi {\n  run(args: FabricCouncilRunOptions & { synthesize?: true }): Promise<FabricAgentResult>;\n  run(args: FabricCouncilRunOptions & { synthesize: false }): Promise<FabricAgentResult[]>;\n}\ninterface FabricMeshIdentity {\n  id: string;\n  name: string;\n  kind: \"main\" | \"actor\" | \"agent\";\n  sessionId?: string;\n}\ninterface FabricMeshEvent {\n  id: string;\n  sequence: number;\n  topic: string;\n  kind: string;\n  from: FabricMeshIdentity;\n  to?: string;\n  text?: string;\n  data?: unknown;\n  createdAt: number;\n}\ninterface FabricMeshStateEntry<T = unknown> {\n  key: string;\n  value: T;\n  version: number;\n  updatedAt: number;\n  updatedBy: FabricMeshIdentity;\n}\ninterface FabricMeshApi {\n  self(): Promise<FabricMeshIdentity>;\n  publish(args: { topic: string; kind?: string; to?: string; text?: string; data?: unknown; message?: string; body?: string }): Promise<FabricMeshEvent>;\n  read(args?: { after?: number; topic?: string; to?: string; limit?: number; max?: number }): Promise<FabricMeshEvent[]>;\n  members(args?: { scope?: FabricParticipantScope; kinds?: FabricParticipantKind[]; includeStale?: boolean; limit?: number; max?: number; include_stale?: boolean }): Promise<FabricParticipantInfo[]>;\n  get<T = unknown>(args: { key: string }): Promise<FabricMeshStateEntry<T> | null>;\n  list<T = unknown>(args?: { prefix?: string; limit?: number; max?: number }): Promise<Array<FabricMeshStateEntry<T>>>;\n  put<T = unknown>(args: { key: string; value: T; ifVersion?: number; if_version?: number; version?: number }): Promise<FabricMeshStateEntry<T>>;\n  delete(args: { key: string; ifVersion?: number; if_version?: number; version?: number }): Promise<{ deleted: boolean; version?: number }>;\n}\n// Stable-provider argument bags declare the canonical keys plus the\n// near-miss spellings repaired during argument normalization\n// (providers/arg-normalization.ts and each provider's per-action table). The\n// registry's prepare stage repairs aliases before schema validation, so a\n// call spelled with an alias typechecks instead of tripping the\n// excess-property check; the canonical key wins on conflict, and anything\n// else fails additionalProperties:false validation with the offending\n// property path named. Keep these spillover fields in sync with the provider\n// normalization tables.\ntype FabricMemoryBranches = \"active\" | \"all\";\ntype FabricMemoryQueryMode = \"literal\" | \"phrase\" | \"regex\";\ntype FabricMemoryQueryMatch = \"all\" | \"any\";\ninterface FabricMemoryEntryRange {\n  first: number;\n  last: number;\n}\ninterface FabricMemoryRecallArgs {\n  query?: string;\n  queryMode?: FabricMemoryQueryMode;\n  queryMatch?: FabricMemoryQueryMatch;\n  expectedSourceHash?: string;\n  expectedLineageFingerprint?: string;\n  branches?: FabricMemoryBranches;\n  scope?: string;\n  offset?: number;\n  pageSize?: number;\n  snippetChars?: number;\n  role?: string;\n  tool?: string;\n  ref?: string;\n  provider?: string;\n  action?: string;\n  outcome?: \"succeeded\" | \"failed\" | \"aborted\" | \"timed_out\";\n  since?: number;\n  until?: number;\n  entryRange?: FabricMemoryEntryRange;\n  q?: string;\n  limit?: number;\n  max?: number;\n  page_size?: number;\n  snippet_chars?: number;\n  query_mode?: FabricMemoryQueryMode;\n  query_match?: FabricMemoryQueryMatch;\n  entry_range?: FabricMemoryEntryRange;\n}\ninterface FabricMemoryExpandArgs {\n  session: string;\n  expectedSourceHash?: string;\n  expectedLineageFingerprint?: string;\n  branches?: FabricMemoryBranches;\n  indices?: number[];\n  entryIds?: string[];\n  operationAddresses?: string[];\n  entryRange?: FabricMemoryEntryRange;\n  before?: number;\n  after?: number;\n  entryOffset?: number;\n  textOffset?: number;\n  maxChars?: number;\n  maxEntries?: number;\n  id?: string;\n  file?: string;\n  path?: string;\n  session_id?: string;\n  index?: number;\n  entry_ids?: string[];\n  operation_addresses?: string[];\n  entry_range?: FabricMemoryEntryRange;\n  entry_offset?: number;\n  text_offset?: number;\n  max_chars?: number;\n  max_entries?: number;\n}\ninterface FabricMemoryCall<Ref extends string, Args> {\n  ref: Ref;\n  args: Args;\n}\ninterface FabricMemoryRecallEntryHit {\n  kind: \"entry\";\n  sessionId: string;\n  tier: \"hot\" | \"cold\";\n  index: number;\n  entryId: string | null;\n  parentId: string | null;\n  operationAddress: string | null;\n  type: string;\n  role: string | null;\n  tool: string | null;\n  ref: string | null;\n  provider: string | null;\n  action: string | null;\n  timestamp: number | null;\n  isError: boolean;\n  outcome?: \"succeeded\" | \"failed\" | \"aborted\" | \"timed_out\";\n  score: number;\n  snippet: string;\n  truncated: boolean;\n  follow: FabricMemoryCall<\"memory.expand\", FabricMemoryExpandArgs>;\n}\ninterface FabricMemoryRecallSessionHit {\n  kind: \"session\";\n  sessionId: string;\n  tier: \"cold\";\n  cwd: string;\n  lastTimestamp: number | null;\n  score: number;\n  matchedTerms: number;\n  matchedStructuralEntries: number;\n  follow: FabricMemoryCall<\"memory.recall\", FabricMemoryRecallArgs>;\n}\ntype FabricMemoryRecallHit = FabricMemoryRecallEntryHit | FabricMemoryRecallSessionHit;\ninterface FabricMemoryError {\n  code: string;\n  message: string;\n  [key: string]: unknown;\n}\ninterface FabricMemoryCoverage {\n  complete: boolean;\n  indexedSessions: number;\n  eligibleSessions: number;\n  staleSessions: number;\n  incompleteSessions: number;\n  reasons: string[];\n  error?: FabricMemoryError;\n}\ninterface FabricMemoryRecallResult {\n  total: number;\n  hits: FabricMemoryRecallHit[];\n  next: FabricMemoryCall<\"memory.recall\", FabricMemoryRecallArgs> | null;\n  coverage: FabricMemoryCoverage;\n  error?: FabricMemoryError;\n}\ninterface FabricMemoryExpandedEntry {\n  index: number;\n  entryId: string | null;\n  parentId: string | null;\n  type: string | null;\n  role: string | null;\n  timestamp: number | null;\n  isError: boolean;\n  anchor?: boolean;\n  text: string;\n  textRange: { start: number; end: number; total: number; complete: boolean };\n  parentEntryId?: string | null;\n  operationAddress?: string | null;\n  tool?: string | null;\n  ref?: string | null;\n  provider?: string | null;\n  action?: string | null;\n  outcome?: \"succeeded\" | \"failed\" | \"aborted\" | \"timed_out\";\n  filesTouched?: Array<string | null>;\n  operation?: unknown;\n  branchFact?: unknown;\n  structuredTruncated?: boolean;\n  factAddress?: string | null;\n  carrierEntryId?: string | null;\n  carrierParentId?: string | null;\n  carrierFromId?: string | null;\n}\ninterface FabricMemoryExpandResult {\n  session?: string;\n  sourceHash?: string;\n  branches?: FabricMemoryBranches;\n  lineageFingerprint?: string;\n  entryCount?: number;\n  entries: FabricMemoryExpandedEntry[];\n  next?: FabricMemoryCall<\"memory.expand\", FabricMemoryExpandArgs> | null;\n  error?: FabricMemoryError;\n}\ninterface FabricMemoryWalkResult {\n  visited: number;\n  stopped: boolean;\n  error?: FabricMemoryError;\n}\ninterface FabricMemorySessionInfo {\n  id: string;\n  file: string;\n  cwd: string;\n  mtime: number;\n  entryCount: number;\n  tier: \"hot\" | \"cold\";\n  branches: FabricMemoryBranches;\n  lineageFingerprint: string | null;\n}\ninterface FabricMemoryApi {\n  recall(args?: FabricMemoryRecallArgs): Promise<FabricMemoryRecallResult>;\n  expand(args: FabricMemoryExpandArgs): Promise<FabricMemoryExpandResult>;\n  walk(\n    args: FabricMemoryExpandArgs,\n    visitor: (\n      entry: FabricMemoryExpandedEntry,\n      index: number,\n    ) => boolean | void | Promise<boolean | void>,\n  ): Promise<FabricMemoryWalkResult>;\n  sessions(args?: {\n    scope?: string;\n    branches?: FabricMemoryBranches;\n    limit?: number;\n    max?: number;\n  }): Promise<{\n    scope?: string;\n    branches?: FabricMemoryBranches;\n    sessions?: FabricMemorySessionInfo[];\n    error?: FabricMemoryError;\n  }>;\n}\ninterface FabricStateTransitionArgs {\n  label: string;\n  from?: string;\n  to: string;\n  summary: string;\n  evidence?: string[];\n  tags?: string[];\n  kind?: \"state\" | \"representation\";\n  complexity?: { files: string[] };\n  force?: boolean;\n  name?: string;\n  description?: string;\n}\ninterface FabricStateComplexityFile {\n  file: string;\n  supported: boolean;\n  language?: string;\n  current?: number;\n  recorded?: number;\n  delta?: number;\n  recordedDelta?: number;\n}\ninterface FabricStateVerificationResult {\n  certified: boolean;\n  violated: boolean;\n  certificationStatus: \"certified\" | \"failed\";\n  results: unknown[];\n  failures: unknown[];\n  certificate?: unknown;\n  reportingError?: string;\n  evidenceDigest: string;\n  resultDigest: string;\n}\ninterface FabricStateApi {\n  transition(args: FabricStateTransitionArgs): Promise<{ event: FabricMeshEvent; head: unknown }>;\n  get(): Promise<{\n    head: unknown | null;\n    goal: { check: string; description?: string } | null;\n    complexity: { files: number; decisionPoints: number; lastNetDelta: number };\n    certification: { current: unknown | null; recent: unknown[] };\n    recentLabels: string[];\n  }>;\n  history(args?: { label?: string; limit?: number; includeArchived?: boolean; name?: string; max?: number }): Promise<{\n    transitions: unknown[];\n    labels: string[];\n    certifications: unknown[];\n  }>;\n  complexity(args?: { files?: string[]; paths?: string[] }): Promise<{ files: FabricStateComplexityFile[]; netDelta: number }>;\n  verify(args?: { labels?: string[]; includeArchived?: boolean; timeoutMs?: number; label?: string }): Promise<FabricStateVerificationResult>;\n  goal(args: { check: string; description?: string; command?: string; cmd?: string; predicate?: string }): Promise<FabricMeshStateEntry<{ check: string; description?: string }>>;\n  checkGoal(args?: { timeoutMs?: number }): Promise<{\n    passed: boolean;\n    output: string;\n    exitCode: number | null;\n    error?: string;\n  }>;\n}\ntype FabricSchemaEvidence =\n  | { kind: \"file_exists\"; path: string }\n  | { kind: \"file_absent\"; path: string }\n  | { kind: \"file_contains\"; path: string; literal: string }\n  | { kind: \"file_sha256\"; path: string; sha256: string }\n  | { kind: \"trusted_command\"; name: string };\ntype FabricSchemaFileOperation =\n  | { kind: \"write\"; path: string; content: string; expected: { absent: true } | { sha256: string } }\n  | { kind: \"edit\"; path: string; oldText: string; newText: string; expectedSha256: string }\n  | { kind: \"delete\"; path: string; expectedSha256: string };\ninterface FabricSchemaEvidenceResult {\n  evidence: FabricSchemaEvidence;\n  status: \"confirmed\" | \"nonconfirmed\" | \"error\";\n  detail: string;\n  exitCode?: number | null;\n  output?: string;\n  observedSha256?: string;\n}\ninterface FabricSchemaStatus {\n  mode: \"off\" | \"audit\" | \"enforce\";\n  certificateTtlMs: number;\n  maxFiles: number;\n  maxBytes: number;\n  trustedCommands: string[];\n  generation: number;\n  lastOutcome: \"committed\" | \"rolled_back\" | \"quarantined\" | null;\n  hypotheses: Array<{\n    id: string;\n    label: string;\n    status: string;\n    generation: number;\n    updatedAt: number;\n  }>;\n}\ninterface FabricSchemaVerificationResult {\n  verified: boolean;\n  hypothesisId: string;\n  certificate?: string;\n  issuedAt?: number;\n  expiresAt?: number;\n  reason?: string;\n  results: FabricSchemaEvidenceResult[];\n}\ninterface FabricSchemaCommitResult {\n  outcome: \"committed\" | \"rolled_back\" | \"quarantined\";\n  transactionId: string;\n  generation?: number;\n  paths?: string[];\n  postconditions?: FabricSchemaEvidenceResult[];\n  complexityReductionCertified?: boolean;\n  stateTransition?: unknown;\n  error?: string;\n  rollbackError?: string;\n}\ninterface FabricSchemaApi {\n  status(): Promise<FabricSchemaStatus>;\n  hypothesize(args: {\n    label: string;\n    summary: string;\n    evidence: FabricSchemaEvidence[];\n    complexityReduction?: boolean;\n    name?: string;\n    description?: string;\n    complexity_reduction?: boolean;\n  }): Promise<{\n    hypothesisId: string;\n    status: string;\n    state: unknown;\n    fingerprint: string;\n    generation: number;\n  }>;\n  verify(args: { hypothesisId: string; id?: string; hypothesis_id?: string }): Promise<FabricSchemaVerificationResult>;\n  commit(args: {\n    hypothesisId: string;\n    certificate: string;\n    operations: FabricSchemaFileOperation[];\n    postconditions: FabricSchemaEvidence[];\n    id?: string;\n    hypothesis_id?: string;\n  }): Promise<FabricSchemaCommitResult>;\n  abort(args: { hypothesisId: string; certificate?: string; id?: string; hypothesis_id?: string }): Promise<{\n    aborted: true;\n    hypothesisId: string;\n  }>;\n}\ninterface FabricCompactPendingIntent {\n  reason?: string;\n  instructions?: string;\n  preserve?: string[];\n  requestedBy: string;\n  requestedAt: number;\n}\ninterface FabricCompactLastCommit {\n  at: number;\n  requestedBy: string;\n  status: \"committed\" | \"cancelled\" | \"failed\";\n  summary?: string;\n  tokensBefore?: number;\n  estimatedTokensAfter?: number;\n  error?: string;\n}\ntype FabricComponentState = \"waiting\" | \"loading\" | \"active\" | \"unloading\" | \"failed\" | \"quarantined\" | \"disposed\";\ninterface FabricComponentEffectInfo {\n  label: string;\n  kind: \"none\" | \"scoped\" | \"transactional\" | \"emission\";\n  resources: string[];\n  ordering: \"commutative\" | \"ordered\" | \"unknown\";\n}\ninterface FabricComponentEffectConflict {\n  withComponent: string;\n  resources: string[];\n  reason: \"shared_resource\" | \"unknown_resource\";\n}\ninterface FabricComponentInfo {\n  id: string;\n  component: string;\n  parentId?: string;\n  state: FabricComponentState;\n  guarantee: \"managed\" | \"revertible\";\n  requirements: string[];\n  provisions: string[];\n  missing: string[];\n  optionalMissing: string[];\n  effects?: FabricComponentEffectInfo[];\n  effectConflicts?: FabricComponentEffectConflict[];\n  targetDigest?: string;\n  error?: string;\n  cleanupErrors?: string[];\n  revision: number;\n  createdAt: number;\n  updatedAt: number;\n}\ninterface FabricComponentsApi {\n  list(): Promise<{\n    definitions: Array<{ name: string; description?: string; revision: number; requirements: string[]; provisions: string[] }>;\n    components: FabricComponentInfo[];\n  }>;\n  status(args: { id: string }): Promise<FabricComponentInfo>;\n  graph(): Promise<{\n    components: FabricComponentInfo[];\n    edges: Array<{ from: string; to: string; ref: string; kind?: \"dependency\" | \"ownership\" }>;\n    cycles: string[][];\n  }>;\n  reload(args?: { id?: string }): Promise<{ components: FabricComponentInfo[] }>;\n}\n\ninterface FabricCompactApi {\n  request(args?: {\n    reason?: string;\n    instructions?: string;\n    preserve?: string[];\n    requestedBy?: string;\n    instruction?: string;\n    requested_by?: string;\n  }): Promise<{ requested: true; intent: FabricCompactPendingIntent }>;\n  status(): Promise<{ pending?: FabricCompactPendingIntent; last?: FabricCompactLastCommit }>;\n  cancel(): Promise<{ cancelled: true }>;\n}\n\ninterface FabricWorkflowAgentOptions extends Omit<FabricAgentRequest, \"task\"> {\n  label?: string;\n}\ntype FabricActivityStatus = \"pending\" | \"running\" | \"completed\" | \"failed\" | \"blocked\" | \"stopped\";\ntype FabricActivityKind = \"agent\" | \"actor\" | \"tool\" | \"extension\" | \"mcp\" | \"mesh\" | \"task\" | \"custom\";\ninterface FabricWorkflowDisplay {\n  name?: string;\n  description?: string;\n}\ninterface FabricWorkflowPhaseOptions {\n  id?: string;\n  description?: string;\n  total?: number;\n}\ninterface FabricWorkflowPhaseInput extends FabricWorkflowPhaseOptions {\n  name: string;\n}\ninterface FabricWorkflowItem {\n  id: string;\n  label: string;\n  status?: FabricActivityStatus;\n  phase?: string;\n  detail?: string;\n  kind?: FabricActivityKind;\n  current?: string;\n  total?: number;\n  completed?: number;\n  data?: unknown;\n}\ninterface FabricWorkflowApi {\n  agent<T = string>(prompt: string, options?: FabricWorkflowAgentOptions): Promise<T>;\n  parallel<T, R>(items: T[], mapper: (item: T, index: number) => Promise<R> | R, concurrency?: number | { concurrency?: number }): Promise<R[]>;\n  parallel<T>(thunks: Array<() => Promise<T> | T>, concurrency?: number | { concurrency?: number }): Promise<T[]>;\n  pipeline<T>(items: T[], ...stages: Array<(value: unknown, original: T, index: number) => Promise<unknown> | unknown>): Promise<unknown[]>;\n  configure(display: FabricWorkflowDisplay): Promise<FabricWorkflowDisplay>;\n  phase(name: string, options?: FabricWorkflowPhaseOptions): Promise<{ name: string; index: number; id?: string }>;\n  phase(input: FabricWorkflowPhaseInput): Promise<{ name: string; index: number; id?: string }>;\n  item(item: FabricWorkflowItem): Promise<FabricWorkflowItem>;\n  event(event: { message: string; level?: \"info\" | \"success\" | \"warning\" | \"error\"; data?: unknown }): Promise<void>;\n  log(...values: unknown[]): void;\n  budget: { total: number; spent(): number; remaining(): number };\n}\ndeclare const tools: FabricToolsApi;\ndeclare const omp: OmpToolsApi;\ndeclare const extensions: FabricExtensionsApi;\ndeclare const agents: FabricAgentsApi;\ndeclare const mesh: FabricMeshApi;\ndeclare const mcp: FabricMcpApi;\ndeclare const memory: FabricMemoryApi;\ndeclare const state: FabricStateApi;\ndeclare const schema: FabricSchemaApi;\ndeclare const components: FabricComponentsApi;\ndeclare const compact: FabricCompactApi;\ndeclare const council: FabricCouncilApi;\ndeclare const workflow: FabricWorkflowApi;\ndeclare function agent<T = string>(prompt: string, options?: FabricWorkflowAgentOptions): Promise<T>;\ndeclare function parallel<T, R>(items: T[], mapper: (item: T, index: number) => Promise<R> | R, concurrency?: number | { concurrency?: number }): Promise<R[]>;\ndeclare function parallel<T>(thunks: Array<() => Promise<T> | T>, concurrency?: number | { concurrency?: number }): Promise<T[]>;\ndeclare function pipeline<T>(items: T[], ...stages: Array<(value: unknown, original: T, index: number) => Promise<unknown> | unknown>): Promise<unknown[]>;\ndeclare function phase(name: string, options?: FabricWorkflowPhaseOptions): Promise<{ name: string; index: number; id?: string }>;\ndeclare function phase(input: FabricWorkflowPhaseInput): Promise<{ name: string; index: number; id?: string }>;\ndeclare function log(...values: unknown[]): void;\ndeclare const budget: FabricWorkflowApi[\"budget\"];\ntype FabricRlmRequest = Omit<FabricAgentRequest, \"runner\" | \"recursive\" | \"cwd\"> & { runner?: \"omp\" };\ndeclare const rlm: { query(args: FabricRlmRequest): Promise<FabricAgentResult> };\ninterface FabricConsole {\n  log(...args: unknown[]): void;\n  info(...args: unknown[]): void;\n  warn(...args: unknown[]): void;\n  error(...args: unknown[]): void;\n}\ndeclare const console: FabricConsole;\ndeclare const payloads: Readonly<Record<string, string>>;\ndeclare function print(...args: unknown[]): void;\ndeclare function setTimeout(handler: (...args: any[]) => void, timeout?: number): number;\ndeclare function clearTimeout(handle: number): void;\ndeclare function setInterval(handler: (...args: any[]) => void, timeout?: number): number;\ndeclare function clearInterval(handle: number): void;\n";
+export interface FabricGuestDeclarationOptions {
+    /** Global names to omit (for example providers disabled by configuration). */
+    excludeGlobals?: readonly string[];
+    /**
+     * Pre-rendered replacement blocks from buildDynamicGuestDeclarations().
+     * Applied only when the loose anchor line is still present — excluded
+     * globals (or orchestration-only mode, for extensions) keep nothing to
+     * replace, and missing/undefined sections keep the loose surface.
+     */
+    dynamic?: FabricDynamicGuestDeclarations;
+    /** Add captured core overloads to the full-code OMP declaration. */
+    coreOverrides?: string;
+}
+export declare const guestTypeDeclarations: (fullCodeMode: boolean, options?: FabricGuestDeclarationOptions) => string;
+//# sourceMappingURL=guest-types.d.ts.map

package/dist/runtime/guest-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guest-types.d.ts","sourceRoot":"","sources":["../../src/runtime/guest-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAQrE,eAAO,MAAM,0CAA0C;;;;;;;;CAQ7C,CAAC;AAEX,eAAO,MAAM,uBAAuB;;;;;;;;CAQ1B,CAAC;AAEX,eAAO,MAAM,uBAAuB,mw9CAmvCnC,CAAC;AAWF,MAAM,WAAW,6BAA6B;IAC5C,8EAA8E;IAC9E,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,8BAA8B,CAAC;IACzC,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAQD,eAAO,MAAM,qBAAqB,GAChC,cAAc,OAAO,EACrB,UAAS,6BAAkC,KAC1C,MA8BF,CAAC"}

package/dist/runtime/guest-types.js

@@ -0,0 +1,13 @@
+import {
+  GUEST_TYPE_DECLARATIONS,
+  OMP_CORE_COMPATIBILITY_ARGUMENT_TYPE_NAMES,
+  OMP_CORE_NUMERIC_FIELDS,
+  guestTypeDeclarations
+} from "../chunks/chunk-JP4LIZFT.js";
+export {
+  GUEST_TYPE_DECLARATIONS,
+  OMP_CORE_COMPATIBILITY_ARGUMENT_TYPE_NAMES,
+  OMP_CORE_NUMERIC_FIELDS,
+  guestTypeDeclarations
+};
+//# sourceMappingURL=guest-types.js.map

package/dist/runtime/guest-types.js.map

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

package/dist/runtime/node-process-child-source.d.ts

@@ -0,0 +1,2 @@
+export declare const NODE_PROCESS_CHILD_SOURCE: string;
+//# sourceMappingURL=node-process-child-source.d.ts.map

package/dist/runtime/node-process-child-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-process-child-source.d.ts","sourceRoot":"","sources":["../../src/runtime/node-process-child-source.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,yBAAyB,QAyGrC,CAAC"}

package/dist/runtime/node-process-runtime.d.ts

@@ -0,0 +1,10 @@
+import { type FabricHostCall, type FabricSandboxOptions, type FabricSandboxResult } from "./quickjs-runtime.js";
+export declare class NodeProcessRuntime {
+    #private;
+    constructor(interpreter?: "node" | "bun");
+    execute(code: string, hostCall: FabricHostCall, options: FabricSandboxOptions): Promise<FabricSandboxResult>;
+}
+export declare class BunProcessRuntime extends NodeProcessRuntime {
+    constructor();
+}
+//# sourceMappingURL=node-process-runtime.d.ts.map

package/dist/runtime/node-process-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-process-runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/node-process-runtime.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AA8B9B,qBAAa,kBAAkB;;gBAGjB,WAAW,GAAE,MAAM,GAAG,KAAc;IAI1C,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;CAqLhC;AAED,qBAAa,iBAAkB,SAAQ,kBAAkB;;CAIxD"}

package/dist/runtime/node-process-runtime.js

@@ -0,0 +1,319 @@
+import {
+  GUEST_SETUP,
+  createGuestStackMap,
+  remapGuestErrorText
+} from "../chunks/chunk-5GTPD4BA.js";
+import {
+  OMP_GUEST_ENTRYPOINT,
+  transpileFabricCodeWithSourceMap
+} from "../chunks/chunk-JHKOG5GS.js";
+import {
+  ompBashExitMetadata
+} from "../chunks/chunk-6X6WUU2K.js";
+import {
+  runAbortable,
+  settleWithin
+} from "../chunks/chunk-7TB7NXSL.js";
+import {
+  resolveScriptRuntime,
+  resolveScriptRuntimeSync
+} from "../chunks/chunk-ZTM45GH5.js";
+import {
+  isOmpShellRef
+} from "../chunks/chunk-6N4XGAZY.js";
+
+// src/runtime/node-process-runtime.ts
+import { spawn } from "node:child_process";
+
+// src/runtime/node-process-child-source.ts
+var NODE_PROCESS_CHILD_SOURCE = String.raw`
+import vm from "node:vm";
+
+const pending = new Map();
+let nextCallId = 0;
+
+const send = (message) => {
+  if (process.connected) process.send?.(message);
+};
+
+const formatValue = (value) => {
+  if (typeof value === "string") return value;
+  if (value instanceof Error) return value.stack ?? value.message;
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+};
+
+const jsonCompatible = (value) => {
+  if (value === undefined) return undefined;
+  const serialized = JSON.stringify(value);
+  return serialized === undefined ? undefined : JSON.parse(serialized);
+};
+
+const run = async (message) => {
+  const logs = [];
+  let logChars = 0;
+  let logsTruncated = false;
+  const hostCall = (ref, args) => {
+    const id = nextCallId++;
+    return new Promise((resolve, reject) => {
+      pending.set(id, { resolve, reject });
+      send({
+        type: "call",
+        id,
+        ref: String(ref),
+        args:
+          typeof args === "object" && args !== null && !Array.isArray(args)
+            ? args
+            : {},
+      });
+    });
+  };
+  const print = (...values) => {
+    if (logsTruncated) return;
+    const line = values.map(formatValue).join(" ");
+    const remaining = message.maxLogChars - logChars;
+    if (line.length > remaining) {
+      if (remaining > 0) logs.push(line.slice(0, remaining));
+      logs.push("[OMP Fabric log output truncated]");
+      logsTruncated = true;
+      return;
+    }
+    logs.push(line);
+    logChars += line.length;
+  };
+  const sandbox = {
+    __fabricHostCall: hostCall,
+    __fabricTokenBudget: message.tokenBudget ?? Number.POSITIVE_INFINITY,
+    print,
+    payloads: jsonCompatible(message.payloads),
+  };
+  const context = vm.createContext(sandbox, {
+    name: "omp-fabric-node-process",
+    codeGeneration: { strings: true, wasm: false },
+  });
+
+  try {
+    vm.runInContext(message.setup, context, { filename: "omp-fabric-setup.js" });
+    const promise = vm.runInContext(message.code + "\n" + "${OMP_GUEST_ENTRYPOINT}()", context, {
+      filename: "omp-fabric-guest.js",
+    });
+    const value = jsonCompatible(await promise);
+    send({ type: "result", result: { value, logs, terminationReason: "completed" } });
+  } catch (error) {
+    send({
+      type: "result",
+      result: {
+        logs,
+        terminationReason: "runtime_error",
+        error: error?.stack ?? error?.message ?? String(error),
+      },
+    });
+  }
+};
+
+process.on("message", (message) => {
+  if (typeof message !== "object" || message === null) return;
+  if (message.type === "execute") {
+    void run(message);
+    return;
+  }
+  if (message.type !== "response") return;
+  const operation = pending.get(message.id);
+  if (!operation) return;
+  pending.delete(message.id);
+  if (message.ok) operation.resolve(message.value);
+  else {
+    const error = new Error(message.error ?? "Host call failed");
+    if (message.bashExit) error.__fabricBashExit = message.bashExit;
+    operation.reject(error);
+  }
+});
+`;
+
+// src/runtime/node-process-runtime.ts
+var HOST_TASK_SETTLE_GRACE_MS = 250;
+var send = (child, message) => {
+  if (!child.connected) return;
+  child.send(message, () => void 0);
+};
+var NodeProcessRuntime = class {
+  #interpreter;
+  constructor(interpreter = "node") {
+    this.#interpreter = interpreter;
+  }
+  async execute(code, hostCall, options) {
+    if (options.signal?.aborted) {
+      return {
+        value: void 0,
+        logs: [],
+        terminationReason: "aborted",
+        error: "Execution cancelled"
+      };
+    }
+    if (!Number.isSafeInteger(options.memoryLimitBytes) || options.memoryLimitBytes < 1) {
+      return {
+        value: void 0,
+        logs: [],
+        terminationReason: "runtime_error",
+        error: "Process memory limit must be a positive safe integer"
+      };
+    }
+    const runtimeOptions = this.#interpreter === "bun" ? { requireBun: true } : { requireNode: true };
+    const interpreterPath = this.#interpreter === "bun" ? await resolveScriptRuntime(runtimeOptions) : resolveScriptRuntimeSync(runtimeOptions);
+    const child = spawn(
+      interpreterPath,
+      this.#interpreter === "bun" ? ["--eval", NODE_PROCESS_CHILD_SOURCE] : [
+        `--max-old-space-size=${Math.max(16, Math.floor(options.memoryLimitBytes / (1024 * 1024)))}`,
+        "--input-type=module",
+        "--eval",
+        NODE_PROCESS_CHILD_SOURCE
+      ],
+      { stdio: ["ignore", "ignore", "ignore", "ipc"] }
+    );
+    if (options.signal?.aborted) {
+      return {
+        value: void 0,
+        logs: [],
+        terminationReason: "aborted",
+        error: "Execution cancelled"
+      };
+    }
+    const hostAbortController = new AbortController();
+    const startedAt = Date.now();
+    let effectiveTimeoutMs = options.timeoutMs;
+    let deadlineAt = startedAt + effectiveTimeoutMs;
+    let deadline;
+    let abortHandler;
+    let settled = false;
+    let finishing = false;
+    const hostTasks = /* @__PURE__ */ new Set();
+    const guestBundle = options.transpiledCode === void 0 ? transpileFabricCodeWithSourceMap(code) : { code: options.transpiledCode, sourceMap: options.transpiledSourceMap };
+    const guestStackMap = createGuestStackMap(guestBundle.sourceMap);
+    const guestLineCount = guestBundle.code.split("\n").length;
+    return new Promise((resolve) => {
+      const finish = (result) => {
+        if (settled) return;
+        settled = true;
+        if (deadline) clearTimeout(deadline);
+        if (abortHandler) options.signal?.removeEventListener("abort", abortHandler);
+        if (!hostAbortController.signal.aborted && hostTasks.size > 0) {
+          hostAbortController.abort(new Error(result.error ?? "Process execution stopped"));
+        }
+        child.removeAllListeners();
+        if (child.connected) child.disconnect();
+        if (child.exitCode === null && child.signalCode === null) child.kill("SIGKILL");
+        resolve(result);
+      };
+      const scheduleDeadline = () => {
+        if (deadline) clearTimeout(deadline);
+        deadline = setTimeout(() => {
+          const error = `Execution timed out after ${effectiveTimeoutMs}ms`;
+          finish({ value: void 0, logs: [], terminationReason: "timed_out", error });
+        }, Math.max(0, deadlineAt - Date.now()));
+        deadline.unref?.();
+      };
+      const extendDeadline = (ref, args) => {
+        const requested = options.minimumTimeoutMsForHostCall?.(ref, args);
+        if (typeof requested !== "number" || !Number.isFinite(requested)) return;
+        const nextDeadlineAt = Date.now() + Math.max(1, Math.floor(requested));
+        if (nextDeadlineAt <= deadlineAt) return;
+        deadlineAt = nextDeadlineAt;
+        effectiveTimeoutMs = deadlineAt - startedAt;
+        scheduleDeadline();
+      };
+      abortHandler = () => {
+        finish({
+          value: void 0,
+          logs: [],
+          terminationReason: "aborted",
+          error: "Execution cancelled"
+        });
+      };
+      options.signal?.addEventListener("abort", abortHandler, { once: true });
+      child.on("message", (raw) => {
+        if (settled || finishing || typeof raw !== "object" || raw === null) return;
+        const message = raw;
+        if (message.type === "result") {
+          finishing = true;
+          if (deadline) clearTimeout(deadline);
+          if (message.result.terminationReason !== "completed" && !hostAbortController.signal.aborted) {
+            hostAbortController.abort(new Error(message.result.error ?? "Process execution stopped"));
+          }
+          void (async () => {
+            const completed = await settleWithin(hostTasks, HOST_TASK_SETTLE_GRACE_MS);
+            if (!completed && !hostAbortController.signal.aborted) {
+              hostAbortController.abort(
+                new Error("Fabric guest execution ended before its host calls settled")
+              );
+              await settleWithin(hostTasks, HOST_TASK_SETTLE_GRACE_MS);
+            }
+            finish(
+              message.result.error === void 0 ? message.result : {
+                ...message.result,
+                error: remapGuestErrorText(message.result.error, guestStackMap, guestLineCount)
+              }
+            );
+          })();
+          return;
+        }
+        if (message.type !== "call") return;
+        extendDeadline(message.ref, message.args);
+        const task = runAbortable(
+          hostAbortController.signal,
+          () => hostCall(message.ref, message.args, hostAbortController.signal)
+        ).then(
+          (value) => send(child, { type: "response", id: message.id, ok: true, value }),
+          (error) => send(child, {
+            type: "response",
+            id: message.id,
+            ok: false,
+            error: error instanceof Error ? error.message : String(error),
+            bashExit: isOmpShellRef(message.ref) ? ompBashExitMetadata(error) : void 0
+          })
+        );
+        hostTasks.add(task);
+        void task.finally(() => hostTasks.delete(task));
+      });
+      child.once("error", (error) => {
+        finish({
+          value: void 0,
+          logs: [],
+          terminationReason: "runtime_error",
+          error: `Process executor failed: ${error.message}`
+        });
+      });
+      child.once("exit", (exitCode, signal) => {
+        if (settled) return;
+        const detail = signal ? `signal ${signal}` : `exit code ${exitCode ?? "unknown"}`;
+        finish({
+          value: void 0,
+          logs: [],
+          terminationReason: "runtime_error",
+          error: `Process executor exited before returning a result (${detail}); it may have exceeded its memory limit`
+        });
+      });
+      scheduleDeadline();
+      send(child, {
+        type: "execute",
+        setup: GUEST_SETUP,
+        code: guestBundle.code,
+        payloads: options.payloads ?? {},
+        tokenBudget: options.tokenBudget,
+        maxLogChars: options.maxLogChars ?? 1e5
+      });
+    });
+  }
+};
+var BunProcessRuntime = class extends NodeProcessRuntime {
+  constructor() {
+    super("bun");
+  }
+};
+export {
+  BunProcessRuntime,
+  NodeProcessRuntime
+};
+//# sourceMappingURL=node-process-runtime.js.map

package/dist/runtime/node-process-runtime.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/runtime/node-process-runtime.ts", "../../src/runtime/node-process-child-source.ts"],
+  "sourcesContent": ["import { spawn, type ChildProcess } from \"node:child_process\";\nimport { runAbortable, settleWithin } from \"../async-settlement.js\";\nimport { ompBashExitMetadata } from \"../core/omp-bash-error.js\";\nimport { isOmpShellRef } from \"../core/omp-tools.js\";\nimport {\n  GUEST_SETUP,\n  type FabricHostCall,\n  type FabricSandboxOptions,\n  type FabricSandboxResult,\n} from \"./quickjs-runtime.js\";\nimport { NODE_PROCESS_CHILD_SOURCE } from \"./node-process-child-source.js\";\nimport { createGuestStackMap, remapGuestErrorText } from \"./guest-stack-map.js\";\nimport { transpileFabricCodeWithSourceMap } from \"./type-checker.js\";\nimport {\n  resolveScriptRuntime,\n  resolveScriptRuntimeSync,\n} from \"../agents/transports/process-utils.js\";\n\ninterface ChildCallMessage {\n  type: \"call\";\n  id: number;\n  ref: string;\n  args: Record<string, unknown>;\n}\n\ninterface ChildResultMessage {\n  type: \"result\";\n  result: FabricSandboxResult;\n}\n\ntype ChildMessage = ChildCallMessage | ChildResultMessage;\n\nconst HOST_TASK_SETTLE_GRACE_MS = 250;\n\nconst send = (child: ChildProcess, message: any): void => {\n  if (!child.connected) return;\n  child.send(message, () => undefined);\n};\n\nexport class NodeProcessRuntime {\n  readonly #interpreter: \"node\" | \"bun\";\n\n  constructor(interpreter: \"node\" | \"bun\" = \"node\") {\n    this.#interpreter = interpreter;\n  }\n\n  async execute(\n    code: string,\n    hostCall: FabricHostCall,\n    options: FabricSandboxOptions,\n  ): Promise<FabricSandboxResult> {\n    if (options.signal?.aborted) {\n      return {\n        value: undefined,\n        logs: [],\n        terminationReason: \"aborted\",\n        error: \"Execution cancelled\",\n      };\n    }\n    if (!Number.isSafeInteger(options.memoryLimitBytes) || options.memoryLimitBytes < 1) {\n      return {\n        value: undefined,\n        logs: [],\n        terminationReason: \"runtime_error\",\n        error: \"Process memory limit must be a positive safe integer\",\n      };\n    }\n\n    // Bun evaluates --eval input as ESM and ignores V8 heap flags, so the\n    // Bun child gets the guest source bare; Node needs the module + heap flags.\n    // Bun resolution stays async: OMP may legitimately run under Node while bun\n    // is only available on PATH, and the sync variant does no PATH lookup.\n    const runtimeOptions = this.#interpreter === \"bun\" ? { requireBun: true } : { requireNode: true };\n    const interpreterPath = this.#interpreter === \"bun\"\n      ? await resolveScriptRuntime(runtimeOptions)\n      : resolveScriptRuntimeSync(runtimeOptions);\n    const child = spawn(\n      interpreterPath,\n      this.#interpreter === \"bun\"\n        ? [\"--eval\", NODE_PROCESS_CHILD_SOURCE]\n        : [\n            `--max-old-space-size=${Math.max(16, Math.floor(options.memoryLimitBytes / (1024 * 1024)))}`,\n            \"--input-type=module\",\n            \"--eval\",\n            NODE_PROCESS_CHILD_SOURCE,\n          ],\n      { stdio: [\"ignore\", \"ignore\", \"ignore\", \"ipc\"] },\n    );\n    // Bun resolution is async, so the signal may have aborted while resolving.\n    if (options.signal?.aborted) {\n      return {\n        value: undefined,\n        logs: [],\n        terminationReason: \"aborted\",\n        error: \"Execution cancelled\",\n      };\n    }\n    const hostAbortController = new AbortController();\n    const startedAt = Date.now();\n    let effectiveTimeoutMs = options.timeoutMs;\n    let deadlineAt = startedAt + effectiveTimeoutMs;\n    let deadline: NodeJS.Timeout | undefined;\n    let abortHandler: (() => void) | undefined;\n    let settled = false;\n    let finishing = false;\n    const hostTasks = new Set<Promise<void>>();\n\n    const guestBundle = options.transpiledCode === undefined\n      ? transpileFabricCodeWithSourceMap(code)\n      : { code: options.transpiledCode, sourceMap: options.transpiledSourceMap };\n    const guestStackMap = createGuestStackMap(guestBundle.sourceMap);\n    const guestLineCount = guestBundle.code.split(\"\\n\").length;\n\n    return new Promise<FabricSandboxResult>((resolve) => {\n      const finish = (result: FabricSandboxResult): void => {\n        if (settled) return;\n        settled = true;\n        if (deadline) clearTimeout(deadline);\n        if (abortHandler) options.signal?.removeEventListener(\"abort\", abortHandler);\n        if (!hostAbortController.signal.aborted && hostTasks.size > 0) {\n          hostAbortController.abort(new Error(result.error ?? \"Process execution stopped\"));\n        }\n        child.removeAllListeners();\n        if (child.connected) child.disconnect();\n        if (child.exitCode === null && child.signalCode === null) child.kill(\"SIGKILL\");\n        resolve(result);\n      };\n      const scheduleDeadline = (): void => {\n        if (deadline) clearTimeout(deadline);\n        deadline = setTimeout(() => {\n          const error = `Execution timed out after ${effectiveTimeoutMs}ms`;\n          finish({ value: undefined, logs: [], terminationReason: \"timed_out\", error });\n        }, Math.max(0, deadlineAt - Date.now()));\n        deadline.unref?.();\n      };\n      const extendDeadline = (ref: string, args: Record<string, unknown>): void => {\n        const requested = options.minimumTimeoutMsForHostCall?.(ref, args);\n        if (typeof requested !== \"number\" || !Number.isFinite(requested)) return;\n        const nextDeadlineAt = Date.now() + Math.max(1, Math.floor(requested));\n        if (nextDeadlineAt <= deadlineAt) return;\n        deadlineAt = nextDeadlineAt;\n        effectiveTimeoutMs = deadlineAt - startedAt;\n        scheduleDeadline();\n      };\n\n      abortHandler = () => {\n        finish({\n          value: undefined,\n          logs: [],\n          terminationReason: \"aborted\",\n          error: \"Execution cancelled\",\n        });\n      };\n      options.signal?.addEventListener(\"abort\", abortHandler, { once: true });\n\n      child.on(\"message\", (raw: unknown) => {\n        if (settled || finishing || typeof raw !== \"object\" || raw === null) return;\n        const message = raw as ChildMessage;\n        if (message.type === \"result\") {\n          finishing = true;\n          if (deadline) clearTimeout(deadline);\n          if (message.result.terminationReason !== \"completed\" && !hostAbortController.signal.aborted) {\n            hostAbortController.abort(new Error(message.result.error ?? \"Process execution stopped\"));\n          }\n          void (async () => {\n            const completed = await settleWithin(hostTasks, HOST_TASK_SETTLE_GRACE_MS);\n            if (!completed && !hostAbortController.signal.aborted) {\n              hostAbortController.abort(\n                new Error(\"Fabric guest execution ended before its host calls settled\"),\n              );\n              await settleWithin(hostTasks, HOST_TASK_SETTLE_GRACE_MS);\n            }\n            finish(\n              message.result.error === undefined\n                ? message.result\n                : {\n                    ...message.result,\n                    error: remapGuestErrorText(message.result.error, guestStackMap, guestLineCount),\n                  },\n            );\n          })();\n          return;\n        }\n        if (message.type !== \"call\") return;\n        extendDeadline(message.ref, message.args);\n        const task = runAbortable(hostAbortController.signal, () =>\n          hostCall(message.ref, message.args, hostAbortController.signal),\n        ).then(\n          (value) => send(child, { type: \"response\", id: message.id, ok: true, value }),\n          (error) =>\n            send(child, {\n              type: \"response\",\n              id: message.id,\n              ok: false,\n              error: error instanceof Error ? error.message : String(error),\n              bashExit: isOmpShellRef(message.ref) ? ompBashExitMetadata(error) : undefined,\n            }),\n        );\n        hostTasks.add(task);\n        void task.finally(() => hostTasks.delete(task));\n      });\n      child.once(\"error\", (error) => {\n        finish({\n          value: undefined,\n          logs: [],\n          terminationReason: \"runtime_error\",\n          error: `Process executor failed: ${error.message}`,\n        });\n      });\n      child.once(\"exit\", (exitCode, signal) => {\n        if (settled) return;\n        const detail = signal ? `signal ${signal}` : `exit code ${exitCode ?? \"unknown\"}`;\n        finish({\n          value: undefined,\n          logs: [],\n          terminationReason: \"runtime_error\",\n          error: `Process executor exited before returning a result (${detail}); it may have exceeded its memory limit`,\n        });\n      });\n\n      scheduleDeadline();\n      send(child, {\n        type: \"execute\",\n        setup: GUEST_SETUP,\n        code: guestBundle.code,\n        payloads: options.payloads ?? {},\n        tokenBudget: options.tokenBudget,\n        maxLogChars: options.maxLogChars ?? 100_000,\n      });\n    });\n  }\n}\n\nexport class BunProcessRuntime extends NodeProcessRuntime {\n  constructor() {\n    super(\"bun\");\n  }\n}\n", "import { OMP_GUEST_ENTRYPOINT } from \"./type-checker.js\";\nexport const NODE_PROCESS_CHILD_SOURCE = String.raw`\nimport vm from \"node:vm\";\n\nconst pending = new Map();\nlet nextCallId = 0;\n\nconst send = (message) => {\n  if (process.connected) process.send?.(message);\n};\n\nconst formatValue = (value) => {\n  if (typeof value === \"string\") return value;\n  if (value instanceof Error) return value.stack ?? value.message;\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n};\n\nconst jsonCompatible = (value) => {\n  if (value === undefined) return undefined;\n  const serialized = JSON.stringify(value);\n  return serialized === undefined ? undefined : JSON.parse(serialized);\n};\n\nconst run = async (message) => {\n  const logs = [];\n  let logChars = 0;\n  let logsTruncated = false;\n  const hostCall = (ref, args) => {\n    const id = nextCallId++;\n    return new Promise((resolve, reject) => {\n      pending.set(id, { resolve, reject });\n      send({\n        type: \"call\",\n        id,\n        ref: String(ref),\n        args:\n          typeof args === \"object\" && args !== null && !Array.isArray(args)\n            ? args\n            : {},\n      });\n    });\n  };\n  const print = (...values) => {\n    if (logsTruncated) return;\n    const line = values.map(formatValue).join(\" \");\n    const remaining = message.maxLogChars - logChars;\n    if (line.length > remaining) {\n      if (remaining > 0) logs.push(line.slice(0, remaining));\n      logs.push(\"[OMP Fabric log output truncated]\");\n      logsTruncated = true;\n      return;\n    }\n    logs.push(line);\n    logChars += line.length;\n  };\n  const sandbox = {\n    __fabricHostCall: hostCall,\n    __fabricTokenBudget: message.tokenBudget ?? Number.POSITIVE_INFINITY,\n    print,\n    payloads: jsonCompatible(message.payloads),\n  };\n  const context = vm.createContext(sandbox, {\n    name: \"omp-fabric-node-process\",\n    codeGeneration: { strings: true, wasm: false },\n  });\n\n  try {\n    vm.runInContext(message.setup, context, { filename: \"omp-fabric-setup.js\" });\n    const promise = vm.runInContext(message.code + \"\\n\" + \"${OMP_GUEST_ENTRYPOINT}()\", context, {\n      filename: \"omp-fabric-guest.js\",\n    });\n    const value = jsonCompatible(await promise);\n    send({ type: \"result\", result: { value, logs, terminationReason: \"completed\" } });\n  } catch (error) {\n    send({\n      type: \"result\",\n      result: {\n        logs,\n        terminationReason: \"runtime_error\",\n        error: error?.stack ?? error?.message ?? String(error),\n      },\n    });\n  }\n};\n\nprocess.on(\"message\", (message) => {\n  if (typeof message !== \"object\" || message === null) return;\n  if (message.type === \"execute\") {\n    void run(message);\n    return;\n  }\n  if (message.type !== \"response\") return;\n  const operation = pending.get(message.id);\n  if (!operation) return;\n  pending.delete(message.id);\n  if (message.ok) operation.resolve(message.value);\n  else {\n    const error = new Error(message.error ?? \"Host call failed\");\n    if (message.bashExit) error.__fabricBashExit = message.bashExit;\n    operation.reject(error);\n  }\n});\n`;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,aAAgC;;;ACClC,IAAM,4BAA4B,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,6DAuEa,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ADxCjF,IAAM,4BAA4B;AAElC,IAAM,OAAO,CAAC,OAAqB,YAAuB;AACxD,MAAI,CAAC,MAAM,UAAW;AACtB,QAAM,KAAK,SAAS,MAAM,MAAS;AACrC;AAEO,IAAM,qBAAN,MAAyB;AAAA,EACrB;AAAA,EAET,YAAY,cAA8B,QAAQ;AAChD,SAAK,eAAe;AAAA,EACtB;AAAA,EAEA,MAAM,QACJ,MACA,UACA,SAC8B;AAC9B,QAAI,QAAQ,QAAQ,SAAS;AAC3B,aAAO;AAAA,QACL,OAAO;AAAA,QACP,MAAM,CAAC;AAAA,QACP,mBAAmB;AAAA,QACnB,OAAO;AAAA,MACT;AAAA,IACF;AACA,QAAI,CAAC,OAAO,cAAc,QAAQ,gBAAgB,KAAK,QAAQ,mBAAmB,GAAG;AACnF,aAAO;AAAA,QACL,OAAO;AAAA,QACP,MAAM,CAAC;AAAA,QACP,mBAAmB;AAAA,QACnB,OAAO;AAAA,MACT;AAAA,IACF;AAMA,UAAM,iBAAiB,KAAK,iBAAiB,QAAQ,EAAE,YAAY,KAAK,IAAI,EAAE,aAAa,KAAK;AAChG,UAAM,kBAAkB,KAAK,iBAAiB,QAC1C,MAAM,qBAAqB,cAAc,IACzC,yBAAyB,cAAc;AAC3C,UAAM,QAAQ;AAAA,MACZ;AAAA,MACA,KAAK,iBAAiB,QAClB,CAAC,UAAU,yBAAyB,IACpC;AAAA,QACE,wBAAwB,KAAK,IAAI,IAAI,KAAK,MAAM,QAAQ,oBAAoB,OAAO,KAAK,CAAC,CAAC;AAAA,QAC1F;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,MACJ,EAAE,OAAO,CAAC,UAAU,UAAU,UAAU,KAAK,EAAE;AAAA,IACjD;AAEA,QAAI,QAAQ,QAAQ,SAAS;AAC3B,aAAO;AAAA,QACL,OAAO;AAAA,QACP,MAAM,CAAC;AAAA,QACP,mBAAmB;AAAA,QACnB,OAAO;AAAA,MACT;AAAA,IACF;AACA,UAAM,sBAAsB,IAAI,gBAAgB;AAChD,UAAM,YAAY,KAAK,IAAI;AAC3B,QAAI,qBAAqB,QAAQ;AACjC,QAAI,aAAa,YAAY;AAC7B,QAAI;AACJ,QAAI;AACJ,QAAI,UAAU;AACd,QAAI,YAAY;AAChB,UAAM,YAAY,oBAAI,IAAmB;AAEzC,UAAM,cAAc,QAAQ,mBAAmB,SAC3C,iCAAiC,IAAI,IACrC,EAAE,MAAM,QAAQ,gBAAgB,WAAW,QAAQ,oBAAoB;AAC3E,UAAM,gBAAgB,oBAAoB,YAAY,SAAS;AAC/D,UAAM,iBAAiB,YAAY,KAAK,MAAM,IAAI,EAAE;AAEpD,WAAO,IAAI,QAA6B,CAAC,YAAY;AACnD,YAAM,SAAS,CAAC,WAAsC;AACpD,YAAI,QAAS;AACb,kBAAU;AACV,YAAI,SAAU,cAAa,QAAQ;AACnC,YAAI,aAAc,SAAQ,QAAQ,oBAAoB,SAAS,YAAY;AAC3E,YAAI,CAAC,oBAAoB,OAAO,WAAW,UAAU,OAAO,GAAG;AAC7D,8BAAoB,MAAM,IAAI,MAAM,OAAO,SAAS,2BAA2B,CAAC;AAAA,QAClF;AACA,cAAM,mBAAmB;AACzB,YAAI,MAAM,UAAW,OAAM,WAAW;AACtC,YAAI,MAAM,aAAa,QAAQ,MAAM,eAAe,KAAM,OAAM,KAAK,SAAS;AAC9E,gBAAQ,MAAM;AAAA,MAChB;AACA,YAAM,mBAAmB,MAAY;AACnC,YAAI,SAAU,cAAa,QAAQ;AACnC,mBAAW,WAAW,MAAM;AAC1B,gBAAM,QAAQ,6BAA6B,kBAAkB;AAC7D,iBAAO,EAAE,OAAO,QAAW,MAAM,CAAC,GAAG,mBAAmB,aAAa,MAAM,CAAC;AAAA,QAC9E,GAAG,KAAK,IAAI,GAAG,aAAa,KAAK,IAAI,CAAC,CAAC;AACvC,iBAAS,QAAQ;AAAA,MACnB;AACA,YAAM,iBAAiB,CAAC,KAAa,SAAwC;AAC3E,cAAM,YAAY,QAAQ,8BAA8B,KAAK,IAAI;AACjE,YAAI,OAAO,cAAc,YAAY,CAAC,OAAO,SAAS,SAAS,EAAG;AAClE,cAAM,iBAAiB,KAAK,IAAI,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,SAAS,CAAC;AACrE,YAAI,kBAAkB,WAAY;AAClC,qBAAa;AACb,6BAAqB,aAAa;AAClC,yBAAiB;AAAA,MACnB;AAEA,qBAAe,MAAM;AACnB,eAAO;AAAA,UACL,OAAO;AAAA,UACP,MAAM,CAAC;AAAA,UACP,mBAAmB;AAAA,UACnB,OAAO;AAAA,QACT,CAAC;AAAA,MACH;AACA,cAAQ,QAAQ,iBAAiB,SAAS,cAAc,EAAE,MAAM,KAAK,CAAC;AAEtE,YAAM,GAAG,WAAW,CAAC,QAAiB;AACpC,YAAI,WAAW,aAAa,OAAO,QAAQ,YAAY,QAAQ,KAAM;AACrE,cAAM,UAAU;AAChB,YAAI,QAAQ,SAAS,UAAU;AAC7B,sBAAY;AACZ,cAAI,SAAU,cAAa,QAAQ;AACnC,cAAI,QAAQ,OAAO,sBAAsB,eAAe,CAAC,oBAAoB,OAAO,SAAS;AAC3F,gCAAoB,MAAM,IAAI,MAAM,QAAQ,OAAO,SAAS,2BAA2B,CAAC;AAAA,UAC1F;AACA,gBAAM,YAAY;AAChB,kBAAM,YAAY,MAAM,aAAa,WAAW,yBAAyB;AACzE,gBAAI,CAAC,aAAa,CAAC,oBAAoB,OAAO,SAAS;AACrD,kCAAoB;AAAA,gBAClB,IAAI,MAAM,4DAA4D;AAAA,cACxE;AACA,oBAAM,aAAa,WAAW,yBAAyB;AAAA,YACzD;AACA;AAAA,cACE,QAAQ,OAAO,UAAU,SACrB,QAAQ,SACR;AAAA,gBACE,GAAG,QAAQ;AAAA,gBACX,OAAO,oBAAoB,QAAQ,OAAO,OAAO,eAAe,cAAc;AAAA,cAChF;AAAA,YACN;AAAA,UACF,GAAG;AACH;AAAA,QACF;AACA,YAAI,QAAQ,SAAS,OAAQ;AAC7B,uBAAe,QAAQ,KAAK,QAAQ,IAAI;AACxC,cAAM,OAAO;AAAA,UAAa,oBAAoB;AAAA,UAAQ,MACpD,SAAS,QAAQ,KAAK,QAAQ,MAAM,oBAAoB,MAAM;AAAA,QAChE,EAAE;AAAA,UACA,CAAC,UAAU,KAAK,OAAO,EAAE,MAAM,YAAY,IAAI,QAAQ,IAAI,IAAI,MAAM,MAAM,CAAC;AAAA,UAC5E,CAAC,UACC,KAAK,OAAO;AAAA,YACV,MAAM;AAAA,YACN,IAAI,QAAQ;AAAA,YACZ,IAAI;AAAA,YACJ,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,YAC5D,UAAU,cAAc,QAAQ,GAAG,IAAI,oBAAoB,KAAK,IAAI;AAAA,UACtE,CAAC;AAAA,QACL;AACA,kBAAU,IAAI,IAAI;AAClB,aAAK,KAAK,QAAQ,MAAM,UAAU,OAAO,IAAI,CAAC;AAAA,MAChD,CAAC;AACD,YAAM,KAAK,SAAS,CAAC,UAAU;AAC7B,eAAO;AAAA,UACL,OAAO;AAAA,UACP,MAAM,CAAC;AAAA,UACP,mBAAmB;AAAA,UACnB,OAAO,4BAA4B,MAAM,OAAO;AAAA,QAClD,CAAC;AAAA,MACH,CAAC;AACD,YAAM,KAAK,QAAQ,CAAC,UAAU,WAAW;AACvC,YAAI,QAAS;AACb,cAAM,SAAS,SAAS,UAAU,MAAM,KAAK,aAAa,YAAY,SAAS;AAC/E,eAAO;AAAA,UACL,OAAO;AAAA,UACP,MAAM,CAAC;AAAA,UACP,mBAAmB;AAAA,UACnB,OAAO,sDAAsD,MAAM;AAAA,QACrE,CAAC;AAAA,MACH,CAAC;AAED,uBAAiB;AACjB,WAAK,OAAO;AAAA,QACV,MAAM;AAAA,QACN,OAAO;AAAA,QACP,MAAM,YAAY;AAAA,QAClB,UAAU,QAAQ,YAAY,CAAC;AAAA,QAC/B,aAAa,QAAQ;AAAA,QACrB,aAAa,QAAQ,eAAe;AAAA,MACtC,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF;AAEO,IAAM,oBAAN,cAAgC,mBAAmB;AAAA,EACxD,cAAc;AACZ,UAAM,KAAK;AAAA,EACb;AACF;",
+  "names": []
+}

package/dist/runtime/orchestration.d.ts

@@ -0,0 +1,3 @@
+export declare const isBlockingOrchestrationRef: (ref: string) => boolean;
+export declare const codeUsesOrchestration: (code: string) => boolean;
+//# sourceMappingURL=orchestration.d.ts.map

package/dist/runtime/orchestration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration.d.ts","sourceRoot":"","sources":["../../src/runtime/orchestration.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,0BAA0B,GAAI,KAAK,MAAM,KAAG,OACnB,CAAC;AASvC,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,OACxB,CAAC"}