@phnx-labs/agents-cli 1.22.119 → 1.22.121

package/dist/lib/storage/selection.d.ts

@@ -1,48 +1,8 @@
-/**
- * The ONE managed-vs-BYO storage-backend selection policy.
- *
- * Every surface that persists to Phoenix-managed storage (`agents artifacts
- * share` today, `agents sessions` sync next) makes the SAME choice: run on OUR
- * managed infrastructure when the caller is signed in to Phoenix, and only fall
- * back to a bring-your-own bucket when the caller explicitly asked for it. This
- * module owns that decision so it is not re-derived — and re-drifted — per
- * surface.
- *
- * What lives here is ONLY the identity + selection policy. It deliberately does
- * NOT know a surface's endpoint, namespace shape, public-read semantics, or OG
- * covers — those differ (share uses an email-handle namespace with public reads
- * and covers; a traces/sessions adapter uses the userId and differs again). Each
- * surface keeps its own DISCRIMINATED, typed adapter that reads this decision and
- * returns its own `kind`-tagged backend. See `lib/traces/backend.ts` for a
- * concrete adapter.
- */
 import { type PhoenixSession } from '../identity/client.js';
-/** The two legitimate principals any managed-capable surface can resolve to. */
 export type StorageBackendKind = 'managed' | 'byo';
 export interface StorageSelectionOpts {
-    /**
-     * True when the SURFACE detected an explicit bring-your-own override — a
-     * `--byo` flag, a caller-supplied static write token, a `…_BACKEND=byo` env,
-     * or a full BYO endpoint config. Detecting WHICH signals count is the
-     * surface's job (they differ per surface); this policy only honors the boolean.
-     */
     byoOverride?: boolean;
-    /**
-     * DI seam for the Phoenix session. `undefined` reads the real persisted
-     * session (`readSession()`); `null` means "explicitly signed out".
-     */
     session?: PhoenixSession | null;
 }
-/**
- * Pick the storage principal. Managed when signed in (`readSession() != null`)
- * AND the surface reported no explicit BYO override; otherwise BYO.
- *
- * This is not a fallback chain — it is a single decision. A surface that cannot
- * authenticate EITHER principal (signed out AND no BYO config) still reads `byo`
- * here and fails loud in its own adapter, where the actionable "run auth login
- * or set up your bucket" message belongs.
- */
 export declare function selectStorageBackendKind(opts?: StorageSelectionOpts): StorageBackendKind;
-/** True when the shared policy resolves to the managed principal. Thin sugar
- * over {@link selectStorageBackendKind} for the common boolean check. */
 export declare function isManagedSelection(opts?: StorageSelectionOpts): boolean;

package/dist/lib/storage/selection.js

@@ -1,39 +1,10 @@
-/**
- * The ONE managed-vs-BYO storage-backend selection policy.
- *
- * Every surface that persists to Phoenix-managed storage (`agents artifacts
- * share` today, `agents sessions` sync next) makes the SAME choice: run on OUR
- * managed infrastructure when the caller is signed in to Phoenix, and only fall
- * back to a bring-your-own bucket when the caller explicitly asked for it. This
- * module owns that decision so it is not re-derived — and re-drifted — per
- * surface.
- *
- * What lives here is ONLY the identity + selection policy. It deliberately does
- * NOT know a surface's endpoint, namespace shape, public-read semantics, or OG
- * covers — those differ (share uses an email-handle namespace with public reads
- * and covers; a traces/sessions adapter uses the userId and differs again). Each
- * surface keeps its own DISCRIMINATED, typed adapter that reads this decision and
- * returns its own `kind`-tagged backend. See `lib/traces/backend.ts` for a
- * concrete adapter.
- */
 import { readSession } from '../identity/client.js';
-/**
- * Pick the storage principal. Managed when signed in (`readSession() != null`)
- * AND the surface reported no explicit BYO override; otherwise BYO.
- *
- * This is not a fallback chain — it is a single decision. A surface that cannot
- * authenticate EITHER principal (signed out AND no BYO config) still reads `byo`
- * here and fails loud in its own adapter, where the actionable "run auth login
- * or set up your bucket" message belongs.
- */
 export function selectStorageBackendKind(opts = {}) {
     if (opts.byoOverride === true)
         return 'byo';
     const session = opts.session === undefined ? readSession() : opts.session;
     return session != null ? 'managed' : 'byo';
 }
