@pfoundation/ocadvisor 26.9.1 → 26.9.3

package/dist/typesafeGate.js

@@ -0,0 +1,475 @@
+// Optional TypeSafe preflight for advisor invocations.
+//
+// One System One request decides whether this specific consultation is
+// worth the expensive advisor generation, and — when effort selection is
+// available — which effort fits. The gate never blocks on its own failures:
+// timeouts, transport errors, malformed answers, and missing credentials all
+// fall back to the ordinary advisor behavior.
+import { TypeSafeClient, choice, noul } from "@typesafe-ai/sdk";
+export const GATE_NEEDED_QUESTION = "needed";
+export const GATE_EFFORT_QUESTION = "effort";
+// Leaves headroom for state plus the longest question inside the documented
+// 32k state+question and 64k overall context limits.
+export const TYPESAFE_STATE_TOKEN_BUDGET = 16000;
+const BYTES_PER_TOKEN = 4;
+const MIN_STATE_BYTES = 1024;
+const MAX_QUESTION_CHARS = 2000;
+// Built-in effort criteria. Custom variant names fall back to a generic
+// description; the effort decision never changes whether consultation
+// happens, so a coarser description only affects level choice.
+const EFFORT_CRITERIA = {
+    high: "Focused question, clear evidence, limited scope, and few interacting constraints",
+    xhigh: "Meaningful design tradeoffs, cross-component behavior, or several interacting correctness concerns",
+    max: "Difficult unresolved failures, conflicting evidence, or deeply interconnected high-consequence decisions",
+};
+const DEFAULT_EFFORT_CRITERION = "This level fits a consultation more demanding than the lower levels and less demanding than the higher ones";
+// Calibrated with these exact instructions and criteria at skipBelow=0.20.
+// See docs/reports/2026-09-20-gate-policy.md before changing the threshold:
+// the same numeric cutoff is not interchangeable across question wordings.
+export const NEEDED_INSTRUCTIONS = {
+    question: "Would this specific advisor consultation add material value beyond the requesting agent's next direct action with the evidence and tools already available?",
+    judge: [
+        "Assess the actual unresolved question, not just whether it is phrased as a request for an opinion.",
+        "Material value includes resolving substantive uncertainty, comparing meaningful approaches, finding a plausible correctness issue, or independent review of consequential work. Being stuck is not required.",
+        "A useful action that is already determined by direct reading, a deterministic tool, or an explicit mechanical instruction usually needs no consultation.",
+        "Explicit user requests for the advisor should proceed. Missing or truncated task context is uncertainty, not proof that consultation is unnecessary.",
+        "Prior consultations are not a quota. Revisit changed evidence or concerns; an identical settled question without new evidence adds little.",
+        "Model identities alone do not establish value. Relevant comparable benchmarks may inform substantive cases; an advisor advantage cannot turn a direct lookup into a substantive case. A strong requester still benefits from independent review. Missing, stale, or incomparable benchmarks neither prove nor disprove value.",
+    ],
+};
+export const NEEDED_CRITERIA = {
+    true: "A substantive unresolved decision, diagnosis, or correctness concern could benefit from independent reasoning; or the user explicitly requests the advisor. Uncertain task evidence does not justify suppressing consultation.",
+    false: "Visible evidence establishes that a direct lookup, deterministic operation, mechanical edit, or unchanged previously answered question resolves this request without meaningful independent reasoning.",
+};
+export const EFFORT_INSTRUCTIONS = `Assuming this consultation proceeds, which effort level is appropriate for this specific decision or review?
+Choose from the supplied levels based on reasoning difficulty, uncertainty, interacting components, and consequences, not transcript length.
+This question is independent of whether consultation should happen.
+\`models.advisor\` lists the allowed efforts with each effort's benchmark coverage; weigh coverage alongside difficulty, and treat missing coverage as uncertainty rather than disqualification.`;
+export class TypeSafeGateError extends Error {
+    kind;
+    type;
+    constructor(kind, type) {
+        super(kind);
+        this.name = "TypeSafeGateError";
+        this.kind = kind;
+        this.type = type;
+    }
+}
+export function createSdkClient(options = {}) {
+    const client = new TypeSafeClient({
+        ...(options.apiKey !== undefined ? { apiKey: options.apiKey } : {}),
+        ...(options.baseURL !== undefined ? { baseURL: options.baseURL } : {}),
+        ...(options.defaultModel !== undefined
+            ? { defaultModel: options.defaultModel }
+            : {}),
+        ...(options.fetch !== undefined ? { fetch: options.fetch } : {}),
+        // The gate owns its deadline; SDK retries could exceed it.
+        retry: { maxRetries: 0 },
+    });
+    return {
+        async systemOne(call) {
+            try {
+                const result = (await client.systemOne({
+                    state: call.state,
+                    questions: call.questions,
+                    ...(call.model ? { model: call.model } : {}),
+                }, { signal: call.signal, timeout: call.timeoutMs }));
+                return { kind: "response", result };
+            }
+            catch (error) {
+                return { kind: "error", type: classifyFailure(error) };
+            }
+        },
+    };
+}
+// Fixed reason codes instead of raw SDK errors: exception messages can carry
+// transport details and are not stable across SDK releases.
+export function classifyFailure(error) {
+    const name = error && typeof error === "object" && "name" in error
+        ? String(error.name)
+        : "";
+    switch (name) {
+        case "AuthenticationError":
+            return "auth";
+        case "RateLimitError":
+            return "rate_limit";
+        case "APITimeoutError":
+            return "timeout";
+        case "APIConnectionError":
+            return "connection";
+        case "BadRequestError":
+        case "UnprocessableEntityError":
+            return "invalid_request";
+        case "InternalServerError":
+            return "server_error";
+        case "APIUserAbortError":
+            return "aborted";
+        case "NotFoundError":
+            return "not_found";
+        case "PermissionDeniedError":
+            return "permission_denied";
+        default:
+            return "unknown";
+    }
+}
+function proceedReason(input, availableEffortLevels, source) {
+    if (input.explicitEffort)
+        return "caller_effort";
+    // A valid need judgment with no candidate levels keeps the configured
+    // effort; that is still an allowed consultation.
+    if (source === "typesafe" || availableEffortLevels.length > 0) {
+        return "allowed";
+    }
+    return "effort_unknown";
+}
+function byteLength(value) {
+    return Buffer.byteLength(JSON.stringify(value), "utf8");
+}
+function questionText(question) {
+    if (!question)
+        return null;
+    return question.length > MAX_QUESTION_CHARS
+        ? question.slice(-MAX_QUESTION_CHARS)
+        : question;
+}
+function projectMatch(match) {
+    return {
+        status: match.status,
+        source: match.source,
+        aa_model: match.aaModelID,
+        evaluated_effort: match.evaluatedEffort,
+    };
+}
+function projectEffortPolicy(policy) {
+    switch (policy.kind) {
+        case "pinned":
+            return { kind: "pinned", effort: policy.effort };
+        case "candidates":
+            return {
+                kind: "candidates",
+                candidates: [...policy.candidates],
+                fallback: policy.fallback,
+            };
+        case "fixed":
+            return { kind: "fixed", effort: policy.effort };
+    }
+}
+function buildStatePayload(state) {
+    return {
+        request: {
+            question: questionText(state.request.question),
+            mode: state.request.mode,
+            trigger: state.request.trigger,
+            explicitEffort: state.request.explicitEffort,
+            caller: state.request.caller,
+        },
+        models: state.models
+            ? {
+                requester: {
+                    provider: state.models.requester.providerID,
+                    model: state.models.requester.modelID,
+                    effort: state.models.requester.variant,
+                    provenance: state.models.requester.provenance,
+                },
+                advisor: {
+                    provider: state.models.advisor.providerID,
+                    model: state.models.advisor.modelID,
+                    effort_policy: projectEffortPolicy(state.models.advisor.policy),
+                },
+            }
+            : null,
+        benchmarks: state.benchmarks
+            ? {
+                source: state.benchmarks.source,
+                fetched_at: state.benchmarks.fetchedAt,
+                age_days: state.benchmarks.ageDays,
+                content_hash: state.benchmarks.contentHash,
+                hash_verified: state.benchmarks.hashVerified,
+                requester_match: projectMatch(state.benchmarks.requesterMatch),
+                advisor_default_match: projectMatch(state.benchmarks.advisorDefaultMatch),
+                advisor_candidates: state.benchmarks.advisorCandidates.map((entry) => ({
+                    effort: entry.effort,
+                    ...projectMatch(entry),
+                })),
+                comparisons: state.benchmarks.comparisons.map((entry) => ({
+                    metric: entry.key,
+                    label: entry.label,
+                    unit: entry.unit,
+                    requester: entry.requester,
+                    advisor: entry.advisor,
+                    advisor_minus_requester: entry.advisorMinusRequester,
+                    comparable: entry.comparable,
+                    reason: entry.reason,
+                })),
+                omitted: state.benchmarks.omitted,
+            }
+            : null,
+        latest_user_request: state.user.latestRequest,
+        recent_messages: state.context.messages,
+        prior_consultations: {
+            count: state.history.priorConsultations,
+            modes: state.history.priorModes,
+            repeated_question: state.history.repeatedQuestion,
+        },
+        coverage: {
+            messages_dropped: state.coverage.droppedMessages,
+            messages_included: state.coverage.includedMessages,
+            total_messages: state.coverage.totalMessages,
+            latest_user_included: state.context.latestUserIncluded,
+            benchmarks_omitted: state.coverage.benchmarksOmitted,
+        },
+    };
+}
+// Fits the payload into the byte budget by dropping the oldest messages
+// first and reporting the coverage loss so the gate can treat omission as
+// uncertainty. The latest user request is state.user and is never dropped.
+function fitStatePayload(state, maxBytes) {
+    const payload = buildStatePayload(state);
+    if (byteLength(payload) <= maxBytes)
+        return { payload, truncated: false };
+    const messages = [...state.context.messages];
+    let dropped = 0;
+    while (messages.length > 0) {
+        messages.shift();
+        dropped++;
+        const candidate = {
+            ...payload,
+            recent_messages: messages,
+            coverage: {
+                ...payload.coverage,
+                messages_dropped_extra: dropped,
+            },
+        };
+        if (byteLength(candidate) <= maxBytes) {
+            return { payload: candidate, truncated: true };
+        }
+    }
+    const minimal = {
+        ...payload,
+        recent_messages: [],
+        coverage: {
+            ...payload.coverage,
+            messages_dropped_extra: dropped,
+        },
+    };
+    if (byteLength(minimal) > maxBytes)
+        return null;
+    return { payload: minimal, truncated: true };
+}
+function effortCriteria(efforts) {
+    const criteria = {};
+    for (const effort of efforts) {
+        criteria[effort] = EFFORT_CRITERIA[effort] ?? DEFAULT_EFFORT_CRITERION;
+    }
+    return criteria;
+}
+function isNeededAnswer(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        typeof value.noul === "number" &&
+        Number.isFinite(value.noul));
+}
+function isEffortAnswer(value, efforts) {
+    if (!value || typeof value !== "object")
+        return false;
+    const answer = value;
+    return (typeof answer.choice === "string" &&
+        efforts.includes(answer.choice) &&
+        typeof answer.confidence === "number" &&
+        Number.isFinite(answer.confidence));
+}
+function metricsFrom(result, started, truncated, stateBytes) {
+    const usage = result.usage;
+    return {
+        model: typeof result.model === "string" ? result.model : null,
+        neededProbability: null,
+        suggestedEffort: null,
+        effortConfidence: null,
+        latencyMs: Date.now() - started,
+        stateBytes,
+        truncated,
+        inputTokens: typeof usage?.input_tokens === "number" ? usage.input_tokens : null,
+        outputTokens: typeof usage?.output_tokens === "number" ? usage.output_tokens : null,
+    };
+}
+function selectDecision(input, settings, neededProbability, effortAnswer) {
+    if (neededProbability < settings.skipBelow) {
+        return {
+            skip: true,
+            effectiveEffort: null,
+            suggestedEffort: effortAnswer?.choice ?? null,
+            effortConfidence: effortAnswer?.confidence ?? null,
+            source: "config",
+        };
+    }
+    if (input.explicitEffort) {
+        return {
+            skip: false,
+            effectiveEffort: input.explicitEffort,
+            suggestedEffort: effortAnswer?.choice ?? null,
+            effortConfidence: effortAnswer?.confidence ?? null,
+            source: "caller",
+        };
+    }
+    if (effortAnswer && effortAnswer.confidence >= settings.minEffortConfidence) {
+        return {
+            skip: false,
+            effectiveEffort: effortAnswer.choice,
+            suggestedEffort: effortAnswer.choice,
+            effortConfidence: effortAnswer.confidence,
+            source: "typesafe",
+        };
+    }
+    return {
+        skip: false,
+        effectiveEffort: input.defaultEffort,
+        suggestedEffort: effortAnswer?.choice ?? null,
+        effortConfidence: effortAnswer?.confidence ?? null,
+        source: "config",
+    };
+}
+export async function runTypeSafeGate(options) {
+    const { state, input, settings, signal } = options;
+    if (!options.keyPresent)
+        return { status: "disabled" };
+    const started = Date.now();
+    const availableEffortLevels = input.explicitEffort === null ? input.supportedEfforts : [];
+    const maxStateBytes = Math.max(MIN_STATE_BYTES, Math.min(settings.maxStateBytes, TYPESAFE_STATE_TOKEN_BUDGET * BYTES_PER_TOKEN));
+    const fitted = fitStatePayload(state, maxStateBytes);
+    if (!fitted) {
+        return {
+            status: "fallback",
+            reason: "state_unavailable",
+            metrics: {
+                model: null,
+                neededProbability: null,
+                suggestedEffort: null,
+                effortConfidence: null,
+                latencyMs: Date.now() - started,
+                stateBytes: 0,
+                truncated: true,
+                inputTokens: null,
+                outputTokens: null,
+            },
+        };
+    }
+    const questions = {
+        [GATE_NEEDED_QUESTION]: noul(NEEDED_INSTRUCTIONS, NEEDED_CRITERIA),
+    };
+    if (availableEffortLevels.length > 0) {
+        questions[GATE_EFFORT_QUESTION] = choice(EFFORT_INSTRUCTIONS, effortCriteria(availableEffortLevels));
+    }
+    const controller = new AbortController();
+    let callerAborted = false;
+    const onCallerAbort = () => {
+        callerAborted = true;
+        controller.abort();
+    };
+    if (signal?.aborted) {
+        callerAborted = true;
+    }
+    else {
+        signal?.addEventListener("abort", onCallerAbort, { once: true });
+    }
+    const timer = setTimeout(() => controller.abort(), settings.timeoutMs);
+    const stateBytes = byteLength(fitted.payload);
+    const emptyMetrics = () => ({
+        model: null,
+        neededProbability: null,
+        suggestedEffort: null,
+        effortConfidence: null,
+        latencyMs: Date.now() - started,
+        stateBytes,
+        truncated: fitted.truncated,
+        inputTokens: null,
+        outputTokens: null,
+    });
+    try {
+        if (callerAborted) {
+            return { status: "fallback", reason: "aborted", metrics: emptyMetrics() };
+        }
+        let client;
+        try {
+            client =
+                options.client ??
+                    (options.createClient
+                        ? options.createClient()
+                        : createSdkClient({
+                            ...(options.env?.TYPESAFE_API_KEY
+                                ? { apiKey: options.env.TYPESAFE_API_KEY }
+                                : {}),
+                            ...(options.env?.TYPESAFE_BASE_URL
+                                ? { baseURL: options.env.TYPESAFE_BASE_URL }
+                                : {}),
+                            ...(options.fetchImpl ? { fetch: options.fetchImpl } : {}),
+                        }));
+        }
+        catch {
+            return { status: "fallback", reason: "error", metrics: emptyMetrics() };
+        }
+        const outcome = await client.systemOne({
+            state: fitted.payload,
+            questions,
+            ...(settings.model ? { model: settings.model } : {}),
+            signal: controller.signal,
+            timeoutMs: settings.timeoutMs,
+        });
+        if (callerAborted) {
+            return { status: "fallback", reason: "aborted", metrics: emptyMetrics() };
+        }
+        if (outcome.kind !== "response") {
+            return {
+                status: "fallback",
+                reason: outcome.kind === "timeout" ? "timeout" : "error",
+                ...(outcome.kind === "error" ? { errorType: outcome.type } : {}),
+                metrics: emptyMetrics(),
+            };
+        }
+        const result = outcome.result;
+        const answers = result.answers;
+        const needed = answers?.[GATE_NEEDED_QUESTION];
+        if (!isNeededAnswer(needed)) {
+            return {
+                status: "fallback",
+                reason: "malformed_answer",
+                metrics: {
+                    ...metricsFrom(result, started, fitted.truncated, stateBytes),
+                },
+            };
+        }
+        const neededProbability = Math.min(1, Math.max(0, needed.noul));
+        const rawEffort = answers?.[GATE_EFFORT_QUESTION];
+        const effortAnswer = isEffortAnswer(rawEffort, availableEffortLevels)
+            ? rawEffort
+            : null;
+        const decision = selectDecision(input, settings, neededProbability, effortAnswer);
+        const metrics = {
+            ...metricsFrom(result, started, fitted.truncated, stateBytes),
+            neededProbability,
+            suggestedEffort: decision.suggestedEffort,
+            effortConfidence: decision.effortConfidence,
+        };
+        if (decision.skip) {
+            return {
+                status: "skip",
+                reason: "consultation_not_useful",
+                metrics,
+            };
+        }
+        return {
+            status: "proceed",
+            reason: proceedReason(input, availableEffortLevels, decision.source),
+            neededProbability,
+            suggestedEffort: decision.suggestedEffort,
+            effortConfidence: decision.effortConfidence,
+            effectiveEffort: decision.effectiveEffort,
+            effortSource: decision.source,
+            metrics,
+        };
+    }
+    finally {
+        clearTimeout(timer);
+        signal?.removeEventListener("abort", onCallerAbort);
+    }
+}
+//# sourceMappingURL=typesafeGate.js.map

