poe-code 3.0.29 → 3.0.31

package/dist/cli/commands/skill.js

@@ -0,0 +1,242 @@
+import { select, isCancel, cancel } from "@poe-code/design-system";
+import { supportedAgents, configure, unconfigure, resolveAgentSupport } from "@poe-code/agent-skill-config";
+import { createExecutionResources, resolveCommandFlags } from "./shared.js";
+import { throwCommandNotFound } from "../command-not-found.js";
+const DEFAULT_SKILL_AGENT = "claude-code";
+function buildHelpText() {
+    return [
+        "",
+        "Skill directories:",
+        "- poe-code skill configure installs skill directories for supported agents.",
+        "- poe-code skill unconfigure removes skill directories."
+    ].join("\n");
+}
+export function registerSkillCommand(program, container) {
+    const skill = program
+        .command("skill")
+        .description("Skill directory commands")
+        .addHelpText("after", buildHelpText())
+        .action(function () {
+        if (this.args.length > 0) {
+            throwCommandNotFound({
+                container,
+                scope: "skill",
+                unknownCommand: this.args.at(0) ?? "",
+                helpArgs: ["skill", "--help"],
+                moduleUrl: import.meta.url
+            });
+        }
+        this.help();
+    });
+    skill
+        .command("configure [agent]")
+        .description("Install skill directories for an agent")
+        .option("--agent <name>", "Agent to configure skills for")
+        .option("--local", "Use local scope (in the current project)")
+        .option("--global", "Use global scope (in the user home directory)")
+        .action(async (agentArg, options) => {
+        const flags = resolveCommandFlags(program);
+        const resources = createExecutionResources(container, flags, "skill");
+        if (options.local && options.global) {
+            resources.logger.error("Use either --local or --global, not both.");
+            return;
+        }
+        let agent = options.agent ?? agentArg;
+        if (!agent) {
+            if (flags.assumeYes) {
+                agent = DEFAULT_SKILL_AGENT;
+            }
+            else {
+                const selected = await select({
+                    message: "Select agent to configure:",
+                    options: supportedAgents.map((a) => ({ value: a, label: a }))
+                });
+                if (isCancel(selected)) {
+                    cancel("Operation cancelled");
+                    return;
+                }
+                agent = selected;
+            }
+        }
+        const support = resolveAgentSupport(agent);
+        if (support.status === "unknown") {
+            resources.logger.error(`Unknown agent: ${agent}`);
+            return;
+        }
+        if (support.status === "unsupported") {
+            resources.logger.error(`Skills not supported for ${support.id}.`);
+            return;
+        }
+        const resolvedAgent = support.id ?? agent;
+        const config = support.config;
+        let scope;
+        if (options.local) {
+            scope = "local";
+        }
+        else if (options.global) {
+            scope = "global";
+        }
+        else if (flags.assumeYes) {
+            scope = "global";
+        }
+        else {
+            const selected = await select({
+                message: "Select scope:",
+                options: [
+                    { value: "global", label: "Global" },
+                    { value: "local", label: "Local" }
+                ]
+            });
+            if (isCancel(selected)) {
+                cancel("Operation cancelled");
+                return;
+            }
+            scope = selected;
+        }
+        const displayPath = scope === "global"
+            ? config.globalSkillDir
+            : config.localSkillDir.startsWith("./")
+                ? config.localSkillDir
+                : `./${config.localSkillDir}`;
+        resources.logger.intro(`skill configure ${resolvedAgent}`);
+        await configure(resolvedAgent, {
+            fs: container.fs,
+            homeDir: container.env.homeDir,
+            cwd: container.env.cwd,
+            scope,
+            dryRun: flags.dryRun,
+            observers: {
+                onStart: (details) => {
+                    if (flags.dryRun) {
+                        resources.logger.dryRun(`Would ${details.label.toLowerCase()}`);
+                    }
+                },
+                onComplete: (details, outcome) => {
+                    if (!flags.dryRun && outcome.changed) {
+                        resources.logger.verbose(details.label);
+                    }
+                }
+            }
+        });
+        resources.context.complete({
+            success: `Configured skills for ${resolvedAgent} at ${displayPath}`,
+            dry: `Would configure skills for ${resolvedAgent} at ${displayPath}`
+        });
+        resources.context.finalize();
+    });
+    skill
+        .command("unconfigure [agent]")
+        .description("Remove skill directories for an agent")
+        .option("--agent <name>", "Agent to unconfigure skills for")
+        .option("--local", "Use local scope (in the current project)")
+        .option("--global", "Use global scope (in the user home directory)")
+        .option("--force", "Remove directory even if it contains files")
+        .action(async (agentArg, options) => {
+        const flags = resolveCommandFlags(program);
+        const resources = createExecutionResources(container, flags, "skill");
+        if (options.local && options.global) {
+            resources.logger.error("Use either --local or --global, not both.");
+            return;
+        }
+        let agent = options.agent ?? agentArg;
+        if (!agent) {
+            const selected = await select({
+                message: "Select agent to unconfigure:",
+                options: supportedAgents.map((a) => ({ value: a, label: a }))
+            });
+            if (isCancel(selected)) {
+                cancel("Operation cancelled");
+                return;
+            }
+            agent = selected;
+        }
+        const support = resolveAgentSupport(agent);
+        if (support.status === "unknown") {
+            resources.logger.error(`Unknown agent: ${agent}`);
+            return;
+        }
+        if (support.status === "unsupported") {
+            resources.logger.error(`Skills not supported for ${support.id}.`);
+            return;
+        }
+        const resolvedAgent = support.id ?? agent;
+        const config = support.config;
+        let scope;
+        if (options.local) {
+            scope = "local";
+        }
+        else if (options.global) {
+            scope = "global";
+        }
+        else {
+            const selected = await select({
+                message: "Select scope:",
+                options: [
+                    { value: "global", label: "Global" },
+                    { value: "local", label: "Local" }
+                ]
+            });
+            if (isCancel(selected)) {
+                cancel("Operation cancelled");
+                return;
+            }
+            scope = selected;
+        }
+        const displayPath = scope === "global" ? config.globalSkillDir : config.localSkillDir;
+        resources.logger.intro(`skill unconfigure ${resolvedAgent}`);
+        let targetPath;
+        let removed = false;
+        await unconfigure(resolvedAgent, {
+            fs: container.fs,
+            homeDir: container.env.homeDir,
+            cwd: container.env.cwd,
+            scope,
+            force: Boolean(options.force),
+            dryRun: flags.dryRun,
+            observers: {
+                onStart: (details) => {
+                    if (flags.dryRun) {
+                        resources.logger.dryRun(`Would ${details.label.toLowerCase()}`);
+                    }
+                },
+                onComplete: (details, outcome) => {
+                    targetPath = details.targetPath;
+                    removed = outcome.changed;
+                    if (!flags.dryRun && outcome.changed) {
+                        resources.logger.verbose(details.label);
+                    }
+                }
+            }
+        });
+        if (flags.dryRun) {
+            resources.context.complete({
+                success: `Removed skill directory for ${resolvedAgent} at ${displayPath}`,
+                dry: `Would remove skill directory for ${resolvedAgent} at ${displayPath}`
+            });
+            resources.context.finalize();
+            return;
+        }
+        if (removed) {
+            resources.context.complete({
+                success: `Removed skill directory for ${resolvedAgent} at ${displayPath}`,
+                dry: `Would remove skill directory for ${resolvedAgent} at ${displayPath}`
+            });
+            resources.context.finalize();
+            return;
+        }
+        if (!options.force && targetPath) {
+            try {
+                const entries = await container.fs.readdir(targetPath);
+                if (entries.length > 0) {
+                    resources.logger.warn(`Skill directory for ${resolvedAgent} at ${displayPath} has files. Use --force to remove.`);
+                    return;
+                }
+            }
+            catch {
+                // Directory missing or unreadable.
+            }
+        }
+        resources.logger.info(`No skill directory found for ${resolvedAgent} at ${displayPath}.`);
+    });
+}
+//# sourceMappingURL=skill.js.map

