@garygentry/system1-core 0.1.0

package/dist/index.js

@@ -0,0 +1,33 @@
+export { assertConsent, setConsent } from "./config/consent.js";
+export { allProfiles, DEFAULTS, findRepoRoot, loadConfig, repoConfigPath, userConfigDir, } from "./config/load.js";
+export { detectHarness, detectSession } from "./config/session.js";
+export { createDecider } from "./decide.js";
+export { applyExcludes, DEFAULT_EXCLUDES, isExcluded } from "./egress/exclude.js";
+export { scrubQuestions, scrubState, scrubText } from "./egress/scrub.js";
+export { assertStateFits, CHARS_PER_TOKEN, estimateTokens } from "./egress/size.js";
+export { DecisionsError, isDecisionsError, ProviderError } from "./errors.js";
+export { canonicalJson, FIXTURE_VERSION, FixtureStore, fixtureKey } from "./fixtures/store.js";
+export { confidenceOf, DEFAULT_UNDECIDED_FLOOR, isChoice, isNoul, isScore, isUndecided, noulConfidence, rankedProbabilities, undecidedNames, } from "./model/answers.js";
+export { DEFAULT_MODEL_ID, PROFILES, projectCost, resolveProfile } from "./model/profiles.js";
+export { assertQuestionSet, parseDecisionResponse } from "./model/validate.js";
+export { ping, probeUrl } from "./ping.js";
+export { prepare } from "./prepare.js";
+export { matches, parseFilter, parseSort, project as projectRows } from "./project/project.js";
+export { checkBudget, project } from "./run/budget.js";
+export { mapWithConcurrency } from "./run/pool.js";
+export { SpendLedger, sumUsage } from "./run/spend.js";
+export { gitIgnored, parseFileRef, readSources, splitDiffByFile } from "./sources/read.js";
+export { describeExpectation, meets, parseExpect } from "./spec/expect.js";
+export { assertExamples, exampleProblems, listSpecs, loadSpec, parseQuestionSet, parseSpec, SpecSchema, specDirs, } from "./spec/spec.js";
+export { parseSplit, split } from "./split/split.js";
+export { runAsk } from "./tools/ask.js";
+export { createContext, deciderFor } from "./tools/context.js";
+export { CODEX_RULE, runDoctor, which } from "./tools/doctor.js";
+export { runMany, summariseSkipped } from "./tools/many.js";
+export { AskInput, ManyInput, SpecCheckInput, TOOL_SCHEMAS, UsageInput } from "./tools/schemas.js";
+export { runSpecCheck } from "./tools/spec-check.js";
+export { runUsage } from "./tools/usage.js";
+export { createOpenRouterTransport, DEFAULT_TIMEOUT_MS, RETRY_STATUSES, } from "./transport/openrouter.js";
+export { CLI_PACKAGE, VERSION } from "./version.js";
+export { createDeciderFromEnv, DEFAULT_ENDPOINT, DEFAULT_MODEL, resolveConnection, stateDir, } from "./wiring.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/model/answers.d.ts

