@xrkseek/harness 0.4.2 → 0.4.4

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

@@ -0,0 +1,145 @@
+/**
+ * Resolve Hermes-style `image_url` / `reference_image_urls` / attachment ids
+ * into decoded {@link ImageGenSourceImage} rows for Provider edit calls.
+ */
+import { ImageGenError } from "./types.js";
+const ATTACHMENT_PREFIX = "attachment:";
+function sniffMime(bytes, hint) {
+    if (hint === "image/jpeg" || hint === "image/png" || hint === "image/webp") {
+        return hint;
+    }
+    if (bytes.length >= 3 && bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff) {
+        return "image/jpeg";
+    }
+    if (bytes.length >= 12 &&
+        bytes[0] === 0x52 &&
+        bytes[1] === 0x49 &&
+        bytes[2] === 0x46 &&
+        bytes[3] === 0x46) {
+        return "image/webp";
+    }
+    return "image/png";
+}
+function parseDataUrl(url) {
+    const match = /^data:(image\/(?:png|jpeg|jpg|webp));base64,(.+)$/iu.exec(url.trim());
+    if (!match) {
+        throw new ImageGenError("data: image_url must be image/png|jpeg|webp base64", "IMAGE_GEN_BAD_ARGS");
+    }
+    const mimeHint = match[1].toLowerCase().replace("image/jpg", "image/jpeg");
+    const bytes = Uint8Array.from(Buffer.from(match[2], "base64"));
+    if (bytes.byteLength === 0) {
+        throw new ImageGenError("empty data: image", "IMAGE_GEN_BAD_ARGS");
+    }
+    return {
+        bytes,
+        mimeType: sniffMime(bytes, mimeHint),
+        label: "data-url",
+    };
+}
+async function fetchHttpImage(url, fetchImpl) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new ImageGenError(`invalid image_url: ${url.slice(0, 80)}`, "IMAGE_GEN_BAD_ARGS");
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new ImageGenError("image_url must be http(s), data:, or attachment:<id>", "IMAGE_GEN_BAD_ARGS");
+    }
+    // Block obvious loopback / link-local SSRF (Hermes-style safety floor).
+    const host = parsed.hostname.toLowerCase();
+    if (host === "localhost" ||
+        host === "127.0.0.1" ||
+        host === "::1" ||
+        host === "0.0.0.0" ||
+        host.endsWith(".local") ||
+        host.startsWith("169.254.") ||
+        host.startsWith("10.") ||
+        /^192\.168\./u.test(host) ||
+        /^172\.(1[6-9]|2\d|3[0-1])\./u.test(host)) {
+        throw new ImageGenError(`image_url host blocked for SSRF safety: ${host}`, "IMAGE_GEN_BAD_ARGS");
+    }
+    const res = await fetchImpl(url);
+    if (!res.ok) {
+        throw new ImageGenError(`image_url fetch HTTP ${res.status}`, "IMAGE_GEN_BACKEND");
+    }
+    const buf = new Uint8Array(await res.arrayBuffer());
+    if (buf.byteLength === 0) {
+        throw new ImageGenError("image_url returned empty body", "IMAGE_GEN_BAD_ARGS");
+    }
+    const ct = res.headers.get("content-type")?.split(";")[0]?.trim();
+    return {
+        bytes: buf,
+        mimeType: sniffMime(buf, ct),
+        label: parsed.pathname.split("/").pop() || "http-image",
+    };
+}
+async function loadAttachment(id, attachments) {
+    const stored = await attachments.readImage(id);
+    return {
+        bytes: stored.data,
+        mimeType: sniffMime(stored.data, stored.ref.mediaType),
+        label: id,
+    };
+}
+/**
+ * Collect primary `image_url` + `reference_image_urls` + attachment ids
+ * (Hermes `collect_source_images` order). Throws when edit is requested but
+ * `maxReferenceImages === 0`.
+ */
+export async function resolveImageGenReferenceImages(options) {
+    const urls = [];
+    const primary = options.imageUrl?.trim();
+    if (primary)
+        urls.push(primary);
+    for (const raw of options.referenceImageUrls ?? []) {
+        const u = String(raw ?? "").trim();
+        if (u)
+            urls.push(u);
+    }
+    const attachmentIds = (options.referenceAttachmentIds ?? [])
+        .map((id) => String(id ?? "").trim())
+        .filter((id) => id.length > 0);
+    if (urls.length === 0 && attachmentIds.length === 0) {
+        return [];
+    }
+    if (options.maxReferenceImages <= 0) {
+        throw new ImageGenError("This image Provider does not support reference images / edit. Omit image_url and reference_* args, or switch Provider.", "IMAGE_GEN_BAD_ARGS");
+    }
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const out = [];
+    for (const url of urls) {
+        if (out.length >= options.maxReferenceImages)
+            break;
+        if (url.startsWith("data:")) {
+            out.push(parseDataUrl(url));
+            continue;
+        }
+        if (url.startsWith(ATTACHMENT_PREFIX)) {
+            const id = url.slice(ATTACHMENT_PREFIX.length).trim();
+            if (!id) {
+                throw new ImageGenError("attachment: image_url missing id", "IMAGE_GEN_BAD_ARGS");
+            }
+            if (!options.attachments) {
+                throw new ImageGenError("attachment: references require Host AttachmentStore", "IMAGE_GEN_BAD_ARGS");
+            }
+            out.push(await loadAttachment(id, options.attachments));
+            continue;
+        }
+        out.push(await fetchHttpImage(url, fetchImpl));
+    }
+    for (const id of attachmentIds) {
+        if (out.length >= options.maxReferenceImages)
+            break;
+        if (!options.attachments) {
+            throw new ImageGenError("reference_attachment_ids require Host AttachmentStore", "IMAGE_GEN_BAD_ARGS");
+        }
+        out.push(await loadAttachment(id, options.attachments));
+    }
+    if (out.length > options.maxReferenceImages) {
+        throw new ImageGenError(`at most ${options.maxReferenceImages} reference image(s) allowed`, "IMAGE_GEN_BAD_ARGS");
+    }
+    return out;
+}
+//# sourceMappingURL=references.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * Build model-facing tool parameters from Provider capabilities
+ * (Hermes `_build_dynamic_image_schema`).
+ */
+import { type ImageGenCapabilities, type ImageGenSize } from "./types.js";
+export declare const IMAGE_GEN_SIZES: readonly ImageGenSize[];
+export interface ImageGenToolParameters {
+    readonly type: "object";
+    readonly properties: Record<string, unknown>;
+    readonly required: readonly string[];
+}
+/** Static base + edit args only when `capabilities` support image refs. */
+export declare function buildImageGenToolParameters(caps: ImageGenCapabilities): ImageGenToolParameters;
+export declare function buildImageGenToolDescription(caps: ImageGenCapabilities): string;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAMlD,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,2EAA2E;AAC3E,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,oBAAoB,GACzB,sBAAsB,CA8CxB;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAc/E"}

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

