@link.me/eve 0.4.0 → 0.4.2

package/dist/extension/instructions.md

@@ -1,3 +1,3 @@
 Use Linkme only for the authenticated user attached to the current session. Discover remote tools through the `platform` connection; never ask the user to paste a token.
 
-Treat approval gates as authoritative. Re-read affected state after every write. A remote MCP tool cannot access eve's `/workspace`; use `prepare_media` for an AP video and pass its returned key as `videoReference`.
+Treat approval gates as authoritative. Re-read affected state after every write. A remote MCP tool cannot access eve's `/workspace`; use `prepare_media` for AP images/videos. Use the returned video key as `videoReference`, image `assetId` as `uploadAssetId` with `format: "image"`, or ordered `asset:<id>` values as `mediaReference` for carousels. Text posts need no upload.

package/dist/extension/lib/media.d.ts

@@ -1,7 +1,11 @@
 import { z } from "zod";
-export declare const VIDEO_CONTENT_TYPES: readonly ["video/mp4", "video/quicktime", "video/webm", "video/x-m4v", "video/x-matroska", "video/x-msvideo", "video/mpeg"];
+export declare const MEDIA_CONTENT_TYPES: readonly ["image/jpeg", "image/png", "image/webp", "image/gif", "image/avif", "image/heic", "image/heif", "video/mp4", "video/quicktime", "video/webm", "video/x-m4v", "video/x-matroska", "video/x-msvideo", "video/mpeg"];
 declare const finalizeUploadSchema: z.ZodObject<{
     assetId: z.ZodNumber;
+    image: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
     status: z.ZodEnum<{
         failed: "failed";
         processing: "processing";
@@ -20,21 +24,21 @@ export declare function parseSandboxStat(stdout: string): {
     path: string;
     size: number;
 };
-export declare function validateVideoDescriptor(input: {
+export declare function validateMediaDescriptor(input: {
     readonly path: string;
-    readonly contentType: (typeof VIDEO_CONTENT_TYPES)[number];
+    readonly contentType: (typeof MEDIA_CONTENT_TYPES)[number];
     readonly size: number;
     readonly maxBytes: number;
 }): {
     filename: string;
-    contentType: (typeof VIDEO_CONTENT_TYPES)[number];
+    contentType: (typeof MEDIA_CONTENT_TYPES)[number];
     size: number;
 };
 export declare function exactSizeStream(source: ReadableStream<Uint8Array>, expectedBytes: number): ReadableStream<Uint8Array>;
 type DirectIngestInput = {
     readonly apiBaseUrl: string;
     readonly bearerToken: string;
-    readonly contentType: (typeof VIDEO_CONTENT_TYPES)[number];
+    readonly contentType: (typeof MEDIA_CONTENT_TYPES)[number];
     readonly filename: string;
     readonly finalizeIdempotencyKey: string;
     readonly prepareIdempotencyKey: string;
@@ -43,9 +47,13 @@ type DirectIngestInput = {
     readonly stream: ReadableStream<Uint8Array>;
 };
 type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
-export declare function directIngestVideo(input: DirectIngestInput, fetchImpl?: FetchLike): Promise<{
+export declare function directIngestMedia(input: DirectIngestInput, fetchImpl?: FetchLike): Promise<{
     key: string;
     assetId: number;
     status: z.infer<typeof finalizeUploadSchema>["status"];
+    image?: {
+        width: number;
+        height: number;
+    };
 }>;
 export {};

package/dist/extension/lib/media.mjs

@@ -6,7 +6,14 @@ __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { z } from "zod";
 import { basename, extname, posix } from "node:path";
-const VIDEO_CONTENT_TYPES = [
+const MEDIA_CONTENT_TYPES = [
+	"image/jpeg",
+	"image/png",
+	"image/webp",
+	"image/gif",
+	"image/avif",
+	"image/heic",
+	"image/heif",
 	"video/mp4",
 	"video/quicktime",
 	"video/webm",
@@ -16,6 +23,13 @@ const VIDEO_CONTENT_TYPES = [
 	"video/mpeg"
 ];
 const EXTENSIONS_BY_CONTENT_TYPE = {
+	"image/jpeg": [".jpg", ".jpeg"],
+	"image/png": [".png"],
+	"image/webp": [".webp"],
+	"image/gif": [".gif"],
+	"image/avif": [".avif"],
+	"image/heic": [".heic"],
+	"image/heif": [".heif"],
 	"video/mp4": [".mp4"],
 	"video/quicktime": [".mov"],
 	"video/webm": [".webm"],
@@ -35,6 +49,10 @@ const prepareUploadSchema = z.object({
 });
 const finalizeUploadSchema = z.object({
 	assetId: z.number().int(),
+	image: z.object({
+		width: z.number().positive(),
+		height: z.number().positive()
+	}).optional(),
 	status: z.enum([
 		"uploaded",
 		"processing",
@@ -82,9 +100,10 @@ function parseSandboxStat(stdout) {
 		size
 	};
 }
-function validateVideoDescriptor(input) {
-	if (!Number.isSafeInteger(input.size) || input.size <= 0) throw new Error("Video must be non-empty.");
-	if (input.size > input.maxBytes) throw new Error(`Video exceeds the configured ${input.maxBytes}-byte limit.`);
+function validateMediaDescriptor(input) {
+	if (!Number.isSafeInteger(input.size) || input.size <= 0) throw new Error("Media must be non-empty.");
+	const maxBytes = input.contentType.startsWith("image/") ? Math.min(input.maxBytes, 8388608) : input.maxBytes;
+	if (input.size > maxBytes) throw new Error(`Media exceeds the configured ${maxBytes}-byte limit.`);
 	const filename = basename(input.path);
 	const extension = extname(filename).toLowerCase();
 	if (!EXTENSIONS_BY_CONTENT_TYPE[input.contentType].includes(extension)) throw new Error(`File extension ${extension || "(none)"} does not match ${input.contentType}.`);
@@ -121,7 +140,7 @@ function exactSizeStream(source, expectedBytes) {
 		}
 	});
 }
-async function directIngestVideo(input, fetchImpl = fetch) {
+async function directIngestMedia(input, fetchImpl = fetch) {
 	const apiHeaders = {
 		accept: "application/json",
 		authorization: `Bearer ${input.bearerToken}`,
@@ -178,11 +197,12 @@ async function directIngestVideo(input, fetchImpl = fetch) {
 	return {
 		key: prepared.key,
 		assetId: finalized.assetId,
-		status: finalized.status
+		status: finalized.status,
+		...finalized.image ? { image: finalized.image } : {}
 	};
 }
 async function requireApiSuccess(response) {
 	if (response.status === 401) throw new LinkmeUnauthorizedError();
 	if (!response.ok) throw new Error(`Linkme media API failed with status ${response.status}.`);
 }
-export { LinkmeUnauthorizedError, VIDEO_CONTENT_TYPES, directIngestVideo, exactSizeStream, normalizeSandboxPath, parseSandboxStat, sandboxStatCommand, shellQuote, validateVideoDescriptor };
+export { LinkmeUnauthorizedError, MEDIA_CONTENT_TYPES, directIngestMedia, exactSizeStream, normalizeSandboxPath, parseSandboxStat, sandboxStatCommand, shellQuote, validateMediaDescriptor };

package/dist/extension/skills/prepare-media/SKILL.md

@@ -7,16 +7,16 @@ description: Prepare video, image, or document inputs for Linkme agent workflows
 
 First identify the source:
 
-- Eve sandbox path: remote MCP cannot read it. For AP video, call `prepare_media`, then use the returned durable key.
+- Eve sandbox path: remote MCP cannot read it. For AP images/videos, call `prepare_media`, then retain the returned durable asset ID and key.
 - Hosted file object or HTTPS URL: pass it only to a remote tool that explicitly declares that bounded file input.
 - Existing Linkme object key: pass it as the tool's reference field; do not download and re-upload it.
 
 For `prepare_media`:
 
 1. Ensure the path is inside `/workspace`.
-2. Supply the real video MIME type matching the extension.
+2. Supply the real image/video MIME type matching the extension.
 3. Respect the human approval: this transfers user bytes to Linkme.
 4. Keep the returned `key`, `assetId`, and status together.
 5. Wait for or inspect processing state when a downstream operation requires ready media.
 
-The native bridge currently supports AP video only. Do not claim it uploads profile/gallery images or documents. Never proxy a large video through the hosted MCP process.
+The native bridge supports AP images and videos. Raw images are limited to 8 MiB and AP normalizes them to still JPEGs. Use image asset IDs for image posts and ordered asset IDs for carousel posts; bare R2 keys remain video-only. Do not claim it uploads profile/gallery images or documents. Never proxy a large video through the hosted MCP process.

package/dist/extension/skills/publish-content/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: publish-content
-description: Plan, preflight, schedule, publish, inspect, or cancel Linkme multi-platform short-form video posts. Use for YouTube Shorts, Instagram Reels or Stories, TikTok, and other AP publishing workflows.
+description: Plan, preflight, schedule, publish, inspect, or cancel Linkme multi-platform video, image, carousel, and text posts. Use for YouTube Shorts, Instagram Reels or Stories, TikTok, and other AP publishing workflows.
 ---
 
 # Publish Linkme content
 
 1. Discover the `platform` connection's account, limit, post, and capability tools.
 2. Read connected accounts and limits before preparing a post. Report missing or reconnect-required providers.
-3. If the video is in `/workspace`, load the media skill and call `prepare_media`. Use its returned key as `videoReference`; never send the sandbox path to MCP.
+3. If media is in `/workspace`, load the media skill and call `prepare_media`. Use the returned key as `videoReference` for video, `assetId` as `uploadAssetId` with `format: "image"` for an image, or ordered `asset:<id>` values as `mediaReference` for a carousel. Text posts use `format: "text"` and a nonblank caption without uploads; never send the sandbox path to MCP.
 4. Resolve caption, platforms, provider account IDs, timezone, schedule, privacy, and commercial-content settings. Ask only for consequential missing choices.
 5. Summarize the exact publish plan before the approval-gated create call.
 6. Create once. Preserve the returned post ID and do not retry an ambiguous timeout without first listing or getting the post.

package/dist/extension/tools/prepare_media.d.ts

@@ -1,13 +1,17 @@
 declare const _default: import("eve/tools").ToolDefinition<{
     sandboxPath: string;
-    contentType: "video/mp4" | "video/mpeg" | "video/quicktime" | "video/webm" | "video/x-m4v" | "video/x-matroska" | "video/x-msvideo";
+    contentType: "image/avif" | "image/gif" | "image/heic" | "image/heif" | "image/jpeg" | "image/png" | "image/webp" | "video/mp4" | "video/mpeg" | "video/quicktime" | "video/webm" | "video/x-m4v" | "video/x-matroska" | "video/x-msvideo";
 }, {
-    kind: "video";
+    kind: "image" | "video";
     key: string;
     assetId: number;
+    image?: {
+        width: number;
+        height: number;
+    } | undefined;
     status: "failed" | "processing" | "processing_failed" | "ready" | "uploaded";
     filename: string;
-    contentType: "video/mp4" | "video/mpeg" | "video/quicktime" | "video/webm" | "video/x-m4v" | "video/x-matroska" | "video/x-msvideo";
+    contentType: "image/avif" | "image/gif" | "image/heic" | "image/heif" | "image/jpeg" | "image/png" | "image/webp" | "video/mp4" | "video/mpeg" | "video/quicktime" | "video/webm" | "video/x-m4v" | "video/x-matroska" | "video/x-msvideo";
     sizeBytes: number;
     source: "linkme-direct-ingest";
 }>;

package/dist/extension/tools/prepare_media.mjs

@@ -7,13 +7,17 @@ __eveCreateRequire(import.meta.url);
 import extension_default from "../extension.mjs";
 import { linkmeMediaApproval } from "../lib/approval.mjs";
 import { linkmeAuth } from "../lib/auth.mjs";
-import { LinkmeUnauthorizedError, VIDEO_CONTENT_TYPES, directIngestVideo, parseSandboxStat, sandboxStatCommand, validateVideoDescriptor } from "../lib/media.mjs";
+import { LinkmeUnauthorizedError, MEDIA_CONTENT_TYPES, directIngestMedia, parseSandboxStat, sandboxStatCommand, validateMediaDescriptor } from "../lib/media.mjs";
 import { z } from "zod";
 import { defineTool } from "eve/tools";
 const outputSchema = z.object({
-	kind: z.literal("video"),
+	kind: z.enum(["image", "video"]),
 	key: z.string(),
 	assetId: z.number().int(),
+	image: z.object({
+		width: z.number().positive(),
+		height: z.number().positive()
+	}).optional(),
 	status: z.enum([
 		"uploaded",
 		"processing",
@@ -22,15 +26,15 @@ const outputSchema = z.object({
 		"processing_failed"
 	]),
 	filename: z.string(),
-	contentType: z.enum(VIDEO_CONTENT_TYPES),
+	contentType: z.enum(MEDIA_CONTENT_TYPES),
 	sizeBytes: z.number().int().positive(),
 	source: z.literal("linkme-direct-ingest")
 });
 var prepare_media_default = defineTool({
-	description: "Prepare an AP video already stored in this eve session's /workspace for Linkme publishing. Streams directly to Linkme and returns a durable key; never pass sandbox paths to remote MCP tools.",
+	description: "Prepare an AP image or video already stored in this eve session's /workspace for Linkme publishing. Streams directly to Linkme and returns a durable asset ID and key; never pass sandbox paths to remote MCP tools.",
 	inputSchema: z.object({
-		sandboxPath: z.string().min(1).describe("Relative path or absolute /workspace path for an existing sandbox video"),
-		contentType: z.enum(VIDEO_CONTENT_TYPES)
+		sandboxPath: z.string().min(1).describe("Relative path or absolute /workspace path for an existing sandbox image or video"),
+		contentType: z.enum(MEDIA_CONTENT_TYPES)
 	}),
 	outputSchema,
 	approval: linkmeMediaApproval,
@@ -39,7 +43,7 @@ var prepare_media_default = defineTool({
 		const inspected = await sandbox.run({ command: sandboxStatCommand(sandboxPath) });
 		if (inspected.exitCode !== 0) throw new Error("Media must resolve to one regular file inside /workspace.");
 		const stat = parseSandboxStat(inspected.stdout);
-		const video = validateVideoDescriptor({
+		const media = validateMediaDescriptor({
 			path: stat.path,
 			contentType,
 			size: stat.size,
@@ -53,22 +57,23 @@ var prepare_media_default = defineTool({
 		});
 		try {
 			const operationId = `${ctx.session.id}:${ctx.session.turn.id}:${ctx.callId}`;
+			const uploaded = await directIngestMedia({
+				apiBaseUrl: extension_default.config.apApiUrl,
+				bearerToken: token,
+				contentType: media.contentType,
+				filename: media.filename,
+				finalizeIdempotencyKey: `${operationId}:finalize`,
+				prepareIdempotencyKey: `${operationId}:prepare`,
+				signal: ctx.abortSignal,
+				size: media.size,
+				stream
+			});
 			return {
-				kind: "video",
-				...await directIngestVideo({
-					apiBaseUrl: extension_default.config.apApiUrl,
-					bearerToken: token,
-					contentType: video.contentType,
-					filename: video.filename,
-					finalizeIdempotencyKey: `${operationId}:finalize`,
-					prepareIdempotencyKey: `${operationId}:prepare`,
-					signal: ctx.abortSignal,
-					size: video.size,
-					stream
-				}),
-				filename: video.filename,
-				contentType: video.contentType,
-				sizeBytes: video.size,
+				kind: contentType.startsWith("image/") ? "image" : "video",
+				...uploaded,
+				filename: media.filename,
+				contentType: media.contentType,
+				sizeBytes: media.size,
 				source: "linkme-direct-ingest"
 			};
 		} catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link.me/eve",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Linkme MCP connection, media bridge, and agent skills for eve",
   "type": "module",
   "files": [