@inhuman.tools/harness 0.0.0-stage → 0.2.0

package/dist/providers/openai-compat/connection.d.ts

@@ -0,0 +1,153 @@
+import { CompletionExpectation } from "@inhuman.tools/harness-model";
+import type { CompleteResult, ConnectionCompleteRequest } from "@inhuman.tools/harness-provider-sdk";
+import { type DriverOffer, type ExpectationActor, PEWDriver } from "@inhuman.tools/plexus-expectations/driver";
+import { type AdoptCallback, type DriverAdoptArgs, type DriverAdoptBags } from "./adopt.js";
+import { type AccountSnapshot } from "./api-extensions/index.js";
+import { type CacheAffinity, type CacheAffinityRequest, type CacheFlavor } from "./cache-affinity.js";
+import { type FetchInput, type HeaderInit } from "./fetch-types.js";
+import { type ReasoningFlavor } from "./reasoning-flavor.js";
+import { type OpenaiCompatConnectionConfig } from "./schema.js";
+/** Looking (focused / ambient occupancy) quota poll. */
+export declare const ACCOUNT_STALE_MS = 45000;
+/** Interned but nobody looking — slow heartbeat so Ctrl overlay is not empty. */
+export declare const ACCOUNT_IDLE_MS: number;
+/** Local OpenAI-compat (LM Studio / Ollama) answers in milliseconds. */
+export declare const LOCAL_HANDSHAKE_MS = 2500;
+/** Remote catalogs (OpenRouter, Grok proxy, ChatGPT) need a real RTT. */
+export declare const REMOTE_HANDSHAKE_MS = 60000;
+export type LastChallenge = "none" | 401 | 403;
+export declare function handshakeTimeoutMs(url: string): number;
+/** OpenAI-compat extras: invocation catalog plus the account/key face. */
+export declare function openaiCompatLiveState(): {
+    catalogName: string;
+    account: AccountSnapshot | undefined;
+    keyMask: string;
+    /** `undefined` is omitted by the kernel mirror, which clears a previous `"needs-auth"` on `spec.live`. */
+    auth: "needs-auth" | undefined;
+    models: string[];
+    windows: Record<string, number>;
+};
+export declare class OpenAiCompatDriverConnection extends PEWDriver<CompletionExpectation, OpenaiCompatConnectionConfig> {
+    #private;
+    static configurationSchema: import("zod").ZodObject<{
+        baseUrl: import("zod").ZodString;
+        model: import("zod").ZodOptional<import("zod").ZodString>;
+        temperature: import("zod").ZodOptional<import("zod").ZodNumber>;
+        headers: import("zod").ZodOptional<import("zod").ZodPreprocess<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>>;
+        cacheControl: import("zod").ZodOptional<import("zod").ZodEnum<{
+            auto: "auto";
+            on: "on";
+            off: "off";
+        }>>;
+        cacheControlTtl: import("zod").ZodOptional<import("zod").ZodEnum<{
+            "5m": "5m";
+            "1h": "1h";
+        }>>;
+        cacheProbe: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        contextWindow: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodNumber>>;
+    }, import("zod/v4/core").$loose>;
+    static secretsSchema: import("zod").ZodObject<{
+        apiKey: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$loose>;
+    static configurationLabel: string;
+    /** Probe transport for local detection. Tests swap it. */
+    static probeFetch: typeof fetch;
+    /**
+     * Detected local servers, then the custom door, then key-only catalogs. The
+     * detected part is observable and wakes under an observer (the catalog
+     * mirror); a plain read sees whatever was last probed.
+     */
+    static get offers(): readonly DriverOffer[];
+    /**
+     * Loopback baseUrl: no questions. Remote baseUrl (a catalog offer): one
+     * required key. No baseUrl (custom): ask for it, key optional.
+     */
+    static adopt(args: DriverAdoptArgs, callback: AdoptCallback): Promise<DriverAdoptBags>;
+    accessor nowMs: number;
+    accessor lastChallenge: LastChallenge;
+    accessor refreshFailedAtMs: number | null;
+    accessor state: {
+        catalogName: string;
+        account: AccountSnapshot | undefined;
+        keyMask: string;
+        /** `undefined` is omitted by the kernel mirror, which clears a previous `"needs-auth"` on `spec.live`. */
+        auth: "needs-auth" | undefined;
+        models: string[];
+        windows: Record<string, number>;
+    };
+    get alive(): boolean;
+    /** Secret bag changed — computeds read this, not `Date.now()`, then `secrets.get`. */
+    protected readSecrets(): void;
+    get expiring(): boolean;
+    /**
+     * Static key: lastChallenge with a configured key. Empty key is not ceremony.
+     * PR4: a send 401 is `noteChallenge`, not catalog `noteFail`.
+     */
+    get needsAuth(): boolean;
+    get fresh(): boolean;
+    tick(now?: number): void;
+    noteChallenge(status: number): void;
+    protected publishAuth(): void;
+    protected noteRefreshFailed(): void;
+    /** Persist a bag. Identity hydrate uses this; a token grant uses {@link depositSecrets}. */
+    protected mergeSecrets(next: Record<string, string>): void;
+    /**
+     * Token grant. Clears `lastChallenge` and `refreshFailedAtMs` so a grant
+     * does not keep the standing reaction eligible forever.
+     */
+    protected depositSecrets(next: Record<string, string>): void;
+    /** Coalesced grant. Fetch sites do not call this. */
+    refreshSession(): Promise<void>;
+    protected refreshGrant(): Promise<void>;
+    bootstrap(): Promise<void>;
+    protected modelsRequestUrl(): string;
+    completionRequestUrl(): string;
+    responsesRequestUrl(): string;
+    completionApi(): "chat" | "responses";
+    protected reportLive(): void;
+    protected connectionCatalogName(): string;
+    protected connectionKeyMask(): string;
+    /** True when this connection has a funds/quota probe. Local hosts stay off. */
+    protected accountPolls(): boolean;
+    /** Handshake until `bootstrapDone`; send after. */
+    protected accountDoor(input: FetchInput, init?: RequestInit): Promise<Response>;
+    protected loadAccount(): Promise<AccountSnapshot | undefined>;
+    protected refreshAccount(): Promise<void>;
+    noteFail(error: unknown): void;
+    trackInflight(abort: AbortController): void;
+    untrackInflight(abort: AbortController): void;
+    abortOnDrop(reason: unknown): void;
+    [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * Wait send-ready, then `handle(round)`. Idempotent under live honor.
+     * On abort, abort the interned actor.
+     */
+    complete(req: ConnectionCompleteRequest): Promise<CompleteResult>;
+    protected resolve(expectation: CompletionExpectation): ExpectationActor<CompletionExpectation>;
+    /** Pure stamp: current secret + `authHeaders()`. Tests and dumps only. */
+    requestHeaders(): Record<string, string>;
+    /** Stamp wins colliding keys (case-insensitive). Never another connection's secrets. */
+    stamp(init?: HeaderInit): Record<string, string>;
+    /**
+     * Send door. Wait on the graph; stamp; fetch once. No retry. No `refreshSession()`.
+     */
+    authorizedFetch(input: FetchInput, init?: RequestInit, signal?: AbortSignal): Promise<Response>;
+    /** Handshake door. Always hits the wire. Never throws on !fresh. Never waits send-ready. */
+    handshakeFetch(input: FetchInput, init?: RequestInit, signal?: AbortSignal): Promise<Response>;
+    /** Extra auth headers for a subscription profile (account id, grok-cli token). */
+    protected authHeaders(): Record<string, string>;
+    protected secretField(field: string): string | undefined;
+    /**
+     * Prompt-cache flavor. Subscription drivers override. Hostname tables are
+     * the fallback; `#detectedFlavor` wins after a live {@link probeCachePolicy}.
+     */
+    cacheFlavor(): CacheFlavor;
+    /** Completion-only. Handshake must not send these. */
+    cacheAffinity(sessionId: string, model: string, request?: CacheAffinityRequest): CacheAffinity;
+    /**
+     * Reasoning dialect from host. Cache flavor pins grok/openai/chatgpt/openrouter
+     * when a driver stubs it (tests, subscription). Else {@link reasoningFlavorFromBaseUrl}.
+     */
+    reasoningFlavor(): ReasoningFlavor;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/providers/openai-compat/connection.d.ts.map

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