@slashfi/agents-sdk 0.26.2 → 0.27.1

package/dist/agent-definitions/config.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Config Agent (@config)
+ *
+ * Built-in agent for managing consumer configuration — refs and registries.
+ * Replaces @integrations and the LLM-facing parts of @auth.
+ *
+ * Provides:
+ * - add_ref / remove_ref / list_refs for managing agent refs
+ * - add_registry for registering new registries
+ * - FsStore interface for pluggable filesystem storage (VCS-backed or local)
+ *
+ * @example
+ * ```typescript
+ * import { createAgentRegistry, createConfigAgent } from '@slashfi/agents-sdk';
+ *
+ * const registry = createAgentRegistry();
+ * registry.register(createConfigAgent({
+ *   store: myFsStore,
+ * }));
+ * ```
+ */
+import type { AgentDefinition } from "../types.js";
+/**
+ * Filesystem store for reading/writing consumer configs.
+ * The storage engine (VCS, local fs, etc.) is abstracted away.
+ */
+export interface FsStore {
+    /** Read a file as UTF-8 string. Returns null if not found. */
+    readFile(path: string): Promise<string | null>;
+    /** Write a file with UTF-8 content. Creates parent dirs if needed. */
+    writeFile(path: string, content: string): Promise<void>;
+}
+export interface ConfigAgentOptions {
+    /** Filesystem store for persisting consumer config */
+    store: FsStore;
+    /**
+     * Resolve the FsStore for a specific user.
+     * When provided, refs are stored per-user.
+     * The callerId from ToolContext is passed.
+     */
+    resolveUserStore?: (callerId: string) => FsStore;
+}
+export declare function createConfigAgent(options: ConfigAgentOptions): AgentDefinition;
+//# sourceMappingURL=config.d.ts.map

package/dist/agent-definitions/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/agent-definitions/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,aAAa,CAAC;AAMhE;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/C,sEAAsE;IACtE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AA6BD,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,KAAK,EAAE,OAAO,CAAC;IAEf;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;CAClD;AAMD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,eAAe,CAsOjB"}

package/dist/agent-definitions/config.js

