catelog 0.0.0-stage → 1.0.0

package/dist/agent.js

@@ -0,0 +1,309 @@
+import { SecurityManager } from "./security.js";
+import { SSEWriter } from "./sse.js";
+import { toJsonSchema, validateSchemaData } from "./schema.js";
+import { PROTOCOL_VERSION, } from "./types.js";
+import { startAgentServer } from "./server.js";
+export class MarketplaceAgent {
+    id;
+    name;
+    version;
+    description;
+    capabilities;
+    security;
+    config;
+    startTime;
+    constructor(config) {
+        this.config = config;
+        this.name = config.name;
+        this.id = config.id || slugify(config.name);
+        this.version = config.version || "1.0.0";
+        this.description = config.description || `Agent for ${this.name}`;
+        this.capabilities = {
+            streaming: true,
+            delta_stream: false,
+            max_timeout_seconds: 300,
+            ...config.capabilities,
+        };
+        this.security = new SecurityManager({ secret: config.secret });
+        this.startTime = Date.now();
+    }
+    getHealth() {
+        return {
+            status: "ready",
+            protocol_version: PROTOCOL_VERSION,
+            uptime_seconds: Math.floor((Date.now() - this.startTime) / 1000),
+            environment_ready: true,
+        };
+    }
+    getManifest() {
+        return {
+            id: this.id,
+            name: this.name,
+            version: this.version,
+            description: this.description,
+            protocol_version: PROTOCOL_VERSION,
+            capabilities: this.capabilities,
+            input_schema: toJsonSchema(this.config.inputSchema, "InputSchema"),
+            output_schema: toJsonSchema(this.config.outputSchema, "OutputSchema"),
+        };
+    }
+    serve(portOrOptions) {
+        const opts = typeof portOrOptions === "number" ? { port: portOrOptions } : portOrOptions;
+        return startAgentServer(this, opts);
+    }
+    async handleRequest(req, res) {
+        const method = req.method?.toUpperCase() || "GET";
+        const url = new URL(req.url || "/", `http://${req.headers.host || "localhost"}`);
+        const pathname = url.pathname;
+        // Enable CORS for testing & browser callers
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type, Accept, X-Marketplace-Protocol, X-Marketplace-Timestamp, X-Marketplace-Nonce, X-Marketplace-Run-Id, X-Marketplace-Signature");
+        if (method === "OPTIONS") {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        try {
+            if (pathname === "/health" && method === "GET") {
+                this.writeJsonResponse(res, 200, this.getHealth());
+                return;
+            }
+            if (pathname === "/schema" && method === "GET") {
+                this.writeJsonResponse(res, 200, this.getManifest());
+                return;
+            }
+            if (pathname === "/execute" && method === "POST") {
+                await this.handleExecute(req, res);
+                return;
+            }
+            this.writeJsonResponse(res, 404, {
+                error: {
+                    code: "NOT_FOUND",
+                    message: `Endpoint ${method} ${pathname} not found`,
+                    retryable: false,
+                },
+            });
+        }
+        catch (err) {
+            const error = normalizeError(err);
+            this.writeJsonResponse(res, 500, {
+                error,
+            });
+        }
+    }
+    async handleExecute(req, res) {
+        const rawBody = await readBody(req);
+        const headers = req.headers;
+        const path = req.url || "/execute";
+        const method = req.method || "POST";
+        // 1. Security & Signature verification
+        let authInfo;
+        try {
+            authInfo = this.security.verifyRequest({
+                method,
+                path,
+                headers,
+                rawBody,
+            });
+        }
+        catch (err) {
+            if (err && typeof err === "object" && "code" in err && "statusCode" in err) {
+                const secErr = err;
+                this.writeJsonResponse(res, secErr.statusCode, {
+                    error: {
+                        code: secErr.code,
+                        message: secErr.message,
+                        retryable: false,
+                    },
+                });
+                return;
+            }
+            throw err;
+        }
+        // Parse request body
+        let payload;
+        try {
+            payload = rawBody.length > 0 ? JSON.parse(rawBody.toString("utf8")) : {};
+        }
+        catch {
+            this.writeJsonResponse(res, 400, {
+                error: {
+                    code: "INVALID_INPUT",
+                    message: "Malformed JSON request body",
+                    retryable: false,
+                },
+            });
+            return;
+        }
+        const runId = payload.run_id || authInfo.runId;
+        this.security.markRunStarted(runId);
+        // 2. Pre-Execution Schema Validation
+        const validation = validateSchemaData(this.config.inputSchema, payload.input);
+        if (!validation.success) {
+            this.security.markRunCompleted(runId);
+            this.writeJsonResponse(res, 400, {
+                run_id: runId,
+                status: "failed",
+                duration_ms: 0,
+                error: {
+                    code: "INVALID_INPUT",
+                    message: `Input validation failed: ${validation.errors.join("; ")}`,
+                    retryable: false,
+                    details: { validationErrors: validation.errors },
+                },
+            });
+            return;
+        }
+        const startTimestamp = Date.now();
+        const acceptsSse = req.headers.accept?.includes("text/event-stream") ?? true;
+        // Setup deadline timeout if specified
+        const abortController = new AbortController();
+        let timeoutTimer;
+        if (payload.deadline_ms && payload.deadline_ms > Date.now()) {
+            const waitTime = payload.deadline_ms - Date.now();
+            timeoutTimer = setTimeout(() => {
+                abortController.abort(new Error("EXECUTION_TIMEOUT"));
+            }, waitTime);
+        }
+        if (acceptsSse) {
+            // Streaming SSE Response Mode
+            const sseWriter = new SSEWriter(runId, res, {
+                onClientDisconnect: () => {
+                    abortController.abort(new Error("CLIENT_DISCONNECTED"));
+                },
+            });
+            // Forward abort signal
+            sseWriter.signal.addEventListener("abort", () => {
+                abortController.abort(sseWriter.signal.reason);
+            });
+            // Send initial run.started event
+            sseWriter.sendRunStarted();
+            try {
+                const result = await this.config.execute({
+                    runId,
+                    input: validation.data,
+                    stream: sseWriter,
+                    signal: abortController.signal,
+                    metadata: payload.metadata,
+                    deadlineMs: payload.deadline_ms,
+                });
+                if (timeoutTimer)
+                    clearTimeout(timeoutTimer);
+                const durationMs = Date.now() - startTimestamp;
+                this.security.markRunCompleted(runId);
+                sseWriter.sendRunSucceeded(result.output, durationMs, result.telemetry);
+            }
+            catch (err) {
+                if (timeoutTimer)
+                    clearTimeout(timeoutTimer);
+                const durationMs = Date.now() - startTimestamp;
+                this.security.markRunCompleted(runId);
+                const error = normalizeError(err);
+                sseWriter.sendRunFailed(error, durationMs);
+            }
+        }
+        else {
+            // Batch JSON Mode
+            try {
+                const noopStream = {
+                    step: () => { },
+                    delta: () => { },
+                    emit: () => { },
+                    isClosed: () => false,
+                };
+                const result = await this.config.execute({
+                    runId,
+                    input: validation.data,
+                    stream: noopStream,
+                    signal: abortController.signal,
+                    metadata: payload.metadata,
+                    deadlineMs: payload.deadline_ms,
+                });
+                if (timeoutTimer)
+                    clearTimeout(timeoutTimer);
+                const durationMs = Date.now() - startTimestamp;
+                this.security.markRunCompleted(runId);
+                const response = {
+                    run_id: runId,
+                    status: "succeeded",
+                    duration_ms: durationMs,
+                    output: result.output,
+                    telemetry: result.telemetry,
+                };
+                this.writeJsonResponse(res, 200, response);
+            }
+            catch (err) {
+                if (timeoutTimer)
+                    clearTimeout(timeoutTimer);
+                const durationMs = Date.now() - startTimestamp;
+                this.security.markRunCompleted(runId);
+                const error = normalizeError(err);
+                const response = {
+                    run_id: runId,
+                    status: "failed",
+                    duration_ms: durationMs,
+                    error,
+                };
+                this.writeJsonResponse(res, 200, response);
+            }
+        }
+    }
+    writeJsonResponse(res, status, data) {
+        if (res.writableEnded)
+            return;
+        const body = JSON.stringify(data);
+        res.writeHead(status, {
+            "Content-Type": "application/json; charset=utf-8",
+            "Content-Length": Buffer.byteLength(body),
+        });
+        res.end(body);
+    }
+}
+/**
+ * Convenience builder function for creating a compliant Marketplace Agent
+ */
+export function createMarketplaceAgent(config) {
+    return new MarketplaceAgent(config);
+}
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .trim()
+        .replace(/[^\w\s-]/g, "")
+        .replace(/[\s_-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+function normalizeError(err, defaultCode = "INTERNAL_CRASH") {
+    if (err instanceof Error) {
+        if (err.name === "AbortError" || err.message === "EXECUTION_TIMEOUT") {
+            return {
+                code: "EXECUTION_TIMEOUT",
+                message: "Execution exceeded allowed deadline or timeout",
+                retryable: true,
+            };
+        }
+        // Check for standard error codes attached to error object
+        const code = err.code || defaultCode;
+        const retryable = err.retryable ?? false;
+        return {
+            code,
+            message: err.message,
+            retryable,
+        };
+    }
+    return {
+        code: defaultCode,
+        message: String(err),
+        retryable: false,
+    };
+}
+async function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)));
+        req.on("end", () => resolve(Buffer.concat(chunks)));
+        req.on("error", reject);
+    });
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/banner.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Catelog Banner - Terminal splash for installation and agent startup
+ */
+export declare function renderBanner(mode?: "install" | "startup", details?: {
+    name?: string;
+    url?: string;
+}): void;
+//# sourceMappingURL=banner.d.ts.map

