ocmm 0.5.3 → 0.6.0

package/dist/runtime-fallback/subagent-429-session.js

@@ -0,0 +1,316 @@
+import { candidateBlocker, blockedUntil, recoveryDeadline, scheduleDelay, scopeFor } from "./subagent-429-policy.js";
+export class Session429State {
+    lifecycleGeneration = 0;
+    timerGeneration = 0;
+    nextDispatchGeneration = 0;
+    initialPending = true;
+    pending;
+    active;
+    retryCounts = new Map();
+    blocked = new Map();
+    lastRecoveryDeadlines = new Map();
+    sessionID;
+    snapshotId;
+    deps;
+    isLive;
+    remove;
+    constructor(sessionID, snapshotId, deps, isLive, remove) {
+        this.sessionID = sessionID;
+        this.snapshotId = snapshotId;
+        this.deps = deps;
+        this.isLive = isLive;
+        this.remove = remove;
+    }
+    matchesSnapshot(snapshotId) { return this.snapshotId === snapshotId; }
+    activeTarget() { return this.active?.dispatch.target; }
+    stop() {
+        if (!this.isLive())
+            return;
+        this.lifecycleGeneration++;
+        this.timerGeneration++;
+        this.nextDispatchGeneration++;
+        this.pending?.cancel?.();
+        this.pending = undefined;
+        this.active = undefined;
+        this.remove();
+    }
+    on429(input) {
+        if (!this.matchesSnapshot(input.snapshotId) || this.stopIfSnapshotStale())
+            return { handled: false };
+        const restricted = this.restriction(input);
+        if (restricted)
+            return restricted;
+        if (this.active)
+            return this.queue429(input, this.active);
+        if (this.pending)
+            return { handled: true, action: "duplicate-outcome", dispatchGeneration: this.nextDispatchGeneration };
+        return this.process429(input, false);
+    }
+    onOtherError(input) {
+        if (!this.matchesSnapshot(input.snapshotId) || this.stopIfSnapshotStale())
+            return { handled: false };
+        const active = this.active;
+        if (!active) {
+            this.stop();
+            return { handled: false };
+        }
+        if (active.queuedOutcome)
+            return { handled: true, action: "duplicate-outcome", dispatchGeneration: active.generation };
+        active.queuedOutcome = {
+            kind: "other",
+            snapshotId: input.snapshotId,
+            dispatchGeneration: active.generation,
+            runGenericFallback: input.runGenericFallback,
+        };
+        if (active.settled)
+            this.processQueued(active);
+        return { handled: true, action: "queued-other-error", dispatchGeneration: active.generation };
+    }
+    onIdle() {
+        if (this.stopIfSnapshotStale())
+            return { kind: "untracked", suppressIdleContinuation: false };
+        if (this.initialPending) {
+            this.stop();
+            return { kind: "initial-succeeded", suppressIdleContinuation: false };
+        }
+        if (this.pending) {
+            this.pending.errorIdleObserved = true;
+            this.maybeStart(this.pending);
+            return { kind: "error-idle-observed", suppressIdleContinuation: true };
+        }
+        const active = this.active;
+        if (!active)
+            return { kind: "untracked", suppressIdleContinuation: false };
+        if (active.queuedOutcome?.kind === "429") {
+            if (active.queuedOutcome.snapshotId !== this.snapshotId) {
+                this.stop();
+                return { kind: "untracked", suppressIdleContinuation: false };
+            }
+            active.queuedOutcome.errorIdleObserved = true;
+            return { kind: "queued-error-idle-observed", suppressIdleContinuation: true };
+        }
+        active.idleObserved = true;
+        if (active.settled && !active.queuedOutcome) {
+            this.stop();
+            return { kind: "retry-succeeded", suppressIdleContinuation: false };
+        }
+        return { kind: "dispatch-idle-observed", suppressIdleContinuation: true };
+    }
+    restriction(input) {
+        const config = input.runtimeConfig;
+        if (!config.subagent429.enabled || !config.enabled) {
+            this.stop();
+            return { handled: false };
+        }
+        if (!config.dispatch) {
+            this.deps.logger.info("subagent429 observe-only", this.logTarget(input.target));
+            this.stop();
+            return { handled: true, action: "observe-only" };
+        }
+        if (this.deps.dispatchRetry)
+            return undefined;
+        this.deps.logger.warn("subagent429 dispatch stopped", { ...this.logTarget(input.target), reason: "dispatch-unavailable" });
+        this.stop();
+        return { handled: true, action: "stopped", reason: "dispatch-unavailable" };
+    }
+    process429(input, errorIdleObserved) {
+        if (!this.matchesSnapshot(input.snapshotId) || this.stopIfSnapshotStale())
+            return { handled: false };
+        const restricted = this.restriction(input);
+        if (restricted)
+            return restricted;
+        this.initialPending = false;
+        const scope = scopeFor(input.target, input.runtimeConfig);
+        const retriesUsed = this.retryCounts.get(scope.key) ?? 0;
+        const observedAt = this.deps.clock();
+        const deadline = recoveryDeadline(observedAt, input.classification.recoveryDelayMs);
+        if (deadline !== undefined)
+            this.lastRecoveryDeadlines.set(scope.key, deadline);
+        if (retriesUsed >= input.runtimeConfig.subagent429.maxRetries) {
+            this.blocked.set(scope.key, blockedUntil(this.lastRecoveryDeadlines.get(scope.key), observedAt, input.runtimeConfig.cooldownSeconds));
+            const prepared = input.prepareSwitch(input.target, candidateBlocker(this.blocked, input.runtimeConfig, this.deps.clock));
+            if (!prepared.ok) {
+                this.deps.logger.warn("subagent429 switch stopped", { ...this.logTarget(input.target), scope: scope.scope, reason: prepared.reason });
+                this.stop();
+                return { handled: true, action: "stopped", reason: prepared.reason };
+            }
+            if (prepared.prepared.snapshotId !== input.snapshotId) {
+                this.stop();
+                return { handled: false };
+            }
+            const dispatch = {
+                kind: "switch",
+                snapshotId: prepared.prepared.snapshotId,
+                target: prepared.prepared.target,
+                ...(input.agent === undefined ? {} : { agent: input.agent }),
+                reason: input.classification.reason,
+                prepared: prepared.prepared,
+            };
+            this.installGate(dispatch, 0, errorIdleObserved);
+            this.deps.logger.info("subagent429 switch gated", { ...this.logTarget(dispatch.target), attempt: prepared.prepared.attempt, delayMs: 0, scope: scope.scope, reason: dispatch.reason });
+            return { handled: true, action: "switch-gated", attempt: prepared.prepared.attempt, target: dispatch.target };
+        }
+        const delayMs = scheduleDelay(retriesUsed, input.classification.recoveryDelayMs, this.deps.random);
+        const dispatch = {
+            kind: "retry",
+            snapshotId: input.snapshotId,
+            target: input.target,
+            ...(input.agent === undefined ? {} : { agent: input.agent }),
+            reason: input.classification.reason,
+            scope: scope.scope,
+            scopeKey: scope.key,
+            retriesUsed,
+            retryOrdinal: retriesUsed + 1,
+        };
+        this.installGate(dispatch, delayMs, errorIdleObserved);
+        this.deps.logger.info("subagent429 retry gated", { ...this.logTarget(dispatch.target), retryOrdinal: dispatch.retryOrdinal, delayMs, scope: dispatch.scope, reason: dispatch.reason });
+        return { handled: true, action: "retry-gated", delayMs, retryOrdinal: dispatch.retryOrdinal, scope: dispatch.scope };
+    }
+    queue429(input, active) {
+        if (active.queuedOutcome)
+            return { handled: true, action: "duplicate-outcome", dispatchGeneration: active.generation };
+        active.queuedOutcome = {
+            kind: "429",
+            snapshotId: input.snapshotId,
+            dispatchGeneration: active.generation,
+            input,
+            errorIdleObserved: false,
+        };
+        if (active.settled)
+            this.processQueued(active);
+        return { handled: true, action: "queued-429", dispatchGeneration: active.generation };
+    }
+    installGate(dispatch, delayMs, errorIdleObserved) {
+        if (!this.matchesSnapshot(dispatch.snapshotId) || this.stopIfSnapshotStale())
+            return;
+        this.pending?.cancel?.();
+        const generation = ++this.timerGeneration;
+        const gate = {
+            generation,
+            snapshotId: dispatch.snapshotId,
+            delayReady: false,
+            errorIdleObserved,
+            started: false,
+            dispatch,
+        };
+        this.pending = gate;
+        gate.cancel = this.deps.scheduler.schedule(delayMs, async () => {
+            if (this.stopIfSnapshotStale())
+                return;
+            if (this.pending !== gate || this.timerGeneration !== generation || gate.snapshotId !== this.snapshotId)
+                return;
+            gate.delayReady = true;
+            this.maybeStart(gate);
+        });
+        this.maybeStart(gate);
+    }
+    maybeStart(gate) {
+        if (this.stopIfSnapshotStale())
+            return;
+        if (this.pending !== gate || gate.snapshotId !== this.snapshotId || gate.started || !gate.delayReady || !gate.errorIdleObserved)
+            return;
+        gate.started = true;
+        gate.cancel?.();
+        this.pending = undefined;
+        const active = {
+            generation: ++this.nextDispatchGeneration,
+            lifecycleGeneration: this.lifecycleGeneration,
+            snapshotId: gate.snapshotId,
+            dispatch: gate.dispatch,
+            idleObserved: false,
+            settled: false,
+            accounted: false,
+        };
+        this.active = active;
+        void this.settle(active);
+    }
+    async settle(active) {
+        if (!this.isCurrent(active)) {
+            this.stop();
+            return;
+        }
+        let dispatched = false;
+        try {
+            dispatched = await this.deps.dispatchRetry({
+                sessionID: this.sessionID,
+                snapshotId: active.snapshotId,
+                ...(active.dispatch.agent === undefined ? {} : { agent: active.dispatch.agent }),
+                target: active.dispatch.target,
+                reason: active.dispatch.reason,
+            });
+        }
+        catch {
+            dispatched = false;
+        }
+        if (!this.isCurrent(active)) {
+            this.stop();
+            return;
+        }
+        active.settled = true;
+        const requestProven = dispatched || active.queuedOutcome !== undefined;
+        if (requestProven && !active.accounted && !this.account(active))
+            return;
+        if (active.queuedOutcome)
+            return this.processQueued(active);
+        if (active.idleObserved)
+            return this.stop();
+        if (!dispatched) {
+            this.deps.logger.warn("subagent429 dispatch stopped", { ...this.logTarget(active.dispatch.target), reason: "bare-false" });
+            return this.stop();
+        }
+    }
+    processQueued(active) {
+        if (!active.queuedOutcome)
+            return;
+        const outcome = active.queuedOutcome;
+        if (!this.isCurrent(active) || outcome.snapshotId !== active.snapshotId) {
+            this.stop();
+            return;
+        }
+        this.active = undefined;
+        if (outcome.kind === "other") {
+            this.stop();
+            void outcome.runGenericFallback(active.dispatch.target).catch(() => {
+                this.deps.logger.warn("subagent429 generic handoff failed", { ...this.logTarget(active.dispatch.target), reason: "handoff-threw" });
+            });
+            return;
+        }
+        this.process429({
+            ...outcome.input,
+            snapshotId: outcome.snapshotId,
+            target: active.dispatch.target,
+        }, outcome.errorIdleObserved);
+    }
+    account(active) {
+        if (!this.isCurrent(active)) {
+            this.stop();
+            return false;
+        }
+        active.accounted = true;
+        if (active.dispatch.kind === "retry")
+            this.retryCounts.set(active.dispatch.scopeKey, active.dispatch.retriesUsed + 1);
+        else
+            active.dispatch.prepared.commit();
+        return true;
+    }
+    isCurrent(active) {
+        return this.isSnapshotCurrent()
+            && this.active === active
+            && this.lifecycleGeneration === active.lifecycleGeneration
+            && active.snapshotId === this.snapshotId
+            && active.dispatch.snapshotId === this.snapshotId;
+    }
+    isSnapshotCurrent() {
+        return this.isLive() && this.deps.isCurrentSnapshot(this.snapshotId);
+    }
+    stopIfSnapshotStale() {
+        if (this.isSnapshotCurrent())
+            return false;
+        this.stop();
+        return true;
+    }
+    logTarget(target) {
+        return { sessionID: this.sessionID, providerID: target.providerID, modelID: target.modelID };
+    }
+}
+//# sourceMappingURL=subagent-429-session.js.map

