omp-fabric 1.22.0 → 1.23.0

package/dist/index.js

@@ -81,7 +81,7 @@ import "./chunks/chunk-DLXPTBPL.js";
 import {
   GUEST_TYPE_DECLARATIONS,
   OMP_CORE_COMPATIBILITY_ARGUMENT_TYPE_NAMES
-} from "./chunks/chunk-3FYXXYAG.js";
+} from "./chunks/chunk-FT2W4VE2.js";
 import {
   NESTED_TOOL_CALL_ID_PREFIX,
   getActiveRepairCompiler,

package/dist/providers/omp-bash-cwd.d.ts

@@ -24,8 +24,9 @@ declare class ShellCwdDefinitions {
     constructor(createDefinition: ShellDefinitionFactory);
     get(cwd: string): ToolDefinition<any, any>;
 }
+export type BashDefinitionFactory = ShellDefinitionFactory;
 export declare class BashCwdDefinitions extends ShellCwdDefinitions {
-    constructor();
+    constructor(createDefinition?: BashDefinitionFactory);
 }
 export {};
 //# sourceMappingURL=omp-bash-cwd.d.ts.map

package/dist/providers/omp-bash-cwd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"omp-bash-cwd.d.ts","sourceRoot":"","sources":["../../src/providers/omp-bash-cwd.ts"],"names":[],"mappings":"AAEA,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,qEAAqE,CAAC;AAEpI,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAe7D,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AA2CtC,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,EAAE,WAAW,OAAO,KAAG,MACxB,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,gBAAgB,EAC1B,YAAY,MAAM,EAClB,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAUf,CAAC;AAEX,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,GACjC,YAAY,MAAM,EAClB,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAsD,CAAC;AAqBhF,eAAO,MAAM,kBAAkB,GAAI,QAAQ,OAAO,KAAG,OAUpD,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,GAAI,QAAQ,OAAO,KAAG,OAAqC,CAAC;AAI1F,KAAK,sBAAsB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAExE,0EAA0E;AAC1E,cAAM,mBAAmB;;IAGX,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,sBAAsB;IAErE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC;CAe3C;AAED,qBAAa,kBAAmB,SAAQ,mBAAmB;;CAI1D"}
+{"version":3,"file":"omp-bash-cwd.d.ts","sourceRoot":"","sources":["../../src/providers/omp-bash-cwd.ts"],"names":[],"mappings":"AAEA,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,qEAAqE,CAAC;AAEpI,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAe7D,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AA2CtC,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,EAAE,WAAW,OAAO,KAAG,MACxB,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,gBAAgB,EAC1B,YAAY,MAAM,EAClB,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAUf,CAAC;AAEX,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,GACjC,YAAY,MAAM,EAClB,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAsD,CAAC;AA0BhF,eAAO,MAAM,kBAAkB,GAAI,QAAQ,OAAO,KAAG,OAmBpD,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,GAAI,QAAQ,OAAO,KAAG,OAAqC,CAAC;AAI1F,KAAK,sBAAsB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAExE,0EAA0E;AAC1E,cAAM,mBAAmB;;IAGX,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,sBAAsB;IAErE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC;CAe3C;AAED,MAAM,MAAM,qBAAqB,GAAG,sBAAsB,CAAC;AAE3D,qBAAa,kBAAmB,SAAQ,mBAAmB;gBAC7C,gBAAgB,GAAE,qBAAgD;CAG/E"}

package/dist/providers/omp-session-scope.d.ts

@@ -0,0 +1,10 @@
+import type { AsyncJobManager } from "@oh-my-pi/pi-coding-agent/async";
+export interface OmpJobScope {
+    manager: AsyncJobManager;
+    agentId: () => string | null;
+}
+/** Job scope for one session identity; the owner id is re-resolved per call because `/new` re-mints it. */
+export declare const ompJobScope: (getSessionId: () => string | null) => OmpJobScope | undefined;
+/** Auto-background stays off: a handover would resolve a guest call with a job notice in place of output. */
+export declare const shellBackgroundSettings: (jobs: OmpJobScope | undefined, asyncEnabled?: () => boolean) => Record<string, unknown>;
+//# sourceMappingURL=omp-session-scope.d.ts.map

package/dist/providers/omp-session-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"omp-session-scope.d.ts","sourceRoot":"","sources":["../../src/providers/omp-session-scope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAmBvE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,2GAA2G;AAC3G,eAAO,MAAM,WAAW,GAAI,cAAc,MAAM,MAAM,GAAG,IAAI,KAAG,WAAW,GAAG,SAO7E,CAAC;AAKF,6GAA6G;AAC7G,eAAO,MAAM,uBAAuB,GAClC,MAAM,WAAW,GAAG,SAAS,EAC7B,eAAc,MAAM,OAA0B,KAC7C,MAAM,CAAC,MAAM,EAAE,OAAO,CAGvB,CAAC"}

