dsh-draw 0.1.0

package/lib/types/client/present.js

@@ -0,0 +1,86 @@
+/**
+ * Pure presentation projections for the dsh-draw browser half: the tool
+ * result value and the settings snapshot are folded into view models that the
+ * React components render without further logic. Everything here is a pure
+ * function of its input, so tests pin the projections without a DOM.
+ *
+ * @module dsh-draw/client/present
+ */
+/**
+ * Project one settled `image_generate` tool block onto the card model.
+ *
+ * @param block - the frozen tool-call block (running or settled).
+ * @returns the presented model, or `undefined` when the block is not a settled
+ *   image_generate result.
+ */
+export function presentDrawResult(block) {
+    if (!('kind' in block) || block.kind !== 'tool-result' || block.isError)
+        return undefined;
+    if (block.call?.name !== 'image_generate')
+        return undefined;
+    const value = block.meta ?? {};
+    const images = [];
+    if (Array.isArray(value.images)) {
+        for (const raw of value.images) {
+            const image = raw;
+            if (typeof image?.attachmentId === 'string') {
+                images.push({ attachmentId: image.attachmentId, name: typeof image.name === 'string' ? image.name : 'image' });
+            }
+        }
+    }
+    const quota = (value.quota ?? {});
+    const limits = (value.limits ?? {});
+    let args;
+    if (block.call?.argsRaw !== undefined && block.call.argsRaw !== '') {
+        try {
+            const parsed = JSON.parse(block.call.argsRaw);
+            args = typeof parsed === 'object' && parsed !== null ? parsed : undefined;
+        }
+        catch {
+            args = undefined;
+        }
+    }
+    return {
+        engine: typeof value.engine === 'string' ? value.engine : 'unknown',
+        model: typeof value.model === 'string' ? value.model : 'unknown',
+        fallbackUsed: value.fallbackUsed === true,
+        images,
+        quota: {
+            generations: typeof quota.generations === 'number' ? quota.generations : 0,
+            bytes: typeof quota.bytes === 'number' ? quota.bytes : 0,
+        },
+        limits: {
+            maxGenerations: typeof limits.maxGenerations === 'number' ? limits.maxGenerations : 0,
+            maxBytes: typeof limits.maxBytes === 'number' ? limits.maxBytes : 0,
+        },
+        args,
+    };
+}
+/**
+ * Project the panel snapshot onto the settings row model.
+ *
+ * @param snapshot - the `draw/status` wire snapshot.
+ * @returns the presented panel model.
+ */
+export function presentDrawPanel(snapshot) {
+    return {
+        pluginVersion: snapshot.pluginVersion,
+        engines: snapshot.engines.map(engine => ({
+            id: engine.id,
+            model: engine.model,
+            baseUrl: engine.baseUrl,
+            apiKeyRef: engine.apiKeyRef,
+            enabled: engine.enabled,
+            preferred: engine.preferred,
+            credentialConfigured: engine.credential.configured,
+            ...(engine.credential.source !== undefined ? { credentialSource: engine.credential.source } : {}),
+            credentialWritable: engine.credential.writable,
+            consecutiveFailures: engine.health.consecutiveFailures,
+            coolingDown: engine.health.cooldownUntil !== null && engine.health.cooldownUntil > Date.now(),
+            lastError: engine.health.lastError,
+        })),
+        quota: { maxGenerationsPerSession: snapshot.quota.maxGenerationsPerSession, maxBytesPerSession: snapshot.quota.maxBytesPerSession },
+        requestTimeoutMs: snapshot.requestTimeoutMs,
+        maxImagesPerCall: snapshot.maxImagesPerCall,
+    };
+}

package/lib/types/client/remote.d.ts

