@xrkseek/harness 0.3.11 → 0.4.0-rc.2

package/node_modules/@xrkseek/exec-fs/dist/paths.js

@@ -1,3 +1,4 @@
+import { lstatSync, realpathSync } from "node:fs";
 import path from "node:path";
 export class PathEscapeError extends Error {
     constructor(message) {
@@ -5,6 +6,14 @@ export class PathEscapeError extends Error {
         this.name = "PathEscapeError";
     }
 }
+/** True when `candidate` is `root` or a descendant (lexical, after resolve). */
+export function isLexicallyInside(root, candidate) {
+    const rootAbs = path.resolve(root);
+    const candAbs = path.resolve(candidate);
+    const rel = path.relative(rootAbs, candAbs);
+    return (rel === "" ||
+        (rel !== ".." && !rel.startsWith(`..${path.sep}`) && !path.isAbsolute(rel)));
+}
 /**
  * Resolve a user path under `root`. Relative paths join the root; absolute
  * paths are allowed only when they still land inside the root (DSH / Codex).
@@ -14,10 +23,100 @@ export function resolveWithinRoot(root, userPath) {
     const targetAbs = path.isAbsolute(userPath)
         ? path.resolve(userPath)
         : path.resolve(rootAbs, userPath);
-    const rel = path.relative(rootAbs, targetAbs);
-    if (rel === ".." || rel.startsWith(`..${path.sep}`) || path.isAbsolute(rel)) {
+    if (!isLexicallyInside(rootAbs, targetAbs)) {
         throw new PathEscapeError(`path escapes workspace root: ${userPath}`);
     }
     return targetAbs;
 }
+/**
+ * Realpath of the deepest existing ancestor of `abs` (the path itself when
+ * present). Used so a symlink under a host root cannot point at sibling home
+ * files outside that root.
+ */
+function realpathExisting(abs) {
+    let cur = path.resolve(abs);
+    for (;;) {
+        try {
+            return realpathSync(cur);
+        }
+        catch (err) {
+            const code = err && typeof err === "object" && "code" in err
+                ? String(err.code)
+                : "";
+            if (code !== "ENOENT") {
+                throw err;
+            }
+            const parent = path.dirname(cur);
+            if (parent === cur) {
+                throw new PathEscapeError(`path not resolvable: ${abs}`);
+            }
+            cur = parent;
+        }
+    }
+}
+/**
+ * Absolute path allowed only when it stays under one of `hostRoots`
+ * lexically **and** after symlink resolution (Codex/DSH readable-root posture).
+ * Prevents `~/.xrk/spill/…` → symlink → sibling home files
+ * (`host-settings.json`, credentials, …).
+ */
+export function resolveUnderHostRoots(hostRoots, userPath) {
+    if (!path.isAbsolute(userPath)) {
+        throw new PathEscapeError(`host-readable path must be absolute: ${userPath}`);
+    }
+    const abs = path.resolve(userPath);
+    let matchedRoot;
+    for (const hostRoot of hostRoots) {
+        const hostAbs = path.resolve(hostRoot);
+        if (isLexicallyInside(hostAbs, abs)) {
+            matchedRoot = hostAbs;
+            break;
+        }
+    }
+    if (matchedRoot === undefined) {
+        throw new PathEscapeError(`path escapes host-readable roots: ${userPath}`);
+    }
+    let realRoot;
+    try {
+        realRoot = realpathSync(matchedRoot);
+    }
+    catch {
+        // Root not created yet — lexical match is enough until first write.
+        return abs;
+    }
+    let realTarget;
+    try {
+        realTarget = realpathExisting(abs);
+    }
+    catch (err) {
+        if (err instanceof PathEscapeError)
+            throw err;
+        throw new PathEscapeError(`path escapes host-readable roots: ${userPath}`);
+    }
+    if (!isLexicallyInside(realRoot, realTarget)) {
+        throw new PathEscapeError(`path escapes host-readable roots via symlink: ${userPath}`);
+    }
+    // Refuse symlinks whose resolved target leaves the root (incl. dangling).
+    try {
+        const st = lstatSync(abs);
+        if (st.isSymbolicLink()) {
+            let linked;
+            try {
+                linked = realpathSync(abs);
+            }
+            catch {
+                throw new PathEscapeError(`path escapes host-readable roots via symlink: ${userPath}`);
+            }
+            if (!isLexicallyInside(realRoot, linked)) {
+                throw new PathEscapeError(`path escapes host-readable roots via symlink: ${userPath}`);
+            }
+        }
+    }
+    catch (err) {
+        if (err instanceof PathEscapeError)
+            throw err;
+        // ENOENT — file not created yet; lexical + ancestor realpath already checked.
+    }
+    return abs;
+}
 //# sourceMappingURL=paths.js.map

package/node_modules/@xrkseek/exec-fs/dist/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,QAAgB;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QACzC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACxB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC9C,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,eAAe,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/exec-image-gen/README.md

@@ -0,0 +1,11 @@
+# @xrkseek/exec-image-gen
+
+Text-to-image Provider seam for the model tool surface.
+
+- **Definition**: `ImageGenService.generate`
+- **Provider**: `createMemoryImageGenProvider` · `createOpenAiImageGenProvider` · Host-injected
+- **Consumer**: `createImageGenTools` → `image_generate`
+
+Env: `XRK_IMAGE_GEN=memory` | `XRK_IMAGE_GEN=1` + `OPENAI_API_KEY` / `XRK_IMAGE_GEN_OPENAI_KEY`.
+
+See [docs/image-gen.md](../../../docs/image-gen.md) · [docs/seams.md](../../../docs/seams.md).

package/node_modules/@xrkseek/exec-image-gen/dist/format.d.ts

@@ -0,0 +1,2 @@
+export declare const IMAGE_GEN_PROMPT_TEXT: string;
+//# sourceMappingURL=format.d.ts.map

package/node_modules/@xrkseek/exec-image-gen/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,QAKtB,CAAC"}

package/node_modules/@xrkseek/exec-image-gen/dist/format.js

@@ -0,0 +1,7 @@
+export const IMAGE_GEN_PROMPT_TEXT = [
+    "Image generation:",
+    "- Use `image_generate` for text-to-image. Put a complete visual prompt in `prompt` (subject, style, composition).",
+    "- Optional `size` (e.g. 1024x1024) and `n`. Returns PNG bytes as base64; when AttachmentStore is wired, also an attachment id.",
+    "- Without `XRK_IMAGE_GEN=1` (OpenAI key) or `XRK_IMAGE_GEN=memory`, the tool stays visible and fails honestly.",
+].join("\n");
+//# sourceMappingURL=format.js.map

package/node_modules/@xrkseek/exec-image-gen/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,mBAAmB;IACnB,mHAAmH;IACnH,gIAAgI;IAChI,gHAAgH;CACjH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/node_modules/@xrkseek/exec-image-gen/dist/index.d.ts

@@ -0,0 +1,24 @@
+import type { ImageGenService } from "./types.js";
+export { ImageGenError, isImageGenError, type ImageGenDelivery, type ImageGenErrorCode, type ImageGenImage, type ImageGenRequest, type ImageGenResult, type ImageGenService, type ImageGenSize, } from "./types.js";
+export { IMAGE_GEN_PROMPT_TEXT } from "./format.js";
+export { createMemoryImageGenProvider, minimalPngBytes, type MemoryImageGenOptions, } from "./memory.js";
+export { createOpenAiImageGenProvider, type OpenAiImageGenOptions, } from "./openai-http.js";
+export { createImageGenTools, imageGenUnavailableMessage, type CreateImageGenToolsOptions, } from "./tools.js";
+export interface DefaultImageGenAccessOptions {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly service?: ImageGenService;
+    readonly fetchImpl?: typeof fetch;
+}
+export interface DefaultImageGenAccess {
+    readonly service?: ImageGenService;
+    readonly unavailableMessage: string;
+}
+/**
+ * Resolve a text-to-image Provider.
+ * - Injected `service` wins.
+ * - `XRK_IMAGE_GEN=memory` → in-memory Provider.
+ * - `XRK_IMAGE_GEN=1` + API key → OpenAI Images API.
+ * - Else no service; tools stay registered and fail honestly.
+ */
+export declare function createDefaultImageGenAccess(options?: DefaultImageGenAccessOptions): DefaultImageGenAccess;
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@xrkseek/exec-image-gen/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,EACL,aAAa,EACb,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,4BAA4B,EAC5B,eAAe,EACf,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,4BAA4B,EAC5B,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,KAAK,0BAA0B,GAChC,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AASD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,4BAAiC,GACzC,qBAAqB,CA+BvB"}

package/node_modules/@xrkseek/exec-image-gen/dist/index.js

@@ -0,0 +1,55 @@
+import { createMemoryImageGenProvider } from "./memory.js";
+import { createOpenAiImageGenProvider } from "./openai-http.js";
+import { imageGenUnavailableMessage } from "./tools.js";
+export { ImageGenError, isImageGenError, } from "./types.js";
+export { IMAGE_GEN_PROMPT_TEXT } from "./format.js";
+export { createMemoryImageGenProvider, minimalPngBytes, } from "./memory.js";
+export { createOpenAiImageGenProvider, } from "./openai-http.js";
+export { createImageGenTools, imageGenUnavailableMessage, } from "./tools.js";
+function resolveApiKey(env) {
+    const a = String(env.XRK_IMAGE_GEN_OPENAI_KEY ?? "").trim();
+    if (a)
+        return a;
+    const b = String(env.OPENAI_API_KEY ?? "").trim();
+    return b || undefined;
+}
+/**
+ * Resolve a text-to-image Provider.
+ * - Injected `service` wins.
+ * - `XRK_IMAGE_GEN=memory` → in-memory Provider.
+ * - `XRK_IMAGE_GEN=1` + API key → OpenAI Images API.
+ * - Else no service; tools stay registered and fail honestly.
+ */
+export function createDefaultImageGenAccess(options = {}) {
+    const env = options.env ?? process.env;
+    const unavailableMessage = imageGenUnavailableMessage(env);
+    if (options.service) {
+        return { service: options.service, unavailableMessage };
+    }
+    const flag = String(env.XRK_IMAGE_GEN ?? "").trim().toLowerCase();
+    if (flag === "memory") {
+        return {
+            service: createMemoryImageGenProvider(),
+            unavailableMessage,
+        };
+    }
+    if (flag === "1") {
+        const apiKey = resolveApiKey(env);
+        if (!apiKey) {
+            return { unavailableMessage };
+        }
+        const baseUrl = String(env.XRK_IMAGE_GEN_BASE_URL ?? "").trim();
+        const model = String(env.XRK_IMAGE_GEN_MODEL ?? "").trim();
+        return {
+            service: createOpenAiImageGenProvider({
+                apiKey,
+                ...(baseUrl ? { baseUrl } : {}),
+                ...(model ? { model } : {}),
+                ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
+            }),
+            unavailableMessage,
+        };
+    }
+    return { unavailableMessage };
+}
+//# sourceMappingURL=index.js.map

package/node_modules/@xrkseek/exec-image-gen/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EACL,aAAa,EACb,eAAe,GAQhB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,4BAA4B,EAC5B,eAAe,GAEhB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,4BAA4B,GAE7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,GAE3B,MAAM,YAAY,CAAC;AAapB,SAAS,aAAa,CAAC,GAAsB;IAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAChB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,OAAO,CAAC,IAAI,SAAS,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAAwC,EAAE;IAE1C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,kBAAkB,GAAG,0BAA0B,CAAC,GAAG,CAAC,CAAC;IAC3D,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC1D,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClE,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,4BAA4B,EAAE;YACvC,kBAAkB;SACnB,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,kBAAkB,EAAE,CAAC;QAChC,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3D,OAAO;YACL,OAAO,EAAE,4BAA4B,CAAC;gBACpC,MAAM;gBACN,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/B,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3B,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/D,CAAC;YACF,kBAAkB;SACnB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAChC,CAAC"}

package/node_modules/@xrkseek/exec-image-gen/dist/memory.d.ts

@@ -0,0 +1,11 @@
+import type { ImageGenService } from "./types.js";
+/** 1×1 PNG (valid for AttachmentStore image sniff). */
+export declare function minimalPngBytes(): Uint8Array;
+export interface MemoryImageGenOptions {
+    readonly note?: string;
+}
+/**
+ * Deterministic in-memory Provider for CI / demos (`XRK_IMAGE_GEN=memory`).
+ */
+export declare function createMemoryImageGenProvider(options?: MemoryImageGenOptions): ImageGenService;
+//# sourceMappingURL=memory.d.ts.map

package/node_modules/@xrkseek/exec-image-gen/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,YAAY,CAAC;AAGpB,uDAAuD;AACvD,wBAAgB,eAAe,IAAI,UAAU,CAO5C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,qBAA0B,GAClC,eAAe,CAuBjB"}

package/node_modules/@xrkseek/exec-image-gen/dist/memory.js

@@ -0,0 +1,32 @@
+import { ImageGenError } from "./types.js";
+/** 1×1 PNG (valid for AttachmentStore image sniff). */
+export function minimalPngBytes() {
+    return Uint8Array.from(Buffer.from("iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==", "base64"));
+}
+/**
+ * Deterministic in-memory Provider for CI / demos (`XRK_IMAGE_GEN=memory`).
+ */
+export function createMemoryImageGenProvider(options = {}) {
+    return {
+        async generate(req) {
+            const prompt = String(req.prompt ?? "").trim();
+            if (!prompt) {
+                throw new ImageGenError("prompt is empty", "IMAGE_GEN_BAD_ARGS");
+            }
+            const n = Math.min(Math.max(req.n ?? 1, 1), 4);
+            const images = Array.from({ length: n }, () => ({
+                bytes: minimalPngBytes(),
+                mimeType: "image/png",
+                revisedPrompt: prompt,
+            }));
+            return {
+                images,
+                provider: "memory",
+                delivery: "memory",
+                note: options.note ??
+                    `memory-image-gen:${prompt.slice(0, 80)} n=${n}`,
+            };
+        },
+    };
+}
+//# sourceMappingURL=memory.js.map

package/node_modules/@xrkseek/exec-image-gen/dist/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,uDAAuD;AACvD,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,CAAC,IAAI,CACpB,MAAM,CAAC,IAAI,CACT,kGAAkG,EAClG,QAAQ,CACT,CACF,CAAC;AACJ,CAAC;AAMD;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAAiC,EAAE;IAEnC,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,GAAoB;YACjC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,aAAa,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;YACnE,CAAC;YACD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;gBAC9C,KAAK,EAAE,eAAe,EAAE;gBACxB,QAAQ,EAAE,WAAoB;gBAC9B,aAAa,EAAE,MAAM;aACtB,CAAC,CAAC,CAAC;YACJ,OAAO;gBACL,MAAM;gBACN,QAAQ,EAAE,QAAQ;gBAClB,QAAQ,EAAE,QAAQ;gBAClB,IAAI,EACF,OAAO,CAAC,IAAI;oBACZ,oBAAoB,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE;aACnD,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/node_modules/@xrkseek/exec-image-gen/dist/openai-http.d.ts

@@ -0,0 +1,13 @@
+/**
+ * OpenAI Images API Provider (`POST /images/generations`).
+ */
+import type { ImageGenService, ImageGenSize } from "./types.js";
+export interface OpenAiImageGenOptions {
+    readonly apiKey: string;
+    readonly baseUrl?: string;
+    readonly fetchImpl?: typeof fetch;
+    readonly model?: string;
+    readonly defaultSize?: ImageGenSize;
+}
+export declare function createOpenAiImageGenProvider(options: OpenAiImageGenOptions): ImageGenService;
+//# sourceMappingURL=openai-http.d.ts.map

package/node_modules/@xrkseek/exec-image-gen/dist/openai-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-http.d.ts","sourceRoot":"","sources":["../src/openai-http.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAGV,eAAe,EACf,YAAY,EACb,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC;CACrC;AAMD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,qBAAqB,GAC7B,eAAe,CA+EjB"}

package/node_modules/@xrkseek/exec-image-gen/dist/openai-http.js

@@ -0,0 +1,67 @@
+import { ImageGenError } from "./types.js";
+function joinUrl(base, path) {
+    return `${base.replace(/\/+$/, "")}/${path.replace(/^\/+/, "")}`;
+}
+export function createOpenAiImageGenProvider(options) {
+    const baseUrl = (options.baseUrl ?? "https://api.openai.com/v1").replace(/\/+$/, "");
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const model = options.model ?? "dall-e-3";
+    const defaultSize = options.defaultSize ?? "1024x1024";
+    return {
+        async generate(req) {
+            const prompt = String(req.prompt ?? "").trim();
+            if (!prompt) {
+                throw new ImageGenError("prompt is empty", "IMAGE_GEN_BAD_ARGS");
+            }
+            const n = Math.min(Math.max(req.n ?? 1, 1), 4);
+            // dall-e-3 only supports n=1
+            const bodyN = model.includes("dall-e-3") ? 1 : n;
+            const res = await fetchImpl(joinUrl(baseUrl, "images/generations"), {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${options.apiKey}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    model: req.model ?? model,
+                    prompt,
+                    n: bodyN,
+                    size: req.size ?? defaultSize,
+                    response_format: "b64_json",
+                }),
+            });
+            if (!res.ok) {
+                const body = await res.text().catch(() => "");
+                throw new ImageGenError(`OpenAI images HTTP ${res.status}: ${body.slice(0, 200)}`, "IMAGE_GEN_BACKEND");
+            }
+            const json = (await res.json());
+            const rows = json.data ?? [];
+            if (rows.length === 0) {
+                throw new ImageGenError("OpenAI images response missing data", "IMAGE_GEN_BACKEND");
+            }
+            const images = rows.map((row) => {
+                if (row.b64_json) {
+                    return {
+                        bytes: Uint8Array.from(Buffer.from(row.b64_json, "base64")),
+                        mimeType: "image/png",
+                        ...(row.revised_prompt
+                            ? { revisedPrompt: row.revised_prompt }
+                            : {}),
+                        ...(row.url ? { url: row.url } : {}),
+                    };
+                }
+                if (row.url) {
+                    throw new ImageGenError("OpenAI returned url without b64_json; retry with response_format=b64_json", "IMAGE_GEN_BACKEND");
+                }
+                throw new ImageGenError("OpenAI image row missing b64_json", "IMAGE_GEN_BACKEND");
+            });
+            return {
+                images,
+                provider: "openai",
+                delivery: "openai",
+                note: `openai-images model=${req.model ?? model} n=${images.length}`,
+            };
+        },
+    };
+}
+//# sourceMappingURL=openai-http.js.map