@@ -0,0 +1,38 @@
+import type { Answer, Answers, ChoiceAnswer, NoulAnswer, ScoreAnswer } from "./types.js";
+/**
+ * The default confidence at or below which a choice or score answer means
+ * nothing. Profiles carry their own floor; this is Jev's.
+ *
+ * **Calibrated against live output, and wrong at first.** It started at 0.05,
+ * tuned on hand-written fixtures. Live Jev returned 0.09 for a three-level score
+ * spread 0.38 / 0.40 / 0.22, which is about as undecided as an answer gets, and
+ * it cleared a 0.05 floor. Thresholds tuned on invented data don't transfer.
+ *
+ * Not the same as a weakly held answer: 0.34 on a genuine two-way contest (0.51
+ * against 0.49) is a decided answer held weakly. Per-branch gates in policy code
+ * handle that.
+ */
+export declare const DEFAULT_UNDECIDED_FLOOR = 0.15;
+/** A flat distribution: never act on the top option. */
+export declare function isUndecided(answer: ChoiceAnswer | ScoreAnswer, floor?: number): boolean;
+/**
+ * A noul's distance from a coin flip, mapped onto 0–1 so it reads beside choice
+ * and score confidences. Derived here; the model returns no noul confidence.
+ */
+export declare function noulConfidence(answer: NoulAnswer): number;
+/** Confidence of any answer on one 0–1 scale. */
+export declare function confidenceOf(answer: Answer): number;
+/**
+ * Names of the answers that are undecided. A noul is undecided when it sits
+ * within `floor / 2` of 0.5, which keeps the same 0–1 confidence scale.
+ */
+export declare function undecidedNames(answers: Answers, floor?: number): string[];
+/** Distribution entries, highest probability first. */
+export declare function rankedProbabilities(probabilities: Record<string, number>): Array<{
+    key: string;
+    probability: number;
+}>;
+export declare const isChoice: (answer: Answer) => answer is ChoiceAnswer;
+export declare const isScore: (answer: Answer) => answer is ScoreAnswer;
+export declare const isNoul: (answer: Answer) => answer is NoulAnswer;
+//# sourceMappingURL=answers.d.ts.map

package/dist/model/answers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answers.d.ts","sourceRoot":"","sources":["../../src/model/answers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAA;AAE3C,wDAAwD;AACxD,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,GAAG,WAAW,EAClC,KAAK,SAA0B,GAC9B,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAEzD;AAED,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,SAA0B,GAAG,MAAM,EAAE,CAI1F;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAI7C;AAED,eAAO,MAAM,QAAQ,WAAY,MAAM,KAAG,MAAM,IAAI,YAAwC,CAAA;AAC5F,eAAO,MAAM,OAAO,WAAY,MAAM,KAAG,MAAM,IAAI,WAAsC,CAAA;AACzF,eAAO,MAAM,MAAM,WAAY,MAAM,KAAG,MAAM,IAAI,UAAoC,CAAA"}

package/dist/model/answers.js

@@ -0,0 +1,48 @@
+/**
+ * The default confidence at or below which a choice or score answer means
+ * nothing. Profiles carry their own floor; this is Jev's.
+ *
+ * **Calibrated against live output, and wrong at first.** It started at 0.05,
+ * tuned on hand-written fixtures. Live Jev returned 0.09 for a three-level score
+ * spread 0.38 / 0.40 / 0.22, which is about as undecided as an answer gets, and
+ * it cleared a 0.05 floor. Thresholds tuned on invented data don't transfer.
+ *
+ * Not the same as a weakly held answer: 0.34 on a genuine two-way contest (0.51
+ * against 0.49) is a decided answer held weakly. Per-branch gates in policy code
+ * handle that.
+ */
+export const DEFAULT_UNDECIDED_FLOOR = 0.15;
+/** A flat distribution: never act on the top option. */
+export function isUndecided(answer, floor = DEFAULT_UNDECIDED_FLOOR) {
+    return answer.confidence <= floor;
+}
+/**
+ * A noul's distance from a coin flip, mapped onto 0–1 so it reads beside choice
+ * and score confidences. Derived here; the model returns no noul confidence.
+ */
+export function noulConfidence(answer) {
+    return Math.abs(answer.noul - 0.5) * 2;
+}
+/** Confidence of any answer on one 0–1 scale. */
+export function confidenceOf(answer) {
+    return answer.type === "noul" ? noulConfidence(answer) : answer.confidence;
+}
+/**
+ * Names of the answers that are undecided. A noul is undecided when it sits
+ * within `floor / 2` of 0.5, which keeps the same 0–1 confidence scale.
+ */
+export function undecidedNames(answers, floor = DEFAULT_UNDECIDED_FLOOR) {
+    return Object.entries(answers)
+        .filter(([, answer]) => confidenceOf(answer) <= floor)
+        .map(([name]) => name);
+}
+/** Distribution entries, highest probability first. */
+export function rankedProbabilities(probabilities) {
+    return Object.entries(probabilities)
+        .map(([key, probability]) => ({ key, probability }))
+        .sort((a, b) => b.probability - a.probability);
+}
+export const isChoice = (answer) => answer.type === "choice";
+export const isScore = (answer) => answer.type === "score";
+export const isNoul = (answer) => answer.type === "noul";
+//# sourceMappingURL=answers.js.map

