@try-works/dsh-tool-mode 0.0.0-stage → 0.5.44

package/lib/invocation-accounting.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Invocation accounting: timings, outcome class and sizes (OBS-01, OBS-05).
+ *
+ * The receipt already carries identity — contract, implementation, extension version,
+ * content digest, activation generation, caller scope. OBS-01 asks for four things it did
+ * not have:
+ *
+ *   - **queue / load / inference / total time**, separated, because a slow call has three
+ *     very different causes and a single duration cannot tell them apart;
+ *   - **a cancellation/failure CLASS**, so an operations reader can group failures rather
+ *     than reading prose;
+ *   - **sizes**, measured rather than estimated;
+ *   - and all of it **without credentials or bodies**, which is why the sizes are NUMBERS
+ *     and there is deliberately nowhere to put a payload.
+ *
+ * The last point is the design constraint rather than a disclaimer: this module has no
+ * field that can hold request or response content, so a future change cannot start logging
+ * bodies by accident. A `Record<string, unknown>` "details" bag would have undone that in
+ * one commit.
+ *
+ * OBS-05 is the other half: what is recorded is MEASURED, with the runtime that measured
+ * it, so a vendor's published figure can never be mistaken for this machine's.
+ *
+ * @module @try-works/dsh-tool-mode/invocation-accounting
+ */
+/**
+ * Why an invocation ended.
+ *
+ * Deliberately coarse and closed: a reader groups by these, and an open string would make
+ * every dashboard a list of one-off messages.
+ */
+export type FailureClass = 
+/** The call completed. */
+'none'
+/** The caller cancelled, or an imported signal aborted. */
+ | 'cancelled'
+/** Policy or the contract refused before work began. */
+ | 'refused'
+/** A deadline expired. */
+ | 'timeout'
+/** An extension or provider failed. */
+ | 'failed'
+/** Authorization denied. */
+ | 'policy-denied';
+/** Where the time went, in milliseconds. */
+export interface InvocationTimings {
+    /**
+     * Time waiting for admission — a queue, a pool, or a load already in flight.
+     *
+     * Separated from load time because "the model is already loading for someone else" and
+     * "the model is slow to load" are different problems with different fixes.
+     */
+    readonly queuedMs: number;
+    /** Time spent preparing or loading, when the invocation had to. */
+    readonly loadMs: number;
+    /** Time the implementation spent on the work itself. */
+    readonly inferenceMs: number;
+    /**
+     * Wall time from admission attempt to result.
+     *
+     * NOT asserted equal to the sum: phases can overlap, and forcing equality would make the
+     * record wrong whenever they do.
+     */
+    readonly totalMs: number;
+}
+/** Byte sizes, measured rather than estimated. */
+export interface InvocationSizes {
+    /** Serialized request size in bytes. */
+    readonly inputBytes: number;
+    /** Serialized result size in bytes. */
+    readonly outputBytes: number;
+    /** Bytes read from assets during this invocation, when any were. */
+    readonly assetBytes: number;
+}
+/** The runtime that produced the measurements (OBS-05). */
+export interface MeasurementContext {
+    /** Platform, e.g. `win32`. */
+    readonly platform: string;
+    /** Architecture, e.g. `x64`. */
+    readonly architecture: string;
+    /** Node version. */
+    readonly nodeVersion: string;
+    /** The engine or runtime version actually used. */
+    readonly engineVersion: string;
+}
+/** One invocation's accounting record. */
+export interface InvocationAccounting {
+    /** Correlation id, matching the receipt. */
+    readonly receiptId: string;
+    readonly timings: InvocationTimings;
+    readonly sizes: InvocationSizes;
+    readonly failureClass: FailureClass;
+    /** A short class-level reason, never a payload. */
+    readonly reason: string | null;
+    /**
+     * How the timings were obtained.
+     *
+     * `measured` for this process's own clock; the alternative exists so an imported figure
+     * can never be presented as one taken here.
+     */
+    readonly timingSource: 'measured' | 'reported-by-implementation';
+    /** The runtime the measurement belongs to. */
+    readonly measuredOn: MeasurementContext;
+    /**
+     * The CALLER'S grant identity, present only for external MCP calls (SEC-04).
+     *
+     * Identity, never payload: the operator can tell WHICH client called, while the
+     * record still has no field that can hold request or response content.
+     */
+    readonly grantId?: string;
+    /** The authenticated client identity, present with {@link grantId}. */
+    readonly clientId?: string;
+}
+/**
+ * A phase timer.
+ *
+ * Records the phases as they HAPPEN rather than inferring them afterwards, because a
+ * duration measured by subtraction cannot distinguish a slow load from a slow queue.
+ */
+export declare class PhaseTimer {
+    #private;
+    constructor(now?: () => number);
+    /** Begin a phase, closing any phase already open. */
+    begin(name: 'queued' | 'load' | 'inference'): void;
+    /** Close the open phase, if any. Idempotent. */
+    end(): void;
+    /** The timings recorded so far. */
+    finish(): InvocationTimings;
+}
+/** Classify an outcome from what was observed (OBS-01). */
+export declare function classifyOutcome(input: {
+    readonly ok: boolean;
+    readonly aborted?: boolean;
+    readonly timedOut?: boolean;
+    readonly denied?: boolean;
+    readonly refused?: boolean;
+}): FailureClass;
+/**
+ * The runtime this process is measuring on (OBS-05).
+ *
+ * Read from the process rather than configured, so a record cannot claim a platform it was
+ * not produced on. That is the specific defect OBS-05 names: Apple Neural Engine figures
+ * presented as Windows performance.
+ * @param engineVersion - the engine actually used for this invocation.
+ * @returns the measurement context.
+ */
+export declare function measurementContext(engineVersion: string): MeasurementContext;
+/**
+ * Build an accounting record (OBS-01).
+ *
+ * Sizes are computed from the SERIALIZED forms because that is what crossed the boundary;
+ * an object's in-memory size is not what a caller paid for.
+ * @param request - what to record.
+ * @returns the accounting record.
+ */
+export declare function accountInvocation(request: {
+    readonly receiptId: string;
+    readonly timings: InvocationTimings;
+    readonly failureClass: FailureClass;
+    readonly reason?: string;
+    readonly input: unknown;
+    readonly output?: unknown;
+    readonly assetBytes?: number;
+    readonly engineVersion: string;
+    /** The external caller's grant identity, when the call was external (SEC-04). */
+    readonly grantId?: string;
+    readonly clientId?: string;
+}): InvocationAccounting;
+//# sourceMappingURL=invocation-accounting.d.ts.map

