@artinet/sdk 0.5.5 → 0.5.6

package/dist/client/a2a-client.js

@@ -1,5 +1,10 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
 import { executeJsonRpcRequest, executeGetRequest, executeStreamEvents, } from "../transport/index.js";
-import { logError, INTERNAL_ERROR } from "../utils/index.js";
+import { INTERNAL_ERROR } from "../utils/index.js";
+import { logError } from "../utils/logging/index.js";
 /**
  * A2AClient is the main client class for interacting with Agent2Agent (A2A) protocol-compliant services.
  * It provides methods for sending tasks, retrieving statuses, canceling operations, and handling streaming responses.

package/dist/client/a2a-client.js.map

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

package/dist/index.js

@@ -1,6 +1,7 @@
 export * from "./types/index.js";
-export * from "./utils/index.js";
-export * from "./server/index.js";
 export * from "./client/index.js";
+export * from "./server/index.js";
+export * from "./services/index.js";
 export * from "./transport/index.js";
+export * from "./utils/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}

package/dist/server/express/errors.js

@@ -0,0 +1,51 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SystemError, INTERNAL_ERROR } from "../../utils/index.js";
+import { logError } from "../../utils/logging/index.js";
+import escapeHtml from "escape-html";
+/**
+ * Express error handler middleware.
+ */
+export const errorHandler = (err, req, res, _) => {
+    let headersSent = false;
+    if (res.headersSent) {
+        headersSent = true;
+    }
+    logError("errorHandler", JSON.stringify(err), err);
+    let reqId = null;
+    try {
+        if (req.body && typeof req.body === "object" && "id" in req.body) {
+            reqId = req.body.id;
+        }
+    }
+    catch (e) {
+        logError("A2AServer", "Error extracting request ID", e);
+    }
+    let jsonRpcError;
+    if (err instanceof SystemError) {
+        jsonRpcError = { code: err.code, message: err.message, data: err.data };
+    }
+    else {
+        const internalError = INTERNAL_ERROR(err.stack);
+        jsonRpcError = {
+            code: internalError.code,
+            message: internalError.message,
+            data: internalError.data,
+        };
+    }
+    const errorResponse = {
+        jsonrpc: "2.0",
+        id: escapeHtml(reqId),
+        error: jsonRpcError,
+    };
+    if (!headersSent) {
+        res.json(errorResponse);
+    }
+    else {
+        res.write(JSON.stringify(errorResponse));
+        res.end();
+    }
+};
+//# sourceMappingURL=errors.js.map

package/dist/server/express/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/server/express/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,6BAAyB;AAC/D,OAAO,EAAE,QAAQ,EAAE,qCAAiC;AAEpD,OAAO,UAAU,MAAM,aAAa,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAwB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;IACpE,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QACpB,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;IACD,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,IAAI,KAAK,GAAG,IAAI,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YACjE,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,QAAQ,CAAC,WAAW,EAAE,6BAA6B,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,YAA0B,CAAC;IAC/B,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;QAC/B,YAAY,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;IAC1E,CAAC;SAAM,CAAC;QACN,MAAM,aAAa,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChD,YAAY,GAAG;YACb,IAAI,EAAE,aAAa,CAAC,IAAI;YACxB,OAAO,EAAE,aAAa,CAAC,OAAO;YAC9B,IAAI,EAAE,aAAa,CAAC,IAAI;SACzB,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG;QACpB,OAAO,EAAE,KAAK;QACd,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC;QACrB,KAAK,EAAE,YAAY;KACpB,CAAC;IAEF,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;QACzC,GAAG,CAAC,GAAG,EAAE,CAAC;IACZ,CAAC;AACH,CAAC,CAAC"}

package/dist/server/express/index.js

@@ -0,0 +1,4 @@
+export * from "./server.js";
+export * from "./middeware.js";
+export * from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/server/express/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/express/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/server/express/middeware.js