-/** True when the shared policy resolves to the managed principal. Thin sugar
- * over {@link selectStorageBackendKind} for the common boolean check. */
 export function isManagedSelection(opts = {}) {
     return selectStorageBackendKind(opts) === 'managed';
 }

package/dist/lib/subagents-registry.d.ts

@@ -1,97 +1,41 @@
 import type { AgentId, InstalledSubagent, SubagentFrontmatter } from './types.js';
-/** A path an installed subagent occupies, tagged for removal/trash handling. */
 interface OccupiedEntry {
     path: string;
     kind: 'file' | 'dir';
 }
-/** Parsed metadata for one installed subagent (drives the rich listing). */
 interface SubagentMeta {
     frontmatter: SubagentFrontmatter;
     files: string[];
-    /** Primary on-disk path for the listing's `path` field (a file or a dir, per layout). */
     path: string;
 }
-/**
- * The complete on-disk contract for one agent's subagents. Every operation is
- * expressed here so the engine below never branches on the agent id.
- */
 interface SubagentTarget {
-    /** Absolute container dir under a home root (a version home or an agent home). */
     dir(home: string): string;
-    /** Materialize central subagent `sub` into container `dir`. Throws on fs error. */
     write(dir: string, sub: {
         name: string;
         path: string;
     }): void;
-    /** Installed subagent names in `dir` (detector + orphan diff). */
     names(dir: string): string[];
-    /** On-disk paths subagent `name` occupies (for removal / soft-delete). */
     occupied(dir: string, name: string): OccupiedEntry[];
-    /** Rich metadata for `name`; `null` skips it from the listing. */
     read(dir: string, name: string): SubagentMeta | null;
-    /**
-     * True when the installed subagent `sub` in `dir` byte-matches what `write`
-     * would materialize from `sub.path` NOW — the content-drift check `agents
-     * doctor` uses. Re-renders the CURRENT source through the same transform the
-     * writer uses (never a stored hash), so a prompt-body edit to the source
-     * surfaces as drift even though the filename is unchanged.
-     */
     matches(dir: string, sub: {
         name: string;
         path: string;
     }): boolean;
 }
-/**
- * Copy every file in `src` into `dest` (created if missing), applying
- * `rename` (source filename -> target filename) on the way. Directories in
- * `src` are skipped -- subagents are flat file sets. Throws on fs error.
- */
 export declare function copyDirWithRename(src: string, dest: string, rename?: Record<string, string>): void;
-/**
- * Single source of truth for how each subagents-capable agent stores subagents.
- * The keys MUST match `capableAgents('subagents')` (the `subagents` flag in
- * `agents.ts`): the capability flag is the version gate, this table is the shape.
- */
 export declare const SUBAGENT_TARGETS: Partial<Record<AgentId, SubagentTarget>>;
-/** The registry entry for `agent`, or undefined if it stores no subagents. */
 export declare function subagentTarget(agent: AgentId): SubagentTarget | undefined;
-/**
- * Materialize central subagent `sub` into `home` for `agent`. Returns whether a
- * write happened (false when the agent has no registry entry). Throws only on
- * unexpected fs errors -- bulk callers wrap per-item.
- */
 export declare function writeSubagentToHome(agent: AgentId, home: string, sub: {
     name: string;
     path: string;
 }): boolean;
-/** Installed subagent names for `agent` under `home` (detector + orphan diff). */
 export declare function listInstalledSubagentNames(agent: AgentId, home: string): string[];
-/**
- * True when subagent `name` installed for `agent` under `home` byte-matches what
- * the writer would produce NOW from `sourceDir` — the content-drift predicate
- * `agents doctor` uses. Returns false when the agent has no registry entry
- * (nothing could have been written) so an unexpected home copy reads as drift.
- */
 export declare function subagentContentMatches(agent: AgentId, home: string, name: string, sourceDir: string): boolean;
