odai-dsh-agent 0.2.5 → 0.2.7

package/preset/odai/runtime/route-card.mjs

@@ -1,168 +1,180 @@
 import { randomUUID } from "node:crypto";
-
+import { isUnknownRecord } from "./runtime-types.mjs";
 export const ROUTE_CARD_PROMPT = [
-  "## Odai frozen route cards",
-  "Use odai_route_card only after planning has frozen a concrete implementation boundary and executor separation has an observable net benefit.",
-  "After the canonical executor reassessment proves observable net benefit, freeze the card before implementation continues. Otherwise continue directly without a card or process narration.",
-  "A card must preserve the target, decisive evidence, allowed and forbidden scope, acceptance conditions, and stop condition. Do not freeze a card merely because an executor model is configured or cheaper.",
-  "The controller owns the card. Child agents may not create, replace, or clear it. A card is claimed for one executor attempt and consumed only after an applied executor route receipt; validation, provider, or receipt failure releases the claim for retry. A verified provider max-token interruption may reclaim that same card only after a direct user continuation, without changing its scope or authorization. A later explicit clear is terminal and cannot be undone by a delayed release.",
-  "When the original current task already authorizes implementation, a planner that freezes a card must submit an executor responsibility gap so implementation continues automatically in the same user task. Ask the user only for a new task, plan-only request, changed scope, or missing user-owned authorization.",
+    "## Odai frozen route cards",
+    "Use odai_route_card only after planning has frozen a concrete implementation boundary and executor separation has an observable net benefit.",
+    "After the canonical executor reassessment proves observable net benefit, freeze the card before implementation continues. Otherwise continue directly without a card or process narration.",
+    "A card must preserve the target, decisive evidence, allowed and forbidden scope, acceptance conditions, and stop condition. Do not freeze a card merely because an executor model is configured or cheaper.",
+    "The controller owns the card. Child agents may not create, replace, or clear it. A card is claimed for one executor attempt and consumed only after an applied executor route receipt; validation, provider, or receipt failure releases the claim for retry. A verified provider max-token interruption may reclaim that same card only after a direct user continuation, without changing its scope or authorization. A later explicit clear is terminal and cannot be undone by a delayed release.",
+    "When the original current task already authorizes implementation, a planner that freezes a card must submit an executor responsibility gap so implementation continues automatically in the same user task. Ask the user only for a new task, plan-only request, changed scope, or missing user-owned authorization.",
 ].join("\n");
-
 function nonEmptyString(value, field) {
-  if (typeof value !== "string" || value.trim() === "") throw new TypeError(`${field} must be a non-empty string`);
-  return value.trim();
+    if (typeof value !== "string" || value.trim() === "")
+        throw new TypeError(`${field} must be a non-empty string`);
+    return value.trim();
 }
-
 function stringList(value, field, minimum = 0) {
-  if (!Array.isArray(value) || value.length < minimum) {
-    throw new TypeError(`${field} must be an array with at least ${minimum} item${minimum === 1 ? "" : "s"}`);
-  }
-  return Object.freeze(value.map((item, index) => nonEmptyString(item, `${field}[${index}]`)));
+    if (!Array.isArray(value) || value.length < minimum) {
+        throw new TypeError(`${field} must be an array with at least ${minimum} item${minimum === 1 ? "" : "s"}`);
+    }
+    return Object.freeze(value.map((item, index) => nonEmptyString(item, `${field}[${index}]`)));
 }
-
 function normalizeAuthorization(value) {
-  const status = value?.status;
-  if (!["authorized", "plan-only", "unknown"].includes(status)) return Object.freeze({ status: "unknown" });
-  const userMessageId = typeof value.userMessageId === "string" && value.userMessageId.length > 0 && value.userMessageId.length <= 200
-    ? value.userMessageId
-    : undefined;
-  return Object.freeze({ status, ...(userMessageId ? { userMessageId } : {}) });
+    if (!isUnknownRecord(value))
+        return Object.freeze({ status: "unknown" });
+    const status = value.status;
+    if (status !== "authorized" && status !== "plan-only" && status !== "unknown") {
+        return Object.freeze({ status: "unknown" });
+    }
+    const userMessageId = typeof value.userMessageId === "string" && value.userMessageId.length > 0 && value.userMessageId.length <= 200
+        ? value.userMessageId
+        : undefined;
+    return Object.freeze({ status, ...(userMessageId ? { userMessageId } : {}) });
 }
