dsh-draw 0.1.0

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

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

package/lib/types/wire.js

@@ -0,0 +1,273 @@
+/**
+ * The panel's wire vocabulary: the snapshot and action types served over the
+ * `draw` Remote namespace, their zod v4 validation schemas (the strict codecs
+ * both Typert faces carry), and the invocation descriptors shared verbatim by
+ * the host `./typert` manifest and the client Remote contribution. One
+ * canonical source for both faces keeps the host and client codecs from ever
+ * drifting apart.
+ *
+ * @module dsh-draw/wire
+ */
+import { z } from 'zod';
+/** Strict wire schema for {@link DrawStatusSnapshot} (zod v4, both Typert faces). */
+export const DRAW_STATUS_SCHEMA = z.object({
+    pluginVersion: z.string(),
+    engines: z.array(z.object({
+        id: z.string(),
+        model: z.string(),
+        baseUrl: z.string(),
+        apiKeyRef: z.string(),
+        enabled: z.boolean(),
+        preferred: z.boolean(),
+        credential: z.object({
+            configured: z.boolean(),
+            source: z.string().optional(),
+            writable: z.boolean(),
+        }),
+        health: z.object({
+            consecutiveFailures: z.number().int(),
+            cooldownUntil: z.number().int().nullable(),
+            lastError: z.string().nullable(),
+            lastStatus: z.number().int().nullable(),
+        }),
+    })),
+    quota: z.object({
+        maxGenerationsPerSession: z.number().int(),
+        maxBytesPerSession: z.number().int(),
+    }),
+    requestTimeoutMs: z.number().int(),
+    maxImagesPerCall: z.number().int(),
+});
+/** Strict wire schema for {@link DrawProbeResult}. */
+export const DRAW_PROBE_SCHEMA = z.object({
+    engineId: z.string(),
+    reachable: z.boolean(),
+    httpStatus: z.number().int().nullable(),
+    target: z.string(),
+    note: z.string(),
+    credentialConfigured: z.boolean(),
+});
+/** Strict wire schema for {@link CredentialActionResult}. */
+export const CREDENTIAL_ACTION_SCHEMA = z.object({
+    engineId: z.string(),
+    reference: z.string(),
+    note: z.string(),
+});
+/** Strict wire schema for {@link DrawRegenerateResult}. */
+export const DRAW_REGENERATE_SCHEMA = z.object({
+    engine: z.string(),
+    model: z.string(),
+    size: z.string(),
+    images: z.array(z.object({
+        attachmentId: z.string(),
+        mediaType: z.string(),
+        bytes: z.number().int(),
+        width: z.number().int(),
+        height: z.number().int(),
+        name: z.string().optional(),
+    })),
+    quota: z.object({ generations: z.number().int(), bytes: z.number().int() }),
+    quotaLimits: z.object({ maxGenerations: z.number().int(), maxBytes: z.number().int() }),
+    fallbackUsed: z.boolean(),
+    elapsedMs: z.number().int(),
+    attempts: z.array(z.object({
+        engine: z.string(),
+        phase: z.union([z.literal('credential'), z.literal('request'), z.literal('parse')]).optional(),
+        code: z.string(),
+        message: z.string().optional(),
+        status: z.number().int().optional(),
+    })),
+});
+/** Project a draw outcome image onto the wire shape. */
+export function imageToWire(image) {
+    return {
+        attachmentId: image.attachmentId,
+        mediaType: image.mediaType,
+        bytes: image.bytes,
+        width: image.width,
+        height: image.height,
+        ...(image.name !== undefined ? { name: image.name } : {}),
+    };
+}
+/** Project a router engine status onto the panel view shape. */
+export function statusToView(status, engine, credential) {
+    return {
+        id: engine.id,
+        model: engine.model,
+        baseUrl: engine.baseUrl,
+        apiKeyRef: engine.apiKeyRef,
+        enabled: engine.enabled,
+        preferred: engine.preferred,
+        credential,
+        health: {
+            consecutiveFailures: status.consecutiveFailures,
+            cooldownUntil: status.cooldownUntil,
+            lastError: status.lastError,
+            lastStatus: status.lastStatus,
+        },
+    };
+}
+/** Project a probe outcome onto the wire shape. */
+export function probeToWire(probe) {
+    return {
+        engineId: probe.engineId,
+        reachable: probe.reachable,
+        httpStatus: probe.httpStatus,
+        target: probe.target,
+        note: probe.note,
+        credentialConfigured: probe.credentialConfigured,
+    };
+}
+/** JSON codec for one engine id. */
+const ENGINE_ID_CODEC = z.string();
+/** JSON codec for one credential value (non-empty). */
+const CREDENTIAL_VALUE_CODEC = z.string().min(1);
+/** JSON codec for regenerate arguments: the original tool args, verbatim. */
+const REGENERATE_ARGS_CODEC = z.object({
+    prompt: z.string().min(1),
+    size: z.string().optional(),
+    count: z.number().int().optional(),
+    quality: z.string().optional(),
+    style: z.string().optional(),
+    engine: z.string().optional(),
+}).passthrough();
+/** JSON codec for one session id (the wire carries the branded id as a string). */
+const SESSION_ID_CODEC = z.string().min(1);
+/**
+ * The `draw/status` invocation descriptor: the settings-panel snapshot.
+ */
+export const DRAW_STATUS_DESCRIPTOR = Object.freeze({
+    id: 'dsh-draw#draw/status',
+    service: 'dsh-draw',
+    namespace: 'draw',
+    method: 'status',
+    invocation: Object.freeze({ kind: 'direct' }),
+    parameters: Object.freeze([]),
+    result: Object.freeze({
+        mode: 'strict',
+        typeSymbol: 'dsh-draw/types#DrawStatusSnapshot',
+        schema: DRAW_STATUS_SCHEMA,
+    }),
+    sourceLocation: Object.freeze({ file: 'src/wire.ts', line: 1, column: 1 }),
+});
+/**
+ * The `draw/probe` invocation descriptor: one engine's connectivity check.
+ */
+export const DRAW_PROBE_DESCRIPTOR = Object.freeze({
+    id: 'dsh-draw#draw/probe',
+    service: 'dsh-draw',
+    namespace: 'draw',
+    method: 'probe',
+    invocation: Object.freeze({ kind: 'direct' }),
+    parameters: Object.freeze([Object.freeze({
+            name: 'engineId',
+            wire: 'engineId',
+            source: 'json',
+            codec: Object.freeze({
+                mode: 'strict',
+                typeSymbol: 'dsh-draw/types#EngineId',
+                schema: ENGINE_ID_CODEC,
+            }),
+        })]),
+    result: Object.freeze({
+        mode: 'strict',
+        typeSymbol: 'dsh-draw/types#DrawProbeResult',
+        schema: DRAW_PROBE_SCHEMA,
+    }),
+    sourceLocation: Object.freeze({ file: 'src/wire.ts', line: 1, column: 1 }),
+});
+/**
+ * The `draw/setCredential` invocation descriptor: store an API key under the
+ * engine's credential reference. The value crosses the wire once and is never
+ * logged, snapshotted, or returned.
+ */
+export const DRAW_SET_CREDENTIAL_DESCRIPTOR = Object.freeze({
+    id: 'dsh-draw#draw/setCredential',
+    service: 'dsh-draw',
+    namespace: 'draw',
+    method: 'setCredential',
+    invocation: Object.freeze({ kind: 'direct' }),
+    parameters: Object.freeze([
+        Object.freeze({
+            name: 'engineId',
+            wire: 'engineId',
+            source: 'json',
+            codec: Object.freeze({ mode: 'strict', typeSymbol: 'dsh-draw/types#EngineId', schema: ENGINE_ID_CODEC }),
+        }),
+        Object.freeze({
+            name: 'value',
+            wire: 'value',
+            source: 'json',
+            codec: Object.freeze({ mode: 'strict', typeSymbol: 'dsh-draw/types#CredentialValue', schema: CREDENTIAL_VALUE_CODEC }),
+        }),
+    ]),
+    result: Object.freeze({
+        mode: 'strict',
+        typeSymbol: 'dsh-draw/types#CredentialActionResult',
+        schema: CREDENTIAL_ACTION_SCHEMA,
+    }),
+    sourceLocation: Object.freeze({ file: 'src/wire.ts', line: 1, column: 1 }),
+});
+/**
+ * The `draw/unsetCredential` invocation descriptor: remove a stored API key.
+ */
+export const DRAW_UNSET_CREDENTIAL_DESCRIPTOR = Object.freeze({
+    id: 'dsh-draw#draw/unsetCredential',
+    service: 'dsh-draw',
+    namespace: 'draw',
+    method: 'unsetCredential',
+    invocation: Object.freeze({ kind: 'direct' }),
+    parameters: Object.freeze([Object.freeze({
+            name: 'engineId',
+            wire: 'engineId',
+            source: 'json',
+            codec: Object.freeze({ mode: 'strict', typeSymbol: 'dsh-draw/types#EngineId', schema: ENGINE_ID_CODEC }),
+        })]),
+    result: Object.freeze({
+        mode: 'strict',
+        typeSymbol: 'dsh-draw/types#CredentialActionResult',
+        schema: CREDENTIAL_ACTION_SCHEMA,
+    }),
+    sourceLocation: Object.freeze({ file: 'src/wire.ts', line: 1, column: 1 }),
+});
+/**
+ * The `draw/regenerate` invocation descriptor: re-run a generation from the
+ * result card with the original tool args. The host re-runs the full drawer
+ * path (quota, routing, attachment storage, audit event) so a regenerate is
+ * as durable and accounted as a tool call.
+ */
+export const DRAW_REGENERATE_DESCRIPTOR = Object.freeze({
+    id: 'dsh-draw#draw/regenerate',
+    service: 'dsh-draw',
+    namespace: 'draw',
+    method: 'regenerate',
+    invocation: Object.freeze({ kind: 'direct' }),
+    parameters: Object.freeze([
+        Object.freeze({
+            name: 'sessionId',
+            wire: 'sessionId',
+            source: 'json',
+            codec: Object.freeze({ mode: 'strict', typeSymbol: 'dsh-draw/types#SessionId', schema: SESSION_ID_CODEC }),
+        }),
+        Object.freeze({
+            name: 'args',
+            wire: 'args',
+            source: 'json',
+            codec: Object.freeze({ mode: 'strict', typeSymbol: 'dsh-draw/types#RegenerateArgs', schema: REGENERATE_ARGS_CODEC }),
+        }),
+    ]),
+    result: Object.freeze({
+        mode: 'strict',
+        typeSymbol: 'dsh-draw/types#DrawRegenerateResult',
+        schema: DRAW_REGENERATE_SCHEMA,
+    }),
+    sourceLocation: Object.freeze({ file: 'src/wire.ts', line: 1, column: 1 }),
+});
+/** The canonical invocation list both Typert faces register. */
+export const DRAW_INVOCATIONS = Object.freeze([
+    DRAW_STATUS_DESCRIPTOR,
+    DRAW_PROBE_DESCRIPTOR,
+    DRAW_SET_CREDENTIAL_DESCRIPTOR,
+    DRAW_UNSET_CREDENTIAL_DESCRIPTOR,
+    DRAW_REGENERATE_DESCRIPTOR,
+]);