@ai-agent-forge/plugin-image-inspect 0.0.0-stage → 0.88.16

package/MANUAL.md

@@ -0,0 +1,13 @@
+# image_inspect
+
+Use `image_inspect` only when the conversation exposes an `image_ref=...` (in an image placeholder or a compaction summary section `## Available Images`)
+placeholder and you need to know something from that original image.
+
+Input:
+
+```json
+{ "image_ref": "image-1a2b3c4d", "question": "What does the error dialog say?" }
+```
+
+The session's selected vision model answers the question. Treat its answer as
+an observation from another model, not as your own view of the image.

package/README.md

@@ -1,3 +1,14 @@
-# Temporary Holding Version
+# @agent-forge/plugin-image-inspect
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`image_inspect` supplies visual understanding to a main model that is not
+vision-compatible. The tool accepts an original-image reference and one
+question, then asks the session-selected `visual_image` model in an isolated
+completion. It never accepts a provider/model override and never takes over the
+main task. The result states the original image dimensions and a no-crop basis;
+the vision model is asked for normalized coordinates relative to that original
+so they map back regardless of provider-side resizing. Compaction summaries
+carry `image_ref` tokens forward, so the reference remains usable after
+compaction.
+
+The host hides the tool when the main request is vision-compatible or no vision
+target is selected.

package/agent-forge.json

@@ -0,0 +1,25 @@
+{
+	"packageFormatVersion": 1,
+	"id": "agent-forge.plugin.image-inspect",
+	"pluginVersion": "0.88.16",
+	"apiVersion": "1",
+	"minHostVersion": "0.85.14",
+	"capabilityRefs": [
+		{
+			"id": "vision.inspect",
+			"version": 1
+		}
+	],
+	"platform": {
+		"os": [
+			"windows",
+			"macos",
+			"linux"
+		],
+		"runtime": [
+			{
+				"name": "node"
+			}
+		]
+	}
+}

package/dist/capability.d.ts

@@ -0,0 +1,8 @@
+import type { CapabilityPluginSyncFactory } from "@agent-forge/plugin-sdk";
+/**
+ * `image_inspect` for a non-vision main model. The tool resolves the original
+ * image from the session branch by content reference and asks the selected
+ * vision model exactly one question in an isolated completion.
+ */
+export declare function createImageInspectCapabilityFactoryV1(): CapabilityPluginSyncFactory;
+//# sourceMappingURL=capability.d.ts.map