package/dist/model/answers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answers.js","sourceRoot":"","sources":["../../src/model/answers.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAA;AAE3C,wDAAwD;AACxD,MAAM,UAAU,WAAW,CACzB,MAAkC,EAClC,KAAK,GAAG,uBAAuB;IAE/B,OAAO,MAAM,CAAC,UAAU,IAAI,KAAK,CAAA;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;AACxC,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAA;AAC5E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,KAAK,GAAG,uBAAuB;IAC9E,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;SAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;SACrD,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,mBAAmB,CACjC,aAAqC;IAErC,OAAO,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;SACnD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAA;AAClD,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAAc,EAA0B,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAA;AAC5F,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAc,EAAyB,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAA;AACzF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAc,EAAwB,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAA"}

package/dist/model/profiles.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Everything the engine needs to know about one decision model, as data.
+ *
+ * A new model that shares the wire contract is a new entry here, not new code
+ * (decision 0003). `transport` names how it is reached; only
+ * `openrouter-decisions` exists so far.
+ */
+export interface ModelProfile {
+    /** The id sent on the wire. */
+    id: string;
+    displayName: string;
+    transport: "openrouter-decisions";
+    /** Hard cap on one state. Oversized states are refused, never truncated. */
+    maxStateTokens: number;
+    /** Most options one choice question may have (the provider refuses more). */
+    maxChoices: number;
+    /** Listed price, USD per input token. Used only for *projected* costs. */
+    usdPerInputToken: number;
+    usdPerOutputToken: number;
+    /** When the price above was read. Prices go stale; measured cost never does. */
+    priceAsOf: string;
+    /** Confidence at or below which an answer is treated as undecided. */
+    undecidedFloor: number;
+    /** Whether the probabilities are calibrated (an emulated model's are not). */
+    calibrated: boolean;
+}
+export declare const PROFILES: readonly ModelProfile[];
+export declare const DEFAULT_MODEL_ID = "typesafe/jev-1.13";
+/**
+ * Find the profile for a model id. A dated build (`typesafe/jev-1.13-20260917`)
+ * resolves to its family profile but keeps the requested id, so it is what goes
+ * on the wire.
+ *
+ * @throws DecisionsError `unknown-model` when nothing matches.
+ */
+export declare function resolveProfile(id: string, profiles?: readonly ModelProfile[]): ModelProfile;
+/** Projected cost of `calls` decisions of about `tokensPerCall` input tokens. Never a measurement. */
+export declare function projectCost(profile: ModelProfile, calls: number, tokensPerCall: number): number;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/model/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/model/profiles.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,sBAAsB,CAAA;IACjC,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAA;IACtB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAA;IAClB,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAA;IACjB,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAA;IACtB,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,eAAO,MAAM,QAAQ,EAAE,SAAS,YAAY,EAc3C,CAAA;AAED,eAAO,MAAM,gBAAgB,sBAAsB,CAAA;AAEnD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,QAAQ,GAAE,SAAS,YAAY,EAAa,GAC3C,YAAY,CAUd;AAED,sGAAsG;AACtG,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAE/F"}

package/dist/model/profiles.js