package/dist/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../src/banner.ts"],"names":[],"mappings":";AAEA;;GAEG;AA8BH,wBAAgB,YAAY,CAAC,IAAI,GAAE,SAAS,GAAG,SAAqB,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkDrH"}

package/dist/banner.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+/**
+ * Catelog Banner - Terminal splash for installation and agent startup
+ */
+// ANSI escape codes for rich terminal styling
+const c = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    italic: "\x1b[3m",
+    underline: "\x1b[4m",
+    // Vibrant colors
+    cyan: "\x1b[36m",
+    brightCyan: "\x1b[96m",
+    magenta: "\x1b[35m",
+    brightMagenta: "\x1b[95m",
+    blue: "\x1b[34m",
+    brightBlue: "\x1b[94m",
+    green: "\x1b[32m",
+    brightGreen: "\x1b[92m",
+    yellow: "\x1b[33m",
+    brightYellow: "\x1b[93m",
+    gray: "\x1b[90m",
+    white: "\x1b[97m",
+    // Backgrounds
+    bgMagenta: "\x1b[45m",
+    bgCyan: "\x1b[46m",
+    bgDarkGray: "\x1b[100m",
+};
+export function renderBanner(mode = "install", details) {
+    // Check if CI or silent install
+    if (process.env.CI || process.env.CATELOG_SILENT) {
+        return;
+    }
+    const asciiCatelog = `
+  ${c.brightCyan}  ██████╗ █████╗ ████████╗███████╗██╗      ██████╗  ██████╗ 
+  ${c.brightCyan} ██╔════╝██╔══██╗╚══██╔══╝██╔════╝██║     ██╔═══██╗██╔════╝ 
+  ${c.brightMagenta} ██║     ███████║   ██║   █████╗  ██║     ██║   ██║██║  ███╗
+  ${c.brightMagenta} ██║     ██╔══██║   ██║   ██╔══╝  ██║     ██║   ██║██║   ██║
+  ${c.magenta} ╚██████╗██║  ██║   ██║   ███████╗███████╗╚██████╔╝╚██████╔╝
+  ${c.magenta}  ╚═════╝╚═╝  ╚═╝   ╚═╝   ╚══════╝╚══════╝ ╚═════╝  ╚═════╝ 
+`.trimEnd();
+    const width = 68;
+    const line = c.gray + "─".repeat(width) + c.reset;
+    const doubleLine = c.brightMagenta + "═".repeat(width) + c.reset;
+    console.log("\n" + doubleLine);
+    console.log(asciiCatelog);
+    console.log(line);
+    // Team ROX note box
+    console.log(`  ${c.bgMagenta}${c.white}${c.bold} NOTE FROM TEAM ROX ${c.reset}`);
+    console.log(`  ${c.brightYellow}${c.italic}“Welcome to the agent economy, where humans and agents rent out intelligence.”${c.reset}`);
+    console.log(line);
+    if (mode === "install") {
+        console.log(`  ${c.green}✔${c.reset} ${c.bold}Catelog SDK installed successfully!${c.reset}`);
+        console.log(`  ${c.dim}Supported runtimes & package managers:${c.reset}`);
+        console.log(`  ${c.cyan}pnpm${c.reset} ${c.gray}|${c.reset} ${c.brightBlue}npm${c.reset} ${c.gray}|${c.reset} ${c.brightMagenta}yarn${c.reset} ${c.gray}|${c.reset} ${c.brightYellow}bun${c.reset} ${c.gray}• Node.js 18+ • TypeScript 5+${c.reset}`);
+        console.log("");
+        console.log(`  ${c.bold}Quick Start:${c.reset}`);
+        console.log(`  ${c.dim}import { createMarketplaceAgent } from "catelog";${c.reset}`);
+        console.log(`  ${c.dim}const agent = createMarketplaceAgent({ ... });${c.reset}`);
+        console.log(`  ${c.dim}agent.serve(3000);${c.reset}`);
+    }
+    else {
+        const agentName = details?.name || "Marketplace Agent";
+        const serverUrl = details?.url || "http://localhost:3000";
+        console.log(`  ${c.green}●${c.reset} ${c.bold}${agentName}${c.reset} is active and ready for jobs!`);
+        console.log(`  ${c.dim}Public URL:${c.reset}  ${c.brightCyan}${serverUrl}${c.reset}`);
+        console.log(`  ${c.dim}Endpoints:${c.reset}   ${c.white}${serverUrl}/health${c.reset} ${c.gray}•${c.reset} ${c.white}${serverUrl}/schema${c.reset} ${c.gray}•${c.reset} ${c.white}${serverUrl}/execute${c.reset}`);
+    }
+    console.log(doubleLine + "\n");
+}
+// If executed directly (e.g. via postinstall or node)
+if (process.argv[1]?.endsWith("banner.ts") || process.argv[1]?.endsWith("banner.js")) {
+    renderBanner("install");
+}
+//# sourceMappingURL=banner.js.map

