coaiajs 0.4.2 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coaiajs",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "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,10 +42,18 @@
       "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"
     },
+    "./narrative/contract": {
+      "types": "./dist/src/narrative/contract.d.ts",
+      "import": "./dist/src/narrative/contract.js"
+    },
     "./pde": {
       "types": "./dist/src/pde/index.d.ts",
       "import": "./dist/src/pde/index.js"
@@ -72,7 +80,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.