@@ -0,0 +1,234 @@
+/**
+ * Config Agent (@config)
+ *
+ * Built-in agent for managing consumer configuration — refs and registries.
+ * Replaces @integrations and the LLM-facing parts of @auth.
+ *
+ * Provides:
+ * - add_ref / remove_ref / list_refs for managing agent refs
+ * - add_registry for registering new registries
+ * - FsStore interface for pluggable filesystem storage (VCS-backed or local)
+ *
+ * @example
+ * ```typescript
+ * import { createAgentRegistry, createConfigAgent } from '@slashfi/agents-sdk';
+ *
+ * const registry = createAgentRegistry();
+ * registry.register(createConfigAgent({
+ *   store: myFsStore,
+ * }));
+ * ```
+ */
+import { normalizeRef } from "../define-config.js";
+import { defineAgent, defineTool } from "../define.js";
+// ============================================
+// Config Persistence
+// ============================================
+const CONFIG_PATH = "consumer-config.json";
+async function readConfig(store) {
+    const content = await store.readFile(CONFIG_PATH);
+    if (!content)
+        return {};
+    try {
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+async function writeConfig(store, config) {
+    await store.writeFile(CONFIG_PATH, JSON.stringify(config, null, 2));
+}
+// ============================================
+// Create Config Agent
+// ============================================
+export function createConfigAgent(options) {
+    const { store, resolveUserStore } = options;
+    function getStore(ctx) {
+        if (resolveUserStore && ctx.callerId) {
+            return resolveUserStore(ctx.callerId);
+        }
+        return store;
+    }
+    // ---- add_ref ----
+    const addRefTool = defineTool({
+        name: "add_ref",
+        description: "Add or update an agent ref in the consumer config. " +
+            "The ref is persisted to the config store.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ref: {
+                    type: "string",
+                    description: 'Agent ref name (e.g. "notion", "linear")',
+                },
+                as: {
+                    type: "string",
+                    description: "Local alias (for multi-instance refs)",
+                },
+                url: {
+                    type: "string",
+                    description: "Direct URL to the agent",
+                },
+                config: {
+                    type: "object",
+                    additionalProperties: { type: "string" },
+                    description: "Per-instance config (secret URIs or literal values)",
+                },
+                registry: {
+                    type: "string",
+                    description: 'Registry to resolve from (e.g. "slash", "mcp", "https")',
+                },
+            },
+            required: ["ref"],
+        },
+        execute: async (input, ctx) => {
+            const fs = getStore(ctx);
+            const currentConfig = await readConfig(fs);
+            const entry = {
+                ref: input.ref,
+                ...(input.as && { as: input.as }),
+                ...(input.url && { url: input.url }),
+                ...(input.config && { config: input.config }),
+                ...(input.registry && { registry: input.registry }),
+            };
+            // Upsert: find existing ref by name/alias, replace or append
+            const name = input.as ?? input.ref;
+            const refs = currentConfig.refs ?? [];
+            const existingIdx = refs.findIndex((r) => {
+                const normalized = normalizeRef(r);
+                return normalized.name === name;
+            });
+            if (existingIdx >= 0) {
+                refs[existingIdx] = entry;
+            }
+            else {
+                refs.push(entry);
+            }
+            currentConfig.refs = refs;
+            await writeConfig(fs, currentConfig);
+            return {
+                added: true,
+                ref: input.ref,
+                name,
+            };
+        },
+    });
+    // ---- remove_ref ----
+    const removeRefTool = defineTool({
+        name: "remove_ref",
+        description: "Remove an agent ref from the consumer config by name or alias.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Ref name or alias to remove",
+                },
+            },
+            required: ["name"],
+        },
+        execute: async (input, ctx) => {
+            const fs = getStore(ctx);
+            const currentConfig = await readConfig(fs);
+            const refs = currentConfig.refs ?? [];
+            const before = refs.length;
+            currentConfig.refs = refs.filter((r) => {
+                const normalized = normalizeRef(r);
+                return normalized.name !== input.name;
+            });
+            if (currentConfig.refs.length === before) {
+                return { removed: false, error: `Ref "${input.name}" not found` };
+            }
+            await writeConfig(fs, currentConfig);
+            return { removed: true, name: input.name };
+        },
+    });
+    // ---- list_refs ----
+    const listRefsTool = defineTool({
+        name: "list_refs",
+        description: "List all agent refs in the consumer config. " +
+            "Returns normalized refs with their names and config.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+        execute: async (_input, ctx) => {
+            const fs = getStore(ctx);
+            const currentConfig = await readConfig(fs);
+            const refs = (currentConfig.refs ?? []).map(normalizeRef);
+            return { refs };
+        },
+    });
+    // ---- add_registry ----
+    const addRegistryTool = defineTool({
+        name: "add_registry",
+        description: "Add or update a registry in the consumer config. " +
+            "Registries are where refs resolve from.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: 'Human-readable name (e.g. "slash", "internal")',
+                },
+                url: {
+                    type: "string",
+                    description: "Registry URL",
+                },
+                auth: {
+                    type: "object",
+                    description: "Auth config for the registry",
+                    properties: {
+                        type: {
+                            type: "string",
+                            enum: ["none", "bearer", "api-key", "jwt"],
+                        },
+                    },
+                },
+            },
+            required: ["url"],
+        },
+        execute: async (input, ctx) => {
+            const fs = getStore(ctx);
+            const currentConfig = await readConfig(fs);
+            const registries = currentConfig.registries ?? [];
+            const entry = {
+                url: input.url,
+                ...(input.name && { name: input.name }),
+                ...(input.auth && { auth: input.auth }),
+            };
+            // Upsert by URL
+            const existingIdx = registries.findIndex((r) => {
+                const url = typeof r === "string" ? r : r.url;
+                return url === input.url;
+            });
+            if (existingIdx >= 0) {
+                registries[existingIdx] = entry;
+            }
+            else {
+                registries.push(entry);
+            }
+            currentConfig.registries = registries;
+            await writeConfig(fs, currentConfig);
+            return {
+                added: true,
+                url: input.url,
+                name: input.name ?? new URL(input.url).hostname,
+            };
+        },
+    });
+    // ---- Define the agent ----
+    return defineAgent({
+        path: "@config",
+        entrypoint: "Consumer config management. Use add_ref/remove_ref/list_refs to manage agent refs, " +
+            "and add_registry to configure registries.",
+        config: {
+            name: "Config",
+            description: "Manage consumer config — add/remove/list agent refs and registries. " +
+                "Replaces @integrations for connecting to third-party services.",
+        },
+        tools: [addRefTool, removeRefTool, listRefsTool, addRegistryTool],
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/agent-definitions/config.js.map

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

package/dist/cjs/agent-definitions/config.js

@@ -0,0 +1,237 @@
+"use strict";
+/**
+ * Config Agent (@config)
+ *
+ * Built-in agent for managing consumer configuration — refs and registries.
+ * Replaces @integrations and the LLM-facing parts of @auth.
+ *
+ * Provides:
+ * - add_ref / remove_ref / list_refs for managing agent refs
+ * - add_registry for registering new registries
+ * - FsStore interface for pluggable filesystem storage (VCS-backed or local)
+ *
+ * @example
+ * ```typescript
+ * import { createAgentRegistry, createConfigAgent } from '@slashfi/agents-sdk';
+ *
+ * const registry = createAgentRegistry();
+ * registry.register(createConfigAgent({
+ *   store: myFsStore,
+ * }));
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConfigAgent = createConfigAgent;
+const define_config_js_1 = require("../define-config.js");
+const define_js_1 = require("../define.js");
+// ============================================
+// Config Persistence
+// ============================================
+const CONFIG_PATH = "consumer-config.json";
+async function readConfig(store) {
+    const content = await store.readFile(CONFIG_PATH);
+    if (!content)
+        return {};
+    try {
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+async function writeConfig(store, config) {
+    await store.writeFile(CONFIG_PATH, JSON.stringify(config, null, 2));
+}
+// ============================================
+// Create Config Agent
+// ============================================
+function createConfigAgent(options) {
+    const { store, resolveUserStore } = options;
+    function getStore(ctx) {
+        if (resolveUserStore && ctx.callerId) {
+            return resolveUserStore(ctx.callerId);
+        }
+        return store;
+    }
+    // ---- add_ref ----
+    const addRefTool = (0, define_js_1.defineTool)({
+        name: "add_ref",
+        description: "Add or update an agent ref in the consumer config. " +
+            "The ref is persisted to the config store.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ref: {
+                    type: "string",
+                    description: 'Agent ref name (e.g. "notion", "linear")',
+                },
+                as: {
+                    type: "string",
+                    description: "Local alias (for multi-instance refs)",
+                },
+                url: {
+                    type: "string",
+                    description: "Direct URL to the agent",
+                },
+                config: {
+                    type: "object",
+                    additionalProperties: { type: "string" },
+                    description: "Per-instance config (secret URIs or literal values)",
+                },
+                registry: {
+                    type: "string",
+                    description: 'Registry to resolve from (e.g. "slash", "mcp", "https")',
+                },
+            },
+            required: ["ref"],
+        },
+        execute: async (input, ctx) => {
+            const fs = getStore(ctx);
+            const currentConfig = await readConfig(fs);
+            const entry = {
+                ref: input.ref,
+                ...(input.as && { as: input.as }),
+                ...(input.url && { url: input.url }),
+                ...(input.config && { config: input.config }),
+                ...(input.registry && { registry: input.registry }),
+            };
+            // Upsert: find existing ref by name/alias, replace or append
+            const name = input.as ?? input.ref;
+            const refs = currentConfig.refs ?? [];
+            const existingIdx = refs.findIndex((r) => {
+                const normalized = (0, define_config_js_1.normalizeRef)(r);
+                return normalized.name === name;
+            });
+            if (existingIdx >= 0) {
+                refs[existingIdx] = entry;
+            }
+            else {
+                refs.push(entry);
+            }
+            currentConfig.refs = refs;
+            await writeConfig(fs, currentConfig);
+            return {
+                added: true,
+                ref: input.ref,
+                name,
+            };
+        },
+    });
+    // ---- remove_ref ----
+    const removeRefTool = (0, define_js_1.defineTool)({
+        name: "remove_ref",
+        description: "Remove an agent ref from the consumer config by name or alias.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Ref name or alias to remove",
+                },
+            },
+            required: ["name"],
+        },
+        execute: async (input, ctx) => {
+            const fs = getStore(ctx);
+            const currentConfig = await readConfig(fs);
+            const refs = currentConfig.refs ?? [];
+            const before = refs.length;
+            currentConfig.refs = refs.filter((r) => {
+                const normalized = (0, define_config_js_1.normalizeRef)(r);
+                return normalized.name !== input.name;
+            });
+            if (currentConfig.refs.length === before) {
+                return { removed: false, error: `Ref "${input.name}" not found` };
+            }
+            await writeConfig(fs, currentConfig);
+            return { removed: true, name: input.name };
+        },
+    });
+    // ---- list_refs ----
+    const listRefsTool = (0, define_js_1.defineTool)({
+        name: "list_refs",
+        description: "List all agent refs in the consumer config. " +
+            "Returns normalized refs with their names and config.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+        execute: async (_input, ctx) => {
+            const fs = getStore(ctx);
+            const currentConfig = await readConfig(fs);
+            const refs = (currentConfig.refs ?? []).map(define_config_js_1.normalizeRef);
+            return { refs };
+        },
+    });
+    // ---- add_registry ----
+    const addRegistryTool = (0, define_js_1.defineTool)({
+        name: "add_registry",
+        description: "Add or update a registry in the consumer config. " +
+            "Registries are where refs resolve from.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: 'Human-readable name (e.g. "slash", "internal")',
+                },
+                url: {
+                    type: "string",
+                    description: "Registry URL",
+                },
+                auth: {
+                    type: "object",
+                    description: "Auth config for the registry",
+                    properties: {
+                        type: {
+                            type: "string",
+                            enum: ["none", "bearer", "api-key", "jwt"],
+                        },
+                    },
+                },
+            },
+            required: ["url"],
+        },
+        execute: async (input, ctx) => {
+            const fs = getStore(ctx);
+            const currentConfig = await readConfig(fs);
+            const registries = currentConfig.registries ?? [];
+            const entry = {
+                url: input.url,
+                ...(input.name && { name: input.name }),
+                ...(input.auth && { auth: input.auth }),
+            };
+            // Upsert by URL
+            const existingIdx = registries.findIndex((r) => {
+                const url = typeof r === "string" ? r : r.url;
+                return url === input.url;
+            });
+            if (existingIdx >= 0) {
+                registries[existingIdx] = entry;
+            }
+            else {
+                registries.push(entry);
+            }
+            currentConfig.registries = registries;
+            await writeConfig(fs, currentConfig);
+            return {
+                added: true,
+                url: input.url,
+                name: input.name ?? new URL(input.url).hostname,
+            };
+        },
+    });
+    // ---- Define the agent ----
+    return (0, define_js_1.defineAgent)({
+        path: "@config",
+        entrypoint: "Consumer config management. Use add_ref/remove_ref/list_refs to manage agent refs, " +
+            "and add_registry to configure registries.",
+        config: {
+            name: "Config",
+            description: "Manage consumer config — add/remove/list agent refs and registries. " +
+                "Replaces @integrations for connecting to third-party services.",
+        },
+        tools: [addRefTool, removeRefTool, listRefsTool, addRegistryTool],
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/cjs/agent-definitions/config.js.map

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

package/dist/cjs/codegen.js

@@ -41,6 +41,7 @@ exports.useAgent = useAgent;
 exports.listAgentTools = listAgentTools;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
+const mcp_client_js_1 = require("./mcp-client.js");
 // ============================================
 // Protocol Constants
 // ============================================
@@ -477,6 +478,22 @@ function createSseTransport(source) {
 // ============================================
 // Source Parsing
 // ============================================
+/**
+ * Extract the base URL from a server source (for OAuth discovery).
+ * Returns null for stdio/command-based sources.
+ */
+function resolveServerUrl(source) {
+    if (typeof source === "string") {
+        if (source.startsWith("http://") || source.startsWith("https://")) {
+            return source.replace(/\/sse$/, "");
+        }
+        return null;
+    }
+    if ("url" in source) {
+        return source.url.replace(/\/sse$/, "");
+    }
+    return null;
+}
 function parseServerSource(source) {
     if (typeof source === "string") {
         // URL -> HTTP or SSE transport
@@ -870,12 +887,32 @@ function generateCli(serverInfo, tools, agentPath) {
     lines.push("");
     return lines.join("\n");
 }
-function generateManifest(serverSource, serverInfo, tools, agentPath) {
+function generateManifest(serverSource, serverInfo, tools, agentPath, oauth) {
+    // Build connection spec from server source + OAuth discovery
+    const serverUrl = resolveServerUrl(serverSource);
+    const connection = serverUrl
+        ? {
+            url: serverUrl,
+            transport: (typeof serverSource === 'string' && serverSource.endsWith('/sse')) ||
+                (typeof serverSource === 'object' && 'url' in serverSource && serverSource.url.endsWith('/sse'))
+                ? 'sse'
+                : 'http',
+            auth: oauth
+                ? {
+                    type: 'oauth',
+                    discovery: `${serverUrl.replace(/\/mcp$/, '')}/.well-known/oauth-authorization-server`,
+                    dynamic_registration: !!oauth.registration_endpoint,
+                }
+                : { type: 'none' },
+        }
+        : undefined;
     const manifest = {
         agentPath,
         serverSource,
         serverInfo,
         tools: tools.map((t) => ({ name: t.name, description: t.description })),
+        ...(connection ? { connection } : {}),
+        ...(oauth ? { oauth } : {}),
         generatedAt: new Date().toISOString(),
     };
     return JSON.stringify(manifest, null, 2) + "\n";
@@ -930,6 +967,12 @@ async function codegen(options) {
     if (tools.length === 0) {
         throw new Error("MCP server returned no tools. Is the server running and configured correctly?");
     }
+    // 3.5. Discover OAuth metadata (for URL-based servers)
+    let oauth = null;
+    const serverUrl = resolveServerUrl(options.server);
+    if (serverUrl) {
+        oauth = await (0, mcp_client_js_1.discoverOAuthMetadata)(serverUrl);
+    }
     // 4. Derive agent path
     const agentPath = options.agentPath ??
         `@${(options.name ?? serverInfo.name ?? "mcp-agent").toLowerCase().replace(/[^a-z0-9-]/g, "-")}`;
@@ -964,7 +1007,7 @@ async function codegen(options) {
         files.push("cli.ts");
     }
     // 11. Generate manifest (for `agents-sdk use`)
-    const manifest = generateManifest(options.server, serverInfo, tools, agentPath);
+    const manifest = generateManifest(options.server, serverInfo, tools, agentPath, oauth);
     (0, node_fs_1.writeFileSync)((0, node_path_1.join)(outDir, ".codegen-manifest.json"), manifest);
     files.push(".codegen-manifest.json");
     return {
@@ -973,6 +1016,7 @@ async function codegen(options) {
         toolCount: tools.length,
         toolFiles,
         files,
+        ...(oauth ? { oauth } : {}),
     };
 }
 // ============================================