package/dist/cli/commands/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../../src/cli/commands/skill.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEnE,OAAO,EACL,eAAe,EACf,SAAS,EACT,WAAW,EACX,mBAAmB,EAEpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAE1C,SAAS,aAAa;IACpB,OAAO;QACL,EAAE;QACF,oBAAoB;QACpB,6EAA6E;QAC7E,yDAAyD;KAC1D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAAgB,EAChB,SAAuB;IAEvB,MAAM,KAAK,GAAG,OAAO;SAClB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,0BAA0B,CAAC;SACvC,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,CAAC;SACrC,MAAM,CAAC;QACN,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,oBAAoB,CAAC;gBACnB,SAAS;gBACT,KAAK,EAAE,OAAO;gBACd,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;gBACrC,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;gBAC7B,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG;aAC3B,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEL,KAAK;SACF,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,wCAAwC,CAAC;SACrD,MAAM,CAAC,gBAAgB,EAAE,+BAA+B,CAAC;SACzD,MAAM,CAAC,SAAS,EAAE,0CAA0C,CAAC;SAC7D,MAAM,CAAC,UAAU,EAAE,+CAA+C,CAAC;SACnE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QAClC,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,wBAAwB,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAEtE,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACpC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,IAAI,KAAK,GAAuB,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC;QAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBACpB,KAAK,GAAG,mBAAmB,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC;oBAC5B,OAAO,EAAE,4BAA4B;oBACrC,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;iBAC9D,CAAC,CAAC;gBACH,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACvB,MAAM,CAAC,qBAAqB,CAAC,CAAC;oBAC9B,OAAO;gBACT,CAAC;gBACD,KAAK,GAAG,QAAkB,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YACrC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;YAClE,OAAO;QACT,CAAC;QAED,MAAM,aAAa,GAAG,OAAO,CAAC,EAAE,IAAI,KAAK,CAAC;QAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAO,CAAC;QAE/B,IAAI,KAAiB,CAAC;QACtB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,KAAK,GAAG,OAAO,CAAC;QAClB,CAAC;aAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,KAAK,GAAG,QAAQ,CAAC;QACnB,CAAC;aAAM,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YAC3B,KAAK,GAAG,QAAQ,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC;gBAC5B,OAAO,EAAE,eAAe;gBACxB,OAAO,EAAE;oBACP,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;oBACpC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;iBACnC;aACF,CAAC,CAAC;YACH,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,qBAAqB,CAAC,CAAC;gBAC9B,OAAO;YACT,CAAC;YACD,KAAK,GAAG,QAAsB,CAAC;QACjC,CAAC;QAED,MAAM,WAAW,GACf,KAAK,KAAK,QAAQ;YAChB,CAAC,CAAC,MAAM,CAAC,cAAc;YACvB,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC;gBACrC,CAAC,CAAC,MAAM,CAAC,aAAa;gBACtB,CAAC,CAAC,KAAK,MAAM,CAAC,aAAa,EAAE,CAAC;QAEpC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,aAAa,EAAE,CAAC,CAAC;QAE3D,MAAM,SAAS,CAAC,aAAa,EAAE;YAC7B,EAAE,EAAE,SAAS,CAAC,EAAE;YAChB,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,OAAO;YAC9B,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG;YACtB,KAAK;YACL,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,SAAS,EAAE;gBACT,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;oBACnB,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;wBACjB,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;oBAClE,CAAC;gBACH,CAAC;gBACD,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;oBAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;wBACrC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;oBAC1C,CAAC;gBACH,CAAC;aACF;SACF,CAAC,CAAC;QAEH,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC;YACzB,OAAO,EAAE,yBAAyB,aAAa,OAAO,WAAW,EAAE;YACnE,GAAG,EAAE,8BAA8B,aAAa,OAAO,WAAW,EAAE;SACrE,CAAC,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEL,KAAK;SACF,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CAAC,uCAAuC,CAAC;SACpD,MAAM,CAAC,gBAAgB,EAAE,iCAAiC,CAAC;SAC3D,MAAM,CAAC,SAAS,EAAE,0CAA0C,CAAC;SAC7D,MAAM,CAAC,UAAU,EAAE,+CAA+C,CAAC;SACnE,MAAM,CAAC,SAAS,EAAE,4CAA4C,CAAC;SAC/D,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QAClC,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,wBAAwB,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAEtE,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACpC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,IAAI,KAAK,GAAuB,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC;QAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC;gBAC5B,OAAO,EAAE,8BAA8B;gBACvC,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;aAC9D,CAAC,CAAC;YACH,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,qBAAqB,CAAC,CAAC;gBAC9B,OAAO;YACT,CAAC;YACD,KAAK,GAAG,QAAkB,CAAC;QAC7B,CAAC;QAED,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YACrC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;YAClE,OAAO;QACT,CAAC;QAED,MAAM,aAAa,GAAG,OAAO,CAAC,EAAE,IAAI,KAAK,CAAC;QAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAO,CAAC;QAE/B,IAAI,KAA6B,CAAC;QAClC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,KAAK,GAAG,OAAO,CAAC;QAClB,CAAC;aAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,KAAK,GAAG,QAAQ,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC;gBAC5B,OAAO,EAAE,eAAe;gBACxB,OAAO,EAAE;oBACP,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;oBACpC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;iBACnC;aACF,CAAC,CAAC;YACH,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,qBAAqB,CAAC,CAAC;gBAC9B,OAAO;YACT,CAAC;YACD,KAAK,GAAG,QAAsB,CAAC;QACjC,CAAC;QAED,MAAM,WAAW,GACf,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAEpE,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,aAAa,EAAE,CAAC,CAAC;QAE7D,IAAI,UAA8B,CAAC;QACnC,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,WAAW,CAAC,aAAa,EAAE;YAC/B,EAAE,EAAE,SAAS,CAAC,EAAE;YAChB,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,OAAO;YAC9B,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG;YACtB,KAAK;YACL,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;YAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,SAAS,EAAE;gBACT,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;oBACnB,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;wBACjB,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;oBAClE,CAAC;gBACH,CAAC;gBACD,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;oBAC/B,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;oBAChC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;oBAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;wBACrC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;oBAC1C,CAAC;gBACH,CAAC;aACF;SACF,CAAC,CAAC;QAEH,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC;gBACzB,OAAO,EAAE,+BAA+B,aAAa,OAAO,WAAW,EAAE;gBACzE,GAAG,EAAE,oCAAoC,aAAa,OAAO,WAAW,EAAE;aAC3E,CAAC,CAAC;YACH,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC;gBACzB,OAAO,EAAE,+BAA+B,aAAa,OAAO,WAAW,EAAE;gBACzE,GAAG,EAAE,oCAAoC,aAAa,OAAO,WAAW,EAAE;aAC3E,CAAC,CAAC;YACH,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,UAAU,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBACvD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,SAAS,CAAC,MAAM,CAAC,IAAI,CACnB,uBAAuB,aAAa,OAAO,WAAW,oCAAoC,CAC3F,CAAC;oBACF,OAAO;gBACT,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,mCAAmC;YACrC,CAAC;QACH,CAAC;QAED,SAAS,CAAC,MAAM,CAAC,IAAI,CACnB,gCAAgC,aAAa,OAAO,WAAW,GAAG,CACnE,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/spawn.d.ts