package/dist/runtime-fallback/subagent-429-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-429-session.js","sourceRoot":"","sources":["../../src/runtime-fallback/subagent-429-session.ts"],"names":[],"mappings":"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"}

package/dist/shared/opencode-events.d.ts

@@ -0,0 +1,22 @@
+export type SessionLineage = {
+    sessionID: string;
+    parentSessionID?: string;
+};
+export type TaskPartInterruptionEvidence = {
+    childSessionID: string;
+    parentSessionID: string;
+    parentPartID?: string;
+    callID?: string;
+    agent?: string;
+    taskID?: string;
+    terminalTaskErrorObserved: true;
+    transportInterrupted: boolean;
+    errorText: string;
+};
+export declare function eventEnvelope(raw: unknown): {
+    type: string;
+    properties: Record<string, unknown>;
+} | null;
+export declare function resolveSessionLineageProperties(props: unknown): SessionLineage | null;
+export declare function resolveSessionLineage(raw: unknown): SessionLineage | null;
+export declare function resolveTaskPartInterruption(raw: unknown): TaskPartInterruptionEvidence | null;

package/dist/shared/opencode-events.js

@@ -0,0 +1,75 @@
+import { isRecord } from "./logger.js";
+function stringField(value, keys) {
+    if (!isRecord(value))
+        return undefined;
+    for (const key of keys) {
+        const found = value[key];
+        if (typeof found === "string" && found.length > 0)
+            return found;
+    }
+    return undefined;
+}
+export function eventEnvelope(raw) {
+    if (!isRecord(raw))
+        return null;
+    const event = isRecord(raw.event) ? raw.event : raw;
+    const type = typeof event.type === "string" ? event.type : "";
+    if (!type)
+        return null;
+    const properties = isRecord(event.properties) ? event.properties : event;
+    return { type, properties };
+}
+export function resolveSessionLineageProperties(props) {
+    if (!isRecord(props))
+        return null;
+    const info = isRecord(props.info) ? props.info : undefined;
+    const session = isRecord(props.session) ? props.session : undefined;
+    const sessionID = stringField(props, ["sessionID", "sessionId"])
+        ?? (session ? stringField(session, ["id", "sessionID", "sessionId"]) : undefined)
+        ?? (info ? stringField(info, ["id", "sessionID", "sessionId"]) : undefined);
+    if (!sessionID)
+        return null;
+    const parentSessionID = stringField(props, ["parentID", "parentId", "parentSessionID", "parentSessionId"])
+        ?? (session ? stringField(session, ["parentID", "parentId", "parentSessionID", "parentSessionId"]) : undefined)
+        ?? (info ? stringField(info, ["parentID", "parentId", "parentSessionID", "parentSessionId"]) : undefined);
+    return { sessionID, ...(parentSessionID ? { parentSessionID } : {}) };
+}
+export function resolveSessionLineage(raw) {
+    const envelope = eventEnvelope(raw);
+    return envelope ? resolveSessionLineageProperties(envelope.properties) : null;
+}
+export function resolveTaskPartInterruption(raw) {
+    const envelope = eventEnvelope(raw);
+    if (!envelope || envelope.type !== "message.part.updated")
+        return null;
+    const part = isRecord(envelope.properties.part) ? envelope.properties.part : undefined;
+    if (!part || part.type !== "tool" || part.tool !== "task")
+        return null;
+    const state = isRecord(part.state) ? part.state : undefined;
+    if (!state || state.status !== "error")
+        return null;
+    const metadata = isRecord(state.metadata) ? state.metadata : undefined;
+    const input = isRecord(state.input) ? state.input : undefined;
+    const childSessionID = metadata ? stringField(metadata, ["sessionId", "sessionID"]) : undefined;
+    const parentSessionID = stringField(envelope.properties, ["sessionID", "sessionId"])
+        ?? (part ? stringField(part, ["sessionID", "sessionId"]) : undefined);
+    if (!childSessionID || !parentSessionID)
+        return null;
+    const inputTaskID = input ? stringField(input, ["task_id", "taskID", "taskId"]) : undefined;
+    const errorText = typeof state.error === "string" ? state.error : "";
+    const parentPartID = stringField(part, ["id"]);
+    const callID = stringField(part, ["callID", "callId"]);
+    const agent = input ? stringField(input, ["subagent_type", "agent"]) : undefined;
+    return {
+        childSessionID,
+        parentSessionID,
+        ...(parentPartID ? { parentPartID } : {}),
+        ...(callID ? { callID } : {}),
+        ...(agent ? { agent } : {}),
+        ...(inputTaskID ? { taskID: inputTaskID } : {}),
+        terminalTaskErrorObserved: true,
+        transportInterrupted: metadata?.interrupted === true,
+        errorText,
+    };
+}
+//# sourceMappingURL=opencode-events.js.map

