@artemiskit/adapter-deepagents 0.2.0

package/dist/index.js

@@ -0,0 +1,268 @@
+// @bun
+// ../../../node_modules/nanoid/index.js
+import { webcrypto as crypto } from "crypto";
+
+// ../../../node_modules/nanoid/url-alphabet/index.js
+var urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
+
+// ../../../node_modules/nanoid/index.js
+var POOL_SIZE_MULTIPLIER = 128;
+var pool;
+var poolOffset;
+function fillPool(bytes) {
+  if (!pool || pool.length < bytes) {
+    pool = Buffer.allocUnsafe(bytes * POOL_SIZE_MULTIPLIER);
+    crypto.getRandomValues(pool);
+    poolOffset = 0;
+  } else if (poolOffset + bytes > pool.length) {
+    crypto.getRandomValues(pool);
+    poolOffset = 0;
+  }
+  poolOffset += bytes;
+}
+function nanoid(size = 21) {
+  fillPool(size |= 0);
+  let id = "";
+  for (let i = poolOffset - size;i < poolOffset; i++) {
+    id += urlAlphabet[pool[i] & 63];
+  }
+  return id;
+}
+
+// src/client.ts
+class DeepAgentsAdapter {
+  system;
+  config;
+  provider = "deepagents";
+  traces = [];
+  messages = [];
+  constructor(config, system) {
+    this.config = config;
+    this.system = system;
+    this.validateSystem(system);
+  }
+  validateSystem(system) {
+    const hasMethod = typeof system.invoke === "function" || typeof system.run === "function" || typeof system.execute === "function";
+    if (!hasMethod) {
+      throw new Error("DeepAgents system must have an invoke(), run(), or execute() method");
+    }
+  }
+  async generate(options) {
+    const startTime = Date.now();
+    this.traces = [];
+    this.messages = [];
+    const input = this.prepareInput(options);
+    const callbacks = this.createCallbacks();
+    const execConfig = {
+      timeout: this.config.executionTimeout ?? 300000,
+      callbacks
+    };
+    const response = await this.executeSystem(input, execConfig);
+    const latencyMs = Date.now() - startTime;
+    const text = this.extractOutput(response);
+    const metadata = this.extractMetadata(response);
+    const tokens = {
+      prompt: response.tokenUsage?.prompt ?? 0,
+      completion: response.tokenUsage?.completion ?? 0,
+      total: response.tokenUsage?.total ?? 0
+    };
+    return {
+      id: nanoid(),
+      model: this.config.name || "deepagents:system",
+      text,
+      tokens,
+      latencyMs,
+      finishReason: "stop",
+      raw: {
+        response,
+        metadata
+      }
+    };
+  }
+  async executeSystem(input, config) {
+    if (typeof this.system.invoke === "function") {
+      return this.system.invoke(input, config);
+    }
+    if (typeof this.system.run === "function") {
+      return this.system.run(input, config);
+    }
+    if (typeof this.system.execute === "function") {
+      return this.system.execute(input, config);
+    }
+    throw new Error("No execution method available on DeepAgents system");
+  }
+  async* stream(options, onChunk) {
+    if (!this.system.stream) {
+      const result = await this.generate(options);
+      onChunk(result.text);
+      yield result.text;
+      return;
+    }
+    this.traces = [];
+    this.messages = [];
+    const input = this.prepareInput(options);
+    const stream = this.system.stream(input, {
+      timeout: this.config.executionTimeout ?? 300000
+    });
+    for await (const event of stream) {
+      if (event.type === "agent_start" || event.type === "agent_end") {
+        this.traces.push({
+          agent: event.agent || "unknown",
+          action: event.type,
+          output: event.data,
+          timestamp: event.timestamp || Date.now()
+        });
+      }
+      if (event.type === "message" && event.data) {
+        const msgData = event.data;
+        this.messages.push(msgData);
+      }
+      if (event.type === "token" && event.content) {
+        onChunk(event.content);
+        yield event.content;
+      }
+    }
+  }
+  async capabilities() {
+    return {
+      streaming: typeof this.system.stream === "function",
+      functionCalling: true,
+      toolUse: true,
+      maxContext: 128000,
+      vision: false,
+      jsonMode: false
+    };
+  }
+  async close() {}
+  prepareInput(options) {
+    if (typeof options.prompt === "string") {
+      return {
+        task: options.prompt,
+        query: options.prompt,
+        input: options.prompt
+      };
+    }
+    const messages = options.prompt;
+    const lastUserMessage = messages.findLast((m) => m.role === "user");
+    const systemMessage = messages.find((m) => m.role === "system");
+    const input = {
+      task: lastUserMessage?.content || "",
+      query: lastUserMessage?.content || "",
+      input: lastUserMessage?.content || ""
+    };
+    if (systemMessage) {
+      input.context = { systemPrompt: systemMessage.content };
+    }
+    input.messages = messages.map((m) => ({
+      role: m.role,
+      content: m.content
+    }));
+    return input;
+  }
+  extractOutput(response) {
+    const possibleKeys = ["result", "output", "response", "answer", "content"];
+    for (const key of possibleKeys) {
+      const value = response[key];
+      if (typeof value === "string") {
+        return value;
+      }
+    }
+    if (response.traces?.length) {
+      const lastTrace = response.traces[response.traces.length - 1];
+      if (lastTrace.output) {
+        return typeof lastTrace.output === "string" ? lastTrace.output : JSON.stringify(lastTrace.output);
+      }
+    }
+    return JSON.stringify(response);
+  }
+  createCallbacks() {
+    const callbacks = {};
+    if (this.config.captureTraces !== false) {
+      callbacks.onAgentStart = (agent, input) => {
+        this.traces.push({
+          agent,
+          action: "start",
+          input,
+          timestamp: Date.now()
+        });
+      };
+      callbacks.onAgentEnd = (agent, output) => {
+        this.traces.push({
+          agent,
+          action: "end",
+          output,
+          timestamp: Date.now()
+        });
+      };
+      callbacks.onToolUse = (agent, tool, input) => {
+        this.traces.push({
+          agent,
+          action: "tool_use",
+          input: { tool, toolInput: input },
+          toolsUsed: [tool],
+          timestamp: Date.now()
+        });
+      };
+    }
+    if (this.config.captureMessages !== false) {
+      callbacks.onMessage = (from, to, message) => {
+        this.messages.push({
+          from,
+          to,
+          content: typeof message === "string" ? message : JSON.stringify(message),
+          timestamp: Date.now()
+        });
+      };
+    }
+    return callbacks;
+  }
+  extractMetadata(response) {
+    const allTraces = [...response.traces || [], ...this.traces];
+    const allMessages = [...response.messages || [], ...this.messages];
+    const agentsSet = new Set;
+    for (const trace of allTraces) {
+      agentsSet.add(trace.agent);
+    }
+    for (const msg of allMessages) {
+      agentsSet.add(msg.from);
+      agentsSet.add(msg.to);
+    }
+    if (response.agents) {
+      for (const agent of response.agents) {
+        agentsSet.add(agent);
+      }
+    }
+    const toolsSet = new Set;
+    let toolCallCount = 0;
+    for (const trace of allTraces) {
+      if (trace.toolsUsed) {
+        for (const tool of trace.toolsUsed) {
+          toolsSet.add(tool);
+        }
+        toolCallCount += trace.toolsUsed.length;
+      }
+    }
+    return {
+      name: this.config.name,
+      agentsInvolved: Array.from(agentsSet),
+      totalAgentCalls: allTraces.filter((t) => t.action === "start" || t.action === "end").length,
+      totalMessages: allMessages.length,
+      totalToolCalls: toolCallCount,
+      toolsUsed: Array.from(toolsSet),
+      traces: this.config.captureTraces !== false ? allTraces : undefined,
+      messages: this.config.captureMessages !== false ? allMessages : undefined,
+      executionTimeMs: response.executionTimeMs
+    };
+  }
+}
+function createDeepAgentsAdapter(system, options) {
+  const config = {
+    provider: "deepagents",
+    ...options
+  };
+  return new DeepAgentsAdapter(config, system);
+}
+export {
+  createDeepAgentsAdapter,
+  DeepAgentsAdapter
+};

