@jmanuelcorral/openteam 0.2.1 → 0.9.0

package/dist/orchestrator/coordinator.d.ts

@@ -1,10 +1,14 @@
+import { z } from "zod";
 import type { BudgetState } from "../capabilities/budget";
 import type { ModelCapabilityProfile } from "../capabilities/types";
 import type { OpenTeamConfig } from "../config/schema";
+import type { RuntimeConcurrencyLimiter } from "../local/concurrency";
+import type { LocalRuntimeId } from "../local/types";
 import type { AvailableModel, RoutingDecision, TaskSignals } from "../router/types";
 import { type EventSink } from "../telemetry/eventLog";
 import { type MeetingEvent, type RouteEvent } from "../telemetry/events";
 import type { CostRecord } from "../telemetry/types";
+import { type AgentRoleProfile } from "./roles";
 import { type OpencodeSessionClient, type SubsessionResult } from "./subsessions";
 export type RoleTaskInput = {
     roleID: string;
@@ -18,8 +22,18 @@ export type RoleTaskInput = {
     title?: string;
     systemPrompt?: string;
     directory?: string;
+    /**
+     * Dispatch alias override for the roleID/agentName split (#172, W3-S02). When a
+     * roster themes a role (e.g. roleID `scribe` → agentName `gandalf`), routing
+     * still keys on `roleID` but opencode must dispatch to the themed `agentName`.
+     * When set, it wins over the role profile's `opencodeAgent`; when absent, the
+     * profile's `opencodeAgent` is used exactly as before.
+     */
+    agentOverride?: string;
     /** Correlación opcional con una tarea del loop SDD/backlog (Fase D). */
     taskID?: string;
+    /** Role IDs this task depends on. Dependents only run after dependencies succeed. */
+    dependsOn?: readonly string[];
 };
 export type CoordinatorDeps = {
     client: OpencodeSessionClient;
@@ -27,6 +41,58 @@ export type CoordinatorDeps = {
     now: () => number;
     newDecisionID: () => string;
     timeoutMs?: number;
+    /** Optional warn sink; defaults to `console.warn`. Injectable for tests. */
+    warn?: (message?: unknown) => void;
+    /**
+     * Caller-owned Set for once-per-roleID dedup of `warnUnknownRole`. Production
+     * callers pass a long-lived Set (one per plugin instance) so the warning is
+     * emitted at most once per session. Test callers pass `new Set()` per case
+     * for full isolation. When absent, every call to `warnUnknownRole` emits.
+     */
+    warnedRoles?: Set<string>;
+    /**
+     * Reachability probe for local runtimes (#143). A REQUIRED injected I/O port —
+     * probing lives in `src/local/**`; the coordinator receives only the boolean
+     * result, so this module stays I/O-free. Consulted ONLY for roles that carry
+     * `requiresLocalRuntime === true`; returns true when at least one local runtime
+     * is reachable, treating a configured-but-unreachable runtime as absent.
+     *
+     * Deliberately required, with NO fallback. A prohibition must never fail open:
+     * an enabled-but-unreachable runtime (e.g. a stopped daemon) is the very case
+     * #143 exists to catch, and an `enabled`-flag fallback would pass the gate for
+     * it. Making the port mandatory also turns a missing composition-root wiring
+     * into a compile error, so the gate cannot be silently bypassed by dropping the
+     * injection.
+     */
+    localRuntimeReachable: () => boolean | Promise<boolean>;
+    /**
+     * Optional per-runtime reachability probe (#144). Returns the set of local
+     * runtime ids currently reachable, so the dispatcher can fail over across the
+     * ordered list a role declares (`localRuntimes`): an unreachable runtime is
+     * absent from the set and is skipped in favour of the next listed one.
+     *
+     * Injected I/O port, like `localRuntimeReachable` — probing lives in
+     * `src/local/**`. Optional so existing callers (and the many test construction
+     * sites) need no change and keep the pre-#144 boolean-only behaviour; when it
+     * is absent the coordinator falls back to `localRuntimeReachable` and roles
+     * without a list are unaffected. When present alongside a role that declares a
+     * list, it is the single probe consulted for the batch, and `any reachable` is
+     * derived from it — the two ports are never both probed for one batch.
+     */
+    reachableRuntimeIds?: () => ReadonlySet<LocalRuntimeId> | Promise<ReadonlySet<LocalRuntimeId>>;
+    /**
+     * Optional per-runtime concurrency limiter (#144). Caps concurrent generations
+     * per runtime to its configured slot count and QUEUES excess work rather than
+     * dropping it or spilling it to another runtime. Optional so existing callers
+     * need no change; when absent, no cap is enforced (pre-#144 behaviour).
+     *
+     * The coordinator takes a slot with the synchronous `tryAcquire` on the happy
+     * path — adding no `await` before dispatch, so concurrent telemetry emission
+     * order within a wave is unperturbed — and only awaits `acquire` when the
+     * runtime is saturated. A task holds its slot for the whole subsession and is
+     * released in a `finally`, so it stays pinned to its runtime for its duration.
+     */
+    runtimeLimiter?: RuntimeConcurrencyLimiter;
 };
 export type CorrelatedCostRecord = CostRecord & {
     decisionID: string;
@@ -42,10 +108,118 @@ export type RoleTaskResult = {
     subsession: SubsessionResult;
     record: CorrelatedCostRecord;
 };
+/**
+ * Emits an observable warning the first time an unknown roleID is encountered
+ * within a given `warnedRoles` Set. Callers own the Set and its lifetime:
+ * production callers pass a long-lived Set (no repeat logs); test callers pass
+ * a fresh `new Set()` per case (full isolation). When `warnedRoles` is not
+ * provided the warning is emitted unconditionally on every call.
+ *
+ * Follows the `warn*` convention used throughout the codebase
+ * (see `warnInertPrivacySetting`, `warnCostRecordRejections`).
+ */
+export declare function warnUnknownRole(roleID: string, warn?: (message?: unknown) => void, warnedRoles?: Set<string>): void;
+/**
+ * Actionable, English pre-dispatch failure for a role that requires a local
+ * runtime when none is reachable (#143). Names the role, states the hard
+ * requirement, lists the three supported local runtimes a user typically forgot
+ * to start, and points at `openteam doctor`. Deliberately not a generic provider
+ * error: a forgotten daemon is the overwhelmingly likely cause.
+ */
+export declare function mandatoryLocalRuntimeMessage(roleID: string): string;
+/**
+ * Enforces the mandatory-local requirement (#143) BEFORE any model dispatch.
+ * For a role with `requiresLocalRuntime === true`, refuses the request when no
+ * local runtime is reachable — it never falls through to frontier. This does not
+ * overturn the 2026-08-26 fallback ruling: that ruling preserves explicit
+ * prohibitions, and this is one such prohibition, carried per role.
+ *
+ * Reachability is resolved ONCE per batch by `resolveLocalRuntimeReachable` and
+ * passed in as data, so this check is synchronous and adds no `await` inside a
+ * concurrent wave (telemetry emission order is unperturbed). There is
+ * deliberately no fallback: a prohibition must fail closed, so anything other
+ * than an explicit `true` refuses the request.
+ */
+export declare function assertLocalRuntimeForRole(role: AgentRoleProfile, roleID: string, reachable: boolean | undefined): void;
+/**
+ * Reachability resolved once for a batch (#143/#144). `any` is whether at least
+ * one local runtime is reachable (the #143 boolean signal); `set`, when present,
+ * is the per-runtime reachability used to fail over across a role's ordered list
+ * and to select which runtime a task pins to. `set` is `undefined` when the
+ * per-runtime port is not wired or the batch has no role that declares a list —
+ * in which case only the boolean path is used, preserving pre-#144 behaviour.
+ */
+export type BatchReachability = {
+    readonly any: boolean | undefined;
+    readonly set: ReadonlySet<LocalRuntimeId> | undefined;
+};
+/**
+ * Classifies a raw failure reason into a bounded, non-free-form code for
+ * persisted telemetry. The raw `failureReason` from `errorReason()` in
+ * `subsessions.ts` can contain SDK error messages that echo request content
+ * (provider content-filter rejections, validation errors quoting the payload).
+ * Persisting those verbatim violates the project's telemetry policy: "auditable
+ * JSONL with a hashed prompt by default; do not store sensitive prompts."
+ *
+ * The classified code preserves the debugging signal that actually gets
+ * aggregated (timeout vs. rejection vs. missing session) while carrying no
+ * payload. The raw string remains available in-memory via
+ * `CorrelatedCostRecord.failureReason` for the tool response.
+ *
+ * Pure: no I/O, clock, random, or env.
+ */
+/**
+ * Classifies a raw failure reason into a bounded, non-free-form code for
+ * persisted telemetry AND the console failure viewer (P11c, see #195). The raw
+ * `failureReason` from `errorReason()` in `subsessions.ts` can contain SDK error
+ * messages that echo request content (provider content-filter rejections,
+ * validation errors quoting the payload). Persisting or rendering those verbatim
+ * violates the project's telemetry policy: "auditable JSONL with a hashed prompt
+ * by default; do not store sensitive prompts."
+ *
+ * The classified code preserves the debugging signal that actually gets
+ * aggregated (timeout vs. auth vs. rate-limit vs. rejection vs. missing session)
+ * while carrying no payload. The raw string remains available in-memory via
+ * `CorrelatedCostRecord.failureReason` for the tool response.
+ *
+ * Pure: no I/O, clock, random, or env.
+ */
+export declare const TelemetryFailureClassSchema: z.ZodEnum<{
+    "create-no-id": "create-no-id";
+    "create-rejected": "create-rejected";
+    "prompt-auth": "prompt-auth";
+    "prompt-connection": "prompt-connection";
+    "prompt-content-filter": "prompt-content-filter";
+    "prompt-context-length": "prompt-context-length";
+    "prompt-rate-limited": "prompt-rate-limited";
+    "prompt-rejected": "prompt-rejected";
+    "prompt-server": "prompt-server";
+    "prompt-timeout": "prompt-timeout";
+    "prompt-validation": "prompt-validation";
+    unknown: "unknown";
+}>;
+export type TelemetryFailureClass = z.infer<typeof TelemetryFailureClassSchema>;
+export declare function classifyFailureForTelemetry(failureReason: string, failureStage: string | undefined): TelemetryFailureClass;
+/**
+ * Console-facing classifier for an opencode `session.error` frame (P11c, see
+ * #195). The console failure viewer currently renders `error.message` verbatim;
+ * this maps the frame to a bounded {@link TelemetryFailureClass} so the viewer can
+ * render a class instead of a free-form provider string. Total and content-free:
+ * a frame with no recognised cause — or no message at all — maps to `unknown`, and
+ * the raw message is never returned.
+ */
+export declare function classifyOpencodeSessionError(error: {
+    readonly name?: string | undefined;
+    readonly message?: string | undefined;
+} | undefined): TelemetryFailureClass;
 /**
  * Mapea un `CorrelatedCostRecord` a un `route` event preservando la correlación
- * (decisionID/agent/success/batchID/failureReason/failureStage) que el sink de
+ * (decisionID/agent/success/batchID/failureStage) que el sink de
  * `CostRecord` legacy descartaba. Puro.
+ *
+ * `failureReason` is classified into a bounded code via
+ * `classifyFailureForTelemetry` rather than copied raw — the raw string may
+ * contain SDK error messages that echo request content.
  */
 export declare function correlatedCostRecordToRouteEvent(record: CorrelatedCostRecord): RouteEvent;
 /**
@@ -54,5 +228,17 @@ export declare function correlatedCostRecordToRouteEvent(record: CorrelatedCostR
  */
 export declare function buildMeetingEvent(inputs: readonly RoleTaskInput[], batchID: string, decisionIDs: readonly string[], ts: number): MeetingEvent | undefined;
 export declare function runRoleTask(input: RoleTaskInput, deps: CoordinatorDeps): Promise<RoleTaskResult>;
-export declare function runRoleTasks(inputs: readonly RoleTaskInput[], deps: CoordinatorDeps): Promise<RoleTaskResult[]>;
+export type RoleBatchResult = {
+    readonly batchID: string;
+    readonly results: RoleTaskResult[];
+    /** Role IDs that were not executed because a dependency failed or was cancelled. */
+    readonly cancelled: readonly string[];
+};
+/**
+ * Computes topological waves from inputs: each wave contains roles whose
+ * dependencies all appear in earlier waves. Roles with no `dependsOn` are in
+ * wave 0. Pure and deterministic: same inputs produce the same waves.
+ */
+export declare function topologicalWaves(inputs: readonly RoleTaskInput[]): RoleTaskInput[][];
+export declare function runRoleTasks(inputs: readonly RoleTaskInput[], deps: CoordinatorDeps): Promise<RoleBatchResult>;
 //# sourceMappingURL=coordinator.d.ts.map

package/dist/orchestrator/coordinator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAA0B,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAQrD,OAAO,EACL,KAAK,qBAAqB,EAG1B,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACpC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,MAAM,EAAE,oBAAoB,CAAC;CAC9B,CAAC;AAiLF;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,oBAAoB,GAC3B,UAAU,CAyBZ;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,EAAE,EAAE,MAAM,GACT,YAAY,GAAG,SAAS,CAkB1B;AA4DD,wBAAsB,WAAW,CAC/B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,cAAc,CAAC,CAIzB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,cAAc,EAAE,CAAC,CAuB3B"}
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/coordinator.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/graphCancellation.d.ts

@@ -1,71 +1,74 @@
 import type { GraphState, NodeStatus, RunStatus } from "../graph/types";
 /**
- * Políticas puras de cancelación, timeout y compleción tardía (GE-034).
+ * Pure policies for cancellation, timeout, and late completion (GE-034).
  *
- * Deciden, sin I/O ni reloj, qué hacer ante tres situaciones del runtime de
- * Graph. El runtime les inyecta la evidencia ya observada (estado del nodo, si
- * ya se pidió el abort, si expiró la ventana de gracia) y aplica el resultado:
+ * They decide, without I/O or a clock, what to do in three Graph runtime
+ * situations. The runtime injects the already observed evidence (node state,
+ * whether the abort was already requested, whether the grace window expired)
+ * and applies the result:
  *
- * - `timeoutAction`: en un timeout se pide **primero** el abort y solo se
- *   reconcilia tras agotar una ventana de gracia acotada; un nodo no `running`
- *   no tiene nada que expirar.
- * - `planCancellation`: cancelar un run en curso cancela sus nodos `pending` y
- *   `running` (así los `pending` no llegan a despacharse) y pide abort de los
- *   `running`; cancelar un run ya terminal es un no-op idempotente.
- * - `classifyLateCompletion`: un resultado que llega tarde se **audita** pero no
- *   puede revivir un intento cancelado, superado (otro `attemptID`/`operationID`)
- *   ni de un run ya terminal.
+ * - `timeoutAction`: on a timeout, request abort **first** and only reconcile
+ *   after exhausting a bounded grace window; a non-`running` node has nothing to
+ *   expire.
+ * - `planCancellation`: cancelling an in-progress run cancels its `pending` and
+ *   `running` nodes (so `pending` ones are never dispatched) and requests abort
+ *   for the `running` ones; cancelling an already terminal run is an idempotent
+ *   no-op.
+ * - `classifyLateCompletion`: a result that arrives late is **audited** but
+ *   cannot revive an attempt that was cancelled, superseded (another
+ *   `attemptID`/`operationID`), or belongs to an already terminal run.
  *
- * Todo es determinista: la misma evidencia produce la misma decisión, de modo
- * que se reproduce igual tras un reinicio.
+ * Everything is deterministic: the same evidence produces the same decision, so
+ * it is reproduced the same way after a restart.
  */
-/** Acción de timeout sobre el nodo en vuelo. */
+/** Timeout action for the in-flight node. */
 export type TimeoutAction = "noop" | "request-abort" | "awaiting-grace" | "reconcile";
-/** Evidencia inyectada para decidir el timeout de un nodo. */
+/** Injected evidence for deciding a node timeout. */
 export type TimeoutInput = {
     readonly nodeStatus: NodeStatus;
-    /** `true` si el runtime ya solicitó el abort de este intento. */
+    /** `true` if the runtime has already requested the abort for this attempt. */
     readonly abortRequested: boolean;
-    /** `true` si la ventana de gracia acotada ya expiró. */
+    /** `true` if the bounded grace window has already expired. */
     readonly graceExceeded: boolean;
 };
 /**
- * Decide la acción de timeout. Solo un nodo `running` puede expirar: si aún no
- * se pidió el abort, se pide; si ya se pidió, se espera hasta agotar la gracia y
- * entonces se reconcilia. Un nodo no `running` es un no-op.
+ * Decides the timeout action. Only a `running` node can expire: if abort has not
+ * been requested yet, request it; if it has already been requested, wait until
+ * grace is exhausted and then reconcile. A non-`running` node is a no-op.
  */
 export declare function timeoutAction(input: TimeoutInput): TimeoutAction;
-/** Plan determinista de cancelación de un run. */
+/** Deterministic plan for cancelling a run. */
 export type CancellationPlan = {
-    /** `true` si el run sigue en curso y debe marcarse `cancelled`. */
+    /** `true` if the run is still in progress and should be marked `cancelled`. */
     readonly cancelRun: boolean;
-    /** Nodos a marcar `cancelled` (los `pending` y `running`), en orden estable. */
+    /** Nodes to mark `cancelled` (the `pending` and `running` ones), in stable order. */
     readonly cancelNodeIDs: readonly string[];
-    /** Nodos `running` cuyo efecto debe abortarse, en orden estable. */
+    /** `running` nodes whose effect should be aborted, in stable order. */
     readonly abortNodeIDs: readonly string[];
 };
 /**
- * Planifica la cancelación del run. Cancela los nodos `pending` (para que no
- * lleguen a despacharse) y `running`, y pide abort de los `running`. Un run ya
- * terminal no vuelve a cancelarse y no deja nodos por cancelar (idempotente).
+ * Plans cancellation of the run. Cancels `pending` nodes (so they never get
+ * dispatched) and `running` nodes, and requests abort for the `running` ones. An
+ * already terminal run is not cancelled again and leaves no nodes to cancel
+ * (idempotent).
  */
 export declare function planCancellation(state: GraphState): CancellationPlan;
-/** Motivo por el que una compleción tardía se descarta. */
+/** Reason why a late completion is discarded. */
 export type LateCompletionReason = "run-terminal" | "unknown-node" | "not-running" | "superseded";
-/** Veredicto sobre un recibo que llega tarde. */
+/** Verdict for a receipt that arrives late. */
 export type LateCompletionVerdict = {
     readonly kind: "apply";
 } | {
     readonly kind: "stale";
     readonly reason: LateCompletionReason;
 };
-/** Estado mínimo del nodo destino del recibo tardío. */
+/** Minimum state of the target node for the late receipt. */
 export type LateCompletionNode = {
     readonly status: NodeStatus;
     readonly operationID?: string;
     readonly attemptID?: string;
 };
-/** Entrada para clasificar una compleción tardía. */
+/** Input for classifying a late completion. */
 export type LateCompletionInput = {
     readonly runStatus: RunStatus;
     readonly node: LateCompletionNode | undefined;
@@ -75,10 +78,10 @@ export type LateCompletionInput = {
     };
 };
 /**
- * Clasifica un recibo tardío. Solo se aplica al intento `running` vigente con
- * `operationID`/`attemptID` coincidentes; en cualquier otro caso (run terminal,
- * nodo desconocido, nodo no `running`, intento superado) se marca `stale` para
- * auditarlo sin mutar el estado.
+ * Classifies a late receipt. It applies only to the current `running` attempt
+ * with matching `operationID`/`attemptID`; in any other case (terminal run,
+ * unknown node, non-`running` node, superseded attempt) it is marked `stale` so
+ * it can be audited without mutating state.
  */
 export declare function classifyLateCompletion(input: LateCompletionInput): LateCompletionVerdict;
 //# sourceMappingURL=graphCancellation.d.ts.map

package/dist/orchestrator/graphCancellation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphCancellation.d.ts","sourceRoot":"","sources":["../../src/orchestrator/graphCancellation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAExE;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,gDAAgD;AAChD,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,eAAe,GACf,gBAAgB,GAChB,WAAW,CAAC;AAEhB,8DAA8D;AAC9D,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,iEAAiE;IACjE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,wDAAwD;IACxD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CAQhE;AAED,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,oEAAoE;IACpE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAiBpE;AAED,2DAA2D;AAC3D,MAAM,MAAM,oBAAoB,GAC5B,cAAc,GACd,cAAc,GACd,aAAa,GACb,YAAY,CAAC;AAEjB,iDAAiD;AACjD,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEtE,wDAAwD;AACxD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,mBAAmB,GACzB,qBAAqB,CAkBvB"}
+{"version":3,"file":"graphCancellation.d.ts","sourceRoot":"","sources":["../../src/orchestrator/graphCancellation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,eAAe,GACf,gBAAgB,GAChB,WAAW,CAAC;AAEhB,qDAAqD;AACrD,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CAQhE;AAED,+CAA+C;AAC/C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,uEAAuE;IACvE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAiBpE;AAED,iDAAiD;AACjD,MAAM,MAAM,oBAAoB,GAC5B,cAAc,GACd,cAAc,GACd,aAAa,GACb,YAAY,CAAC;AAEjB,+CAA+C;AAC/C,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEtE,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,+CAA+C;AAC/C,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,mBAAmB,GACzB,qBAAqB,CAkBvB"}

package/dist/orchestrator/graphEffects.d.ts

@@ -2,24 +2,25 @@ import type { ContextRef, PrivacyClass } from "../context/schema";
 import { type PrivacyMode, type RouteKind } from "../graph/privacyPolicy";
 import type { ErrorClass, GraphNode } from "../graph/schema";
 /**
- * `GraphEffectExecutor` — puerto del único efecto que el runtime de Graph
- * (GE-031) ejecuta por nodo. El runtime commitea la intención (`node.dispatched`)
- * en el journal **antes** de invocar `execute`, y el recibo (`node.succeeded` o
- * `node.failed`) **después**; el executor solo produce el resultado del efecto.
+ * `GraphEffectExecutor` — port for the only effect that the Graph runtime
+ * (GE-031) executes per node. The runtime commits the intention
+ * (`node.dispatched`) to the journal **before** invoking `execute`, and the
+ * receipt (`node.succeeded` or `node.failed`) **after**; the executor only
+ * produces the effect result.
  *
- * Este módulo es solo tipos: sin I/O, SDK, storage ni estado global. El runtime
- * recibe un executor inyectado; en producción lo implementará el adaptador de
- * sesión de opencode (GE-030), y en tests un doble determinista. Mantener el
- * seam como puerto permite probar el runtime sin red ni SDK reales.
+ * This module is types only: no I/O, SDK, storage, or global state. The runtime
+ * receives an injected executor; in production the opencode session adapter
+ * (GE-030) will implement it, and in tests a deterministic double. Keeping the
+ * seam as a port allows testing the runtime without real network or SDK.
  */
-/** Solicitud de ejecución de un efecto para un nodo e intento concretos. */
+/** Request to execute an effect for a specific node and attempt. */
 export type EffectRequest = {
     readonly runID: string;
     readonly node: GraphNode;
     readonly operationID: string;
     readonly attemptID: string;
 };
-/** Recibo de un efecto: éxito con artefacto referenciado, o fallo clasificado. */
+/** Effect receipt: success with a referenced artifact, or classified failure. */
 export type EffectReceipt = {
     readonly outcome: "succeeded";
     readonly artifact: ContextRef;
@@ -27,14 +28,14 @@ export type EffectReceipt = {
     readonly outcome: "failed";
     readonly errorClass: ErrorClass;
 };
-/** Ejecutor inyectable del efecto de un nodo. Determinista dado el request. */
+/** Injectable executor for a node effect. Deterministic for a given request. */
 export interface GraphEffectExecutor {
     execute(request: EffectRequest): Promise<EffectReceipt>;
 }
 /**
- * Contexto de privacidad de un despacho: clase de privacidad del nodo, modo
- * efectivo de la config y ruta preferida por el router. Deja al seam de efectos
- * la decisión reference-only/frontier antes y después de invocar al executor.
+ * Privacy context for a dispatch: node privacy class, effective config mode,
+ * and the route preferred by the router. Leaves the reference-only/frontier
+ * decision to the effects seam before and after invoking the executor.
  */
 export type EffectDispatchContext = {
     readonly privacyClass: PrivacyClass;
@@ -42,22 +43,21 @@ export type EffectDispatchContext = {
     readonly routeKind: RouteKind;
 };
 /**
- * Resuelve la ruta **efectiva** de un despacho (GE-037). Si la política prohíbe
- * frontier para la clase de privacidad bajo el modo activo, degrada a `local`
- * en vez de lanzar: un nodo `sensitive` con `forceLocalOnSensitive` produce
- * **cero** despachos a frontier. Puro y determinista.
+ * Resolves the **effective** route for a dispatch (GE-037). If policy forbids
+ * frontier for the privacy class under the active mode, degrades to `local`
+ * instead of throwing: a `sensitive` node with `forceLocalOnSensitive` produces
+ * **zero** frontier dispatches. Pure and deterministic.
  */
 export declare function resolveDispatchRoute(privacyClass: PrivacyClass, mode: PrivacyMode, preferred: RouteKind): RouteKind;
 /**
- * Gate de privacidad **antes** de invocar al executor: lanza
- * `PrivacyPolicyError` si un nodo `sensitive` bajo `forceLocalOnSensitive`
- * intenta una ruta frontier.
+ * Privacy gate **before** invoking the executor: throws `PrivacyPolicyError` if
+ * a `sensitive` node under `forceLocalOnSensitive` attempts a frontier route.
  */
 export declare function assertDispatchAllowed(ctx: EffectDispatchContext): void;
 /**
- * Gate reference-only **después** del executor: el recibo solo puede llevar una
- * `ContextRef` (éxito) o una clase de error (fallo); lanza `RedactionError` si
- * alguna estructura transporta un campo de contenido crudo.
+ * Reference-only gate **after** the executor: the receipt may only carry a
+ * `ContextRef` (success) or an error class (failure); throws `RedactionError` if
+ * any structure carries a raw content field.
  */
 export declare function assertReceiptReferenceOnly(receipt: EffectReceipt): void;
 //# sourceMappingURL=graphEffects.d.ts.map

package/dist/orchestrator/graphEffects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphEffects.d.ts","sourceRoot":"","sources":["../../src/orchestrator/graphEffects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;;;;;;;;GAUG;AAEH,4EAA4E;AAC5E,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAAC;AAEpE,+EAA+E;AAC/E,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACzD;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,SAAS,GACnB,SAAS,CAIX;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAEvE"}
+{"version":3,"file":"graphEffects.d.ts","sourceRoot":"","sources":["../../src/orchestrator/graphEffects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;;;;;;;;;GAWG;AAEH,oEAAoE;AACpE,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAAC;AAEpE,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACzD;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,SAAS,GACnB,SAAS,CAIX;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAEvE"}

package/dist/orchestrator/graphFacade.d.ts

@@ -1,16 +1,16 @@
 import { type ShadowMirror, type ShadowMirrorErrorCode } from "./graphShadow";
 /**
- * **Fachada de contención del espejo shadow** (GE-043).
+ * **Shadow mirror containment facade** (GE-043).
  *
- * El espejo observa al camino legacy; nunca lo gobierna. Esta frontera hace esa
- * garantía estructural en vez de disciplinaria: `mirrorLegacyTrace` es
- * **total** —no lanza para ningún valor de entrada, ni siquiera para objetos
- * hostiles cuyos accesores exploten— y `mirrorAlongsideLegacy` devuelve el
- * resultado legacy **por identidad**, sin copiarlo ni inspeccionarlo. Un fallo
- * del espejo degrada a un resultado tipado que el llamante puede ignorar; no
- * hay camino por el que altere el desenlace productivo.
+ * The mirror observes the legacy path; it never governs it. This boundary makes
+ * that guarantee structural rather than disciplinary: `mirrorLegacyTrace` is
+ * **total** —it does not throw for any input value, not even hostile objects
+ * whose accessors explode— and `mirrorAlongsideLegacy` returns the legacy result
+ * **by identity**, without copying or inspecting it. A mirror failure degrades
+ * to a typed result that the caller can ignore; there is no path by which it
+ * alters the production outcome.
  */
-/** Resultado contenido del espejo: éxito con evidencia, o fallo tipado. */
+/** Contained mirror result: success with evidence, or typed failure. */
 export type ShadowMirrorResult = {
     readonly ok: true;
     readonly mirror: ShadowMirror;
@@ -19,21 +19,21 @@ export type ShadowMirrorResult = {
     readonly code: ShadowMirrorErrorCode;
     readonly detail: string;
 };
-/** Resultado productivo con su espejo adjunto, nunca fusionados. */
+/** Production result with its mirror attached, never merged. */
 export type LegacyWithShadow<T> = {
     readonly legacy: T;
     readonly shadow: ShadowMirrorResult;
 };
 /**
- * Construye el espejo de un trace de procedencia no confiable. Cualquier fallo
- * —trace inválido, grafo irrepresentable, secuencia ilegal o error inesperado—
- * se devuelve como valor.
+ * Builds the mirror from an untrusted trace. Any failure — invalid trace,
+ * unrepresentable graph, illegal sequence, or unexpected error — is returned as
+ * a value.
  */
 export declare function mirrorLegacyTrace(trace: unknown): ShadowMirrorResult;
 /**
- * Adjunta el espejo a un desenlace legacy ya calculado. El valor legacy se
- * devuelve tal cual llegó: la identidad referencial es la prueba de que el
- * espejo no lo pudo tocar.
+ * Attaches the mirror to an already computed legacy outcome. The legacy value is
+ * returned exactly as it arrived: referential identity is the proof that the
+ * mirror could not touch it.
  */
 export declare function mirrorAlongsideLegacy<T>(legacy: T, trace: unknown): LegacyWithShadow<T>;
 //# sourceMappingURL=graphFacade.d.ts.map

package/dist/orchestrator/graphFacade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphFacade.d.ts","sourceRoot":"","sources":["../../src/orchestrator/graphFacade.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;GAUG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACpD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;IAChC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAuBpE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,GACb,gBAAgB,CAAC,CAAC,CAAC,CAErB"}
+{"version":3,"file":"graphFacade.d.ts","sourceRoot":"","sources":["../../src/orchestrator/graphFacade.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;GAUG;AAEH,wEAAwE;AACxE,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACpD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,gEAAgE;AAChE,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;IAChC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAuBpE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,GACb,gBAAgB,CAAC,CAAC,CAAC,CAErB"}