package/dist/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,2BAA2B,EAG3B,MAAM,yBAAyB,CAAC;AA8GjC;;;;GAIG;AACH,wBAAgB,qCAAqC,IAAI,2BAA2B,CAkEnF","sourcesContent":["import type {\n\tCapabilityAPI,\n\tCapabilityPluginSyncFactory,\n\tModelInvocationResultV1,\n\tSessionEntryView,\n} from \"@agent-forge/plugin-sdk\";\nimport { Type } from \"typebox\";\nimport { imageReferenceV1 } from \"./image-ref.ts\";\nimport { type ImageSizeV1, imageSizeV1 } from \"./image-size.ts\";\n\nconst IMAGE_INSPECT_PARAMETERS = Type.Object(\n\t{\n\t\timage_ref: Type.String({ minLength: 1, maxLength: 64, pattern: \"^image-[0-9a-f]{8}$\" }),\n\t\tquestion: Type.String({ minLength: 1, maxLength: 2000 }),\n\t},\n\t{ additionalProperties: false },\n);\n\nconst IMAGE_REFERENCE_PATTERN = /^image-[0-9a-f]{8}$/u;\n\ninterface ToolResultV1 {\n\treadonly content: Array<{ type: \"text\"; text: string }>;\n\treadonly details: unknown;\n}\n\ninterface FoundImageV1 {\n\treadonly data: string;\n\treadonly mimeType: string;\n}\n\nfunction objectInput(first: unknown, second: unknown): Record<string, unknown> {\n\tconst value = first !== null && typeof first === \"object\" && !Array.isArray(first) ? first : second;\n\tif (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n\t\tthrow new Error(\"image_inspect input must be an object\");\n\t}\n\treturn value as Record<string, unknown>;\n}\n\nfunction signalFrom(value: unknown): AbortSignal | undefined {\n\treturn value instanceof AbortSignal ? value : undefined;\n}\n\nfunction combineSignals(signals: readonly (AbortSignal | undefined)[]): AbortSignal | undefined {\n\tconst present = signals.filter((signal): signal is AbortSignal => signal !== undefined);\n\tif (present.length === 0) return undefined;\n\tif (present.length === 1) return present[0];\n\treturn AbortSignal.any(present);\n}\n\nfunction contentBlocks(content: unknown): unknown[] {\n\tif (Array.isArray(content)) return content;\n\tif (typeof content === \"string\") return [{ type: \"text\", text: content }];\n\treturn [];\n}\n\nfunction findImage(entries: readonly SessionEntryView[], reference: string): FoundImageV1 | undefined {\n\tfor (let entryIndex = entries.length - 1; entryIndex >= 0; entryIndex--) {\n\t\tconst entry = entries[entryIndex];\n\t\tif (entry?.type !== \"message\") continue;\n\t\tconst blocks = contentBlocks(entry.message?.content);\n\t\tfor (let blockIndex = blocks.length - 1; blockIndex >= 0; blockIndex--) {\n\t\t\tconst block = blocks[blockIndex];\n\t\t\tif (typeof block !== \"object\" || block === null) continue;\n\t\t\tconst record = block as Record<string, unknown>;\n\t\t\tif (record.type !== \"image\") continue;\n\t\t\tconst data = record.data;\n\t\t\tif (typeof data !== \"string\" || data === \"\") continue;\n\t\t\tif (imageReferenceV1(data) !== reference) continue;\n\t\t\tconst mimeType = typeof record.mimeType === \"string\" && record.mimeType !== \"\" ? record.mimeType : \"image/png\";\n\t\t\treturn { data, mimeType };\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction failed(code: string, message: string, details?: Record<string, unknown>): ToolResultV1 {\n\treturn {\n\t\tcontent: [{ type: \"text\", text: `image_inspect failed (${code}): ${message}` }],\n\t\tdetails: { version: 1, status: \"failed\", code, message, ...(details ?? {}) },\n\t};\n}\n\nfunction imageBasisNote(imageSize: ImageSizeV1 | undefined): string {\n\treturn imageSize === undefined\n\t\t? \"Image basis: original image, no crop; dimensions unavailable.\"\n\t\t: `Image basis: original ${imageSize.width}x${imageSize.height}, no crop. Coordinates are normalized to this image unless the answer states otherwise.`;\n}\n\nfunction resultFromInvocation(\n\tresult: ModelInvocationResultV1,\n\timageRef: string,\n\ttarget: { provider: string; id: string },\n\timageSize?: ImageSizeV1,\n): ToolResultV1 {\n\tif (result.status === \"cancelled\") {\n\t\treturn failed(\"cancelled\", \"image inspection was cancelled\", { imageRef, target });\n\t}\n\tif (result.status === \"failed\") {\n\t\treturn failed(result.error.code, result.error.message, { imageRef, target });\n\t}\n\treturn {\n\t\tcontent: [{ type: \"text\", text: `${result.text}\\n\\n${imageBasisNote(imageSize)}` }],\n\t\tdetails: {\n\t\t\tversion: 1,\n\t\t\tstatus: \"ok\",\n\t\t\timageRef,\n\t\t\ttarget,\n\t\t\tmodel: result.model,\n\t\t\t...(imageSize === undefined ? {} : { image: imageSize }),\n\t\t\t...(result.usage === undefined ? {} : { usage: result.usage }),\n\t\t\tnote: \"observation from the selected vision model; not the main model's own view\",\n\t\t},\n\t};\n}\n\n/**\n * `image_inspect` for a non-vision main model. The tool resolves the original\n * image from the session branch by content reference and asks the selected\n * vision model exactly one question in an isolated completion.\n */\nexport function createImageInspectCapabilityFactoryV1(): CapabilityPluginSyncFactory {\n\treturn (api: CapabilityAPI) => {\n\t\tapi.registerTool({\n\t\t\tname: \"image_inspect\",\n\t\t\tlabel: \"Image inspect\",\n\t\t\tdescription:\n\t\t\t\t\"Inspect an original image that the current model cannot see. Pass the image_ref from the image placeholder (or from an Available Images summary entry) and one question; a selected vision model answers. Do not use it when you can already see the image.\",\n\t\t\tparameters: IMAGE_INSPECT_PARAMETERS,\n\t\t\treadonlySafe: true,\n\t\t\tcapability: { key: \"visual_image\", hideWhenNative: true, requiresSelection: true },\n\t\t\texecute: async (first: unknown, second?: unknown, third?: unknown): Promise<ToolResultV1> => {\n\t\t\t\tlet input: Record<string, unknown>;\n\t\t\t\ttry {\n\t\t\t\t\tinput = objectInput(first, second);\n\t\t\t\t} catch (error) {\n\t\t\t\t\treturn failed(\"invalid_input\", error instanceof Error ? error.message : \"invalid input\");\n\t\t\t\t}\n\t\t\t\tconst imageRef = typeof input.image_ref === \"string\" ? input.image_ref : \"\";\n\t\t\t\tif (!IMAGE_REFERENCE_PATTERN.test(imageRef)) {\n\t\t\t\t\treturn failed(\"invalid_image_ref\", \"image_ref must be an image_ref value from the conversation\");\n\t\t\t\t}\n\t\t\t\tconst question = typeof input.question === \"string\" ? input.question.trim() : \"\";\n\t\t\t\tif (question === \"\") return failed(\"invalid_question\", \"question must be a non-empty string\");\n\n\t\t\t\tconst target = api.selection?.get(\"visual_image\");\n\t\t\t\tif (target === undefined) {\n\t\t\t\t\treturn failed(\"selection_missing\", \"no vision target is selected for this session\");\n\t\t\t\t}\n\t\t\t\tif (!target.available) {\n\t\t\t\t\treturn failed(\"selection_unavailable\", target.error ?? \"selected vision target is unavailable\", {\n\t\t\t\t\t\timageRef,\n\t\t\t\t\t\ttarget: { provider: target.provider, id: target.id },\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tconst image = findImage(api.session?.getBranchEntries() ?? [], imageRef);\n\t\t\t\tconst imageSize = image === undefined ? undefined : imageSizeV1(image.data, image.mimeType);\n\t\t\t\tif (image === undefined) {\n\t\t\t\t\treturn failed(\"image_unavailable\", `no image with reference ${imageRef} is available in this branch`, {\n\t\t\t\t\t\timageRef,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (api.modelInvocation === undefined) {\n\t\t\t\t\treturn failed(\"model_invocation_unavailable\", \"the host does not expose model invocation\", {\n\t\t\t\t\t\timageRef,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tconst signal = combineSignals([signalFrom(third) ?? signalFrom(second), api.sessionAbortSignal?.()]);\n\t\t\t\tif (signal?.aborted === true) return failed(\"cancelled\", \"image inspection was cancelled\", { imageRef });\n\t\t\t\tconst result = await api.modelInvocation.complete(\n\t\t\t\t\t{\n\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\ttarget: { provider: target.provider, id: target.id },\n\t\t\t\t\t\tcapability: \"visual_image\",\n\t\t\t\t\t\tsystemPrompt: `You inspect one image for another model. The image is the original, no crop${\n\t\t\t\t\t\t\timageSize === undefined ? \"\" : `, ${imageSize.width}x${imageSize.height} pixels`\n\t\t\t\t\t\t}. Answer only the question. Separate direct observation, inference, and uncertainty. Report any coordinates as normalized fractions in [0,1] relative to the full original image (origin top-left); use absolute pixels only when the question asks for them. Do not take over the main task or invent details that are not visible.`,\n\t\t\t\t\t\tprompt: question,\n\t\t\t\t\t\timages: [{ type: \"image\", data: image.data, mimeType: image.mimeType }],\n\t\t\t\t\t\tmaxTokens: 1200,\n\t\t\t\t\t},\n\t\t\t\t\tsignal === undefined ? {} : { signal },\n\t\t\t\t);\n\t\t\t\treturn resultFromInvocation(result, imageRef, { provider: target.provider, id: target.id }, imageSize);\n\t\t\t},\n\t\t});\n\t};\n}\n"]}

