@phnx-labs/agents-cli 1.20.12 → 1.20.14

package/dist/lib/staleness/detectors/subagents.js

@@ -1,5 +1,6 @@
 /**
  * Subagents detector. Claude: flat .md files under `<agentDir>/agents/`.
+ * Droid: flat .md files under `<versionHome>/.factory/droids/`.
  * OpenClaw: subdirectories containing AGENTS.md under `<versionHome>/.openclaw/`.
  * Mirrors versions.ts:521-539.
  */
@@ -21,6 +22,20 @@ function buildClaudeDetector() {
         },
     };
 }
+function buildDroidDetector() {
+    return {
+        kind: 'subagents',
+        agent: 'droid',
+        list({ versionHome }) {
+            const droidsDir = path.join(versionHome, '.factory', 'droids');
+            if (!fs.existsSync(droidsDir))
+                return [];
+            return fs.readdirSync(droidsDir)
+                .filter(f => f.endsWith('.md'))
+                .map(f => f.replace('.md', ''));
+        },
+    };
+}
 function buildOpenclawDetector() {
     return {
         kind: 'subagents',
@@ -37,6 +52,7 @@ function buildOpenclawDetector() {
 }
 const handlers = {
     claude: buildClaudeDetector,
+    droid: buildDroidDetector,
     openclaw: buildOpenclawDetector,
 };
 export const subagentsDetectors = lazyAgentMap(() => {

package/dist/lib/staleness/writers/subagents.js

@@ -1,7 +1,9 @@
 /**
  * Subagents writer. Claude flattens each subagent into a single .md file
- * under `<agentDir>/agents/`. OpenClaw copies the full subagent directory
- * (with AGENT.md renamed to AGENTS.md) into `<versionHome>/.openclaw/<name>/`.
+ * under `<agentDir>/agents/`. Droid (Factory AI) flattens each into a custom
+ * droid .md under `<versionHome>/.factory/droids/`. OpenClaw copies the full
+ * subagent directory (with AGENT.md renamed to AGENTS.md) into
+ * `<versionHome>/.openclaw/<name>/`.
  *
  * Source-side discovery is `listInstalledSubagents` from lib/subagents.ts —
  * it reads user + system layers only (project layer excluded for the same
@@ -10,7 +12,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { capableAgents } from '../../capabilities.js';
-import { listInstalledSubagents, transformSubagentForClaude, syncSubagentToOpenclaw } from '../../subagents.js';
+import { listInstalledSubagents, transformSubagentForClaude, transformSubagentForDroid, syncSubagentToOpenclaw } from '../../subagents.js';
 import { safeJoin } from '../../paths.js';
 import { lazyAgentMap } from './lazy-map.js';
 function buildSubagentsWriter(agent) {
@@ -32,6 +34,12 @@ function buildSubagentsWriter(agent) {
                         fs.writeFileSync(safeJoin(agentsDir, `${sub.name}.md`), transformSubagentForClaude(sub.path));
                         synced.push(sub.name);
                     }
+                    else if (agent === 'droid') {
+                        const droidsDir = path.join(versionHome, '.factory', 'droids');
+                        fs.mkdirSync(droidsDir, { recursive: true });
+                        fs.writeFileSync(safeJoin(droidsDir, `${sub.name}.md`), transformSubagentForDroid(sub.path));
+                        synced.push(sub.name);
+                    }
                     else if (agent === 'openclaw') {
                         const target = safeJoin(path.join(versionHome, '.openclaw'), sub.name);
                         const r = syncSubagentToOpenclaw(sub.path, target);

package/dist/lib/subagents.d.ts

@@ -47,6 +47,15 @@ export declare function removeSubagent(name: string): {
  * 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;
 /**
  * Sync a subagent to an OpenClaw workspace
  * Copies full directory, renames AGENT.md to AGENTS.md

package/dist/lib/subagents.js

@@ -229,6 +229,39 @@ export function transformSubagentForClaude(subagentDir) {
     }
     return result;
 }
+/**
+ * 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 function transformSubagentForDroid(subagentDir) {
+    const agentMd = path.join(subagentDir, 'AGENT.md');
+    const frontmatter = parseSubagentFrontmatter(agentMd);
+    const body = getSubagentBody(agentMd);
+    if (!frontmatter) {
+        throw new Error(`Invalid AGENT.md in ${subagentDir}`);
+    }
+    const frontmatterYaml = yaml.stringify({
+        name: frontmatter.name,
+        description: frontmatter.description,
+        ...(frontmatter.model && { model: frontmatter.model }),
+    }).trim();
+    let result = `---\n${frontmatterYaml}\n---\n\n${body}`;
+    const files = fs.readdirSync(subagentDir)
+        .filter(f => f.endsWith('.md') && f !== 'AGENT.md')
+        .sort();
+    for (const file of files) {
+        const filePath = path.join(subagentDir, file);
+        const content = fs.readFileSync(filePath, 'utf-8').trim();
+        const sectionName = file.replace('.md', '');
+        const title = sectionName.charAt(0).toUpperCase() + sectionName.slice(1).toLowerCase();
+        result += `\n\n## ${title}\n\n${content}`;
+    }
+    return result;
+}
 /**
  * Sync a subagent to an OpenClaw workspace
  * Copies full directory, renames AGENT.md to AGENTS.md

package/dist/lib/teams/agents.js

@@ -173,7 +173,7 @@ export function captureProcessStartTime(pid) {
     }
 }
 /** Agent types the team runner supports. */
-const TEAM_AGENT_TYPES = ['codex', 'cursor', 'gemini', 'claude', 'opencode', 'grok', 'antigravity', 'kimi'];
+const TEAM_AGENT_TYPES = ['codex', 'cursor', 'gemini', 'claude', 'opencode', 'grok', 'antigravity', 'kimi', 'droid'];
 // Suffix appended to all prompts to ensure agents provide a summary
 const PROMPT_SUFFIX = `
 

package/dist/lib/teams/parsers.d.ts

@@ -1,5 +1,5 @@
 /** Supported agent CLI types for team spawning. */
-export type AgentType = 'codex' | 'gemini' | 'cursor' | 'claude' | 'opencode' | 'grok' | 'antigravity' | 'kimi';
+export type AgentType = 'codex' | 'gemini' | 'cursor' | 'claude' | 'opencode' | 'grok' | 'antigravity' | 'kimi' | 'droid';
 /** Normalize a raw JSON event from any agent type into an array of unified event objects. */
 export declare function normalizeEvents(agentType: AgentType, raw: any): any[];
 /** Normalize a raw JSON event, returning only the first unified event (convenience wrapper). */

package/dist/lib/teams/parsers.js

@@ -31,6 +31,12 @@ export function normalizeEvents(agentType, raw) {
     else if (agentType === 'antigravity') {
         return normalizeAntigravity(raw);
     }
+    // droid (Factory AI) intentionally falls through to the generic normalizer
+    // below: its `-o stream-json` JSONL event schema is not yet verified against
+    // a live run (the documented `debug` format differs from stream-json). Events
+    // still stream and render; structured tool/file categorization will be added
+    // once a real `droid exec -o stream-json` sample is captured. Do NOT guess the
+    // schema here — a wrong discriminator silently mislabels every event.
     const timestamp = new Date().toISOString();
     return [{
             type: raw.type || 'unknown',

package/dist/lib/types.d.ts

@@ -6,7 +6,7 @@
  * formats for each supported agent.
  */
 /** Unique identifier for a supported AI coding agent. */
-export type AgentId = 'claude' | 'codex' | 'gemini' | 'cursor' | 'opencode' | 'openclaw' | 'copilot' | 'amp' | 'kiro' | 'goose' | 'roo' | 'antigravity' | 'grok' | 'kimi';
+export type AgentId = 'claude' | 'codex' | 'gemini' | 'cursor' | 'opencode' | 'openclaw' | 'copilot' | 'amp' | 'kiro' | 'goose' | 'roo' | 'antigravity' | 'grok' | 'kimi' | 'droid';
 /** How `agents run <agent>` chooses an installed version when none is pinned. */
 export type RunStrategy = 'pinned' | 'available' | 'balanced';
 /** Per-agent run strategy config. */

package/dist/lib/versions.d.ts

@@ -126,6 +126,10 @@ export declare function isVersionInstalled(agent: AgentId, version: string): boo
  * Get the latest available version from npm for an agent.
  */
 export declare function getLatestNpmVersion(agent: AgentId): Promise<string | null>;
+/**
+ * Get the oldest published version from npm for an agent.
+ */
+export declare function getOldestNpmVersion(agent: AgentId): Promise<string | null>;
 /**
  * Check if 'latest' version is already installed (by resolving to actual version).
  */
@@ -133,6 +137,13 @@ export declare function isLatestInstalled(agent: AgentId): Promise<{
     installed: boolean;
     version: string | null;
 }>;
+/**
+ * Check if 'oldest' published version is already installed (by resolving to actual version).
+ */
+export declare function isOldestInstalled(agent: AgentId): Promise<{
+    installed: boolean;
+    version: string | null;
+}>;
 /**
  * List all installed versions for an agent.
  */
@@ -210,6 +221,7 @@ export declare function resolveVersion(agent: AgentId, projectPath?: string): st
  *
  *   undefined / "" / "default"  -> undefined  (caller falls back to project pin or global default)
  *   "latest"                    -> highest installed version (process.exit if none installed)
+ *   "oldest"                    -> lowest installed version (process.exit if none installed)
  *   "x.y.z" (installed)         -> "x.y.z"
  *   "x.y.z" (not installed)     -> process.exit with installed-list hint
  *
@@ -221,9 +233,9 @@ export declare function resolveVersion(agent: AgentId, projectPath?: string): st
 export declare function resolveVersionAlias(agent: AgentId, raw: string | undefined | null): string | undefined;
 /**
  * Loose variant of resolveVersionAlias for record-filter contexts (sessions,
- * team history). Same `default`/`latest` semantics, but explicit versions
- * pass through unchanged so historical records of uninstalled versions remain
- * queryable.
+ * team history). Same `default`/`latest`/`oldest` semantics, but explicit
+ * versions pass through unchanged so historical records of uninstalled versions
+ * remain queryable.
  */
 export declare function resolveVersionAliasLoose(agent: AgentId, raw: string | undefined | null): string | undefined;
 /**

package/dist/lib/versions.js

@@ -35,7 +35,7 @@ import { discoverPlugins } from './plugins.js';
 import { loadManifest, saveManifest, buildManifest as buildSyncManifest, isStale } from './staleness/index.js';
 import { emit } from './events.js';
 import { safeJoin } from './paths.js';
-import { listCommandSkillsInVersion, shouldInstallCommandAsSkill } from './command-skills.js';
+import { listCommandSkillsInVersion, readSkillSourceCommandMarker, shouldInstallCommandAsSkill } from './command-skills.js';
 import { getWriter, getDetector } from './staleness/registry.js';
 /** Promisified exec for running shell commands. */
 const execAsync = promisify(exec);
@@ -804,10 +804,7 @@ export function getVersionDir(agent, version) {
 export function getBinaryPath(agent, version) {
     const agentConfig = AGENTS[agent];
     if (agent === 'grok') {
-        // Grok binaries live in the global ~/.grok/downloads, not per-version node_modules.
-        // We return a best-effort path (used for display / checks). Real resolution
-        // happens in agents.ts resolveGrokBinary + the generated shims.
-        const grokDownloads = path.join(os.homedir(), '.grok', 'downloads');
+        const grokDownloads = path.join(getVersionHomePath(agent, version), '.grok', 'downloads');
         // Best effort: first matching file for this version
         try {
             const entries = fs.readdirSync(grokDownloads);
@@ -853,6 +850,26 @@ export async function getLatestNpmVersion(agent) {
         return null;
     }
 }
+/**
+ * Get the oldest published version from npm for an agent.
+ */
+export async function getOldestNpmVersion(agent) {
+    const agentConfig = AGENTS[agent];
+    if (!agentConfig.npmPackage)
+        return null;
+    try {
+        const { stdout } = await execFileAsync('npm', ['view', agentConfig.npmPackage, 'versions', '--json'], { shell: process.platform === 'win32' });
+        const parsed = JSON.parse(stdout.trim());
+        // `npm view ... versions --json` returns an array (multiple versions) or a
+        // bare string (single published version). Normalize to an array.
+        const versions = Array.isArray(parsed) ? parsed : [parsed];
+        const sorted = versions.filter((v) => VERSION_RE.test(v)).sort(compareVersions);
+        return sorted[0] ?? null;
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Check if 'latest' version is already installed (by resolving to actual version).
  */
@@ -863,6 +880,16 @@ export async function isLatestInstalled(agent) {
     }
     return { installed: isVersionInstalled(agent, latestVersion), version: latestVersion };
 }
+/**
+ * Check if 'oldest' published version is already installed (by resolving to actual version).
+ */
+export async function isOldestInstalled(agent) {
+    const oldestVersion = await getOldestNpmVersion(agent);
+    if (!oldestVersion) {
+        return { installed: false, version: null };
+    }
+    return { installed: isVersionInstalled(agent, oldestVersion), version: oldestVersion };
+}
 /**
  * List all installed versions for an agent.
  */
@@ -996,6 +1023,20 @@ export async function installVersion(agent, version, onProgress) {
         emit('version.install', { agent, version: installedVersion });
         return { success: true, installedVersion };
     }
+    // Resolve the `oldest` alias to a concrete npm version up front so the rest
+    // of the install path treats it as an ordinary pinned install. (`latest`
+    // keeps its bare-package-name + post-install-rename handling below.)
+    if (version === 'oldest') {
+        const oldest = await getOldestNpmVersion(agent);
+        if (!oldest) {
+            return {
+                success: false,
+                installedVersion: version,
+                error: `Could not resolve the oldest published version for ${agentConfig.name} from npm.`,
+            };
+        }
+        version = oldest;
+    }
     ensureAgentsDir();
     const versionDir = getVersionDir(agent, version);
     // Create version directory and isolated home
@@ -1012,6 +1053,8 @@ export async function installVersion(agent, version, onProgress) {
     const packageSpec = version === 'latest'
         ? agentConfig.npmPackage
         : `${agentConfig.npmPackage}@${version}`;
+    // The `${agentConfig.npmPackage}@` prefix is load-bearing: it ensures `version`
+    // (which VERSION_RE permits to start with `-`) is never passed as a standalone npm CLI flag.
     try {
         // Check npm is available
         const winShell = process.platform === 'win32';
@@ -1120,7 +1163,17 @@ export function softDeleteVersionDir(agent, version) {
     const trashDest = path.join(trashAgentDir, stamp);
     try {
         fs.mkdirSync(trashAgentDir, { recursive: true, mode: 0o700 });
-        fs.renameSync(versionDir, trashDest);
+        try {
+            fs.renameSync(versionDir, trashDest);
+        }
+        catch (renameErr) {
+            // On Windows, rename fails with EPERM/EACCES when any file in the tree
+            // is locked by a running process. Fall back to recursive copy + delete.
+            if (renameErr.code !== 'EPERM' && renameErr.code !== 'EACCES')
+                throw renameErr;
+            fs.cpSync(versionDir, trashDest, { recursive: true });
+            fs.rmSync(versionDir, { recursive: true, force: true });
+        }
         return trashDest;
     }
     catch {
@@ -1182,10 +1235,10 @@ export function printTrashFooter(moved) {
     console.log(chalk.gray('Sessions remain accessible via `agents sessions`.'));
     if (moved.length === 1) {
         const { agent, version } = moved[0];
-        console.log(chalk.gray(`Restore with: agents trash restore ${agent}@${version}`));
+        console.log(chalk.gray(`Restore with: agents restore ${agent}@${version}`));
     }
     else {
-        console.log(chalk.gray('Restore with: agents trash restore <agent>@<version>  (run `agents trash list` to see)'));
+        console.log(chalk.gray('Restore with: agents restore <agent>@<version>  (run `agents trash list` to see)'));
     }
 }
 /**
@@ -1223,6 +1276,7 @@ export function resolveVersion(agent, projectPath) {
  *
  *   undefined / "" / "default"  -> undefined  (caller falls back to project pin or global default)
  *   "latest"                    -> highest installed version (process.exit if none installed)
+ *   "oldest"                    -> lowest installed version (process.exit if none installed)
  *   "x.y.z" (installed)         -> "x.y.z"
  *   "x.y.z" (not installed)     -> process.exit with installed-list hint
  *
@@ -1234,14 +1288,14 @@ export function resolveVersion(agent, projectPath) {
 export function resolveVersionAlias(agent, raw) {
     if (!raw || raw === 'default')
         return undefined;
-    if (raw === 'latest') {
+    if (raw === 'latest' || raw === 'oldest') {
         const installed = listInstalledVersions(agent);
         if (installed.length === 0) {
             console.error(chalk.red(`No ${agent} versions installed.`));
             console.error(chalk.gray(`Install one: agents versions install ${agent}`));
             process.exit(1);
         }
-        return installed[installed.length - 1];
+        return raw === 'oldest' ? installed[0] : installed[installed.length - 1];
     }
     if (!isVersionInstalled(agent, raw)) {
         const installed = listInstalledVersions(agent);
@@ -1256,16 +1310,18 @@ export function resolveVersionAlias(agent, raw) {
 }
 /**
  * Loose variant of resolveVersionAlias for record-filter contexts (sessions,
- * team history). Same `default`/`latest` semantics, but explicit versions
- * pass through unchanged so historical records of uninstalled versions remain
- * queryable.
+ * team history). Same `default`/`latest`/`oldest` semantics, but explicit
+ * versions pass through unchanged so historical records of uninstalled versions
+ * remain queryable.
  */
 export function resolveVersionAliasLoose(agent, raw) {
     if (!raw || raw === 'default')
         return undefined;
-    if (raw === 'latest') {
+    if (raw === 'latest' || raw === 'oldest') {
         const installed = listInstalledVersions(agent);
-        return installed.length > 0 ? installed[installed.length - 1] : undefined;
+        if (installed.length === 0)
+            return undefined;
+        return raw === 'oldest' ? installed[0] : installed[installed.length - 1];
     }
     return raw;
 }
@@ -1643,10 +1699,10 @@ export function syncResourcesToVersion(agent, version, selection, options = {})
     const commandsToSync = selection
         ? resolveSelection(selection.commands, available.commands)
         : available.commands; // No selection = sync all
+    const commandsAsSkills = shouldInstallCommandAsSkill(agent, version);
     if (commandsToSync.length > 0 && commandsWriter) {
         const commandsTarget = path.join(agentDir, agentConfig.commandsSubdir);
-        const commandsAsSkills = shouldInstallCommandAsSkill(agent, version);
-        if (commandsAsSkills) {
+        if (commandsAsSkills && agentConfig.commandsSubdir) {
             removePath(commandsTarget);
         }
         const r = commandsWriter.write({ version, versionHome, selection: commandsToSync, cwd });
@@ -1680,9 +1736,22 @@ export function syncResourcesToVersion(agent, version, selection, options = {})
     // ~/.agents/skills/ (Gemini) are not registered; we clear the version-home
     // skills dir for them so a stale per-version copy never shadows central.
     const skillsWriter = getWriter('skills', agent);
-    const skillsToSync = selection
+    let skillsToSync = selection
         ? resolveSelection(selection.skills, available.skills)
         : available.skills;
+    if (commandsAsSkills && commandsToSync.length > 0 && skillsToSync.length > 0) {
+        const commandNames = new Set(commandsToSync);
+        const skillRoots = [
+            path.join(getUserAgentsDir(), 'skills'),
+            getSkillsDir(),
+            ...getEnabledExtraRepos().map((e) => path.join(e.dir, 'skills')),
+        ];
+        skillsToSync = skillsToSync.filter((skill) => {
+            if (!commandNames.has(skill))
+                return true;
+            return readSkillSourceCommandMarker(skill, skillRoots) !== skill;
+        });
+    }
     if (agentConfig.nativeAgentsSkillsDir) {
         removePath(path.join(agentDir, 'skills'));
     }
@@ -1745,7 +1814,7 @@ export function syncResourcesToVersion(agent, version, selection, options = {})
     // CAPABLE_AGENTS list and silently skipped it). Project rules are NOT
     // synced into the version home — they are composed into the workspace at
     // agents-run time (see compileRulesForProject).
-    const skipMemory = selection && (selection.memory === undefined || (Array.isArray(selection.memory) && selection.memory.length === 0));
+    const skipMemory = selection && Array.isArray(selection.memory) && selection.memory.length === 0;
     const rulesWriter = getWriter('rules', agent);
     if (!skipMemory && rulesWriter) {
         try {

package/dist/lib/wallet/index.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Wallet: device-local credit-card vault.
+ *
+ * Two-tier storage so listing the wallet doesn't pop Touch ID, but reading
+ * a card always does:
+ *
+ *   Card metadata (id, nickname, brand, last4, expiry, created_at, kind)
+ *     -> ~/.agents/wallet/cards.json, mode 0600
+ *     -> Display-only data, equivalent of Apple Wallet's "card art" tier.
+ *
+ *   Card secret (PAN, CVC, cardholder)
+ *     -> Keychain item `agents-cli.secrets.wallet.<id>` (JSON-encoded)
+ *     -> Routed through the signed helper, so the OS gates decryption with
+ *        Touch ID + biometryCurrentSet. Re-enrolling Touch ID invalidates
+ *        the item, matching Apple Pay's AR-value rotation behavior.
+ *
+ * Not Apple Pay: we store a real PAN, not a network DPAN, and we do not
+ * generate per-transaction cryptograms. Callers must surface this clearly.
+ */
+/** Test seam: override the index path. Returns the previous override (or null). */
+export declare function _setIndexPathForTest(p: string | null): string | null;
+export type CardBrand = 'visa' | 'mastercard' | 'amex' | 'discover' | 'diners' | 'jcb' | 'unionpay' | 'unknown';
+/** Storage kind discriminator. Reserved for future kind: 'stripe_token'. */
+export type CardKind = 'pan_encrypted';
+/** Non-sensitive card metadata. Safe to display without biometric auth. */
+export interface CardMetadata {
+    id: string;
+    nickname: string;
+    brand: CardBrand;
+    last4: string;
+    exp_month: string;
+    exp_year: string;
+    created_at: string;
+    kind: CardKind;
+}
+/** Sensitive card fields. Keychain-stored, Touch ID required to read. */
+export interface CardSecret {
+    pan: string;
+    cvc: string;
+    cardholder: string;
+}
+/** Card metadata plus its secret payload. Returned by show() only. */
+export interface CardFull extends CardMetadata, CardSecret {
+}
+/** Input shape for add(). */
+export interface AddCardInput {
+    nickname: string;
+    pan: string;
+    cvc: string;
+    cardholder: string;
+    exp_month: string;
+    exp_year: string;
+}
+/** Compute the Luhn checksum and verify a candidate PAN. */
+export declare function isValidLuhn(pan: string): boolean;
+/** Detect card brand from the BIN (first 6 digits). */
+export declare function detectBrand(pan: string): CardBrand;
+/** Atomically read the index file. Returns [] when missing. */
+export declare function readIndex(): CardMetadata[];
+/** List all stored cards. Does NOT trigger biometric auth. */
+export declare function listCards(): CardMetadata[];
+/** Look up a card by id (or by case-insensitive nickname). Returns undefined when missing. */
+export declare function findCard(idOrNickname: string): CardMetadata | undefined;
+/**
+ * Add a new card. Validates Luhn + expiry. Returns the metadata for the
+ * stored card. The PAN/CVC/cardholder are written to Keychain in a single
+ * JSON blob; only metadata is mirrored to the index file.
+ */
+export declare function addCard(input: AddCardInput): CardMetadata;
+/**
+ * Reveal a card by id. **Triggers Touch ID on macOS.** Throws if the card
+ * isn't in the index or if the keychain entry is missing/cancelled.
+ */
+export declare function showCard(idOrNickname: string): CardFull;
+/** Delete a card from both the index and Keychain. Returns the removed metadata or undefined. */
+export declare function removeCard(idOrNickname: string): CardMetadata | undefined;
+/** Rename a card. Throws if the new nickname collides with an existing card. */
+export declare function renameCard(idOrNickname: string, newNickname: string): CardMetadata;