@@ -0,0 +1,17 @@
+import type { Command } from "commander";
+import type { CliContainer } from "../container.js";
+import { type CommandFlags, type ExecutionResources } from "./shared.js";
+import type { SpawnCommandOptions } from "../../providers/spawn-options.js";
+export interface CustomSpawnHandlerContext {
+    container: CliContainer;
+    service: string;
+    options: SpawnCommandOptions;
+    flags: CommandFlags;
+    resources: ExecutionResources;
+}
+export type CustomSpawnHandler = (context: CustomSpawnHandlerContext) => Promise<void>;
+export interface RegisterSpawnCommandOptions {
+    handlers?: Record<string, CustomSpawnHandler>;
+    extraServices?: string[];
+}
+export declare function registerSpawnCommand(program: Command, container: CliContainer, options?: RegisterSpawnCommandOptions): void;

package/dist/cli/commands/spawn.js

@@ -0,0 +1,226 @@
+import path from "node:path";
+import { renderAcpStream, spawnInteractive, getSpawnConfig } from "@poe-code/agent-spawn";
+import { allAgents, resolveAgentId } from "@poe-code/agent-defs";
+import { text } from "@poe-code/design-system";
+import { createExecutionResources, resolveCommandFlags, resolveServiceAdapter, formatServiceList } from "./shared.js";
+import { spawnCore } from "../../sdk/spawn-core.js";
+import { spawn as spawnSdk } from "../../sdk/spawn.js";
+export function registerSpawnCommand(program, container, options = {}) {
+    const spawnServices = container.registry
+        .list()
+        .filter((service) => typeof service.spawn === "function")
+        .map((service) => service.name);
+    const extraServices = options.extraServices ?? [];
+    const serviceList = [...spawnServices, ...extraServices];
+    const serviceDescription = `Agent to spawn${formatServiceList(serviceList)}`;
+    program
+        .command("spawn")
+        .description("Run a single prompt through a configured agent CLI.")
+        .option("--model <model>", "Model identifier override passed to the agent CLI")
+        .option("-C, --cwd <path>", "Working directory for the agent CLI")
+        .option("--stdin", "Read the prompt from stdin")
+        .option("-i, --interactive", "Launch the agent in interactive TUI mode")
+        .argument("<agent>", serviceDescription)
+        .argument("[prompt]", "Prompt text to send (or '-' / stdin)")
+        .argument("[agentArgs...]", "Additional arguments forwarded to the agent CLI")
+        .action(async function (service, promptText, agentArgs = []) {
+        const flags = resolveCommandFlags(program);
+        const commandOptions = this.opts();
+        const cwdOverride = resolveSpawnWorkingDirectory(container.env.cwd, commandOptions.cwd);
+        const wantsStdinFlag = commandOptions.stdin === true;
+        const shouldReadFromStdin = wantsStdinFlag ||
+            promptText === "-" ||
+            (!promptText && !process.stdin.isTTY);
+        const forwardedArgs = wantsStdinFlag
+            ? [...(promptText ? [promptText] : []), ...agentArgs]
+            : agentArgs;
+        if (wantsStdinFlag) {
+            promptText = undefined;
+        }
+        if (promptText === "-") {
+            promptText = undefined;
+        }
+        if (commandOptions.interactive) {
+            const adapter = resolveServiceAdapter(container, service);
+            const result = await spawnInteractive(adapter.name, {
+                prompt: promptText ?? "",
+                args: forwardedArgs,
+                model: commandOptions.model,
+                cwd: cwdOverride
+            });
+            process.exitCode = result.exitCode;
+            return;
+        }
+        if (!promptText && shouldReadFromStdin) {
+            const chunks = [];
+            for await (const chunk of process.stdin) {
+                chunks.push(chunk);
+            }
+            promptText = Buffer.concat(chunks).toString("utf8").trim();
+        }
+        if (!promptText) {
+            throw new Error("No prompt provided via argument or stdin");
+        }
+        const spawnOptions = {
+            prompt: promptText,
+            args: forwardedArgs,
+            model: commandOptions.model,
+            cwd: cwdOverride,
+            useStdin: shouldReadFromStdin
+        };
+        // Check for custom handlers first
+        const directHandler = options.handlers?.[service];
+        if (directHandler) {
+            const resources = createExecutionResources(container, flags, `spawn:${service}`);
+            resources.logger.intro(`spawn ${service}`);
+            await directHandler({
+                container,
+                service,
+                options: spawnOptions,
+                flags,
+                resources
+            });
+            resources.context.finalize();
+            return;
+        }
+        const adapter = resolveServiceAdapter(container, service);
+        const canonicalService = adapter.name;
+        const resources = createExecutionResources(container, flags, `spawn:${canonicalService}`);
+        resources.logger.intro(`spawn ${canonicalService}`);
+        const canonicalHandler = options.handlers?.[canonicalService];
+        if (canonicalHandler) {
+            try {
+                await canonicalHandler({
+                    container,
+                    service: canonicalService,
+                    options: spawnOptions,
+                    flags,
+                    resources
+                });
+                return;
+            }
+            finally {
+                resources.context.finalize();
+            }
+        }
+        try {
+            if (flags.dryRun) {
+                // spawnCore already logs the dry run details.
+                await spawnCore(container, canonicalService, spawnOptions, {
+                    dryRun: true,
+                    verbose: flags.verbose
+                });
+                return;
+            }
+            const { events, result } = spawnSdk(canonicalService, {
+                prompt: spawnOptions.prompt,
+                args: spawnOptions.args,
+                model: spawnOptions.model,
+                cwd: spawnOptions.cwd
+            });
+            await renderAcpStream(events);
+            const final = await result;
+            if (final.exitCode !== 0) {
+                const detail = final.stderr.trim() || final.stdout.trim();
+                const suffix = detail ? `: ${detail}` : "";
+                throw new Error(`${adapter.label} spawn failed with exit code ${final.exitCode}${suffix}`);
+            }
+            const trimmedStdout = final.stdout.trim();
+            if (trimmedStdout) {
+                resources.logger.info(trimmedStdout);
+            }
+            else {
+                const trimmedStderr = final.stderr.trim();
+                if (trimmedStderr) {
+                    resources.logger.info(trimmedStderr);
+                }
+                else {
+                    resources.logger.info(`${adapter.label} spawn completed.`);
+                }
+            }
+            if (final.threadId) {
+                const spawnConfig = getSpawnConfig(canonicalService);
+                if (spawnConfig?.kind === "cli" && spawnConfig.resumeCommand) {
+                    const resolvedId = resolveAgentId(canonicalService) ?? canonicalService;
+                    const agentDefinition = allAgents.find((agent) => agent.id === resolvedId);
+                    const binaryName = agentDefinition?.binaryName;
+                    if (binaryName) {
+                        const resumeCwd = path.resolve(spawnOptions.cwd ?? process.cwd());
+                        const args = spawnConfig.resumeCommand(final.threadId, resumeCwd);
+                        const agentCommand = [binaryName, ...args.map(shlexQuote)].join(" ");
+                        const needsCdPrefix = !args.includes(resumeCwd);
+                        const resumeCommand = needsCdPrefix
+                            ? `cd ${shlexQuote(resumeCwd)} && ${agentCommand}`
+                            : agentCommand;
+                        resources.logger.info(text.muted(`\nResume: ${resumeCommand}`));
+                    }
+                }
+            }
+        }
+        finally {
+            resources.context.finalize();
+        }
+    });
+}
+function shlexQuote(value) {
+    if (value.length === 0) {
+        return "''";
+    }
+    let isSafe = true;
+    for (let index = 0; index < value.length; index += 1) {
+        if (!isSafeShellChar(value.charCodeAt(index))) {
+            isSafe = false;
+            break;
+        }
+    }
+    if (isSafe) {
+        return value;
+    }
+    let output = "'";
+    for (let index = 0; index < value.length; index += 1) {
+        const char = value[index];
+        if (char === "'") {
+            output += `'"'"'`;
+            continue;
+        }
+        output += char;
+    }
+    output += "'";
+    return output;
+}
+function isSafeShellChar(code) {
+    if (code >= 48 && code <= 57) {
+        return true;
+    }
+    if (code >= 65 && code <= 90) {
+        return true;
+    }
+    if (code >= 97 && code <= 122) {
+        return true;
+    }
+    switch (code) {
+        case 95: // _
+        case 64: // @
+        case 37: // %
+        case 43: // +
+        case 61: // =
+        case 58: // :
+        case 44: // ,
+        case 46: // .
+        case 47: // /
+        case 45: // -
+            return true;
+        default:
+            return false;
+    }
+}
+function resolveSpawnWorkingDirectory(baseDir, candidate) {
+    if (!candidate || candidate.trim().length === 0) {
+        return undefined;
+    }
+    if (path.isAbsolute(candidate)) {
+        return candidate;
+    }
+    return path.resolve(baseDir, candidate);
+}
+//# sourceMappingURL=spawn.js.map