package/dist/types.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Types for DeepAgents adapter
+ */
+import type { BaseAdapterConfig } from '@artemiskit/core';
+/**
+ * Configuration for DeepAgents adapter
+ */
+export interface DeepAgentsAdapterConfig extends BaseAdapterConfig {
+    provider: 'deepagents';
+    /**
+     * Name identifier for the agent system (for logging/tracking)
+     */
+    name?: string;
+    /**
+     * Whether to capture agent traces and execution history
+     * @default true
+     */
+    captureTraces?: boolean;
+    /**
+     * Whether to capture inter-agent messages
+     * @default true
+     */
+    captureMessages?: boolean;
+    /**
+     * Maximum execution time in milliseconds
+     * @default 300000 (5 minutes)
+     */
+    executionTimeout?: number;
+    /**
+     * Custom input transformer function name
+     */
+    inputTransformer?: string;
+    /**
+     * Custom output transformer function name
+     */
+    outputTransformer?: string;
+}
+/**
+ * Generic interface for DeepAgents systems
+ * Supports multi-agent orchestration with invoke() or run() methods
+ */
+export interface DeepAgentsSystem {
+    invoke?(input: DeepAgentsInput, config?: DeepAgentsConfig): Promise<DeepAgentsOutput>;
+    run?(input: DeepAgentsInput, config?: DeepAgentsConfig): Promise<DeepAgentsOutput>;
+    execute?(input: DeepAgentsInput, config?: DeepAgentsConfig): Promise<DeepAgentsOutput>;
+    stream?(input: DeepAgentsInput, config?: DeepAgentsConfig): AsyncIterable<DeepAgentsStreamEvent>;
+}
+/**
+ * Input format for DeepAgents systems
+ */
+export interface DeepAgentsInput {
+    /** The main task/query to process */
+    task?: string;
+    query?: string;
+    input?: string;
+    message?: string;
+    /** Optional context/memory from previous interactions */
+    context?: Record<string, unknown>;
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Configuration for DeepAgents execution
+ */
+export interface DeepAgentsConfig {
+    /** Maximum iterations for agent loops */
+    maxIterations?: number;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Callback handlers */
+    callbacks?: DeepAgentsCallbacks;
+    [key: string]: unknown;
+}
+/**
+ * Callback handlers for DeepAgents execution
+ */
+export interface DeepAgentsCallbacks {
+    onAgentStart?: (agent: string, input: unknown) => void;
+    onAgentEnd?: (agent: string, output: unknown) => void;
+    onMessage?: (from: string, to: string, message: unknown) => void;
+    onToolUse?: (agent: string, tool: string, input: unknown) => void;
+    onError?: (agent: string, error: Error) => void;
+}
+/**
+ * Output from DeepAgents system execution
+ */
+export interface DeepAgentsOutput {
+    /** Main result/output */
+    result?: string;
+    output?: string;
+    response?: string;
+    answer?: string;
+    /** Execution traces from agents */
+    traces?: DeepAgentsTrace[];
+    /** Messages exchanged between agents */
+    messages?: DeepAgentsMessage[];
+    /** Agents that participated in the execution */
+    agents?: string[];
+    /** Total execution time */
+    executionTimeMs?: number;
+    /** Token usage if available */
+    tokenUsage?: {
+        prompt?: number;
+        completion?: number;
+        total?: number;
+    };
+    /** Raw response data */
+    [key: string]: unknown;
+}
+/**
+ * Trace of a single agent's execution
+ */
+export interface DeepAgentsTrace {
+    /** Agent identifier */
+    agent: string;
+    /** Action taken by the agent */
+    action: string;
+    /** Input to the action */
+    input?: unknown;
+    /** Output/result of the action */
+    output?: unknown;
+    /** Timestamp */
+    timestamp?: number;
+    /** Duration in milliseconds */
+    durationMs?: number;
+    /** Tools used during this action */
+    toolsUsed?: string[];
+}
+/**
+ * Message exchanged between agents
+ */
+export interface DeepAgentsMessage {
+    /** Sender agent */
+    from: string;
+    /** Recipient agent */
+    to: string;
+    /** Message content */
+    content: string;
+    /** Message type */
+    type?: 'request' | 'response' | 'broadcast' | 'delegation';
+    /** Timestamp */
+    timestamp?: number;
+}
+/**
+ * Streaming event from DeepAgents
+ */
+export interface DeepAgentsStreamEvent {
+    /** Event type */
+    type: 'agent_start' | 'agent_end' | 'message' | 'tool_use' | 'token' | 'error' | 'done';
+    /** Agent involved */
+    agent?: string;
+    /** Event data */
+    data?: unknown;
+    /** Text content (for token events) */
+    content?: string;
+    /** Timestamp */
+    timestamp?: number;
+}
+/**
+ * Metadata extracted from DeepAgents execution
+ */
+export interface DeepAgentsExecutionMetadata {
+    /** System/workflow name */
+    name?: string;
+    /** Agents that participated */
+    agentsInvolved: string[];
+    /** Total agent invocations */
+    totalAgentCalls: number;
+    /** Total messages exchanged */
+    totalMessages: number;
+    /** Total tool calls across all agents */
+    totalToolCalls: number;
+    /** Unique tools used */
+    toolsUsed: string[];
+    /** Execution traces */
+    traces?: DeepAgentsTrace[];
+    /** Messages log */
+    messages?: DeepAgentsMessage[];
+    /** Total execution time */
+    executionTimeMs?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@artemiskit/adapter-deepagents",
+  "version": "0.2.0",
+  "description": "DeepAgents.js adapter for ArtemisKit - Test DeepAgents multi-agent systems",
+  "type": "module",
+  "license": "Apache-2.0",
+  "author": "code-sensei",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/code-sensei/artemiskit.git",
+    "directory": "packages/adapters/deepagents"
+  },
+  "bugs": {
+    "url": "https://github.com/code-sensei/artemiskit/issues"
+  },
+  "homepage": "https://artemiskit.vercel.app",
+  "keywords": ["llm", "deepagents", "multi-agent", "agents", "adapter", "artemiskit", "testing"],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc && bun build ./src/index.ts --outdir ./dist --target bun",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@artemiskit/core": "workspace:*",
+    "nanoid": "^5.0.0"
+  },
+  "peerDependencies": {
+    "deepagents": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "deepagents": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/bun": "^1.1.0",
+    "typescript": "^5.3.0"
+  }
+}