-
-function normalizeCard(args, authorization) {
-  if (args.observableBenefit !== true) {
-    throw new TypeError("observableBenefit must be true before freezing an executor route card");
-  }
-  return Object.freeze({
-    id: randomUUID(),
-    frozen: true,
-    observableBenefit: true,
-    authorization: normalizeAuthorization(authorization),
-    target: nonEmptyString(args.target, "target"),
-    evidence: stringList(args.evidence, "evidence", 1),
-    scope: stringList(args.scope, "scope", 1),
-    accept: stringList(args.accept, "accept", 1),
-    stop: nonEmptyString(args.stop, "stop"),
-  });
+function normalizeCard(arguments_, authorization) {
+    if (arguments_.observableBenefit !== true) {
+        throw new TypeError("observableBenefit must be true before freezing an executor route card");
+    }
+    return Object.freeze({
+        id: randomUUID(),
+        frozen: true,
+        observableBenefit: true,
+        authorization: normalizeAuthorization(authorization),
+        target: nonEmptyString(arguments_.target, "target"),
+        evidence: stringList(arguments_.evidence, "evidence", 1),
+        scope: stringList(arguments_.scope, "scope", 1),
+        accept: stringList(arguments_.accept, "accept", 1),
+        stop: nonEmptyString(arguments_.stop, "stop"),
+    });
+}
+function isRouteCard(value) {
+    return isUnknownRecord(value)
+        && value.frozen === true
+        && typeof value.id === "string";
 }
-
 function routeCardInState(events, acceptedStates) {
-  const source = Array.isArray(events) ? events : [];
-  const permanentlyCleared = new Set(source.flatMap((event) => (
-    event?.type === "odai/route-card-cleared" && typeof event.data?.cardId === "string"
-      ? [event.data.cardId]
-      : []
-  )));
-  const latestState = new Map();
-  for (let index = source.length - 1; index >= 0; index -= 1) {
-    const event = source[index];
-    const cardId = event?.data?.cardId;
-    if (typeof cardId === "string" && !latestState.has(cardId)) {
-      if (event.type === "odai/route-card-claim-released") latestState.set(cardId, "active");
-      else if (event.type === "odai/route-card-claimed") latestState.set(cardId, "claimed");
-      else if (["odai/route-card-cleared", "odai/route-card-consumed"].includes(event.type)) latestState.set(cardId, "closed");
+    const source = Array.isArray(events) ? events : [];
+    const permanentlyCleared = new Set(source.flatMap((event) => (event?.type === "odai/route-card-cleared" && typeof event.data?.cardId === "string"
+        ? [event.data.cardId]
+        : [])));
+    const latestState = new Map();
+    for (let index = source.length - 1; index >= 0; index -= 1) {
+        const event = source[index];
+        const cardId = event?.data?.cardId;
+        if (typeof cardId === "string" && !latestState.has(cardId)) {
+            if (event.type === "odai/route-card-claim-released")
+                latestState.set(cardId, "active");
+            else if (event.type === "odai/route-card-claimed")
+                latestState.set(cardId, "claimed");
+            else if (["odai/route-card-cleared", "odai/route-card-consumed"].includes(event.type))
+                latestState.set(cardId, "closed");
+        }
+        if (event?.type !== "odai/route-card-frozen")
+            continue;
+        const card = event.data?.card;
+        if (!isRouteCard(card))
+            continue;
+        const state = permanentlyCleared.has(card.id) ? "closed" : (latestState.get(card.id) ?? "active");
+        if (acceptedStates.has(state))
+            return card;
     }
-    if (event?.type !== "odai/route-card-frozen") continue;
-    const card = event.data?.card;
-    if (card?.frozen !== true || typeof card.id !== "string") continue;
-    const state = permanentlyCleared.has(card.id) ? "closed" : (latestState.get(card.id) ?? "active");
-    if (acceptedStates.has(state)) return card;
-  }
-  return undefined;
+    return undefined;
 }
-
 export function activeRouteCard(events) {
-  return routeCardInState(events, new Set(["active"]));
+    return routeCardInState(events, new Set(["active"]));
 }
-
 export function unsettledRouteCard(events) {
-  return routeCardInState(events, new Set(["active", "claimed"]));
+    return routeCardInState(events, new Set(["active", "claimed"]));
 }
-
 export function routeCardById(events, cardId) {
-  if (typeof cardId !== "string" || cardId === "") return undefined;
-  for (let index = (Array.isArray(events) ? events.length : 0) - 1; index >= 0; index -= 1) {
-    const event = events[index];
-    const card = event?.data?.card;
-    if (event?.type === "odai/route-card-frozen" && card?.id === cardId && card.frozen === true) return card;
-  }
-  return undefined;
+    if (typeof cardId !== "string" || cardId === "")
+        return undefined;
+    for (let index = (Array.isArray(events) ? events.length : 0) - 1; index >= 0; index -= 1) {
+        const event = events?.[index];
+        const card = event?.data?.card;
+        if (event?.type === "odai/route-card-frozen" && isRouteCard(card) && card.id === cardId)
+            return card;
+    }
+    return undefined;
 }
-
 export function createRouteCardTool(options = {}) {
-  const onFrozen = typeof options.onFrozen === "function" ? options.onFrozen : () => {};
-  const onCleared = typeof options.onCleared === "function" ? options.onCleared : () => {};
-  const activeFor = typeof options.activeFor === "function" ? options.activeFor : () => undefined;
-  const unsettledFor = typeof options.unsettledFor === "function" ? options.unsettledFor : activeFor;
-  const authorizationFor = typeof options.authorizationFor === "function"
-    ? options.authorizationFor
-    : () => Object.freeze({ status: "unknown" });
-  return {
-    name: "odai_route_card",
-    description: "Freeze or clear one structured executor route card. Use only when planning has bounded implementation and independently justified executor separation.",
-    parameters: {
-      type: "object",
-      additionalProperties: false,
-      required: ["action"],
-      properties: {
-        action: { type: "string", enum: ["freeze", "clear"] },
-        target: { type: "string" },
-        evidence: { type: "array", items: { type: "string" } },
-        scope: { type: "array", items: { type: "string" } },
-        accept: { type: "array", items: { type: "string" } },
-        stop: { type: "string" },
-        observableBenefit: { type: "boolean" },
-        cardId: { type: "string" },
-      },
-    },
-    output: {
-      schema: {
-        type: "object",
-        additionalProperties: false,
-        required: ["action", "status"],
-        properties: {
-          action: { type: "string", enum: ["freeze", "clear"] },
-          status: { type: "string", enum: ["frozen", "cleared", "absent"] },
-          card: { type: "object" },
-          cardId: { type: "string" },
+    const onFrozen = typeof options.onFrozen === "function" ? options.onFrozen : () => { };
+    const onCleared = typeof options.onCleared === "function" ? options.onCleared : () => { };
+    const activeFor = typeof options.activeFor === "function" ? options.activeFor : () => undefined;
+    const unsettledFor = typeof options.unsettledFor === "function" ? options.unsettledFor : activeFor;
+    const authorizationFor = typeof options.authorizationFor === "function"
+        ? options.authorizationFor
+        : () => Object.freeze({ status: "unknown" });
+    return {
+        name: "odai_route_card",
+        description: "Freeze or clear one structured executor route card. Use only when planning has bounded implementation and independently justified executor separation.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            required: ["action"],
+            properties: {
+                action: { type: "string", enum: ["freeze", "clear"] },
+                target: { type: "string" },
+                evidence: { type: "array", items: { type: "string" } },
+                scope: { type: "array", items: { type: "string" } },
+                accept: { type: "array", items: { type: "string" } },
+                stop: { type: "string" },
+                observableBenefit: { type: "boolean" },
+                cardId: { type: "string" },
+            },
         },
-      },
-      render(_args, value) {
-        return [{
-          type: "text",
-          text: value.status === "frozen"
-            ? `Frozen executor route card ${value.card.id}: ${value.card.target}`
-            : value.status === "cleared"
-              ? `Cleared executor route card ${value.cardId}.`
-              : "No active executor route card exists.",
-        }];
-      },
-    },
-    execute(args, execution) {
-      if (!execution.agent) throw new Error("odai_route_card requires an owning agent session");
-      const header = execution.agent.session?.header;
-      if (header?.origin === "subagent" || (Number.isSafeInteger(header?.delegationDepth) && header.delegationDepth > 0)) {
-        throw new Error("child agents may not change Odai route cards");
-      }
-      if (!args || typeof args !== "object" || Array.isArray(args)) throw new TypeError("arguments must be an object");
-      if (args.action === "freeze") {
-        const active = unsettledFor(execution.agent);
-        if (active) throw new Error(`executor route card ${active.id} is already active or claimed`);
-        const card = normalizeCard(args, authorizationFor(execution.agent));
-        onFrozen(execution.agent, card);
-        return Promise.resolve(Object.freeze({ action: "freeze", status: "frozen", card }));
-      }
-      if (args.action === "clear") {
-        const card = activeFor(execution.agent);
-        if (!card) return Promise.resolve(Object.freeze({ action: "clear", status: "absent" }));
-        if (args.cardId !== undefined && args.cardId !== card.id) {
-          throw new Error(`route card ${args.cardId} does not match active card ${card.id}`);
-        }
-        onCleared(execution.agent, card.id);
-        return Promise.resolve(Object.freeze({ action: "clear", status: "cleared", cardId: card.id }));
-      }
-      throw new TypeError("action must be freeze or clear");
-    },
-  };
+        output: {
+            schema: {
+                type: "object",
+                additionalProperties: false,
+                required: ["action", "status"],
+                properties: {
+                    action: { type: "string", enum: ["freeze", "clear"] },
+                    status: { type: "string", enum: ["frozen", "cleared", "absent"] },
+                    card: { type: "object" },
+                    cardId: { type: "string" },
+                },
+            },
+            render(_arguments, value) {
+                return [{
+                        type: "text",
+                        text: value.status === "frozen"
+                            ? `Frozen executor route card ${value.card.id}: ${value.card.target}`
+                            : value.status === "cleared"
+                                ? `Cleared executor route card ${value.cardId}.`
+                                : "No active executor route card exists.",
+                    }];
+            },
+        },
+        execute(arguments_, execution) {
+            if (!execution.agent)
+                throw new Error("odai_route_card requires an owning agent session");
+            const header = execution.agent.session?.header;
+            if (header?.origin === "subagent" || (Number.isSafeInteger(header?.delegationDepth) && (header?.delegationDepth ?? 0) > 0)) {
+                throw new Error("child agents may not change Odai route cards");
+            }
+            if (!isUnknownRecord(arguments_))
+                throw new TypeError("arguments must be an object");
+            if (arguments_.action === "freeze") {
+                const active = unsettledFor(execution.agent);
+                if (active)
+                    throw new Error(`executor route card ${active.id} is already active or claimed`);
+                const card = normalizeCard(arguments_, authorizationFor(execution.agent));
+                onFrozen(execution.agent, card);
+                return Promise.resolve(Object.freeze({ action: "freeze", status: "frozen", card }));
+            }
+            if (arguments_.action === "clear") {
+                const card = activeFor(execution.agent);
+                if (!card)
+                    return Promise.resolve(Object.freeze({ action: "clear", status: "absent" }));
+                if (arguments_.cardId !== undefined && arguments_.cardId !== card.id) {
+                    throw new Error(`route card ${String(arguments_.cardId)} does not match active card ${card.id}`);
+                }
+                onCleared(execution.agent, card.id);
+                return Promise.resolve(Object.freeze({ action: "clear", status: "cleared", cardId: card.id }));
+            }
+            throw new TypeError("action must be freeze or clear");
+        },
+    };
 }
+//# sourceMappingURL=route-card.mjs.map

package/preset/odai/runtime/route-card.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-card.mjs","sourceRoot":"","sources":["../src/route-card.mts"],"names":[],"mappings":"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"}

package/preset/odai/runtime/router.d.mts

@@ -0,0 +1,80 @@
+import type { DshEvent, DshMessage, ModelRoute } from "./runtime-types.mjs";
+export type OdaiRouteRole = "controller" | "researcher" | "planner" | "executor" | "reviewer" | "frontend";
+export type OdaiRouteAction = "direct" | "delegate" | "upgrade";
+export interface RouteConsideration {
+    readonly role: string;
+    readonly match: string;
+    readonly action: "skip";
+    readonly reasonCode: string;
+    readonly signals: readonly string[];
+    readonly unmet: readonly string[];
+}
+export interface RouteDecision {
+    readonly role: OdaiRouteRole;
+    readonly mode: OdaiRouteAction;
+    readonly action: OdaiRouteAction;
+    readonly targetRole?: OdaiRouteRole;
+    readonly reasonCode: string;
+    readonly reason: string;
+    readonly signals: readonly string[];
+    readonly considerations?: readonly RouteConsideration[];
+}
+export interface ResponsibilityGapState {
+    readonly responsibility: string;
+    readonly gap: string;
+    readonly stateDigest: string;
+}
+export interface RouteCardState {
+    readonly frozen?: boolean;
+    readonly observableBenefit?: boolean;
+    readonly authorization?: {
+        readonly status?: string;
+    };
+}
+export interface ResponsibilityInterruptionState {
+    readonly responsibility?: string;
+    readonly continuationText?: string;
+}
+export interface RouteDecisionInput {
+    readonly text?: string;
+    readonly proposal?: ResponsibilityGapState;
+    readonly routeCard?: RouteCardState;
+    readonly interruption?: ResponsibilityInterruptionState;
+}
+export interface FrontendSpecializationSignals {
+    readonly explicit: boolean;
+    readonly scope: boolean;
+    readonly delivery: boolean;
+    readonly strongWork: boolean;
+    readonly nonUiRequest: boolean;
+    readonly specialistDepth: boolean;
+    readonly surfaceCount: number;
+    readonly axes: readonly string[];
+    readonly substantial: boolean;
+}
+export interface ImplementationAuthorization {
+    readonly status: "authorized" | "plan-only" | "unknown";
+}
+export declare const HIGH_IMPACT_PLANNER_REASON = "PLANNER_UNVERIFIED_HIGH_IMPACT_CHANGE";
+export declare const RESEARCHER_EVIDENCE_REASON = "RESEARCHER_MULTI_SOURCE_DECISION_EVIDENCE";
+export declare const FRONTEND_SPECIALIST_REASON = "FRONTEND_SUBSTANTIAL_INTERFACE_WORK";
+export declare const EXECUTOR_ROUTE_CARD_REASON = "EXECUTOR_FROZEN_ROUTE_NET_BENEFIT";
+export declare const OUTPUT_LIMIT_CONTINUATION_REASON = "RESPONSIBILITY_OUTPUT_LIMIT_CONTINUATION";
+export declare function classifyResponsibilityInterruptionText(text: unknown): "continue" | "preserve" | "clear";
+export declare function classifyPendingReviewerText(text: unknown): "continue" | "supersede" | "dormant";
+export declare function classifyImplementationAuthorization(text: unknown): Readonly<ImplementationAuthorization>;
+export declare function decideResearchPrefetch(input?: RouteDecisionInput): Readonly<RouteDecision>;
+/**
+ * Choose the smallest useful odai role. Risk alone never creates another role.
+ * Executor routing requires a frozen route card and observable net benefit;
+ * those facts cannot be inferred from task prose.
+ */
+export declare function decideRoute(input?: RouteDecisionInput): Readonly<RouteDecision>;
+export declare function extractLatestUserText(messages: readonly DshMessage[] | undefined): string;
+export declare function extractRoutingText(messages: readonly DshMessage[] | undefined, sessionEvents: readonly DshEvent[] | undefined): string;
+export declare function requiresFailClosedProtection(decision: RouteDecision | undefined): boolean;
+export declare function renderRouteNotice(decision: RouteDecision, runtimeMode: string, actualRoute?: ModelRoute): string;
+export declare function renderMissingRouteConfigNotice(decision: RouteDecision, runtimeMode: string, configFailure?: string): string;
+export declare function renderRouteFailureNotice(decision: RouteDecision, failure: unknown): string;
+export declare function renderDelegationPrompt(decision: Pick<RouteDecision, "role">, taskText: string, roleContract: unknown): string;
+//# sourceMappingURL=router.d.mts.map

package/preset/odai/runtime/router.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.mts","sourceRoot":"","sources":["../src/router.mts"],"names":[],"mappings":"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"}