coaiajs 0.3.3 → 0.4.0

package/dist/src/langfuse/traces.js

@@ -1,67 +1,38 @@
 // coaiajs/src/langfuse/traces.ts — Trace operations
 // Port of cofuse.py trace functions
-import { v4 as uuidv4 } from 'uuid';
-import { getClient, nowISO } from './client.js';
+import { getClient } from './client.js';
+import { ALL_OBSERVATION_FIELDS, fetchAllObservations, fetchObservationsPage, } from './observations.js';
 export async function addTrace(params) {
     const client = getClient();
-    const now = nowISO();
-    const traceId = params.traceId ?? uuidv4();
-    const body = {
-        id: traceId,
-        timestamp: now,
-    };
-    if (params.sessionId)
-        body.sessionId = params.sessionId;
-    if (params.name)
-        body.name = params.name;
-    if (params.inputData)
-        body.input = params.inputData;
-    if (params.outputData)
-        body.output = params.outputData;
-    if (params.userId)
-        body.userId = params.userId;
-    if (params.metadata)
-        body.metadata = params.metadata;
-    const event = {
-        id: `${traceId}-event`,
-        timestamp: now,
-        type: 'trace-create',
-        body,
-    };
-    await client.ingest([event]);
+    const metadata = asRecord(params.metadata);
+    const result = await client.exportObservation({
+        traceId: params.traceId,
+        name: params.name ?? 'trace',
+        type: 'SPAN',
+        input: params.inputData,
+        output: params.outputData,
+        metadata,
+        traceName: params.name,
+        userId: params.userId,
+        sessionId: params.sessionId,
+        tags: params.tags,
+        version: params.version,
+        environment: params.environment,
+        traceMetadata: metadata,
+    });
     return JSON.stringify({
         success: true,
-        traceId,
-        message: `Trace ${traceId} created`,
+        traceId: result.traceId,
+        rootObservationId: result.observationId,
+        message: `Trace ${result.traceId} created through OpenTelemetry`,
     }, null, 2);
 }