package/dist/capability.js

@@ -0,0 +1,158 @@
+import { Type } from "typebox";
+import { imageReferenceV1 } from "./image-ref.js";
+import { imageSizeV1 } from "./image-size.js";
+const IMAGE_INSPECT_PARAMETERS = Type.Object({
+    image_ref: Type.String({ minLength: 1, maxLength: 64, pattern: "^image-[0-9a-f]{8}$" }),
+    question: Type.String({ minLength: 1, maxLength: 2000 }),
+}, { additionalProperties: false });
+const IMAGE_REFERENCE_PATTERN = /^image-[0-9a-f]{8}$/u;
+function objectInput(first, second) {
+    const value = first !== null && typeof first === "object" && !Array.isArray(first) ? first : second;
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("image_inspect input must be an object");
+    }
+    return value;
+}
+function signalFrom(value) {
+    return value instanceof AbortSignal ? value : undefined;
+}
+function combineSignals(signals) {
+    const present = signals.filter((signal) => signal !== undefined);
+    if (present.length === 0)
+        return undefined;
+    if (present.length === 1)
+        return present[0];
+    return AbortSignal.any(present);
+}
+function contentBlocks(content) {
+    if (Array.isArray(content))
+        return content;
+    if (typeof content === "string")
+        return [{ type: "text", text: content }];
+    return [];
+}
+function findImage(entries, reference) {
+    for (let entryIndex = entries.length - 1; entryIndex >= 0; entryIndex--) {
+        const entry = entries[entryIndex];
+        if (entry?.type !== "message")
+            continue;
+        const blocks = contentBlocks(entry.message?.content);
+        for (let blockIndex = blocks.length - 1; blockIndex >= 0; blockIndex--) {
+            const block = blocks[blockIndex];
+            if (typeof block !== "object" || block === null)
+                continue;
+            const record = block;
+            if (record.type !== "image")
+                continue;
+            const data = record.data;
+            if (typeof data !== "string" || data === "")
+                continue;
+            if (imageReferenceV1(data) !== reference)
+                continue;
+            const mimeType = typeof record.mimeType === "string" && record.mimeType !== "" ? record.mimeType : "image/png";
+            return { data, mimeType };
+        }
+    }
+    return undefined;
+}
+function failed(code, message, details) {
+    return {
+        content: [{ type: "text", text: `image_inspect failed (${code}): ${message}` }],
+        details: { version: 1, status: "failed", code, message, ...(details ?? {}) },
+    };
+}
+function imageBasisNote(imageSize) {
+    return imageSize === undefined
+        ? "Image basis: original image, no crop; dimensions unavailable."
+        : `Image basis: original ${imageSize.width}x${imageSize.height}, no crop. Coordinates are normalized to this image unless the answer states otherwise.`;
+}
+function resultFromInvocation(result, imageRef, target, imageSize) {
+    if (result.status === "cancelled") {
+        return failed("cancelled", "image inspection was cancelled", { imageRef, target });
+    }
+    if (result.status === "failed") {
+        return failed(result.error.code, result.error.message, { imageRef, target });
+    }
+    return {
+        content: [{ type: "text", text: `${result.text}\n\n${imageBasisNote(imageSize)}` }],
+        details: {
+            version: 1,
+            status: "ok",
+            imageRef,
+            target,
+            model: result.model,
+            ...(imageSize === undefined ? {} : { image: imageSize }),
+            ...(result.usage === undefined ? {} : { usage: result.usage }),
+            note: "observation from the selected vision model; not the main model's own view",
+        },
+    };
+}
+/**
+ * `image_inspect` for a non-vision main model. The tool resolves the original
+ * image from the session branch by content reference and asks the selected
+ * vision model exactly one question in an isolated completion.
+ */
+export function createImageInspectCapabilityFactoryV1() {
+    return (api) => {
+        api.registerTool({
+            name: "image_inspect",
+            label: "Image inspect",
+            description: "Inspect an original image that the current model cannot see. Pass the image_ref from the image placeholder (or from an Available Images summary entry) and one question; a selected vision model answers. Do not use it when you can already see the image.",
+            parameters: IMAGE_INSPECT_PARAMETERS,
+            readonlySafe: true,
+            capability: { key: "visual_image", hideWhenNative: true, requiresSelection: true },
+            execute: async (first, second, third) => {
+                let input;
+                try {
+                    input = objectInput(first, second);
+                }
+                catch (error) {
+                    return failed("invalid_input", error instanceof Error ? error.message : "invalid input");
+                }
+                const imageRef = typeof input.image_ref === "string" ? input.image_ref : "";
+                if (!IMAGE_REFERENCE_PATTERN.test(imageRef)) {
+                    return failed("invalid_image_ref", "image_ref must be an image_ref value from the conversation");
+                }
+                const question = typeof input.question === "string" ? input.question.trim() : "";
+                if (question === "")
+                    return failed("invalid_question", "question must be a non-empty string");
+                const target = api.selection?.get("visual_image");
+                if (target === undefined) {
+                    return failed("selection_missing", "no vision target is selected for this session");
+                }
+                if (!target.available) {
+                    return failed("selection_unavailable", target.error ?? "selected vision target is unavailable", {
+                        imageRef,
+                        target: { provider: target.provider, id: target.id },
+                    });
+                }
+                const image = findImage(api.session?.getBranchEntries() ?? [], imageRef);
+                const imageSize = image === undefined ? undefined : imageSizeV1(image.data, image.mimeType);
+                if (image === undefined) {
+                    return failed("image_unavailable", `no image with reference ${imageRef} is available in this branch`, {
+                        imageRef,
+                    });
+                }
+                if (api.modelInvocation === undefined) {
+                    return failed("model_invocation_unavailable", "the host does not expose model invocation", {
+                        imageRef,
+                    });
+                }
+                const signal = combineSignals([signalFrom(third) ?? signalFrom(second), api.sessionAbortSignal?.()]);
+                if (signal?.aborted === true)
+                    return failed("cancelled", "image inspection was cancelled", { imageRef });
+                const result = await api.modelInvocation.complete({
+                    version: 1,
+                    target: { provider: target.provider, id: target.id },
+                    capability: "visual_image",
+                    systemPrompt: `You inspect one image for another model. The image is the original, no crop${imageSize === undefined ? "" : `, ${imageSize.width}x${imageSize.height} pixels`}. Answer only the question. Separate direct observation, inference, and uncertainty. Report any coordinates as normalized fractions in [0,1] relative to the full original image (origin top-left); use absolute pixels only when the question asks for them. Do not take over the main task or invent details that are not visible.`,
+                    prompt: question,
+                    images: [{ type: "image", data: image.data, mimeType: image.mimeType }],
+                    maxTokens: 1200,
+                }, signal === undefined ? {} : { signal });
+                return resultFromInvocation(result, imageRef, { provider: target.provider, id: target.id }, imageSize);
+            },
+        });
+    };
+}
+//# sourceMappingURL=capability.js.map

