agent-afk 5.26.1 → 5.26.3

package/dist/agent/ask-question-gate.d.ts

@@ -0,0 +1,7 @@
+import type { HookContext, HookDecision } from './hooks.js';
+export declare const ASK_QUESTION_GATE_REASON: string;
+export interface AskQuestionGateOptions {
+    hasHandler?: () => boolean;
+    notify?: (message: string) => void;
+}
+export declare function createAskQuestionGate(options?: AskQuestionGateOptions): (context: HookContext) => HookDecision;

package/dist/agent/elicitation-router.d.ts

@@ -8,6 +8,7 @@ declare class ElicitationRouter {
     private queueDepth;
     install(handler: ElicitationHandler): void;
     uninstall(): void;
+    hasHandler(): boolean;
     pendingCount(): number;
     route(request: ElicitationRequest, options: {
         signal: AbortSignal;

package/dist/agent/providers/anthropic-direct/loop.test-helpers.d.ts

@@ -0,0 +1,23 @@
+import type { RawMessageStreamEvent } from '@anthropic-ai/sdk/resources';
+import type { ProviderEvent } from '../../provider.js';
+import type { AnthropicClientLike, ToolDispatcherLike, ToolCall, ToolResult, TranslateCtx } from './types.js';
+export declare function fromArray<T>(arr: T[]): AsyncIterable<T>;
+export declare function collect(gen: AsyncGenerator<ProviderEvent>): Promise<ProviderEvent[]>;
+export declare const SESSION_ID = "sess_loop_test";
+export declare const ctx: TranslateCtx;
+export declare function baseUsage(): {
+    input_tokens: number;
+    output_tokens: number;
+    cache_creation_input_tokens: number;
+    cache_read_input_tokens: number;
+};
+export declare function makeTextStream(text: string, stopReason?: string): RawMessageStreamEvent[];
+export declare function makeToolUseStream(toolId: string, toolName: string, inputJson: string): RawMessageStreamEvent[];
+export declare function makeMultiToolUseStream(tools: Array<{
+    id: string;
+    name: string;
+    input: string;
+}>): RawMessageStreamEvent[];
+export declare function makeClient(streamFactory: () => AsyncIterable<RawMessageStreamEvent>): AnthropicClientLike;
+export declare function makeDispatcher(executeFn: (call: ToolCall) => Promise<ToolResult>): ToolDispatcherLike;
+export declare function makeBatchDispatcher(executeBatchFn: (calls: ToolCall[]) => Promise<ToolResult[]>): ToolDispatcherLike;

package/dist/bundled-plugins/awa-bundled/skills/diagnose/SKILL.md

@@ -0,0 +1,11 @@
+---
+name: diagnose
+description: "Parallel root-cause analysis for bugs and failing tests. Use when a test fails, a bug is reported, or behavior is unexplained — dispatches sub-agents to form and validate hypotheses in isolated worktrees."
+context: fork
+---
+
+Gather context: read the failing test or bug description, relevant error output, and recent git changes. If no failing test exists yet, write a minimal reproducer test (or identify a concrete verification command) before proceeding — hypotheses need a pass/fail signal to validate against. Dispatch two sub-agents in parallel — one to search the codebase for code paths involved in the failure (`subagent_type: research-agent`, read-only), and one to check recent commits and diffs that could have introduced the regression (`subagent_type: general-purpose` — requires Bash for `git log`/`git diff`/`git show`). When both return, synthesize findings into 2–4 ranked hypotheses, each with a specific code location and proposed cause.
+
+For each hypothesis, first create a dedicated git worktree with the `worktree` tool (`action: "create"`, one per hypothesis), then dispatch a sub-agent with its `cwd` set to that worktree's absolute path. This is how afk isolates a sub-agent to its own tree — the `agent` tool has NO `isolation` parameter, so parallel agents that omit `cwd` all inherit the same working tree and would contaminate each other's speculative fixes and test runs, invalidating the pass/fail attribution. Each sub-agent applies a minimal speculative fix, runs the test or verification command, then runs the broader related test suite to check for regressions. Run all hypothesis-testing agents in parallel, each in its own worktree; after collecting a result, remove that worktree with the `worktree` tool (`action: "remove"`). Collect results: which fixes passed, which didn't, and any regressions surfaced by the broader suite.
+
+Report the validated root cause (the hypothesis whose fix passed), the speculative fix diff, and regression status from the broader test run. If no hypothesis passes, synthesize what was learned and form a second round of hypotheses. If the user approves the fix, apply it to the main worktree.

package/dist/cli/commands/skill-router.d.ts

@@ -1,6 +1,5 @@
 import type { IAgentSession } from '../../agent/types.js';
 import '../../skills/mint/index.js';
-import '../../skills/diagnose/index.js';
 export interface RouteResult {
     handled: true;
     output: string;

package/dist/cli/slash/plugin-skills/dispatch.d.ts

@@ -0,0 +1,10 @@
+import type { AgentSession } from '../../../agent/session.js';
+import type { SlashCommand } from '../types.js';
+import { type DiscoveredSkill } from './state.js';
+export declare function makeForwardHandler(skill: DiscoveredSkill, flags?: readonly string[]): SlashCommand;
+export declare function registerPluginSkills(session: AgentSession): Promise<number | null>;
+export declare function getPluginShadowingNoticeLines(): string[];
+export declare function autoRegisterPluginPassthroughs(session: AgentSession): Promise<{
+    skillCount: number | null;
+    agentCount: number | null;
+}>;

package/dist/cli/slash/plugin-skills/flags.d.ts

@@ -0,0 +1,3 @@
+export declare function harvestPluginSkillFlags(cacheRoot?: string): Map<string, string[]>;
+export declare function harvestAllPluginSkillFlags(): Map<string, string[]>;
+export declare function extractHintFromDescription(description: string): string | undefined;

package/dist/cli/slash/plugin-skills/listing.d.ts

@@ -0,0 +1,4 @@
+import type { SlashCommand } from '../types.js';
+import { type DiscoveredSkill } from './state.js';
+export declare const initialSkillsCmd: SlashCommand;
+export declare function makeDynamicSkillsCmd(plugins: DiscoveredSkill[]): SlashCommand;

package/dist/cli/slash/plugin-skills/reload.d.ts

@@ -0,0 +1,14 @@
+import { type SkillManifestEntry } from '../../../agent/tools/skill-bridge.js';
+import { type InstalledPlugin } from '../../../agent/plugins/inventory.js';
+import type { SlashCommand } from '../types.js';
+export declare function buildSourceBreakdown(entries: SkillManifestEntry[]): string;
+export declare function computeSkillDelta(prev: ReadonlySet<string>, next: ReadonlySet<string>): {
+    added: string[];
+    removed: string[];
+} | null;
+export declare function formatSkillDelta(delta: {
+    added: string[];
+    removed: string[];
+}): string;
+export declare function buildPluginRows(plugins: InstalledPlugin[]): string[];
+export declare const reloadPluginsCmd: SlashCommand;

package/dist/cli/slash/plugin-skills/state.d.ts

@@ -0,0 +1,18 @@
+export interface DiscoveredSkill {
+    name: string;
+    description: string;
+    argumentHint?: string;
+}
+export interface PluginCollision {
+    bare: string;
+    altSlash: string;
+    altDescription: string;
+}
+export interface PluginSkillsState {
+    discovered: DiscoveredSkill[];
+    collisions: PluginCollision[];
+    shadowedBareNames: Set<string>;
+}
+export declare let state: PluginSkillsState;
+export declare function setState(next: PluginSkillsState): void;
+export declare function bareName(name: string): string;

package/dist/cli/slash/plugin-skills.d.ts

@@ -1,32 +1,5 @@
-import type { AgentSession } from '../../agent/session.js';
-import { type SkillManifestEntry } from '../../agent/tools/skill-bridge.js';
-import { type InstalledPlugin } from '../../agent/plugins/inventory.js';
-import type { SlashCommand } from './types.js';
-interface DiscoveredSkill {
-    name: string;
-    description: string;
-    argumentHint?: string;
-}
-export declare function harvestPluginSkillFlags(cacheRoot?: string): Map<string, string[]>;
-export declare function extractHintFromDescription(description: string): string | undefined;
-export declare function makeForwardHandler(skill: DiscoveredSkill, flags?: readonly string[]): SlashCommand;
-export declare const initialSkillsCmd: SlashCommand;
-export declare function registerPluginSkills(session: AgentSession): Promise<number | null>;
-export declare function getPluginShadowingNoticeLines(): string[];
-export declare function autoRegisterPluginPassthroughs(session: AgentSession): Promise<{
-    skillCount: number | null;
-    agentCount: number | null;
-}>;
-export declare function buildSourceBreakdown(entries: SkillManifestEntry[]): string;
-export declare function computeSkillDelta(prev: ReadonlySet<string>, next: ReadonlySet<string>): {
-    added: string[];
-    removed: string[];
-} | null;
-export declare function formatSkillDelta(delta: {
-    added: string[];
-    removed: string[];
-}): string;
-export declare function buildPluginRows(plugins: InstalledPlugin[]): string[];
-export declare const reloadPluginsCmd: SlashCommand;
+export { harvestPluginSkillFlags, extractHintFromDescription, } from './plugin-skills/flags.js';
+export { initialSkillsCmd } from './plugin-skills/listing.js';
+export { makeForwardHandler, registerPluginSkills, getPluginShadowingNoticeLines, autoRegisterPluginPassthroughs, } from './plugin-skills/dispatch.js';
+export { buildSourceBreakdown, computeSkillDelta, formatSkillDelta, buildPluginRows, reloadPluginsCmd, } from './plugin-skills/reload.js';
 export declare function registerStaticPluginSkillCommands(): void;
-export {};