agent-relay 9.1.4 → 9.1.5

package/dist/cli/lib/skills-install.js

@@ -0,0 +1,182 @@
+/**
+ * Core logic for `agent-relay skills add` — fetching a published skill and
+ * installing it into the right per-harness directory for either the current
+ * project or the user's global config.
+ *
+ * This module is deliberately free of any interactive/TTY concerns so it can
+ * be unit-tested in isolation. The TUI lives in `./skills-tui.ts` and the
+ * command wiring in `../commands/skills.ts`.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+/** The `/orchestrate` skill published at agentrelay.com. */
+export const ORCHESTRATE_SKILL = {
+    /** Slug used for the installed file/directory name (the slash command). */
+    slug: 'orchestrate',
+    /** Canonical source of the skill markdown. */
+    url: 'https://agentrelay.com/skill.md',
+};
+/**
+ * Parse a skill markdown document, extracting `name`/`description` from the
+ * leading `---` YAML frontmatter block (if any) and the body that follows.
+ * Tolerant by design: a document with no frontmatter yields `body === raw`.
+ */
+export function parseSkill(raw) {
+    const normalized = raw.replace(/^\uFEFF/, '');
+    const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(normalized);
+    if (!match) {
+        return { raw, body: normalized.trim() };
+    }
+    const frontmatter = match[1];
+    const body = normalized.slice(match[0].length).trim();
+    const name = readScalar(frontmatter, 'name');
+    const description = readScalar(frontmatter, 'description');
+    return { raw, body, name, description };
+}
+function readScalar(frontmatter, key) {
+    const re = new RegExp(`^${key}\\s*:\\s*(.+)$`, 'm');
+    const m = re.exec(frontmatter);
+    if (!m)
+        return undefined;
+    return m[1].trim().replace(/^["']|["']$/g, '');
+}
+function tomlEscape(body) {
+    // Triple-quoted TOML strings only need `"""` and backslash escaped.
+    return body.replace(/\\/g, '\\\\').replace(/"""/g, '\\"\\"\\"');
+}
+/**
+ * The set of harnesses `skills add` can target. Each maps the skill onto the
+ * harness's native custom-command / skill convention.
+ */
+export const HARNESS_TARGETS = [
+    {
+        id: 'claude',
+        label: 'Claude Code',
+        resolvePath: (scope, ctx) => path.join(scope === 'global' ? ctx.homeDir : ctx.projectRoot, '.claude', 'skills', ORCHESTRATE_SKILL.slug, 'SKILL.md'),
+        // Claude skills are directories with a SKILL.md carrying frontmatter.
+        render: (skill) => ensureTrailingNewline(skill.raw),
+    },
+    {
+        id: 'codex',
+        label: 'Codex CLI',
+        resolvePath: (scope, ctx) => path.join(scope === 'global' ? ctx.homeDir : ctx.projectRoot, '.agents', 'skills', ORCHESTRATE_SKILL.slug, 'SKILL.md'),
+        // Codex discovers skills as `.agents/skills/<name>/SKILL.md` directories
+        // (the portable SKILL.md standard), scanning from the cwd up to the repo
+        // root and from $HOME. The full skill — frontmatter included — is required.
+        render: (skill) => ensureTrailingNewline(skill.raw),
+    },
+    {
+        id: 'cursor',
+        label: 'Cursor',
+        resolvePath: (scope, ctx) => path.join(scope === 'global' ? ctx.homeDir : ctx.projectRoot, '.cursor', 'commands', `${ORCHESTRATE_SKILL.slug}.md`),
+        // Cursor commands accept frontmatter (it surfaces the description).
+        render: (skill) => ensureTrailingNewline(skill.raw),
+    },
+    {
+        id: 'gemini',
+        label: 'Gemini CLI',
+        resolvePath: (scope, ctx) => path.join(scope === 'global' ? ctx.homeDir : ctx.projectRoot, '.gemini', 'commands', `${ORCHESTRATE_SKILL.slug}.toml`),
+        // Gemini custom commands are TOML with a `prompt` field.
+        render: (skill) => {
+            const description = skill.description ?? `The /${ORCHESTRATE_SKILL.slug} skill`;
+            return (`description = ${JSON.stringify(description)}\n` + `prompt = """\n${tomlEscape(skill.body)}\n"""\n`);
+        },
+    },
+    {
+        id: 'opencode',
+        label: 'OpenCode',
+        resolvePath: (scope, ctx) => scope === 'global'
+            ? path.join(ctx.homeDir, '.config', 'opencode', 'commands', `${ORCHESTRATE_SKILL.slug}.md`)
+            : path.join(ctx.projectRoot, '.opencode', 'commands', `${ORCHESTRATE_SKILL.slug}.md`),
+        // OpenCode commands are plain markdown prompts.
+        render: (skill) => ensureTrailingNewline(skill.body),
+    },
+];
+function ensureTrailingNewline(text) {
+    return text.endsWith('\n') ? text : `${text}\n`;
+}
+/** Look up a harness target by id. */
+export function findHarnessTarget(id) {
+    return HARNESS_TARGETS.find((t) => t.id === id);
+}
+/** Default resolution context: real project root + home directory. */
+export function defaultTargetContext(projectRoot) {
+    return { projectRoot, homeDir: os.homedir() };
+}
+/** Default writer: mkdir -p the parent and write the file. */
+export const fsWriter = {
+    exists: (filePath) => fs.existsSync(filePath),
+    write: (filePath, content) => {
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.writeFileSync(filePath, content, 'utf8');
+    },
+};
+/**
+ * Install the skill into each requested harness for the given scope.
+ * Never throws for a single-harness failure — it is recorded in the result so
+ * the caller can report a partial success.
+ */
+export function installSkill(opts) {
+    const writer = opts.writer ?? fsWriter;
+    const slug = opts.slug ?? ORCHESTRATE_SKILL.slug;
+    return opts.harnesses.map((target) => {
+        const filePath = target.resolvePath(opts.scope, opts.ctx);
+        try {
+            const existed = writer.exists(filePath);
+            writer.write(filePath, target.render(opts.skill, slug));
+            return {
+                harnessId: target.id,
+                label: target.label,
+                path: filePath,
+                status: existed ? 'overwritten' : 'installed',
+            };
+        }
+        catch (err) {
+            return {
+                harnessId: target.id,
+                label: target.label,
+                path: filePath,
+                status: 'failed',
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    });
+}
+/** Default time budget for the skill download before it is aborted. */
+export const FETCH_SKILL_TIMEOUT_MS = 15_000;
+/**
+ * Fetch the published skill markdown over HTTPS. Bounded by an abort timeout so
+ * a stalled connection can't hang `skills add` (notably in CI). Throws a clear
+ * error on timeout or a non-2xx response so the command can surface it.
+ */
+export async function fetchSkill(url = ORCHESTRATE_SKILL.url, timeoutMs = FETCH_SKILL_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    let res;
+    try {
+        res = await fetch(url, {
+            headers: { accept: 'text/markdown, text/plain, */*' },
+            signal: controller.signal,
+        });
+    }
+    catch (err) {
+        if (controller.signal.aborted) {
+            throw new Error(`Timed out downloading skill from ${url} after ${timeoutMs}ms`);
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to reach ${url}: ${message}`);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (!res.ok) {
+        throw new Error(`Failed to download skill from ${url} (HTTP ${res.status})`);
+    }
+    const text = await res.text();
+    if (!text.trim()) {
+        throw new Error(`Skill at ${url} was empty`);
+    }
+    return text;
+}
+//# sourceMappingURL=skills-install.js.map

package/dist/cli/lib/skills-install.js.map

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

package/dist/cli/lib/skills-tui.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Minimal terminal UI for `agent-relay skills add`.
+ *
+ * Two interactions:
+ *   - {@link selectScope}: a single-choice picker (project vs global).
+ *   - {@link selectHarnesses}: a multi-select checklist (which harnesses).
+ *
+ * Both are driven by raw keypress events so they work without any third-party
+ * prompt dependency. They require a TTY; callers must fall back to flags when
+ * `process.stdin.isTTY` is false (handled in the command layer).
+ */
+import type { HarnessTarget, SkillScope } from './skills-install.js';
+interface TtyStreams {
+    input: NodeJS.ReadStream;
+    output: NodeJS.WriteStream;
+}
+export interface ScopeChoice {
+    value: SkillScope;
+    label: string;
+    hint: string;
+}
+/** Single-choice picker for the install scope. Returns null if aborted. */
+export declare function selectScope(streams?: TtyStreams, choices?: ScopeChoice[]): Promise<SkillScope | null>;
+/**
+ * Multi-select checklist of harnesses. Space toggles, enter confirms.
+ * Returns the selected harness ids, or null if aborted. An empty selection at
+ * confirm time is treated as an abort (null) by the caller.
+ */
+export declare function selectHarnesses(harnesses: HarnessTarget[], streams?: TtyStreams, preselected?: string[]): Promise<string[] | null>;
+export {};
+//# sourceMappingURL=skills-tui.d.ts.map

package/dist/cli/lib/skills-tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-tui.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/skills-tui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMrE,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC;CAC5B;AA2DD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAOD,2EAA2E;AAC3E,wBAAsB,WAAW,CAC/B,OAAO,GAAE,UAA6B,EACtC,OAAO,GAAE,WAAW,EAAkB,GACrC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAsC5B;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,aAAa,EAAE,EAC1B,OAAO,GAAE,UAA6B,EACtC,WAAW,GAAE,MAAM,EAAO,GACzB,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAkD1B"}

package/dist/cli/lib/skills-tui.js

@@ -0,0 +1,165 @@
+/**
+ * Minimal terminal UI for `agent-relay skills add`.
+ *
+ * Two interactions:
+ *   - {@link selectScope}: a single-choice picker (project vs global).
+ *   - {@link selectHarnesses}: a multi-select checklist (which harnesses).
+ *
+ * Both are driven by raw keypress events so they work without any third-party
+ * prompt dependency. They require a TTY; callers must fall back to flags when
+ * `process.stdin.isTTY` is false (handled in the command layer).
+ */
+import readline from 'node:readline';
+const ESC = '\x1b';
+const HIDE_CURSOR = `${ESC}[?25l`;
+const SHOW_CURSOR = `${ESC}[?25h`;
+function defaultStreams() {
+    return { input: process.stdin, output: process.stdout };
+}
+/**
+ * Run a keypress-driven interaction. Handles raw mode setup/teardown, cursor
+ * hiding, and Ctrl+C, then resolves with whatever `onKey` returns (or null if
+ * the user aborted).
+ */
+async function runKeyLoop(streams, render, onKey) {
+    const { input, output } = streams;
+    readline.emitKeypressEvents(input);
+    const wasRaw = input.isRaw ?? false;
+    if (input.isTTY)
+        input.setRawMode(true);
+    output.write(HIDE_CURSOR);
+    return await new Promise((resolve) => {
+        const cleanup = () => {
+            input.off('keypress', handler);
+            if (input.isTTY)
+                input.setRawMode(wasRaw);
+            output.write(SHOW_CURSOR);
+            input.pause();
+        };
+        const handler = (_str, key) => {
+            const k = key ?? {};
+            if (k.ctrl && k.name === 'c') {
+                cleanup();
+                output.write('\n');
+                resolve(null);
+                return;
+            }
+            const result = onKey(k);
+            if (result.done) {
+                cleanup();
+                resolve(result.value);
+                return;
+            }
+            render();
+        };
+        input.resume();
+        input.on('keypress', handler);
+        render();
+    });
+}
+const SCOPE_CHOICES = [
+    { value: 'project', label: 'This project', hint: 'install into the current directory' },
+    { value: 'global', label: 'Global', hint: 'install into your home config for all projects' },
+];
+/** Single-choice picker for the install scope. Returns null if aborted. */
+export async function selectScope(streams = defaultStreams(), choices = SCOPE_CHOICES) {
+    let index = 0;
+    const { output } = streams;
+    let lines = 0;
+    const render = () => {
+        if (lines > 0)
+            output.write(`${ESC}[${lines}A`);
+        const out = [];
+        out.push('Where should the /orchestrate skill be installed?');
+        choices.forEach((choice, i) => {
+            const pointer = i === index ? '❯' : ' ';
+            const label = i === index ? `\x1b[36m${choice.label}\x1b[0m` : choice.label;
+            out.push(`${ESC}[2K${pointer} ${label}  \x1b[2m${choice.hint}\x1b[0m`);
+        });
+        out.push(`${ESC}[2K\x1b[2m(↑/↓ to move, enter to select, Ctrl+C to cancel)\x1b[0m`);
+        lines = out.length;
+        output.write(`${out.join('\n')}\n`);
+    };
+    return runKeyLoop(streams, render, (key) => {
+        switch (key.name) {
+            case 'up':
+            case 'k':
+                index = (index - 1 + choices.length) % choices.length;
+                return { done: false };
+            case 'down':
+            case 'j':
+                index = (index + 1) % choices.length;
+                return { done: false };
+            case 'return':
+            case 'enter':
+                return { done: true, value: choices[index].value };
+            case 'escape':
+                return { done: true, value: null };
+            default:
+                return { done: false };
+        }
+    });
+}
+/**
+ * Multi-select checklist of harnesses. Space toggles, enter confirms.
+ * Returns the selected harness ids, or null if aborted. An empty selection at
+ * confirm time is treated as an abort (null) by the caller.
+ */
+export async function selectHarnesses(harnesses, streams = defaultStreams(), preselected = []) {
+    let index = 0;
+    const selected = new Set(preselected);
+    const { output } = streams;
+    let lines = 0;
+    const render = () => {
+        if (lines > 0)
+            output.write(`${ESC}[${lines}A`);
+        const out = [];
+        out.push('Which coding harnesses? (space to toggle, a to toggle all)');
+        harnesses.forEach((harness, i) => {
+            const pointer = i === index ? '❯' : ' ';
+            const box = selected.has(harness.id) ? '\x1b[32m◉\x1b[0m' : '◯';
+            const label = i === index ? `\x1b[36m${harness.label}\x1b[0m` : harness.label;
+            out.push(`${ESC}[2K${pointer} ${box} ${label}`);
+        });
+        out.push(`${ESC}[2K\x1b[2m(↑/↓ move, space toggle, enter confirm, Ctrl+C cancel)\x1b[0m`);
+        lines = out.length;
+        output.write(`${out.join('\n')}\n`);
+    };
+    return runKeyLoop(streams, render, (key) => {
+        switch (key.name) {
+            case 'up':
+            case 'k':
+                index = (index - 1 + harnesses.length) % harnesses.length;
+                return { done: false };
+            case 'down':
+            case 'j':
+                index = (index + 1) % harnesses.length;
+                return { done: false };
+            case 'space':
+                toggle(selected, harnesses[index].id);
+                return { done: false };
+            case 'a':
+                if (selected.size === harnesses.length) {
+                    selected.clear();
+                }
+                else {
+                    harnesses.forEach((h) => selected.add(h.id));
+                }
+                return { done: false };
+            case 'return':
+            case 'enter':
+                return { done: true, value: harnesses.filter((h) => selected.has(h.id)).map((h) => h.id) };
+            case 'escape':
+                return { done: true, value: null };
+            default:
+                return { done: false };
+        }
+    });
+}
+function toggle(set, id) {
+    if (set.has(id))
+        set.delete(id);
+    else
+        set.add(id);
+}
+//# sourceMappingURL=skills-tui.js.map

package/dist/cli/lib/skills-tui.js.map

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

package/dist/index.cjs

@@ -283,7 +283,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // ../sdk/node_modules/@relaycast/sdk/dist/version.js
-var SDK_VERSION = "5.0.5";
+var SDK_VERSION = "5.0.6";
 
 // ../sdk/node_modules/zod/v4/classic/external.js
 var external_exports = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay",
-  "version": "9.1.4",
+  "version": "9.1.5",
   "description": "Real-time agent-to-agent communication system",
   "type": "module",
   "main": "dist/index.cjs",
@@ -43,12 +43,12 @@
     "pack:validate": "npm pack --dry-run"
   },
   "dependencies": {
-    "@agent-relay/cloud": "9.1.4",
-    "@agent-relay/config": "9.1.4",
-    "@agent-relay/fleet": "9.1.4",
-    "@agent-relay/harness-driver": "9.1.4",
-    "@agent-relay/sdk": "9.1.4",
-    "@agent-relay/utils": "9.1.4",
+    "@agent-relay/cloud": "9.1.5",
+    "@agent-relay/config": "9.1.5",
+    "@agent-relay/fleet": "9.1.5",
+    "@agent-relay/harness-driver": "9.1.5",
+    "@agent-relay/sdk": "9.1.5",
+    "@agent-relay/utils": "9.1.5",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "@relaycast/sdk": "^5.0.5",
     "@relayflows/cli": "^1.0.1",