-export async function patchTraceOutput(traceIdOrParams, outputData) {
-    const traceId = typeof traceIdOrParams === 'string' ? traceIdOrParams : traceIdOrParams.traceId;
-    if (!traceId)
-        throw new Error('traceId is required');
-    const output = typeof traceIdOrParams === 'string'
-        ? outputData
-        : parseJsonOption(traceIdOrParams.outputData ?? traceIdOrParams.output);
-    const client = getClient();
-    const now = nowISO();
-    const body = {
-        id: traceId,
-        timestamp: now,
-        output,
-    };
-    const eventId = `${traceId}-patch-${uuidv4().slice(0, 8)}`;
-    const event = {
-        id: eventId,
-        timestamp: now,
-        type: 'trace-create',
-        body,
-    };
-    await client.ingest([event]);
-    return JSON.stringify({
-        success: true,
-        traceId,
-        message: `Trace output patched for ${traceId}`,
-    }, null, 2);
+/**
+ * Langfuse v4 observations are immutable after export. Callers must set the
+ * root observation output before it is ended and exported.
+ */
+export async function patchTraceOutput(_traceIdOrParams, _outputData) {
+    throw new Error('patchTraceOutput is not supported by Langfuse v4. Set output when creating the root observation.');
 }
 function parseJsonOption(value) {
     if (typeof value !== 'string')
@@ -73,6 +44,12 @@ function parseJsonOption(value) {
         return value;
     }
 }
+function asRecord(value) {
+    const parsed = parseJsonOption(value);
+    return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+        ? parsed
+        : undefined;
+}
 export async function createTrace(params) {
     return addTrace({
         traceId: params.traceId ?? params.id,
@@ -82,60 +59,43 @@ export async function createTrace(params) {
         inputData: parseJsonOption(params.inputData ?? params.input),
         outputData: parseJsonOption(params.outputData ?? params.output),
         metadata: parseJsonOption(params.metadata),
+        tags: params.tags,
+        version: params.version,
+        environment: params.environment,
     });
 }
-export async function listTraces(filters) {
-    const client = getClient();
-    const params = new URLSearchParams();
-    if (filters.sessionId)
-        params.set('sessionId', filters.sessionId);
-    if (filters.userId)
-        params.set('userId', filters.userId);
-    if (filters.name)
-        params.set('name', filters.name);
-    if (filters.fromTimestamp)
-        params.set('fromTimestamp', filters.fromTimestamp);
-    if (filters.toTimestamp)
-        params.set('toTimestamp', filters.toTimestamp);
-    if (filters.orderBy)
-        params.set('orderBy', filters.orderBy);
-    if (filters.version)
-        params.set('version', filters.version);
-    if (filters.release)
-        params.set('release', filters.release);
-    if (filters.tags) {
-        for (const tag of filters.tags)
-            params.append('tags', tag);
+export async function listTraces(filters = {}) {
+    if (filters.orderBy) {
+        throw new Error('Langfuse v4 observations are always sorted by startTime descending; orderBy is unsupported.');
     }
-    if (filters.environment) {
-        for (const env of filters.environment)
-            params.append('environment', env);
+    if (filters.release) {
+        throw new Error('Langfuse v4 Observations API v2 does not support filtering by release.');
     }
-    const page = filters.page ?? 1;
-    const limit = filters.limit ?? 50;
-    params.set('page', String(page));
-    params.set('limit', String(limit));
-    const qs = params.toString();
-    const path = `/api/public/traces${qs ? `?${qs}` : ''}`;
-    const result = await client.request('GET', path);
-    return JSON.stringify(result, null, 2);
+    const filter = buildTraceFilter(filters);
+    const result = await fetchObservationsPage({
+        fields: ALL_OBSERVATION_FIELDS,
+        limit: filters.limit ?? 50,
+        cursor: filters.cursor,
+        filter,
+    });
+    const traces = result.data.map(traceFromRootObservation);
+    return JSON.stringify({ data: traces, meta: result.meta }, null, 2);
 }
 export async function getTrace(traceId) {
-    const client = getClient();
-    const trace = await client.request('GET', `/api/public/traces/${traceId}`);
-    // Fetch observations for this trace
-    try {
-        const obsResult = await client.request('GET', `/api/public/observations?traceId=${traceId}`);
-        if (obsResult && typeof obsResult === 'object' && 'data' in obsResult) {
-            trace.observations = obsResult.data;
-        }
-        else {
-            trace.observations = obsResult;
-        }
-    }
-    catch {
-        trace.observations = [];
-    }
+    const observations = await fetchAllObservations({
+        fields: ALL_OBSERVATION_FIELDS,
+        traceId,
+        limit: 1000,
+    });
+    if (!observations.length)
+        throw new Error(`Trace not found: ${traceId}`);
+    const root = observations.find((observation) => observation.isRootObservation === true)
+        ?? observations.find((observation) => !observation.parentObservationId)
+        ?? observations[observations.length - 1];
+    const trace = {
+        ...traceFromRootObservation(root),
+        observations,
+    };
     return JSON.stringify(trace, null, 2);
 }
 export async function traceView(traceId) {
@@ -143,9 +103,56 @@ export async function traceView(traceId) {
     return formatTraceTree(raw);
 }
 export async function sessionView(sessionId) {
-    const raw = await listTraces({ sessionId, limit: 20, orderBy: 'timestamp.desc' });
+    const raw = await listTraces({ sessionId, limit: 20 });
     return formatTracesMarkdown(raw);
 }
+function buildTraceFilter(filters) {
+    const result = [{
+            type: 'boolean', column: 'isRootObservation', operator: '=', value: true,
+        }];
+    if (filters.sessionId)
+        result.push(stringFilter('sessionId', filters.sessionId));
+    if (filters.userId)
+        result.push(stringFilter('userId', filters.userId));
+    if (filters.name)
+        result.push(stringFilter('traceName', filters.name));
+    if (filters.version)
+        result.push(stringFilter('version', filters.version));
+    if (filters.fromTimestamp)
+        result.push(datetimeFilter('startTime', '>=', filters.fromTimestamp));
+    if (filters.toTimestamp)
+        result.push(datetimeFilter('startTime', '<', filters.toTimestamp));
+    if (filters.tags?.length) {
+        result.push({ type: 'arrayOptions', column: 'tags', operator: 'all of', value: filters.tags });
+    }
+    if (filters.environment?.length) {
+        result.push({ type: 'stringOptions', column: 'environment', operator: 'any of', value: filters.environment });
+    }
+    return result;
+}
+function stringFilter(column, value) {
+    return { type: 'string', column, operator: '=', value };
+}
+function datetimeFilter(column, operator, value) {
+    return { type: 'datetime', column, operator, value };
+}
+function traceFromRootObservation(observation) {
+    return {
+        id: observation.traceId,
+        name: observation.traceName ?? observation.name,
+        sessionId: observation.sessionId,
+        userId: observation.userId,
+        timestamp: observation.startTime,
+        input: observation.input,
+        output: observation.output,
+        metadata: observation.metadata,
+        tags: observation.tags,
+        release: observation.release,
+        version: observation.version,
+        environment: observation.environment,
+        rootObservationId: observation.id,
+    };
+}
 // ─── Formatters ─────────────────────────────────────────────────────
 export function formatTracesTable(json) {
     try {

package/dist/src/langfuse/traces.js.map

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

package/llms-full.txt

@@ -162,13 +162,16 @@ MobileTemplateEngine, TemplateLoader, TemplateRenderer
 
 Client and errors: `LangfuseClient`, `LangfuseApiError`, `getClient`, `resetClient`, `nowISO`, `detectContentType`
 
+Langfuse Cloud v4 compatibility: writes use the scoped JS SDK v5 and OpenTelemetry endpoint; trace/observation/session reads use Observations API v2; score reads use Scores API v3. `patchTraceOutput` remains as a compatibility export that throws because v4 observations are immutable.
+
 - **Traces:** `createTrace`, `addTrace`, `getTrace`, `listTraces`, `patchTraceOutput`, `traceView`, `sessionView`
-- **Observations:** `addObservation`, `addObservations`, `getObservation`
+- **Observations:** `addObservation`, `addObservations`, `listObservations`, `getObservation`
 - **Prompts:** `createPrompt`, `getPrompt`, `listPrompts`
 - **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`
+- **Projects:** `listProjects`
 - **Formatters:** `formatTracesTable`, `formatTracesMarkdown`, `formatTraceTree`, `formatObservationDisplay`, `formatPromptMarkdown`, `formatPromptDisplay`, `formatPromptsTable`, `formatDatasetsTable`, `formatDatasetForFinetuning`, `formatScoresTable`, `formatScoreConfigsTable`, `formatMediaDisplay`
 
 ### Exported types
@@ -191,7 +194,7 @@ PipelineVariable, PipelineStep, PipelineTemplate, CoaiaConfig
 npx coaiajs-mcp
 ```
 
-Transport: **stdio**. Serves **63 tools, 3 prompts, 1 listable resource**.
+Transport: **stdio**. Serves **62 tools, 3 prompts, 1 listable resource**.
 
 Flags: `--memory-path <path>` (JSONL knowledge graph), `--plans-dir <path>`, `--feature-level <level>`.
 
@@ -212,15 +215,15 @@ Claude Code / client registration:
 | Level | Effect |
 |---|---|
 | `MINIMAL` | Core tash/fetch and essential graph tools |
-| `STANDARD` | Default — the 63 tools listed below |
+| `STANDARD` | Default — the 62 tools listed below |
 | `OBSERVABILITY` | Same set as `STANDARD` |
 | `FULL` | Everything, including media tools |
 
-### Tools — coaiapy + Langfuse (20)
+### Tools — coaiapy + Langfuse (19)
 
 ```
 coaia_tash, coaia_fetch,
-coaia_fuse_trace_create, coaia_fuse_add_observation, coaia_fuse_trace_patch_output,
+coaia_fuse_trace_create, coaia_fuse_add_observation,
 coaia_fuse_trace_get, coaia_fuse_trace_view, coaia_fuse_observation_get,
 coaia_fuse_traces_list, coaia_fuse_traces_session_view,
 coaia_fuse_prompts_list, coaia_fuse_prompts_get,

package/llms.txt

@@ -1,6 +1,6 @@
 # coaiajs
 
-> TypeScript package consolidating the CoAIA (Creative Orientation AI Architecture) ecosystem into one installable unit: a **library**, a **CLI** (`coaia`), and an **MCP server** (`coaiajs-mcp`, 63 tools). Its core data model is the *structural tension chart* — desired outcome, current reality, and telescoping action steps — backed by a JSONL knowledge graph.
+> TypeScript package consolidating the CoAIA (Creative Orientation AI Architecture) ecosystem into one installable unit: a **library**, a **CLI** (`coaia`), and an **MCP server** (`coaiajs-mcp`, 62 tools). Its core data model is the *structural tension chart* — desired outcome, current reality, and telescoping action steps — backed by a JSONL knowledge graph.
 
 Install with `npm install coaiajs`. Requires Node.js >= 20. **ESM only** — there is no CommonJS build, so `require('coaiajs')` will not work. Ships `.d.ts` for every entry point.
 
@@ -9,7 +9,7 @@ Key facts an agent usually needs first:
 - Import from `coaiajs` (root) or a subpath such as `coaiajs/narrative`. **Do not** import `coaiajs/src/*.js` — `src/` is not shipped in the published package.
 - Clients (Redis, OpenAI, Polly, Octokit) are lazy: importing a module opens no connection and reads no file. Call `disconnect()` when finished.
 - Config precedence: environment variables > `.env` files > `coaia.json` > defaults.
-- The MCP server serves 63 tools, 3 prompts, and 1 listable resource over stdio. `COAIAJS_FEATURES` (`MINIMAL`/`STANDARD`/`OBSERVABILITY`/`FULL`) controls the tool set; default is `STANDARD`.
+- The MCP server serves 62 tools, 3 prompts, and 1 listable resource over stdio. `COAIAJS_FEATURES` (`MINIMAL`/`STANDARD`/`OBSERVABILITY`/`FULL`) controls the tool set; default is `STANDARD`.
 
 ## Documentation
 
@@ -28,7 +28,7 @@ Key facts an agent usually needs first:
 - `coaiajs/github`: `listIssues`, `getIssue`, `getIssueComments`
 - `coaiajs/environment`: `EnvironmentManager`, `createEnvironment`, `findEnvironment`
 - `coaiajs/version`: `getPackageVersion`
-- `coaiajs/langfuse`: tracing, observations, prompts, datasets, scores, comments, media
+- `coaiajs/langfuse`: Langfuse v4-compatible OpenTelemetry tracing, Observations API v2, Scores API v3, prompts, datasets, comments, media, projects
 - `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.3.3",
+  "version": "0.4.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",
@@ -62,6 +62,7 @@
   },
   "files": [
     "dist",
+    "agents/custom_gpt",
     "rispecs",
     "README.md",
     "KINSHIP.md",
@@ -87,14 +88,18 @@
   },
   "dependencies": {
     "@aws-sdk/client-polly": "^3.1117.0",
+    "@langfuse/client": "^5.10.1",
+    "@langfuse/otel": "^5.10.1",
+    "@langfuse/tracing": "^5.10.1",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "@octokit/rest": "^21.1.1",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/sdk-trace-node": "^2.10.0",
     "chalk": "^5.6.2",
     "commander": "^12.1.0",
     "dotenv": "^16.6.1",
     "ioredis": "^5.11.1",
     "js-yaml": "^4.1.0",
-    "langfuse": "^3.38.20",
     "minimist": "^1.2.8",
     "openai": "^4.104.0",
     "uuid": "^11.1.1",

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

@@ -14,6 +14,9 @@ A comprehensive Langfuse client covering traces, observations, prompts, datasets
   - [`traces.ts`](../src/langfuse/traces.ts), [`observations.ts`](../src/langfuse/observations.ts), [`prompts.ts`](../src/langfuse/prompts.ts), [`datasets.ts`](../src/langfuse/datasets.ts), [`scores.ts`](../src/langfuse/scores.ts), [`comments.ts`](../src/langfuse/comments.ts), and [`media.ts`](../src/langfuse/media.ts) port the coaiapy `cofuse.py` surface.
   - [`index.ts`](../src/langfuse/index.ts) exposes a public barrel for `coaiajs/langfuse`.
 - [`mcp/server.ts`](../mcp/server.ts) wires coaiapy-compatible Langfuse MCP tools such as `coaia_fuse_trace_create`, `coaia_fuse_add_observation`, `coaia_fuse_score_apply`, comments, prompts, datasets, and media.
+- 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 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.
 - 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.
 
@@ -100,4 +103,6 @@ Langfuse REST API uses Basic auth: `base64(publicKey:secretKey)`. Config provide
 - ✅ Pagination handled transparently (auto-page through results when needed)
 - ✅ Auth failure returns clear error, not cryptic 401
 - ✅ Missing credentials detected at call time, not import time
+- ✅ No trace/observation writes use the sunset legacy ingestion API
+- ✅ No trace, observation, session, or score reads use deprecated v1/v2 endpoints
 - ✅ Response types validated with Zod before returning

package/rispecs/08-cli-interface.spec.md

@@ -74,13 +74,16 @@ coaia env unset <key>                   # Remove env var
 
 ### Langfuse Commands
 ```
-coaia fuse traces [--limit N]           # List traces
-coaia fuse trace <id>                   # Get trace details
-coaia fuse prompts [--name X]           # List prompts
-coaia fuse scores [--trace-id X]        # List scores
-coaia fuse datasets                     # List datasets
+coaia fuse traces list [--from ISO --to ISO --cursor X]  # V4 traces reconstructed from observations
+coaia fuse traces trace-view <id>                        # V4 observation tree
+coaia fuse traces create --name X [--input JSON --output JSON] # OTEL root observation
+coaia fuse prompts get <name> [--md]                     # Markdown by default
+coaia fuse scores list [--trace-id X --cursor X]         # Scores API v3
+coaia fuse sessions view <id>                            # Session reconstructed by sessionId
 ```
 
+Langfuse v4 removes legacy session entities and immutable observation updates, so the CLI does not expose session creation/add-node or trace patch-output commands.
+
 ### Narrative Commands
 ```
 coaia narrative charts                  # List all active charts

package/rispecs/09-mcp-server.spec.md

@@ -4,7 +4,7 @@
 
 ## Desired Outcome
 
-A single MCP server (`coaiajs-mcp`) that consolidates the 44 tools from coaia-narrative (27), coaia-pde (12), and coaia-planning (5) into one server, adds 20 new tools for Redis, Langfuse, pipeline, and audio, and supports feature gating so resource-constrained environments can load only what they need.
+A single MCP server (`coaiajs-mcp`) that consolidates the 44 tools from coaia-narrative (27), coaia-pde (12), and coaia-planning (5) into one server, adds 19 new tools for Redis, Langfuse, pipeline, and audio, and supports feature gating so resource-constrained environments can load only what they need.
 
 ## Structural Tension
 
@@ -94,7 +94,7 @@ MMOT: `perform_mmot_evaluation`, `init_llm_guidance`
 
 ### Langfuse
 
-`coaia_fuse_trace_create`, `coaia_fuse_add_observation`, `coaia_fuse_trace_patch_output`, `coaia_fuse_trace_get`, `coaia_fuse_trace_view`, `coaia_fuse_observation_get`, `coaia_fuse_traces_list`, `coaia_fuse_traces_session_view`, comments, prompts, datasets, score configs, score application, and media tools.
+`coaia_fuse_trace_create`, `coaia_fuse_add_observation`, `coaia_fuse_trace_get`, `coaia_fuse_trace_view`, `coaia_fuse_observation_get`, `coaia_fuse_traces_list`, `coaia_fuse_traces_session_view`, comments, prompts, datasets, score configs, score application, and media tools.
 
 ### Resources