agent.libx.js 0.94.19 → 0.94.21

package/dist/index.d.ts

@@ -590,6 +590,8 @@ interface SkillInfo {
  * adds the catalog + a convenience tool. (Executable skills can be `bash`-exec'd: wcli
  * runs JS files from the VFS as commands.)
  */
+/** Scan `dir`(s) for `<dir>/<id>/SKILL.md` entries (first dir wins on duplicate ids). */
+declare function scanSkills(fs: IFilesystem, dir: string | string[]): Promise<SkillInfo[]>;
 declare function loadSkills(fs: IFilesystem, dir: string | string[], opts?: {
     relevanceHint?: string;
     max?: number;
@@ -644,6 +646,8 @@ declare function expandCommand(fs: IFilesystem, cmd: CommandInfo, args: string):
  * VFS files. The template body is returned (user args appended, and `$ARGUMENTS`
  * substituted if present) so the model can act on it. Mirrors loadSkills.
  */
+/** Scan `dir`(s) for `<dir>/<name>.md` command templates (first dir wins on duplicate names). */
+declare function scanCommands(fs: IFilesystem, dir: string | string[]): Promise<CommandInfo[]>;
 declare function loadCommands(fs: IFilesystem, dir: string | string[], opts?: {
     relevanceHint?: string;
     max?: number;
@@ -1261,4 +1265,4 @@ declare class CartesiaTTS {
     close(): void;
 }
 
-export { Agent, type AgentDef, AgentOptions, AgentTool, type AskOptions, type Attempt, type AudioSink, type AudioSource, type AuthProvider, BodDbFilesystem, CartesiaTTS, CartesiaTTSOptions, ChatLike, ChatOptions, ChatResponse, type CommandInfo, ConsoleHostBridge, DEFAULT_DENY, DuplexAgent, DuplexAgentOptions, type DuplexTaskStatus, FakeAIClient, Hooks, HostBridge, JailOptions, JailedFilesystem, type LessonOptions, LessonOptionsDefaults, type LoadMemoryOpts, MEMORY_PROMPT, MessageContent, type Mount, MountFilesystem, NodeDiskFilesystem, OverlayFilesystem, type ReflectOptions, RunResult, SCRATCH_DIR, STT_SAMPLE_RATE, type ScheduledJob, type ScheduledJobSnapshot, Scheduler, type SchedulerOptions, Scratch, type ScratchOptions, ScriptedHostBridge, type SkillInfo, SonioxSTT, SonioxSTTOptions, type SttLike, TTS_SAMPLE_RATE, type TaskRecord, type TaskToolOptions, ToolCall, type ToolSpec, type Trigger, type TriggerCron, type TriggerInterval, type TriggerOneOff, type TtsLike, UserQuestion, VOICE_MEMORY_PROMPT, VOICE_SYSTEM_PROMPT, VoiceEngine, VoiceEngineOptions, type VoiceState, type WebFetchOptions, type WebSearchOptions, type WorkerTier, applyEditsTool, askUserQuestionTool, checkpointTool, checkpointTools, compileSynthesizedTool, cronMatches, decodeDdgUrl, diskAgentOptions, expandCommand, expandTemplate, forComponent, fullAgentOptions, globTool, grepTool, htmlToText, idfWeights, lessonCapture, loadAgents, loadCommands, loadInstructions, loadMemory, loadSkills, makeAskTool, makeScheduleTools, makeTaskBatchTool, makeTaskTool, makeWebFetchTool, makeWebSearchTool, mkdirp, multiEditTool, nextCronAfter, parseCron, parseDdgHtml, raceAttempts, reflectOnRun, relevanceScore, repoIndex, repoMapTool, resolveAuth, rollbackTool, sandboxAgentOptions, slugify, tokenize, toolCall, topByRelevance, validateToolCode, webFetchTool, webSearchTool, writeFact, writeTool };
+export { Agent, type AgentDef, AgentOptions, AgentTool, type AskOptions, type Attempt, type AudioSink, type AudioSource, type AuthProvider, BodDbFilesystem, CartesiaTTS, CartesiaTTSOptions, ChatLike, ChatOptions, ChatResponse, type CommandInfo, ConsoleHostBridge, DEFAULT_DENY, DuplexAgent, DuplexAgentOptions, type DuplexTaskStatus, FakeAIClient, Hooks, HostBridge, JailOptions, JailedFilesystem, type LessonOptions, LessonOptionsDefaults, type LoadMemoryOpts, MEMORY_PROMPT, MessageContent, type Mount, MountFilesystem, NodeDiskFilesystem, OverlayFilesystem, type ReflectOptions, RunResult, SCRATCH_DIR, STT_SAMPLE_RATE, type ScheduledJob, type ScheduledJobSnapshot, Scheduler, type SchedulerOptions, Scratch, type ScratchOptions, ScriptedHostBridge, type SkillInfo, SonioxSTT, SonioxSTTOptions, type SttLike, TTS_SAMPLE_RATE, type TaskRecord, type TaskToolOptions, ToolCall, type ToolSpec, type Trigger, type TriggerCron, type TriggerInterval, type TriggerOneOff, type TtsLike, UserQuestion, VOICE_MEMORY_PROMPT, VOICE_SYSTEM_PROMPT, VoiceEngine, VoiceEngineOptions, type VoiceState, type WebFetchOptions, type WebSearchOptions, type WorkerTier, applyEditsTool, askUserQuestionTool, checkpointTool, checkpointTools, compileSynthesizedTool, cronMatches, decodeDdgUrl, diskAgentOptions, expandCommand, expandTemplate, forComponent, fullAgentOptions, globTool, grepTool, htmlToText, idfWeights, lessonCapture, loadAgents, loadCommands, loadInstructions, loadMemory, loadSkills, makeAskTool, makeScheduleTools, makeTaskBatchTool, makeTaskTool, makeWebFetchTool, makeWebSearchTool, mkdirp, multiEditTool, nextCronAfter, parseCron, parseDdgHtml, raceAttempts, reflectOnRun, relevanceScore, repoIndex, repoMapTool, resolveAuth, rollbackTool, sandboxAgentOptions, scanCommands, scanSkills, slugify, tokenize, toolCall, topByRelevance, validateToolCode, webFetchTool, webSearchTool, writeFact, writeTool };

package/dist/index.js

@@ -1833,7 +1833,8 @@ var askUserQuestionTool = {
       const fallback = args.options?.[0]?.label ?? "";
       return `No interactive user is available \u2014 proceed using your best judgment.${fallback ? ` (Closest default: "${fallback}")` : ""}`;
     }
-    return ctx.host.ask(args);
+    const answer = ctx.host.ask(args);
+    return ctx.parkHuman ? ctx.parkHuman(answer) : answer;
   }
 };
 var ScriptedHostBridge = class {
@@ -1980,7 +1981,7 @@ function parseFrontmatter(md) {
   const b = block || md.slice(0, 600);
   return { name: grabField(b, "name"), description: grabField(b, "description") };
 }
-async function loadSkills(fs, dir, opts = {}) {
+async function scanSkills(fs, dir) {
   const skills = [];
   const seen = /* @__PURE__ */ new Set();
   for (const d of Array.isArray(dir) ? dir : [dir]) {
@@ -1995,6 +1996,10 @@ async function loadSkills(fs, dir, opts = {}) {
       }
     }
   }
+  return skills;
+}
+async function loadSkills(fs, dir, opts = {}) {
+  const skills = await scanSkills(fs, dir);
   if (skills.length === 0) return { skills, catalog: "" };
   const { kept, rest } = topByRelevance(skills, opts.relevanceHint ?? "", (s) => `${s.name} ${s.description}`, opts.max ?? MAX_CATALOG);
   const catalog = "## Skills (load one before acting on a matching task)\n" + kept.map((s) => `- **${s.name}** \u2014 ${s.description} (\`${s.path}\`)`).join("\n") + (rest.length ? `
@@ -2004,8 +2009,13 @@ async function loadSkills(fs, dir, opts = {}) {
     description: "Load a skill by name \u2014 returns its full instructions (SKILL.md). Use when a task matches a listed skill.",
     parameters: { type: "object", required: ["name"], properties: { name: { type: "string" } } },
     async run({ name }, ctx) {
-      const s = skills.find((x) => x.name === name);
-      if (!s) return `Error: no skill named '${name}'. Available: ${skills.map((x) => x.name).join(", ")}`;
+      let s = skills.find((x) => x.name === name);
+      if (!s) {
+        const fresh = await scanSkills(ctx.fs, dir);
+        s = fresh.find((x) => x.name === name);
+        if (!s) return `Error: no skill named '${name}'. Available: ${fresh.map((x) => x.name).join(", ")}`;
+        skills.push(s);
+      }
       return ctx.fs.readFile(s.path);
     }
   };
@@ -2046,7 +2056,7 @@ async function expandCommand(fs, cmd, args) {
   const { body } = parseFrontmatter2(await fs.readFile(cmd.path));
   return embedFiles(expandTemplate(body, args), fs);
 }
-async function loadCommands(fs, dir, opts = {}) {
+async function scanCommands(fs, dir) {
   const commands = [];
   const seen = /* @__PURE__ */ new Set();
   for (const d of Array.isArray(dir) ? dir : [dir]) {
@@ -2061,6 +2071,10 @@ async function loadCommands(fs, dir, opts = {}) {
       commands.push({ name, description: fm.description || "", path });
     }
   }
+  return commands;
+}
+async function loadCommands(fs, dir, opts = {}) {
+  const commands = await scanCommands(fs, dir);
   if (commands.length === 0) return { commands, catalog: "" };
   const { kept, rest } = topByRelevance(commands, opts.relevanceHint ?? "", (c) => `${c.name} ${c.description}`, opts.max ?? MAX_CATALOG2);
   const catalog = "## Slash commands (reusable prompt templates)\n" + kept.map((c) => `- **/${c.name}** \u2014 ${c.description} (\`${c.path}\`)`).join("\n") + (rest.length ? `
@@ -2075,8 +2089,13 @@ async function loadCommands(fs, dir, opts = {}) {
     },
     async run({ name, args }, ctx) {
       const slug2 = String(name ?? "").replace(/^\//, "");
-      const c = commands.find((x) => x.name === slug2);
-      if (!c) return `Error: no command named '${slug2}'. Available: ${commands.map((x) => x.name).join(", ")}`;
+      let c = commands.find((x) => x.name === slug2);
+      if (!c) {
+        const fresh = await scanCommands(ctx.fs, dir);
+        c = fresh.find((x) => x.name === slug2);
+        if (!c) return `Error: no command named '${slug2}'. Available: ${fresh.map((x) => x.name).join(", ")}`;
+        commands.push(c);
+      }
       return expandCommand(ctx.fs, c, String(args ?? ""));
     }
   };
@@ -5840,6 +5859,8 @@ export {
   resolveAuth,
   rollbackTool,
   sandboxAgentOptions,
+  scanCommands,
+  scanSkills,
   slugify,
   toWireTools,
   todoWriteTool,