bashkit 0.1.3 → 0.2.2

package/dist/skills/loader.d.ts

@@ -1,3 +1,4 @@
+import type { SkillBundle } from "./fetch";
 import type { SkillMetadata } from "./types";
 /**
  * Parses YAML frontmatter from a SKILL.md file content.
@@ -9,3 +10,38 @@ import type { SkillMetadata } from "./types";
  * @throws Error if required fields (name, description) are missing
  */
 export declare function parseSkillMetadata(content: string, skillPath: string): SkillMetadata;
+/**
+ * Loads all files from a local skill directory as a SkillBundle.
+ * Recursively reads all files, preserving directory structure.
+ *
+ * @param skillDir - Absolute path to skill directory (containing SKILL.md)
+ * @returns SkillBundle with all files
+ *
+ * @example
+ * ```typescript
+ * const bundle = await loadSkillBundle('/path/to/.skills/pdf-processing');
+ * // bundle.files = {
+ * //   'SKILL.md': '---\nname: pdf-processing\n...',
+ * //   'templates/report.md': '# Report Template...',
+ * //   'scripts/extract.sh': '#!/bin/bash...',
+ * // }
+ * ```
+ */
+export declare function loadSkillBundle(skillDir: string): Promise<SkillBundle>;
+/**
+ * Loads multiple discovered skills as bundles.
+ * Takes the output of discoverSkills() and loads all files for each skill.
+ *
+ * @param skills - Array of skill metadata from discoverSkills()
+ * @returns Record mapping skill names to their bundles
+ *
+ * @example
+ * ```typescript
+ * const discovered = await discoverSkills();
+ * const bundles = await loadSkillBundles(discovered);
+ *
+ * // Use with setupAgentEnvironment
+ * await setupAgentEnvironment(sandbox, { skills: bundles });
+ * ```
+ */
+export declare function loadSkillBundles(skills: SkillMetadata[]): Promise<Record<string, SkillBundle>>;

package/dist/tools/exit-plan-mode.d.ts