package/dist/capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tCapabilityAPI,\n\tCapabilityPluginSyncFactory,\n\tModelInvocationResultV1,\n\tSessionEntryView,\n} from \"@agent-forge/plugin-sdk\";\nimport { Type } from \"typebox\";\nimport { imageReferenceV1 } from \"./image-ref.ts\";\nimport { type ImageSizeV1, imageSizeV1 } from \"./image-size.ts\";\n\nconst IMAGE_INSPECT_PARAMETERS = Type.Object(\n\t{\n\t\timage_ref: Type.String({ minLength: 1, maxLength: 64, pattern: \"^image-[0-9a-f]{8}$\" }),\n\t\tquestion: Type.String({ minLength: 1, maxLength: 2000 }),\n\t},\n\t{ additionalProperties: false },\n);\n\nconst IMAGE_REFERENCE_PATTERN = /^image-[0-9a-f]{8}$/u;\n\ninterface ToolResultV1 {\n\treadonly content: Array<{ type: \"text\"; text: string }>;\n\treadonly details: unknown;\n}\n\ninterface FoundImageV1 {\n\treadonly data: string;\n\treadonly mimeType: string;\n}\n\nfunction objectInput(first: unknown, second: unknown): Record<string, unknown> {\n\tconst value = first !== null && typeof first === \"object\" && !Array.isArray(first) ? first : second;\n\tif (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n\t\tthrow new Error(\"image_inspect input must be an object\");\n\t}\n\treturn value as Record<string, unknown>;\n}\n\nfunction signalFrom(value: unknown): AbortSignal | undefined {\n\treturn value instanceof AbortSignal ? value : undefined;\n}\n\nfunction combineSignals(signals: readonly (AbortSignal | undefined)[]): AbortSignal | undefined {\n\tconst present = signals.filter((signal): signal is AbortSignal => signal !== undefined);\n\tif (present.length === 0) return undefined;\n\tif (present.length === 1) return present[0];\n\treturn AbortSignal.any(present);\n}\n\nfunction contentBlocks(content: unknown): unknown[] {\n\tif (Array.isArray(content)) return content;\n\tif (typeof content === \"string\") return [{ type: \"text\", text: content }];\n\treturn [];\n}\n\nfunction findImage(entries: readonly SessionEntryView[], reference: string): FoundImageV1 | undefined {\n\tfor (let entryIndex = entries.length - 1; entryIndex >= 0; entryIndex--) {\n\t\tconst entry = entries[entryIndex];\n\t\tif (entry?.type !== \"message\") continue;\n\t\tconst blocks = contentBlocks(entry.message?.content);\n\t\tfor (let blockIndex = blocks.length - 1; blockIndex >= 0; blockIndex--) {\n\t\t\tconst block = blocks[blockIndex];\n\t\t\tif (typeof block !== \"object\" || block === null) continue;\n\t\t\tconst record = block as Record<string, unknown>;\n\t\t\tif (record.type !== \"image\") continue;\n\t\t\tconst data = record.data;\n\t\t\tif (typeof data !== \"string\" || data === \"\") continue;\n\t\t\tif (imageReferenceV1(data) !== reference) continue;\n\t\t\tconst mimeType = typeof record.mimeType === \"string\" && record.mimeType !== \"\" ? record.mimeType : \"image/png\";\n\t\t\treturn { data, mimeType };\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction failed(code: string, message: string, details?: Record<string, unknown>): ToolResultV1 {\n\treturn {\n\t\tcontent: [{ type: \"text\", text: `image_inspect failed (${code}): ${message}` }],\n\t\tdetails: { version: 1, status: \"failed\", code, message, ...(details ?? {}) },\n\t};\n}\n\nfunction imageBasisNote(imageSize: ImageSizeV1 | undefined): string {\n\treturn imageSize === undefined\n\t\t? \"Image basis: original image, no crop; dimensions unavailable.\"\n\t\t: `Image basis: original ${imageSize.width}x${imageSize.height}, no crop. Coordinates are normalized to this image unless the answer states otherwise.`;\n}\n\nfunction resultFromInvocation(\n\tresult: ModelInvocationResultV1,\n\timageRef: string,\n\ttarget: { provider: string; id: string },\n\timageSize?: ImageSizeV1,\n): ToolResultV1 {\n\tif (result.status === \"cancelled\") {\n\t\treturn failed(\"cancelled\", \"image inspection was cancelled\", { imageRef, target });\n\t}\n\tif (result.status === \"failed\") {\n\t\treturn failed(result.error.code, result.error.message, { imageRef, target });\n\t}\n\treturn {\n\t\tcontent: [{ type: \"text\", text: `${result.text}\\n\\n${imageBasisNote(imageSize)}` }],\n\t\tdetails: {\n\t\t\tversion: 1,\n\t\t\tstatus: \"ok\",\n\t\t\timageRef,\n\t\t\ttarget,\n\t\t\tmodel: result.model,\n\t\t\t...(imageSize === undefined ? {} : { image: imageSize }),\n\t\t\t...(result.usage === undefined ? {} : { usage: result.usage }),\n\t\t\tnote: \"observation from the selected vision model; not the main model's own view\",\n\t\t},\n\t};\n}\n\n/**\n * `image_inspect` for a non-vision main model. The tool resolves the original\n * image from the session branch by content reference and asks the selected\n * vision model exactly one question in an isolated completion.\n */\nexport function createImageInspectCapabilityFactoryV1(): CapabilityPluginSyncFactory {\n\treturn (api: CapabilityAPI) => {\n\t\tapi.registerTool({\n\t\t\tname: \"image_inspect\",\n\t\t\tlabel: \"Image inspect\",\n\t\t\tdescription:\n\t\t\t\t\"Inspect an original image that the current model cannot see. Pass the image_ref from the image placeholder (or from an Available Images summary entry) and one question; a selected vision model answers. Do not use it when you can already see the image.\",\n\t\t\tparameters: IMAGE_INSPECT_PARAMETERS,\n\t\t\treadonlySafe: true,\n\t\t\tcapability: { key: \"visual_image\", hideWhenNative: true, requiresSelection: true },\n\t\t\texecute: async (first: unknown, second?: unknown, third?: unknown): Promise<ToolResultV1> => {\n\t\t\t\tlet input: Record<string, unknown>;\n\t\t\t\ttry {\n\t\t\t\t\tinput = objectInput(first, second);\n\t\t\t\t} catch (error) {\n\t\t\t\t\treturn failed(\"invalid_input\", error instanceof Error ? error.message : \"invalid input\");\n\t\t\t\t}\n\t\t\t\tconst imageRef = typeof input.image_ref === \"string\" ? input.image_ref : \"\";\n\t\t\t\tif (!IMAGE_REFERENCE_PATTERN.test(imageRef)) {\n\t\t\t\t\treturn failed(\"invalid_image_ref\", \"image_ref must be an image_ref value from the conversation\");\n\t\t\t\t}\n\t\t\t\tconst question = typeof input.question === \"string\" ? input.question.trim() : \"\";\n\t\t\t\tif (question === \"\") return failed(\"invalid_question\", \"question must be a non-empty string\");\n\n\t\t\t\tconst target = api.selection?.get(\"visual_image\");\n\t\t\t\tif (target === undefined) {\n\t\t\t\t\treturn failed(\"selection_missing\", \"no vision target is selected for this session\");\n\t\t\t\t}\n\t\t\t\tif (!target.available) {\n\t\t\t\t\treturn failed(\"selection_unavailable\", target.error ?? \"selected vision target is unavailable\", {\n\t\t\t\t\t\timageRef,\n\t\t\t\t\t\ttarget: { provider: target.provider, id: target.id },\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tconst image = findImage(api.session?.getBranchEntries() ?? [], imageRef);\n\t\t\t\tconst imageSize = image === undefined ? undefined : imageSizeV1(image.data, image.mimeType);\n\t\t\t\tif (image === undefined) {\n\t\t\t\t\treturn failed(\"image_unavailable\", `no image with reference ${imageRef} is available in this branch`, {\n\t\t\t\t\t\timageRef,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (api.modelInvocation === undefined) {\n\t\t\t\t\treturn failed(\"model_invocation_unavailable\", \"the host does not expose model invocation\", {\n\t\t\t\t\t\timageRef,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tconst signal = combineSignals([signalFrom(third) ?? signalFrom(second), api.sessionAbortSignal?.()]);\n\t\t\t\tif (signal?.aborted === true) return failed(\"cancelled\", \"image inspection was cancelled\", { imageRef });\n\t\t\t\tconst result = await api.modelInvocation.complete(\n\t\t\t\t\t{\n\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\ttarget: { provider: target.provider, id: target.id },\n\t\t\t\t\t\tcapability: \"visual_image\",\n\t\t\t\t\t\tsystemPrompt: `You inspect one image for another model. The image is the original, no crop${\n\t\t\t\t\t\t\timageSize === undefined ? \"\" : `, ${imageSize.width}x${imageSize.height} pixels`\n\t\t\t\t\t\t}. Answer only the question. Separate direct observation, inference, and uncertainty. Report any coordinates as normalized fractions in [0,1] relative to the full original image (origin top-left); use absolute pixels only when the question asks for them. Do not take over the main task or invent details that are not visible.`,\n\t\t\t\t\t\tprompt: question,\n\t\t\t\t\t\timages: [{ type: \"image\", data: image.data, mimeType: image.mimeType }],\n\t\t\t\t\t\tmaxTokens: 1200,\n\t\t\t\t\t},\n\t\t\t\t\tsignal === undefined ? {} : { signal },\n\t\t\t\t);\n\t\t\t\treturn resultFromInvocation(result, imageRef, { provider: target.provider, id: target.id }, imageSize);\n\t\t\t},\n\t\t});\n\t};\n}\n"]}