package/node_modules/@xrkseek/exec-image-gen/dist/openai-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-http.js","sourceRoot":"","sources":["../src/openai-http.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAU3C,SAAS,OAAO,CAAC,IAAY,EAAE,IAAY;IACzC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,OAA8B;IAE9B,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,2BAA2B,CAAC,CAAC,OAAO,CACtE,MAAM,EACN,EAAE,CACH,CAAC;IACF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC;IAC1C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,WAAW,CAAC;IAEvD,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,GAAoB;YACjC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,aAAa,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;YACnE,CAAC;YACD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/C,6BAA6B;YAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACjD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,oBAAoB,CAAC,EAAE;gBAClE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,OAAO,CAAC,MAAM,EAAE;oBACzC,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,KAAK;oBACzB,MAAM;oBACN,CAAC,EAAE,KAAK;oBACR,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,WAAW;oBAC7B,eAAe,EAAE,UAAU;iBAC5B,CAAC;aACH,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC9C,MAAM,IAAI,aAAa,CACrB,sBAAsB,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EACzD,mBAAmB,CACpB,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAE7B,CAAC;YACF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,aAAa,CACrB,qCAAqC,EACrC,mBAAmB,CACpB,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC9B,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;oBACjB,OAAO;wBACL,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;wBAC3D,QAAQ,EAAE,WAAoB;wBAC9B,GAAG,CAAC,GAAG,CAAC,cAAc;4BACpB,CAAC,CAAC,EAAE,aAAa,EAAE,GAAG,CAAC,cAAc,EAAE;4BACvC,CAAC,CAAC,EAAE,CAAC;wBACP,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBACrC,CAAC;gBACJ,CAAC;gBACD,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;oBACZ,MAAM,IAAI,aAAa,CACrB,2EAA2E,EAC3E,mBAAmB,CACpB,CAAC;gBACJ,CAAC;gBACD,MAAM,IAAI,aAAa,CACrB,mCAAmC,EACnC,mBAAmB,CACpB,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,OAAO;gBACL,MAAM;gBACN,QAAQ,EAAE,QAAQ;gBAClB,QAAQ,EAAE,QAAQ;gBAClB,IAAI,EAAE,uBAAuB,GAAG,CAAC,KAAK,IAAI,KAAK,MAAM,MAAM,CAAC,MAAM,EAAE;aACrE,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/node_modules/@xrkseek/exec-image-gen/dist/tools.d.ts

