coaiajs 0.4.2 → 0.4.3

package/dist/src/media-upload-proxy.js

@@ -0,0 +1,210 @@
+#!/usr/bin/env node
+// coaiajs/src/media-upload-proxy.ts — Custom GPT file-to-Langfuse media bridge
+import { timingSafeEqual } from 'node:crypto';
+import { createServer } from 'node:http';
+import { pathToFileURL } from 'node:url';
+import { uploadMediaBytes } from './langfuse/media.js';
+const DEFAULT_MAX_FILE_BYTES = 10 * 1024 * 1024;
+const DEFAULT_BODY_BYTES = 1024 * 1024;
+const DEFAULT_OPENAI_FILE_HOSTS = ['files.oaiusercontent.com', 'files.openai.com'];
+/** Download one Custom GPT conversation file and complete the Langfuse media upload flow. */
+export async function uploadOpenAIFileToLangfuse(input, options = {}) {
+    if (!Array.isArray(input.openaiFileIdRefs) || input.openaiFileIdRefs.length !== 1) {
+        throw new Error('openaiFileIdRefs must contain exactly one conversation file');
+    }
+    const file = parseOpenAIFileReference(input.openaiFileIdRefs[0]);
+    const allowedHosts = options.openAIFileHosts ?? configuredOpenAIFileHosts();
+    const bytes = await downloadFile(file.download_link, options.maxFileBytes ?? configuredMaxFileBytes(), allowedHosts);
+    const result = await uploadMediaBytes({
+        data: bytes,
+        fileName: file.name,
+        contentType: detectDownloadedContentType(bytes, file.mime_type),
+        traceId: input.traceId,
+        observationId: input.observationId,
+        datasetId: input.datasetId,
+        datasetItemId: input.datasetItemId,
+        field: input.field,
+        source: 'bytes',
+    });
+    return { ...result, openaiFileId: file.id };
+}
+/** Create the small HTTP service used by the companion Custom GPT action spec. */
+export function createMediaUploadProxyServer(options = {}) {
+    const apiKey = options.apiKey ?? process.env['COAIA_MEDIA_PROXY_API_KEY'];
+    if (!apiKey)
+        throw new Error('COAIA_MEDIA_PROXY_API_KEY is required');
+    const maxBodyBytes = options.maxBodyBytes ?? DEFAULT_BODY_BYTES;
+    return createServer(async (request, response) => {
+        try {
+            if (request.method === 'GET' && request.url === '/health') {
+                sendJson(response, 200, { ok: true });
+                return;
+            }
+            if (request.method !== 'POST' || request.url !== '/media/upload') {
+                sendJson(response, 404, { error: 'Not found' });
+                return;
+            }
+            if (!secureEqual(request.headers['x-coaia-proxy-key'], apiKey)) {
+                sendJson(response, 401, { error: 'Unauthorized' });
+                return;
+            }
+            const body = await readJsonBody(request, maxBodyBytes);
+            const result = await uploadOpenAIFileToLangfuse(body, options);
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const status = /too large/i.test(message) ? 413 : 400;
+            sendJson(response, status, { error: message });
+        }
+    });
+}
+async function readJsonBody(request, maxBytes) {
+    const contentType = String(request.headers['content-type'] ?? '').toLowerCase();
+    if (!contentType.startsWith('application/json'))
+        throw new Error('Content-Type must be application/json');
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of request) {
+        const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        size += bytes.byteLength;
+        if (size > maxBytes)
+            throw new Error(`Request body is too large (maximum ${maxBytes} bytes)`);
+        chunks.push(bytes);
+    }
+    try {
+        return JSON.parse(Buffer.concat(chunks).toString('utf8'));
+    }
+    catch {
+        throw new Error('Request body must contain valid JSON');
+    }
+}
+function parseOpenAIFileReference(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Custom GPT did not provide a runtime file reference object');
+    }
+    const record = value;
+    const file = {
+        name: record.name,
+        id: record.id,
+        mime_type: record.mime_type,
+        download_link: record.download_link,
+    };
+    for (const [key, item] of Object.entries(file)) {
+        if (typeof item !== 'string' || !item)
+            throw new Error(`Conversation file reference is missing ${key}`);
+    }
+    return file;
+}
+async function downloadFile(urlValue, maxBytes, allowedHosts) {
+    let url = validateDownloadUrl(urlValue, allowedHosts);
+    for (let redirect = 0; redirect <= 3; redirect += 1) {
+        const response = await fetch(url, { redirect: 'manual' });
+        if (response.status >= 300 && response.status < 400) {
+            const location = response.headers.get('location');
+            if (!location)
+                throw new Error('Conversation file redirect did not include a location');
+            url = validateDownloadUrl(new URL(location, url).toString(), allowedHosts);
+            continue;
+        }
+        if (!response.ok || !response.body) {
+            throw new Error(`Unable to download conversation file (HTTP ${response.status})`);
+        }
+        const declaredLength = Number(response.headers.get('content-length') ?? 0);
+        if (declaredLength > maxBytes)
+            throw new Error(`Conversation file is too large (maximum ${maxBytes} bytes)`);
+        const chunks = [];
+        let size = 0;
+        const reader = response.body.getReader();
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            size += value.byteLength;
+            if (size > maxBytes) {
+                await reader.cancel();
+                throw new Error(`Conversation file is too large (maximum ${maxBytes} bytes)`);
+            }
+            chunks.push(Buffer.from(value));
+        }
+        return Buffer.concat(chunks);
+    }
+    throw new Error('Conversation file download exceeded the redirect limit');
+}
+function validateDownloadUrl(value, allowedHosts) {
+    const url = new URL(value);
+    const allowHttp = process.env['COAIA_MEDIA_ALLOW_HTTP'] === 'true';
+    if (url.protocol !== 'https:' && !(allowHttp && url.protocol === 'http:')) {
+        throw new Error(`Conversation file URL protocol '${url.protocol}' is not allowed`);
+    }
+    if (!isAllowedHost(url.hostname, allowedHosts)) {
+        throw new Error(`Conversation file URL domain '${url.hostname}' is not allowed`);
+    }
+    if (url.username || url.password)
+        throw new Error('Conversation file URL credentials are not allowed');
+    return url;
+}
+function detectDownloadedContentType(bytes, declaredType) {
+    if (bytes.subarray(0, 8).equals(Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]))) {
+        return 'image/png';
+    }
+    if (bytes.length >= 3 && bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff)
+        return 'image/jpeg';
+    const prefix = bytes.subarray(0, 6).toString('ascii');
+    if (prefix === 'GIF87a' || prefix === 'GIF89a')
+        return 'image/gif';
+    if (bytes.subarray(0, 4).toString('ascii') === 'RIFF' && bytes.subarray(8, 12).toString('ascii') === 'WEBP') {
+        return 'image/webp';
+    }
+    if (bytes.subarray(0, 5).toString('ascii') === '%PDF-')
+        return 'application/pdf';
+    return declaredType;
+}
+function configuredOpenAIFileHosts() {
+    const extra = (process.env['COAIA_OPENAI_FILE_HOSTS'] ?? '')
+        .split(',')
+        .map((host) => host.trim().toLowerCase())
+        .filter(Boolean);
+    return [...DEFAULT_OPENAI_FILE_HOSTS, ...extra];
+}
+function configuredMaxFileBytes() {
+    const configured = Number(process.env['COAIA_MEDIA_MAX_BYTES']);
+    return Number.isSafeInteger(configured) && configured > 0 ? configured : DEFAULT_MAX_FILE_BYTES;
+}
+function isAllowedHost(hostname, allowedHosts) {
+    const lower = hostname.toLowerCase();
+    return allowedHosts.some((host) => lower === host || lower.endsWith(`.${host}`));
+}
+function secureEqual(actual, expected) {
+    if (!actual || Array.isArray(actual))
+        return false;
+    const actualBytes = Buffer.from(actual);
+    const expectedBytes = Buffer.from(expected);
+    return actualBytes.byteLength === expectedBytes.byteLength && timingSafeEqual(actualBytes, expectedBytes);
+}
+function sendJson(response, status, body) {
+    response.writeHead(status, {
+        'Content-Type': 'application/json; charset=utf-8',
+        'Cache-Control': 'no-store',
+    });
+    response.end(JSON.stringify(body));
+}
+export async function startMediaUploadProxy() {
+    const port = Number(process.env['PORT'] ?? process.env['COAIA_MEDIA_PROXY_PORT'] ?? 8787);
+    if (!Number.isInteger(port) || port < 1 || port > 65535)
+        throw new Error(`Invalid proxy port: ${port}`);
+    const server = createMediaUploadProxyServer();
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(port, '0.0.0.0', () => resolve());
+    });
+    console.log(`coaiajs media upload proxy listening on port ${port}`);
+    return server;
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    startMediaUploadProxy().catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=media-upload-proxy.js.map