package/dist/entry.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (api: import("@agent-forge/plugin-sdk").CapabilityAPI) => void | import("@agent-forge/plugin-sdk").CapabilityPluginSyncInstance;
+export default _default;
+//# sourceMappingURL=entry.d.ts.map

package/dist/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":";AAGA,wBAA6G","sourcesContent":["import type { CapabilityPluginSyncFactory } from \"@agent-forge/plugin-sdk\";\nimport { createImageInspectCapabilityFactoryV1 } from \"./capability.ts\";\n\nexport default ((api) => createImageInspectCapabilityFactoryV1()(api)) satisfies CapabilityPluginSyncFactory;\n"]}

package/dist/entry.js

@@ -0,0 +1,3 @@
+import { createImageInspectCapabilityFactoryV1 } from "./capability.js";
+export default ((api) => createImageInspectCapabilityFactoryV1()(api));
+//# sourceMappingURL=entry.js.map

package/dist/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qCAAqC,EAAE,MAAM,iBAAiB,CAAC;AAExE,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,qCAAqC,EAAE,CAAC,GAAG,CAAC,CAAuC,CAAC","sourcesContent":["import type { CapabilityPluginSyncFactory } from \"@agent-forge/plugin-sdk\";\nimport { createImageInspectCapabilityFactoryV1 } from \"./capability.ts\";\n\nexport default ((api) => createImageInspectCapabilityFactoryV1()(api)) satisfies CapabilityPluginSyncFactory;\n"]}

package/dist/image-ref.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Stable reference for an original image payload. Must stay identical to
+ * `imageReferenceV1` in packages/ai/src/api/transform-messages.ts: the model
+ * sees this value in the non-vision placeholder and passes it to image_inspect.
+ */
+export declare function imageReferenceV1(data: string): string;
+//# sourceMappingURL=image-ref.d.ts.map