@@ -0,0 +1,116 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { PUSH_NOTIFICATION_NOT_SUPPORTED, INVALID_REQUEST, INVALID_PARAMS, METHOD_NOT_FOUND, } from "../../utils/index.js";
+import { logError } from "../../utils/logging/index.js";
+const isValidMethod = (method) => {
+    return (method &&
+        method !== "" &&
+        method !== null &&
+        method !== undefined &&
+        typeof method === "string");
+};
+const checkParams = (params, method) => {
+    if (!params ||
+        (typeof params === "object" && Object.keys(params).length === 0)) {
+        throw INVALID_PARAMS({
+            data: {
+                message: "No params provided",
+                method,
+            },
+        });
+    }
+};
+export async function jsonRPCMiddleware(service, req, res, next) {
+    const { method, params, id, jsonrpc } = req.body;
+    // Validate JSON-RPC format
+    if (jsonrpc !== "2.0" || !id) {
+        res.json({
+            jsonrpc: "2.0",
+            id: id || null,
+            error: { code: -32600, message: "Invalid Request" },
+        });
+        return;
+    }
+    try {
+        if (!isValidMethod(method)) {
+            throw INVALID_REQUEST({
+                data: {
+                    message: "No method provided",
+                    method,
+                },
+            });
+        }
+        let result;
+        switch (method) {
+            case "message/send": {
+                checkParams(params, method);
+                result = await service.sendMessage(params);
+                break;
+            }
+            case "message/stream": {
+                checkParams(params, method);
+                res.writeHead(200, {
+                    "Content-Type": "text/event-stream",
+                    "Cache-Control": "no-cache",
+                    Connection: "keep-alive",
+                });
+                const stream = service.streamMessage(params);
+                for await (const data of stream) {
+                    res.write(`data: ${JSON.stringify({ jsonrpc: "2.0", id, result: data })}\n\n`);
+                }
+                res.end();
+                return;
+            }
+            case "tasks/resubscribe": {
+                checkParams(params, method);
+                const stream = service.resubscribe(params);
+                res.writeHead(200, {
+                    "Content-Type": "text/event-stream",
+                    "Cache-Control": "no-cache",
+                    Connection: "keep-alive",
+                });
+                for await (const data of stream) {
+                    res.write(`data: ${JSON.stringify({ jsonrpc: "2.0", id, result: data })}\n\n`);
+                }
+                res.end();
+                return;
+            }
+            case "tasks/get": {
+                checkParams(params, method);
+                result = await service.getTask(params);
+                break;
+            }
+            case "tasks/cancel": {
+                checkParams(params, method);
+                result = await service.cancelTask(params);
+                break;
+            }
+            case "tasks/pushNotificationConfig/set":
+            case "tasks/pushNotificationConfig/get":
+            case "tasks/pushNotificationConfig/delete":
+            case "task/pushNotificationConfig/list": {
+                throw PUSH_NOTIFICATION_NOT_SUPPORTED({
+                    data: {
+                        message: "Push notifications not supported",
+                        method,
+                    },
+                });
+            }
+            default:
+                throw METHOD_NOT_FOUND({
+                    data: {
+                        message: "Method not found",
+                        method,
+                    },
+                });
+        }
+        res.json({ jsonrpc: "2.0", id, result });
+    }
+    catch (error) {
+        logError("jsonRPCMiddleware", "error detected", error, req.body);
+        return next(error);
+    }
+}
+//# sourceMappingURL=middeware.js.map

package/dist/server/express/middeware.js.map

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

package/dist/server/express/server.js

@@ -0,0 +1,80 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import express from "express";
+import { INVALID_REQUEST } from "../../utils/index.js";
+import { createAgent } from "../../services/index.js";
+import cors from "cors";
+import { jsonRPCMiddleware } from "./middeware.js";
+import { errorHandler } from "./errors.js";
+function ensureAgent(agentOrParams) {
+    if (agentOrParams &&
+        typeof agentOrParams === "object" &&
+        "agentCard" in agentOrParams &&
+        typeof agentOrParams.agentCard === "object" &&
+        "sendMessage" in agentOrParams &&
+        typeof agentOrParams.sendMessage === "function" &&
+        "streamMessage" in agentOrParams &&
+        typeof agentOrParams.streamMessage === "function" &&
+        "addConnection" in agentOrParams &&
+        typeof agentOrParams.addConnection === "function" &&
+        "removeConnection" in agentOrParams &&
+        typeof agentOrParams.removeConnection === "function" &&
+        "getState" in agentOrParams &&
+        typeof agentOrParams.getState === "function" &&
+        "setState" in agentOrParams &&
+        typeof agentOrParams.setState === "function") {
+        return agentOrParams;
+    }
+    else if (agentOrParams &&
+        typeof agentOrParams === "object" &&
+        "engine" in agentOrParams &&
+        typeof agentOrParams.engine === "function" &&
+        "agentCard" in agentOrParams &&
+        typeof agentOrParams.agentCard === "object") {
+        return createAgent(agentOrParams);
+    }
+    throw new Error("invalid agent or params");
+}
+export function createAgentServer(params) {
+    const { app = express(), basePath = "/", agentCardPath = "/.well-known/agent-card.json", agent, } = params;
+    const agentInstance = ensureAgent(agent);
+    app.use(express.json());
+    app.use(cors(params.corsOptions));
+    app.get(agentCardPath, (_, res) => {
+        res.json(agentInstance.agentCard);
+    });
+    /**
+     * Now that agents are services we can wrap them in any kind of transport layer
+     * for express we can use json-rpc, but we could also use websockets, or any other
+     * transport layer.
+     */
+    //a standard express middleware to handle json-rpc requests
+    app.post(basePath, express.json(), async (req, res, next) => {
+        const { jsonrpc } = req.body;
+        if (jsonrpc === "2.0") {
+            return await jsonRPCMiddleware(agentInstance, req, res, next);
+        }
+        next(INVALID_REQUEST({ data: { message: "Invalid JSON-RPC request" } }));
+    });
+    app.use(errorHandler);
+    /** this is an example of using trpc as express middleware
+      app.use(
+        `${basePath}`,
+        trpcExpress.createExpressMiddleware({
+          router: agentRouter,
+          createContext: async (ctx: trpcExpress.CreateExpressContextOptions) => {
+            return {
+              ...ctx,
+              service: serviceInstance,
+              engine: agent,
+            };
+          },
+        })
+      );
+     * we could also just use trpc directly or any other transport layer
+     */
+    return { app, agent: agentInstance };
+}
+//# sourceMappingURL=server.js.map

