coaiajs 0.2.0 → 0.2.1

package/dist/src/langfuse/index.d.ts

@@ -1,8 +1,8 @@
 export { LangfuseClient, LangfuseApiError, getClient, resetClient, nowISO } from './client.js';
 export type { IngestionEvent, LangfuseClientConfig } from './client.js';
-export { addTrace, patchTraceOutput, listTraces, getTrace, formatTracesTable, formatTracesMarkdown, formatTraceTree } from './traces.js';
+export { addTrace, createTrace, patchTraceOutput, listTraces, getTrace, traceView, sessionView, formatTracesTable, formatTracesMarkdown, formatTraceTree, } from './traces.js';
 export type { TraceFilters } from './traces.js';
-export { addObservation, getObservation, formatObservationDisplay } from './observations.js';
+export { addObservation, addObservations, getObservation, formatObservationDisplay } from './observations.js';
 export { listPrompts, getPrompt, createPrompt, formatPromptsTable, formatPromptDisplay } from './prompts.js';
 export { listDatasets, getDataset, createDataset, listDatasetItems, createDatasetItem, formatDatasetsTable, formatDatasetForFinetuning, } from './datasets.js';
 export { createScore, applyScoreToTrace, createScoreForTarget, listScores, listScoreConfigs, getScoreConfig, createScoreConfig, exportScoreConfigs, importScoreConfigs, applyScoreConfig, getBuiltInPresets, installPreset, formatScoresTable, formatScoreConfigsTable, } from './scores.js';

package/dist/src/langfuse/index.js

@@ -1,7 +1,7 @@
 // coaiajs/src/langfuse/index.ts — Barrel export
 export { LangfuseClient, LangfuseApiError, getClient, resetClient, nowISO } from './client.js';
-export { addTrace, patchTraceOutput, listTraces, getTrace, formatTracesTable, formatTracesMarkdown, formatTraceTree } from './traces.js';
-export { addObservation, getObservation, formatObservationDisplay } from './observations.js';
+export { addTrace, createTrace, patchTraceOutput, listTraces, getTrace, traceView, sessionView, formatTracesTable, formatTracesMarkdown, formatTraceTree, } from './traces.js';
+export { addObservation, addObservations, getObservation, formatObservationDisplay } from './observations.js';
 export { listPrompts, getPrompt, createPrompt, formatPromptsTable, formatPromptDisplay } from './prompts.js';
 export { listDatasets, getDataset, createDataset, listDatasetItems, createDatasetItem, formatDatasetsTable, formatDatasetForFinetuning, } from './datasets.js';
 export { createScore, applyScoreToTrace, createScoreForTarget, listScores, listScoreConfigs, getScoreConfig, createScoreConfig, exportScoreConfigs, importScoreConfigs, applyScoreConfig, getBuiltInPresets, installPreset, formatScoresTable, formatScoreConfigsTable, } from './scores.js';

package/dist/src/langfuse/observations.d.ts