package/dist/src/media-upload-proxy.js.map

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

package/dist/src/redis.d.ts

@@ -1,8 +1,14 @@
-import IORedis from 'ioredis';
-declare const Redis: typeof IORedis.Redis;
-type RedisClient = InstanceType<typeof Redis>;
+/** Minimal key-value surface shared by the TCP and REST backends. */
+export interface KvClient {
+    set(key: string, value: string, ttlSeconds?: number): Promise<unknown>;
+    get(key: string): Promise<string | null>;
+    del(key: string): Promise<number>;
+    keys(pattern: string): Promise<string[]>;
+    exists(key: string): Promise<number>;
+    quit(): Promise<unknown>;
+}
 /** Get or create the lazy Redis client. */
-export declare function getClient(): RedisClient;
+export declare function getClient(): KvClient;
 /** Store a key-value pair with optional TTL in minutes, matching coaiapy. */
 export declare function tash(key: string, value: string, ttl?: number): Promise<void>;
 /** Fetch a value by key. Returns null if not found. */
@@ -17,5 +23,4 @@ export declare function exists(key: string): Promise<boolean>;
 export declare function disconnect(): Promise<void>;
 /** Reset client (testing). */
 export declare function resetClient(): void;
-export {};
 //# sourceMappingURL=redis.d.ts.map