package/dist/providers/omp-tools-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"omp-tools-provider.d.ts","sourceRoot":"","sources":["../../src/providers/omp-tools-provider.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAU5D,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EAEvB,cAAc,EACd,yBAAyB,EAE1B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAUrE,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACtC;AAID,eAAO,MAAM,qBAAqB,GAAI,UAAU,kBAAkB,GAAG,SAAS,KAAG,IAEhF,CAAC;AAgTF,eAAO,MAAM,iBAAiB,6BAA6B,CAAC;AA+Z5D,+EAA+E;AAC/E,MAAM,MAAM,uBAAuB,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;AAE5E,qBAAa,gBAAiB,YAAW,cAAc;;WACxC,MAAM,CACjB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,mBAAmB,EAC7B,aAAa,CAAC,EAAE,qBAAqB,EACrC,eAAe,CAAC,EAAE,uBAAuB,GACxC,OAAO,CAAC,gBAAgB,CAAC;IAG5B,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,WAAW,iCAAiC;gBAWnD,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,mBAAmB,EAC7B,aAAa,CAAC,EAAE,qBAAqB,EACrC,eAAe,CAAC,EAAE,uBAAuB;IAiBrC,IAAI,CACR,OAAO,EAAE,yBAAyB,EAClC,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAY9B,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAU9C,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA2B5F,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAuC/C,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,OAAO,CAAC;CAobpB"}
+{"version":3,"file":"omp-tools-provider.d.ts","sourceRoot":"","sources":["../../src/providers/omp-tools-provider.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAU5D,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EAEvB,cAAc,EACd,yBAAyB,EAE1B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAWrE,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACtC;AAID,eAAO,MAAM,qBAAqB,GAAI,UAAU,kBAAkB,GAAG,SAAS,KAAG,IAEhF,CAAC;AAyTF,eAAO,MAAM,iBAAiB,6BAA6B,CAAC;AA+Z5D,+EAA+E;AAC/E,MAAM,MAAM,uBAAuB,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;AAE5E,qBAAa,gBAAiB,YAAW,cAAc;;WACxC,MAAM,CACjB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,mBAAmB,EAC7B,aAAa,CAAC,EAAE,qBAAqB,EACrC,eAAe,CAAC,EAAE,uBAAuB,GACxC,OAAO,CAAC,gBAAgB,CAAC;IAG5B,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,WAAW,iCAAiC;gBAanD,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,mBAAmB,EAC7B,aAAa,CAAC,EAAE,qBAAqB,EACrC,eAAe,CAAC,EAAE,uBAAuB;IAiBrC,IAAI,CACR,OAAO,EAAE,yBAAyB,EAClC,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAY9B,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAU9C,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA2B5F,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAuC/C,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,OAAO,CAAC;CAobpB"}

package/dist/runtime/core-override-guest-types.js

@@ -1,7 +1,7 @@
 import {
   OMP_CORE_COMPATIBILITY_ARGUMENT_TYPE_NAMES,
   OMP_CORE_NUMERIC_FIELDS
-} from "../chunks/chunk-3FYXXYAG.js";
+} from "../chunks/chunk-FT2W4VE2.js";
 import {
   OMP_CORE_TOOL_NAMES
 } from "../chunks/chunk-ZFMSJLQE.js";

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