@@ -1,4 +1,3 @@
-import type { ToolConfig } from "../types";
 export interface ExitPlanModeOutput {
     message: string;
     approved?: boolean;
@@ -6,6 +5,6 @@ export interface ExitPlanModeOutput {
 export interface ExitPlanModeError {
     error: string;
 }
-export declare function createExitPlanModeTool(config?: ToolConfig, onPlanSubmit?: (plan: string) => Promise<boolean> | boolean): import("ai").Tool<{
+export declare function createExitPlanModeTool(onPlanSubmit?: (plan: string) => Promise<boolean> | boolean): import("ai").Tool<{
     plan: string;
 }, ExitPlanModeOutput | ExitPlanModeError>;

package/dist/tools/index.d.ts

@@ -69,9 +69,9 @@ export type { SubagentEventData, SubagentStepEvent, SubagentTypeConfig, TaskErro
 export { createTaskTool } from "./task";
 export type { TodoItem, TodoState, TodoWriteError, TodoWriteOutput, } from "./todo-write";
 export { createTodoWriteTool } from "./todo-write";
-export type { WebFetchError, WebFetchOutput, WebFetchToolConfig, } from "./web-fetch";
+export type { WebFetchError, WebFetchOutput } from "./web-fetch";
 export { createWebFetchTool } from "./web-fetch";
-export type { WebSearchError, WebSearchOutput, WebSearchResult, WebSearchToolConfig, } from "./web-search";
+export type { WebSearchError, WebSearchOutput, WebSearchResult, } from "./web-search";
 export { createWebSearchTool } from "./web-search";
 export type { WriteError, WriteOutput } from "./write";
 export { createWriteTool } from "./write";

package/dist/tools/task.d.ts

@@ -1,4 +1,5 @@
 import { type ModelMessage, type LanguageModel, type PrepareStepFunction, type StepResult, type StopCondition, type UIMessageStreamWriter, type Tool, type ToolSet } from "ai";
+import { z } from "zod";
 export interface TaskOutput {
     result: string;
     usage?: {
@@ -12,6 +13,14 @@ export interface TaskOutput {
 export interface TaskError {
     error: string;
 }
+declare const taskInputSchema: z.ZodObject<{
+    description: z.ZodString;
+    prompt: z.ZodString;
+    subagent_type: z.ZodString;
+    system_prompt: z.ZodOptional<z.ZodString>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type TaskInput = z.infer<typeof taskInputSchema>;
 /** Event emitted for each step a subagent takes */
 export interface SubagentStepEvent {
     subagentType: string;
@@ -55,4 +64,5 @@ export interface TaskToolConfig {
     /** Optional stream writer for real-time subagent activity (uses streamText instead of generateText) */
     streamWriter?: UIMessageStreamWriter;
 }
-export declare function createTaskTool(config: TaskToolConfig): Tool;
+export declare function createTaskTool(config: TaskToolConfig): Tool<TaskInput, TaskOutput | TaskError>;
+export {};

package/dist/tools/todo-write.d.ts

@@ -1,4 +1,3 @@
-import type { ToolConfig } from "../types";
 export interface TodoItem {
     content: string;
     status: "pending" | "in_progress" | "completed";
@@ -19,7 +18,7 @@ export interface TodoWriteError {
 export interface TodoState {
     todos: TodoItem[];
 }
-export declare function createTodoWriteTool(state: TodoState, config?: ToolConfig, onUpdate?: (todos: TodoItem[]) => void): import("ai").Tool<{
+export declare function createTodoWriteTool(state: TodoState, onUpdate?: (todos: TodoItem[]) => void): import("ai").Tool<{
     todos: {
         content: string;
         status: "pending" | "in_progress" | "completed";

package/dist/tools/web-constants.d.ts

@@ -0,0 +1,5 @@
+/**
+ * HTTP status codes that indicate a retryable error.
+ * Shared between web-search and web-fetch tools.
+ */
+export declare const RETRYABLE_STATUS_CODES: number[];

package/dist/tools/web-fetch.d.ts

@@ -1,4 +1,4 @@
-import type { LanguageModel } from "ai";
+import type { WebFetchConfig } from "../types";
 export interface WebFetchOutput {
     response: string;
     url: string;
@@ -10,11 +10,7 @@ export interface WebFetchError {
     status_code?: number;
     retryable?: boolean;
 }
-export interface WebFetchToolConfig {
-    apiKey: string;
-    model: LanguageModel;
-}
-export declare function createWebFetchTool(config: WebFetchToolConfig): import("ai").Tool<{
+export declare function createWebFetchTool(config: WebFetchConfig): import("ai").Tool<{
     url: string;
     prompt: string;
 }, WebFetchOutput | WebFetchError>;

package/dist/tools/web-search.d.ts

@@ -1,3 +1,4 @@
+import type { WebSearchConfig } from "../types";
 export interface WebSearchResult {
     title: string;
     url: string;
@@ -14,10 +15,7 @@ export interface WebSearchError {
     status_code?: number;
     retryable?: boolean;
 }
-export interface WebSearchToolConfig {
-    apiKey: string;
-}
-export declare function createWebSearchTool(config: WebSearchToolConfig): import("ai").Tool<{
+export declare function createWebSearchTool(config: WebSearchConfig): import("ai").Tool<{
     query: string;
     allowed_domains?: string[] | undefined;
     blocked_domains?: string[] | undefined;

package/dist/types.d.ts

@@ -1,23 +1,37 @@
-import type { LanguageModel } from "ai";
+import type { LanguageModel, Tool } from "ai";
+import type { CacheStore } from "./cache/types";
 import type { SkillMetadata } from "./skills/types";
+/**
+ * SDK tool options picked from the Tool type.
+ * This automatically adapts to the user's installed AI SDK version.
+ * - v5 users get v5 options (if any)
+ * - v6 users get v6 options (needsApproval, strict, etc.)
+ *
+ * Uses `any` for input/output to allow typed needsApproval functions.
+ */
+export type SDKToolOptions = Partial<Pick<Tool<any, any>, "strict" | "needsApproval" | "providerOptions">>;
+/**
+ * Configuration for sandbox-based tools.
+ * Extends AI SDK tool options for version-appropriate type safety.
+ */
 export type ToolConfig = {
     timeout?: number;
     maxFileSize?: number;
     maxOutputLength?: number;
     allowedPaths?: string[];
     blockedCommands?: string[];
-};
+} & SDKToolOptions;
 export type GrepToolConfig = ToolConfig & {
     /** Use ripgrep (rg) instead of grep. Requires ripgrep to be installed. Default: false */
     useRipgrep?: boolean;
 };
 export type WebSearchConfig = {
     apiKey: string;
-};
+} & SDKToolOptions;
 export type WebFetchConfig = {
     apiKey: string;
     model: LanguageModel;
-};
+} & SDKToolOptions;
 export type AskUserConfig = {
     /** Callback to handle questions and return answers */
     onQuestion?: (question: string) => Promise<string> | string;
@@ -28,6 +42,40 @@ export type SkillConfig = {
     /** Callback when a skill is activated */
     onActivate?: (skill: SkillMetadata, instructions: string) => void | Promise<void>;
 };
+/**
+ * Cache configuration for tool result caching.
+ *
+ * @example
+ * ```typescript
+ * // Enable with defaults (LRU cache, 5min TTL, safe tools only)
+ * cache: true
+ *
+ * // Custom cache store
+ * cache: myRedisStore
+ *
+ * // Per-tool control
+ * cache: { Read: true, Glob: true, Bash: false }
+ *
+ * // Full options
+ * cache: { store: myStore, ttl: 600000, debug: true, Read: true }
+ * ```
+ */
+export type CacheConfig = boolean | CacheStore | {
+    /** Custom cache store (default: LRUCacheStore) */
+    store?: CacheStore;
+    /** TTL in milliseconds (default: 5 minutes) */
+    ttl?: number;
+    /** Enable debug logging for cache hits/misses */
+    debug?: boolean;
+    /** Callback when cache hit occurs */
+    onHit?: (toolName: string, key: string) => void;
+    /** Callback when cache miss occurs */
+    onMiss?: (toolName: string, key: string) => void;
+    /** Custom key generator for cache keys */
+    keyGenerator?: (toolName: string, params: unknown) => string;
+    /** Per-tool overrides - any tool name can be enabled/disabled */
+    [toolName: string]: boolean | CacheStore | number | ((toolName: string, key: string) => void) | ((toolName: string, params: unknown) => string) | undefined;
+};
 export type AgentConfig = {
     tools?: {
         Bash?: ToolConfig;
@@ -47,6 +95,8 @@ export type AgentConfig = {
     webSearch?: WebSearchConfig;
     /** Include WebFetch tool with this config */
     webFetch?: WebFetchConfig;
+    /** Enable tool result caching */
+    cache?: CacheConfig;
     defaultTimeout?: number;
     workingDirectory?: string;
 };

package/dist/utils/http-constants.d.ts

@@ -0,0 +1,5 @@
+/**
+ * HTTP status codes that indicate a retryable error.
+ * Shared between web-search and web-fetch tools.
+ */
+export declare const RETRYABLE_STATUS_CODES: number[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bashkit",
-  "version": "0.1.3",
+  "version": "0.2.2",
   "description": "Agentic coding tools for the Vercel AI SDK",
   "type": "module",
   "main": "./dist/index.js",
@@ -54,17 +54,18 @@
     "@clack/prompts": "^0.7.0"
   },
   "devDependencies": {
-    "@ai-sdk/anthropic": "^2.0.50",
+    "@ai-sdk/anthropic": "^3.0.1",
     "@biomejs/biome": "^2.3.9",
     "@e2b/code-interpreter": "^1.5.1",
     "@types/bun": "latest",
     "@types/node": "^24.10.0",
     "@vercel/sandbox": "^1.0.4",
+    "ai": "^6.0.0",
     "parallel-web": "^0.2.4",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "ai": "^5.0.0",
+    "ai": ">=5.0.0",
     "zod": "^4.1.8",
     "@vercel/sandbox": "^1.0.0",
     "@e2b/code-interpreter": "^1.0.0",