package/dist/src/redis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/redis.ts"],"names":[],"mappings":"AAGA,OAAO,OAAO,MAAM,SAAS,CAAC;AAI9B,QAAA,MAAM,KAAK,sBAA6B,CAAC;AACzC,KAAK,WAAW,GAAG,YAAY,CAAC,OAAO,KAAK,CAAC,CAAC;AA6C9C,2CAA2C;AAC3C,wBAAgB,SAAS,IAAI,WAAW,CAKvC;AAED,6EAA6E;AAC7E,wBAAsB,IAAI,CACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,uDAAuD;AACvD,wBAAsB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG/D;AAED,oDAAoD;AACpD,wBAAsB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGtD;AAED,oCAAoC;AACpC,wBAAsB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAG7D;AAED,6BAA6B;AAC7B,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG1D;AAED,6BAA6B;AAC7B,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAKhD;AAED,8BAA8B;AAC9B,wBAAgB,WAAW,IAAI,IAAI,CAElC"}
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/redis.ts"],"names":[],"mappings":"AASA,qEAAqE;AACrE,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B;AAkJD,2CAA2C;AAC3C,wBAAgB,SAAS,IAAI,QAAQ,CAKpC;AAED,6EAA6E;AAC7E,wBAAsB,IAAI,CACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,uDAAuD;AACvD,wBAAsB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG/D;AAED,oDAAoD;AACpD,wBAAsB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGtD;AAED,oCAAoC;AACpC,wBAAsB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAG7D;AAED,6BAA6B;AAC7B,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG1D;AAED,6BAA6B;AAC7B,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAKhD;AAED,8BAA8B;AAC9B,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/src/redis.js

@@ -4,18 +4,104 @@ import IORedis from 'ioredis';
 import { getConfig } from './config.js';
 const Redis = IORedis.default ?? IORedis;
 let _client = null;