@@ -4,9 +4,12 @@ export declare function addObservation(params: {
     type?: string;
     name: string;
     parentId?: string;
+    parentObservationId?: string;
+    input?: string;
     inputData?: unknown;
+    output?: string;
     outputData?: unknown;
-    metadata?: unknown;
+    metadata?: string | unknown;
     startTime?: string;
     endTime?: string;
     level?: string;
@@ -14,5 +17,9 @@ export declare function addObservation(params: {
     usage?: unknown;
 }): Promise<string>;
 export declare function getObservation(observationId: string): Promise<string>;
+export declare function addObservations(params: {
+    traceId?: string;
+    observations?: Array<Record<string, unknown>>;
+}): Promise<string>;
 export declare function formatObservationDisplay(json: unknown): string;
 //# sourceMappingURL=observations.d.ts.map

package/dist/src/langfuse/observations.js

@@ -15,14 +15,14 @@ export async function addObservation(params) {
     };
     if (params.name)
         body.name = params.name;
-    if (params.inputData)
-        body.input = params.inputData;
-    if (params.outputData)
-        body.output = params.outputData;
+    if (params.inputData ?? params.input)
+        body.input = parseJsonOption(params.inputData ?? params.input);
+    if (params.outputData ?? params.output)
+        body.output = parseJsonOption(params.outputData ?? params.output);
     if (params.metadata)
-        body.metadata = params.metadata;
-    if (params.parentId)
-        body.parentObservationId = params.parentId;
+        body.metadata = parseJsonOption(params.metadata);
+    if (params.parentId ?? params.parentObservationId)
+        body.parentObservationId = params.parentId ?? params.parentObservationId;
     if (params.endTime)
         body.endTime = params.endTime;
     if (params.model)
@@ -49,6 +49,28 @@ export async function getObservation(observationId) {
     const result = await client.request('GET', `/api/public/observations/${observationId}`);
     return JSON.stringify(result, null, 2);
 }
+function parseJsonOption(value) {
+    if (typeof value !== 'string')
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+export async function addObservations(params) {
+    const observations = params.observations ?? [];
+    const results = [];
+    for (const observation of observations) {
+        const traceId = String(observation.traceId ?? params.traceId ?? '');
+        const name = String(observation.name ?? 'Observation');
+        if (!traceId)
+            throw new Error('traceId is required for every observation');
+        results.push(JSON.parse(await addObservation({ ...observation, traceId, name })));
+    }
+    return JSON.stringify({ success: true, count: results.length, observations: results }, null, 2);
+}
 // ─── Formatters ─────────────────────────────────────────────────────
 const TYPE_GLYPHS = {
     SPAN: '🔗',

package/dist/src/langfuse/traces.d.ts

@@ -21,9 +21,27 @@ export declare function addTrace(params: {
     outputData?: unknown;
     metadata?: unknown;
 }): Promise<string>;
-export declare function patchTraceOutput(traceId: string, outputData: unknown): Promise<string>;
+export declare function patchTraceOutput(traceIdOrParams: string | {
+    traceId?: string;
+    output?: string;
+    outputData?: unknown;
+}, outputData?: unknown): Promise<string>;
+export declare function createTrace(params: {
+    traceId?: string;
+    id?: string;
+    userId?: string;
+    sessionId?: string;
+    name?: string;
+    input?: string;
+    inputData?: unknown;
+    output?: string;
+    outputData?: unknown;
+    metadata?: string | unknown;
+}): Promise<string>;
 export declare function listTraces(filters: TraceFilters): Promise<string>;
 export declare function getTrace(traceId: string): Promise<string>;
+export declare function traceView(traceId: string): Promise<string>;
+export declare function sessionView(sessionId: string): Promise<string>;
 export declare function formatTracesTable(json: unknown): string;
 export declare function formatTraceTree(json: unknown): string;
 export declare function formatTracesMarkdown(json: unknown): string;

package/dist/src/langfuse/traces.js

@@ -35,13 +35,19 @@ export async function addTrace(params) {
         message: `Trace ${traceId} created`,
     }, null, 2);
 }
-export async function patchTraceOutput(traceId, outputData) {
+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: outputData,
+        output,
     };
     const eventId = `${traceId}-patch-${uuidv4().slice(0, 8)}`;
     const event = {
@@ -57,6 +63,27 @@ export async function patchTraceOutput(traceId, outputData) {
         message: `Trace output patched for ${traceId}`,
     }, null, 2);
 }
+function parseJsonOption(value) {
+    if (typeof value !== 'string')
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+export async function createTrace(params) {
+    return addTrace({
+        traceId: params.traceId ?? params.id,
+        userId: params.userId,
+        sessionId: params.sessionId,
+        name: params.name,
+        inputData: parseJsonOption(params.inputData ?? params.input),
+        outputData: parseJsonOption(params.outputData ?? params.output),
+        metadata: parseJsonOption(params.metadata),
+    });
+}
 export async function listTraces(filters) {
     const client = getClient();
     const params = new URLSearchParams();
@@ -111,6 +138,14 @@ export async function getTrace(traceId) {
     }
     return JSON.stringify(trace, null, 2);
 }
+export async function traceView(traceId) {
+    const raw = await getTrace(traceId);
+    return formatTraceTree(raw);
+}
+export async function sessionView(sessionId) {
+    const raw = await listTraces({ sessionId, limit: 20, orderBy: 'timestamp.desc' });
+    return formatTracesMarkdown(raw);
+}
 // ─── Formatters ─────────────────────────────────────────────────────
 export function formatTracesTable(json) {
     try {

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "coaiajs",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "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.",
   "bin": {
-    "coaia": "./dist/src/cli.js",
-    "coaiajs-mcp": "./dist/mcp/server.js"
+    "coaia": "dist/src/cli.js",
+    "coaiajs-mcp": "dist/mcp/server.js"
   },
   "engines": {
     "node": ">=20.0.0"

package/src/langfuse/index.ts

@@ -3,10 +3,14 @@
 export { LangfuseClient, LangfuseApiError, getClient, resetClient, nowISO } from './client.js';
 export type { IngestionEvent, LangfuseClientConfig } from './client.js';
 
-export { addTrace, patchTraceOutput, listTraces, getTrace, formatTracesTable, formatTracesMarkdown, formatTraceTree } from './traces.js';
+export {
+  addTrace, createTrace, patchTraceOutput,
+  listTraces, getTrace, traceView, sessionView,
+  formatTracesTable, formatTracesMarkdown, formatTraceTree,
+} from './traces.js';
 export type { TraceFilters } from './traces.js';
 
-export { addObservation, getObservation, formatObservationDisplay } from './observations.js';
+export { addObservation, addObservations, getObservation, formatObservationDisplay } from './observations.js';
 
 export { listPrompts, getPrompt, createPrompt, formatPromptsTable, formatPromptDisplay } from './prompts.js';
 

package/src/langfuse/observations.ts

@@ -11,9 +11,12 @@ export async function addObservation(params: {
   type?: string;
   name: string;
   parentId?: string;
+  parentObservationId?: string;
+  input?: string;
   inputData?: unknown;
+  output?: string;
   outputData?: unknown;
-  metadata?: unknown;
+  metadata?: string | unknown;
   startTime?: string;
   endTime?: string;
   level?: string;
@@ -33,10 +36,10 @@ export async function addObservation(params: {
   };
 
   if (params.name) body.name = params.name;
-  if (params.inputData) body.input = params.inputData;
-  if (params.outputData) body.output = params.outputData;
-  if (params.metadata) body.metadata = params.metadata;
-  if (params.parentId) body.parentObservationId = params.parentId;
+  if (params.inputData ?? params.input) body.input = parseJsonOption(params.inputData ?? params.input);
+  if (params.outputData ?? params.output) body.output = parseJsonOption(params.outputData ?? params.output);
+  if (params.metadata) body.metadata = parseJsonOption(params.metadata);
+  if (params.parentId ?? params.parentObservationId) body.parentObservationId = params.parentId ?? params.parentObservationId;
   if (params.endTime) body.endTime = params.endTime;
   if (params.model) body.model = params.model;
   if (params.usage) body.usage = params.usage;
@@ -65,6 +68,27 @@ export async function getObservation(observationId: string): Promise<string> {
   return JSON.stringify(result, null, 2);
 }
 
+function parseJsonOption(value: unknown): unknown {
+  if (typeof value !== 'string') return value;
+  try {
+    return JSON.parse(value) as unknown;
+  } catch {
+    return value;
+  }
+}
+
+export async function addObservations(params: { traceId?: string; observations?: Array<Record<string, unknown>> }): Promise<string> {
+  const observations = params.observations ?? [];
+  const results: unknown[] = [];
+  for (const observation of observations) {
+    const traceId = String(observation.traceId ?? params.traceId ?? '');
+    const name = String(observation.name ?? 'Observation');
+    if (!traceId) throw new Error('traceId is required for every observation');
+    results.push(JSON.parse(await addObservation({ ...observation, traceId, name })) as unknown);
+  }
+  return JSON.stringify({ success: true, count: results.length, observations: results }, null, 2);
+}
+
 // ─── Formatters ─────────────────────────────────────────────────────
 
 const TYPE_GLYPHS: Record<string, string> = {

package/src/langfuse/traces.ts

@@ -61,14 +61,23 @@ export async function addTrace(params: {
   }, null, 2);
 }
 
-export async function patchTraceOutput(traceId: string, outputData: unknown): Promise<string> {
+export async function patchTraceOutput(
+  traceIdOrParams: string | { traceId?: string; output?: string; outputData?: unknown },
+  outputData?: unknown,
+): Promise<string> {
+  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: Record<string, unknown> = {
     id: traceId,
     timestamp: now,
-    output: outputData,
+    output,
   };
 
   const eventId = `${traceId}-patch-${uuidv4().slice(0, 8)}`;
@@ -88,6 +97,38 @@ export async function patchTraceOutput(traceId: string, outputData: unknown): Pr
   }, null, 2);
 }
 
+function parseJsonOption(value: unknown): unknown {
+  if (typeof value !== 'string') return value;
+  try {
+    return JSON.parse(value) as unknown;
+  } catch {
+    return value;
+  }
+}
+
+export async function createTrace(params: {
+  traceId?: string;
+  id?: string;
+  userId?: string;
+  sessionId?: string;
+  name?: string;
+  input?: string;
+  inputData?: unknown;
+  output?: string;
+  outputData?: unknown;
+  metadata?: string | unknown;
+}): Promise<string> {
+  return addTrace({
+    traceId: params.traceId ?? params.id,
+    userId: params.userId,
+    sessionId: params.sessionId,
+    name: params.name,
+    inputData: parseJsonOption(params.inputData ?? params.input),
+    outputData: parseJsonOption(params.outputData ?? params.output),
+    metadata: parseJsonOption(params.metadata),
+  });
+}
+
 export async function listTraces(filters: TraceFilters): Promise<string> {
   const client = getClient();
   const params = new URLSearchParams();
@@ -141,6 +182,16 @@ export async function getTrace(traceId: string): Promise<string> {
   return JSON.stringify(trace, null, 2);
 }
 
+export async function traceView(traceId: string): Promise<string> {
+  const raw = await getTrace(traceId);
+  return formatTraceTree(raw);
+}
+
+export async function sessionView(sessionId: string): Promise<string> {
+  const raw = await listTraces({ sessionId, limit: 20, orderBy: 'timestamp.desc' });
+  return formatTracesMarkdown(raw);
+}
+
 // ─── Formatters ─────────────────────────────────────────────────────
 
 export function formatTracesTable(json: unknown): string {