package/dist/image-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-ref.d.ts","sourceRoot":"","sources":["../src/image-ref.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOrD","sourcesContent":["/**\n * Stable reference for an original image payload. Must stay identical to\n * `imageReferenceV1` in packages/ai/src/api/transform-messages.ts: the model\n * sees this value in the non-vision placeholder and passes it to image_inspect.\n */\nexport function imageReferenceV1(data: string): string {\n\tlet hash = 0x811c9dc5;\n\tfor (let index = 0; index < data.length; index++) {\n\t\thash ^= data.charCodeAt(index);\n\t\thash = Math.imul(hash, 0x01000193);\n\t}\n\treturn `image-${(hash >>> 0).toString(16).padStart(8, \"0\")}`;\n}\n"]}

package/dist/image-ref.js

@@ -0,0 +1,14 @@
+/**
+ * Stable reference for an original image payload. Must stay identical to
+ * `imageReferenceV1` in packages/ai/src/api/transform-messages.ts: the model
+ * sees this value in the non-vision placeholder and passes it to image_inspect.
+ */
+export function imageReferenceV1(data) {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < data.length; index++) {
+        hash ^= data.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return `image-${(hash >>> 0).toString(16).padStart(8, "0")}`;
+}
+//# sourceMappingURL=image-ref.js.map

package/dist/image-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-ref.js","sourceRoot":"","sources":["../src/image-ref.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAU;IACtD,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAClD,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,SAAS,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAAA,CAC7D","sourcesContent":["/**\n * Stable reference for an original image payload. Must stay identical to\n * `imageReferenceV1` in packages/ai/src/api/transform-messages.ts: the model\n * sees this value in the non-vision placeholder and passes it to image_inspect.\n */\nexport function imageReferenceV1(data: string): string {\n\tlet hash = 0x811c9dc5;\n\tfor (let index = 0; index < data.length; index++) {\n\t\thash ^= data.charCodeAt(index);\n\t\thash = Math.imul(hash, 0x01000193);\n\t}\n\treturn `image-${(hash >>> 0).toString(16).padStart(8, \"0\")}`;\n}\n"]}

package/dist/image-size.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Minimal image header reader for the original-image basis note.
+ *
+ * Vision providers may resize the image before the model sees it, so
+ * coordinates from the model must be anchored to a server-visible fact: the
+ * original image's dimensions. Only the header is read; no decoding.
+ */
+export interface ImageSizeV1 {
+    readonly width: number;
+    readonly height: number;
+}
+export declare function imageSizeV1(base64: string, mimeType?: string): ImageSizeV1 | undefined;
+//# sourceMappingURL=image-size.d.ts.map

package/dist/image-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-size.d.ts","sourceRoot":"","sources":["../src/image-size.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AA6DD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAgBtF","sourcesContent":["/**\n * Minimal image header reader for the original-image basis note.\n *\n * Vision providers may resize the image before the model sees it, so\n * coordinates from the model must be anchored to a server-visible fact: the\n * original image's dimensions. Only the header is read; no decoding.\n */\n\nexport interface ImageSizeV1 {\n\treadonly width: number;\n\treadonly height: number;\n}\n\nfunction pngSize(bytes: Buffer): ImageSizeV1 | undefined {\n\tif (bytes.length < 24) return undefined;\n\tconst signature = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];\n\tfor (let index = 0; index < signature.length; index++) {\n\t\tif (bytes[index] !== signature[index]) return undefined;\n\t}\n\tif (bytes.toString(\"ascii\", 12, 16) !== \"IHDR\") return undefined;\n\treturn { width: bytes.readUInt32BE(16), height: bytes.readUInt32BE(20) };\n}\n\nfunction gifSize(bytes: Buffer): ImageSizeV1 | undefined {\n\tif (bytes.length < 10) return undefined;\n\tconst header = bytes.toString(\"ascii\", 0, 6);\n\tif (header !== \"GIF87a\" && header !== \"GIF89a\") return undefined;\n\treturn { width: bytes.readUInt16LE(6), height: bytes.readUInt16LE(8) };\n}\n\nfunction jpegSize(bytes: Buffer): ImageSizeV1 | undefined {\n\tif (bytes.length < 4 || bytes[0] !== 0xff || bytes[1] !== 0xd8) return undefined;\n\tlet offset = 2;\n\twhile (offset + 4 <= bytes.length) {\n\t\tif (bytes[offset] !== 0xff) return undefined;\n\t\tlet marker = bytes[offset + 1] ?? 0;\n\t\twhile (marker === 0xff) {\n\t\t\toffset++;\n\t\t\tmarker = bytes[offset + 1] ?? 0;\n\t\t}\n\t\toffset += 2;\n\t\tif (marker === 0xd8 || marker === 0xd9 || marker === 0x01 || (marker >= 0xd0 && marker <= 0xd7)) continue;\n\t\tif (offset + 2 > bytes.length) return undefined;\n\t\tconst length = bytes.readUInt16BE(offset);\n\t\tif (length < 2) return undefined;\n\t\tconst isStartOfFrame = marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc;\n\t\tif (isStartOfFrame) {\n\t\t\tif (offset + 7 > bytes.length) return undefined;\n\t\t\treturn { height: bytes.readUInt16BE(offset + 3), width: bytes.readUInt16BE(offset + 5) };\n\t\t}\n\t\toffset += length;\n\t}\n\treturn undefined;\n}\n\nfunction webpSize(bytes: Buffer): ImageSizeV1 | undefined {\n\tif (bytes.length < 30) return undefined;\n\tif (bytes.toString(\"ascii\", 0, 4) !== \"RIFF\" || bytes.toString(\"ascii\", 8, 12) !== \"WEBP\") return undefined;\n\tconst chunk = bytes.toString(\"ascii\", 12, 16);\n\tif (chunk === \"VP8X\") {\n\t\treturn { width: 1 + bytes.readUIntLE(24, 3), height: 1 + bytes.readUIntLE(27, 3) };\n\t}\n\tif (chunk === \"VP8 \") {\n\t\treturn { width: bytes.readUInt16LE(26) & 0x3fff, height: bytes.readUInt16LE(28) & 0x3fff };\n\t}\n\tif (chunk === \"VP8L\") {\n\t\tconst bits = bytes.readUInt32LE(21);\n\t\treturn { width: 1 + (bits & 0x3fff), height: 1 + ((bits >> 14) & 0x3fff) };\n\t}\n\treturn undefined;\n}\n\nexport function imageSizeV1(base64: string, mimeType?: string): ImageSizeV1 | undefined {\n\tlet bytes: Buffer;\n\ttry {\n\t\tbytes = Buffer.from(base64, \"base64\");\n\t} catch {\n\t\treturn undefined;\n\t}\n\tconst size =\n\t\tmimeType === \"image/gif\"\n\t\t\t? gifSize(bytes)\n\t\t\t: mimeType === \"image/jpeg\"\n\t\t\t\t? jpegSize(bytes)\n\t\t\t\t: mimeType === \"image/webp\"\n\t\t\t\t\t? webpSize(bytes)\n\t\t\t\t\t: (pngSize(bytes) ?? gifSize(bytes) ?? jpegSize(bytes) ?? webpSize(bytes));\n\treturn size !== undefined && size.width > 0 && size.height > 0 ? size : undefined;\n}\n"]}