package/dist/server/express/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/server/express/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,6BAAyB;AAEnD,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,IAAqB,MAAM,MAAM,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ3C,SAAS,WAAW,CAAC,aAAwC;IAC3D,IACE,aAAa;QACb,OAAO,aAAa,KAAK,QAAQ;QACjC,WAAW,IAAI,aAAa;QAC5B,OAAO,aAAa,CAAC,SAAS,KAAK,QAAQ;QAC3C,aAAa,IAAI,aAAa;QAC9B,OAAO,aAAa,CAAC,WAAW,KAAK,UAAU;QAC/C,eAAe,IAAI,aAAa;QAChC,OAAO,aAAa,CAAC,aAAa,KAAK,UAAU;QACjD,eAAe,IAAI,aAAa;QAChC,OAAO,aAAa,CAAC,aAAa,KAAK,UAAU;QACjD,kBAAkB,IAAI,aAAa;QACnC,OAAO,aAAa,CAAC,gBAAgB,KAAK,UAAU;QACpD,UAAU,IAAI,aAAa;QAC3B,OAAO,aAAa,CAAC,QAAQ,KAAK,UAAU;QAC5C,UAAU,IAAI,aAAa;QAC3B,OAAO,aAAa,CAAC,QAAQ,KAAK,UAAU,EAC5C,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;SAAM,IACL,aAAa;QACb,OAAO,aAAa,KAAK,QAAQ;QACjC,QAAQ,IAAI,aAAa;QACzB,OAAO,aAAa,CAAC,MAAM,KAAK,UAAU;QAC1C,WAAW,IAAI,aAAa;QAC5B,OAAO,aAAa,CAAC,SAAS,KAAK,QAAQ,EAC3C,CAAC;QACD,OAAO,WAAW,CAAC,aAAkC,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAIC;IAED,MAAM,EACJ,GAAG,GAAG,OAAO,EAAE,EACf,QAAQ,GAAG,GAAG,EACd,aAAa,GAAG,8BAA8B,EAC9C,KAAK,GACN,GAAG,MAAM,CAAC;IAEX,MAAM,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAEzC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACxB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IAClC,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QAChC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IACH;;;;OAIG;IACH,2DAA2D;IAC3D,GAAG,CAAC,IAAI,CACN,QAAQ,EACR,OAAO,CAAC,IAAI,EAAE,EACd,KAAK,EACH,GAAoB,EACpB,GAAqB,EACrB,IAA0B,EAC1B,EAAE;QACF,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;QAC7B,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;YACtB,OAAO,MAAM,iBAAiB,CAAC,aAAa,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,0BAA0B,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3E,CAAC,CACF,CAAC;IACF,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACtB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;AACvC,CAAC"}

package/dist/server/index.js

@@ -1,8 +1,2 @@
-export * from "./a2a-server.js";
-export * from "./interfaces/params.js";
-export * from "./interfaces/store.js";
-export * from "./lib/json-middleware.js";
-export * from "./lib/express-server.js";
-export * from "./lib/storage/file.js";
-export * from "./lib/storage/memory.js";
+export * from "./express/index.js";
 //# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}