@@ -17,7 +17,7 @@ export declare const OMP_CORE_NUMERIC_FIELDS: {
     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 FabricImageContent {\n  type: \"image\";\n  data: string;\n  mimeType: string;\n}\ninterface FabricAgentRequest {\n  task: string;\n  images?: FabricImageContent[];\n  name?: string;\n  runner?: FabricAgentRunner;\n  transport?: FabricTransport;\n  model?: string;\n  persona?: string;\n  thinking?: FabricThinking;\n  tools?: string[];\n  addTools?: 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  env?: Record<string, string>; pty?: boolean;\n};\ntype OmpBashOptions = OmpShellOptions;\ntype OmpGrepOptions = { path?: string; glob?: string; globPattern?: string; ignoreCase?: boolean; ic?: boolean; caseInsensitive?: boolean; literal?: boolean; context?: number; ctx?: number; skip?: number; gitignore?: boolean };\ntype OmpFindOptions = { path?: string; limit?: number; max?: number; gitignore?: boolean; hidden?: boolean };\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, skip?: 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  cwd?: string;\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>; timeoutMs?: number }): 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; withTotal: true }): Promise<{ members: FabricParticipantInfo[]; total: number; truncated: boolean }>;\n  members(args?: { scope?: FabricParticipantScope; kinds?: FabricParticipantKind[]; includeStale?: boolean; limit?: number; max?: number; include_stale?: boolean; withTotal?: false }): Promise<FabricParticipantInfo[]>;\n  get<T = unknown>(args: { key: string }): Promise<FabricMeshStateEntry<T> | null>;\n  list<T = unknown>(args: { prefix?: string; limit?: number; max?: number; withTotal: true }): Promise<{ entries: Array<FabricMeshStateEntry<T>>; total: number; truncated: boolean }>;\n  list<T = unknown>(args?: { prefix?: string; limit?: number; max?: number; withTotal?: false }): 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}\ninterface FabricLcmMemoryHit {\n  kind: \"lcm.raw\" | \"lcm.summary\";\n  sessionId: string;\n  score: number;\n  snippet: string;\n  truncated: boolean;\n  source: { kind: \"raw\" | \"summary\"; projectKey: string; sessionId: string; entryId?: string; revision?: number; contentHash?: string; nodeId?: string; sourceHash: string };\n  follow: FabricMemoryCall<\"memory.expand\", FabricMemoryExpandArgs>;\n}\ntype FabricMemoryRecallHit = FabricMemoryRecallEntryHit | FabricMemoryRecallSessionHit | FabricLcmMemoryHit;\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  structuredContent?: 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    offset?: number;\n  }): Promise<{\n    scope?: string;\n    branches?: FabricMemoryBranches;\n    offset?: number;\n    total?: number;\n    truncated?: boolean;\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\" | \"skipped\" | \"cancelled\" | \"failed\";\n  summary?: string;\n  tokensBefore?: number;\n  estimatedTokensAfter?: number;\n  error?: string;\n  persisted?: boolean;\n}\ninterface FabricCompactContextUsage {\n  known: boolean;\n  tokens: number | null;\n  contextWindow: number | null;\n  percent: number | null;\n  remainingTokens: number | null;\n}\ninterface FabricCompactStatus {\n  pending?: FabricCompactPendingIntent;\n  last?: FabricCompactLastCommit;\n  context?: FabricCompactContextUsage;\n  engine?: string;\n  targetContextRatio?: number;\n  model?: string;\n  sessionId?: 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<FabricCompactStatus>;\n  cancel(): Promise<{ cancelled: true }>;\n}\n\ninterface FabricCodemapSymbolCounts {\n  files: number;\n  symbols: number;\n  languages: Record<string, number>;\n  fallbackFiles: number;\n  truncated: boolean;\n  elapsedMs: number;\n}\ninterface FabricCodemapCascadeEdge {\n  file: string;\n  score: number;\n  commits: number;\n}\ninterface FabricCodemapCascade {\n  seeds: string[];\n  edges: FabricCodemapCascadeEdge[];\n  commitsScanned: number;\n  truncated: boolean;\n  unavailable?: string;\n}\ninterface FabricCodemapApi {\n  map(args?: {\n    path?: string;\n    maxTokens?: number;\n    glob?: string;\n    focus?: string;\n    seeds?: string[];\n    refresh?: boolean;\n  }): Promise<{\n    text: string;\n    root: string;\n    tokensEstimated: number;\n    filesShown: number;\n    symbolsShown: number;\n    omittedFiles: number;\n    omittedSymbols: number;\n    truncated: boolean;\n    indexed: FabricCodemapSymbolCounts;\n    cascade?: FabricCodemapCascade;\n  }>;\n  cascade(args: {\n    path?: string;\n    seeds: string[];\n    limit?: number;\n    maxCommits?: number;\n  }): Promise<FabricCodemapCascade>;\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}\ninterface FabricJudgmentChoiceQuestion {\n  type: \"choice\";\n  instructions: string;\n  criteria: Record<string, string | null>;\n}\ninterface FabricJudgmentBoolQuestion {\n  type: \"bool\";\n  instructions: string;\n  criteria?: { true?: string; false?: string };\n}\ninterface FabricJudgmentScoreQuestion {\n  type: \"score\";\n  instructions: string;\n  criteria: [string, string, ...string[]];\n}\ntype FabricJudgmentQuestion =\n  | FabricJudgmentChoiceQuestion\n  | FabricJudgmentBoolQuestion\n  | FabricJudgmentScoreQuestion;\ninterface FabricJudgmentChoiceAnswer {\n  type: \"choice\";\n  choice: string;\n  probabilities: Record<string, number>;\n  confidence: number;\n}\ninterface FabricJudgmentBoolAnswer {\n  type: \"bool\";\n  bool: number;\n}\ninterface FabricJudgmentScoreAnswer {\n  type: \"score\";\n  score: number;\n  probabilities: Record<string, number>;\n  confidence: number;\n}\ntype FabricJudgmentAnswer =\n  | FabricJudgmentChoiceAnswer\n  | FabricJudgmentBoolAnswer\n  | FabricJudgmentScoreAnswer;\ninterface FabricJudgmentApi {\n  ask(args: {\n    state: unknown;\n    questions: Record<string, FabricJudgmentQuestion>;\n  }): Promise<\n    | { ok: true; backend: string; answers: Record<string, FabricJudgmentAnswer> }\n    | {\n      ok: false;\n      reason: \"disabled\" | \"unsupported\" | \"refused\" | \"failed\" | \"timeout\" | \"aborted\";\n      detail?: string;\n    }\n  >;\n  stats(): Promise<{\n    enabled: boolean;\n    requests: number;\n    batched: number;\n    questions: number;\n    merged: number;\n    failures: number;\n    refusals: number;\n    timeouts: number;\n    lastBackend?: string;\n    lastError?: string;\n  }>;\n}\ninterface FabricJudgeFilterOptions {\n  threshold?: number;\n  onFail?: \"keep-all\" | \"empty\" | \"throw\";\n  maxItems?: number;\n  maxBytes?: number;\n}\ninterface FabricJudgeClassifyOptions {\n  onFail?: \"keep-all\" | \"empty\" | \"throw\";\n  fallbackCategory?: string;\n  maxItems?: number;\n  maxBytes?: number;\n}\ninterface FabricJudgeBoolOptions {\n  fallback?: number;\n}\ninterface FabricJudgeChoiceOptions {\n  fallback?: string;\n}\ninterface FabricJudgeScoreOptions {\n  fallback?: number;\n}\ninterface FabricJudgeApi {\n  ask(args: {\n    state: unknown;\n    questions: Record<string, FabricJudgmentQuestion>;\n  }): Promise<\n    | { ok: true; backend: string; answers: Record<string, FabricJudgmentAnswer> }\n    | {\n      ok: false;\n      reason: \"disabled\" | \"unsupported\" | \"refused\" | \"failed\" | \"timeout\" | \"aborted\";\n      detail?: string;\n    }\n  >;\n  ask(\n    state: unknown,\n    questions: Record<string, FabricJudgmentQuestion>,\n  ): Promise<\n    | { ok: true; backend: string; answers: Record<string, FabricJudgmentAnswer> }\n    | {\n      ok: false;\n      reason: \"disabled\" | \"unsupported\" | \"refused\" | \"failed\" | \"timeout\" | \"aborted\";\n      detail?: string;\n    }\n  >;\n  bool(state: unknown, instructions: string, options?: FabricJudgeBoolOptions): Promise<number | undefined>;\n  choice(\n    state: unknown,\n    options: readonly string[] | Record<string, string | null>,\n    instructions: string,\n    config?: FabricJudgeChoiceOptions,\n  ): Promise<string | undefined>;\n  score(\n    state: unknown,\n    criteria: readonly string[],\n    instructions: string,\n    config?: FabricJudgeScoreOptions,\n  ): Promise<number | undefined>;\n  filter<T>(items: T[], instructions: string, options?: FabricJudgeFilterOptions): Promise<T[]>;\n  classify<T, C extends string>(\n    items: T[],\n    categories: readonly C[],\n    instructions: string,\n    options?: FabricJudgeClassifyOptions,\n  ): Promise<Array<{ item: T; category?: C; confidence?: 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 codemap: FabricCodemapApi;\ndeclare const judgment: FabricJudgmentApi;\ndeclare const judge: FabricJudgeApi;\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 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 FabricImageContent {\n  type: \"image\";\n  data: string;\n  mimeType: string;\n}\ninterface FabricAgentRequest {\n  task: string;\n  images?: FabricImageContent[];\n  name?: string;\n  runner?: FabricAgentRunner;\n  transport?: FabricTransport;\n  model?: string;\n  persona?: string;\n  thinking?: FabricThinking;\n  tools?: string[];\n  addTools?: 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; async?: boolean;\n  cwd?: string; workdir?: string; directory?: string; workingDirectory?: string;\n  env?: Record<string, string>; pty?: boolean;\n};\ntype OmpBashOptions = OmpShellOptions;\ntype OmpGrepOptions = { path?: string; glob?: string; globPattern?: string; ignoreCase?: boolean; ic?: boolean; caseInsensitive?: boolean; literal?: boolean; context?: number; ctx?: number; skip?: number; gitignore?: boolean };\ntype OmpFindOptions = { path?: string; limit?: number; max?: number; gitignore?: boolean; hidden?: boolean };\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, skip?: 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  cwd?: string;\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>; timeoutMs?: number }): 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; withTotal: true }): Promise<{ members: FabricParticipantInfo[]; total: number; truncated: boolean }>;\n  members(args?: { scope?: FabricParticipantScope; kinds?: FabricParticipantKind[]; includeStale?: boolean; limit?: number; max?: number; include_stale?: boolean; withTotal?: false }): Promise<FabricParticipantInfo[]>;\n  get<T = unknown>(args: { key: string }): Promise<FabricMeshStateEntry<T> | null>;\n  list<T = unknown>(args: { prefix?: string; limit?: number; max?: number; withTotal: true }): Promise<{ entries: Array<FabricMeshStateEntry<T>>; total: number; truncated: boolean }>;\n  list<T = unknown>(args?: { prefix?: string; limit?: number; max?: number; withTotal?: false }): 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}\ninterface FabricLcmMemoryHit {\n  kind: \"lcm.raw\" | \"lcm.summary\";\n  sessionId: string;\n  score: number;\n  snippet: string;\n  truncated: boolean;\n  source: { kind: \"raw\" | \"summary\"; projectKey: string; sessionId: string; entryId?: string; revision?: number; contentHash?: string; nodeId?: string; sourceHash: string };\n  follow: FabricMemoryCall<\"memory.expand\", FabricMemoryExpandArgs>;\n}\ntype FabricMemoryRecallHit = FabricMemoryRecallEntryHit | FabricMemoryRecallSessionHit | FabricLcmMemoryHit;\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  structuredContent?: 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    offset?: number;\n  }): Promise<{\n    scope?: string;\n    branches?: FabricMemoryBranches;\n    offset?: number;\n    total?: number;\n    truncated?: boolean;\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\" | \"skipped\" | \"cancelled\" | \"failed\";\n  summary?: string;\n  tokensBefore?: number;\n  estimatedTokensAfter?: number;\n  error?: string;\n  persisted?: boolean;\n}\ninterface FabricCompactContextUsage {\n  known: boolean;\n  tokens: number | null;\n  contextWindow: number | null;\n  percent: number | null;\n  remainingTokens: number | null;\n}\ninterface FabricCompactStatus {\n  pending?: FabricCompactPendingIntent;\n  last?: FabricCompactLastCommit;\n  context?: FabricCompactContextUsage;\n  engine?: string;\n  targetContextRatio?: number;\n  model?: string;\n  sessionId?: 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<FabricCompactStatus>;\n  cancel(): Promise<{ cancelled: true }>;\n}\n\ninterface FabricCodemapSymbolCounts {\n  files: number;\n  symbols: number;\n  languages: Record<string, number>;\n  fallbackFiles: number;\n  truncated: boolean;\n  elapsedMs: number;\n}\ninterface FabricCodemapCascadeEdge {\n  file: string;\n  score: number;\n  commits: number;\n}\ninterface FabricCodemapCascade {\n  seeds: string[];\n  edges: FabricCodemapCascadeEdge[];\n  commitsScanned: number;\n  truncated: boolean;\n  unavailable?: string;\n}\ninterface FabricCodemapApi {\n  map(args?: {\n    path?: string;\n    maxTokens?: number;\n    glob?: string;\n    focus?: string;\n    seeds?: string[];\n    refresh?: boolean;\n  }): Promise<{\n    text: string;\n    root: string;\n    tokensEstimated: number;\n    filesShown: number;\n    symbolsShown: number;\n    omittedFiles: number;\n    omittedSymbols: number;\n    truncated: boolean;\n    indexed: FabricCodemapSymbolCounts;\n    cascade?: FabricCodemapCascade;\n  }>;\n  cascade(args: {\n    path?: string;\n    seeds: string[];\n    limit?: number;\n    maxCommits?: number;\n  }): Promise<FabricCodemapCascade>;\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}\ninterface FabricJudgmentChoiceQuestion {\n  type: \"choice\";\n  instructions: string;\n  criteria: Record<string, string | null>;\n}\ninterface FabricJudgmentBoolQuestion {\n  type: \"bool\";\n  instructions: string;\n  criteria?: { true?: string; false?: string };\n}\ninterface FabricJudgmentScoreQuestion {\n  type: \"score\";\n  instructions: string;\n  criteria: [string, string, ...string[]];\n}\ntype FabricJudgmentQuestion =\n  | FabricJudgmentChoiceQuestion\n  | FabricJudgmentBoolQuestion\n  | FabricJudgmentScoreQuestion;\ninterface FabricJudgmentChoiceAnswer {\n  type: \"choice\";\n  choice: string;\n  probabilities: Record<string, number>;\n  confidence: number;\n}\ninterface FabricJudgmentBoolAnswer {\n  type: \"bool\";\n  bool: number;\n}\ninterface FabricJudgmentScoreAnswer {\n  type: \"score\";\n  score: number;\n  probabilities: Record<string, number>;\n  confidence: number;\n}\ntype FabricJudgmentAnswer =\n  | FabricJudgmentChoiceAnswer\n  | FabricJudgmentBoolAnswer\n  | FabricJudgmentScoreAnswer;\ninterface FabricJudgmentApi {\n  ask(args: {\n    state: unknown;\n    questions: Record<string, FabricJudgmentQuestion>;\n  }): Promise<\n    | { ok: true; backend: string; answers: Record<string, FabricJudgmentAnswer> }\n    | {\n      ok: false;\n      reason: \"disabled\" | \"unsupported\" | \"refused\" | \"failed\" | \"timeout\" | \"aborted\";\n      detail?: string;\n    }\n  >;\n  stats(): Promise<{\n    enabled: boolean;\n    requests: number;\n    batched: number;\n    questions: number;\n    merged: number;\n    failures: number;\n    refusals: number;\n    timeouts: number;\n    lastBackend?: string;\n    lastError?: string;\n  }>;\n}\ninterface FabricJudgeFilterOptions {\n  threshold?: number;\n  onFail?: \"keep-all\" | \"empty\" | \"throw\";\n  maxItems?: number;\n  maxBytes?: number;\n}\ninterface FabricJudgeClassifyOptions {\n  onFail?: \"keep-all\" | \"empty\" | \"throw\";\n  fallbackCategory?: string;\n  maxItems?: number;\n  maxBytes?: number;\n}\ninterface FabricJudgeBoolOptions {\n  fallback?: number;\n}\ninterface FabricJudgeChoiceOptions {\n  fallback?: string;\n}\ninterface FabricJudgeScoreOptions {\n  fallback?: number;\n}\ninterface FabricJudgeApi {\n  ask(args: {\n    state: unknown;\n    questions: Record<string, FabricJudgmentQuestion>;\n  }): Promise<\n    | { ok: true; backend: string; answers: Record<string, FabricJudgmentAnswer> }\n    | {\n      ok: false;\n      reason: \"disabled\" | \"unsupported\" | \"refused\" | \"failed\" | \"timeout\" | \"aborted\";\n      detail?: string;\n    }\n  >;\n  ask(\n    state: unknown,\n    questions: Record<string, FabricJudgmentQuestion>,\n  ): Promise<\n    | { ok: true; backend: string; answers: Record<string, FabricJudgmentAnswer> }\n    | {\n      ok: false;\n      reason: \"disabled\" | \"unsupported\" | \"refused\" | \"failed\" | \"timeout\" | \"aborted\";\n      detail?: string;\n    }\n  >;\n  bool(state: unknown, instructions: string, options?: FabricJudgeBoolOptions): Promise<number | undefined>;\n  choice(\n    state: unknown,\n    options: readonly string[] | Record<string, string | null>,\n    instructions: string,\n    config?: FabricJudgeChoiceOptions,\n  ): Promise<string | undefined>;\n  score(\n    state: unknown,\n    criteria: readonly string[],\n    instructions: string,\n    config?: FabricJudgeScoreOptions,\n  ): Promise<number | undefined>;\n  filter<T>(items: T[], instructions: string, options?: FabricJudgeFilterOptions): Promise<T[]>;\n  classify<T, C extends string>(\n    items: T[],\n    categories: readonly C[],\n    instructions: string,\n    options?: FabricJudgeClassifyOptions,\n  ): Promise<Array<{ item: T; category?: C; confidence?: 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 codemap: FabricCodemapApi;\ndeclare const judgment: FabricJudgmentApi;\ndeclare const judge: FabricJudgeApi;\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[];

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

@@ -1 +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,qxqDAi9CnC,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"}
+{"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,syqDAi9CnC,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

@@ -3,7 +3,7 @@ import {
   OMP_CORE_COMPATIBILITY_ARGUMENT_TYPE_NAMES,
   OMP_CORE_NUMERIC_FIELDS,
   guestTypeDeclarations
-} from "../chunks/chunk-3FYXXYAG.js";
+} from "../chunks/chunk-FT2W4VE2.js";
 export {
   GUEST_TYPE_DECLARATIONS,
   OMP_CORE_COMPATIBILITY_ARGUMENT_TYPE_NAMES,

package/docs/judgment.md

@@ -97,6 +97,12 @@ Guest programs and batch scripts access the lane through `globalThis.judge`.
 - `judge.bool(state, instructions, options?)`: returns the probability of yes as a number, or the configured fallback when the backend fails.
 - `judge.choice(state, options, instructions, config?)`: returns the chosen label string from an array or criteria map.
 - `judge.score(state, criteria, instructions, config?)`: returns the score index from ordered levels.
-- `judge.filter(items, instructions, options?)`: evaluates an array in bounded chunks of up to 25 items per request. When a request fails, it preserves all chunk items under `onFail: "keep-all"`.
+- `judge.filter(items, instructions, options?)`: evaluates an array in bounded chunks. When a request fails, it preserves all chunk items under `onFail: "keep-all"`.
 - `judge.classify(items, categories, instructions, options?)`: assigns a category to each item across bounded chunks.
 - `judge.ask(state, questions)`: direct access for custom question maps.
+
+### Batch chunking and fail-open policy
+
+Batch helpers group items with two limits: at most 25 items and at most 48 KiB JSON payload per request. Items larger than 40 KiB are bounded in the evaluation state payload with a truncation notice, while the original item instances remain intact in returned collections.
+
+When a backend request fails or times out, `judge.filter` and `judge.classify` default to `onFail: "keep-all"`, returning all candidate items so failures do not discard data. Callers can also choose `onFail: "empty"` or `onFail: "throw"`.

package/docs/providers.md

@@ -107,3 +107,9 @@ export default function resultGuard(omp: ExtensionAPI) {
 If you change only `content`, the nested sandbox value becomes the patched text. To keep a structured replacement, return the proxy envelope in `details` with a changed `result`, as in the example above. When both fields are patched, a valid changed `details.result` takes precedence. Returning `isError: true` fails the nested provider invocation.
 
 OMP core tools and captured extension tools skip this generic proxy, because they already replay their native `tool_call`, `tool_result`, and `tool_execution_*` lifecycle. Nested shell calls still emit their native identity: `omp.bash()` uses `toolName: "bash"`/`isBashToolResult()`. Proxied events act as middleware only. They create no separate persisted tool-result messages.
+
+The shell adapter reaches the host's background-job manager. `omp.bash({ async: true })` registers a job owned by the calling agent and resolves at once with `details.async.jobId`; the host delivers the finished job to that owner as an `async-result` follow-up, so the work outlives the program that started it and the agent, not the program, receives its output. The agent's own `hub` tool inspects and cancels those jobs; `hub` is not a Fabric provider and a guest program cannot reach it.
+
+Auto-background stays off at every host setting. A guest program is straight-line code that reads a command's output on its next line, and a mid-flight handover would resolve the call with a job notice in place of that output.
+
+Fabric resolves the owner by scanning `AgentRegistry` for the live agent whose session id matches the identity the provider captured, then takes that agent's own `asyncJobManager` (never the process singleton, which the host withholds from secondary sessions on purpose). The owner id is re-resolved per call, so `/new` and a session switch keep delivering. Where no such agent exists, or where the host gave it no manager, `async.enabled` is forced off: the `async` parameter leaves the advertised schema and the tool description promises no backgrounding.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omp-fabric",
-  "version": "1.22.0",
+  "version": "1.23.0",
   "description": "A programmable tool and agent runtime for Oh My Pi (OMP)",
   "type": "module",
   "main": "./dist/index.js",

package/skills/fabric-exec/SKILL.md

@@ -17,7 +17,7 @@ One type-checked TS program in a fresh executor (isolated QuickJS by default). O
 | Tool | Form | Returns |
 |------|------|---------|
 | `read` | `path` \| `{path,offset?,limit?}` \| `(path, options?)` | `string` |
-| `bash` | `command` \| `{command,timeout?,cwd?}` \| `(command, options?)` | `{ok:true,output,details}`; rejects on a nonzero exit (`settle:true` returns `{ok:false,output,details:null,exitCode,error}` instead) |
+| `bash` | `command` \| `{command,timeout?,cwd?,async?}` \| `(command, options?)` | `{ok:true,output,details}`; rejects on a nonzero exit (`settle:true` returns `{ok:false,output,details:null,exitCode,error}` instead) |
 | `grep` | `pattern` \| `{pattern,path?,glob?,ignoreCase?,literal?,context?,limit?}` \| `(pattern, path?, limit?)` | `string` |
 | `find` | `pattern` \| `{pattern,path?,limit?}` \| `(pattern, path?, limit?)` | `string` |
 | `ls` | `path?` \| `{path?,limit?}` \| `(path, options?)` | `string` |
@@ -32,6 +32,8 @@ Shell tools reject on an ordinary nonzero exit; pass `settle:true` to get `{ok:f
 
 Aliases are normalized to canonical fields before host validation. Command aliases include `cmd`/`shell`/`cmdline`/`script`/`commandLine`; pattern aliases include `query`/`regex`/`search` plus `q`/`expression`/`text` for grep and `name`/`filename`/`glob`/`include` for find. Path aliases include `file`, `file_path`, camel-case path variants, `dir`/`folder`/`directory`, and target-file variants. Edit text accepts `old`/`from`/`old_string`-style and `new`/`to`/`replacement`/`new_string`-style spellings, including inside `edits`; write content accepts `contents`/`body`/`text`/`data`/`fileContent`. `ic`/`caseInsensitive`→`ignoreCase`, `globPattern`→`glob`, `ctx`→`context`, `max`→`limit`, and `start`→`offset`.
 
+`async:true` starts the command as a host background job: the call resolves at once with `details.async.jobId`, the command keeps running past this program, and its output reaches the agent as a follow-up message. The program never sees that output, and `settle` has nothing to settle on a call that resolved, so read a file the command writes when a later step needs its result. Foreground calls are never backgrounded, whatever their duration. The parameter needs a live agent owning this session with a host job manager; the schema drops it when the owner is missing, parked, or was given no manager, and passing it anyway fails with `Async bash execution is disabled`.
+
 Shell `timeout` is in seconds; `timeoutMs` is converted from milliseconds. Numeric strings in `limit`, `timeout`, `offset`, and `context` coerce to numbers. `null`/`undefined` is omitted only for known optional fields; required fields remain invalid so authoritative host validation still reports them. Canonical fields win when both canonical and alias spellings are present. Unknown keys still fail the excess-property type check.
 
 `bash`/`edit`/`write` always resolve an envelope `{ ok, output, details }`, never a bare string, and the executor guards those envelopes: a string method or iteration applied to the envelope itself (`r.trim()`, `for (const line of r)`) throws a TypeError naming the fix (`.output`) instead of a context-free "not a function".
@@ -84,6 +86,8 @@ All calls return promises. Fields ending in `?` are optional; `unknown` marks pr
 | `compact.request(args?)` | `{requested:true,intent:{reason?,instructions?,preserve?,requestedBy,requestedAt}}` |
 | `compact.status()` | `{pending?:CompactIntent,last?:{at,requestedBy,status,summary?,tokensBefore?,estimatedTokensAfter?,error?}}` |
 | `compact.cancel()` | `{cancelled:true}` |
+| `judgment.ask(args)` | `{ok:true,backend,answers:Record<string,Answer>}|{ok:false,reason,detail?}` |
+| `judgment.stats()` | `{enabled,requests,batched,questions,merged,failures,refusals,timeouts,lastBackend?,lastError?}` |
 
 `memory.recall` multi-term literal queries default to ranked `queryMatch: "any"` so wording differences do not hide evidence; use `"all"` to require every canonical term in one indexed entry, and `queryMode: "phrase"` when adjacency matters. Results are hard-bounded either way. Structural filters (`ref`, `provider`, `action`, `outcome`) use exact persisted trace fields. Use `tools.catalog()`/`tools.search()` only to choose a current action head—catalog descriptions are navigation metadata and never become session evidence.
 
@@ -93,6 +97,8 @@ Recall returns one bounded flat hit stream. Every hit has the same copy-ready `{
 
 Stable-provider arguments normalize near-miss spellings the way `omp.*` does: known aliases and casing/singular variants repair to the canonical key, numeric strings coerce for numeric fields, and scope spellings such as `cwd` repair to `project`. Unknown keys are never silently ignored—they fail validation with the offending property path named (e.g. `/befroe: must NOT have additional properties`).
 
+`judge.*` exposes ergonomic guest helpers over the judgment lane. `judge.bool(state, instructions, {fallback?})` returns probability of yes (`0..1`) or a fallback number. `judge.choice(state, options, instructions, {fallback?})` evaluates a choice label. `judge.score(state, criteria, instructions, {fallback?})` evaluates an ordered level index. `judge.filter(items, instructions, {threshold?,onFail?,maxItems?,maxBytes?})` and `judge.classify(items, categories, instructions, {onFail?,fallbackCategory?,maxItems?,maxBytes?})` evaluate collections with dual-bounded chunking (<=25 items, <=48 KiB) and fail-open preservation (`onFail: "keep-all"`). `judge.ask(state, questions)` provides direct access for custom question maps.
+
 `SessionInfo` is `{id,file,cwd,mtime,entryCount,tier:"hot"|"cold",branches,lineageFingerprint}`. Memory failures are returned in `error: {code,message,...}`; ambiguous-session failures may return only `{error}`. Check `error` before relying on optional success fields.
 
 ### Dynamic provider return shapes