@@ -0,0 +1,17 @@
+import type { AttachmentStore } from "@xrkseek/attachment";
+import type { ToolDefinition } from "@xrkseek/core-tools";
+import { IMAGE_GEN_PROMPT_TEXT } from "./format.js";
+import { type ImageGenService } from "./types.js";
+export { IMAGE_GEN_PROMPT_TEXT };
+export declare function imageGenUnavailableMessage(env?: NodeJS.ProcessEnv): string;
+export interface CreateImageGenToolsOptions {
+    readonly service?: ImageGenService;
+    readonly env?: NodeJS.ProcessEnv;
+    /** When set, persist generated images and return attachment ids. */
+    readonly attachments?: AttachmentStore;
+}
+/**
+ * Model-facing `image_generate` tool (Hermes-style text-to-image).
+ */
+export declare function createImageGenTools(options?: CreateImageGenToolsOptions): ToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

package/node_modules/@xrkseek/exec-image-gen/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAUjC,wBAAgB,0BAA0B,CACxC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAiBR;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,oEAAoE;IACpE,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;CACxC;AAqBD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,0BAA+B,GACvC,cAAc,EAAE,CA6FlB"}

package/node_modules/@xrkseek/exec-image-gen/dist/tools.js

@@ -0,0 +1,130 @@
+import { IMAGE_GEN_PROMPT_TEXT } from "./format.js";
+import { ImageGenError, isImageGenError, } from "./types.js";
+export { IMAGE_GEN_PROMPT_TEXT };
+const SIZES = [
+    "256x256",
+    "512x512",
+    "1024x1024",
+    "1792x1024",
+    "1024x1792",
+];
+export function imageGenUnavailableMessage(env = process.env) {
+    const flag = String(env.XRK_IMAGE_GEN ?? "").trim().toLowerCase();
+    if (!flag) {
+        return ("Error: image generation is not enabled. Set XRK_IMAGE_GEN=memory (CI/demo) or " +
+            "XRK_IMAGE_GEN=1 with OPENAI_API_KEY / XRK_IMAGE_GEN_OPENAI_KEY. See docs/image-gen.md.");
+    }
+    if (flag === "1") {
+        return ("Error: XRK_IMAGE_GEN=1 but no API key. Set OPENAI_API_KEY or XRK_IMAGE_GEN_OPENAI_KEY " +
+            "(optional XRK_IMAGE_GEN_BASE_URL / XRK_IMAGE_GEN_MODEL).");
+    }
+    return ("Error: no ImageGenService Provider is configured. Inject a service or set XRK_IMAGE_GEN.");
+}
+function fail(err) {
+    const message = isImageGenError(err)
+        ? `Error: ${err.message}`
+        : `Error: ${err instanceof Error ? err.message : String(err)}`;
+    return { content: message, isError: true };
+}
+function parseSize(raw) {
+    if (raw === undefined || raw === null || raw === "")
+        return undefined;
+    const s = String(raw).trim();
+    if (!SIZES.includes(s)) {
+        throw new ImageGenError(`size must be one of ${SIZES.join(", ")}`, "IMAGE_GEN_BAD_ARGS");
+    }
+    return s;
+}
+/**
+ * Model-facing `image_generate` tool (Hermes-style text-to-image).
+ */
+export function createImageGenTools(options = {}) {
+    const missing = imageGenUnavailableMessage(options.env ?? process.env);
+    const service = options.service;
+    const attachments = options.attachments;
+    const tool = {
+        name: "image_generate",
+        description: "Generate an image from a text prompt via the Host text-to-image Provider. " +
+            "Returns PNG as base64 (truncated in tool text) and optional attachment id when the Host attachment store is wired.",
+        parameters: {
+            type: "object",
+            properties: {
+                prompt: {
+                    type: "string",
+                    description: "Full visual description (subject, style, composition).",
+                },
+                size: {
+                    type: "string",
+                    enum: [...SIZES],
+                    description: "Output size (provider-dependent; default 1024x1024).",
+                },
+                n: {
+                    type: "number",
+                    description: "Number of images (1–4; dall-e-3 forces 1).",
+                },
+                model: {
+                    type: "string",
+                    description: "Optional model override (e.g. dall-e-3, gpt-image-1).",
+                },
+            },
+            required: ["prompt"],
+        },
+        presentCall: (args) => ({
+            card: "generic",
+            title: "Image generate",
+            kind: "execute",
+            rawInput: args,
+        }),
+        async execute(args) {
+            if (!service)
+                return { content: missing, isError: true };
+            try {
+                const prompt = String(args.prompt ?? "").trim();
+                const size = parseSize(args.size);
+                const n = typeof args.n === "number" && Number.isFinite(args.n)
+                    ? Math.trunc(args.n)
+                    : undefined;
+                const result = await service.generate({
+                    prompt,
+                    ...(size ? { size } : {}),
+                    ...(n !== undefined ? { n } : {}),
+                    ...(args.model ? { model: String(args.model) } : {}),
+                });
+                const lines = [
+                    `provider=${result.provider} delivery=${result.delivery} images=${result.images.length}`,
+                ];
+                if (result.note)
+                    lines.push(`note=${result.note}`);
+                for (let i = 0; i < result.images.length; i += 1) {
+                    const img = result.images[i];
+                    let attachmentId;
+                    if (attachments) {
+                        const ref = await attachments.saveImage({
+                            data: img.bytes,
+                            mediaType: img.mimeType,
+                            name: `image_generate_${i + 1}.png`,
+                        });
+                        attachmentId = ref.attachmentId;
+                    }
+                    const b64 = Buffer.from(img.bytes).toString("base64");
+                    const preview = b64.length > 96 ? `${b64.slice(0, 96)}…(${b64.length} chars)` : b64;
+                    lines.push(`--- image ${i + 1} ---`);
+                    lines.push(`mime=${img.mimeType} bytes=${img.bytes.byteLength}`);
+                    if (img.revisedPrompt)
+                        lines.push(`revised_prompt=${img.revisedPrompt}`);
+                    if (img.url)
+                        lines.push(`url=${img.url}`);
+                    if (attachmentId)
+                        lines.push(`attachmentId=${attachmentId}`);
+                    lines.push(`image_base64=${preview}`);
+                }
+                return { content: lines.join("\n") };
+            }
+            catch (err) {
+                return fail(err);
+            }
+        },
+    };
+    return [tool];
+}
+//# sourceMappingURL=tools.js.map

