@slashfi/agents-sdk 0.50.6 → 0.60.0

package/dist/cjs/init.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * ADK Init — Setup + skill injection for coding agents.
+ *
+ * Uses a preset-based system for scalability:
+ * - Presets are JSON files in src/presets/ (one per coding agent)
+ * - All use the agentskills.io SKILL.md standard
+ * - Adding a new coding agent = adding one JSON file
+ *
+ * Non-interactive by design. The coding agent is the UX layer.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadPresets = loadPresets;
+exports.getPreset = getPreset;
+exports.listPresets = listPresets;
+exports.renderContent = renderContent;
+exports.parseTarget = parseTarget;
+exports.installSkill = installSkill;
+exports.runInit = runInit;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+// ============================================
+// Preset Loading
+// ============================================
+// Presets are inlined to avoid import.meta/CJS compatibility issues.
+// To add a new coding agent, add an entry here and a JSON file in src/presets/.
+const BUILTIN_PRESETS = [
+    { name: "claude", defaultPath: "~/.claude/skills", filename: "adk/SKILL.md" },
+    { name: "cursor", defaultPath: ".agents/skills", filename: "adk/SKILL.md" },
+    { name: "codex", defaultPath: ".agents/skills", filename: "adk/SKILL.md" },
+    { name: "copilot", defaultPath: ".github/skills", filename: "adk/SKILL.md" },
+    { name: "windsurf", defaultPath: ".windsurf/skills", filename: "adk/SKILL.md" },
+    { name: "hermes", defaultPath: "~/.hermes/skills", filename: "adk/SKILL.md" },
+];
+let _presets = null;
+function loadPresets() {
+    if (_presets)
+        return _presets;
+    _presets = new Map();
+    for (const preset of BUILTIN_PRESETS) {
+        _presets.set(preset.name, preset);
+    }
+    return _presets;
+}
+function getPreset(name) {
+    return loadPresets().get(name);
+}
+function listPresets() {
+    return Array.from(loadPresets().values());
+}
+// ============================================
+// Skill Content Templates
+// ============================================
+const ADK_SKILL_CONTENT = `adk is the Agent Development Kit CLI.
+
+Config location: run \`adk config-path\` to find the config directory.
+Installed refs: run \`adk ref list\` to see configured agents.
+
+Each installed ref has local docs at the config path under refs/<name>/:
+  - tools/*.tool.json — full tool schemas (inputSchema, description)
+  - skills/ — usage guides and patterns from the agent
+  - types/*.d.ts — TypeScript type definitions
+
+## Commands
+
+To call a tool: \`adk ref call <name> <tool> '{"param": "value"}'\`
+To browse available agents: \`adk registry browse slash\`
+To install an agent: \`adk ref add <name>\`
+To authenticate: \`adk ref auth <name>\`
+To check auth status: \`adk ref auth-status <name>\`
+To inspect an agent: \`adk ref inspect <name>\`
+To view tool schemas: \`adk ref inspect <name> --full\`
+To list resources: \`adk ref resources <name>\`
+To read a resource: \`adk ref read <name> <uri>\`
+`;
+function renderContent(content, meta) {
+    return `---
+name: ${meta.name}
+description: ${meta.description}
+---
+${content}`;
+}
+// ============================================
+// Target Parsing
+// ============================================
+function expandHome(p) {
+    if (p.startsWith("~/"))
+        return (0, node_path_1.join)((0, node_os_1.homedir)(), p.slice(2));
+    return p;
+}
+function parseTarget(value) {
+    const colonIdx = value.indexOf(":");
+    if (colonIdx === -1) {
+        // Just a preset name
+        const preset = getPreset(value);
+        if (!preset) {
+            const presetNames = Array.from(loadPresets().keys()).join(", ");
+            throw new Error(`Unknown preset: ${value}. Available: ${presetNames}`);
+        }
+        return { preset, path: expandHome(preset.defaultPath) };
+    }
+    const key = value.slice(0, colonIdx);
+    const path = value.slice(colonIdx + 1);
+    // Check if key is a preset name (with custom path)
+    const preset = getPreset(key);
+    if (preset) {
+        return { preset, path: expandHome(path || preset.defaultPath) };
+    }
+    const presetNames = Array.from(loadPresets().keys()).join(", ");
+    throw new Error(`Unknown target: ${key}. Available presets: ${presetNames}`);
+}
+// ============================================
+// Skill Installation
+// ============================================
+function ensureWrite(path, content) {
+    const dir = (0, node_path_1.dirname)(path);
+    if (!(0, node_fs_1.existsSync)(dir)) {
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    }
+    (0, node_fs_1.writeFileSync)(path, content, "utf-8");
+}
+function installSkill(target) {
+    const outputPath = (0, node_path_1.join)((0, node_path_1.resolve)(target.path), target.preset.filename);
+    const content = renderContent(ADK_SKILL_CONTENT, {
+        name: "adk",
+        description: "When connecting to APIs, calling remote tools, managing integrations, or the user asks about adk",
+    });
+    ensureWrite(outputPath, content);
+    return outputPath;
+}
+// ============================================
+// Init Command
+// ============================================
+const DEFAULT_REGISTRY_URL = "https://registry.slash.com";
+const DEFAULT_REGISTRY_NAME = "public";
+async function runInit(adk, targets) {
+    // 1. Ensure default registry
+    const registries = await adk.registry.list();
+    const hasDefault = registries.some((r) => r.url === DEFAULT_REGISTRY_URL || r.name === DEFAULT_REGISTRY_NAME);
+    if (!hasDefault) {
+        await adk.registry.add({ url: DEFAULT_REGISTRY_URL, name: DEFAULT_REGISTRY_NAME });
+        console.log(`\x1b[32m\u2713\x1b[0m Set default registry: ${DEFAULT_REGISTRY_URL}`);
+    }
+    else {
+        console.log(`\x1b[32m\u2713\x1b[0m Default registry already configured: ${DEFAULT_REGISTRY_URL}`);
+    }
+    // 2. Install skills to targets
+    if (targets.length === 0) {
+        console.log(`\nTo install skills, re-run with targets:\n`);
+        const presets = listPresets();
+        for (const preset of presets) {
+            console.log(`  adk init --target ${preset.name}`);
+        }
+        console.log(`\nCustom path: adk init --target <preset>:<path>`);
+        console.log(`\nAsk the user which coding agents they use,`);
+        console.log(`then run: adk init --target <preset> [--target <preset> ...]`);
+        return;
+    }
+    for (const target of targets) {
+        const outputPath = installSkill(target);
+        console.log(`\x1b[32m\u2713\x1b[0m Installed adk skill \u2192 ${outputPath}`);
+    }
+    // 3. Save targets to config
+    const config = await adk.readConfig();
+    const targetStrings = targets.map((t) => {
+        return t.path === expandHome(t.preset.defaultPath) ? t.preset.name : `${t.preset.name}:${t.path}`;
+    });
+    config.targets = targetStrings;
+    await adk.writeConfig(config);
+    console.log(`\x1b[32m\u2713\x1b[0m Saved targets to config`);
+    console.log(`\nDone! Your coding agents now know how to use adk.`);
+    console.log(`Run \`adk init\` again anytime to refresh skills or add targets.`);
+}
+//# sourceMappingURL=init.js.map