package/lib/invocation-accounting.d.ts.map

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

package/lib/invocation-accounting.js

@@ -0,0 +1,148 @@
+/**
+ * Invocation accounting: timings, outcome class and sizes (OBS-01, OBS-05).
+ *
+ * The receipt already carries identity — contract, implementation, extension version,
+ * content digest, activation generation, caller scope. OBS-01 asks for four things it did
+ * not have:
+ *
+ *   - **queue / load / inference / total time**, separated, because a slow call has three
+ *     very different causes and a single duration cannot tell them apart;
+ *   - **a cancellation/failure CLASS**, so an operations reader can group failures rather
+ *     than reading prose;
+ *   - **sizes**, measured rather than estimated;
+ *   - and all of it **without credentials or bodies**, which is why the sizes are NUMBERS
+ *     and there is deliberately nowhere to put a payload.
+ *
+ * The last point is the design constraint rather than a disclaimer: this module has no
+ * field that can hold request or response content, so a future change cannot start logging
+ * bodies by accident. A `Record<string, unknown>` "details" bag would have undone that in
+ * one commit.
+ *
+ * OBS-05 is the other half: what is recorded is MEASURED, with the runtime that measured
+ * it, so a vendor's published figure can never be mistaken for this machine's.
+ *
+ * @module @try-works/dsh-tool-mode/invocation-accounting
+ */
+/**
+ * A phase timer.
+ *
+ * Records the phases as they HAPPEN rather than inferring them afterwards, because a
+ * duration measured by subtraction cannot distinguish a slow load from a slow queue.
+ */
+export class PhaseTimer {
+    #start;
+    #phases = new Map();
+    #current = null;
+    constructor(now = Date.now) {
+        this.#now = now;
+        this.#start = now();
+    }
+    #now;
+    /** Begin a phase, closing any phase already open. */
+    begin(name) {
+        this.end();
+        this.#current = { name, startedAt: this.#now() };
+    }
+    /** Close the open phase, if any. Idempotent. */
+    end() {
+        if (this.#current === null)
+            return;
+        const elapsed = this.#now() - this.#current.startedAt;
+        // Phases ACCUMULATE: a call may load, infer, and resume the same phase after a retry.
+        this.#phases.set(this.#current.name, (this.#phases.get(this.#current.name) ?? 0) + elapsed);
+        this.#current = null;
+    }
+    /** The timings recorded so far. */
+    finish() {
+        this.end();
+        return {
+            queuedMs: this.#phases.get('queued') ?? 0,
+            loadMs: this.#phases.get('load') ?? 0,
+            inferenceMs: this.#phases.get('inference') ?? 0,
+            totalMs: this.#now() - this.#start,
+        };
+    }
+}
+/** Classify an outcome from what was observed (OBS-01). */
+export function classifyOutcome(input) {
+    /**
+     * ORDER MATTERS, and it is the caller's intent that wins.
+     *
+     * A deadline that fires will usually also surface as an abort, so checking `aborted`
+     * first would report every timeout as a cancellation and hide the deadline. Likewise a
+     * denial is a policy decision rather than a failure of the work.
+     */
+    if (input.ok)
+        return 'none';
+    if (input.denied === true)
+        return 'policy-denied';
+    if (input.refused === true)
+        return 'refused';
+    if (input.timedOut === true)
+        return 'timeout';
+    if (input.aborted === true)
+        return 'cancelled';
+    return 'failed';
+}
+/**
+ * The runtime this process is measuring on (OBS-05).
+ *
+ * Read from the process rather than configured, so a record cannot claim a platform it was
+ * not produced on. That is the specific defect OBS-05 names: Apple Neural Engine figures
+ * presented as Windows performance.
+ * @param engineVersion - the engine actually used for this invocation.
+ * @returns the measurement context.
+ */
+export function measurementContext(engineVersion) {
+    return {
+        platform: process.platform,
+        architecture: process.arch,
+        nodeVersion: process.version,
+        engineVersion,
+    };
+}
+/**
+ * Build an accounting record (OBS-01).
+ *
+ * Sizes are computed from the SERIALIZED forms because that is what crossed the boundary;
+ * an object's in-memory size is not what a caller paid for.
+ * @param request - what to record.
+ * @returns the accounting record.
+ */
+export function accountInvocation(request) {
+    return {
+        receiptId: request.receiptId,
+        timings: request.timings,
+        sizes: {
+            inputBytes: byteLengthOf(request.input),
+            // An absent output is ZERO bytes rather than unknown: nothing crossed the boundary,
+            // and reporting `null` would invite a reader to treat it as unmeasured.
+            outputBytes: request.output === undefined ? 0 : byteLengthOf(request.output),
+            assetBytes: request.assetBytes ?? 0,
+        },
+        failureClass: request.failureClass,
+        reason: request.reason ?? null,
+        timingSource: 'measured',
+        measuredOn: measurementContext(request.engineVersion),
+        ...request.grantId === undefined
+            ? {}
+            : { grantId: request.grantId, ...request.clientId === undefined ? {} : { clientId: request.clientId } },
+    };
+}
+/** Serialized byte length, with a defined answer for values that cannot serialize. */
+function byteLengthOf(value) {
+    try {
+        const serialized = JSON.stringify(value);
+        // `undefined` and functions serialize to `undefined`, which is zero bytes on the wire.
+        return serialized === undefined ? 0 : Buffer.byteLength(serialized, 'utf8');
+    }
+    catch {
+        /**
+         * A cyclic or otherwise unserializable value did cross the boundary, but its size is
+         * unknown — and reporting `0` would understate it. Recorded as `-1`, which no real
+         * payload can produce, so a reader sees "unmeasured" rather than "empty".
+         */
+        return -1;
+    }
+}
+//# sourceMappingURL=invocation-accounting.js.map

package/lib/jev.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Remote Jev (TypeSafe System One) adapter (TOOL-02, DEC-07).
+ *
+ * Jev is a remote typed-question service, not a local checkpoint and not a chat
+ * endpoint. This module speaks its native `systemOne` request/response shape and
+ * converts a choice answer onto the standard `decision.choose` result. The
+ * conversion is VERSIONED and tested; an invalid probability set or an unknown
+ * choice is an error, never an abstention.
+ *
+ * @module @try-works/dsh-tool-mode/jev
+ */
+/** The version of the native-to-standard conversion this build implements. */
+export declare const JEV_CONVERSION_VERSION = "1.0.0";
+/** A configuration or transport failure; never carries the API key or response body. */
+export declare class JevError extends Error {
+    /** Stable failure class. */
+    readonly code: string;
+    /** HTTP status, when the failure came from a response. */
+    readonly status?: number;
+    constructor(code: string, message: string, status?: number);
+}
+/** The standard `decision.choose` result. */
+export interface JevChoiceResult {
+    /** Zero-based index into the caller's option list. */
+    readonly chosen: number;
+    /** Bucket over the uncalibrated probability mass. */
+    readonly confidence: 'confident' | 'likely' | 'tentative';
+    /** Human-readable reason naming the option and its uncalibrated probability. */
+    readonly reason: string;
+}
+/** The remote request one choice becomes. */
+export interface JevChoiceRequest {
+    readonly model: string;
+    readonly state: {
+        readonly decision: string;
+    };
+    readonly questions: {
+        readonly choice: {
+            readonly type: 'choice';
+            readonly instructions: string;
+            readonly criteria: Readonly<Record<string, string>>;
+        };
+    };
+}
+/** Configuration for one Jev client. */
+export interface JevConfig {
+    readonly enabled?: boolean;
+    readonly apiKey?: string;
+    readonly apiKeyEnv?: string;
+    readonly credentialRef?: string;
+    readonly baseURL?: string;
+    readonly model?: string;
+}
+/** Configuration for one Jev client. */
+export interface JevClientConfig {
+    readonly apiKey: string;
+    /** API root ending before `/v1/systemone`. */
+    readonly baseURL?: string;
+    /** Pinned model id, e.g. `jev-1.14`. */
+    readonly model?: string;
+    readonly timeoutMs?: number;
+    /** Injected transport for tests; defaults to the global fetch. */
+    readonly fetch?: typeof fetch;
+}
+/** The default TypeSafe API root (the `/v1/systemone` path is appended). */
+export declare const JEV_DEFAULT_BASE_URL = "https://api.typesafe.ai";
+/** The default pinned model; callers may pin another documented model. */
+export declare const JEV_DEFAULT_MODEL = "jev-1.14";
+/** Convert a probability mass to the standard bucket. */
+export declare function confidenceBucket(mass: number): 'confident' | 'likely' | 'tentative';
+/**
+ * Build the native request for a choice.
+ * @param decision - the decision text.
+ * @param options - 2–16 distinct nonempty labels.
+ * @param model - the pinned model id.
+ * @returns the native request body.
+ */
+export declare function buildJevChoiceRequest(decision: string, options: readonly string[], model?: string): JevChoiceRequest;
+/**
+ * Convert a native response payload to the standard result.
+ * @param payload - the parsed JSON response.
+ * @param options - the caller's option labels, in order.
+ * @returns the standard result.
+ */
+export declare function convertJevChoiceResponse(payload: unknown, options: readonly string[]): JevChoiceResult;
+/**
+ * Ask Jev one choice question through its native API.
+ * @param decision - the decision text.
+ * @param options - the caller's labels.
+ * @param config - API key, base URL, model and optional transport.
+ * @param signal - cancellation.
+ * @returns the standard result.
+ */
+export declare function chooseWithJev(decision: string, options: readonly string[], config: JevClientConfig, signal?: AbortSignal): Promise<JevChoiceResult>;
+/** One atomic judgment question in the native multi-question shape. */
+export type JevJudgmentQuestion = {
+    readonly id: string;
+    readonly type: 'boolean';
+    readonly proposition: string;
+} | {
+    readonly id: string;
+    readonly type: 'choice';
+    readonly instructions: string;
+    readonly criteria: Readonly<Record<string, string>>;
+};
+/** Native answers returned for a batch of independent judgments. */
+export interface JevJudgmentsResult {
+    readonly model: string;
+    readonly judgments: Readonly<Record<string, Record<string, unknown>>>;
+}
+/** Build the native multi-question request. */
+export declare function buildJevJudgmentsRequest(state: unknown, questions: readonly JevJudgmentQuestion[], model?: string): {
+    readonly model: string;
+    readonly state: unknown;
+    readonly questions: Record<string, unknown>;
+};
+/** Convert the native batch response; missing or invalid answers are errors. */
+export declare function convertJevJudgmentsResponse(payload: unknown, questions: readonly JevJudgmentQuestion[]): JevJudgmentsResult;
+/**
+ * Ask independent atomic judgments in ONE native request.
+ * @param state - the same state for every question.
+ * @param questions - 1–16 independent questions.
+ * @param config - API key, base URL, model and optional transport.
+ * @param signal - cancellation.
+ * @returns native judgments keyed by question id.
+ */
+export declare function judgeWithJev(state: unknown, questions: readonly JevJudgmentQuestion[], config: JevClientConfig, signal?: AbortSignal): Promise<JevJudgmentsResult>;
+/** The MCP contract for the atomic judgment batch. */
+export declare const JEV_JUDGMENTS_CONTRACT: {
+    readonly contract: "decision.judgments.jev";
+    readonly version: "1.0.0";
+    readonly toolName: "decision_judgments_jev";
+    readonly description: "Ask independent atomic boolean/choice questions through Jev in one native request.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["state", "questions"];
+        readonly properties: {
+            readonly state: {
+                readonly type: "object";
+                readonly additionalProperties: true;
+            };
+            readonly questions: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly additionalProperties: true;
+                };
+            };
+        };
+    };
+    readonly outputSchema: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["model", "judgments"];
+        readonly properties: {
+            readonly model: {
+                readonly type: "string";
+            };
+            readonly judgments: {
+                readonly type: "object";
+                readonly additionalProperties: true;
+            };
+        };
+    };
+    readonly semantics: {
+        readonly deterministic: false;
+        readonly readsInputs: true;
+    };
+    readonly limits: {};
+    readonly unsupported: readonly ["no local Jev weights", "no chat schema"];
+};
+/** The MCP contract for the single-choice Jev tool. */
+export declare const JEV_CHOOSE_CONTRACT: {
+    readonly contract: "decision.choose.jev";
+    readonly version: "1.0.0";
+    readonly toolName: "decision_choose_jev";
+    readonly description: "Choose 2–16 options through the remote Jev typed-question API on the standard decision result.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["decision", "options"];
+        readonly properties: {
+            readonly decision: {
+                readonly type: "string";
+            };
+            readonly options: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+        };
+    };
+    readonly outputSchema: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["chosen", "confidence", "reason"];
+        readonly properties: {
+            readonly chosen: {
+                readonly type: "integer";
+            };
+            readonly confidence: {
+                readonly type: "string";
+                readonly enum: readonly ["confident", "likely", "tentative"];
+            };
+            readonly reason: {
+                readonly type: "string";
+            };
+        };
+    };
+    readonly semantics: {
+        readonly deterministic: false;
+        readonly readsInputs: true;
+    };
+    readonly limits: {};
+};
+//# sourceMappingURL=jev.d.ts.map

package/lib/jev.d.ts.map

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