catelog 1.0.1 → 1.0.3

package/dist/sse.js.map

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

package/dist/telemetry.d.ts

@@ -0,0 +1,41 @@
+import type { AgentLogger, AgentMetric, TelemetryData } from "./types.js";
+export interface TelemetryCollector {
+    /** Merge base metrics into telemetry payload */
+    finalize: (overrides?: Partial<TelemetryData>) => TelemetryData;
+    /** Record a custom metric */
+    record: (name: string, value: number) => void;
+    /** Get the metric helper for the execution context */
+    getMetricHelper: () => AgentMetric;
+    /** Get all recorded metrics */
+    getMetrics: () => Record<string, number>;
+}
+export declare function createTelemetryCollector(opts: {
+    inputBytes: number;
+}): TelemetryCollector;
+export declare function createLogger(runId: string): AgentLogger;
+export interface TelemetryReporterOptions {
+    /** Telemetry endpoint URL. Auto-reads CATELOG_TELEMETRY_URL. */
+    endpoint?: string;
+    /** Max time to wait for telemetry POST in ms (default: 3000) */
+    timeoutMs?: number;
+    /** Disable telemetry reporting entirely */
+    disabled?: boolean;
+}
+export declare class TelemetryReporter {
+    private endpoint?;
+    private timeoutMs;
+    private disabled;
+    constructor(options?: TelemetryReporterOptions);
+    /**
+     * Report telemetry in the background. This is completely async and
+     * will NEVER throw or block the agent's response.
+     */
+    report(data: {
+        agentId: string;
+        runId: string;
+        status: string;
+        telemetry: TelemetryData;
+        timestamp: number;
+    }): void;
+}
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAa1E,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,aAAa,CAAC;IAChE,6BAA6B;IAC7B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,sDAAsD;IACtD,eAAe,EAAE,MAAM,WAAW,CAAC;IACnC,+BAA+B;IAC/B,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,kBAAkB,CAgCrB;AAcD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAsBvD;AAOD,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAU;gBAEd,OAAO,GAAE,wBAA6B;IAMlD;;;OAGG;IACI,MAAM,CAAC,IAAI,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,aAAa,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI;CAkBT"}

package/dist/telemetry.js