package/dist/cli/commands/spawn.js.map

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

package/dist/cli/commands/test.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from "commander";
+import type { CliContainer } from "../container.js";
+export declare function registerTestCommand(program: Command, container: CliContainer): Command;
+export declare function executeTest(program: Command, container: CliContainer, service: string, options?: {
+    isolated?: boolean;
+    stdin?: boolean;
+    model?: string;
+}): Promise<void>;

package/dist/cli/commands/test.js

@@ -0,0 +1,124 @@
+import { buildProviderContext, createExecutionResources, resolveCommandFlags, resolveServiceAdapter, formatServiceList } from "./shared.js";
+import { resolveServiceArgument } from "./configure.js";
+import { resolveIsolatedEnvDetails } from "../isolated-env.js";
+import { formatCommandRunnerResult, stdoutMatchesExpected } from "../../utils/command-checks.js";
+export function registerTestCommand(program, container) {
+    const serviceNames = container.registry
+        .list()
+        .filter((service) => typeof service.test === "function")
+        .map((service) => service.name);
+    const serviceDescription = `Agent to test${formatServiceList(serviceNames)}`;
+    return program
+        .command("test")
+        .description("Run agent health checks.")
+        .option("--stdin", "Verify stdin prompt support via spawn")
+        .option("--model <model>", "Model identifier override (requires --stdin)")
+        .argument("[agent]", serviceDescription)
+        .option("--isolated", "Run the health check using isolated configuration.")
+        .action(async function (service) {
+        const resolved = await resolveServiceArgument(program, container, service, { action: "test" });
+        const opts = this.opts();
+        await executeTest(this, container, resolved, {
+            isolated: Boolean(opts.isolated),
+            stdin: Boolean(opts.stdin),
+            model: opts.model
+        });
+    });
+}
+export async function executeTest(program, container, service, options = {}) {
+    const adapter = resolveServiceAdapter(container, service);
+    const canonicalService = adapter.name;
+    const flags = resolveCommandFlags(program);
+    const resources = createExecutionResources(container, flags, `test:${canonicalService}`);
+    resources.logger.intro(`test ${canonicalService}`);
+    const providerContext = buildProviderContext(container, adapter, resources);
+    if (options.model && !options.stdin) {
+        throw new Error("The --model option requires --stdin.");
+    }
+    const isolatedDetails = options.isolated && adapter.isolatedEnv
+        ? await resolveIsolatedEnvDetails(container.env, adapter.isolatedEnv, adapter.name, container.fs)
+        : null;
+    if (options.isolated && adapter.isolatedEnv) {
+        const { ensureIsolatedConfigForService } = await import("./ensure-isolated-config.js");
+        await ensureIsolatedConfigForService({
+            container,
+            adapter,
+            service: canonicalService,
+            flags
+        });
+    }
+    if (options.stdin) {
+        if (!adapter.supportsStdinPrompt) {
+            throw new Error(`${adapter.label} does not support stdin prompts.`);
+        }
+        if (flags.dryRun) {
+            resources.context.complete({
+                success: `Tested ${adapter.label}.`,
+                dry: `Dry run: would run a stdin spawn test for ${adapter.label}.`
+            });
+            return;
+        }
+        const expectedOutput = "STDIN_OK";
+        const prompt = `Output exactly: ${expectedOutput}`;
+        const result = (await container.registry.invoke(canonicalService, "spawn", async (entry) => {
+            if (!entry.spawn) {
+                throw new Error(`Agent "${canonicalService}" does not support spawn.`);
+            }
+            const output = await entry.spawn(providerContext, {
+                prompt,
+                useStdin: true,
+                model: options.model
+            });
+            return output;
+        }));
+        if (!result) {
+            throw new Error(`Stdin spawn test for ${adapter.label} did not return command output.`);
+        }
+        if (result.exitCode !== 0) {
+            throw new Error([
+                `Stdin spawn test for ${adapter.label} failed with exit code ${result.exitCode}.`,
+                formatCommandRunnerResult(result)
+            ].join("\n"));
+        }
+        if (!stdoutMatchesExpected(result.stdout, expectedOutput)) {
+            throw new Error([
+                `Stdin spawn test for ${adapter.label} failed: expected "${expectedOutput}" but received "${result.stdout.trim()}".`,
+                formatCommandRunnerResult(result)
+            ].join("\n"));
+        }
+    }
+    else {
+        await container.registry.invoke(canonicalService, "test", async (entry) => {
+            if (!entry.test) {
+                throw new Error(`Agent "${canonicalService}" does not support test.`);
+            }
+            const activeContext = isolatedDetails
+                ? {
+                    ...providerContext,
+                    runCheck: async (check) => {
+                        await check.run({
+                            isDryRun: providerContext.logger.context.dryRun,
+                            runCommand: (command, args) => resources.context.runCommand("poe-code", [
+                                "wrap",
+                                canonicalService,
+                                "--",
+                                ...args
+                            ]),
+                            logDryRun: (message) => providerContext.logger.dryRun(message)
+                        });
+                    }
+                }
+                : providerContext;
+            await entry.test(activeContext);
+        });
+    }
+    const dryMessage = canonicalService === "claude-code"
+        ? `${adapter.label} test (dry run)`
+        : `Dry run: would test ${adapter.label}.`;
+    resources.context.complete({
+        success: `Tested ${adapter.label}.`,
+        dry: dryMessage
+    });
+    resources.context.finalize();
+}
+//# sourceMappingURL=test.js.map

package/dist/cli/commands/test.js.map

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