@@ -0,0 +1,42 @@
+import { DecisionsError } from "../errors.js";
+import { DEFAULT_UNDECIDED_FLOOR } from "./answers.js";
+export const PROFILES = [
+    {
+        id: "typesafe/jev-1.13",
+        displayName: "TypeSafe Jev 1.13",
+        transport: "openrouter-decisions",
+        maxStateTokens: 32_000,
+        // Measured 2026-09-22: 400 options is refused upstream with "at most 255 choices".
+        maxChoices: 255,
+        usdPerInputToken: 0.042 / 1_000_000,
+        usdPerOutputToken: 0,
+        priceAsOf: "2026-09-19",
+        undecidedFloor: DEFAULT_UNDECIDED_FLOOR,
+        calibrated: true,
+    },
+];
+export const DEFAULT_MODEL_ID = "typesafe/jev-1.13";
+/**
+ * Find the profile for a model id. A dated build (`typesafe/jev-1.13-20260917`)
+ * resolves to its family profile but keeps the requested id, so it is what goes
+ * on the wire.
+ *
+ * @throws DecisionsError `unknown-model` when nothing matches.
+ */
+export function resolveProfile(id, profiles = PROFILES) {
+    const exact = profiles.find((p) => p.id === id);
+    if (exact)
+        return exact;
+    const family = profiles.find((p) => new RegExp(`^${escapeRegExp(p.id)}-\\d{8}$`).test(id));
+    if (family)
+        return { ...family, id };
+    throw new DecisionsError("unknown-model", `No profile for model "${id}". Known: ${profiles.map((p) => p.id).join(", ")}.`, { model: id, known: profiles.map((p) => p.id) });
+}
+/** Projected cost of `calls` decisions of about `tokensPerCall` input tokens. Never a measurement. */
+export function projectCost(profile, calls, tokensPerCall) {
+    return calls * tokensPerCall * profile.usdPerInputToken;
+}
+function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=profiles.js.map

package/dist/model/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/model/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AA6BtD,MAAM,CAAC,MAAM,QAAQ,GAA4B;IAC/C;QACE,EAAE,EAAE,mBAAmB;QACvB,WAAW,EAAE,mBAAmB;QAChC,SAAS,EAAE,sBAAsB;QACjC,cAAc,EAAE,MAAM;QACtB,mFAAmF;QACnF,UAAU,EAAE,GAAG;QACf,gBAAgB,EAAE,KAAK,GAAG,SAAS;QACnC,iBAAiB,EAAE,CAAC;QACpB,SAAS,EAAE,YAAY;QACvB,cAAc,EAAE,uBAAuB;QACvC,UAAU,EAAE,IAAI;KACjB;CACF,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAA;AAEnD;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,EAAU,EACV,QAAQ,GAA4B,QAAQ;IAE5C,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;IAC/C,IAAI,KAAK;QAAE,OAAO,KAAK,CAAA;IACvB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;IAC1F,IAAI,MAAM;QAAE,OAAO,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,CAAA;IACpC,MAAM,IAAI,cAAc,CACtB,eAAe,EACf,yBAAyB,EAAE,aAAa,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAC/E,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAChD,CAAA;AACH,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,WAAW,CAAC,OAAqB,EAAE,KAAa,EAAE,aAAqB;IACrF,OAAO,KAAK,GAAG,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAA;AACzD,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;AACpD,CAAC"}