package/dist/image-size.js

@@ -0,0 +1,93 @@
+/**
+ * Minimal image header reader for the original-image basis note.
+ *
+ * Vision providers may resize the image before the model sees it, so
+ * coordinates from the model must be anchored to a server-visible fact: the
+ * original image's dimensions. Only the header is read; no decoding.
+ */
+function pngSize(bytes) {
+    if (bytes.length < 24)
+        return undefined;
+    const signature = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];
+    for (let index = 0; index < signature.length; index++) {
+        if (bytes[index] !== signature[index])
+            return undefined;
+    }
+    if (bytes.toString("ascii", 12, 16) !== "IHDR")
+        return undefined;
+    return { width: bytes.readUInt32BE(16), height: bytes.readUInt32BE(20) };
+}
+function gifSize(bytes) {
+    if (bytes.length < 10)
+        return undefined;
+    const header = bytes.toString("ascii", 0, 6);
+    if (header !== "GIF87a" && header !== "GIF89a")
+        return undefined;
+    return { width: bytes.readUInt16LE(6), height: bytes.readUInt16LE(8) };
+}
+function jpegSize(bytes) {
+    if (bytes.length < 4 || bytes[0] !== 0xff || bytes[1] !== 0xd8)
+        return undefined;
+    let offset = 2;
+    while (offset + 4 <= bytes.length) {
+        if (bytes[offset] !== 0xff)
+            return undefined;
+        let marker = bytes[offset + 1] ?? 0;
+        while (marker === 0xff) {
+            offset++;
+            marker = bytes[offset + 1] ?? 0;
+        }
+        offset += 2;
+        if (marker === 0xd8 || marker === 0xd9 || marker === 0x01 || (marker >= 0xd0 && marker <= 0xd7))
+            continue;
+        if (offset + 2 > bytes.length)
+            return undefined;
+        const length = bytes.readUInt16BE(offset);
+        if (length < 2)
+            return undefined;
+        const isStartOfFrame = marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc;
+        if (isStartOfFrame) {
+            if (offset + 7 > bytes.length)
+                return undefined;
+            return { height: bytes.readUInt16BE(offset + 3), width: bytes.readUInt16BE(offset + 5) };
+        }
+        offset += length;
+    }
+    return undefined;
+}
+function webpSize(bytes) {
+    if (bytes.length < 30)
+        return undefined;
+    if (bytes.toString("ascii", 0, 4) !== "RIFF" || bytes.toString("ascii", 8, 12) !== "WEBP")
+        return undefined;
+    const chunk = bytes.toString("ascii", 12, 16);
+    if (chunk === "VP8X") {
+        return { width: 1 + bytes.readUIntLE(24, 3), height: 1 + bytes.readUIntLE(27, 3) };
+    }
+    if (chunk === "VP8 ") {
+        return { width: bytes.readUInt16LE(26) & 0x3fff, height: bytes.readUInt16LE(28) & 0x3fff };
+    }
+    if (chunk === "VP8L") {
+        const bits = bytes.readUInt32LE(21);
+        return { width: 1 + (bits & 0x3fff), height: 1 + ((bits >> 14) & 0x3fff) };
+    }
+    return undefined;
+}
+export function imageSizeV1(base64, mimeType) {
+    let bytes;
+    try {
+        bytes = Buffer.from(base64, "base64");
+    }
+    catch {
+        return undefined;
+    }
+    const size = mimeType === "image/gif"
+        ? gifSize(bytes)
+        : mimeType === "image/jpeg"
+            ? jpegSize(bytes)
+            : mimeType === "image/webp"
+                ? webpSize(bytes)
+                : (pngSize(bytes) ?? gifSize(bytes) ?? jpegSize(bytes) ?? webpSize(bytes));
+    return size !== undefined && size.width > 0 && size.height > 0 ? size : undefined;
+}
+//# sourceMappingURL=image-size.js.map

