@actuate-media/plugin-ai 0.5.0 → 0.5.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @actuate-media/plugin-ai
 
+## 0.5.2
+
+### Patch Changes
+
+- 041a228: Add the MIT `license` field to every published package (previously missing) and correct `repository.url` to `github.com/actuate-media/actuatecms` (13 packages carried the wrong org).
+
+## 0.5.1
+
+### Patch Changes
+
+- 4afb589: WCAG-aligned AI alt text: improved vision prompts, feature-gated `/ai/media-metadata` with `aiAltText` suggestions, post-upload auto-suggest in Media, MCP `generate_media_alt` tool, and validation warnings for static image paths outside the media library.
+
 ## 0.5.0
 
 ### Minor Changes

package/dist/__tests__/alt-text-prompt.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=alt-text-prompt.test.d.ts.map

package/dist/__tests__/alt-text-prompt.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alt-text-prompt.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/alt-text-prompt.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/alt-text-prompt.test.js

@@ -0,0 +1,15 @@
+import { describe, expect, it } from 'vitest';
+import { normalizeGeneratedAltText } from '../media/alt-text-prompt.js';
+describe('normalizeGeneratedAltText', () => {
+    it('returns empty for decorative', () => {
+        expect(normalizeGeneratedAltText('anything', true)).toBe('');
+    });
+    it('strips redundant "image of" prefix', () => {
+        expect(normalizeGeneratedAltText('Image of a red bicycle parked outside', false)).toBe('a red bicycle parked outside');
+    });
+    it('clamps to 125 characters', () => {
+        const long = 'a'.repeat(200);
+        expect(normalizeGeneratedAltText(long, false).length).toBeLessThanOrEqual(125);
+    });
+});
+//# sourceMappingURL=alt-text-prompt.test.js.map