-/**
- * Rich listing of subagents installed for `agent` under `home`, with parsed
- * metadata. Enumerates names, then reads each -- entries whose metadata is
- * unreadable (per the target's reader) are dropped.
- */
 export declare function listInstalledSubagentsRich(agent: AgentId, home: string): InstalledSubagent[];
-/**
- * Remove subagent `name` for `agent` from `home` (hard delete). No-op success
- * when the agent has no registry entry or nothing is installed.
- */
 export declare function removeSubagentFromHome(agent: AgentId, home: string, name: string): {
     success: boolean;
     error?: string;
 };
-/**
- * Soft-delete subagent `name` for `agent` from `home` into `trashDir`, stamping
- * each moved entry. Files land as `<basename>.<stamp>`, directories as
- * `<stamp>/`. No-op success when nothing is installed.
- */
 export declare function trashSubagentFromHome(agent: AgentId, home: string, name: string, trashDir: string, stamp: string): {
     success: boolean;
     error?: string;

package/dist/lib/subagents-registry.js

@@ -1,34 +1,3 @@
-/**
- * Declarative subagent-target registry.
- *
- * Each subagents-capable agent gets ONE table entry (`SUBAGENT_TARGETS`)
- * describing how a central subagent (`~/.agents/subagents/<name>/`) is
- * materialized into that agent's home, how it is enumerated, and where it lives
- * on disk. Generic install / list / detect / orphan / remove logic iterates the
- * table instead of the near-identical `else if (agent === '...')` chains that
- * used to be copy-pasted across `subagents.ts`, the staleness writer, and the
- * staleness detector -- roughly O(agents x operations) arms.
- *
- * Adding a *standard* integration is now one line here (plus the `subagents`
- * capability flag in `agents.ts`, the version gate). Three layout builders cover
- * every current agent, so most entries are a single call:
- *
- *   - `flatFile`  one `<name><ext>` file, body from a `transform` fn.
- *                 (claude, grok, pi, droid, codex, opencode, copilot,
- *                  cursor, goose, kimi)
- *   - `dirFile`   a `<name>/` directory holding one generated `<file>`.
- *                 (antigravity: `<name>/agent.md`)
- *   - `dirCopy`   copy the whole source directory to `<name>/`, applying
- *                 renames, detected by a `marker` file. (openclaw)
- *
- * Every agent now uses a builder; there are no bespoke handlers left. Legacy
- * on-disk layouts are folded once by `lib/migrate.ts`, never by a target --
- * a target describes the CURRENT shape and nothing else.
- *
- * The per-agent `transform`/metadata parsers are the escape hatch: they live in
- * `subagents.ts` and are referenced by the table, so the generic engine has zero
- * per-agent branches. See `docs/orchestration.md`.
- */
 import * as fs from 'fs';
 import * as path from 'path';
 import * as TOML from 'smol-toml';
@@ -36,7 +5,6 @@ import * as yaml from 'yaml';
 import { safeJoin } from './paths.js';
 import { filesContentMatch, normalizeResourceContent } from './resource-content-diff.js';
 import { parseSubagentFrontmatter, transformSubagentForClaude, transformSubagentForCodex, transformSubagentForCopilot, transformSubagentForCursor, transformSubagentForDroid, transformSubagentForGoose, transformSubagentForOpenCode, transformSubagentForAntigravity, } from './subagents.js';
-/** Read a file's UTF-8 content, or null when it is missing/unreadable. */
 function readFileSafe(filePath) {
     try {
         return fs.readFileSync(filePath, 'utf-8');
@@ -45,12 +13,9 @@ function readFileSafe(filePath) {
         return null;
     }
 }
-// ── metadata readers (the per-format escape hatch) ───────────────────────────
-/** Frontmatter, skipping files that lack a valid block (claude/grok/droid). */
 function metaFrontmatterSkip(filePath) {
     return parseSubagentFrontmatter(filePath);
 }
-/** Frontmatter, falling back to an empty description (opencode/copilot/cursor). */
 function metaFrontmatterFallback(filePath, name) {
     return parseSubagentFrontmatter(filePath) ?? { name, description: '' };
 }
@@ -63,7 +28,6 @@ function metaJson(filePath, name) {
         return null;
     }
 }
-/** Goose recipe YAML: title -> name, description; skip on parse error. */
 function metaGooseYaml(filePath, name) {
     try {
         const recipe = yaml.parse(fs.readFileSync(filePath, 'utf-8'));
@@ -73,12 +37,6 @@ function metaGooseYaml(filePath, name) {
         return null;
     }
 }
-/**
- * Codex custom-agent TOML: name / description / model (optional).
- * Codex writes no YAML frontmatter — without this reader, `flatFile.read`
- * drops every installed `.toml` and `agents subagents list` reports codex
- * targets as `missing` even when the files are present and Codex loads them.
- */
 function metaToml(filePath, name) {
     try {
         const cfg = TOML.parse(fs.readFileSync(filePath, 'utf-8'));
@@ -91,12 +49,6 @@ function metaToml(filePath, name) {
         return null;
     }
 }
-// ── shared fs primitive ──────────────────────────────────────────────────────
-/**
- * Copy every file in `src` into `dest` (created if missing), applying
- * `rename` (source filename -> target filename) on the way. Directories in
- * `src` are skipped -- subagents are flat file sets. Throws on fs error.
- */
 export function copyDirWithRename(src, dest, rename) {
     if (!fs.existsSync(dest)) {
         fs.mkdirSync(dest, { recursive: true });
@@ -109,8 +61,6 @@ export function copyDirWithRename(src, dest, rename) {
         fs.copyFileSync(sourcePath, path.join(dest, targetName));
     }
 }
-// ── layout builders ──────────────────────────────────────────────────────────
-/** One flattened `<name><ext>` file per subagent under `subdir`. */
 function flatFile(opts) {
     const readMeta = opts.readMeta ?? metaFrontmatterSkip;
     return {
@@ -148,7 +98,6 @@ function flatFile(opts) {
         },
     };
 }
-/** A `<name>/` directory holding one generated `<file>` per subagent. */
 function dirFile(opts) {
     const readMeta = opts.readMeta ?? ((p, name) => metaFrontmatterFallback(p, name));
     return {
@@ -187,7 +136,6 @@ function dirFile(opts) {
         },
     };
 }
-/** Copy the whole source directory to `<name>/`, detected by `marker`. */
 function dirCopy(opts) {
     return {
         dir: (home) => path.join(home, ...opts.subdir),
@@ -209,7 +157,6 @@ function dirCopy(opts) {
             const markerPath = path.join(dir, name, opts.marker);
             if (!fs.existsSync(markerPath))
                 return null;
-            // The marker may lack frontmatter; fall back to the first content line.
             let frontmatter = { name, description: '' };
             const parsed = parseSubagentFrontmatter(markerPath);
             if (parsed) {
@@ -228,9 +175,6 @@ function dirCopy(opts) {
             return { frontmatter, files, path: subagentDir };
         },
         matches(dir, sub) {
-            // dirCopy materializes every source file (with rename) into <dir>/<name>/.
-            // Re-derive the expected file set from source and byte-compare each, so an
-            // edit to any copied file — or an added/removed source file — is drift.
             const dest = path.join(dir, sub.name);
             let sourceFiles;
             try {
@@ -253,7 +197,6 @@ function dirCopy(opts) {
                 if (!filesContentMatch(path.join(sub.path, file), path.join(dest, destName)))
                     return false;
             }
-            // An extra file left in the installed dir (source file removed) is drift.
             let destFiles;
             try {
                 destFiles = fs.readdirSync(dest).filter((f) => {
@@ -272,18 +215,10 @@ function dirCopy(opts) {
         },
     };
 }
-// ── the registry ─────────────────────────────────────────────────────────────
-/**
- * Single source of truth for how each subagents-capable agent stores subagents.
- * The keys MUST match `capableAgents('subagents')` (the `subagents` flag in
- * `agents.ts`): the capability flag is the version gate, this table is the shape.
- */
 export const SUBAGENT_TARGETS = {
-    // Tier 1 -- flat markdown, Claude-compatible flatten.
     claude: flatFile({ subdir: ['.claude', 'agents'], ext: '.md', transform: transformSubagentForClaude }),
     grok: flatFile({ subdir: ['.grok', 'agents'], ext: '.md', transform: transformSubagentForClaude }),
     droid: flatFile({ subdir: ['.factory', 'droids'], ext: '.md', transform: transformSubagentForDroid }),
-    // Bespoke frontmatter/format, still one flat file.
     codex: flatFile({
         subdir: ['.codex', 'agents'],
         ext: '.toml',
@@ -314,30 +249,17 @@ export const SUBAGENT_TARGETS = {
         transform: transformSubagentForGoose,
         readMeta: metaGooseYaml,
     }),
-    // Directory layouts.
     antigravity: dirFile({
         subdir: ['.gemini', 'config', 'agents'],
         file: 'agent.md',
         transform: transformSubagentForAntigravity,
     }),
     openclaw: dirCopy({ subdir: ['.openclaw'], marker: 'AGENTS.md', rename: { 'AGENT.md': 'AGENTS.md' } }),
-    // Kimi discovers Claude-shaped agent markdown from its brand home's `agents/`
-    // dir (`USER_BRAND_DIRS = ["agents"]`, kimi-code >= 0.29.0). Frontmatter
-    // name/description + body, kebab-case name -- the same shape as claude/grok.
-    // The pre-markdown files agents-cli used to write here are swept once by
-    // `migrateKimiSubagentsToMarkdown` (lib/migrate.ts), not by this target.
     kimi: flatFile({ subdir: ['.kimi-code', 'agents'], ext: '.md', transform: transformSubagentForClaude, readMeta: metaFrontmatterFallback }),
 };
-/** The registry entry for `agent`, or undefined if it stores no subagents. */
 export function subagentTarget(agent) {
     return SUBAGENT_TARGETS[agent];
 }
-// ── generic engine (zero per-agent branches) ─────────────────────────────────
-/**
- * Materialize central subagent `sub` into `home` for `agent`. Returns whether a
- * write happened (false when the agent has no registry entry). Throws only on
- * unexpected fs errors -- bulk callers wrap per-item.
- */
 export function writeSubagentToHome(agent, home, sub) {
     const target = SUBAGENT_TARGETS[agent];
     if (!target)
@@ -345,30 +267,18 @@ export function writeSubagentToHome(agent, home, sub) {
     target.write(target.dir(home), sub);
     return true;
 }
-/** Installed subagent names for `agent` under `home` (detector + orphan diff). */
 export function listInstalledSubagentNames(agent, home) {
     const target = SUBAGENT_TARGETS[agent];
     if (!target)
         return [];
     return target.names(target.dir(home));
 }
-/**
- * True when subagent `name` installed for `agent` under `home` byte-matches what
- * the writer would produce NOW from `sourceDir` — the content-drift predicate
- * `agents doctor` uses. Returns false when the agent has no registry entry
- * (nothing could have been written) so an unexpected home copy reads as drift.
- */
 export function subagentContentMatches(agent, home, name, sourceDir) {
     const target = SUBAGENT_TARGETS[agent];
     if (!target)
         return false;
     return target.matches(target.dir(home), { name, path: sourceDir });
 }
-/**
- * Rich listing of subagents installed for `agent` under `home`, with parsed
- * metadata. Enumerates names, then reads each -- entries whose metadata is
- * unreadable (per the target's reader) are dropped.
- */
 export function listInstalledSubagentsRich(agent, home) {
     const target = SUBAGENT_TARGETS[agent];
     if (!target)
@@ -383,10 +293,6 @@ export function listInstalledSubagentsRich(agent, home) {
     }
     return out;
 }
-/**
- * Remove subagent `name` for `agent` from `home` (hard delete). No-op success
- * when the agent has no registry entry or nothing is installed.
- */
 export function removeSubagentFromHome(agent, home, name) {
     const target = SUBAGENT_TARGETS[agent];
     if (!target)
@@ -406,11 +312,6 @@ export function removeSubagentFromHome(agent, home, name) {
         return { success: false, error: String(err) };
     }
 }
-/**
- * Soft-delete subagent `name` for `agent` from `home` into `trashDir`, stamping
- * each moved entry. Files land as `<basename>.<stamp>`, directories as
- * `<stamp>/`. No-op success when nothing is installed.
- */
 export function trashSubagentFromHome(agent, home, name, trashDir, stamp) {
     const target = SUBAGENT_TARGETS[agent];
     if (!target)

package/dist/lib/subagents.d.ts

@@ -1,169 +1,45 @@
-/**
- * Subagent management -- discovery, installation, and format conversion.
- *
- * Subagents are named agent definitions in ~/.agents/subagents/, each a directory
- * with an agent.md file (frontmatter + instructions). This module discovers them,
- * transforms them into agent-native formats (Claude .mdc, OpenClaw YAML),
- * and syncs them into version homes.
- */
 import type { AgentId, DiscoveredSubagent, InstalledSubagent, SubagentFrontmatter } from './types.js';
-/**
- * Parse AGENT.md frontmatter to extract subagent metadata
- */
 export declare function parseSubagentFrontmatter(filePath: string): SubagentFrontmatter | null;
-/**
- * Get the body content of AGENT.md (everything after frontmatter)
- */
 export declare function getSubagentBody(filePath: string): string;
-/**
- * Discover subagents from a repository
- * Looks for subagents/{name}/AGENT.md
- */
 export declare function discoverSubagentsFromRepo(repoPath: string): DiscoveredSubagent[];
-/**
- * List installed subagents from ~/.agents/subagents/
- */
 export declare function listInstalledSubagents(): InstalledSubagent[];
-/**
- * Get a specific installed subagent
- */
 export declare function getInstalledSubagent(name: string): InstalledSubagent | null;
-/**
- * Install a subagent centrally to ~/.agents/subagents/{name}/
- */
 export declare function installSubagentCentrally(sourcePath: string, name: string): {
     success: boolean;
     error?: string;
 };
-/**
- * Remove an installed subagent
- */
 export declare function removeSubagent(name: string): {
     success: boolean;
     error?: string;
 };
-/**
- * Transform a subagent directory into a single .md file for Claude
- * Combines AGENT.md frontmatter + body with other files as sections
- */
 export declare function transformSubagentForClaude(subagentDir: string): string;
-/**
- * Transform a subagent into a Factory AI Droid "custom droid" .md file.
- *
- * Mirrors transformSubagentForClaude (flatten frontmatter + body + appended
- * .md sections), but emits only frontmatter keys Factory recognizes
- * (name, description, model). Factory has no `color` field, so it is dropped.
- * See https://docs.factory.ai/cli/configuration/custom-droids.
- */
 export declare function transformSubagentForDroid(subagentDir: string): string;
-/**
- * Transform a subagent into a GitHub Copilot CLI custom agent `.agent.md` file.
- *
- * Copilot custom agents are Markdown profiles with YAML frontmatter stored in
- * `~/.copilot/agents/` (user) or `.github/agents/` (project). The file name
- * ends in `.agent.md` and the frontmatter carries `name`, `description`, and
- * optionally `model` and `tools`. The emitted body is identical to Factory
- * Droid's custom-droid format (flatten frontmatter + body + appended .md
- * sections, `color` dropped), so this is an alias of transformSubagentForDroid.
- * See GitHub docs for custom agents.
- */
 export declare function transformSubagentForCopilot(subagentDir: string): string;
-/**
- * Transform a subagent into a Cursor CLI custom subagent `.md` file.
- *
- * Cursor loads subagents from `.cursor/agents/*.md` (project) or
- * `~/.cursor/agents/*.md` (user) — Markdown with YAML frontmatter
- * (name, description, model; also readonly/is_background, which our
- * frontmatter schema doesn't carry). Cursor has no `color` field, so this is
- * an alias of transformSubagentForDroid, same as Copilot.
- * See https://cursor.com/docs/subagents.
- */
 export declare function transformSubagentForCursor(subagentDir: string): string;
-/**
- * Transform a subagent into Antigravity's custom-agent markdown shape.
- *
- * Antigravity exposes custom agents as Markdown files with YAML frontmatter,
- * close to Gemini CLI subagents. Keep portable frontmatter fields and flatten
- * sibling markdown files into the prompt body like the other markdown-backed
- * agents.
- */
 export declare function transformSubagentForAntigravity(subagentDir: string): string;
-/**
- * Transform a subagent into an OpenCode agent markdown file.
- *
- * OpenCode loads agents from ~/.config/opencode/agents/*.md (global) with
- * YAML frontmatter (description required; mode: subagent for invocable
- * subagents) and a prompt body. File stem becomes the agent name.
- * https://opencode.ai/docs/agents/
- */
 export declare function transformSubagentForOpenCode(subagentDir: string): string;
-/**
- * Transform a subagent into a Codex custom-agent TOML file.
- *
- * Codex loads standalone TOML under ~/.codex/agents/*.toml. Required fields:
- * name, description, developer_instructions. Optional model maps from our
- * frontmatter when present.
- * https://developers.openai.com/codex/subagents (custom agents section)
- */
 export declare function transformSubagentForCodex(subagentDir: string): string;
-/**
- * Transform a subagent into a Goose recipe YAML file.
- *
- * Goose has no dedicated subagent file format — a named subagent IS a recipe.
- * Goose resolves named agents from `~/.config/goose/agents/<name>.yaml` (global)
- * and delegates to them by name in autonomous mode. The recipe schema mirrors the
- * one agents-cli already emits for Goose workflow recipes (`writeGooseSubrecipe`):
- * `version`, `title`, `description`, `instructions`, `prompt`, plus an optional
- * `settings.goose_model`. See goose-docs.ai context-engineering/subagents.
- */
 export declare function transformSubagentForGoose(subagentDir: string): string;
-/**
- * Sync a subagent to an OpenClaw workspace
- * Copies full directory, renames AGENT.md to AGENTS.md
- */
 export declare function syncSubagentToOpenclaw(subagentDir: string, targetDir: string): {
     success: boolean;
     error?: string;
 };
-/**
- * Install a subagent to a specific agent's home
- */
 export declare function installSubagentToAgent(subagentDir: string, subagentName: string, agent: AgentId, agentHome: string): {
     success: boolean;
     error?: string;
 };
-/**
- * Remove a subagent from a specific agent's home
- */
 export declare function removeSubagentFromAgent(subagentName: string, agent: AgentId, agentHome: string): {
     success: boolean;
     error?: string;
 };
-/**
- * Check if subagent content matches between source and installed
- */
 export declare function subagentContentMatches(installedDir: string, sourceDir: string): boolean;
-/**
- * List subagents installed to a specific agent's home.
- *
- * Layout (target dir, file/dir shape, metadata reader) is declared once per
- * agent in the subagent registry; this is a thin wrapper over the generic
- * enumerator so a new agent needs no arm here -- just a registry entry.
- */
 export declare function listSubagentsForAgent(agentId: AgentId, home: string): InstalledSubagent[];
 interface VersionSubagentDiff {
     agent: AgentId;
     version: string;
     orphans: string[];
 }
-/**
- * Compare a version home's subagents against discovered subagents.
- * Returns orphan subagent names.
- */
 export declare function diffVersionSubagents(agent: AgentId, version: string): VersionSubagentDiff;
-/**
- * Iterate all (agent, version) pairs that support subagents and are installed.
- */
 export declare function iterSubagentsCapableVersions(filter?: {
     agent?: AgentId;
     version?: string;
@@ -171,10 +47,6 @@ export declare function iterSubagentsCapableVersions(filter?: {
     agent: AgentId;
     version: string;
 }>;
-/**
- * Remove a single subagent from a specific version home.
- * Soft-deletes to ~/.agents/.trash/subagents/.
- */
 export declare function removeSubagentFromVersion(agent: AgentId, version: string, subagentName: string): {
     success: boolean;
     error?: string;