package/dist/cjs/init.js.map

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

package/dist/cjs/materialize.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * Ref Materialization — Download agent docs to local filesystem.
+ *
+ * When `adk ref add` succeeds, materialize the agent's tool schemas,
+ * resources (skills), and generate TypeScript type definitions locally.
+ *
+ * Files are written under the adk config dir at refs/<name>/.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.materializeRef = materializeRef;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+// ============================================
+// Helpers
+// ============================================
+function ensureWrite(path, content) {
+    const dir = (0, node_path_1.dirname)(path);
+    if (!(0, node_fs_1.existsSync)(dir)) {
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    }
+    (0, node_fs_1.writeFileSync)(path, content, "utf-8");
+}
+/** Generate a .d.ts file from tool schemas. */
+function generateTypes(refName, tools) {
+    const lines = [
+        `// Auto-generated by adk ref add`,
+        `// Agent: ${refName}`,
+        `// Tools: ${tools.length}`,
+        ``,
+        `export interface ${pascalCase(refName)}Tools {`,
+    ];
+    for (const tool of tools) {
+        lines.push(`  /** ${tool.description ?? tool.name} */`);
+        lines.push(`  ${JSON.stringify(tool.name)}: {`);
+        lines.push(`    name: ${JSON.stringify(tool.name)};`);
+        if (tool.description) {
+            lines.push(`    description: ${JSON.stringify(tool.description)};`);
+        }
+        lines.push(`    params: Record<string, unknown>;`);
+        lines.push(`  };`);
+    }
+    lines.push(`}`);
+    lines.push(``);
+    lines.push(`export declare const tools: (keyof ${pascalCase(refName)}Tools)[];`);
+    lines.push(``);
+    return lines.join("\n");
+}
+function pascalCase(s) {
+    return s
+        .replace(/[^a-zA-Z0-9]+(.)/g, (_, c) => c.toUpperCase())
+        .replace(/^./, (c) => c.toUpperCase());
+}
+// ============================================
+// Materialize
+// ============================================
+async function materializeRef(adk, refName, configDir) {
+    const refDir = (0, node_path_1.join)(configDir, "refs", refName);
+    const toolsDir = (0, node_path_1.join)(refDir, "tools");
+    const skillsDir = (0, node_path_1.join)(refDir, "skills");
+    const typesDir = (0, node_path_1.join)(refDir, "types");
+    let toolCount = 0;
+    let skillCount = 0;
+    let typesGenerated = false;
+    // 1. Fetch and write tool schemas
+    try {
+        const info = await adk.ref.inspect(refName, { full: true });
+        if (info?.tools && info.tools.length > 0) {
+            const tools = info.tools.map((t) => ({
+                name: t.name,
+                description: t.description,
+                inputSchema: t.inputSchema,
+                outputSchema: t.outputSchema,
+            }));
+            for (const tool of tools) {
+                const safeName = tool.name.replace(/[^a-zA-Z0-9_-]/g, "_");
+                ensureWrite((0, node_path_1.join)(toolsDir, `${safeName}.tool.json`), JSON.stringify(tool, null, 2));
+            }
+            toolCount = tools.length;
+            // Write agent.json metadata
+            ensureWrite((0, node_path_1.join)(refDir, "agent.json"), JSON.stringify({
+                name: refName,
+                description: info.description,
+                toolCount: tools.length,
+                tools: tools.map((t) => t.name),
+                materializedAt: new Date().toISOString(),
+            }, null, 2));
+            // Generate .d.ts
+            ensureWrite((0, node_path_1.join)(typesDir, `${refName}.d.ts`), generateTypes(refName, tools));
+            typesGenerated = true;
+        }
+    }
+    catch {
+        // inspect failed — agent might not be reachable yet (needs auth)
+    }
+    // 2. Fetch and write resources (skills)
+    try {
+        const resourcesResult = await adk.ref.resources(refName);
+        const response = resourcesResult;
+        if (response?.result?.resources) {
+            for (const resource of response.result.resources) {
+                if (resource.uri && resource.text) {
+                    const filename = resource.uri.split("/").pop() ?? "resource.md";
+                    ensureWrite((0, node_path_1.join)(skillsDir, filename), resource.text);
+                    skillCount++;
+                }
+            }
+        }
+    }
+    catch {
+        // resources fetch failed — might not be supported
+    }
+    return { toolCount, skillCount, typesGenerated };
+}
+//# sourceMappingURL=materialize.js.map