package/dist/__tests__/alt-text-prompt.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alt-text-prompt.test.js","sourceRoot":"","sources":["../../src/__tests__/alt-text-prompt.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAEvE,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,yBAAyB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,yBAAyB,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CACpF,8BAA8B,CAC/B,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC5B,MAAM,CAAC,yBAAyB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAA;IAChF,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/media/alt-text-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alt-text-generator.d.ts","sourceRoot":"","sources":["../../src/media/alt-text-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAInE,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,YAAY,GAAG,aAAa,GAAG,YAAY,CAAA;IACrD,QAAQ,CAAC,EAAE,UAAU,CAAA;IACrB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,OAAO,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAA;CACpB;AAKD;;kDAEkD;AAClD,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CA4DxB"}
+{"version":3,"file":"alt-text-generator.d.ts","sourceRoot":"","sources":["../../src/media/alt-text-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AASnE,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,YAAY,GAAG,aAAa,GAAG,YAAY,CAAA;IACrD,QAAQ,CAAC,EAAE,UAAU,CAAA;IACrB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,OAAO,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAA;CACpB;AAKD;;kDAEkD;AAClD,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAqExB"}

package/dist/media/alt-text-generator.js

@@ -1,4 +1,5 @@
 import { requireAIProvider } from '../providers/index.js';
+import { ALT_TEXT_JSON_SHAPE, ALT_TEXT_SYSTEM_PROMPT, normalizeGeneratedAltText, } from './alt-text-prompt.js';
 import { clampConfidence, stripJsonFences } from './json.js';
 /** Max confidence we'll report for a text-only (no real image) heuristic. */
 const HEURISTIC_MAX_CONFIDENCE = 0.4;
@@ -18,16 +19,11 @@ export async function generateAltText(imageUrl, context) {
     ]
         .filter(Boolean)
         .join('\n');
-    const jsonShape = `Return a JSON object with:
-- "altText": concise, descriptive alt text (max 125 characters)
-- "alternatives": array of 2 alternative alt text options
-- "confidence": number 0-1 for how confident you are`;
-    const systemPrompt = 'You are an accessibility expert. Generate descriptive, concise alt text for images. Return valid JSON only.';
     let result;
     if (canSeeImage) {
-        const prompt = `Analyze the attached image and generate accessible alt text.\n\n${contextInfo ? `Context:\n${contextInfo}\n\n` : ''}${jsonShape}`;
+        const prompt = `Analyze the attached image and generate accessible alt text.\n\n${contextInfo ? `Context:\n${contextInfo}\n\n` : ''}${ALT_TEXT_JSON_SHAPE}`;
         result = await ai.analyzeImage(context.image, prompt, {
-            systemPrompt,
+            systemPrompt: ALT_TEXT_SYSTEM_PROMPT,
             maxTokens: 512,
             temperature: 0.3,
         });
@@ -35,17 +31,33 @@ export async function generateAltText(imageUrl, context) {
     else {
         // No vision: infer ONLY from context. Be explicit so the model doesn't
         // fabricate visual detail it cannot possibly know.
-        const prompt = `You CANNOT see the image. Based only on the context below and the file name, suggest plausible accessible alt text, and report low confidence since the image was not analyzed.\n\n${contextInfo ? `Context:\n${contextInfo}\n` : ''}File: ${imageUrl}\n\n${jsonShape}`;
-        result = await ai.generateText(prompt, { systemPrompt, maxTokens: 512, temperature: 0.3 });
+        const prompt = `You CANNOT see the image. Based only on the context below and the file name, suggest plausible accessible alt text, set isDecorative false unless context clearly indicates ornamentation, and report low confidence since the image was not analyzed.\n\n${contextInfo ? `Context:\n${contextInfo}\n` : ''}File: ${imageUrl}\n\n${ALT_TEXT_JSON_SHAPE}`;
+        result = await ai.generateText(prompt, {
+            systemPrompt: ALT_TEXT_SYSTEM_PROMPT,
+            maxTokens: 512,
+            temperature: 0.3,
+        });
     }
     try {
         const parsed = JSON.parse(stripJsonFences(result.text));
+        const isDecorative = parsed.isDecorative === true;
+        const altText = normalizeGeneratedAltText(parsed.altText ?? '', isDecorative);
         const rawConfidence = clampConfidence(parsed.confidence, canSeeImage ? 0.7 : 0.3);
+        const alternatives = isDecorative
+            ? []
+            : (Array.isArray(parsed.alternatives) ? parsed.alternatives : [])
+                .map((a) => normalizeGeneratedAltText(String(a ?? ''), false))
+                .filter(Boolean)
+                .slice(0, 2);
         return {
-            altText: parsed.altText ?? '',
-            isDecorative: false,
-            confidence: canSeeImage ? rawConfidence : Math.min(rawConfidence, HEURISTIC_MAX_CONFIDENCE),
-            alternatives: Array.isArray(parsed.alternatives) ? parsed.alternatives : [],
+            altText,
+            isDecorative,
+            confidence: isDecorative
+                ? 1
+                : canSeeImage
+                    ? rawConfidence
+                    : Math.min(rawConfidence, HEURISTIC_MAX_CONFIDENCE),
+            alternatives,
             usedVision: canSeeImage,
         };
     }

package/dist/media/alt-text-generator.js.map

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

package/dist/media/alt-text-prompt.d.ts

@@ -0,0 +1,6 @@
+/** WCAG-aligned alt-text guidance shared by vision and heuristic paths. */
+export declare const ALT_TEXT_SYSTEM_PROMPT = "You are an accessibility specialist writing alt text for web images (WCAG 2.1 / W3C best practices).\n\nRules:\n- Describe what matters for the image's purpose in context \u2014 not every visual detail.\n- Be concise: target \u2264125 characters; never exceed 125.\n- Do NOT start with \"image of\", \"photo of\", \"picture of\", or \"graphic of\" \u2014 screen readers already announce it as an image.\n- Do NOT include file names, dimensions, or SEO keyword stuffing.\n- Include visible text in the image when it is essential to understanding.\n- For people: describe relevant appearance only when needed for context; avoid speculative identity or sensitive traits.\n- If the image is purely decorative (borders, spacers, visual flourish with no informational value), set isDecorative true and altText to \"\".\n- For functional images (icons/buttons), describe the action or destination, not the pixel art.\n- When page context is provided, prefer alt text that fits the surrounding content.\n\nReturn valid JSON only.";
+export declare const ALT_TEXT_JSON_SHAPE = "Return a JSON object with:\n- \"altText\": string (empty when decorative)\n- \"isDecorative\": boolean\n- \"alternatives\": array of exactly 2 alternative alt text options (empty strings when decorative)\n- \"confidence\": number 0-1";
+/** Normalize model output to publishing-ready alt text. */
+export declare function normalizeGeneratedAltText(raw: string, isDecorative: boolean): string;
+//# sourceMappingURL=alt-text-prompt.d.ts.map

package/dist/media/alt-text-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alt-text-prompt.d.ts","sourceRoot":"","sources":["../../src/media/alt-text-prompt.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,kgCAaX,CAAA;AAExB,eAAO,MAAM,mBAAmB,8OAIL,CAAA;AAE3B,2DAA2D;AAC3D,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,CAOpF"}

package/dist/media/alt-text-prompt.js

@@ -0,0 +1,32 @@
+/** WCAG-aligned alt-text guidance shared by vision and heuristic paths. */
+export const ALT_TEXT_SYSTEM_PROMPT = `You are an accessibility specialist writing alt text for web images (WCAG 2.1 / W3C best practices).
+
+Rules:
+- Describe what matters for the image's purpose in context — not every visual detail.
+- Be concise: target ≤125 characters; never exceed 125.
+- Do NOT start with "image of", "photo of", "picture of", or "graphic of" — screen readers already announce it as an image.
+- Do NOT include file names, dimensions, or SEO keyword stuffing.
+- Include visible text in the image when it is essential to understanding.
+- For people: describe relevant appearance only when needed for context; avoid speculative identity or sensitive traits.
+- If the image is purely decorative (borders, spacers, visual flourish with no informational value), set isDecorative true and altText to "".
+- For functional images (icons/buttons), describe the action or destination, not the pixel art.
+- When page context is provided, prefer alt text that fits the surrounding content.
+
+Return valid JSON only.`;
+export const ALT_TEXT_JSON_SHAPE = `Return a JSON object with:
+- "altText": string (empty when decorative)
+- "isDecorative": boolean
+- "alternatives": array of exactly 2 alternative alt text options (empty strings when decorative)
+- "confidence": number 0-1`;
+/** Normalize model output to publishing-ready alt text. */
+export function normalizeGeneratedAltText(raw, isDecorative) {
+    if (isDecorative)
+        return '';
+    let s = raw.trim();
+    s = s.replace(/^(an?\s+)?(image|photo|picture|graphic|screenshot)\s+of\s+/i, '');
+    s = s.replace(/\s+/g, ' ').trim();
+    if (s.length > 125)
+        s = `${s.slice(0, 122).trim()}…`;
+    return s;
+}
+//# sourceMappingURL=alt-text-prompt.js.map

package/dist/media/alt-text-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alt-text-prompt.js","sourceRoot":"","sources":["../../src/media/alt-text-prompt.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;wBAad,CAAA;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;2BAIR,CAAA;AAE3B,2DAA2D;AAC3D,MAAM,UAAU,yBAAyB,CAAC,GAAW,EAAE,YAAqB;IAC1E,IAAI,YAAY;QAAE,OAAO,EAAE,CAAA;IAC3B,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;IAClB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,6DAA6D,EAAE,EAAE,CAAC,CAAA;IAChF,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IACjC,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG;QAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,CAAA;IACpD,OAAO,CAAC,CAAA;AACV,CAAC"}

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@actuate-media/plugin-ai",
-  "version": "0.5.0",
+  "version": "0.5.2",
+  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/actuatecms/actuatecms.git",
+    "url": "https://github.com/actuate-media/actuatecms.git",
     "directory": "packages/plugin-ai"
   },
   "publishConfig": {
@@ -27,7 +28,7 @@
     "@types/react": "^19.0.0",
     "typescript": "^5.7.0",
     "vitest": "^4.1.0",
-    "@actuate-media/cms-core": "0.67.0"
+    "@actuate-media/cms-core": "0.91.0"
   },
   "peerDependencies": {
     "@actuate-media/cms-core": ">=0.1.0",