package/node_modules/@xrkseek/exec-image-gen/dist/tools.js.map

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

package/node_modules/@xrkseek/exec-image-gen/dist/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Text-to-image Provider seam — model tool `image_generate`.
+ */
+export type ImageGenDelivery = "memory" | "openai" | "unavailable";
+export type ImageGenErrorCode = "IMAGE_GEN_UNAVAILABLE" | "IMAGE_GEN_BAD_ARGS" | "IMAGE_GEN_BACKEND";
+export declare class ImageGenError extends Error {
+    readonly code: ImageGenErrorCode;
+    constructor(message: string, code?: ImageGenErrorCode);
+}
+export declare function isImageGenError(err: unknown): err is ImageGenError;
+export type ImageGenSize = "256x256" | "512x512" | "1024x1024" | "1792x1024" | "1024x1792";
+export interface ImageGenRequest {
+    readonly prompt: string;
+    readonly size?: ImageGenSize;
+    readonly n?: number;
+    readonly model?: string;
+}
+export interface ImageGenImage {
+    readonly bytes: Uint8Array;
+    readonly mimeType: "image/png" | "image/jpeg" | "image/webp";
+    readonly revisedPrompt?: string;
+    readonly url?: string;
+}
+export interface ImageGenResult {
+    readonly images: readonly ImageGenImage[];
+    readonly provider: string;
+    readonly delivery: ImageGenDelivery;
+    readonly note?: string;
+}
+/**
+ * Definition: text-to-image Provider.
+ * Tools always register; missing Provider → honest execute error.
+ */
+export interface ImageGenService {
+    generate(req: ImageGenRequest): Promise<ImageGenResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@xrkseek/exec-image-gen/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEnE,MAAM,MAAM,iBAAiB,GACzB,uBAAuB,GACvB,oBAAoB,GACpB,mBAAmB,CAAC;AAExB,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAuC;CAK3E;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAElE;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;AAE3F,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;IAC7D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACzD"}

package/node_modules/@xrkseek/exec-image-gen/dist/types.js

@@ -0,0 +1,15 @@
+/**
+ * Text-to-image Provider seam — model tool `image_generate`.
+ */
+export class ImageGenError extends Error {
+    code;
+    constructor(message, code = "IMAGE_GEN_BACKEND") {
+        super(message);
+        this.name = "ImageGenError";
+        this.code = code;
+    }
+}
+export function isImageGenError(err) {
+    return err instanceof ImageGenError;
+}
+//# sourceMappingURL=types.js.map

package/node_modules/@xrkseek/exec-image-gen/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,IAAI,CAAoB;IAEjC,YAAY,OAAe,EAAE,OAA0B,mBAAmB;QACxE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,GAAG,YAAY,aAAa,CAAC;AACtC,CAAC"}