@@ -0,0 +1,67 @@
+/**
+ * Build model-facing tool parameters from Provider capabilities
+ * (Hermes `_build_dynamic_image_schema`).
+ */
+import { imageGenSupportsEdit, } from "./types.js";
+export const IMAGE_GEN_SIZES = [
+    "256x256",
+    "512x512",
+    "1024x1024",
+    "1792x1024",
+    "1024x1792",
+];
+/** Static base + edit args only when `capabilities` support image refs. */
+export function buildImageGenToolParameters(caps) {
+    const properties = {
+        prompt: {
+            type: "string",
+            description: "Full visual description (text-to-image) or edit instruction (image-to-image).",
+        },
+        size: {
+            type: "string",
+            enum: [...IMAGE_GEN_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).",
+        },
+    };
+    if (imageGenSupportsEdit(caps)) {
+        properties.image_url = {
+            type: "string",
+            description: "Primary reference image for edit / i2i: https URL, data:image/…;base64,…, or attachment:<attachmentId>.",
+        };
+        properties.reference_image_urls = {
+            type: "array",
+            items: { type: "string" },
+            description: `Additional reference image URLs (same schemes as image_url). Max ${caps.maxReferenceImages} sources total.`,
+        };
+        properties.reference_attachment_ids = {
+            type: "array",
+            items: { type: "string" },
+            description: "Host AttachmentStore image ids to use as edit references (preferred over fetching URLs when already attached).",
+        };
+    }
+    return {
+        type: "object",
+        properties,
+        required: ["prompt"],
+    };
+}
+export function buildImageGenToolDescription(caps) {
+    if (imageGenSupportsEdit(caps)) {
+        return ("Generate or edit an image via the Host image Provider. " +
+            "Text-only prompt → text-to-image; with image_url / reference_image_urls / " +
+            `reference_attachment_ids (≤${caps.maxReferenceImages}) → image edit. ` +
+            "Returns PNG base64 (truncated in tool text) and optional attachment id.");
+    }
+    return ("Generate an image from a text prompt via the Host text-to-image Provider. " +
+        "This Provider does not accept reference images. " +
+        "Returns PNG as base64 (truncated in tool text) and optional attachment id.");
+}
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,oBAAoB,GAGrB,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,eAAe,GAA4B;IACtD,SAAS;IACT,SAAS;IACT,WAAW;IACX,WAAW;IACX,WAAW;CACZ,CAAC;AAQF,2EAA2E;AAC3E,MAAM,UAAU,2BAA2B,CACzC,IAA0B;IAE1B,MAAM,UAAU,GAA4B;QAC1C,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,+EAA+E;SAClF;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,GAAG,eAAe,CAAC;YAC1B,WAAW,EAAE,sDAAsD;SACpE;QACD,CAAC,EAAE;YACD,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,4CAA4C;SAC1D;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,uDAAuD;SACrE;KACF,CAAC;IAEF,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,UAAU,CAAC,SAAS,GAAG;YACrB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,yGAAyG;SAC5G,CAAC;QACF,UAAU,CAAC,oBAAoB,GAAG;YAChC,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EAAE,oEAAoE,IAAI,CAAC,kBAAkB,iBAAiB;SAC1H,CAAC;QACF,UAAU,CAAC,wBAAwB,GAAG;YACpC,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EACT,gHAAgH;SACnH,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU;QACV,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,IAA0B;IACrE,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,CACL,yDAAyD;YACzD,4EAA4E;YAC5E,8BAA8B,IAAI,CAAC,kBAAkB,kBAAkB;YACvE,yEAAyE,CAC1E,CAAC;IACJ,CAAC;IACD,OAAO,CACL,4EAA4E;QAC5E,kDAAkD;QAClD,4EAA4E,CAC7E,CAAC;AACJ,CAAC"}

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

