@ainetwork/adk 0.0.1

package/dist/esm/types/tool.d.ts

@@ -0,0 +1,87 @@
+import type { A2AClient, AgentCard } from "@a2a-js/sdk";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Supported tool protocol types in the AIN-ADK framework.
+ */
+export declare enum TOOL_PROTOCOL_TYPE {
+    /** Agent-to-Agent protocol */
+    A2A = "A2A",
+    /** Model Context Protocol */
+    MCP = "MCP"
+}
+/**
+ * Represents a tool invocation request.
+ */
+export type ToolCall = {
+    /** Name of the tool to invoke */
+    name: string;
+    /** Arguments to pass to the tool */
+    arguments?: Record<string, unknown>;
+};
+/**
+ * Response from a model fetch operation.
+ *
+ * Contains either content (text response) or tool calls (function invocations),
+ * or both in the case of mixed responses.
+ */
+export type FetchResponse = {
+    /** Text content response from the model */
+    content?: string;
+    /** Array of tool calls requested by the model */
+    toolCalls?: ToolCall[];
+};
+/**
+ * MCP-specific tool implementation.
+ *
+ * Wraps an MCP tool with additional metadata and functionality
+ * required for integration with the AIN-ADK framework.
+ */
+export interface IMCPTool extends IAgentTool {
+    /** The underlying MCP tool definition */
+    mcpTool: Tool;
+    /** Name of the MCP server providing this tool */
+    serverName: string;
+}
+/**
+ * A2A-specific tool implementation.
+ *
+ * Represents a tool provided by another agent through the A2A protocol,
+ * including the client connection and agent metadata.
+ */
+export interface IA2ATool extends IAgentTool {
+    /** A2A client instance for communication with the remote agent */
+    client: A2AClient;
+    /** Agent card containing metadata about the remote agent */
+    card: AgentCard;
+}
+/**
+ * Base interface for all tools in the AIN-ADK framework.
+ *
+ * Provides a protocol-agnostic interface for tool management,
+ * allowing tools from different sources (MCP, A2A) to be used
+ * interchangeably throughout the system.
+ *
+ * @example
+ * ```typescript
+ * const tool: IAgentTool = {
+ *   id: "search-tool",
+ *   protocol: TOOL_PROTOCOL_TYPE.MCP,
+ *   enabled: true,
+ *   enable: () => { this.enabled = true; },
+ *   disable: () => { this.enabled = false; }
+ * };
+ * ```
+ */
+export interface IAgentTool {
+    /** Unique identifier for the tool */
+    id: string;
+    /** Protocol type (MCP or A2A) */
+    protocol: TOOL_PROTOCOL_TYPE;
+    /** Whether the tool is currently enabled for use */
+    enabled: boolean;
+    /** Enables the tool for use */
+    enable: () => void;
+    /** Disables the tool from being used */
+    disable: () => void;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/esm/types/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/types/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D;;GAEG;AACH,oBAAY,kBAAkB;IAC7B,8BAA8B;IAC9B,GAAG,QAAQ;IACX,6BAA6B;IAC7B,GAAG,QAAQ;CACX;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG;IACtB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC3B,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC3C,yCAAyC;IACzC,OAAO,EAAE,IAAI,CAAC;IACd,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC3C,kEAAkE;IAClE,MAAM,EAAE,SAAS,CAAC;IAClB,4DAA4D;IAC5D,IAAI,EAAE,SAAS,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,UAAU;IAC1B,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,oDAAoD;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,wCAAwC;IACxC,OAAO,EAAE,MAAM,IAAI,CAAC;CACpB"}

package/dist/esm/types/tool.js

@@ -0,0 +1,11 @@
+/**
+ * Supported tool protocol types in the AIN-ADK framework.
+ */
+export var TOOL_PROTOCOL_TYPE;
+(function (TOOL_PROTOCOL_TYPE) {
+    /** Agent-to-Agent protocol */
+    TOOL_PROTOCOL_TYPE["A2A"] = "A2A";
+    /** Model Context Protocol */
+    TOOL_PROTOCOL_TYPE["MCP"] = "MCP";
+})(TOOL_PROTOCOL_TYPE || (TOOL_PROTOCOL_TYPE = {}));
+//# sourceMappingURL=tool.js.map

package/dist/esm/types/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../src/types/tool.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC7B,8BAA8B;IAC9B,iCAAW,CAAA;IACX,6BAA6B;IAC7B,iCAAW,CAAA;AACZ,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B"}

package/dist/esm/utils/logger.d.ts

@@ -0,0 +1,13 @@
+import winston from "winston";
+export declare const logger: winston.Logger;
+export declare const getLogger: (service: string) => winston.Logger;
+export declare const loggers: {
+    readonly agent: winston.Logger;
+    readonly intent: winston.Logger;
+    readonly mcp: winston.Logger;
+    readonly a2a: winston.Logger;
+    readonly model: winston.Logger;
+    readonly server: winston.Logger;
+    readonly fol: winston.Logger;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/esm/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AA2B9B,eAAO,MAAM,MAAM,gBAA0B,CAAC;AAG9C,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,mBAA0B,CAAC;AAGpE,eAAO,MAAM,OAAO;;;;;;;;CAQV,CAAC"}

package/dist/esm/utils/logger.js

@@ -0,0 +1,32 @@
+import winston from "winston";
+const { combine, timestamp, printf, colorize, errors } = winston.format;
+const createLogger = (service) => {
+    const logger = winston.createLogger({
+        level: process.env.LOG_LEVEL || "info",
+        format: combine(errors({ stack: true }), colorize(), timestamp({ format: "HH:mm:ss" }), printf(({ level, message, timestamp, service, stack, ...meta }) => {
+            const metaStr = Object.keys(meta).length
+                ? ` | ${JSON.stringify(meta)}`
+                : "";
+            const errorStack = stack ? `\n${stack}` : "";
+            return `${timestamp} [${service}] ${level}: ${message}${metaStr}${errorStack}`;
+        })),
+        defaultMeta: { service },
+        transports: [new winston.transports.Console()],
+    });
+    return logger;
+};
+// Default logger instance
+export const logger = createLogger("ain-adk");
+// Factory function for creating service-specific loggers
+export const getLogger = (service) => createLogger(service);
+// Convenience methods for different components
+export const loggers = {
+    agent: getLogger("AINAgent"),
+    intent: getLogger("Intent"),
+    mcp: getLogger("MCPModule"),
+    a2a: getLogger("A2AModule"),
+    model: getLogger("Model"),
+    server: getLogger("A2AServer"),
+    fol: getLogger("FOL"),
+};
+//# sourceMappingURL=logger.js.map

package/dist/esm/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;AAExE,MAAM,YAAY,GAAG,CAAC,OAAe,EAAE,EAAE;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;QACnC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;QACtC,MAAM,EAAE,OAAO,CACd,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EACvB,QAAQ,EAAE,EACV,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EACjC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE;YACjE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM;gBACvC,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;gBAC9B,CAAC,CAAC,EAAE,CAAC;YACN,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,OAAO,GAAG,SAAS,KAAK,OAAO,KAAK,KAAK,KAAK,OAAO,GAAG,OAAO,GAAG,UAAU,EAAE,CAAC;QAChF,CAAC,CAAC,CACF;QACD,WAAW,EAAE,EAAE,OAAO,EAAE;QACxB,UAAU,EAAE,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;KAC9C,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAEF,0BAA0B;AAC1B,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;AAE9C,yDAAyD;AACzD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;AAEpE,+CAA+C;AAC/C,MAAM,CAAC,MAAM,OAAO,GAAG;IACtB,KAAK,EAAE,SAAS,CAAC,UAAU,CAAC;IAC5B,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC;IAC3B,GAAG,EAAE,SAAS,CAAC,WAAW,CAAC;IAC3B,GAAG,EAAE,SAAS,CAAC,WAAW,CAAC;IAC3B,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC;IACzB,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC;IAC9B,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC;CACZ,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+	"name": "@ainetwork/adk",
+	"version": "0.0.1",
+	"description": "AI Network Agent Development Kit",
+	"repository": "git@github.com:ainetwork-ai/ain-adk.git",
+	"author": "AI Network (https://ainetwork.ai)",
+	"type": "module",
+	"engines": {
+		"node": ">=20"
+	},
+	"exports": {
+		"./*": {
+			"import": "./dist/esm/*",
+			"require": "./dist/cjs/*"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "npm run build:esm && npm run build:cjs",
+		"build:esm": "tsc -p tsconfig.esm.json && tsc-alias -p tsconfig.esm.json && echo '{\"type\": \"module\"}' > dist/esm/package.json",
+		"build:cjs": "tsc -p tsconfig.cjs.json && tsc-alias -p tsconfig.cjs.json && echo '{\"type\": \"commonjs\"}' > dist/cjs/package.json",
+		"format": "npx @biomejs/biome format --write",
+		"lint": "npx @biomejs/biome lint --write",
+		"check": "npx @biomejs/biome check",
+		"check:write": "npx @biomejs/biome check --write",
+		"test": "jest --passWithNoTests",
+		"prepare": "husky"
+	},
+	"keywords": [],
+	"license": "MIT",
+	"devDependencies": {
+		"@biomejs/biome": "2.0.4",
+		"@eslint/js": "^9.29.0",
+		"@types/cors": "^2.8.19",
+		"@types/express": "^5.0.3",
+		"@types/helmet": "^4.0.0",
+		"@types/jest": "^30.0.0",
+		"@types/node": "^24.0.1",
+		"eslint": "^9.29.0",
+		"husky": "^9.1.7",
+		"jest": "^30.0.0",
+		"ts-jest": "^29.4.0",
+		"ts-node": "^10.9.2",
+		"tsc-alias": "^1.8.16",
+		"tsx": "^4.20.3",
+		"typescript": "^5.8.3",
+		"typescript-eslint": "^8.34.1"
+	},
+	"dependencies": {
+		"@a2a-js/sdk": "^0.2.2",
+		"@google/genai": "^1.6.0",
+		"@modelcontextprotocol/sdk": "^1.12.3",
+		"cors": "^2.8.5",
+		"dotenv": "^16.5.0",
+		"express": "^5.1.0",
+		"http-status-codes": "^2.3.0",
+		"openai": "^5.3.0",
+		"uuid": "^11.1.0",
+		"winston": "^3.17.0"
+	}
+}