package/dist/model/types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * The decision-model wire contract, verified against OpenRouter's decisions
+ * endpoint:
+ *
+ *     POST https://openrouter.ai/api/alpha/decisions
+ *     {"model": "typesafe/jev-1.13", "state": ..., "questions": {...}}
+ *
+ * A decision model does not generate text. You send one `state` and a map of
+ * named `questions`, and every question is answered against that same state,
+ * in one request, with typed, calibrated answers. `/chat/completions` rejects
+ * these models outright; they are served on their own path.
+ *
+ * The names are model-neutral on purpose: Jev is the first model with this
+ * calling convention, not the only one (decision 0003).
+ */
+/** Anything JSON-shaped. A bare string or a structured object both work. */
+export type State = string | Record<string, unknown> | unknown[];
+/**
+ * One of a fixed set of options. `criteria` maps each option key to when it
+ * applies. Always include a no-match option: the model cannot choose a value
+ * you never offered, so without one it is forced to pick among wrong answers.
+ */
+export interface ChoiceQuestion {
+    type: "choice";
+    instructions: string;
+    criteria: Record<string, string>;
+}
+/**
+ * A position along a dimension you define. `criteria` is an ordered list of
+ * levels, and **levels are 0-indexed**: three criteria are levels 0, 1 and 2, so
+ * a score of 1.5 sits between the middle and top level. Describe each level as
+ * a concrete situation ("a workaround exists"), not a degree ("medium").
+ */
+export interface ScoreQuestion {
+    type: "score";
+    instructions: string;
+    criteria: string[];
+}
+/**
+ * Whether a proposition holds, as a probability. Optional `true`/`false`
+ * criteria sharpen the boundary when the proposition is at all ambiguous.
+ */
+export interface NoulQuestion {
+    type: "noul";
+    instructions: string;
+    criteria?: {
+        true: string;
+        false: string;
+    };
+}
+export type Question = ChoiceQuestion | ScoreQuestion | NoulQuestion;
+export type QuestionType = Question["type"];
+/** Named questions, all answered against one state in one request. */
+export type QuestionSet = Record<string, Question>;
+export interface ChoiceAnswer {
+    type: "choice";
+    /** The winning option key. */
+    choice: string;
+    /** Distribution over every option key, summing to about 1. */
+    probabilities: Record<string, number>;
+    /** How concentrated the distribution is. See `isUndecided`. */
+    confidence: number;
+}
+export interface ScoreAnswer {
+    type: "score";
+    /** Probability-weighted mean level. Can land between levels. */
+    score: number;
+    /** Distribution over levels. Keys are strings ("0", "1", ...), not numbers. */
+    probabilities: Record<string, number>;
+    /** Level index to its criterion text, string-keyed for the same reason. */
+    legend?: Record<string, string>;
+    confidence: number;
+}
+export interface NoulAnswer {
+    type: "noul";
+    /** Probability the proposition holds, 0–1. 0.5 means "cannot tell". */
+    noul: number;
+}
+export type Answer = ChoiceAnswer | ScoreAnswer | NoulAnswer;
+export type Answers = Record<string, Answer>;
+export interface Usage {
+    input_tokens: number;
+    output_tokens: number;
+    /** Upstream-reported cost in USD. Output tokens are free on Jev. */
+    cost: number;
+    /**
+     * False when the provider reported no usage (or an unreadable one), so the
+     * zeroes above are "unknown", not "free". Absent means reported.
+     */
+    reported?: boolean;
+}
+/** What the decisions endpoint returns, after validation. */
+export interface DecisionResponse {
+    /** The model build that actually served the call, e.g. `typesafe/jev-1.13-20260917`. */
+    model: string;
+    answers: Answers;
+    usage: Usage;
+    /** Upstream generation id, when present. */
+    id?: string;
+    provider?: string;
+}
+export interface DecisionRequest {
+    model: string;
+    state: State;
+    questions: QuestionSet;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/model/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/model/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,4EAA4E;AAC5E,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAAA;AAMhE;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAC3C;AAED,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,aAAa,GAAG,YAAY,CAAA;AACpE,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;AAE3C,sEAAsE;AACtE,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;AAMlD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAA;IACd,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAA;IACb,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAA;IACb,+EAA+E;IAC/E,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,MAAM,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,CAAA;AAC5D,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAE5C,MAAM,WAAW,KAAK;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,wFAAwF;IACxF,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,CAAA;IACZ,4CAA4C;IAC5C,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,KAAK,CAAA;IACZ,SAAS,EAAE,WAAW,CAAA;CACvB"}

package/dist/model/types.js

@@ -0,0 +1,17 @@
+/**
+ * The decision-model wire contract, verified against OpenRouter's decisions
+ * endpoint:
+ *
+ *     POST https://openrouter.ai/api/alpha/decisions
+ *     {"model": "typesafe/jev-1.13", "state": ..., "questions": {...}}
+ *
+ * A decision model does not generate text. You send one `state` and a map of
+ * named `questions`, and every question is answered against that same state,
+ * in one request, with typed, calibrated answers. `/chat/completions` rejects
+ * these models outright; they are served on their own path.
+ *
+ * The names are model-neutral on purpose: Jev is the first model with this
+ * calling convention, not the only one (decision 0003).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/model/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/model/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/model/validate.d.ts

@@ -0,0 +1,17 @@
+import type { DecisionResponse, QuestionSet } from "./types.js";
+/**
+ * Reject a malformed question set before it costs a call.
+ *
+ * @throws DecisionsError `invalid-request`, listing every problem found.
+ */
+export declare function assertQuestionSet(questions: unknown): asserts questions is QuestionSet;
+/**
+ * Validate a decisions-endpoint body against the request it answers.
+ *
+ * Stricter than "has answers": every question asked must come back, as the
+ * type it was asked as, with correctly typed fields. A 2xx that fails this is
+ * still a provider failure, so it surfaces as `malformed-response` and never as
+ * a partial result.
+ */
+export declare function parseDecisionResponse(raw: unknown, questions: QuestionSet, requestedModel: string): DecisionResponse;
+//# sourceMappingURL=validate.d.ts.map

package/dist/model/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/model/validate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,gBAAgB,EAAE,WAAW,EAAS,MAAM,YAAY,CAAA;AAEvF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,IAAI,WAAW,CAwDtF;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,WAAW,EACtB,cAAc,EAAE,MAAM,GACrB,gBAAgB,CA2BlB"}

package/dist/model/validate.js

@@ -0,0 +1,151 @@
+import { DecisionsError, ProviderError } from "../errors.js";
+/**
+ * Reject a malformed question set before it costs a call.
+ *
+ * @throws DecisionsError `invalid-request`, listing every problem found.
+ */
+export function assertQuestionSet(questions) {
+    const problems = [];
+    if (!isObject(questions) || Object.keys(questions).length === 0) {
+        throw new DecisionsError("invalid-request", "questions must be a non-empty object of named questions");
+    }
+    for (const [name, q] of Object.entries(questions)) {
+        if (!isObject(q)) {
+            problems.push(`${name}: must be an object`);
+            continue;
+        }
+        if (typeof q.instructions !== "string" || q.instructions.trim() === "") {
+            problems.push(`${name}: instructions must be a non-empty string`);
+        }
+        switch (q.type) {
+            case "choice":
+                if (!isObject(q.criteria) || Object.keys(q.criteria).length < 2) {
+                    problems.push(`${name}: choice criteria must map at least two option keys to descriptions`);
+                }
+                else if (!Object.values(q.criteria).every((v) => typeof v === "string")) {
+                    problems.push(`${name}: choice criteria values must be strings`);
+                }
+                break;
+            case "score":
+                if (!Array.isArray(q.criteria) ||
+                    q.criteria.length < 2 ||
+                    !q.criteria.every((c) => typeof c === "string")) {
+                    problems.push(`${name}: score criteria must be a list of at least two level descriptions`);
+                }
+                break;
+            case "noul":
+                if (q.criteria !== undefined &&
+                    (!isObject(q.criteria) ||
+                        typeof q.criteria.true !== "string" ||
+                        typeof q.criteria.false !== "string")) {
+                    problems.push(`${name}: noul criteria, when given, must be {true: string, false: string}`);
+                }
+                break;
+            default:
+                problems.push(`${name}: type must be choice, score or noul (got ${JSON.stringify(q.type)})`);
+        }
+    }
+    if (problems.length > 0) {
+        throw new DecisionsError("invalid-request", `Invalid question set:\n  ${problems.join("\n  ")}`, { problems });
+    }
+}
+/**
+ * Validate a decisions-endpoint body against the request it answers.
+ *
+ * Stricter than "has answers": every question asked must come back, as the
+ * type it was asked as, with correctly typed fields. A 2xx that fails this is
+ * still a provider failure, so it surfaces as `malformed-response` and never as
+ * a partial result.
+ */
+export function parseDecisionResponse(raw, questions, requestedModel) {
+    if (!isObject(raw))
+        throw malformed("body is not a JSON object", raw);
+    if (!isObject(raw.answers))
+        throw malformed("body has no answers object", raw);
+    const answers = {};
+    for (const [name, question] of Object.entries(questions)) {
+        const answer = raw.answers[name];
+        if (answer === undefined)
+            throw malformed(`question "${name}" was not answered`, raw);
+        if (!isObject(answer) || answer.type !== question.type) {
+            throw malformed(`answer "${name}" should be type ${question.type}, got ${JSON.stringify(isObject(answer) ? answer.type : answer)}`, raw);
+        }
+        answers[name] = checkAnswer(name, answer, raw);
+    }
+    const usage = raw.usage;
+    return {
+        model: typeof raw.model === "string" ? raw.model : requestedModel,
+        answers,
+        usage: isObject(usage)
+            ? checkUsage(usage)
+            : { input_tokens: 0, output_tokens: 0, cost: 0, reported: false },
+        ...(typeof raw.id === "string" ? { id: raw.id } : {}),
+        ...(typeof raw.provider === "string" ? { provider: raw.provider } : {}),
+    };
+}
+function checkAnswer(name, a, raw) {
+    const bad = (field) => malformed(`answer "${name}" has an invalid ${field}`, raw);
+    switch (a.type) {
+        case "choice":
+            if (typeof a.choice !== "string")
+                throw bad("choice");
+            if (!isDistribution(a.probabilities))
+                throw bad("probabilities");
+            if (!isUnit(a.confidence))
+                throw bad("confidence");
+            return {
+                type: "choice",
+                choice: a.choice,
+                probabilities: a.probabilities,
+                confidence: a.confidence,
+            };
+        case "score":
+            if (typeof a.score !== "number" || !Number.isFinite(a.score))
+                throw bad("score");
+            if (!isDistribution(a.probabilities))
+                throw bad("probabilities");
+            if (!isUnit(a.confidence))
+                throw bad("confidence");
+            return {
+                type: "score",
+                score: a.score,
+                probabilities: a.probabilities,
+                confidence: a.confidence,
+                ...(isObject(a.legend) ? { legend: a.legend } : {}),
+            };
+        case "noul":
+            if (!isUnit(a.noul))
+                throw bad("noul");
+            return { type: "noul", noul: a.noul };
+        default:
+            throw bad("type");
+    }
+}
+function checkUsage(u) {
+    // A missing or unreadable cost is unknown, not zero: an upstream change
+    // would otherwise look like free service.
+    const reported = [u.input_tokens, u.output_tokens, u.cost].every((v) => typeof v === "number" && Number.isFinite(v));
+    return {
+        input_tokens: finiteOrZero(u.input_tokens),
+        output_tokens: finiteOrZero(u.output_tokens),
+        cost: finiteOrZero(u.cost),
+        ...(reported ? {} : { reported: false }),
+    };
+}
+function malformed(reason, raw) {
+    const preview = JSON.stringify(raw)?.slice(0, 300) ?? String(raw);
+    return new ProviderError("malformed-response", `Malformed decision response: ${reason}. Body: ${preview}`);
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isUnit(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 && value <= 1;
+}
+function isDistribution(value) {
+    return isObject(value) && Object.keys(value).length > 0 && Object.values(value).every(isUnit);
+}
+function finiteOrZero(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+//# sourceMappingURL=validate.js.map

package/dist/model/validate.js.map

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

package/dist/ping.d.ts

@@ -0,0 +1,30 @@
+import type { ConnectionConfig } from "./wiring.js";
+/**
+ * A reachability check that spends nothing.
+ *
+ * It reads the model's public endpoint listing rather than calling the
+ * decisions endpoint, so it needs no key and makes no decision. That makes it
+ * safe to run from any harness, and a good probe for whether the agent's shell
+ * sandbox allows network access at all.
+ */
+export interface PingResult {
+    ok: boolean;
+    model: string;
+    endpoint: string;
+    /** The URL actually probed. */
+    probe: string;
+    keyPresent: boolean;
+    /** Measured round trip. Absent when the request never completed. */
+    latencyMs?: number;
+    httpStatus?: number;
+    /** The listing's context length for the model, when it answered. */
+    contextLength?: number;
+    error?: string;
+}
+export interface PingOptions {
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+}
+export declare function probeUrl(config: ConnectionConfig): string;
+export declare function ping(config: ConnectionConfig, options?: PingOptions): Promise<PingResult>;
+//# sourceMappingURL=ping.d.ts.map

package/dist/ping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../src/ping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,OAAO,CAAA;IACnB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAGzD;AAED,wBAAsB,IAAI,CACxB,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAoCrB"}

package/dist/ping.js

@@ -0,0 +1,50 @@
+export function probeUrl(config) {
+    const origin = new URL(config.endpoint).origin;
+    return `${origin}/api/v1/models/${config.model}/endpoints`;
+}
+export async function ping(config, options = {}) {
+    const doFetch = options.fetch ?? fetch;
+    const probe = probeUrl(config);
+    const base = {
+        model: config.model,
+        endpoint: config.endpoint,
+        probe,
+        keyPresent: config.apiKey !== undefined,
+    };
+    const started = performance.now();
+    try {
+        const response = await doFetch(probe, {
+            signal: AbortSignal.timeout(options.timeoutMs ?? 10_000),
+        });
+        const latencyMs = Math.round(performance.now() - started);
+        if (!response.ok) {
+            return {
+                ...base,
+                ok: false,
+                latencyMs,
+                httpStatus: response.status,
+                error: `HTTP ${response.status}`,
+            };
+        }
+        const body = (await response.json());
+        const contextLength = body.data?.endpoints?.[0]?.context_length;
+        return {
+            ...base,
+            ok: true,
+            latencyMs,
+            httpStatus: response.status,
+            ...(typeof contextLength === "number" ? { contextLength } : {}),
+        };
+    }
+    catch (error) {
+        return { ...base, ok: false, error: describe(error) };
+    }
+}
+function describe(error) {
+    if (error instanceof Error) {
+        const cause = error.cause;
+        return cause instanceof Error ? `${error.message}: ${cause.message}` : error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=ping.js.map

package/dist/ping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.js","sourceRoot":"","sources":["../src/ping.ts"],"names":[],"mappings":"AA8BA,MAAM,UAAU,QAAQ,CAAC,MAAwB;IAC/C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAA;IAC9C,OAAO,GAAG,MAAM,kBAAkB,MAAM,CAAC,KAAK,YAAY,CAAA;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,MAAwB,EACxB,OAAO,GAAgB,EAAE;IAEzB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAA;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC9B,MAAM,IAAI,GAAG;QACX,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK;QACL,UAAU,EAAE,MAAM,CAAC,MAAM,KAAK,SAAS;KACxC,CAAA;IACD,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;IACjC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE;YACpC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;SACzD,CAAC,CAAA;QACF,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAA;QACzD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO;gBACL,GAAG,IAAI;gBACP,EAAE,EAAE,KAAK;gBACT,SAAS;gBACT,UAAU,EAAE,QAAQ,CAAC,MAAM;gBAC3B,KAAK,EAAE,QAAQ,QAAQ,CAAC,MAAM,EAAE;aACjC,CAAA;QACH,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgB,CAAA;QACnD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,CAAA;QAC/D,OAAO;YACL,GAAG,IAAI;YACP,EAAE,EAAE,IAAI;YACR,SAAS;YACT,UAAU,EAAE,QAAQ,CAAC,MAAM;YAC3B,GAAG,CAAC,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAA;IACvD,CAAC;AACH,CAAC;AAMD,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAI,KAA6B,CAAC,KAAK,CAAA;QAClD,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAA;IACtF,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC"}