package/dist/cjs/materialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize.js","sourceRoot":"","sources":["../../src/materialize.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AA0EH,wCA2EC;AAnJD,qCAA+D;AAC/D,yCAA0C;AAqB1C,+CAA+C;AAC/C,UAAU;AACV,+CAA+C;AAE/C,SAAS,WAAW,CAAC,IAAY,EAAE,OAAe;IAChD,MAAM,GAAG,GAAG,IAAA,mBAAO,EAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,IAAA,oBAAU,EAAC,GAAG,CAAC,EAAE,CAAC;QACrB,IAAA,mBAAS,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,IAAA,uBAAa,EAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,+CAA+C;AAC/C,SAAS,aAAa,CAAC,OAAe,EAAE,KAAmB;IACzD,MAAM,KAAK,GAAa;QACtB,kCAAkC;QAClC,aAAa,OAAO,EAAE;QACtB,aAAa,KAAK,CAAC,MAAM,EAAE;QAC3B,EAAE;QACF,oBAAoB,UAAU,CAAC,OAAO,CAAC,SAAS;KACjD,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACtE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,sCAAsC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACjF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC;SACL,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SACvD,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,+CAA+C;AAC/C,cAAc;AACd,+CAA+C;AAExC,KAAK,UAAU,cAAc,CAClC,GAAQ,EACR,OAAe,EACf,SAAiB;IAEjB,MAAM,MAAM,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,IAAA,gBAAI,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,cAAc,GAAG,KAAK,CAAC;IAE3B,kCAAkC;IAClC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,IAAI,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,KAAK,GAAiB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;gBACtD,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,YAAY,EAAE,CAAC,CAAC,YAAY;aAC7B,CAAC,CAAC,CAAC;YAEJ,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;gBAC3D,WAAW,CACT,IAAA,gBAAI,EAAC,QAAQ,EAAE,GAAG,QAAQ,YAAY,CAAC,EACvC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAC9B,CAAC;YACJ,CAAC;YACD,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;YAEzB,4BAA4B;YAC5B,WAAW,CACT,IAAA,gBAAI,EAAC,MAAM,EAAE,YAAY,CAAC,EAC1B,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,SAAS,EAAE,KAAK,CAAC,MAAM;gBACvB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;gBAC/B,cAAc,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACzC,EAAE,IAAI,EAAE,CAAC,CAAC,CACZ,CAAC;YAEF,iBAAiB;YACjB,WAAW,CACT,IAAA,gBAAI,EAAC,QAAQ,EAAE,GAAG,OAAO,OAAO,CAAC,EACjC,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAC9B,CAAC;YACF,cAAc,GAAG,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;IACnE,CAAC;IAED,wCAAwC;IACxC,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,eAAsB,CAAC;QACxC,IAAI,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YAChC,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACjD,IAAI,QAAQ,CAAC,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;oBAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,aAAa,CAAC;oBAChE,WAAW,CAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;oBACtD,UAAU,EAAE,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;IACpD,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;AACnD,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,31 @@
+/**
+ * ADK Init — Setup + skill injection for coding agents.
+ *
+ * Uses a preset-based system for scalability:
+ * - Presets are JSON files in src/presets/ (one per coding agent)
+ * - All use the agentskills.io SKILL.md standard
+ * - Adding a new coding agent = adding one JSON file
+ *
+ * Non-interactive by design. The coding agent is the UX layer.
+ */
+import type { Adk } from "./config-store.js";
+export interface Preset {
+    name: string;
+    defaultPath: string;
+    filename: string;
+}
+export interface SkillTarget {
+    preset: Preset;
+    path: string;
+}
+export declare function loadPresets(): Map<string, Preset>;
+export declare function getPreset(name: string): Preset | undefined;
+export declare function listPresets(): Preset[];
+export declare function renderContent(content: string, meta: {
+    name: string;
+    description: string;
+}): string;
+export declare function parseTarget(value: string): SkillTarget;
+export declare function installSkill(target: SkillTarget): string;
+export declare function runInit(adk: Adk, targets: SkillTarget[]): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAM7C,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAmBD,wBAAgB,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAOjD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1D;AAED,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AA6BD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC1C,MAAM,CAMR;AAWD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAwBtD;AAcD,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAQxD;AAUD,wBAAsB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C7E"}

