@hraness/sys1 0.17.0

package/dist/client.d.ts

@@ -0,0 +1,52 @@
+import { type SystemOneRequest, type SystemOneResponse } from "./protocol.ts";
+export type { Answer, ChoiceAnswer, ChoiceQuestion, EntryType, JsonValue, NoulAnswer, NoulQuestion, Question, ScoreAnswer, ScoreQuestion, SystemOneRequest, SystemOneResponse, } from "./protocol.ts";
+export declare const DEFAULT_BASE_URL = "http://127.0.0.1:13900";
+export type ClientErrorCode = "invalid_options" | "invalid_request" | "aborted" | "timeout" | "transport_error" | "http_error" | "response_too_large" | "invalid_response";
+/** Never includes request bodies, credentials, URLs, or untrusted server errors. */
+export declare class Sys1ClientError extends Error {
+    readonly code: ClientErrorCode;
+    readonly status: number | undefined;
+    constructor(code: ClientErrorCode, status?: number);
+}
+export interface ClientOptions {
+    /** Use only for a direct Kev endpoint. Sys1 gateways declare their own adapter. */
+    adapter?: "systemone" | "kev";
+    /** An explicit HTTP(S) endpoint root; /v1/systemone is appended. */
+    baseUrl?: string;
+    /** Explicit headers, including Authorization if needed. Never read from env. */
+    headers?: HeadersInit;
+    /** Total HTTP request and response-body deadline, 1..300000 ms. Default 30000. */
+    timeoutMs?: number;
+    /** Optional transport injection. It must respect Fetch semantics. */
+    fetch?: typeof globalThis.fetch;
+}
+export interface EvaluationOptions {
+    signal?: AbortSignal;
+}
+export interface RouteMetadata {
+    /** Native Kev probabilities retain their published two-decimal precision. */
+    adapter?: "kev";
+    probabilityDecimals?: 2;
+    backend?: string;
+    attempts?: number;
+    local?: {
+        /** Adapter identity, not a claim of calibrated probabilities. */
+        adapter: string;
+        minCoverage?: number;
+        minConcentration?: number;
+    };
+}
+export interface EvaluationResult {
+    response: SystemOneResponse;
+    /** Empty for direct endpoints that do not supply Sys1 routing headers. */
+    metadata: RouteMetadata;
+}
+export interface Sys1Client {
+    /** Makes exactly one HTTP attempt. Never retries, starts a daemon, or falls back. */
+    evaluate(request: SystemOneRequest, options?: EvaluationOptions): Promise<EvaluationResult>;
+}
+/** A dependency-light client. No filesystem, environment, native runtime, or daemon access. */
+export declare function createClient(options?: ClientOptions): Sys1Client;
+export { PROTOCOL_LIMITS, answerSchema, questionSchema, noulQuestionSchema, choiceQuestionSchema, scoreQuestionSchema, noulAnswerSchema, choiceAnswerSchema, scoreAnswerSchema, systemOneRequestSchema, systemOneResponseSchema, } from "./protocol.ts";
+export { createProfile, Sys1ProfileError } from "./profile.ts";
+export type { DecisionProfile, ProfileDefinition, ReadonlyProfileDefinition, ProfileErrorCode, } from "./profile.ts";