+/**
+ * Upstash-compatible REST backend. The endpoint accepts a JSON command array
+ * (`["SET","k","v"]`) POSTed to the base URL and answers `{"result": ...}`.
+ */
+class RestRedisClient {
+    baseUrl;
+    token;
+    constructor(url, token) {
+        this.baseUrl = url.replace(/\/+$/, '');
+        this.token = token;
+    }
+    async command(args) {
+        const headers = { 'Content-Type': 'application/json' };
+        if (this.token)
+            headers['Authorization'] = `Bearer ${this.token}`;
+        const res = await globalThis.fetch(this.baseUrl, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(args.map(String)),
+        });
+        const text = await res.text();
+        if (!res.ok) {
+            throw new Error(`Redis REST ${res.status} ${res.statusText}: ${text.slice(0, 200)}`);
+        }
+        let payload;
+        try {
+            payload = JSON.parse(text);
+        }
+        catch {
+            throw new Error(`Redis REST returned non-JSON response: ${text.slice(0, 200)}`);
+        }
+        if (payload.error)
+            throw new Error(`Redis REST error: ${payload.error}`);
+        return payload.result;
+    }
+    set(key, value, ttlSeconds) {
+        const args = ttlSeconds && ttlSeconds > 0 ? ['EX', String(ttlSeconds)] : [];
+        return this.command(['SET', key, value, ...args]);
+    }
+    get(key) {
+        return this.command(['GET', key]);
+    }
+    del(key) {
+        return this.command(['DEL', key]);
+    }
+    keys(pattern) {
+        return this.command(['KEYS', pattern]);
+    }
+    exists(key) {
+        return this.command(['EXISTS', key]);
+    }
+    async quit() {
+        return 'OK';
+    }
+}
+/** ioredis-backed TCP/TLS backend, adapted to the shared KvClient surface. */
+class TcpRedisClient {
+    redis;
+    constructor(redis) {
+        this.redis = redis;
+    }
+    set(key, value, ttlSeconds) {
+        return ttlSeconds && ttlSeconds > 0
+            ? this.redis.set(key, value, 'EX', ttlSeconds)
+            : this.redis.set(key, value);
+    }
+    get(key) {
+        return this.redis.get(key);
+    }
+    del(key) {
+        return this.redis.del(key);
+    }
+    keys(pattern) {
+        return this.redis.keys(pattern);
+    }
+    exists(key) {
+        return this.redis.exists(key);
+    }
+    quit() {
+        return this.redis.quit();
+    }
+}
 function upstashClient(url, token) {
     const parsed = new URL(url);
-    const tls = parsed.protocol === 'https:' || parsed.protocol === 'rediss:';
+    // An http(s) URL is a REST endpoint, not a TCP socket.
+    if (parsed.protocol === 'http:' || parsed.protocol === 'https:') {
+        return new RestRedisClient(url, token ?? (decodeURIComponent(parsed.password) || undefined));
+    }
+    const tls = parsed.protocol === 'rediss:';
     const password = token ?? decodeURIComponent(parsed.password);
-    return new Redis({
+    return new TcpRedisClient(new Redis({
         host: parsed.hostname,
         port: parsed.port ? parseInt(parsed.port, 10) : 6379,
         username: parsed.username ? decodeURIComponent(parsed.username) : undefined,
         password: password || undefined,
         lazyConnect: true,
         tls: tls ? {} : undefined,
-    });
+    }));
 }
 function buildClient(cfg) {
     const r = cfg.redis;
@@ -25,19 +111,19 @@ function buildClient(cfg) {
     }
     // Explicit URL takes priority
     if (r?.url) {
-        return new Redis(r.url, {
+        return new TcpRedisClient(new Redis(r.url, {
             lazyConnect: true,
             tls: r.url.startsWith('rediss://') ? {} : undefined,
-        });
+        }));
     }
     // Host / port fallback
-    return new Redis({
+    return new TcpRedisClient(new Redis({
         host: r?.host ?? '127.0.0.1',
         port: r?.port ?? 6379,
         password: r?.password,
         lazyConnect: true,
         tls: r?.ssl ? {} : undefined,
-    });
+    }));
 }
 /** Get or create the lazy Redis client. */
 export function getClient() {
@@ -50,7 +136,7 @@ export function getClient() {
 export async function tash(key, value, ttl) {
     const client = getClient();
     if (ttl && ttl > 0) {
-        await client.set(key, value, 'EX', ttl * 60);
+        await client.set(key, value, ttl * 60);
     }
     else {
         await client.set(key, value);

package/dist/src/redis.js.map

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

package/llms-full.txt

@@ -170,10 +170,18 @@ Langfuse Cloud v4 compatibility: writes use the scoped JS SDK v5 and OpenTelemet
 - **Datasets:** `createDataset`, `getDataset`, `listDatasets`, `createDatasetItem`, `listDatasetItems`
 - **Scores:** `createScore`, `listScores`, `createScoreForTarget`, `applyScoreToTrace`, `createScoreConfig`, `getScoreConfig`, `listScoreConfigs`, `applyScoreConfig`, `importScoreConfigs`, `exportScoreConfigs`, `getBuiltInPresets`, `installPreset`
 - **Comments:** `createComment`, `getComment`, `listComments`
-- **Media:** `uploadAndAttachMedia`, `getMedia`
+- **Media:** `uploadMediaBytes`, `uploadAndAttachMedia`, `getMedia`
 - **Projects:** `listProjects`
 - **Formatters:** `formatTracesTable`, `formatTracesMarkdown`, `formatTraceTree`, `formatObservationDisplay`, `formatPromptMarkdown`, `formatPromptDisplay`, `formatPromptsTable`, `formatDatasetsTable`, `formatDatasetForFinetuning`, `formatScoresTable`, `formatScoreConfigsTable`, `formatMediaDisplay`
 
+### `coaiajs/media-upload-proxy`
+
+```
+uploadOpenAIFileToLangfuse, createMediaUploadProxyServer, startMediaUploadProxy
+```
+
+The deployable bridge consumes Custom GPT `openaiFileIdRefs`, downloads the actual conversation file from an allowlisted host, completes the Langfuse presigned media upload, and returns a renderable media token.
+
 ### Exported types
 
 ```

package/llms.txt

@@ -29,6 +29,7 @@ Key facts an agent usually needs first:
 - `coaiajs/environment`: `EnvironmentManager`, `createEnvironment`, `findEnvironment`
 - `coaiajs/version`: `getPackageVersion`
 - `coaiajs/langfuse`: Langfuse v4-compatible OpenTelemetry tracing, Observations API v2, Scores API v3, prompts, datasets, comments, media, projects
+- `coaiajs/media-upload-proxy`: deployable `openaiFileIdRefs` to Langfuse media upload bridge (`coaiajs-media-proxy` binary)
 - `coaiajs/narrative`: `KnowledgeGraphManager`, structural tension charts, markdown export
 - `coaiajs/pde`: Prompt Decomposition Engine — sessions, STC mapping
 - `coaiajs/planning`: `parsePlan`, `planToSTC`, `syncToChart`, `syncToPlan`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coaiajs",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "type": "module",
   "description": "CoAIA unified TypeScript monorepo — CLI, MCP server, and library consolidating coaia-narrative, coaia-pde, coaia-planning, and coaiapy patterns into one package.",
   "main": "./dist/src/index.js",
@@ -42,6 +42,10 @@
       "types": "./dist/src/langfuse/index.d.ts",
       "import": "./dist/src/langfuse/index.js"
     },
+    "./media-upload-proxy": {
+      "types": "./dist/src/media-upload-proxy.d.ts",
+      "import": "./dist/src/media-upload-proxy.js"
+    },
     "./narrative": {
       "types": "./dist/src/narrative/index.d.ts",
       "import": "./dist/src/narrative/index.js"
@@ -72,7 +76,8 @@
   ],
   "bin": {
     "coaia": "dist/src/cli.js",
-    "coaiajs-mcp": "dist/mcp/server.js"
+    "coaiajs-mcp": "dist/mcp/server.js",
+    "coaiajs-media-proxy": "dist/src/media-upload-proxy.js"
   },
   "engines": {
     "node": ">=20.0.0"

package/rispecs/03-langfuse-module.spec.md

@@ -17,7 +17,8 @@ A comprehensive Langfuse client covering traces, observations, prompts, datasets
 - Langfuse v4 migration is implemented: trace writes use the scoped JS SDK v5 and `POST /api/public/otel/v1/traces`; trace, observation, and session reads use Observations API v2; score reads use Scores API v3.
 - V4 observations are immutable: root input/output must be complete before export, sessions are reconstructed by `sessionId`, and the legacy patch-output MCP/CLI operation is removed.
 - The broad Custom GPT action spec at [`agents/custom_gpt/ceremony.yml`](../agents/custom_gpt/ceremony.yml) remains OpenAPI 3.1.0 and uses the supported v4 endpoints.
-- The focused [`agents/custom_gpt/ceremony-observations.yml`](../agents/custom_gpt/ceremony-observations.yml) spec provides 20 GPT Actions for root-trace creation, nested observation append through OTLP/HTTP JSON, observations-first reads, and the ceremony's core prompt, dataset, score, comment, and project operations. Its companion instructions document Basic authorization, v4 ingestion headers, immutable-span rules, and parent context.
+- The focused [`agents/custom_gpt/ceremony-observations.yml`](../agents/custom_gpt/ceremony-observations.yml) spec provides 23 GPT Actions for root-trace creation, nested observation append through OTLP/HTTP JSON, observations-first reads, and the ceremony's core prompt, dataset, score, comment, media, and project operations. Its companion instructions document Basic authorization, v4 ingestion headers, immutable-span rules, parent context, and the exact-byte media workflow using padded Base64 SHA-256 digests and a separate presigned PUT.
+- The deployable [`src/media-upload-proxy.ts`](../src/media-upload-proxy.ts) bridge and one-operation [`ceremony-media-proxy.yml`](../agents/custom_gpt/ceremony-media-proxy.yml) companion Action use OpenAI `openaiFileIdRefs` to transfer the actual conversation file, complete the Langfuse record/PUT/finalize flow, and return a renderable media token. Together the focused specs expose 24 non-consequential actions.
 - Types defined in [`src/types.ts`](../src/types.ts): `ScoreCategory`, `ScoreConfig`.
 - Remaining gap: not every Langfuse formatting and cache helper from `cofuse.py` has a TypeScript equivalent; the core trace/observation/prompt/dataset/score/comment/media path is present.