@gencode/agents 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @gencode/agents
 
+## 0.2.0
+
+### Minor Changes
+
+- Add CLI support for loading additional absolute skill directories and pass them through run and resume flows into the agent skill registry.
+
+### Patch Changes
+
+- 059d077: Expose completed subagent results in status polling and delay delivery marking until parent announce handling succeeds.
+
+## 0.1.1
+
+### Patch Changes
+
+- 2908094: Preserve skill-loading correctness across context compaction by requiring explicit reloads when SKILL.md content is no longer visible.
+
 ## 0.1.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -162,7 +162,12 @@ type AgentRunParamsBase = {
     ownershipUid?: number | null; /** Optional tool allowlist for plugin tools */
     toolAllowlist?: string[]; /** Optional allowlist for plugin LLM access (plugin id or tool name) */
     llmAllowlist?: string[];
-  }; /** Memory system options (optional) */
+  };
+  /**
+   * Additional skill registry directories supplied by the CLI.
+   * Each directory contains skill child directories such as <dir>/<skill-name>/SKILL.md.
+   */
+  skillsLoadPaths?: string[]; /** Memory system options (optional) */
   memory?: {
     /** Explicit memory provider id (overrides plugins.slots.memory) */providerId?: string; /** Explicit plugin id for memory provider (used when providerId not set) */
     pluginId?: string; /** Whether memory replies should include source path/line hints */
@@ -278,7 +283,7 @@ declare const MAX_CHILDREN_PER_SESSION = 5;
  */
 declare class SubagentRegistry {
   private readonly entries;
-  /** RunIds that have already been returned by consumeCompleted */
+  /** RunIds whose terminal result has already been delivered to the parent. */
   private readonly announced;
   register(record: SubagentRunRecord, promise: Promise<void>): void;
   complete(runId: string, result: string): void;
@@ -298,13 +303,21 @@ declare class SubagentRegistry {
    * Returns immediately if nothing is pending.
    */
   waitForAll(parentSessionId: string): Promise<void>;
+  /**
+   * Returns all finished runs whose terminal result has not yet been delivered.
+   * This is a read-only snapshot; callers must explicitly mark delivery after
+   * the result has been handed back to the parent.
+   */
+  peekCompleted(parentSessionId: string): SubagentRunRecord[];
   /**
    * Returns all finished runs that have not yet been returned by this method,
    * and marks them as announced so they are not returned again.
    */
   consumeCompleted(parentSessionId: string): SubagentRunRecord[];
   /** Marks a finished run as already delivered to its parent. */
-  markAnnounced(runId: string): void;
+  markAnnounced(runId: string | string[]): void;
+  /** Returns whether a run's terminal result has already been delivered. */
+  isAnnounced(runId: string): boolean;
   /** Returns true if there are completed runs not yet returned by consumeCompleted. */
   hasUnannounced(parentSessionId: string): boolean;
   /**
@@ -1117,7 +1130,7 @@ type SkillViewResult = {
  * Returns at most MAX_SKILLS_IN_PROMPT skills.
  */
 declare function loadSkills(dataDir: string): Promise<Skill[]>;
-declare function loadSkillsWithPluginDirs(dataDir: string, pluginDirs: string[]): Promise<Skill[]>;
+declare function loadSkillsWithPluginDirs(dataDir: string, pluginDirs: string[], skillsLoadPaths?: string[]): Promise<Skill[]>;
 declare function loadSkillsFromDirs(dirs: string[]): Promise<Skill[]>;
 declare function findSkillByName(dirs: string[], requestedName: string): Promise<SkillDirectory | undefined>;
 declare function loadSkillView(dirs: string[], requestedName: string, skillPath?: string): Promise<SkillViewResult | undefined>;
@@ -1608,10 +1621,11 @@ type SkillLoadToolResult = {
 type SkillUsedReporter = (event: Extract<AgentProgressEvent$2, {
   type: "skill_used";
 }>) => Promise<void>;
-declare function createSkillListTool(dataDir: string, pluginDirs: string[]): AgentTool<typeof skillListSchema, SkillListResult>;
+declare function createSkillListTool(dataDir: string, pluginDirs: string[], skillsLoadPaths?: string[]): AgentTool<typeof skillListSchema, SkillListResult>;
 declare function createSkillLoadTool(params: {
   dataDir: string;
   pluginDirs: string[];
+  skillsLoadPaths?: string[];
   sessionId: string;
   reportSkillUsed?: SkillUsedReporter;
 }): AgentTool<typeof skillLoadSchema, SkillLoadToolResult>;
@@ -1673,11 +1687,12 @@ declare function buildSubagentAnnounceMessage(params: {
  * @param loopDetection  Tool-loop detection config inherited from the parent.
  * @param spawnFn  Function that actually runs a child agent (injected to avoid circular imports).
  */
-declare function createSubagentSpawnTool(registry: SubagentRegistry, parentSessionId: string, depth: number, dataDir: string, channel: AgentRunParams["channel"], llm: AgentRunParams["llm"], loopDetection: ToolLoopDetectionConfig | undefined, inheritedRunParams: Pick<AgentRunParams, "plugins" | "memory" | "messaging" | "historyLimit" | "onProgress" | "messageId" | "sessionStoreName">, spawnFn: (params: AgentRunParams) => Promise<AgentRunResult>): AgentTool<typeof spawnSchema, SpawnResult>;
+declare function createSubagentSpawnTool(registry: SubagentRegistry, parentSessionId: string, depth: number, dataDir: string, channel: AgentRunParams["channel"], llm: AgentRunParams["llm"], loopDetection: ToolLoopDetectionConfig | undefined, inheritedRunParams: Pick<AgentRunParams, "plugins" | "skillsLoadPaths" | "memory" | "messaging" | "historyLimit" | "onProgress" | "messageId" | "sessionStoreName">, spawnFn: (params: AgentRunParams) => Promise<AgentRunResult>): AgentTool<typeof spawnSchema, SpawnResult>;
 //#endregion
 //#region src/tools/subagents.d.ts
 declare const ACTIONS: readonly ["list", "kill"];
 type SubagentsAction = (typeof ACTIONS)[number];
+type SubagentDeliveryStatus = "running" | "pending" | "delivered";
 declare const subagentsSchema: TObject<{
   action: TUnion<[TLiteral<"list">, TLiteral<"kill">]>;
   target: TOptional<TString>;
@@ -1690,8 +1705,11 @@ type SubagentsResult = {
     label: string;
     task: string;
     status: string;
+    deliveryStatus: SubagentDeliveryStatus;
     depth: number;
     runtimeMs: number;
+    result?: string;
+    error?: string;
   }>;
   killed?: number;
   error?: string;
@@ -1781,10 +1799,11 @@ type SubagentToolsContext = {
   depth: number;
   channel: AgentRunParams["channel"];
   llm: AgentRunParams["llm"];
-  inheritedRunParams?: Pick<AgentRunParams, "plugins" | "memory" | "messaging" | "historyLimit" | "onProgress" | "messageId" | "sessionStoreName">;
+  inheritedRunParams?: Pick<AgentRunParams, "plugins" | "skillsLoadPaths" | "memory" | "messaging" | "historyLimit" | "onProgress" | "messageId" | "sessionStoreName">;
   loopDetection?: ToolLoopDetectionConfig;
   memoryOptions?: MemoryToolOptions;
   pluginSkillDirs?: string[];
+  skillsLoadPaths?: string[];
   reportSkillUsed?: (event: Extract<AgentProgressEvent$2, {
     type: "skill_used";
   }>) => Promise<void>;