package/dist/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../src/banner.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,8CAA8C;AAC9C,MAAM,CAAC,GAAG;IACR,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,SAAS;IAEpB,iBAAiB;IACjB,IAAI,EAAE,UAAU;IAChB,UAAU,EAAE,UAAU;IACtB,OAAO,EAAE,UAAU;IACnB,aAAa,EAAE,UAAU;IACzB,IAAI,EAAE,UAAU;IAChB,UAAU,EAAE,UAAU;IACtB,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,UAAU;IACvB,MAAM,EAAE,UAAU;IAClB,YAAY,EAAE,UAAU;IACxB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IAEjB,cAAc;IACd,SAAS,EAAE,UAAU;IACrB,MAAM,EAAE,UAAU;IAClB,UAAU,EAAE,WAAW;CACxB,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,OAA8B,SAAS,EAAE,OAAyC;IAC7G,gCAAgC;IAChC,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QACjD,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG;IACnB,CAAC,CAAC,UAAU;IACZ,CAAC,CAAC,UAAU;IACZ,CAAC,CAAC,aAAa;IACf,CAAC,CAAC,aAAa;IACf,CAAC,CAAC,OAAO;IACT,CAAC,CAAC,OAAO;CACZ,CAAC,OAAO,EAAE,CAAC;IAEV,MAAM,KAAK,GAAG,EAAE,CAAC;IACjB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;IAClD,MAAM,UAAU,GAAG,CAAC,CAAC,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;IAEjE,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAElB,oBAAoB;IACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,uBAAuB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACjF,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,MAAM,iFAAiF,CAAC,CAAC,KAAK,EAAE,CACzH,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAElB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,sCAAsC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9F,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,yCAAyC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,UAAU,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,aAAa,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,YAAY,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,gCAAgC,CAAC,CAAC,KAAK,EAAE,CACzO,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,oDAAoD,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACrF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,iDAAiD,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAClF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,GAAG,OAAO,EAAE,IAAI,IAAI,mBAAmB,CAAC;QACvD,MAAM,SAAS,GAAG,OAAO,EAAE,GAAG,IAAI,uBAAuB,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,GAAG,SAAS,GAAG,CAAC,CAAC,KAAK,gCAAgC,CAAC,CAAC;QACrG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,UAAU,GAAG,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACtF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,KAAK,GAAG,SAAS,UAAU,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,GAAG,SAAS,UAAU,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,GAAG,SAAS,WAAW,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACrN,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,sDAAsD;AACtD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;IACrF,YAAY,CAAC,SAAS,CAAC,CAAC;AAC1B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./security.js";
+export * from "./sse.js";
+export * from "./schema.js";
+export * from "./agent.js";
+export * from "./server.js";
+export * from "./banner.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./security.js";
+export * from "./sse.js";
+export * from "./schema.js";
+export * from "./agent.js";
+export * from "./server.js";
+export * from "./banner.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,20 @@
+import type { ZodTypeAny } from "zod";
+export type SchemaLike = ZodTypeAny | Record<string, unknown>;
+export declare function isZodSchema(schema: unknown): schema is ZodTypeAny;
+/**
+ * Converts a Zod schema or passes through a JSON schema object
+ * to standard JSON Schema (Draft-07).
+ */
+export declare function toJsonSchema(schema: SchemaLike, title?: string): Record<string, unknown>;
+/**
+ * Validates input against schema (if Zod is provided).
+ * Returns { success: true, data } or { success: false, error }
+ */
+export declare function validateSchemaData<T>(schema: SchemaLike, data: unknown): {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    errors: string[];
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEtC,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9D,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,UAAU,CAOjE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBxF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,OAAO,GACZ;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAcnE"}

package/dist/schema.js

@@ -0,0 +1,49 @@
+import { zodToJsonSchema } from "zod-to-json-schema";
+export function isZodSchema(schema) {
+    return (typeof schema === "object" &&
+        schema !== null &&
+        "_def" in schema &&
+        typeof schema.safeParse === "function");
+}
+/**
+ * Converts a Zod schema or passes through a JSON schema object
+ * to standard JSON Schema (Draft-07).
+ */
+export function toJsonSchema(schema, title) {
+    if (isZodSchema(schema)) {
+        const converted = zodToJsonSchema(schema, {
+            name: title,
+            target: "jsonSchema7",
+            $refStrategy: "none",
+        });
+        // If wrapped in definitions, unwrap the root object
+        if (converted && typeof converted === "object") {
+            const record = converted;
+            const defs = record.definitions;
+            if (defs && title && defs[title]) {
+                return defs[title];
+            }
+            return record;
+        }
+        return converted;
+    }
+    // Already a raw JSON schema object
+    return schema;
+}
+/**
+ * Validates input against schema (if Zod is provided).
+ * Returns { success: true, data } or { success: false, error }
+ */
+export function validateSchemaData(schema, data) {
+    if (isZodSchema(schema)) {
+        const result = schema.safeParse(data);
+        if (result.success) {
+            return { success: true, data: result.data };
+        }
+        const formattedErrors = result.error.errors.map((err) => `${err.path.join(".") || "root"}: ${err.message}`);
+        return { success: false, errors: formattedErrors };
+    }
+    // Raw JSON schema pass-through (pre-validated by gateway as per spec rule 4)
+    return { success: true, data: data };
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAKrD,MAAM,UAAU,WAAW,CAAC,MAAe;IACzC,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,MAAM,IAAI,MAAM;QAChB,OAAQ,MAAkC,CAAC,SAAS,KAAK,UAAU,CACpE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAkB,EAAE,KAAc;IAC7D,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,EAAE;YACxC,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,aAAa;YACrB,YAAY,EAAE,MAAM;SACrB,CAAC,CAAC;QAEH,oDAAoD;QACpD,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC/C,MAAM,MAAM,GAAG,SAAoC,CAAC;YACpD,MAAM,IAAI,GAAG,MAAM,CAAC,WAAkD,CAAC;YACvE,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjC,OAAO,IAAI,CAAC,KAAK,CAA4B,CAAC;YAChD,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,SAAoC,CAAC;IAC9C,CAAC;IAED,mCAAmC;IACnC,OAAO,MAAiC,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAkB,EAClB,IAAa;IAEb,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAS,EAAE,CAAC;QACnD,CAAC;QACD,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAC7C,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,CAC3D,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACrD,CAAC;IAED,6EAA6E;IAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAS,EAAE,CAAC;AAC5C,CAAC"}

package/dist/security.d.ts

@@ -0,0 +1,52 @@
+import type { ErrorCode } from "./types.js";
+export interface SecurityOptions {
+    secret?: string;
+    maxTimestampDriftMs?: number;
+    nonceTtlMs?: number;
+}
+export declare class SecurityVerificationError extends Error {
+    readonly code: ErrorCode;
+    readonly statusCode: number;
+    constructor(code: ErrorCode, message: string, statusCode?: number);
+}
+export declare class SecurityManager {
+    private secret?;
+    private maxTimestampDriftMs;
+    private nonceTtlMs;
+    private seenNonces;
+    private activeRunIds;
+    private completedRunIds;
+    constructor(options?: SecurityOptions);
+    setSecret(secret: string): void;
+    getSecret(): string | undefined;
+    /**
+     * Computes SHA-256 hash in lowercase hex of request body
+     */
+    computeBodyHash(rawBody: string | Buffer): string;
+    /**
+     * Constructs the canonical string according to MAPS 1.0.0:
+     * METHOD\nPATH\nTIMESTAMP\nNONCE\nRUN_ID\nBodyHash
+     */
+    buildCanonicalString(method: string, path: string, timestamp: string | number, nonce: string, runId: string, bodyHash: string): string;
+    /**
+     * Calculates HMAC-SHA256 signature in lowercase hex
+     */
+    calculateSignature(canonicalString: string, secret: string): string;
+    /**
+     * Verifies headers, timestamp, nonce, and HMAC-SHA256 signature.
+     */
+    verifyRequest(params: {
+        method: string;
+        path: string;
+        headers: Record<string, string | string[] | undefined>;
+        rawBody: string | Buffer;
+    }): {
+        runId: string;
+        nonce: string;
+        timestamp: number;
+    };
+    markRunStarted(runId: string): void;
+    markRunCompleted(runId: string): void;
+    private cleanupOldEntries;
+}
+//# sourceMappingURL=security.d.ts.map

package/dist/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,yBAA0B,SAAQ,KAAK;aAEhC,IAAI,EAAE,SAAS;aAEf,UAAU,EAAE,MAAM;gBAFlB,IAAI,EAAE,SAAS,EAC/B,OAAO,EAAE,MAAM,EACC,UAAU,GAAE,MAAY;CAK3C;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,eAAe,CAA6B;gBAExC,OAAO,GAAE,eAAoB;IAMlC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,SAAS,IAAI,MAAM,GAAG,SAAS;IAItC;;OAEG;IACI,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAIxD;;;OAGG;IACI,oBAAoB,CACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,MAAM;IAMT;;OAEG;IACI,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAI1E;;OAEG;IACI,aAAa,CAAC,MAAM,EAAE;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;QACvD,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;KAC1B,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IA+FhD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAInC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK5C,OAAO,CAAC,iBAAiB;CAgB1B"}