@@ -0,0 +1,93 @@
+export function createTelemetryCollector(opts) {
+    const metrics = new Map();
+    let chunksStreamed = 0;
+    const record = (name, value) => {
+        metrics.set(name, (metrics.get(name) ?? 0) + value);
+    };
+    const metricHelper = {
+        count: (name, value) => record(name, value ?? 1),
+        gauge: (name, value) => metrics.set(name, value),
+        timing: (name, durationMs) => record(name, durationMs),
+    };
+    return {
+        record,
+        getMetricHelper: () => metricHelper,
+        getMetrics: () => Object.fromEntries(metrics),
+        finalize(overrides) {
+            return {
+                input_bytes: opts.inputBytes,
+                chunks_streamed: chunksStreamed,
+                ...overrides,
+                // Merge framework-specific from overrides if present
+                framework: {
+                    ...overrides?.framework,
+                    custom_metrics: Object.fromEntries(metrics),
+                },
+            };
+        },
+    };
+}
+// ─────────────────────────────────────────────────
+//  Structured Logger
+// ─────────────────────────────────────────────────
+const LOG_COLORS = {
+    info: "\x1b[36m", // cyan
+    warn: "\x1b[33m", // yellow
+    error: "\x1b[31m", // red
+    debug: "\x1b[90m", // gray
+    reset: "\x1b[0m",
+};
+export function createLogger(runId) {
+    const log = (level, message, data) => {
+        if (level === "debug" && process.env.NODE_ENV === "production")
+            return;
+        const color = LOG_COLORS[level] || LOG_COLORS.info;
+        const ts = new Date().toISOString();
+        const prefix = `${color}[${level.toUpperCase()}]${LOG_COLORS.reset}`;
+        const runTag = `\x1b[90m[${runId}]\x1b[0m`;
+        if (data && Object.keys(data).length > 0) {
+            console.log(`${prefix} ${runTag} ${message}`, data);
+        }
+        else {
+            console.log(`${prefix} ${runTag} ${message}`);
+        }
+    };
+    return {
+        info: (msg, data) => log("info", msg, data),
+        warn: (msg, data) => log("warn", msg, data),
+        error: (msg, data) => log("error", msg, data),
+        debug: (msg, data) => log("debug", msg, data),
+    };
+}
+export class TelemetryReporter {
+    endpoint;
+    timeoutMs;
+    disabled;
+    constructor(options = {}) {
+        this.endpoint = options.endpoint || process.env.CATELOG_TELEMETRY_URL;
+        this.timeoutMs = options.timeoutMs ?? 3_000;
+        this.disabled = options.disabled ?? (process.env.CATELOG_TELEMETRY_DISABLED === "true");
+    }
+    /**
+     * Report telemetry in the background. This is completely async and
+     * will NEVER throw or block the agent's response.
+     */
+    report(data) {
+        if (this.disabled || !this.endpoint)
+            return;
+        // Fire-and-forget with silent catch
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        fetch(this.endpoint, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(data),
+            signal: controller.signal,
+        })
+            .catch(() => {
+            // Silently ignore — telemetry failures NEVER affect agent execution
+        })
+            .finally(() => clearTimeout(timer));
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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

package/dist/types.d.ts

@@ -1,14 +1,18 @@
 export declare const PROTOCOL_VERSION = "1.0.0";
-/**
- * Standard error codes defined by Marketplace Agent Protocol Specification (MAPS)
- */
-export type ErrorCode = "AUTH_INVALID_SIGNATURE" | "AUTH_TIMESTAMP_OUT_OF_BOUNDS" | "AUTH_REPLAY_DETECTED" | "INVALID_INPUT" | "MODEL_RATE_LIMIT" | "UPSTREAM_TIMEOUT" | "EXECUTION_TIMEOUT" | "INTERNAL_CRASH" | "TOOL_FAILURE";
+export type ErrorCode = "AUTH_INVALID_SIGNATURE" | "AUTH_TIMESTAMP_OUT_OF_BOUNDS" | "AUTH_REPLAY_DETECTED" | "AUTH_MISSING_KEY" | "AUTH_INVALID_KEY" | "INVALID_INPUT" | "MODEL_RATE_LIMIT" | "UPSTREAM_TIMEOUT" | "EXECUTION_TIMEOUT" | "INTERNAL_CRASH" | "TOOL_FAILURE" | "TASK_CANCELED" | "NOT_FOUND";
 export interface StructuredError {
     code: ErrorCode | string;
     message: string;
     retryable: boolean;
     details?: Record<string, unknown>;
 }
+export type TaskState = "working" | "completed" | "failed" | "canceled" | "input-required";
+/**
+ * sync:           Direct HTTP/SSE — stream and resolve in same connection.
+ * async:          Returns 202 Accepted immediately, polled via GET /tasks/:id.
+ * conversational: Supports multi-turn with ctx.needInput() suspensions.
+ */
+export type ExecutionMode = "sync" | "async" | "conversational";
 export interface TelemetryData {
     llm_tokens?: {
         prompt?: number;
@@ -17,11 +21,19 @@ export interface TelemetryData {
     };
     model_used?: string;
     cost_usd?: number;
+    /** Base metrics auto-collected by the SDK */
+    duration_ms?: number;
+    input_bytes?: number;
+    output_bytes?: number;
+    chunks_streamed?: number;
+    /** Framework-specific extras (OpenAI usage, LangGraph nodes, etc.) */
+    framework?: Record<string, unknown>;
 }
 export interface AgentCapabilities {
     streaming: boolean;
     delta_stream?: boolean;
     max_timeout_seconds?: number;
+    execution_modes: ExecutionMode[];
 }
 export interface AgentManifest {
     id: string;
@@ -38,12 +50,15 @@ export interface HealthCheckResponse {
     protocol_version: string;
     uptime_seconds: number;
     environment_ready: boolean;
+    capabilities?: AgentCapabilities;
     details?: Record<string, unknown>;
 }
 export interface ExecuteRequest<TInput = Record<string, unknown>> {
-    run_id: string;
+    run_id?: string;
     input: TInput;
     deadline_ms?: number;
+    /** Resume token for conversational continuation */
+    resume_token?: string;
     metadata?: {
         buyer_id?: string;
         session_id?: string;
@@ -52,7 +67,7 @@ export interface ExecuteRequest<TInput = Record<string, unknown>> {
 }
 export interface ExecuteSuccessResponse<TOutput = Record<string, unknown>> {
     run_id: string;
-    status: "succeeded";
+    status: "completed";
     duration_ms: number;
     output: TOutput;
     error?: false;
@@ -60,66 +75,139 @@ export interface ExecuteSuccessResponse<TOutput = Record<string, unknown>> {
 }
 export interface ExecuteFailureResponse {
     run_id: string;
-    status: "failed" | "cancelled";
+    status: "failed" | "canceled";
     duration_ms: number;
     error: StructuredError;
     output?: false;
     telemetry?: TelemetryData;
 }
-export type ExecuteResponse<TOutput = Record<string, unknown>> = ExecuteSuccessResponse<TOutput> | ExecuteFailureResponse;
-export interface RunStartedEvent {
-    event: "run.started";
+export interface ExecuteInputRequiredResponse {
     run_id: string;
+    status: "input-required";
+    duration_ms: number;
+    prompt: string;
+    input_schema?: Record<string, unknown>;
+    resume_token: string;
+    telemetry?: TelemetryData;
+}
+export interface ExecuteAsyncAcceptedResponse {
+    run_id: string;
+    status: "working";
+    poll_url: string;
+    telemetry?: TelemetryData;
+}
+export type ExecuteResponse<TOutput = Record<string, unknown>> = ExecuteSuccessResponse<TOutput> | ExecuteFailureResponse | ExecuteInputRequiredResponse | ExecuteAsyncAcceptedResponse;
+export interface TaskStatusEvent {
+    event: "task.status";
+    run_id: string;
+    status: TaskState;
     timestamp: number;
 }
-export interface StepStartedEvent {
-    event: "step.started";
+export interface TaskProgressEvent {
+    event: "task.progress";
     run_id: string;
-    step_index: number;
-    label: string;
+    percent: number;
+    message?: string;
+    step?: number;
     timestamp: number;
 }
-export interface OutputDeltaEvent {
-    event: "output.delta";
+export interface TaskDeltaEvent {
+    event: "task.delta";
     run_id: string;
     index: number;
     delta_type: "text" | "json_patch";
     content: string;
 }
-export interface HeartbeatEvent {
-    event: "heartbeat";
+export interface TaskActivityEvent {
+    event: "task.activity";
+    run_id: string;
+    activity_type: string;
+    data?: Record<string, unknown>;
     timestamp: number;
 }
-export interface RunSucceededEvent<TOutput = Record<string, unknown>> {
-    event: "run.succeeded";
+export interface TaskInputRequiredEvent {
+    event: "task.input_required";
+    run_id: string;
+    prompt: string;
+    input_schema?: Record<string, unknown>;
+    resume_token: string;
+    timestamp: number;
+}
+export interface TaskCompletedEvent<TOutput = Record<string, unknown>> {
+    event: "task.completed";
     run_id: string;
     duration_ms: number;
     output: TOutput;
     telemetry?: TelemetryData;
 }
-export interface RunFailedEvent {
-    event: "run.failed";
+export interface TaskFailedEvent {
+    event: "task.failed";
     run_id: string;
     duration_ms: number;
     error: StructuredError;
 }
-export type SSEProtocolEvent = RunStartedEvent | StepStartedEvent | OutputDeltaEvent | HeartbeatEvent | RunSucceededEvent | RunFailedEvent;
-/**
- * Stream controller passed to agent execute handlers
- */
+export interface HeartbeatEvent {
+    event: "heartbeat";
+    timestamp: number;
+}
+export type SSEProtocolEvent = TaskStatusEvent | TaskProgressEvent | TaskDeltaEvent | TaskActivityEvent | TaskInputRequiredEvent | TaskCompletedEvent | TaskFailedEvent | HeartbeatEvent;
 export interface AgentStream {
-    step: (label: string) => void;
+    /** Emit a progress tick (0-100). Does NOT complete the task. */
+    progress: (percent: number, message?: string) => void;
+    /** Stream a text/token delta. Does NOT complete the task. */
     delta: (content: string, type?: "text" | "json_patch") => void;
+    /** Emit a named activity event (tool_call, search, etc.) */
+    activity: (type: string, data?: Record<string, unknown>) => void;
+    /** Legacy step label (maps to progress internally) */
+    step: (label: string) => void;
+    /** Raw event emitter */
     emit: (event: string, data: unknown) => void;
+    /** Write arbitrary text to the stream (convenience alias for delta) */
+    write: (text: string) => void;
+    /** Is the connection still open? */
     isClosed: () => boolean;
 }
+export interface AgentLogger {
+    info: (message: string, data?: Record<string, unknown>) => void;
+    warn: (message: string, data?: Record<string, unknown>) => void;
+    error: (message: string, data?: Record<string, unknown>) => void;
+    debug: (message: string, data?: Record<string, unknown>) => void;
+}
+export interface AgentMetric {
+    count: (name: string, value?: number) => void;
+    gauge: (name: string, value: number) => void;
+    timing: (name: string, durationMs: number) => void;
+}
+export declare const NEED_INPUT_SYMBOL: unique symbol;
+export interface NeedInputResult {
+    [NEED_INPUT_SYMBOL]: true;
+    prompt: string;
+    schema?: Record<string, unknown>;
+    continuation?: boolean;
+}
 export interface AgentExecutionContext<TInput = Record<string, unknown>> {
     runId: string;
     input: TInput;
     stream: AgentStream;
     signal: AbortSignal;
+    log: AgentLogger;
+    metric: AgentMetric;
     metadata?: Record<string, unknown>;
     deadlineMs?: number;
+    /** Resume token when continuing a conversation */
+    resumeToken?: string;
+    /** Suspend execution and ask for human/caller input */
+    needInput: (opts: {
+        prompt: string;
+        schema?: Record<string, unknown>;
+        continuation?: boolean;
+    }) => NeedInputResult;
+    /** Session state for multi-turn conversations */
+    session: {
+        get: <T = unknown>(key: string) => T | undefined;
+        set: (key: string, value: unknown) => void;
+        getAll: () => Record<string, unknown>;
+    };
 }
 export interface AgentExecutionResult<TOutput = Record<string, unknown>> {
     output: TOutput;

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,2 +1,6 @@
 export const PROTOCOL_VERSION = "1.0.0";
+// ─────────────────────────────────────────────────
+//  NeedInput result (for conversational agents)
+// ─────────────────────────────────────────────────
+export const NEED_INPUT_SYMBOL = Symbol.for("catelog.needInput");
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAqRxC,oDAAoD;AACpD,gDAAgD;AAChD,oDAAoD;AAEpD,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "catelog",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Official TypeScript SDK for Marketplace Agent Protocol Specification (MAPS)",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,6 +20,7 @@
     "dist",
     "scripts",
     "README.md",
+    "USAGE.md",
     "DECISION.md",
     "LICENSE"
   ],