package/dist/typesafeGate.js.map

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

package/dist/typesafeState.d.ts

@@ -0,0 +1,94 @@
+import { Database } from "bun:sqlite";
+import type { EvidenceBenchmarks, EvidenceModels } from "./benchmarkEvidence.js";
+export interface TypeSafeSettings {
+    model?: string;
+    timeoutMs: number;
+    skipBelow: number;
+    minEffortConfidence: number;
+    maxStateBytes: number;
+    efforts: string[];
+}
+export type TypeSafeOptions = boolean | {
+    model?: string;
+    timeoutMs?: number;
+    skipBelow?: number;
+    minEffortConfidence?: number;
+    maxStateBytes?: number;
+    efforts?: string[];
+} | null;
+export interface TypeSafeConfig {
+    enabled: boolean;
+    settings: TypeSafeSettings | null;
+    keyPresent: boolean;
+}
+export declare const TYPESAFE_DEFAULTS: TypeSafeSettings;
+export type NormalizedTypeSafeOptions = {
+    disabled: true;
+} | {
+    disabled: false;
+    overrides: Partial<TypeSafeSettings>;
+};
+export type TypeSafeValidationError = {
+    error: string;
+};
+export declare function normalizeTypeSafeOptions(value: unknown): NormalizedTypeSafeOptions | TypeSafeValidationError;
+export declare function resolveTypeSafeSettings(source: NormalizedTypeSafeOptions): TypeSafeSettings;
+export declare function resolveTypeSafeConfig(source: NormalizedTypeSafeOptions | undefined, env?: Record<string, string | undefined>): TypeSafeConfig;
+export declare const TYPE_SAFE_ENV_KEY = "TYPESAFE_API_KEY";
+export interface DecisionState {
+    request: {
+        question: string | null;
+        mode: string;
+        trigger: string;
+        explicitEffort: string | null;
+        caller: string | null;
+        directory: string | null;
+    };
+    user: {
+        latestRequest: string | null;
+    };
+    context: {
+        messages: string[];
+        latestUserIncluded: boolean;
+    };
+    history: {
+        priorConsultations: number;
+        priorModes: string[];
+        repeatedQuestion: boolean;
+    };
+    availability: {
+        supportedEfforts: string[];
+        defaultEffort: string | null;
+    };
+    models: EvidenceModels | null;
+    benchmarks: EvidenceBenchmarks | null;
+    coverage: {
+        truncated: boolean;
+        droppedMessages: number;
+        includedMessages: number;
+        totalMessages: number;
+        stateBytes: number;
+        maxStateBytes: number;
+        benchmarksOmitted: boolean;
+    };
+}
+export interface BuildDecisionStateOptions {
+    question?: string | null;
+    mode: string;
+    trigger: string;
+    explicitEffort?: string | null;
+    caller?: string | null;
+    directory?: string | null;
+    priorConsultations: number;
+    priorModes: string[];
+    priorQuestions?: string[];
+    supportedEfforts: string[];
+    defaultEffort?: string | null;
+    maxStateBytes?: number;
+    models?: EvidenceModels | null;
+    benchmarks?: EvidenceBenchmarks | null;
+    formatMessage?: (type: string, data: Record<string, any>) => string | null;
+}
+export declare function makeDecisionState(options: BuildDecisionStateOptions): DecisionState;
+export declare function buildDecisionState(db: InstanceType<typeof Database>, sessionId: string, options: BuildDecisionStateOptions): DecisionState;
+//# sourceMappingURL=typesafeState.d.ts.map

package/dist/typesafeState.d.ts.map

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