@@ -12,11 +12,14 @@ export interface CreateImageGenToolsOptions {
     readonly product?: {
         readonly mode?: string;
     };
-    /** When set, persist generated images and return attachment ids. */
+    /** When set, persist generated images and resolve reference_attachment_ids. */
     readonly attachments?: AttachmentStore;
+    readonly fetchImpl?: typeof fetch;
 }
 /**
- * Model-facing `image_generate` tool (Hermes-style text-to-image).
+ * Model-facing `image_generate` tool (Hermes-style t2i + edit in one tool).
+ * Static fields are an initial bake; `dynamicSchema` rebuilds from live
+ * Provider `capabilities()` on each materialize (Hermes get_definitions).
  */
 export declare function createImageGenTools(options?: CreateImageGenToolsOptions): ToolDefinition[];
 //# sourceMappingURL=tools.d.ts.map

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

@@ -1 +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,EACpC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,MAAM,CAuBR;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,oEAAoE;IACpE,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;CACxC;AAqBD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,0BAA+B,GACvC,cAAc,EAAE,CAgGlB"}
+{"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;AAOpD,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC,wBAAgB,0BAA0B,CACxC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,MAAM,CAuBR;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACnC;AAgCD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,0BAA+B,GACvC,cAAc,EAAE,CAqGlB"}

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