@@ -0,0 +1,268 @@
+/**
+ * The client-side Remote face of the `draw` namespace: the hand-written
+ * `TypertRemoteContribution` mounted through `ctx.remote.$mount`, plus the
+ * declaration merging that types `ctx.remote.draw`. The descriptor list is
+ * shared with the host `./typert` manifest (`../wire.ts`), so the two faces
+ * can never drift.
+ *
+ * @module dsh-draw/client/remote
+ */
+import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
+import type { CredentialActionResult, DrawProbeResult, DrawRegenerateResult, DrawStatusSnapshot } from '../wire.ts';
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface TypertRemoteNamespace$draw {
+        /** Read the panel snapshot (engines, health, credentials, quota). */
+        status: () => Promise<RemoteResult<DrawStatusSnapshot>>;
+        /** Probe one engine's connectivity. */
+        probe: (engineId: string) => Promise<RemoteResult<DrawProbeResult>>;
+        /** Store one API key under the engine's credential reference. */
+        setCredential: (engineId: string, value: string) => Promise<RemoteResult<CredentialActionResult>>;
+        /** Remove a stored API key. */
+        unsetCredential: (engineId: string) => Promise<RemoteResult<CredentialActionResult>>;
+        /** Re-run a generation from the result card (full drawer path). */
+        regenerate: (sessionId: string, args: Record<string, unknown>) => Promise<RemoteResult<DrawRegenerateResult>>;
+    }
+    interface TypertRemoteMap {
+        'draw/status': () => Promise<RemoteResult<DrawStatusSnapshot>>;
+        'draw/probe': (engineId: string) => Promise<RemoteResult<DrawProbeResult>>;
+        'draw/setCredential': (engineId: string, value: string) => Promise<RemoteResult<CredentialActionResult>>;
+        'draw/unsetCredential': (engineId: string) => Promise<RemoteResult<CredentialActionResult>>;
+        'draw/regenerate': (sessionId: string, args: Record<string, unknown>) => Promise<RemoteResult<DrawRegenerateResult>>;
+    }
+    interface TypertRemoteNamespaceMap {
+        draw: TypertRemoteNamespace$draw;
+    }
+}
+/** The client Remote contribution for the `draw` namespace. */
+export declare const DRAW_REMOTE: Readonly<{
+    package: string;
+    descriptors: readonly (Readonly<{
+        readonly id: 'dsh-draw#draw/status';
+        readonly service: 'dsh-draw';
+        readonly namespace: 'draw';
+        readonly method: 'status';
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly never[];
+        readonly result: Readonly<{
+            mode: "strict";
+            typeSymbol: "dsh-draw/types#DrawStatusSnapshot";
+            schema: import("zod").ZodObject<{
+                pluginVersion: import("zod").ZodString;
+                engines: import("zod").ZodArray<import("zod").ZodObject<{
+                    id: import("zod").ZodString;
+                    model: import("zod").ZodString;
+                    baseUrl: import("zod").ZodString;
+                    apiKeyRef: import("zod").ZodString;
+                    enabled: import("zod").ZodBoolean;
+                    preferred: import("zod").ZodBoolean;
+                    credential: import("zod").ZodObject<{
+                        configured: import("zod").ZodBoolean;
+                        source: import("zod").ZodOptional<import("zod").ZodString>;
+                        writable: import("zod").ZodBoolean;
+                    }, import("zod/v4/core").$strip>;
+                    health: import("zod").ZodObject<{
+                        consecutiveFailures: import("zod").ZodNumber;
+                        cooldownUntil: import("zod").ZodNullable<import("zod").ZodNumber>;
+                        lastError: import("zod").ZodNullable<import("zod").ZodString>;
+                        lastStatus: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    }, import("zod/v4/core").$strip>;
+                }, import("zod/v4/core").$strip>>;
+                quota: import("zod").ZodObject<{
+                    maxGenerationsPerSession: import("zod").ZodNumber;
+                    maxBytesPerSession: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>;
+                requestTimeoutMs: import("zod").ZodNumber;
+                maxImagesPerCall: import("zod").ZodNumber;
+            }, import("zod/v4/core").$strip>;
+        }>;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: 'dsh-draw#draw/probe';
+        readonly service: 'dsh-draw';
+        readonly namespace: 'draw';
+        readonly method: 'probe';
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly Readonly<{
+            name: string;
+            wire: string;
+            source: "json";
+            codec: Readonly<{
+                mode: "strict";
+                typeSymbol: "dsh-draw/types#EngineId";
+                schema: import("zod").ZodString;
+            }>;
+        }>[];
+        readonly result: Readonly<{
+            mode: "strict";
+            typeSymbol: "dsh-draw/types#DrawProbeResult";
+            schema: import("zod").ZodObject<{
+                engineId: import("zod").ZodString;
+                reachable: import("zod").ZodBoolean;
+                httpStatus: import("zod").ZodNullable<import("zod").ZodNumber>;
+                target: import("zod").ZodString;
+                note: import("zod").ZodString;
+                credentialConfigured: import("zod").ZodBoolean;
+            }, import("zod/v4/core").$strip>;
+        }>;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: 'dsh-draw#draw/setCredential';
+        readonly service: 'dsh-draw';
+        readonly namespace: 'draw';
+        readonly method: 'setCredential';
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly (Readonly<{
+            name: string;
+            wire: string;
+            source: "json";
+            codec: Readonly<{
+                mode: "strict";
+                typeSymbol: "dsh-draw/types#EngineId";
+                schema: import("zod").ZodString;
+            }>;
+        }> | Readonly<{
+            name: string;
+            wire: string;
+            source: "json";
+            codec: Readonly<{
+                mode: "strict";
+                typeSymbol: "dsh-draw/types#CredentialValue";
+                schema: import("zod").ZodString;
+            }>;
+        }>)[];
+        readonly result: Readonly<{
+            mode: "strict";
+            typeSymbol: "dsh-draw/types#CredentialActionResult";
+            schema: import("zod").ZodObject<{
+                engineId: import("zod").ZodString;
+                reference: import("zod").ZodString;
+                note: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>;
+        }>;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: 'dsh-draw#draw/unsetCredential';
+        readonly service: 'dsh-draw';
+        readonly namespace: 'draw';
+        readonly method: 'unsetCredential';
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly Readonly<{
+            name: string;
+            wire: string;
+            source: "json";
+            codec: Readonly<{
+                mode: "strict";
+                typeSymbol: "dsh-draw/types#EngineId";
+                schema: import("zod").ZodString;
+            }>;
+        }>[];
+        readonly result: Readonly<{
+            mode: "strict";
+            typeSymbol: "dsh-draw/types#CredentialActionResult";
+            schema: import("zod").ZodObject<{
+                engineId: import("zod").ZodString;
+                reference: import("zod").ZodString;
+                note: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>;
+        }>;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }> | Readonly<{
+        readonly id: 'dsh-draw#draw/regenerate';
+        readonly service: 'dsh-draw';
+        readonly namespace: 'draw';
+        readonly method: 'regenerate';
+        readonly invocation: Readonly<{
+            kind: "direct";
+        }>;
+        readonly parameters: readonly (Readonly<{
+            name: string;
+            wire: string;
+            source: "json";
+            codec: Readonly<{
+                mode: "strict";
+                typeSymbol: "dsh-draw/types#SessionId";
+                schema: import("zod").ZodString;
+            }>;
+        }> | Readonly<{
+            name: string;
+            wire: string;
+            source: "json";
+            codec: Readonly<{
+                mode: "strict";
+                typeSymbol: "dsh-draw/types#RegenerateArgs";
+                schema: import("zod").ZodObject<{
+                    prompt: import("zod").ZodString;
+                    size: import("zod").ZodOptional<import("zod").ZodString>;
+                    count: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    quality: import("zod").ZodOptional<import("zod").ZodString>;
+                    style: import("zod").ZodOptional<import("zod").ZodString>;
+                    engine: import("zod").ZodOptional<import("zod").ZodString>;
+                }, import("zod/v4/core").$loose>;
+            }>;
+        }>)[];
+        readonly result: Readonly<{
+            mode: "strict";
+            typeSymbol: "dsh-draw/types#DrawRegenerateResult";
+            schema: import("zod").ZodObject<{
+                engine: import("zod").ZodString;
+                model: import("zod").ZodString;
+                size: import("zod").ZodString;
+                images: import("zod").ZodArray<import("zod").ZodObject<{
+                    attachmentId: import("zod").ZodString;
+                    mediaType: import("zod").ZodString;
+                    bytes: import("zod").ZodNumber;
+                    width: import("zod").ZodNumber;
+                    height: import("zod").ZodNumber;
+                    name: import("zod").ZodOptional<import("zod").ZodString>;
+                }, import("zod/v4/core").$strip>>;
+                quota: import("zod").ZodObject<{
+                    generations: import("zod").ZodNumber;
+                    bytes: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>;
+                quotaLimits: import("zod").ZodObject<{
+                    maxGenerations: import("zod").ZodNumber;
+                    maxBytes: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>;
+                fallbackUsed: import("zod").ZodBoolean;
+                elapsedMs: import("zod").ZodNumber;
+                attempts: import("zod").ZodArray<import("zod").ZodObject<{
+                    engine: import("zod").ZodString;
+                    phase: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"credential">, import("zod").ZodLiteral<"request">, import("zod").ZodLiteral<"parse">]>>;
+                    code: import("zod").ZodString;
+                    message: import("zod").ZodOptional<import("zod").ZodString>;
+                    status: import("zod").ZodOptional<import("zod").ZodNumber>;
+                }, import("zod/v4/core").$strip>>;
+            }, import("zod/v4/core").$strip>;
+        }>;
+        readonly sourceLocation: Readonly<{
+            file: "src/wire.ts";
+            line: 1;
+            column: 1;
+        }>;
+    }>)[];
+}>;
+//# sourceMappingURL=remote.d.ts.map

package/lib/types/client/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../../src/client/remote.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAA4B,MAAM,kCAAkC,CAAA;AAE9F,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEnH,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,0BAA0B;QAClC,qEAAqE;QACrE,MAAM,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAA;QACvD,uCAAuC;QACvC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAA;QACnE,iEAAiE;QACjE,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC,CAAA;QACjG,+BAA+B;QAC/B,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC,CAAA;QACpF,mEAAmE;QACnE,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC,CAAA;KAC9G;IACD,UAAU,eAAe;QACvB,aAAa,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAA;QAC9D,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAA;QAC1E,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC,CAAA;QACxG,sBAAsB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC,CAAA;QAC3F,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC,CAAA;KACrH;IACD,UAAU,wBAAwB;QAChC,IAAI,EAAE,0BAA0B,CAAA;KACjC;CACF;AAED,+DAA+D;AAC/D,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGa,CAAA"}

package/lib/types/client/remote.js

@@ -0,0 +1,15 @@
+/**
+ * The client-side Remote face of the `draw` namespace: the hand-written
+ * `TypertRemoteContribution` mounted through `ctx.remote.$mount`, plus the
+ * declaration merging that types `ctx.remote.draw`. The descriptor list is
+ * shared with the host `./typert` manifest (`../wire.ts`), so the two faces
+ * can never drift.
+ *
+ * @module dsh-draw/client/remote
+ */
+import { DRAW_INVOCATIONS } from '../wire.js';
+/** The client Remote contribution for the `draw` namespace. */
+export const DRAW_REMOTE = Object.freeze({
+    package: 'dsh-draw',
+    descriptors: DRAW_INVOCATIONS,
+});

package/lib/types/client/styles.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Scoped inline stylesheet for the dsh-draw browser half. Standalone client
+ * bundles cannot use the in-repo CSS-module pipeline, so the styles live in
+ * one scoped `style` element; every class carries the `dshdraw-` prefix and
+ * the root node is the only position the stylesheet may leak from.
+ *
+ * @module dsh-draw/client/styles
+ */
+/** Install the scoped stylesheet once; returns the removal disposer. */
+export declare function installDrawStyles(): () => void;
+//# sourceMappingURL=styles.d.ts.map

package/lib/types/client/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/client/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,wEAAwE;AACxE,wBAAgB,iBAAiB,IAAI,MAAM,IAAI,CA+B9C"}

package/lib/types/client/styles.js

@@ -0,0 +1,43 @@
+/**
+ * Scoped inline stylesheet for the dsh-draw browser half. Standalone client
+ * bundles cannot use the in-repo CSS-module pipeline, so the styles live in
+ * one scoped `style` element; every class carries the `dshdraw-` prefix and
+ * the root node is the only position the stylesheet may leak from.
+ *
+ * @module dsh-draw/client/styles
+ */
+const STYLE_ID = 'dsh-draw-client-styles';
+/** Install the scoped stylesheet once; returns the removal disposer. */
+export function installDrawStyles() {
+    if (document.getElementById(STYLE_ID) !== null)
+        return () => undefined;
+    const style = document.createElement('style');
+    style.id = STYLE_ID;
+    style.textContent = `
+.dshdraw-card { display: flex; flex-direction: column; gap: 8px; padding: 4px 0; }
+.dshdraw-grid { display: flex; flex-wrap: wrap; gap: 8px; }
+.dshdraw-figure { display: flex; flex-direction: column; gap: 4px; max-width: 320px; }
+.dshdraw-figure img { max-width: 100%; border-radius: 6px; border: 1px solid var(--dsh-border, #d0d7de); }
+.dshdraw-figure figcaption { font-size: 11px; opacity: 0.75; overflow-wrap: anywhere; }
+.dshdraw-meta { font-size: 12px; opacity: 0.85; display: flex; flex-wrap: wrap; gap: 12px; }
+.dshdraw-actions { display: flex; gap: 8px; }
+.dshdraw-button {
+  border: 1px solid var(--dsh-border, #d0d7de); border-radius: 6px; background: transparent;
+  padding: 3px 10px; font-size: 12px; cursor: pointer; color: inherit;
+}
+.dshdraw-button:hover { background: var(--dsh-hover, rgba(0, 0, 0, 0.05)); }
+.dshdraw-panel { display: flex; flex-direction: column; gap: 14px; }
+.dshdraw-engine { border: 1px solid var(--dsh-border, #d0d7de); border-radius: 8px; padding: 10px 12px; display: flex; flex-direction: column; gap: 6px; }
+.dshdraw-engine h4 { margin: 0; }
+.dshdraw-row { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; font-size: 12px; }
+.dshdraw-row label { opacity: 0.8; min-width: 110px; }
+.dshdraw-badge { border-radius: 999px; padding: 1px 8px; font-size: 11px; border: 1px solid var(--dsh-border, #d0d7de); }
+.dshdraw-badge.ok { color: #1a7f37; border-color: #1a7f37; }
+.dshdraw-badge.warn { color: #9a6700; border-color: #9a6700; }
+.dshdraw-input { flex: 1; min-width: 180px; border: 1px solid var(--dsh-border, #d0d7de); border-radius: 6px; padding: 4px 8px; font-size: 12px; background: transparent; color: inherit; }
+`;
+    document.head.append(style);
+    return () => {
+        style.remove();
+    };
+}

package/lib/types/config.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Plugin configuration for `dsh-draw` and its explicit resolve step.
+ * `resolveConfig` re-judges every default and bound so programmatic
+ * construction that bypasses Schemastery normalization still fails loud
+ * instead of running with hidden defaults (the explicit-resolve contract).
+ *
+ * @module dsh-draw/config
+ */
+import z from '@deepseek-ai/schemastery';
+import type { ImageMediaType } from '@deepseek-ai/dsh-attachment';
+/** Default per-generation HTTP timeout in milliseconds. */
+export declare const DEFAULT_REQUEST_TIMEOUT_MS = 120000;
+/** Ceiling for one generation call: engines can take minutes per image. */
+export declare const MAX_REQUEST_TIMEOUT_MS = 600000;
+/** Default cap on images a single call may produce. */
+export declare const DEFAULT_MAX_IMAGES_PER_CALL = 4;
+/** Ceiling on images a single call may produce. */
+export declare const MAX_IMAGES_PER_CALL = 10;
+/** Default prompt length cap (characters). */
+export declare const DEFAULT_MAX_PROMPT_LENGTH = 4000;
+/** Ceiling on the prompt length cap. */
+export declare const MAX_PROMPT_LENGTH = 32000;
+/** Default per-session generation-call cap. */
+export declare const DEFAULT_MAX_GENERATIONS_PER_SESSION = 200;
+/** Ceiling on the per-session generation-call cap. */
+export declare const MAX_GENERATIONS_PER_SESSION = 100000;
+/** Default per-session image-byte cap (200 MiB). */
+export declare const DEFAULT_MAX_BYTES_PER_SESSION: number;
+/** Ceiling on the per-session image-byte cap (4 GiB). */
+export declare const MAX_BYTES_PER_SESSION: number;
+/** Default consecutive failures before an engine enters cooldown. */
+export declare const DEFAULT_FAILURE_THRESHOLD = 2;
+/** Ceiling on the consecutive-failure threshold. */
+export declare const MAX_FAILURE_THRESHOLD = 10;
+/** Default engine cooldown after the failure threshold trips (ms). */
+export declare const DEFAULT_COOLDOWN_MS = 60000;
+/** Ceiling on the engine cooldown. */
+export declare const MAX_COOLDOWN_MS = 3600000;
+/** Standard size vocabulary mapped per engine through {@link EngineConfig.sizeMap}. */
+export type StandardSize = 'square' | 'landscape' | 'portrait' | 'auto';
+/** Per-engine mapping from the standard size vocabulary to concrete engine sizes. */
+export interface EngineSizeMap {
+    /** Square composition (the default). */
+    square: string;
+    /** Wider-than-tall composition. */
+    landscape: string;
+    /** Taller-than-wide composition. */
+    portrait: string;
+    /** Engine-chosen composition; may alias one of the concrete sizes. */
+    auto: string;
+}
+/** Whether generated images arrive as base64 payloads or downloadable URLs. */
+export type EngineResponseFormat = 'b64_json' | 'url';
+/** One OpenAI-compatible image-generation endpoint the router may use. */
+export interface EngineConfig {
+    /** Stable engine id used in tool args, results, and the settings panel. */
+    id: string;
+    /** OpenAI-compatible API root, e.g. `https://api.openai.com/v1`; must not embed credentials. */
+    baseUrl: string;
+    /** Engine model name sent in the request body, e.g. `gpt-image-1`. */
+    model: string;
+    /** Credential reference (environment-variable name) the API key resolves from; never a literal key. */
+    apiKeyRef: string;
+    /** Whether the router may use this engine (default true). */
+    enabled?: boolean;
+    /** Standard-size → concrete-size translation (default: the OpenAI sizes). */
+    sizeMap?: EngineSizeMap;
+    /** Whether the engine accepts the `quality` request field (default false). */
+    qualitySupported?: boolean;
+    /** Whether the engine accepts the `style` request field (default false). */
+    styleSupported?: boolean;
+    /** How generated bytes arrive: base64 in the response or a URL to download (default `b64_json`). */
+    responseFormat?: EngineResponseFormat;
+    /** Declared media type of the bytes (default `image/png`). */
+    imageMediaType?: ImageMediaType;
+}
+/** Plugin configuration. */
+export interface Config {
+    /** Ordered engine chain; the router walks it top-down and falls back on failure. */
+    engines?: EngineConfig[];
+    /** Engine id the router prefers; defaults to the first configured engine. Must name a configured engine. */
+    defaultEngine?: string;
+    /** Per-generation HTTP timeout in milliseconds (default 120000). */
+    requestTimeoutMs?: number;
+    /** Cap on images one call may produce (default 4). */
+    maxImagesPerCall?: number;
+    /** Prompt length cap in characters (default 4000). */
+    maxPromptLength?: number;
+    /** Per-session generation-call cap (default 200). */
+    maxGenerationsPerSession?: number;
+    /** Per-session generated-image byte cap (default 209715200). */
+    maxBytesPerSession?: number;
+    /** Consecutive failures before an engine enters cooldown (default 2). */
+    failureThreshold?: number;
+    /** Engine cooldown in milliseconds after the failure threshold trips (default 60000). */
+    cooldownMs?: number;
+}
+/** The two shipped engine presets: OpenAI Images and Zhipu CogView. */
+export declare const DEFAULT_ENGINES: ReadonlyArray<Required<EngineConfig>>;
+/** Default size map for user-configured engines (the OpenAI vocabulary). */
+export declare const DEFAULT_SIZE_MAP: Readonly<EngineSizeMap>;
+/** Fully resolved per-engine configuration. */
+export interface ResolvedEngineConfig {
+    /** Stable engine id. */
+    id: string;
+    /** OpenAI-compatible API root without credentials. */
+    baseUrl: string;
+    /** Engine model name. */
+    model: string;
+    /** Credential reference the API key resolves from. */
+    apiKeyRef: string;
+    /** Whether the router may use this engine. */
+    enabled: boolean;
+    /** Standard-size → concrete-size translation. */
+    sizeMap: EngineSizeMap;
+    /** Whether the engine accepts the `quality` request field. */
+    qualitySupported: boolean;
+    /** Whether the engine accepts the `style` request field. */
+    styleSupported: boolean;
+    /** How generated bytes arrive. */
+    responseFormat: EngineResponseFormat;
+    /** Declared media type of the bytes. */
+    imageMediaType: ImageMediaType;
+}
+/** Fully resolved configuration captured at plugin load. */
+export interface ResolvedConfig {
+    /** Ordered engine chain. */
+    engines: readonly ResolvedEngineConfig[];
+    /** Engine id the router prefers. */
+    defaultEngine: string;
+    /** Per-generation HTTP timeout in milliseconds. */
+    requestTimeoutMs: number;
+    /** Cap on images one call may produce. */
+    maxImagesPerCall: number;
+    /** Prompt length cap in characters. */
+    maxPromptLength: number;
+    /** Per-session generation-call cap. */
+    maxGenerationsPerSession: number;
+    /** Per-session generated-image byte cap. */
+    maxBytesPerSession: number;
+    /** Consecutive failures before an engine enters cooldown. */
+    failureThreshold: number;
+    /** Engine cooldown in milliseconds after the failure threshold trips. */
+    cooldownMs: number;
+}
+/** Schemastery schema for loader-validated configuration. */
+export declare const Config: z<Config>;
+/**
+ * Resolve raw config to the runtime policy, re-validating defaults and bounds
+ * plus the cross-field facts a per-field schema cannot see (duplicate engine
+ * ids, credential-bearing base URLs, an unknown default engine).
+ *
+ * @param config - raw loader config; `undefined` for a bare row.
+ * @returns the frozen resolved config.
+ * @throws on any invalid value (fail-loud at load).
+ */
+export declare function resolveConfig(config: Config | undefined): ResolvedConfig;
+/** Engine id by which an engine is addressed, or `undefined` for an unknown id. */
+export declare function engineById(config: ResolvedConfig, id: string): ResolvedEngineConfig | undefined;
+//# sourceMappingURL=config.d.ts.map

package/lib/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAEjE,2DAA2D;AAC3D,eAAO,MAAM,0BAA0B,SAAU,CAAA;AAEjD,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,SAAU,CAAA;AAE7C,uDAAuD;AACvD,eAAO,MAAM,2BAA2B,IAAI,CAAA;AAE5C,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC,8CAA8C;AAC9C,eAAO,MAAM,yBAAyB,OAAQ,CAAA;AAE9C,wCAAwC;AACxC,eAAO,MAAM,iBAAiB,QAAS,CAAA;AAEvC,+CAA+C;AAC/C,eAAO,MAAM,mCAAmC,MAAM,CAAA;AAEtD,sDAAsD;AACtD,eAAO,MAAM,2BAA2B,SAAU,CAAA;AAElD,oDAAoD;AACpD,eAAO,MAAM,6BAA6B,QAAoB,CAAA;AAE9D,yDAAyD;AACzD,eAAO,MAAM,qBAAqB,QAAyB,CAAA;AAE3D,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,IAAI,CAAA;AAE1C,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,KAAK,CAAA;AAEvC,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,QAAS,CAAA;AAEzC,sCAAsC;AACtC,eAAO,MAAM,eAAe,UAAY,CAAA;AAExC,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAAA;AAEvE,qFAAqF;AACrF,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAA;CACb;AAED,+EAA+E;AAC/E,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,KAAK,CAAA;AAErD,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,EAAE,EAAE,MAAM,CAAA;IACV,gGAAgG;IAChG,OAAO,EAAE,MAAM,CAAA;IACf,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAA;IACb,uGAAuG;IACvG,SAAS,EAAE,MAAM,CAAA;IACjB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,4EAA4E;IAC5E,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,oGAAoG;IACpG,cAAc,CAAC,EAAE,oBAAoB,CAAA;IACrC,8DAA8D;IAC9D,cAAc,CAAC,EAAE,cAAc,CAAA;CAChC;AAED,4BAA4B;AAC5B,MAAM,WAAW,MAAM;IACrB,oFAAoF;IACpF,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;IACxB,4GAA4G;IAC5G,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qDAAqD;IACrD,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,uEAAuE;AACvE,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,QAAQ,CAAC,YAAY,CAAC,CAyBhE,CAAA;AAEF,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,aAAa,CAKnD,CAAA;AAEF,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAA;IACjB,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAA;IAChB,iDAAiD;IACjD,OAAO,EAAE,aAAa,CAAA;IACtB,8DAA8D;IAC9D,gBAAgB,EAAE,OAAO,CAAA;IACzB,4DAA4D;IAC5D,cAAc,EAAE,OAAO,CAAA;IACvB,kCAAkC;IAClC,cAAc,EAAE,oBAAoB,CAAA;IACpC,wCAAwC;IACxC,cAAc,EAAE,cAAc,CAAA;CAC/B;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAA;IACxC,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAA;IACrB,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,CAAA;IACxB,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,CAAA;IACxB,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAA;IACvB,uCAAuC;IACvC,wBAAwB,EAAE,MAAM,CAAA;IAChC,4CAA4C;IAC5C,kBAAkB,EAAE,MAAM,CAAA;IAC1B,6DAA6D;IAC7D,gBAAgB,EAAE,MAAM,CAAA;IACxB,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,6DAA6D;AAC7D,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CA0B3B,CAAA;AAOF;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CA6GxE;AAED,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAE/F"}