@eddyskywalker/dsh-chatgpt-subscription 0.31.0 → 0.32.0

package/lib/types/host/cline-pass/client.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Transport for the Cline gateway and its public catalogs. Transport only: no
+ * pinning, retry, or failover policy lives here (see `adapter.ts`).
+ *
+ * - `POST {baseURL}/chat/completions` — the gateway
+ * - `GET  {baseURL}/models` — the gateway's own catalog
+ * - `GET  {baseURL}/users/me/plan/usage-limits` — the account's quota windows
+ * - `GET  api.cline.bot/…/recommended-models` — official subscription list
+ * - `GET  models.dev/api.json` — community registry, a metadata backstop
+ * - `GET  ai-gateway.vercel.sh/v1/models` — the upstream's own catalog
+ * - `GET  openrouter.ai/api/v1/…` — endpoint detail for direct-pipeline models
+ *
+ * @module dsh-chatgpt-subscription/cline-pass-client
+ */
+import { type ClinePassCatalogScan } from './types.ts';
+export interface ClinePassHttpResult {
+    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 own chat-completions endpoint for one base URL. */
+export declare function chatURL(baseURL: string): string;
+/** 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<ClinePassHttpResult>;
+/** Send one chat completion, non-streaming. */
+export declare function chatCompletion({ fetchFn, baseURL, apiKey, body, signal, timeoutMs, }: {
+    fetchFn: typeof fetch;
+    baseURL: string;
+    apiKey: string;
+    body: unknown;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<ClinePassHttpResult>;
+/** 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>;
+/** List the gateway's own catalog ids; an empty array when the call fails. */
+export declare function fetchGatewayCatalog({ fetchFn, baseURL, apiKey, signal, timeoutMs, }: {
+    fetchFn: typeof fetch;
+    baseURL: string;
+    apiKey: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<string[]>;
+/** One quota window as the gateway reports it. */
+export interface ClinePassRawUsageLimit {
+    type: string;
+    percentUsed: number;
+    resetsAt: string;
+}
+/**
+ * Read the account's official quota consumption.
+ *
+ * The gateway answers with `{ success, data: { limits: [{ type, percentUsed,
+ * resetsAt }] } }`, where `type` is `five_hour`, `weekly` or `monthly`. A refusal
+ * is reported as data, never thrown: the card shows quota beside controls that
+ * keep working without it.
+ */
+export declare function fetchUsageLimits({ fetchFn, baseURL, apiKey, signal, timeoutMs, }: {
+    fetchFn: typeof fetch;
+    baseURL: string;
+    apiKey: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<{
+    ok: boolean;
+    limits: ClinePassRawUsageLimit[];
+    error: string;
+}>;
+/**
+ * Collect `cline-pass/*` ids and metadata from the official endpoints and the
+ * community registry. Additive by design: a source that fails is skipped.
+ */
+export declare function fetchOfficialModels({ fetchFn, signal, timeoutMs, }: {
+    fetchFn: typeof fetch;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<ClinePassCatalogScan>;
+/** Resolve a canonical slug against OpenRouter's public catalog. */
+export declare function resolveOpenRouterSlug(fetchFn: typeof fetch, slug: string, { signal, timeoutMs }?: {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<string | null>;
+/** One upstream endpoint detail, as OpenRouter reports it. */
+export interface ClinePassEndpointDetail {
+    slug: string;
+    name: string;
+    endpoints: number;
+    context: number;
+    uptime: number;
+}
+/** Per-upstream endpoint detail (context length, recent uptime) for one model. */
+export declare function openRouterEndpoints(fetchFn: typeof fetch, slug: string, { signal, timeoutMs }?: {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<{
+    slug: string;
+    endpoints: ClinePassEndpointDetail[];
+}>;
+//# sourceMappingURL=client.d.ts.map

package/lib/types/host/cline-pass/client.d.ts.map

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

package/lib/types/host/cline-pass/engine.d.ts

@@ -0,0 +1,223 @@
+/**
+ * The Cline Pass engine: pinned request chains with pre-first-token failover,
+ * probing, validation, and account verification. It owns every probe network
+ * call, so the adapter, the settings routes and the management tools apply
+ * identical pinning semantics.
+ *
+ * Failover contract: a candidate is abandoned only while nothing has been
+ * delivered yet. A non-2xx, a transport failure, or an error payload before the
+ * first content delta moves to the next candidate; once a chunk has been
+ * produced the stream is the answer, and a later failure is reported as such.
+ *
+ * @module dsh-chatgpt-subscription/cline-pass-engine
+ */
+import { LlmError } from '@deepseek-ai/dsh-llm';
+import { parseRouting, pinAdherence, type PinAttempt, type PinConfig } from './protocol.ts';
+import { type ClinePassCatalogScan, type ClinePassPinSettings } from './types.ts';
+import type { ClinePassStore } from './store.ts';
+import type { ClinePassAccountPool } from './account-pool.ts';
+/** One resolved account, as the engine hands it to a request or a probe. */
+export interface ClinePassAccount {
+    id: string;
+    name: string;
+    key: string;
+    baseURL: string;
+}
+/** One pinned request's outcome. */
+export interface ClinePassAttemptOutcome {
+    attempt: PinAttempt;
+    account: ClinePassAccount;
+    status: number;
+    ok: boolean;
+    json: Record<string, unknown>;
+    text: string;
+    ms: number;
+    routing: ReturnType<typeof parseRouting>;
+    adherence: ReturnType<typeof pinAdherence> | null;
+    warnings: string[];
+    error: string;
+}
+export interface ClinePassEngineOptions {
+    fetchFn: typeof fetch;
+    /** Controlled/diagnostic fetch used only for live chat streams; defaults to fetchFn. */
+    streamFetchFn?: typeof fetch;
+    accountPool: ClinePassAccountPool;
+    store: ClinePassStore;
+    /** The stored pin plus the route-wide spelling policy. */
+    pinFor(model: string): PinConfig;
+    /** The route's default gateway, used when an account names none. */
+    baseURL(): string;
+    logger?: {
+        warn(message: string, ...args: unknown[]): void;
+    };
+    attemptTimeoutMs?: number;
+    probeTimeoutMs?: number;
+}
+/**
+ * The engine. All methods are safe to call while the pool is serving live
+ * traffic; probes take an account through the same rotation as a request.
+ */
+export declare class ClinePassEngine {
+    private readonly options;
+    constructor(options: ClinePassEngineOptions);
+    private get fetchFn();
+    private get store();
+    /** The account a request would use right now, without consuming a rotation slot. */
+    resolveAccount(exclude?: ReadonlySet<string>): Promise<ClinePassAccount>;
+    /** The pin plus the route-wide spelling policy, as a request will send it. */
+    pinConfigFor(model: string): PinConfig;
+    /** The configured pin for one model, read through the live settings file. */
+    pinOf(model: string): ClinePassPinSettings;
+    /**
+     * One pinned request, non-streaming.
+     * @returns the decoded payload plus the facts the pin was judged on.
+     */
+    attemptChat(model: string, body: Record<string, unknown>, attempt: PinAttempt, { signal, timeoutMs }?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<ClinePassAttemptOutcome>;
+    /**
+     * Run one model's ordered candidate chain until an attempt is both answered
+     * and served by the channel the pin asked for.
+     *
+     * This is the diagnostic path (`cline_pass_test`), so it keeps looking past a
+     * candidate the router quietly ignored: the point of the call is to find out
+     * whether the pin works.
+     */
+    runChain(model: string, body: Record<string, unknown>, pinConfig: PinConfig, { signal, timeoutMs }?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<{
+        ok: boolean;
+        result: ClinePassAttemptOutcome | null;
+        trace: Array<{
+            upstream: string;
+            status: number;
+            ms: number;
+            note: string;
+        }>;
+        error: string;
+        warnings: string[];
+    }>;
+    /** Merge a gateway error's own provider list into the model's channel list. */
+    learnFromError(model: string, message: string): void;
+    /**
+     * Probe one model: detect its pipeline, read back the upstream it used, and
+     * harvest the channel list each pipeline publishes. Costs two tiny requests.
+     */
+    probe(model: string, { signal, timeoutMs }?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<{
+        ok: boolean;
+        ms: number;
+        model: string;
+        error: string;
+        pipeline: string;
+        pinnable: boolean;
+        canonicalSlug: string;
+        lastProvider: string;
+        upstreams: string[];
+        availableProviders: string[];
+        tier0: string[];
+    }>;
+    /**
+     * Harvest the exact channel list for one pipeline by pinning a channel that
+     * cannot exist: the router fails before spending a token and names every
+     * provider it could have used.
+     */
+    private harvest;
+    /**
+     * Test every known channel of a model once and record the verdicts.
+     *
+     * A channel counts as usable only when the response names it as the one that
+     * served the request; a payload carrying `choices` alone is not evidence the
+     * pin was honored.
+     */
+    validate(model: string, { signal, timeoutMs }?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<{
+        results: Array<{
+            upstream: string;
+            status: string;
+            ms: number;
+            note: string;
+        }>;
+        summary: {
+            ok: number;
+            limited: number;
+            bad: number;
+            auth: number;
+            unknown: number;
+        };
+        cancelled: boolean;
+    }>;
+    /**
+     * Send one small chat through a (possibly temporary) pin configuration and
+     * report what served it. Nothing is persisted.
+     */
+    test(model: string, { upstreams, exclude, signal }?: {
+        upstreams?: string[];
+        exclude?: string[];
+        signal?: AbortSignal;
+    }): Promise<{
+        ok: boolean;
+        ms: number;
+        model: string;
+        error: string;
+        targets: string[];
+        excluded: string[];
+        trace: Array<{
+            upstream: string;
+            status: number;
+            ms: number;
+            note: string;
+        }>;
+        actual: string;
+        actualName: string;
+        pipeline: string;
+        pinnable: boolean;
+        canonicalSlug: string;
+        account: string;
+        content: string;
+        adopted: boolean;
+        adherence: string;
+        plan: string;
+        warnings: string[];
+    }>;
+    /**
+     * Check one account key against the gateway with a single small request.
+     *
+     * A key that authenticates but whose model still errors (a reasoning model
+     * burning `max_tokens` into an empty completion, for example) counts as
+     * authorized: only a real authentication failure is reported as one.
+     */
+    testAccount({ key, baseURL, model, signal, timeoutMs, }: {
+        key: string;
+        baseURL?: string;
+        model: string;
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<{
+        ok: boolean;
+        authorized: boolean;
+        ms: number;
+        model: string;
+        error: string;
+    }>;
+    /** Refresh the gateway's own catalog ids. */
+    gatewayCatalog({ signal, timeoutMs }?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<string[]>;
+    /** Refresh the official subscription model list. */
+    officialModels({ signal }?: {
+        signal?: AbortSignal;
+    }): Promise<ClinePassCatalogScan>;
+    /** Open one chat stream for the adapter; transport only. */
+    openStream(account: ClinePassAccount, body: Record<string, unknown>, signal?: AbortSignal): Promise<Response>;
+    /** Raise the engine's own error for a request that never reached a candidate. */
+    noAccountError(error: unknown): LlmError;
+}
+//# sourceMappingURL=engine.d.ts.map

package/lib/types/host/cline-pass/engine.d.ts.map

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

package/lib/types/host/cline-pass/line.d.ts

@@ -0,0 +1,55 @@
+/**
+ * The Cline Pass line, assembled in one place.
+ *
+ * `src/index.ts` calls {@link createClinePassLine} beside the other lines and
+ * appends the returned claim, route disposer, hub source and exports. Everything
+ * this line owns — stores, pool, engine, adapter, routes, optional tools — is
+ * constructed here, so the integration touches no sibling line's behaviour.
+ *
+ * @module dsh-chatgpt-subscription/cline-pass-line
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { AttachmentStore } from '@deepseek-ai/dsh-attachment';
+import { type ProviderRouteClaim } from '../common/provider-route.ts';
+import { ClinePassAccountPool } from './account-pool.ts';
+import { ClinePassAdapter } from './adapter.ts';
+import { ClinePassEngine } from './engine.ts';
+import { CLINE_PASS_ROUTES } from './routes.ts';
+import { type ClinePassStore } from './store.ts';
+import { ClinePassModelSettingsStore, type ClinePassModelSettings } from './token-store.ts';
+import type { HubSummarySource } from '../hub-overview.ts';
+export interface ClinePassLineOptions {
+    /** Proxy-aware fetch that routes, OAuth, quota reads and catalog sync 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'>;
+    /** Test seam: skip tools even when the stored settings ask for them. */
+    disableTools?: boolean;
+}
+export interface ClinePassLine {
+    adapter: ClinePassAdapter;
+    engine: ClinePassEngine;
+    store: ClinePassStore;
+    modelSettings: ClinePassModelSettingsStore;
+    accountPool: ClinePassAccountPool;
+    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, before the visibility selection is applied. */
+export declare function clinePassKnownModelIds(settings: ClinePassModelSettings, catalogIds: readonly string[]): string[];
+/** Every id the line advertises right now. */
+export declare function clinePassVisibleModelIds(settings: ClinePassModelSettings, catalogIds: readonly string[]): string[];
+/**
+ * Build the line.
+ * @param ctx - host plugin context (owns `llm`, `webServer` and `tools`).
+ * @param options - the proxy-aware fetch and the attachment reader.
+ */
+export declare function createClinePassLine(ctx: Context, options: ClinePassLineOptions): ClinePassLine;
+export { CLINE_PASS_ROUTES };
+//# sourceMappingURL=line.d.ts.map

package/lib/types/host/cline-pass/line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line.d.ts","sourceRoot":"","sources":["../../../../src/host/cline-pass/line.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,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,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C,OAAO,EAAkD,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/F,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AACtE,OAAO,EAAE,2BAA2B,EAAE,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAG3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,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;IACrE,wEAAwE;IACxE,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,gBAAgB,CAAA;IACzB,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,cAAc,CAAA;IACrB,aAAa,EAAE,2BAA2B,CAAA;IAC1C,WAAW,EAAE,oBAAoB,CAAA;IACjC,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,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,sBAAsB,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAKhH;AAED,8CAA8C;AAC9C,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,sBAAsB,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAIlH;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAgI9F;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAA"}

package/lib/types/host/cline-pass/mapper.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Cline Pass 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/cline-pass-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';
+/** One OpenAI wire message. */
+export interface ClinePassWireMessage {
+    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 after pin injection. */
+export interface ClinePassWireBody {
+    model: string;
+    messages: ClinePassWireMessage[];
+    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;
+    provider?: Record<string, unknown>;
+    providerOptions?: Record<string, unknown>;
+}
+/**
+ * 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): ClinePassWireMessage[];
+/**
+ * Build the wire request for one harness call, before pinning.
+ * @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 buildClinePassBody(options: GenerateOptions, connection: {
+    maxTokens: number;
+}, images: ResolvedRequestImages): ClinePassWireBody;
+/** 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;
+/** Map a gateway error payload to a stable harness code. */
+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/cline-pass/mapper.d.ts.map

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