@eddyskywalker/dsh-chatgpt-subscription 0.33.0 → 0.34.0

package/lib/types/host/opendesign/client.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Transport for the OpenDesign link gateway. Transport only: no account or
+ * retry policy lives here (see `adapter.ts`).
+ *
+ * - `POST {baseURL}/chat/completions` — the chat endpoint this line speaks
+ * - `GET  {baseURL}/models` — the key's live catalog; also the auth probe,
+ *   because listing costs no credits while a token of chat does
+ *
+ * The base URL is the OpenAI spelling and already ends in `/v1`
+ * (src/host/opendesign/types.ts records how that was verified), so paths append
+ * literally.
+ *
+ * @module dsh-chatgpt-subscription/opendesign-client
+ */
+import { type OpenDesignDiscoveredModel } from './types.ts';
+export interface OpenDesignHttpResult {
+    status: number;
+    ok: boolean;
+    json: unknown;
+    text: string;
+}
+/** Combine a caller signal with a timeout signal. */
+export declare function withTimeout(signal: AbortSignal | undefined, timeoutMs: number | undefined): AbortSignal | undefined;
+/** Strip a trailing slash so paths can be appended literally. */
+export declare function trimBase(baseURL: string): string;
+/** The gateway's chat-completions endpoint for one base URL. */
+export declare function chatURL(baseURL: string): string;
+/** The gateway's catalog endpoint for one base URL. */
+export declare function modelsURL(baseURL: string): string;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** Send one JSON request and decode whatever comes back; never throws for HTTP errors. */
+export declare function sendJSON(fetchFn: typeof fetch, url: string, { method, apiKey, body, signal, timeoutMs, headers, }?: {
+    method?: string;
+    apiKey?: string;
+    body?: unknown;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    headers?: Record<string, string>;
+}): Promise<OpenDesignHttpResult>;
+/** Open a streaming chat completion and hand back the live response. */
+export declare function openChatStream({ fetchFn, baseURL, apiKey, body, signal, headers, }: {
+    fetchFn: typeof fetch;
+    baseURL: string;
+    apiKey: string;
+    body: unknown;
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+}): Promise<Response>;
+/** The gateway's own one-line explanation, when it sent one. */
+export declare function firstMessage(envelope: unknown): string;
+/**
+ * The live catalog one key may list.
+ *
+ * Returns ids plus whatever metadata the listing published, or null on any
+ * failure — a refused or unreachable gateway is a fact the caller reports, not
+ * an exception the route drops.
+ */
+export declare function fetchGatewayCatalog({ fetchFn, baseURL, apiKey, signal, timeoutMs, }: {
+    fetchFn: typeof fetch;
+    baseURL: string;
+    apiKey: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<{
+    ids: string[];
+    catalog: Record<string, OpenDesignDiscoveredModel>;
+} | null>;
+/**
+ * One id compared without its separators.
+ *
+ * The AMR control-plane catalog spells ids `public_model_deepseek_v4_1_flash`
+ * (the open-source daemon normalizes the same spellings at its boundary), while
+ * the link gateway and this line's table use `deepseek-v4.1-flash`. Comparing
+ * alphanumerics only maps one onto the other without a per-model translation
+ * table that would rot the moment a model is added.
+ */
+export declare function canonicalModelKey(id: string): string;
+/**
+ * The control-plane catalog: the AMR-side listing, which DOES carry metadata.
+ *
+ * `GET {amr}/models` with a control key (the open-source daemon reads the same
+ * catalog through `vela model list --all --format json`, whose items carry
+ * `metadata.contextWindowTokens`). Ids are normalized onto the known wire ids
+ * with {@link canonicalModelKey}; an id the line does not know is kept as the
+ * slug it arrived as, never dropped.
+ *
+ * A runtime key is not accepted here (the console's control-plane surfaces
+ * reject it), so this is an OAuth-account capability; the gateway listing stays
+ * the path for a pasted key.
+ */
+export declare function fetchControlPlaneCatalog({ fetchFn, controlKey, apiBase, knownIds, signal, timeoutMs, }: {
+    fetchFn: typeof fetch;
+    controlKey: string;
+    apiBase?: string;
+    knownIds?: readonly string[];
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<{
+    ids: string[];
+    catalog: Record<string, OpenDesignDiscoveredModel>;
+} | null>;
+/**
+ * Verify one key with the free catalog read.
+ *
+ * A chat probe would spend credits to learn the same thing, so the probe is the
+ * listing: 200 proves the key works (and how many models it sees), 401/403
+ * proves it does not, and anything else is reported as the gateway sent it.
+ */
+export declare function testApiKey({ fetchFn, baseURL, apiKey, signal, timeoutMs, }: {
+    fetchFn: typeof fetch;
+    baseURL: string;
+    apiKey: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<{
+    authorized: boolean;
+    ms: number;
+    error: string;
+    modelCount: number;
+}>;
+/** One wallet reading: the balance string as served, or the refusal as data. */
+export interface OpenDesignWalletBalance {
+    ok: boolean;
+    /** USD balance, exactly as the service strings it (e.g. "12.34"). */
+    balanceUsd: string | null;
+    /** ISO instant the service stamped on the reading, when it sent one. */
+    updatedAt: string | null;
+    error: string;
+}
+/**
+ * Read one OAuth account's wallet balance with its control key.
+ *
+ * Wire shape from the open-source daemon's reader
+ * (apps/daemon/src/integrations/vela-wallet.ts, nexu-io/open-design): the
+ * balance is a STRING matching /^\d+(?:\.\d+)?$/ — a number-shaped field of
+ * any other type is not a balance. A refusal is reported as data, never thrown:
+ * the card shows it beside controls that keep working without it. Billing reads
+ * are display-only upstream too (OPEND-3553 in the same repo): a wallet 401/403
+ * says nothing about the chat credential, so it must never mark the account.
+ */
+export declare function fetchWalletBalance({ fetchFn, controlKey, apiBase, signal, timeoutMs, }: {
+    fetchFn: typeof fetch;
+    controlKey: string;
+    apiBase?: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<OpenDesignWalletBalance>;
+//# sourceMappingURL=client.d.ts.map

package/lib/types/host/opendesign/client.d.ts.map

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

package/lib/types/host/opendesign/line.d.ts

@@ -0,0 +1,49 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { AttachmentStore } from '@deepseek-ai/dsh-attachment';
+import { type ProviderRouteClaim } from '../common/provider-route.ts';
+import { OpenDesignAccountPool } from './account-pool.ts';
+import { OpenDesignAdapter } from './adapter.ts';
+import { OpenDesignLoginManager } from './oauth.ts';
+import { OPENDESIGN_ROUTES } from './routes.ts';
+import { OpenDesignModelSettingsStore, type OpenDesignModelSettings } from './token-store.ts';
+import type { HubSummarySource } from '../hub-overview.ts';
+export interface OpenDesignLineOptions {
+    /** Proxy-aware fetch that routes and catalog syncs use. */
+    fetchFn: typeof fetch;
+    /** Controlled/diagnostic fetch that live adapter chat streams use; defaults to fetchFn. */
+    modelFetchFn?: typeof fetch;
+    /** Durable attachment service, for image input. */
+    attachments?: Pick<AttachmentStore, 'readImage' | 'readImageRequest'>;
+}
+export interface OpenDesignLine {
+    adapter: OpenDesignAdapter;
+    modelSettings: OpenDesignModelSettingsStore;
+    accountPool: OpenDesignAccountPool;
+    login: OpenDesignLoginManager;
+    claim: ProviderRouteClaim;
+    disposeRoutes: () => void;
+    /** Owner overview card source, read from local snapshots only. */
+    hubSource: HubSummarySource;
+    /** Release every registration this line made. */
+    dispose(): void;
+}
+/** Every id the line knows: the shipped table plus the synced live catalog. */
+export declare function openDesignKnownModelIds(settings: OpenDesignModelSettings): string[];
+/**
+ * Every id the line advertises right now.
+ *
+ * The selection rule is shared by the adapter, the status route and the hub
+ * card — they must all read this one function, not three private copies: the
+ * user's tick list and the shipped table speak the same id vocabulary here (the
+ * gateway's own wire ids), so a cold-start intersection cannot empty the picker,
+ * and an explicit "everything off" (`[]`) still wins.
+ */
+export declare function openDesignVisibleModelIds(settings: OpenDesignModelSettings): string[];
+/**
+ * Build the line.
+ * @param ctx - host plugin context (owns `llm` and `webServer`).
+ * @param options - the proxy-aware fetch and the attachment reader.
+ */
+export declare function createOpenDesignLine(ctx: Context, options: OpenDesignLineOptions): OpenDesignLine;
+export { OPENDESIGN_ROUTES };
+//# sourceMappingURL=line.d.ts.map

package/lib/types/host/opendesign/line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line.d.ts","sourceRoot":"","sources":["../../../../src/host/opendesign/line.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAGzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAoD,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACjG,OAAO,EAAE,4BAA4B,EAAE,KAAK,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAE7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,OAAO,EAAE,OAAO,KAAK,CAAA;IACrB,2FAA2F;IAC3F,YAAY,CAAC,EAAE,OAAO,KAAK,CAAA;IAC3B,mDAAmD;IACnD,WAAW,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,kBAAkB,CAAC,CAAA;CACtE;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,iBAAiB,CAAA;IAC1B,aAAa,EAAE,4BAA4B,CAAA;IAC3C,WAAW,EAAE,qBAAqB,CAAA;IAClC,KAAK,EAAE,sBAAsB,CAAA;IAC7B,KAAK,EAAE,kBAAkB,CAAA;IACzB,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,kEAAkE;IAClE,SAAS,EAAE,gBAAgB,CAAA;IAC3B,iDAAiD;IACjD,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,EAAE,CAInF;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,EAAE,CAIrF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAmFjG;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAA"}

package/lib/types/host/opendesign/mapper.d.ts

@@ -0,0 +1,128 @@
+/**
+ * OpenDesign wire mapping: the harness conversation in, an OpenAI-compatible
+ * `chat/completions` body out; decoded SSE frames in, harness stream chunks out.
+ *
+ * The request order rules matter more than they look: an assistant message
+ * carrying `tool_calls` must be followed immediately by one `tool` message per
+ * call id, or a validating gateway rejects the whole request with "insufficient
+ * tool messages following tool_calls message". Everything that would otherwise
+ * land inside that run is held back until the group closes.
+ *
+ * @module dsh-chatgpt-subscription/opendesign-mapper
+ */
+import { type StreamChunk, type TokenUsage } from '@deepseek-ai/dsh-llm';
+import type { GenerateOptions, Message } from '../common/llm-compat.ts';
+import { type ResolvedRequestImages } from '../common/request-images.ts';
+/** The sentence a no-content finish carries, shared with the sibling lines. */
+export declare const NO_ANSWER_PHRASE = "ended the turn without an answer or a tool call";
+/** One OpenAI wire message. */
+export interface OpenDesignWireMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | Array<Record<string, unknown>>;
+    reasoning_content?: string;
+    tool_calls?: Array<{
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+    tool_call_id?: string;
+}
+/** One request body, as sent to the gateway. */
+export interface OpenDesignWireBody {
+    model: string;
+    messages: OpenDesignWireMessage[];
+    stream: true;
+    stream_options: {
+        include_usage: true;
+    };
+    tools?: Array<{
+        type: 'function';
+        function: {
+            name: string;
+            description: string;
+            parameters: Record<string, unknown>;
+        };
+    }>;
+    temperature?: number;
+    max_tokens?: number;
+    stop?: readonly string[];
+    reasoning_effort?: string;
+}
+/**
+ * Convert the harness conversation to wire messages.
+ *
+ * Tool results become standalone `role: 'tool'` messages. A user message
+ * carrying an image switches to the OpenAI content-part array; a text-only one
+ * keeps the plain-string form. An image nested in a tool result has no OpenAI
+ * `tool` wire spelling, so it rides a following user message instead — the same
+ * shape the shipped adapters use. Deferring that message until the next non-tool
+ * message keeps a parallel group's answers contiguous.
+ *
+ * `developer` becomes `system`: the newer OpenAI spelling is not accepted by
+ * every OpenAI-compatible gateway, while `system` is.
+ */
+export declare function serializeMessages(messages: readonly Message[], images: ResolvedRequestImages): OpenDesignWireMessage[];
+/**
+ * Build the wire request for one harness call.
+ * @param options - the harness request (model, system, history, tools, sampling).
+ * @param connection - resolved connection facts (default output budget).
+ * @param images - attachmentId → prepared request version.
+ */
+export declare function buildOpenDesignBody(options: GenerateOptions, connection: {
+    maxTokens: number;
+}, images: ResolvedRequestImages): OpenDesignWireBody;
+/** Map an OpenAI `finish_reason` to the harness finish reason. */
+export declare function mapFinishReason(reason: string): StreamChunk & {
+    type: 'finish';
+};
+/**
+ * Map OpenAI usage fields to disjoint harness counts.
+ *
+ * `prompt_tokens` includes cache hits per the OpenAI convention, and the harness
+ * counts are disjoint, so cached tokens are subtracted out of `inputTokens`.
+ */
+export declare function mapUsage(usage: Record<string, unknown> | null | undefined): TokenUsage;
+/**
+ * Read one delta's reasoning text, tolerating both wire spellings.
+ *
+ * Prefers the string field, and falls back to joining the `reasoning_details`
+ * parts, which is where a gateway that omits the flat field puts the same text.
+ */
+export declare function reasoningOf(delta: Record<string, unknown>): string | undefined;
+/** The gateway's error string, whichever envelope it arrived in. */
+export declare function errorText(error: unknown): string;
+/** Whether the payload is a bare error object rather than a completion chunk. */
+export declare function isErrorPayload(payload: unknown): payload is {
+    error: unknown;
+};
+/** Whether one refusal is about the credential at all. */
+export declare function isAuthenticationError(message: string, status?: number): boolean;
+/**
+ * Map a gateway error payload to a stable harness code.
+ *
+ * OpenDesign meters in dollar-denominated credits, so the exhausted state reads
+ * as an insufficient-balance/credits refusal, not a window name: 402, or the
+ * gateway's own wording about credits/balance running out, is QUOTA. Anything
+ * merely mentioning a plan or a limit is NOT — a temporary billing-lookup
+ * failure must not stand an account down.
+ */
+export declare function streamErrorCode(message: string, status?: number): string;
+/**
+ * Parse an SSE body into decoded JSON frames.
+ * @param body - a web ReadableStream of UTF-8 bytes.
+ * @returns every `data:` payload up to `[DONE]`.
+ */
+export declare function parseServerSentEvents(body: ReadableStream<Uint8Array>): AsyncGenerator<unknown | '[DONE]'>;
+/**
+ * Translate decoded SSE payloads into harness stream chunks.
+ *
+ * Deltas stream through as they arrive; block ends, usage and the finish reason
+ * are all deferred to the `[DONE]` sentinel, so no chunk ever follows `finish`.
+ * A completion with no content at all becomes an `EMPTY_RESPONSE` error finish
+ * rather than a silent empty message.
+ */
+export declare function translate(payloads: AsyncIterable<unknown | '[DONE]'>): AsyncGenerator<StreamChunk>;
+//# sourceMappingURL=mapper.d.ts.map

package/lib/types/host/opendesign/mapper.d.ts.map

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

package/lib/types/host/opendesign/oauth.d.ts

@@ -0,0 +1,105 @@
+import type { OpenDesignOAuthCredentials } from './token-store.ts';
+/** An auth failure with the HTTP facts a caller can judge. */
+export declare class OpenDesignOAuthError extends Error {
+    readonly status?: number;
+    readonly code?: string;
+    constructor(message: string, options?: {
+        status?: number;
+        code?: string;
+        cause?: unknown;
+    });
+}
+/** One device authorization, as the create call returns it. */
+export interface OpenDesignDeviceAuthorization {
+    deviceId: string;
+    userCode: string;
+    activationUrl: string;
+    deviceSecret: string;
+    expiresAt: number;
+    pollIntervalSeconds: number;
+}
+/** Step 1: create one device authorization. */
+export declare function startOpenDesignDeviceAuth(fetchFn: typeof fetch, { apiBase, host, signal, timeoutMs, }: {
+    apiBase?: string;
+    host: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<OpenDesignDeviceAuthorization>;
+/** One poll verdict: still waiting, or the issued credential pair. */
+export type OpenDesignDevicePoll = {
+    pending: true;
+} | {
+    pending: false;
+    credentials: OpenDesignOAuthCredentials;
+};
+/**
+ * Step 3: one poll of the device grant.
+ *
+ * Completion is read from the payload's SHAPE: `runtimeKey`/`controlKey`
+ * present means approved, whatever `status` says; a non-pending status with no
+ * keys is a refusal (denied or expired), reported with the service's own words.
+ */
+export declare function pollOpenDesignDevice(fetchFn: typeof fetch, authorization: Pick<OpenDesignDeviceAuthorization, 'deviceId' | 'deviceSecret'>, { apiBase, signal, timeoutMs, }?: {
+    apiBase?: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<OpenDesignDevicePoll>;
+/** One login flow, as the settings card renders it. */
+export type OpenDesignLoginStatus = 'idle' | 'pending' | 'complete' | 'failed' | 'cancelled';
+export interface OpenDesignLoginFlow {
+    id: string;
+    status: OpenDesignLoginStatus;
+    userCode: string;
+    verificationUri: string;
+    expiresAt: number;
+    intervalSeconds: number;
+    error: string;
+    accountAlias: string;
+}
+export interface OpenDesignLoginOptions {
+    fetchFn: typeof fetch;
+    /** AMR control-plane base; a test seam and a deployment override. */
+    apiBase?: string;
+    /** This machine's name, recorded on the authorization the console lists. */
+    host(): string;
+    /** Persist a newly signed-in account; throws make the flow fail. */
+    onLogin(credentials: OpenDesignOAuthCredentials): Promise<void>;
+    logger?: {
+        warn(message: string, ...args: unknown[]): void;
+    };
+}
+/**
+ * One device-authorization sign-in at a time.
+ *
+ * Polling is driven by the card (`GET /login/status`): each request makes at
+ * most one AMR call, and only after the advertised interval has elapsed. A host
+ * restart therefore loses the pending flow rather than keeping a poll loop
+ * alive with no reader — the same contract the sibling lines use.
+ */
+export declare class OpenDesignLoginManager {
+    private readonly options;
+    private flow;
+    private sequence;
+    constructor(options: OpenDesignLoginOptions);
+    /** Start a new flow, cancelling any previous one. */
+    begin({ signal }?: {
+        signal?: AbortSignal;
+    }): Promise<OpenDesignLoginFlow>;
+    /** The latest flow, or null when this process never started one. */
+    current(): OpenDesignLoginFlow | null;
+    /**
+     * Advance one flow and return its state.
+     *
+     * A flow the caller does not name is not advanced: two cards (or a stale one)
+     * cannot spend each other's polls.
+     */
+    status(id: string, { signal, timeoutMs }?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<OpenDesignLoginFlow>;
+    /** Abandon one flow; a late browser confirmation is then ignored. */
+    cancel(id: string): boolean;
+    /** Mark every flow cancelled for teardown. */
+    dispose(): void;
+}
+//# sourceMappingURL=oauth.d.ts.map

package/lib/types/host/opendesign/oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../../../src/host/opendesign/oauth.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA;AAQlE,8DAA8D;AAC9D,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;gBAEV,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAM/F;AAED,+DAA+D;AAC/D,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAuBD,+CAA+C;AAC/C,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,OAAO,KAAK,EACrB,EACE,OAAsB,EACtB,IAAI,EACJ,MAAM,EACN,SAAmC,GACpC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9E,OAAO,CAAC,6BAA6B,CAAC,CAmCxC;AAED,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAC5B;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GACjB;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,0BAA0B,CAAA;CAAE,CAAA;AAE/D;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,OAAO,KAAK,EACrB,aAAa,EAAE,IAAI,CAAC,6BAA6B,EAAE,UAAU,GAAG,cAAc,CAAC,EAC/E,EACE,OAAsB,EACtB,MAAM,EACN,SAAmC,GACpC,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACrE,OAAO,CAAC,oBAAoB,CAAC,CA2C/B;AAED,uDAAuD;AACvD,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAA;AAE5F,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,qBAAqB,CAAA;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;CACrB;AAUD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,KAAK,CAAA;IACrB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,IAAI,IAAI,MAAM,CAAA;IACd,oEAAoE;IACpE,OAAO,CAAC,WAAW,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;KAAE,CAAA;CAC7D;AAED;;;;;;;GAOG;AACH,qBAAa,sBAAsB;IAIrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,QAAQ,CAAI;gBAES,OAAO,EAAE,sBAAsB;IAE5D,qDAAqD;IAC/C,KAAK,CAAC,EAAE,MAAM,EAAE,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA+BpF,oEAAoE;IACpE,OAAO,IAAI,mBAAmB,GAAG,IAAI;IAIrC;;;;;OAKG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA0DhI,qEAAqE;IACrE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQ3B,8CAA8C;IAC9C,OAAO,IAAI,IAAI;CAKhB"}

package/lib/types/host/opendesign/routes.d.ts

@@ -0,0 +1,74 @@
+/**
+ * The OpenDesign settings API.
+ *
+ * The surface is the one every sibling line exposes — status, accounts, models —
+ * plus the controls this line genuinely has: device-authorization sign-in, an
+ * explicit catalog sync, and the wallet-balance read an OAuth account's control
+ * key can make.
+ *
+ * Reads never trigger an upstream call; the catalog is synced by its own action
+ * and behind a successful sign-in, and quota is refreshed by its own action.
+ *
+ * @module dsh-chatgpt-subscription/opendesign-routes
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { OpenDesignAccountPool } from './account-pool.ts';
+import { type OpenDesignModelSettingsStore } from './token-store.ts';
+import type { OpenDesignLoginManager } from './oauth.ts';
+import { openPlatformBrowser } from '../step-code/routes.ts';
+import { type OpenDesignUsageAccountDto, type OpenDesignWebStatus } from '../../shared/opendesign-contracts.ts';
+export interface OpenDesignRouteOptions {
+    settings: OpenDesignModelSettingsStore;
+    accountPool: OpenDesignAccountPool;
+    /** Proxy-aware fetch for account verification, quota reads and catalog syncs. */
+    fetchFn: typeof fetch;
+    /** Device-authorization sign-in state, when the composition installed one. */
+    login?: OpenDesignLoginManager;
+    /**
+     * Browser opener for `/login/start`; defaults to a no-op because the settings
+     * card opens the activation URL itself via `window.open`.
+     */
+    openBrowser?: (url: string) => void;
+    serving(): boolean;
+    conflict(): string | null;
+}
+/** Named browser opener for deployments that want the host to launch the activation URL. */
+export declare const openOpenDesignBrowser: typeof openPlatformBrowser;
+/**
+ * Latest wallet readings, in-process only.
+ *
+ * A reading is a snapshot, not a stream: a restart starts blank rather than
+ * serving a stale figure as if fresh, and a failed refresh keeps the previous
+ * one with its error attached (the card shows both).
+ */
+interface UsageStore {
+    readings: Map<string, OpenDesignUsageAccountDto>;
+    fetchedAt: number;
+}
+/** Assemble the whole status payload the OpenDesign tab renders. */
+export declare function getOpenDesignWebStatus(options: OpenDesignRouteOptions, usageStore?: UsageStore): Promise<OpenDesignWebStatus>;
+/** The route table, exported so the client and this file can be checked against each other. */
+export declare const OPENDESIGN_ROUTES: {
+    readonly status: "GET";
+    readonly settings: "POST";
+    readonly accounts: "GET|POST";
+    readonly 'login/start': "POST";
+    readonly 'login/status': "GET";
+    readonly 'login/cancel': "POST";
+    readonly models: "GET|POST";
+    readonly 'models/visibility': "POST";
+    readonly 'models/visibility-all': "POST";
+    readonly 'models/context-window': "POST";
+    readonly 'catalog/refresh': "POST";
+    readonly usage: "GET|POST";
+};
+/**
+ * Register the OpenDesign settings API under `/opendesign/api`.
+ *
+ * Registered unconditionally: the card is how a user adds their first key, so
+ * gating it on winning the route would leave a contested id with no way to
+ * configure it at all.
+ */
+export declare function registerOpenDesignRoutes(ctx: Context, options: OpenDesignRouteOptions): () => void;
+export {};
+//# sourceMappingURL=routes.d.ts.map

package/lib/types/host/opendesign/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../src/host/opendesign/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,EAKL,KAAK,4BAA4B,EAClC,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAOL,KAAK,yBAAyB,EAE9B,KAAK,mBAAmB,EACzB,MAAM,sCAAsC,CAAA;AAsG7C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,4BAA4B,CAAA;IACtC,WAAW,EAAE,qBAAqB,CAAA;IAClC,iFAAiF;IACjF,OAAO,EAAE,OAAO,KAAK,CAAA;IACrB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,sBAAsB,CAAA;IAC9B;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,OAAO,IAAI,OAAO,CAAA;IAClB,QAAQ,IAAI,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB,4BAAsB,CAAA;AAExD;;;;;;GAMG;AACH,UAAU,UAAU;IAClB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAA;IAChD,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,oEAAoE;AACpE,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,sBAAsB,EAC/B,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAwC9B;AAkBD,+FAA+F;AAC/F,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAAS,CAAA;AAEvC;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAwYlG"}