package/dist/shared/opencode-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-events.js","sourceRoot":"","sources":["../../src/shared/opencode-events.ts"],"names":[],"mappings":"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"}

package/dist/shared/types.d.ts

@@ -43,6 +43,17 @@ export type ModelRequirement = {
     /** Restrict eligible providers (subset of provider IDs). */
     requiresProvider?: string[];
 };
+/** Where the route requirement was selected, before request-local overrides. */
+export type RequirementSource = "user-config" | "agent-default" | "category-default";
+/** Which final-primary selection branch won during route construction. */
+export type PrimarySource = "existing-model" | "user-requirement" | "catalog-upgrade" | "builtin-requirement";
+/** Immutable route snapshot materialized for one registered OpenCode agent. */
+export type EffectiveModelRoute = {
+    readonly model: string;
+    readonly requirement: ModelRequirement;
+    readonly requirementSource: RequirementSource;
+    readonly primarySource: PrimarySource;
+};
 /** Lightweight category descriptor used for documentation + delegate-task hints. */
 export type Category = {
     name: string;
@@ -85,4 +96,4 @@ export type ResolutionEntry = {
     /** Why we chose this entry (used in logs). */
     source: ResolutionSource;
 };
-export type ResolutionSource = "user-config" | "agent-default" | "category-default" | "input-variant" | "no-op";
+export type ResolutionSource = "user-config" | "agent-default" | "category-default" | "input-variant" | "host-profile-floor" | "no-op";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ocmm",
-  "version": "0.5.3",
+  "version": "0.6.0",
   "description": "OpenCode Multi-Model Auto-Router plugin (ocmm). Per-agent model selection, variant -> param translation, intent-keyword mode injection.",
   "type": "module",
   "main": "./dist/index.js",

package/plugins/deepwork/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "deepwork",
-  "version": "0.5.3",
+  "version": "0.6.0",
   "description": "Codex adapter for deepwork workflows, Deepwork agents, skills, and MCP tool registrations.",
   "author": {
     "name": "Hugefiver"

package/plugins/deepwork/README.md

@@ -3,11 +3,12 @@
 Generated from the Deepwork source tree. Do not edit generated files by hand; run `pnpm run gen:codex-plugin` from the repository root.
 
 - Workflow: `codex`
-- Generated agents: 21
+- Generated agents: 22
 - Skills are copied from `skills/` plus flattened `skills/v1/` deepwork skills.
 - MCP servers are generated from the Deepwork `mcp` config namespace.
 - The default `lsp` MCP uses the plugin-local `ocmm-lsp` wrapper and bundled GitHub Release binary.
 - Workflow skill: `deepwork`.
-- Generated Codex agent profiles use the `dw-*` prefix, including functional agents such as `dw-oracle` and `dw-creative`.
+- Generated Codex agent profiles use the `dw-*` prefix, including functional agents such as `dw-oracle`, `dw-oracle-2nd`, and `dw-creative`.
+- Logical Oracle/Reviewer tiers (for example `dw-oracle-high`) are emitted only when explicitly configured.
 
 The OpenCode plugin remains `dist/index.js`; this directory is the Codex adapter bundle.