@slashfi/agents-sdk 0.62.0 → 0.63.0

package/dist/pack.js

@@ -1,252 +0,0 @@
-/**
- * ADK Pack
- *
- * Generates a publishable npm package from an agent.json file.
- *
- * Input: agent.json (SerializedAgentDefinition)
- * Output: ready-to-publish directory with:
- *   - package.json
- *   - agent.json (copy)
- *   - meta.json (version metadata + diff)
- *   - index.js + index.d.ts (typed export)
- */
-import { spawnSync } from "node:child_process";
-import { createHash } from "node:crypto";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { resolve } from "node:path";
-import { parseJsonc } from "./jsonc.js";
-import { assertValidDefinition } from "./validate.js";
-// ============================================
-// Hash
-// ============================================
-function contentHash(content) {
-    return createHash("sha256").update(content).digest("hex").slice(0, 8);
-}
-// ============================================
-// Diff
-// ============================================
-function diffDefinitions(current, previous, previousRawContent) {
-    const prevToolNames = new Set(previous.tools.map((t) => t.name));
-    const currToolNames = new Set(current.tools.map((t) => t.name));
-    const toolsAdded = current.tools
-        .filter((t) => !prevToolNames.has(t.name))
-        .map((t) => t.name);
-    const toolsRemoved = previous.tools
-        .filter((t) => !currToolNames.has(t.name))
-        .map((t) => t.name);
-    // Find modified tools (same name, different schema)
-    const toolsModified = [];
-    const schemaChanges = [];
-    const prevToolMap = new Map(previous.tools.map((t) => [t.name, t]));
-    for (const tool of current.tools) {
-        const prev = prevToolMap.get(tool.name);
-        if (!prev)
-            continue;
-        const currSchema = JSON.stringify(tool.inputSchema);
-        const prevSchema = JSON.stringify(prev.inputSchema);
-        if (currSchema !== prevSchema) {
-            toolsModified.push(tool.name);
-            // Generate human-readable schema change description
-            const currProps = Object.keys(tool.inputSchema.properties || {});
-            const prevProps = Object.keys(prev.inputSchema.properties || {});
-            const added = currProps.filter((p) => !prevProps.includes(p));
-            const removed = prevProps.filter((p) => !currProps.includes(p));
-            if (added.length > 0) {
-                schemaChanges.push(`${tool.name}: added properties: ${added.join(", ")}`);
-            }
-            if (removed.length > 0) {
-                schemaChanges.push(`${tool.name}: removed properties: ${removed.join(", ")}`);
-            }
-            if (added.length === 0 && removed.length === 0) {
-                schemaChanges.push(`${tool.name}: schema modified`);
-            }
-        }
-    }
-    return {
-        previousHash: contentHash(previousRawContent),
-        toolsAdded,
-        toolsRemoved,
-        toolsModified,
-        schemaChanges,
-    };
-}
-// ============================================
-// Pack
-// ============================================
-export function pack(options) {
-    const { agentFile, outDir = "./dist", scope = "@agentdef" } = options;
-    // Read agent.json
-    const agentPath = resolve(agentFile);
-    if (!existsSync(agentPath)) {
-        throw new Error(`agent.json not found: ${agentPath}`);
-    }
-    const agentContent = readFileSync(agentPath, "utf-8");
-    const definition = parseJsonc(agentContent);
-    // Validate the definition schema
-    assertValidDefinition(definition, agentPath);
-    // Compute hash + version
-    const hash = contentHash(agentContent);
-    const version = `${definition.version || "1.0.0"}`;
-    const packageName = `${scope}/${definition.path}`;
-    // Create output directory
-    const packageDir = resolve(outDir, definition.path);
-    mkdirSync(packageDir, { recursive: true });
-    // Generate meta.json
-    const meta = {
-        hash,
-        serverVersion: definition.serverInfo?.version || definition.version || "1.0.0",
-        npmPackage: definition.serverSource,
-        toolCount: definition.tools.length,
-        sizeBytes: Buffer.byteLength(agentContent, "utf-8"),
-        generatedAt: definition.generatedAt || new Date().toISOString(),
-        sdkVersion: definition.sdkVersion || "0.21.0",
-    };
-    // Diff against previous if provided
-    if (options.previousAgentFile) {
-        const prevPath = resolve(options.previousAgentFile);
-        if (existsSync(prevPath)) {
-            const prevContent = readFileSync(prevPath, "utf-8");
-            const prevDef = parseJsonc(prevContent);
-            meta.changes = diffDefinitions(definition, prevDef, prevContent);
-        }
-    }
-    // Write agent.json
-    writeFileSync(resolve(packageDir, "agent.json"), agentContent);
-    // Write meta.json
-    writeFileSync(resolve(packageDir, "meta.json"), `${JSON.stringify(meta, null, 2)}\n`);
-    // Write package.json
-    const pkg = {
-        name: packageName,
-        version,
-        description: definition.description || `Agent definition for ${definition.name}`,
-        type: "module",
-        main: "index.js",
-        types: "index.d.ts",
-        exports: {
-            ".": {
-                import: "./index.js",
-                types: "./index.d.ts",
-            },
-            "./agent.json": "./agent.json",
-            "./meta.json": "./meta.json",
-        },
-        files: ["index.js", "index.d.ts", "agent.json", "meta.json"],
-        peerDependencies: {
-            "@slashfi/agents-sdk": ">=0.21.0",
-        },
-        keywords: ["agent", "mcp", "agentdef", definition.path],
-        license: "MIT",
-        repository: {
-            type: "git",
-            url: "https://github.com/slashfi/agents-sdk",
-        },
-    };
-    writeFileSync(resolve(packageDir, "package.json"), `${JSON.stringify(pkg, null, 2)}\n`);
-    // Write index.js
-    writeFileSync(resolve(packageDir, "index.js"), [
-        'import { readFileSync } from "node:fs";',
-        'import { fileURLToPath } from "node:url";',
-        'import { dirname, resolve } from "node:path";',
-        "",
-        "const __dirname = dirname(fileURLToPath(import.meta.url));",
-        'const definition = JSON.parse(readFileSync(resolve(__dirname, "agent.json"), "utf-8"));',
-        "export default definition;",
-        "export { definition };",
-        "",
-    ].join("\n"));
-    // Write index.d.ts
-    writeFileSync(resolve(packageDir, "index.d.ts"), [
-        'import type { SerializedAgentDefinition } from "@slashfi/agents-sdk";',
-        "",
-        "declare const definition: SerializedAgentDefinition;",
-        "export default definition;",
-        "export { definition };",
-        "",
-    ].join("\n"));
-    return { packageDir, packageName, version, hash, meta };
-}
-/**
- * Compare semver: returns true if `a` is older than `b`.
- */
-function isOlderVersion(a, b) {
-    const pa = a.split(".").map(Number);
-    const pb = b.split(".").map(Number);
-    for (let i = 0; i < 3; i++) {
-        if ((pa[i] || 0) < (pb[i] || 0))
-            return true;
-        if ((pa[i] || 0) > (pb[i] || 0))
-            return false;
-    }
-    return false; // equal
-}
-export function publish(options) {
-    const result = pack(options);
-    // Check if this version already exists in the registry
-    const registryArgs = options.registry ? ["--registry", options.registry] : [];
-    const viewProc = spawnSync("npm", ["view", `${result.packageName}`, "versions", "--json", ...registryArgs], { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
-    if (viewProc.status === 0 && viewProc.stdout) {
-        try {
-            const raw = JSON.parse(viewProc.stdout);
-            const existing = Array.isArray(raw) ? raw : [raw];
-            // E409 prevention: version already exists
-            if (existing.includes(result.version)) {
-                const versions = existing.join(", ");
-                throw new Error(`\x1b[31m\u2717 ${result.packageName}@${result.version} already exists in registry\x1b[0m\n\n  Published versions: ${versions}\n  Hint: bump the version in agent.json, or use --tag to publish a pre-release`);
-            }
-            // Out-of-order protection: warn if publishing older than latest
-            const latestViewProc = spawnSync("npm", ["view", `${result.packageName}`, "dist-tags.latest", ...registryArgs], { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
-            if (latestViewProc.status === 0 && latestViewProc.stdout) {
-                const latest = latestViewProc.stdout.trim();
-                if (latest && !options.tag && isOlderVersion(result.version, latest)) {
-                    console.warn(`\x1b[33m\u26A0 Warning: publishing ${result.version} which is older than latest (${latest})\x1b[0m`);
-                    console.warn(`  This will move the "latest" tag from ${latest} to ${result.version}.`);
-                    console.warn("  Use --tag <name> to publish without affecting latest.");
-                    throw new Error(`Refusing to clobber latest tag. Use --tag <name> to publish ${result.version} alongside ${latest}.`);
-                }
-            }
-        }
-        catch (e) {
-            if (e instanceof Error && e.message.includes("already exists"))
-                throw e;
-            if (e instanceof Error && e.message.includes("Refusing to clobber"))
-                throw e;
-            // JSON parse error or other issue — continue with publish
-        }
-    }
-    const npmArgs = ["publish", result.packageDir];
-    npmArgs.push("--access", options.access || "public");
-    if (options.tag)
-        npmArgs.push("--tag", options.tag);
-    if (options.dryRun)
-        npmArgs.push("--dry-run");
-    if (options.registry)
-        npmArgs.push("--registry", options.registry);
-    console.log(`Publishing ${result.packageName}@${result.version} (hash: ${result.hash})`);
-    const proc = spawnSync("npm", npmArgs, {
-        stdio: ["pipe", "pipe", "pipe"],
-        encoding: "utf-8",
-    });
-    if (proc.status !== 0) {
-        const stderr = proc.stderr || "";
-        // Extract npm log path for debug hint
-        const logMatch = stderr.match(/complete log[^:]*:\s*(.+\.log)/i);
-        const logHint = logMatch
-            ? `\n  Debug: cat ${logMatch[1].trim()} | tail -40`
-            : "";
-        // Parse npm error for better messages
-        if (stderr.includes("E409") || stderr.includes("already present")) {
-            throw new Error(`\x1b[31m\u2717 ${result.packageName}@${result.version} already exists in registry\x1b[0m\n\n` +
-                `  Hint: bump the version in agent.json, or use --tag to publish a pre-release${logHint}`);
-        }
-        if (stderr.includes("E401") || stderr.includes("authentication")) {
-            throw new Error(`\x1b[31m\u2717 Authentication failed\x1b[0m\n\n  Run: npm login --scope=@agentdef\n  Or set NPM_TOKEN in your environment${logHint}`);
-        }
-        if (stderr.includes("E403") || stderr.includes("Forbidden")) {
-            throw new Error(`\x1b[31m\u2717 Permission denied publishing ${result.packageName}\x1b[0m\n\n  Make sure you have publish access to the @agentdef scope.\n  Run: npm access ls-packages @agentdef${logHint}`);
-        }
-        // Fallback: show raw error
-        throw new Error(`npm publish failed (exit ${proc.status}):${logHint}\n${stderr}`);
-    }
-    return result;
-}
-//# sourceMappingURL=pack.js.map

package/dist/pack.js.map

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

package/src/client.ts

@@ -1,273 +0,0 @@
-/**
- * Agent Client
- *
- * Creates a typed client from a SerializedAgentDefinition.
- * The client spawns (or connects to) the MCP server and proxies
- * tool calls via JSON-RPC.
- *
- * @example
- * ```typescript
- * import { createClient } from '@slashfi/agents-sdk';
- * import definition from './agents/notion/definition.json';
- *
- * const client = createClient(definition, {
- *   env: { NOTION_TOKEN: process.env.NOTION_TOKEN },
- * });
- *
- * const result = await client.call('API-post-search', { query: 'meeting notes' });
- * await client.close();
- * ```
- */
-
-import { type ChildProcess, spawn } from "node:child_process";
-import type {
-  SerializedAgentDefinition,
-  SerializedTool,
-} from "./serialized.js";
-
-// ============================================
-// Client Options
-// ============================================
-
-export interface CreateClientOptions {
-  /** Extra environment variables for the MCP server process */
-  env?: Record<string, string | undefined>;
-  /** Override the server command (defaults to definition.serverSource) */
-  serverCommand?: string;
-  /** Timeout for tool calls in ms (default: 30000) */
-  timeout?: number;
-}
-
-// ============================================
-// Agent Client
-// ============================================
-
-export interface AgentClient {
-  /** The definition this client was created from */
-  readonly definition: SerializedAgentDefinition;
-
-  /** List available tools */
-  tools(): SerializedTool[];
-
-  /** Call a tool by name */
-  call(toolName: string, input?: Record<string, unknown>): Promise<unknown>;
-
-  /** Check if connected */
-  isConnected(): boolean;
-
-  /** Close the MCP server connection */
-  close(): void;
-}
-
-// ============================================
-// MCP Stdio Transport
-// ============================================
-
-interface PendingRequest {
-  resolve: (value: unknown) => void;
-  reject: (error: Error) => void;
-  timer: ReturnType<typeof setTimeout>;
-}
-
-class McpStdioClient implements AgentClient {
-  readonly definition: SerializedAgentDefinition;
-  private proc: ChildProcess | null = null;
-  private messageId = 0;
-  private buffer = "";
-  private pending = new Map<number, PendingRequest>();
-  private initialized = false;
-  private initPromise: Promise<void> | null = null;
-  private serverCommand: string;
-  private env: Record<string, string | undefined>;
-  private timeout: number;
-
-  constructor(
-    definition: SerializedAgentDefinition,
-    options: CreateClientOptions = {},
-  ) {
-    this.definition = definition;
-    this.serverCommand = options.serverCommand ?? definition.serverSource ?? "";
-    this.env = options.env ?? {};
-    this.timeout = options.timeout ?? 30000;
-
-    if (!this.serverCommand) {
-      throw new Error(
-        `No server command for agent "${definition.path}". Set serverSource in the definition or pass serverCommand in options.`,
-      );
-    }
-  }
-
-  tools(): SerializedTool[] {
-    return this.definition.tools;
-  }
-
-  isConnected(): boolean {
-    return this.proc !== null && !this.proc.killed;
-  }
-
-  async call(
-    toolName: string,
-    input: Record<string, unknown> = {},
-  ): Promise<unknown> {
-    // Validate tool exists
-    const tool = this.definition.tools.find((t) => t.name === toolName);
-    if (!tool) {
-      const available = this.definition.tools.map((t) => t.name).join(", ");
-      throw new Error(`Tool "${toolName}" not found. Available: ${available}`);
-    }
-
-    // Ensure connected + initialized
-    await this.ensureInitialized();
-
-    // Send tools/call
-    const result = await this.sendRequest("tools/call", {
-      name: toolName,
-      arguments: input,
-    });
-
-    // MCP tools/call returns { content: [{ type, text }] }
-    const resultObj = result as Record<string, unknown> | null;
-    if (resultObj && typeof resultObj === "object" && "content" in resultObj) {
-      const content = resultObj.content;
-      if (Array.isArray(content) && content.length > 0) {
-        const first = content[0];
-        if (first.type === "text") {
-          try {
-            return JSON.parse(first.text);
-          } catch {
-            return first.text;
-          }
-        }
-        return first;
-      }
-    }
-    return result;
-  }
-
-  close(): void {
-    if (this.proc) {
-      this.proc.kill();
-      this.proc = null;
-    }
-    this.initialized = false;
-    this.initPromise = null;
-    // Reject all pending
-    for (const req of Array.from(this.pending.values())) {
-      clearTimeout(req.timer);
-      req.reject(new Error("Client closed"));
-    }
-    this.pending.clear();
-  }
-
-  // ── Private ──
-
-  private async ensureInitialized(): Promise<void> {
-    if (this.initialized) return;
-    if (this.initPromise) return this.initPromise;
-
-    this.initPromise = this.connect();
-    await this.initPromise;
-    this.initialized = true;
-  }
-
-  private async connect(): Promise<void> {
-    const parts = this.serverCommand.split(/\s+/);
-    this.proc = spawn(parts[0], parts.slice(1), {
-      stdio: ["pipe", "pipe", "pipe"],
-      env: { ...process.env, ...this.env },
-    });
-
-    this.proc.stdout?.on("data", (chunk: Buffer) => this.onData(chunk));
-    this.proc.on("error", (err) => {
-      for (const req of Array.from(this.pending.values())) {
-        clearTimeout(req.timer);
-        req.reject(err);
-      }
-      this.pending.clear();
-    });
-
-    // Initialize handshake
-    await this.sendRequest("initialize", {
-      protocolVersion: "2024-11-05",
-      capabilities: {},
-      clientInfo: { name: "agents-sdk-client", version: "1.0.0" },
-    });
-
-    // Send initialized notification
-    this.sendNotification("notifications/initialized");
-  }
-
-  private sendRequest(
-    method: string,
-    params: Record<string, unknown> = {},
-  ): Promise<unknown> {
-    return new Promise((resolve, reject) => {
-      const id = ++this.messageId;
-      const timer = setTimeout(() => {
-        this.pending.delete(id);
-        reject(new Error(`Timeout after ${this.timeout}ms calling ${method}`));
-      }, this.timeout);
-
-      this.pending.set(id, { resolve, reject, timer });
-
-      const msg = JSON.stringify({ jsonrpc: "2.0", id, method, params });
-      this.proc?.stdin?.write(`${msg}\n`);
-    });
-  }
-
-  private sendNotification(
-    method: string,
-    params?: Record<string, unknown>,
-  ): void {
-    const msg = JSON.stringify({
-      jsonrpc: "2.0",
-      method,
-      ...(params ? { params } : {}),
-    });
-    this.proc?.stdin?.write(`${msg}\n`);
-  }
-
-  private onData(chunk: Buffer): void {
-    this.buffer += chunk.toString();
-    const lines = this.buffer.split("\n");
-    this.buffer = lines.pop() || "";
-
-    for (const line of lines) {
-      const trimmed = line.trim();
-      if (!trimmed) continue;
-      try {
-        const parsed = JSON.parse(trimmed);
-        if (parsed.id != null && this.pending.has(parsed.id)) {
-          const req = this.pending.get(parsed.id);
-          if (!req) continue;
-          this.pending.delete(parsed.id);
-          clearTimeout(req.timer);
-          if (parsed.error) {
-            req.reject(new Error(JSON.stringify(parsed.error)));
-          } else {
-            req.resolve(parsed.result);
-          }
-        }
-      } catch {
-        // ignore non-JSON lines (stderr leakage, etc.)
-      }
-    }
-  }
-}
-
-// ============================================
-// Factory
-// ============================================
-
-/**
- * Create an agent client from a serialized definition.
- *
- * The client lazily spawns the MCP server on first call and
- * proxies tool invocations via JSON-RPC over stdio.
- */
-export function createClient(
-  definition: SerializedAgentDefinition,
-  options?: CreateClientOptions,
-): AgentClient {
-  return new McpStdioClient(definition, options);
-}