@@ -1,13 +1,8 @@
 import { IMAGE_GEN_PROMPT_TEXT } from "./format.js";
-import { ImageGenError, isImageGenError, } from "./types.js";
+import { resolveImageGenReferenceImages } from "./references.js";
+import { buildImageGenToolDescription, buildImageGenToolParameters, IMAGE_GEN_SIZES, } from "./schema.js";
+import { ImageGenError, isImageGenError, resolveImageGenCapabilities, } from "./types.js";
 export { IMAGE_GEN_PROMPT_TEXT };
-const SIZES = [
-    "256x256",
-    "512x512",
-    "1024x1024",
-    "1792x1024",
-    "1024x1792",
-];
 export function imageGenUnavailableMessage(env = process.env, product) {
     const envRaw = String(env.XRK_IMAGE_GEN ?? "").trim();
     const flag = envRaw !== ""
@@ -36,44 +31,39 @@ 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");
+    if (!IMAGE_GEN_SIZES.includes(s)) {
+        throw new ImageGenError(`size must be one of ${IMAGE_GEN_SIZES.join(", ")}`, "IMAGE_GEN_BAD_ARGS");
     }
     return s;
 }
+function asStringList(raw) {
+    if (raw === undefined || raw === null)
+        return undefined;
+    if (!Array.isArray(raw)) {
+        throw new ImageGenError("reference lists must be arrays of strings", "IMAGE_GEN_BAD_ARGS");
+    }
+    return raw.map((item) => String(item));
+}
 /**
- * Model-facing `image_generate` tool (Hermes-style text-to-image).
+ * Model-facing `image_generate` tool (Hermes-style t2i + edit in one tool).
+ * Static fields are an initial bake; `dynamicSchema` rebuilds from live
+ * Provider `capabilities()` on each materialize (Hermes get_definitions).
  */
 export function createImageGenTools(options = {}) {
     const missing = imageGenUnavailableMessage(options.env ?? process.env, options.product);
     const service = options.service;
     const attachments = options.attachments;
+    const caps = resolveImageGenCapabilities(service);
     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"],
+        description: buildImageGenToolDescription(caps),
+        parameters: buildImageGenToolParameters(caps),
+        dynamicSchema: () => {
+            const live = resolveImageGenCapabilities(service);
+            return {
+                description: buildImageGenToolDescription(live),
+                parameters: buildImageGenToolParameters(live),
+            };
         },
         presentCall: (args) => ({
             card: "generic",
@@ -85,19 +75,31 @@ export function createImageGenTools(options = {}) {
             if (!service)
                 return { content: missing, isError: true };
             try {
+                const liveCaps = resolveImageGenCapabilities(service);
                 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 refUrls = asStringList(args.reference_image_urls);
+                const refAttach = asStringList(args.reference_attachment_ids);
+                const referenceImages = await resolveImageGenReferenceImages({
+                    maxReferenceImages: liveCaps.maxReferenceImages,
+                    ...(args.image_url ? { imageUrl: String(args.image_url) } : {}),
+                    ...(refUrls ? { referenceImageUrls: refUrls } : {}),
+                    ...(refAttach ? { referenceAttachmentIds: refAttach } : {}),
+                    ...(attachments ? { attachments } : {}),
+                    ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
+                });
                 const result = await service.generate({
                     prompt,
                     ...(size ? { size } : {}),
                     ...(n !== undefined ? { n } : {}),
                     ...(args.model ? { model: String(args.model) } : {}),
+                    ...(referenceImages.length > 0 ? { referenceImages } : {}),
                 });
                 const lines = [
-                    `provider=${result.provider} delivery=${result.delivery} images=${result.images.length}`,
+                    `provider=${result.provider} delivery=${result.delivery} modality=${result.modality ?? "text"} images=${result.images.length}`,
                 ];
                 if (result.note)
                     lines.push(`note=${result.note}`);

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

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

@@ -1,5 +1,6 @@
 /**
- * Text-to-image Provider seam — model tool `image_generate`.
+ * Text-to-image / image-to-image Provider seam — model tool `image_generate`.
+ * Aligns Hermes `image_gen` (single tool; refs select edit) + Codex ImageGen/Edit.
  */
 export type ImageGenDelivery = "memory" | "openai" | "unavailable";
 export type ImageGenErrorCode = "IMAGE_GEN_UNAVAILABLE" | "IMAGE_GEN_BAD_ARGS" | "IMAGE_GEN_BACKEND";
@@ -9,11 +10,33 @@ export declare class ImageGenError extends Error {
 }
 export declare function isImageGenError(err: unknown): err is ImageGenError;
 export type ImageGenSize = "256x256" | "512x512" | "1024x1024" | "1792x1024" | "1024x1792";
+/** One decoded source image for edit / i2i (Hermes `image_url` + refs). */
+export interface ImageGenSourceImage {
+    readonly bytes: Uint8Array;
+    readonly mimeType: "image/png" | "image/jpeg" | "image/webp";
+    /** Optional label for logs (attachment id or URL stem). */
+    readonly label?: string;
+}
+/**
+ * Provider capability surface (Hermes `capabilities()`).
+ * Tool schema is rebuilt from this — edit args appear only when supported.
+ */
+export interface ImageGenCapabilities {
+    /** `"text"` = t2i only; `"image"` = accepts reference images for edit. */
+    readonly modalities: readonly ("text" | "image")[];
+    /** Max source images for edit (OpenAI Images edit ≤16). 0 = t2i only. */
+    readonly maxReferenceImages: number;
+}
 export interface ImageGenRequest {
     readonly prompt: string;
     readonly size?: ImageGenSize;
     readonly n?: number;
     readonly model?: string;
+    /**
+     * Decoded reference images (primary + extras). Non-empty → edit / i2i.
+     * Tools resolve URLs / attachment ids before calling the Provider.
+     */
+    readonly referenceImages?: readonly ImageGenSourceImage[];
 }
 export interface ImageGenImage {
     readonly bytes: Uint8Array;
@@ -26,12 +49,21 @@ export interface ImageGenResult {
     readonly provider: string;
     readonly delivery: ImageGenDelivery;
     readonly note?: string;
+    /** `"text"` generation vs `"image"` edit (Hermes modality). */
+    readonly modality?: "text" | "image";
 }
+/** Text-only default when a Provider omits `capabilities()`. */
+export declare const IMAGE_GEN_CAPABILITIES_TEXT_ONLY: ImageGenCapabilities;
+export declare function imageGenSupportsEdit(caps: ImageGenCapabilities): boolean;
 /**
- * Definition: text-to-image Provider.
+ * Definition: text-to-image / edit Provider.
  * Tools always register; missing Provider → honest execute error.
  */
 export interface ImageGenService {
     generate(req: ImageGenRequest): Promise<ImageGenResult>;
+    /** Optional; tools rebuild schema from this (Hermes dynamic schema). */
+    capabilities?(): ImageGenCapabilities;
 }
+/** Resolve caps with text-only fallback. */
+export declare function resolveImageGenCapabilities(service: ImageGenService | undefined): ImageGenCapabilities;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;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,GACpB,SAAS,GACT,SAAS,GACT,WAAW,GACX,WAAW,GACX,WAAW,CAAC;AAEhB,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;IAC7D,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;IACnD,yEAAyE;IACzE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAED,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;IACxB;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAC3D;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;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtC;AAED,gEAAgE;AAChE,eAAO,MAAM,gCAAgC,EAAE,oBAG9C,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAIxE;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACxD,wEAAwE;IACxE,YAAY,CAAC,IAAI,oBAAoB,CAAC;CACvC;AAED,4CAA4C;AAC5C,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,GAAG,SAAS,GACnC,oBAAoB,CAGtB"}

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

@@ -1,5 +1,6 @@
 /**
- * Text-to-image Provider seam — model tool `image_generate`.
+ * Text-to-image / image-to-image Provider seam — model tool `image_generate`.
+ * Aligns Hermes `image_gen` (single tool; refs select edit) + Codex ImageGen/Edit.
  */
 export class ImageGenError extends Error {
     code;
@@ -12,4 +13,18 @@ export class ImageGenError extends Error {
 export function isImageGenError(err) {
     return err instanceof ImageGenError;
 }
+/** Text-only default when a Provider omits `capabilities()`. */
+export const IMAGE_GEN_CAPABILITIES_TEXT_ONLY = {
+    modalities: ["text"],
+    maxReferenceImages: 0,
+};
+export function imageGenSupportsEdit(caps) {
+    return (caps.maxReferenceImages > 0 && caps.modalities.includes("image"));
+}
+/** Resolve caps with text-only fallback. */
+export function resolveImageGenCapabilities(service) {
+    if (!service?.capabilities)
+        return IMAGE_GEN_CAPABILITIES_TEXT_ONLY;
+    return service.capabilities();
+}
 //# sourceMappingURL=types.js.map

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

@@ -1 +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"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;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;AAwDD,gEAAgE;AAChE,MAAM,CAAC,MAAM,gCAAgC,GAAyB;IACpE,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,kBAAkB,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,IAA0B;IAC7D,OAAO,CACL,IAAI,CAAC,kBAAkB,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CACjE,CAAC;AACJ,CAAC;AAYD,4CAA4C;AAC5C,MAAM,UAAU,2BAA2B,CACzC,OAAoC;IAEpC,IAAI,CAAC,OAAO,EAAE,YAAY;QAAE,OAAO,gCAAgC,CAAC;IACpE,OAAO,OAAO,CAAC,YAAY,EAAE,CAAC;AAChC,CAAC"}

package/node_modules/@xrkseek/exec-memory/README.md

@@ -3,11 +3,12 @@
 Curated memory files frozen into the system prompt at session start.
 
 - **Definition**: `CuratedMemoryStore` / `MemoryProvider` (`add` / `replace` / `remove`, plus an atomic batch)
-- **Providers**: default **file** (`MEMORY.md` / `USER.md` under `{XRK_HOME}/memories`); optional **HTTP** sample (`createHttpMemoryProvider` → `/v1/curated/{target}`)
+- **Providers**: default **file** (`MEMORY.md` / `USER.md` under `{XRK_HOME}/memories`); optional **HTTP** and **sqlite** samples
 - **Consumer**: `createCuratedMemoryTools` → `memory`
+- **Consolidate**: Phase1 heuristic session-end; optional Phase2 LLM extract (`consolidateCuratedMemoryPhase2`)
 
 The prompt block is the snapshot taken when the store is created. Tool writes update the backend and leave that snapshot alone. This is not the Mnemon document library.
 
-Select via `resolveMemoryProvider` / `XRK_MEMORY_PROVIDER=file|http` (+ `XRK_MEMORY_HTTP_URL`).
+Select via `resolveMemoryProvider` / `XRK_MEMORY_PROVIDER=file|http|sqlite` (+ `XRK_MEMORY_HTTP_URL` for http).
 
 See [docs/curated-memory.md](../../../docs/curated-memory.md).

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

@@ -2,6 +2,7 @@ export { createCuratedMemoryStore, defaultCuratedMemoryDir, ENTRY_DELIMITER, MEM
 export type { MemoryProvider, MemoryProviderKind, } from "./provider.js";
 export { createHttpMemoryProvider, HttpMemoryProviderError, probeHttpMemoryProvider, type HttpMemoryProviderOptions, } from "./http.js";
 export { createFileMemoryProvider, resolveMemoryProvider, type ResolveMemoryProviderOptions, } from "./resolve.js";
+export { createSqliteMemoryProvider, type SqliteMemoryProvider, type SqliteMemoryProviderOptions, } from "./sqlite.js";
 export { CURATED_MEMORY_PROMPT_TEXT, createCuratedMemoryTools, } from "./tools.js";
-export { extractReusableNotes, writeReusableNotesAfterTurn, consolidateCuratedMemoryPhase1, noteCoveredByEntries, type TurnNoteInput, type TurnNoteWriteResult, type SessionEndConsolidateInput, } from "./write-path.js";
+export { extractReusableNotes, writeReusableNotesAfterTurn, consolidateCuratedMemoryPhase1, consolidateCuratedMemoryPhase2, buildPhase2ExtractPrompt, parsePhase2Notes, noteCoveredByEntries, type TurnNoteInput, type TurnNoteWriteResult, type SessionEndConsolidateInput, type SessionEndPhase2Input, type Phase2CompleteFn, } from "./write-path.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,KAAK,+BAA+B,EACpC,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,cAAc,EACd,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,yBAAyB,GAC/B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,4BAA4B,GAClC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,8BAA8B,EAC9B,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,GAChC,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,KAAK,+BAA+B,EACpC,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,cAAc,EACd,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,yBAAyB,GAC/B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,4BAA4B,GAClC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,GACjC,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,8BAA8B,EAC9B,8BAA8B,EAC9B,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC"}

package/node_modules/@xrkseek/exec-memory/dist/index.js

@@ -1,6 +1,7 @@
 export { createCuratedMemoryStore, defaultCuratedMemoryDir, ENTRY_DELIMITER, MEMORY_CHAR_LIMIT, USER_CHAR_LIMIT, } from "./store.js";
 export { createHttpMemoryProvider, HttpMemoryProviderError, probeHttpMemoryProvider, } from "./http.js";
 export { createFileMemoryProvider, resolveMemoryProvider, } from "./resolve.js";
+export { createSqliteMemoryProvider, } from "./sqlite.js";
 export { CURATED_MEMORY_PROMPT_TEXT, createCuratedMemoryTools, } from "./tools.js";
-export { extractReusableNotes, writeReusableNotesAfterTurn, consolidateCuratedMemoryPhase1, noteCoveredByEntries, } from "./write-path.js";
+export { extractReusableNotes, writeReusableNotesAfterTurn, consolidateCuratedMemoryPhase1, consolidateCuratedMemoryPhase2, buildPhase2ExtractPrompt, parsePhase2Notes, noteCoveredByEntries, } from "./write-path.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,eAAe,GAQhB,MAAM,YAAY,CAAC;AAKpB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,GAExB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GAEtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,8BAA8B,EAC9B,oBAAoB,GAIrB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,eAAe,GAQhB,MAAM,YAAY,CAAC;AAKpB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,GAExB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GAEtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,0BAA0B,GAG3B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,8BAA8B,EAC9B,8BAA8B,EAC9B,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,GAMrB,MAAM,iBAAiB,CAAC"}

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

@@ -15,5 +15,5 @@ export interface MemoryProvider extends CuratedMemoryStore {
     /** Probe before wiring (Hermes `is_available`). */
     isAvailable(): boolean | Promise<boolean>;
 }
-export type MemoryProviderKind = "file" | "http";
+export type MemoryProviderKind = "file" | "http" | "sqlite";
 //# sourceMappingURL=provider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,iDAAiD;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,WAAW,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,CAAC"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,iDAAiD;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,WAAW,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC"}