package/dist/image-size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-size.js","sourceRoot":"","sources":["../src/image-size.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Minimal image header reader for the original-image basis note.\n *\n * Vision providers may resize the image before the model sees it, so\n * coordinates from the model must be anchored to a server-visible fact: the\n * original image's dimensions. Only the header is read; no decoding.\n */\n\nexport interface ImageSizeV1 {\n\treadonly width: number;\n\treadonly height: number;\n}\n\nfunction pngSize(bytes: Buffer): ImageSizeV1 | undefined {\n\tif (bytes.length < 24) return undefined;\n\tconst signature = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];\n\tfor (let index = 0; index < signature.length; index++) {\n\t\tif (bytes[index] !== signature[index]) return undefined;\n\t}\n\tif (bytes.toString(\"ascii\", 12, 16) !== \"IHDR\") return undefined;\n\treturn { width: bytes.readUInt32BE(16), height: bytes.readUInt32BE(20) };\n}\n\nfunction gifSize(bytes: Buffer): ImageSizeV1 | undefined {\n\tif (bytes.length < 10) return undefined;\n\tconst header = bytes.toString(\"ascii\", 0, 6);\n\tif (header !== \"GIF87a\" && header !== \"GIF89a\") return undefined;\n\treturn { width: bytes.readUInt16LE(6), height: bytes.readUInt16LE(8) };\n}\n\nfunction jpegSize(bytes: Buffer): ImageSizeV1 | undefined {\n\tif (bytes.length < 4 || bytes[0] !== 0xff || bytes[1] !== 0xd8) return undefined;\n\tlet offset = 2;\n\twhile (offset + 4 <= bytes.length) {\n\t\tif (bytes[offset] !== 0xff) return undefined;\n\t\tlet marker = bytes[offset + 1] ?? 0;\n\t\twhile (marker === 0xff) {\n\t\t\toffset++;\n\t\t\tmarker = bytes[offset + 1] ?? 0;\n\t\t}\n\t\toffset += 2;\n\t\tif (marker === 0xd8 || marker === 0xd9 || marker === 0x01 || (marker >= 0xd0 && marker <= 0xd7)) continue;\n\t\tif (offset + 2 > bytes.length) return undefined;\n\t\tconst length = bytes.readUInt16BE(offset);\n\t\tif (length < 2) return undefined;\n\t\tconst isStartOfFrame = marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc;\n\t\tif (isStartOfFrame) {\n\t\t\tif (offset + 7 > bytes.length) return undefined;\n\t\t\treturn { height: bytes.readUInt16BE(offset + 3), width: bytes.readUInt16BE(offset + 5) };\n\t\t}\n\t\toffset += length;\n\t}\n\treturn undefined;\n}\n\nfunction webpSize(bytes: Buffer): ImageSizeV1 | undefined {\n\tif (bytes.length < 30) return undefined;\n\tif (bytes.toString(\"ascii\", 0, 4) !== \"RIFF\" || bytes.toString(\"ascii\", 8, 12) !== \"WEBP\") return undefined;\n\tconst chunk = bytes.toString(\"ascii\", 12, 16);\n\tif (chunk === \"VP8X\") {\n\t\treturn { width: 1 + bytes.readUIntLE(24, 3), height: 1 + bytes.readUIntLE(27, 3) };\n\t}\n\tif (chunk === \"VP8 \") {\n\t\treturn { width: bytes.readUInt16LE(26) & 0x3fff, height: bytes.readUInt16LE(28) & 0x3fff };\n\t}\n\tif (chunk === \"VP8L\") {\n\t\tconst bits = bytes.readUInt32LE(21);\n\t\treturn { width: 1 + (bits & 0x3fff), height: 1 + ((bits >> 14) & 0x3fff) };\n\t}\n\treturn undefined;\n}\n\nexport function imageSizeV1(base64: string, mimeType?: string): ImageSizeV1 | undefined {\n\tlet bytes: Buffer;\n\ttry {\n\t\tbytes = Buffer.from(base64, \"base64\");\n\t} catch {\n\t\treturn undefined;\n\t}\n\tconst size =\n\t\tmimeType === \"image/gif\"\n\t\t\t? gifSize(bytes)\n\t\t\t: mimeType === \"image/jpeg\"\n\t\t\t\t? jpegSize(bytes)\n\t\t\t\t: mimeType === \"image/webp\"\n\t\t\t\t\t? webpSize(bytes)\n\t\t\t\t\t: (pngSize(bytes) ?? gifSize(bytes) ?? jpegSize(bytes) ?? webpSize(bytes));\n\treturn size !== undefined && size.width > 0 && size.height > 0 ? size : undefined;\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createImageInspectCapabilityFactoryV1 } from "./capability.ts";
+export { imageReferenceV1 } from "./image-ref.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC","sourcesContent":["export { createImageInspectCapabilityFactoryV1 } from \"./capability.ts\";\nexport { imageReferenceV1 } from \"./image-ref.ts\";\n"]}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createImageInspectCapabilityFactoryV1 } from "./capability.js";
+export { imageReferenceV1 } from "./image-ref.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC","sourcesContent":["export { createImageInspectCapabilityFactoryV1 } from \"./capability.ts\";\nexport { imageReferenceV1 } from \"./image-ref.ts\";\n"]}

package/package.json

@@ -1,6 +1,56 @@
 {
-  "name": "@ai-agent-forge/plugin-image-inspect",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+	"name": "@ai-agent-forge/plugin-image-inspect",
+	"version": "0.88.16",
+	"description": "Supplemental image inspection capability for non-vision models",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"MANUAL.md",
+		"agent-forge.json",
+		"plugin.json",
+		"README.md"
+	],
+	"scripts": {
+		"clean": "shx rm -rf dist",
+		"build": "tsgo -p tsconfig.build.json",
+		"test": "vitest --run",
+		"prepublishOnly": "npm run clean && npm run build",
+		"test:coverage": "vitest --run --coverage"
+	},
+	"keywords": [
+		"agent-forge",
+		"plugin",
+		"vision",
+		"image"
+	],
+	"author": "Agent Forge contributors",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/agent-forge/agent-forge.git",
+		"directory": "plugins/image-inspect"
+	},
+	"bugs": {
+		"url": "https://github.com/agent-forge/agent-forge/issues"
+	},
+	"homepage": "https://github.com/agent-forge/agent-forge#readme",
+	"engines": {
+		"node": ">=22.19.0"
+	},
+	"dependencies": {
+		"typebox": "1.3.27",
+		"@ai-agent-forge/plugin-sdk": "^0.88.16"
+	},
+	"devDependencies": {
+		"shx": "0.3.4",
+		"vitest": "4.1.11"
+	}
+}

package/plugin.json

@@ -0,0 +1,19 @@
+{
+	"id": "agent-forge.plugin.image-inspect",
+	"version": "0.88.16",
+	"apiVersion": "1-draft",
+	"entry": "./dist/entry.js",
+	"hostVersion": ">=0.84.4",
+	"description": "补充识图:主模型无原生视觉时,用会话已选视觉模型查看原图并回答指定问题",
+	"activation": "always",
+	"requiredCapabilities": [
+		"tools"
+	],
+	"provides": [
+		{
+			"id": "vision.inspect",
+			"version": 1,
+			"kind": "contribution"
+		}
+	]
+}