@wrongstack/tools 0.277.1 → 0.280.0

package/dist/index.d.ts

@@ -5,11 +5,11 @@ export { replaceTool } from './replace.js';
 export { globTool } from './glob.js';
 export { grepTool } from './grep.js';
 export { bashTool } from './bash.js';
-export { configureExecPolicy, execTool, getExecAllowlist, isExecCommandAllowed, resetExecPolicy } from './exec.js';
+export { D as DangerAssessment, a as DangerLevel, c as configureDangerBypass, b as configureExecPolicy, d as detectDanger, e as execTool, g as getDangerBypass, f as getExecAllowlist, i as isExecCommandAllowed, r as resetDangerBypass, h as resetExecPolicy } from './exec-Ca3fnpUh.js';
 export { fetchTool } from './fetch.js';
 export { searchTool } from './search.js';
 export { todoTool } from './todo.js';
-import { Tool } from '@wrongstack/core';
+import { Tool, SkillLoader } from '@wrongstack/core';
 export { gitTool } from './git.js';
 export { patchTool } from './patch.js';
 export { jsonTool } from './json.js';
@@ -237,6 +237,49 @@ interface DesignOutput {
  */
 declare const designTool: Tool<DesignInput, DesignOutput>;
 
+interface SkillToolInput {
+    name: string;
+    /** Optional relative path of a bundled resource to load (e.g. `references/REF.md`, `scripts/extract.py`, `assets/template.html`). Omit to list resources. */
+    resource?: string | undefined;
+}
+interface SkillResource {
+    /** Path relative to the skill directory (e.g. `scripts/extract.py`). */
+    path: string;
+    bytes: number;
+}
+interface LoadedResource {
+    rel: string;
+    absPath: string;
+    content: string;
+    bytes: number;
+    truncated: boolean;
+}
+interface SkillToolOutput {
+    name: string;
+    description: string;
+    /** Frontmatter-stripped SKILL.md body (capped). */
+    body: string;
+    /** All bundled resource files (recursive), when no specific resource was requested. */
+    resources: SkillResource[];
+    /** Absolute directory of the skill — run scripts via bash using paths under here. */
+    dir: string;
+    /** When `resource` was requested: the loaded file. */
+    loadedResource?: LoadedResource | undefined;
+}
+/**
+ * Skill tool — the agentskills.io progressive-disclosure primitive.
+ *
+ * - `skill({ name })` → SKILL.md body + a recursive listing of every bundled
+ *   resource file (scripts/ references/ assets/ templates/ … any subdir).
+ * - `skill({ name, resource })` → the content of that one resource file.
+ *
+ * Use this (not the `read` tool) to load skill resources: it works for foreign
+ * skills that live outside the project root (e.g. `~/.claude/skills/…`), which
+ * a project-root-restricted `read` tool may refuse. Scripts are returned with
+ * their absolute path so the agent can run them via `bash`.
+ */
+declare function makeSkillTool(skillLoader: SkillLoader): Tool<SkillToolInput, SkillToolOutput>;
+
 /**
  * PersistentProcessRegistry — filesystem-backed process registry that survives
  * process restarts and coordinates protection across multiple WrongStack instances
@@ -595,4 +638,4 @@ declare const TOOL_ICON_CONFIG: Record<ToolIconId, ToolIconConfig>;
  */
 declare const FALLBACK_ICON: ToolIconId;
 
-export { type BashShell, type EnsureSessionShellOptions, FALLBACK_ICON, type GlobalProcessStatus, type InstanceInfo, type InstanceListOptions, type PersistentProcessEntry, type PersistentRegistryData, type ProcessGuardianConfig, ProcessRegistryImpl, type ResolveSessionShellDeps, TOOL_ICON_CONFIG, TOOL_ICON_MAP, type ToolIconConfig, type ToolIconId, createGlobalPsSlashCommand, designTool, ensureSessionShell, formatGlobalStatus, formatInstanceList, formatInstanceSummary, getInstanceCount, getPersistentProcessRegistry, getProcessGuardian, getToolIcon, listInstances, normalizeShell, planTool, resetPersistentProcessRegistry, resolveSessionShell, startProcessGuardian, stopProcessGuardian };
+export { type BashShell, type EnsureSessionShellOptions, FALLBACK_ICON, type GlobalProcessStatus, type InstanceInfo, type InstanceListOptions, type PersistentProcessEntry, type PersistentRegistryData, type ProcessGuardianConfig, ProcessRegistryImpl, type ResolveSessionShellDeps, TOOL_ICON_CONFIG, TOOL_ICON_MAP, type ToolIconConfig, type ToolIconId, createGlobalPsSlashCommand, designTool, ensureSessionShell, formatGlobalStatus, formatInstanceList, formatInstanceSummary, getInstanceCount, getPersistentProcessRegistry, getProcessGuardian, getToolIcon, listInstances, makeSkillTool, normalizeShell, planTool, resetPersistentProcessRegistry, resolveSessionShell, startProcessGuardian, stopProcessGuardian };