poe-code 3.0.184 → 3.0.186

package/packages/agent-skill-config/dist/templates/poe-generate.md

@@ -0,0 +1,47 @@
+---
+name: poe-generate
+description: 'Poe code generation skill'
+---
+
+# poe-code generate
+
+Use `poe-code generate` to create text, images, audio, or video via the Poe API.
+
+## Text generation
+
+```bash
+poe-code generate "Write a short function that parses a JSON string safely."
+```
+
+Specify the model/bot:
+
+```bash
+# CLI option
+poe-code generate --model "gpt-4.1" "Summarize this codebase change."
+
+# Some agent runtimes call the model selector `--bot`
+poe-code generate --bot "gpt-4.1" "Summarize this codebase change."
+```
+
+## Media generation
+
+The CLI supports media generation as subcommands:
+
+```bash
+poe-code generate image "A 3D render of a rubber duck wearing sunglasses" --model "gpt-image-1" -o duck.png
+poe-code generate video "A cinematic timelapse of a city at night" --model "veo" -o city.mp4
+poe-code generate audio "A calm 10 second lo-fi beat" --model "audio-model" -o beat.wav
+```
+
+Some agent runtimes expose the same media types as flags. If available, these are equivalent:
+
+```bash
+poe-code generate --image "A 3D render of a rubber duck wearing sunglasses" --bot "gpt-image-1" -o duck.png
+poe-code generate --video "A cinematic timelapse of a city at night" --bot "veo" -o city.mp4
+poe-code generate --audio "A calm 10 second lo-fi beat" --bot "audio-model" -o beat.wav
+```
+
+## Tips
+
+- Use `--param key=value` to pass provider/model parameters (repeatable).
+- Use `--output <path>` (or `-o`) for media outputs.

package/packages/agent-skill-config/dist/templates/terminal-pilot.md

@@ -0,0 +1,45 @@
+---
+name: terminal-pilot
+description: 'Terminal automation skill using the terminal-pilot CLI'
+---
+
+# Terminal Pilot
+
+Use the `terminal-pilot` CLI when you need to automate or inspect interactive
+CLI applications through a real PTY session.
+
+## Commands
+
+- `terminal-pilot create-session` - start a PTY-backed command
+- `terminal-pilot fill` - paste text into a session
+- `terminal-pilot type` - type character-by-character for TUIs and readline
+- `terminal-pilot press-key` - send named keys such as `Enter` or `ArrowDown`
+- `terminal-pilot wait-for` - wait for terminal output to match a pattern
+- `terminal-pilot wait-for-exit` - block until a session exits
+- `terminal-pilot read-screen` - inspect the current visible terminal screen
+- `terminal-pilot read-history` - read scrollback output
+- `terminal-pilot list-sessions` - list active sessions
+- `terminal-pilot close-session` - close a session and return its exit code
+
+## Examples
+
+```bash
+terminal-pilot --help
+terminal-pilot create-session --help
+terminal-pilot read-screen --help
+```
+
+Use JSON output when another tool or script needs to read the result:
+
+```bash
+terminal-pilot list-sessions --output json
+terminal-pilot read-screen --session s1 --output json
+```
+
+## Tips
+
+- Use `fill` for pasted text and multi-line input.
+- Use `type` when the app reacts to individual keystrokes.
+- Use `press-key` for Enter, Tab, arrow keys, Escape, and control-key chords.
+- Use `wait-for --literal` for exact string matching.
+- Default terminal size is 120x40.

package/packages/agent-skill-config/dist/templates.d.ts

@@ -0,0 +1,3 @@
+import type { TemplateLoader } from "../../config-mutations/dist/index.js";
+export declare function loadTemplate(templateId: string): Promise<string>;
+export declare function createTemplateLoader(): TemplateLoader;

package/packages/agent-skill-config/dist/templates.js

@@ -0,0 +1,63 @@
+import { readFile, stat } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const TEMPLATE_IDS = ["poe-generate.md", "terminal-pilot.md"];
+const cache = new Map();
+async function pathExists(target) {
+    try {
+        await stat(target);
+        return true;
+    }
+    catch (error) {
+        if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+async function findPackageRoot(entryFilePath) {
+    let current = path.dirname(entryFilePath);
+    while (true) {
+        if (await pathExists(path.join(current, "package.json"))) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            throw new Error("Unable to locate package root for agent-skill-config templates.");
+        }
+        current = parent;
+    }
+}
+async function resolveTemplatePath(templateId) {
+    const packageRoot = await findPackageRoot(fileURLToPath(import.meta.url));
+    const candidates = [
+        path.join(packageRoot, "src", "templates", templateId),
+        path.join(packageRoot, "dist", "templates", templateId),
+        path.join(packageRoot, "dist", "templates", "skill", templateId)
+    ];
+    for (const candidate of candidates) {
+        if (await pathExists(candidate)) {
+            return candidate;
+        }
+    }
+    throw new Error(`Template not found: ${templateId}`);
+}
+function isKnownTemplate(templateId) {
+    return TEMPLATE_IDS.includes(templateId);
+}
+export async function loadTemplate(templateId) {
+    if (!isKnownTemplate(templateId)) {
+        throw new Error(`Template not found: ${templateId}`);
+    }
+    const cached = cache.get(templateId);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const resolved = await resolveTemplatePath(templateId);
+    const content = await readFile(resolved, "utf8");
+    cache.set(templateId, content);
+    return content;
+}
+export function createTemplateLoader() {
+    return loadTemplate;
+}

package/packages/agent-skill-config/dist/types.d.ts

@@ -0,0 +1,16 @@
+import type { FileSystem, MutationObservers } from "../../config-mutations/dist/index.js";
+import type { SkillScope } from "./configs.js";
+export interface ApplyOptions {
+    fs: FileSystem;
+    homeDir: string;
+    cwd: string;
+    scope?: SkillScope;
+    dryRun?: boolean;
+    observers?: MutationObservers;
+}
+export interface SkillFile {
+    /** Skill folder name */
+    name: string;
+    /** Content to write to SKILL.md */
+    content: string;
+}

package/packages/agent-skill-config/dist/types.js

@@ -0,0 +1 @@
+export {};

package/packages/cmdkit/dist/cli.js

@@ -1276,8 +1276,13 @@ function createOption(field) {
     if (collidesWithGlobalFlag) {
       return [createCommanderOption(flags, field.description, field)];
     }
+    const mainOption = createCommanderOption(`${flags} [value]`, field.description, field);
+    mainOption.preset(true);
+    mainOption.argParser(
+      (value) => typeof value === "boolean" ? value : parseBooleanText(value, field.displayPath)
+    );
     return [
-      createCommanderOption(flags, field.description, field),
+      mainOption,
       createCommanderOption(`--no-${field.optionFlag.slice(2)}`, field.description, field)
     ];
   }
@@ -1395,7 +1400,7 @@ function formatHelpFieldFlags(field) {
     return formatPositionalToken(field);
   }
   if (field.schema.kind === "boolean") {
-    return formatOptionFlags(field);
+    return `${formatOptionFlags(field)} [value]`;
   }
   return `${formatOptionFlags(field)} <${describeSchemaType(field.schema)}>`;
 }