package/dist/init.js

@@ -0,0 +1,166 @@
+/**
+ * ADK Init — Setup + skill injection for coding agents.
+ *
+ * Uses a preset-based system for scalability:
+ * - Presets are JSON files in src/presets/ (one per coding agent)
+ * - All use the agentskills.io SKILL.md standard
+ * - Adding a new coding agent = adding one JSON file
+ *
+ * Non-interactive by design. The coding agent is the UX layer.
+ */
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { homedir } from "node:os";
+// ============================================
+// Preset Loading
+// ============================================
+// Presets are inlined to avoid import.meta/CJS compatibility issues.
+// To add a new coding agent, add an entry here and a JSON file in src/presets/.
+const BUILTIN_PRESETS = [
+    { name: "claude", defaultPath: "~/.claude/skills", filename: "adk/SKILL.md" },
+    { name: "cursor", defaultPath: ".agents/skills", filename: "adk/SKILL.md" },
+    { name: "codex", defaultPath: ".agents/skills", filename: "adk/SKILL.md" },
+    { name: "copilot", defaultPath: ".github/skills", filename: "adk/SKILL.md" },
+    { name: "windsurf", defaultPath: ".windsurf/skills", filename: "adk/SKILL.md" },
+    { name: "hermes", defaultPath: "~/.hermes/skills", filename: "adk/SKILL.md" },
+];
+let _presets = null;
+export function loadPresets() {
+    if (_presets)
+        return _presets;
+    _presets = new Map();
+    for (const preset of BUILTIN_PRESETS) {
+        _presets.set(preset.name, preset);
+    }
+    return _presets;
+}
+export function getPreset(name) {
+    return loadPresets().get(name);
+}
+export function listPresets() {
+    return Array.from(loadPresets().values());
+}
+// ============================================
+// Skill Content Templates
+// ============================================
+const ADK_SKILL_CONTENT = `adk is the Agent Development Kit CLI.
+
+Config location: run \`adk config-path\` to find the config directory.
+Installed refs: run \`adk ref list\` to see configured agents.
+
+Each installed ref has local docs at the config path under refs/<name>/:
+  - tools/*.tool.json — full tool schemas (inputSchema, description)
+  - skills/ — usage guides and patterns from the agent
+  - types/*.d.ts — TypeScript type definitions
+
+## Commands
+
+To call a tool: \`adk ref call <name> <tool> '{"param": "value"}'\`
+To browse available agents: \`adk registry browse slash\`
+To install an agent: \`adk ref add <name>\`
+To authenticate: \`adk ref auth <name>\`
+To check auth status: \`adk ref auth-status <name>\`
+To inspect an agent: \`adk ref inspect <name>\`
+To view tool schemas: \`adk ref inspect <name> --full\`
+To list resources: \`adk ref resources <name>\`
+To read a resource: \`adk ref read <name> <uri>\`
+`;
+export function renderContent(content, meta) {
+    return `---
+name: ${meta.name}
+description: ${meta.description}
+---
+${content}`;
+}
+// ============================================
+// Target Parsing
+// ============================================
+function expandHome(p) {
+    if (p.startsWith("~/"))
+        return join(homedir(), p.slice(2));
+    return p;
+}
+export function parseTarget(value) {
+    const colonIdx = value.indexOf(":");
+    if (colonIdx === -1) {
+        // Just a preset name
+        const preset = getPreset(value);
+        if (!preset) {
+            const presetNames = Array.from(loadPresets().keys()).join(", ");
+            throw new Error(`Unknown preset: ${value}. Available: ${presetNames}`);
+        }
+        return { preset, path: expandHome(preset.defaultPath) };
+    }
+    const key = value.slice(0, colonIdx);
+    const path = value.slice(colonIdx + 1);
+    // Check if key is a preset name (with custom path)
+    const preset = getPreset(key);
+    if (preset) {
+        return { preset, path: expandHome(path || preset.defaultPath) };
+    }
+    const presetNames = Array.from(loadPresets().keys()).join(", ");
+    throw new Error(`Unknown target: ${key}. Available presets: ${presetNames}`);
+}
+// ============================================
+// Skill Installation
+// ============================================
+function ensureWrite(path, content) {
+    const dir = dirname(path);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(path, content, "utf-8");
+}
+export function installSkill(target) {
+    const outputPath = join(resolve(target.path), target.preset.filename);
+    const content = renderContent(ADK_SKILL_CONTENT, {
+        name: "adk",
+        description: "When connecting to APIs, calling remote tools, managing integrations, or the user asks about adk",
+    });
+    ensureWrite(outputPath, content);
+    return outputPath;
+}
+// ============================================
+// Init Command
+// ============================================
+const DEFAULT_REGISTRY_URL = "https://registry.slash.com";
+const DEFAULT_REGISTRY_NAME = "public";
+export async function runInit(adk, targets) {
+    // 1. Ensure default registry
+    const registries = await adk.registry.list();
+    const hasDefault = registries.some((r) => r.url === DEFAULT_REGISTRY_URL || r.name === DEFAULT_REGISTRY_NAME);
+    if (!hasDefault) {
+        await adk.registry.add({ url: DEFAULT_REGISTRY_URL, name: DEFAULT_REGISTRY_NAME });
+        console.log(`\x1b[32m\u2713\x1b[0m Set default registry: ${DEFAULT_REGISTRY_URL}`);
+    }
+    else {
+        console.log(`\x1b[32m\u2713\x1b[0m Default registry already configured: ${DEFAULT_REGISTRY_URL}`);
+    }
+    // 2. Install skills to targets
+    if (targets.length === 0) {
+        console.log(`\nTo install skills, re-run with targets:\n`);
+        const presets = listPresets();
+        for (const preset of presets) {
+            console.log(`  adk init --target ${preset.name}`);
+        }
+        console.log(`\nCustom path: adk init --target <preset>:<path>`);
+        console.log(`\nAsk the user which coding agents they use,`);
+        console.log(`then run: adk init --target <preset> [--target <preset> ...]`);
+        return;
+    }
+    for (const target of targets) {
+        const outputPath = installSkill(target);
+        console.log(`\x1b[32m\u2713\x1b[0m Installed adk skill \u2192 ${outputPath}`);
+    }
+    // 3. Save targets to config
+    const config = await adk.readConfig();
+    const targetStrings = targets.map((t) => {
+        return t.path === expandHome(t.preset.defaultPath) ? t.preset.name : `${t.preset.name}:${t.path}`;
+    });
+    config.targets = targetStrings;
+    await adk.writeConfig(config);
+    console.log(`\x1b[32m\u2713\x1b[0m Saved targets to config`);
+    console.log(`\nDone! Your coding agents now know how to use adk.`);
+    console.log(`Run \`adk init\` again anytime to refresh skills or add targets.`);
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/materialize.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Ref Materialization — Download agent docs to local filesystem.
+ *
+ * When `adk ref add` succeeds, materialize the agent's tool schemas,
+ * resources (skills), and generate TypeScript type definitions locally.
+ *
+ * Files are written under the adk config dir at refs/<name>/.
+ */
+import type { Adk } from "./config-store.js";
+interface MaterializeResult {
+    toolCount: number;
+    skillCount: number;
+    typesGenerated: boolean;
+}
+export declare function materializeRef(adk: Adk, refName: string, configDir: string): Promise<MaterializeResult>;
+export {};
+//# sourceMappingURL=materialize.d.ts.map

package/dist/materialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize.d.ts","sourceRoot":"","sources":["../src/materialize.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAc7C,UAAU,iBAAiB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;CACzB;AAoDD,wBAAsB,cAAc,CAClC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAuE5B"}

package/dist/materialize.js

@@ -0,0 +1,112 @@
+/**
+ * Ref Materialization — Download agent docs to local filesystem.
+ *
+ * When `adk ref add` succeeds, materialize the agent's tool schemas,
+ * resources (skills), and generate TypeScript type definitions locally.
+ *
+ * Files are written under the adk config dir at refs/<name>/.
+ */
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+// ============================================
+// Helpers
+// ============================================
+function ensureWrite(path, content) {
+    const dir = dirname(path);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(path, content, "utf-8");
+}
+/** Generate a .d.ts file from tool schemas. */
+function generateTypes(refName, tools) {
+    const lines = [
+        `// Auto-generated by adk ref add`,
+        `// Agent: ${refName}`,
+        `// Tools: ${tools.length}`,
+        ``,
+        `export interface ${pascalCase(refName)}Tools {`,
+    ];
+    for (const tool of tools) {
+        lines.push(`  /** ${tool.description ?? tool.name} */`);
+        lines.push(`  ${JSON.stringify(tool.name)}: {`);
+        lines.push(`    name: ${JSON.stringify(tool.name)};`);
+        if (tool.description) {
+            lines.push(`    description: ${JSON.stringify(tool.description)};`);
+        }
+        lines.push(`    params: Record<string, unknown>;`);
+        lines.push(`  };`);
+    }
+    lines.push(`}`);
+    lines.push(``);
+    lines.push(`export declare const tools: (keyof ${pascalCase(refName)}Tools)[];`);
+    lines.push(``);
+    return lines.join("\n");
+}
+function pascalCase(s) {
+    return s
+        .replace(/[^a-zA-Z0-9]+(.)/g, (_, c) => c.toUpperCase())
+        .replace(/^./, (c) => c.toUpperCase());
+}
+// ============================================
+// Materialize
+// ============================================
+export async function materializeRef(adk, refName, configDir) {
+    const refDir = join(configDir, "refs", refName);
+    const toolsDir = join(refDir, "tools");
+    const skillsDir = join(refDir, "skills");
+    const typesDir = join(refDir, "types");
+    let toolCount = 0;
+    let skillCount = 0;
+    let typesGenerated = false;
+    // 1. Fetch and write tool schemas
+    try {
+        const info = await adk.ref.inspect(refName, { full: true });
+        if (info?.tools && info.tools.length > 0) {
+            const tools = info.tools.map((t) => ({
+                name: t.name,
+                description: t.description,
+                inputSchema: t.inputSchema,
+                outputSchema: t.outputSchema,
+            }));
+            for (const tool of tools) {
+                const safeName = tool.name.replace(/[^a-zA-Z0-9_-]/g, "_");
+                ensureWrite(join(toolsDir, `${safeName}.tool.json`), JSON.stringify(tool, null, 2));
+            }
+            toolCount = tools.length;
+            // Write agent.json metadata
+            ensureWrite(join(refDir, "agent.json"), JSON.stringify({
+                name: refName,
+                description: info.description,
+                toolCount: tools.length,
+                tools: tools.map((t) => t.name),
+                materializedAt: new Date().toISOString(),
+            }, null, 2));
+            // Generate .d.ts
+            ensureWrite(join(typesDir, `${refName}.d.ts`), generateTypes(refName, tools));
+            typesGenerated = true;
+        }
+    }
+    catch {
+        // inspect failed — agent might not be reachable yet (needs auth)
+    }
+    // 2. Fetch and write resources (skills)
+    try {
+        const resourcesResult = await adk.ref.resources(refName);
+        const response = resourcesResult;
+        if (response?.result?.resources) {
+            for (const resource of response.result.resources) {
+                if (resource.uri && resource.text) {
+                    const filename = resource.uri.split("/").pop() ?? "resource.md";
+                    ensureWrite(join(skillsDir, filename), resource.text);
+                    skillCount++;
+                }
+            }
+        }
+    }
+    catch {
+        // resources fetch failed — might not be supported
+    }
+    return { toolCount, skillCount, typesGenerated };
+}
+//# sourceMappingURL=materialize.js.map