@agentex/agent 0.0.1 → 0.0.3

package/README.md

@@ -1,6 +1,6 @@
 # @agentex/agent
 
-Programmatic execution of AI coding agents. Spawn and manage Claude Code, Codex, OpenClaw, or any CLI-based agent as a child process with streaming output, session resume, and a unified interface.
+Programmatic execution of AI coding agents. Spawn and manage Claude Code, Codex, Gemini, Cursor, OpenCode, Pi, OpenClaw, or any CLI-based agent as a child process with streaming output, multi-turn sessions, auth detection, isolated workspaces, skill installation, and a unified interface.
 
 ## Install
 
@@ -8,6 +8,8 @@ Programmatic execution of AI coding agents. Spawn and manage Claude Code, Codex,
 npm install @agentex/agent
 ```
 
+Node.js >= 18. Each provider requires its CLI to be installed and on `$PATH`.
+
 ## Quick Start
 
 ```typescript
@@ -28,21 +30,313 @@ const result = await claude.execute({
   },
 });
 
-console.log(result.exitCode);   // 0
+console.log(result.status);     // "completed"
 console.log(result.summary);    // "Added try/catch to all route handlers..."
 console.log(result.durationMs); // 12340
 console.log(result.costUsd);    // 0.0342
-console.log(result.usage);      // { inputTokens: 1200, outputTokens: 350, cachedInputTokens: 800 }
+console.log(result.usage);      // { "claude-sonnet-4-6": { inputTokens: 1200, outputTokens: 350, ... } }
 ```
 
 ## Built-in Providers
 
-| Provider   | CLI              | Description                         |
-| ---------- | ---------------- | ----------------------------------- |
-| `claude`   | `claude`         | Claude Code (Anthropic)             |
-| `codex`    | `codex`          | Codex CLI (OpenAI)                  |
-| `openclaw` | `openclaw`       | OpenClaw agent                      |
-| `process`  | any executable   | Generic process executor            |
+| Provider   | CLI              | Description                                 |
+| ---------- | ---------------- | ------------------------------------------- |
+| `claude`   | `claude`         | Claude Code (Anthropic)                     |
+| `codex`    | `codex`          | Codex CLI (OpenAI)                          |
+| `gemini`   | `gemini`         | Gemini CLI (Google)                         |
+| `cursor`   | `agent`          | Cursor CLI agent                            |
+| `opencode` | `opencode`       | OpenCode                                    |
+| `pi`       | `pi`             | Pi CLI                                      |
+| `openclaw` | gateway HTTP     | OpenClaw HTTP-gateway agent                 |
+| `process`  | any executable   | Generic process executor (arbitrary binary) |
+
+Provider capabilities (sessions, skills, workspaces, MCP, model discovery, quota probing, instructions) are declared on each module's `capabilities` field — check `provider.capabilities` to branch on what's supported.
+
+## Execution Context
+
+Only `prompt` is required. Everything else has sensible defaults.
+
+```typescript
+interface ExecutionContext {
+  prompt: string;
+  model?: string;
+  runId?: string;                   // Auto-generated UUIDv7 if omitted
+  cwd?: string;                     // Defaults to process.cwd()
+  env?: Record<string, string>;
+  sessionParams?: Record<string, unknown> | null;
+  config?: ProviderConfig;
+  signal?: AbortSignal;             // Cancellation — SIGTERM then SIGKILL after graceSec
+  onOutput?: (stream: "stdout" | "stderr", chunk: string) => void | Promise<void>;
+  onEvent?: (event: StreamEvent) => void | Promise<void>;
+  onStart?: (pid: number) => void;
+  onLifecycle?: (event: LifecycleEvent) => void;
+}
+```
+
+`ProviderConfig` covers the knobs most providers accept:
+
+```typescript
+interface ProviderConfig {
+  command?: string;                 // Override CLI binary path
+  model?: string;
+  effort?: string;
+  maxTurns?: number;
+  timeoutSec?: number;
+  graceSec?: number;
+  skipPermissions?: boolean;
+  skillDirs?: string[];
+  instructionsFile?: string;
+  mcpServers?: McpServerConfig[];
+  extraArgs?: string[];
+  search?: boolean;
+  sandbox?: boolean;
+  thinking?: string;
+  mode?: string;
+  workspace?: { strategy: "worktree"; baseBranch?: string; branchName?: string };
+}
+```
+
+## Execution Result
+
+```typescript
+interface ExecutionResult {
+  runId: string;
+  exitCode: number | null;
+  signal: string | null;
+  status: ExecutionStatus;          // "completed" | "failed" | "aborted" | "timeout" | "blocked"
+  startedAt: string;                // ISO timestamp
+  completedAt: string;
+  durationMs: number;
+  errorMessage: string | null;
+  errorCode: string | null;
+  usage?: Record<string, TokenUsage>;  // keyed by model ID
+  costUsd: number | null;
+  model: string | null;
+  summary: string | null;
+  sessionParams: Record<string, unknown> | null;
+  sessionDisplayId: string | null;
+  clearSession: boolean;
+  billingType: "api" | "subscription" | "metered_api" | null;
+  raw?: Record<string, unknown> | null;
+  workspace?: PreparedWorkspace;    // Present if config.workspace was set
+}
+```
+
+Use `aggregateUsage(result.usage)` to collapse per-model usage into a single total.
+
+## Stream Events
+
+Emitted during execution via `onEvent`. All events include `timestamp`.
+
+- `system` — Session init (`sessionId`, `model`, `subtype`)
+- `assistant` — Text output from the agent (`text`)
+- `thinking` — Agent's internal reasoning (`text`)
+- `tool_call` — Agent invoked a tool (`name`, `input`, `callId?`)
+- `tool_result` — Tool returned a result (`toolCallId`, `content`, `isError`)
+- `result` — Final result (`text`, `cost`, `isError`)
+
+Lifecycle events (via `onLifecycle`) report phases: `preparing`, `spawning`, `running`, `waiting_for_input`, `completed`, `cancelled`, `error`.
+
+## Sessions (multi-turn)
+
+Providers with `capabilities.sessions = true` (Claude, Codex) can host a persistent session where you send multiple user messages and reuse context across turns.
+
+```typescript
+import { getProvider, parseAskUserQuestion } from "@agentex/agent";
+
+const claude = getProvider("claude");
+const session = await claude.createSession!({
+  cwd: process.cwd(),
+  onEvent: (e) => { /* stream events */ },
+  onUserInputRequest: async (req) => {
+    const q = parseAskUserQuestion(req);
+    if (q) return { allow: true, updatedInput: { answers: ["Yes"] } };
+    return { allow: true };  // auto-approve other tool calls
+  },
+});
+
+const first = await session.send("List the API routes in src/");
+const followUp = await session.send("Now add rate limiting to each one.");
+
+await session.close();
+```
+
+`session.send()` returns a `TurnResult` with `summary`, `usage`, `costUsd`, and a `status` of `completed | failed | max_turns | max_budget | aborted`. Handle elicitations (MCP forms), hook callbacks, and interrupts through the corresponding `SessionContext` callbacks.
+
+## Auth
+
+`@agentex/agent` models three billing modes explicitly — API key, Bedrock, and subscription — and refuses to collapse them into a single "is it ready?" boolean. Callers must name the mode they want so billing choices stay visible at the call site.
+
+```typescript
+import { getProvider, hasSubscription, hasApiKey, hasBedrock } from "@agentex/agent";
+
+const codex = getProvider("codex");
+
+await hasSubscription(codex);  // true — Codex authenticated via `codex login`
+await hasApiKey(codex);        // true — OPENAI_API_KEY is set (metered billing)
+```
+
+### Common cases
+
+```typescript
+// 1. Just a Codex subscription (ChatGPT login, no metered billing)
+const codex = getProvider("codex");
+if (await hasSubscription(codex) && !(await hasApiKey(codex))) {
+  /* safe to run — no API charges */
+}
+
+// 2. Just a Claude Code subscription
+const claude = getProvider("claude");
+if (await hasSubscription(claude) && !(await hasApiKey(claude))) {
+  /* subscription-only */
+}
+
+// 3. API keys across providers
+for (const p of [claude, codex, getProvider("gemini")]) {
+  if (await hasApiKey(p)) console.log(`${p.type} has API-key auth available`);
+}
+
+// 4. Full report when you need conflict detection, bedrock, or source paths
+const report = await claude.resolveAuth();
+// report.options = [
+//   { method: "api_key", source: { kind: "env", var: "ANTHROPIC_API_KEY" }, present: false },
+//   { method: "bedrock", source: { kind: "env_combo", vars: ["ANTHROPIC_BEDROCK_BASE_URL", "AWS_ACCESS_KEY_ID", "AWS_REGION"] }, present: false },
+//   { method: "subscription", source: { kind: "keychain", service: "Claude Code" }, present: "unknown" },
+// ]
+```
+
+### What each provider reports
+
+| Provider  | API key source(s)                          | Other                                                                          | Subscription source                                                             |
+| --------- | ------------------------------------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
+| `codex`   | `OPENAI_API_KEY`                           | —                                                                              | `$CODEX_HOME/auth.json` (default `~/.codex/auth.json`)                          |
+| `claude`  | `ANTHROPIC_API_KEY`                        | Bedrock via `ANTHROPIC_BEDROCK_BASE_URL` or `AWS_ACCESS_KEY_ID`+`AWS_REGION`   | macOS: Keychain `Claude Code` · Linux/Win: `$CLAUDE_CONFIG_DIR/.credentials.json` |
+| `gemini`  | `GEMINI_API_KEY`, `GOOGLE_API_KEY`         | —                                                                              | `$GEMINI_CONFIG_DIR/oauth_creds.json` (default `~/.gemini/oauth_creds.json`)    |
+| `cursor`  | `CURSOR_API_KEY`, `OPENAI_API_KEY`         | —                                                                              | Detected at runtime                                                             |
+| `opencode`| `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`      | —                                                                              | —                                                                               |
+| `pi`      | `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`      | —                                                                              | —                                                                               |
+
+### Safety notes
+
+- Each sugar helper returns `true` only when a source is **confirmed** present. `"unknown"` presence (macOS Keychain — can't be checked without triggering an OS prompt) is treated as not-present.
+- There is deliberately no blanket `canRun()` helper. If you want "any auth works," write it explicitly:
+  ```typescript
+  const anyReady = (await codex.resolveAuth()).options.some((o) => o.present === true);
+  ```
+- `provider.testEnvironment()` additionally surfaces conflict checks — e.g., Codex or Claude emit a `warn` when both an API key and subscription credentials are present, since the API key will win and cause metered billing.
+
+### Auth types
+
+```typescript
+type AuthMethod = "api_key" | "bedrock" | "subscription";
+
+type AuthSource =
+  | { kind: "env"; var: string }
+  | { kind: "env_combo"; vars: string[] }
+  | { kind: "file"; path: string }
+  | { kind: "keychain"; service: string; account?: string };
+
+interface AuthOption {
+  method: AuthMethod;
+  source: AuthSource;
+  present: boolean | "unknown";
+}
+
+interface AuthReport {
+  providerType: string;
+  options: AuthOption[];
+}
+```
+
+## Environment Testing
+
+`provider.testEnvironment()` is the heavyweight probe — binary resolution, auth presence, optional hello probe. It returns the same `AuthReport` as `resolveAuth()` plus human-readable `checks` for UI.
+
+```typescript
+const result = await claude.testEnvironment({ providerType: "claude" });
+
+result.status        // "pass" | "warn" | "fail"
+result.auth          // AuthReport (same shape as provider.resolveAuth())
+result.checks        // [{ code, level: "info"|"warn"|"error", message, hint? }]
+```
+
+Use `resolveAuth()` for cheap yes/no auth checks; use `testEnvironment()` when you need end-to-end confidence (e.g., on a first-run setup screen).
+
+## Workspaces (isolated git worktree)
+
+Providers with `capabilities.workspace = true` can run in an isolated `git worktree`, letting you diff or discard the agent's changes without touching your main checkout.
+
+```typescript
+import { prepareWorkspace } from "@agentex/agent";
+
+const ws = await prepareWorkspace({ strategy: "worktree", baseBranch: "main" });
+const result = await claude.execute({ prompt: "Refactor utils.ts", cwd: ws.cwd });
+
+const patch = await ws.diff();                        // all changes (default)
+const summary = await ws.diff({ stat: true });        // --stat summary
+const committed = await ws.diff({ scope: "committed" });
+
+await ws.cleanup({ deleteBranch: true });
+```
+
+Or pass `config.workspace` to `execute()` and the provider will prepare and attach it — the result's `workspace` field exposes the same handle.
+
+## Parallel Execution
+
+```typescript
+import { executeAll } from "@agentex/agent";
+
+const results = await executeAll(
+  [
+    { provider: "claude", ctx: { prompt: "Review server.ts" } },
+    { provider: "codex",  ctx: { prompt: "Review db.ts" } },
+  ],
+  { cancelOnFailure: true },
+);
+```
+
+## Skills
+
+Install and remove reusable agent skills across multiple runtimes at once, into either the user's home or a workspace directory.
+
+```typescript
+import { installSkills, listInstalledSkills, removeSkills } from "@agentex/agent";
+
+await installSkills({
+  location: "global",                 // or "workspace" with cwd
+  includeNativeDirs: false,           // true also installs into ~/.gemini/skills/, etc.
+});
+
+const installed = await listInstalledSkills({ location: "global" });
+await removeSkills({ location: "global" });
+```
+
+Channels and locations follow the emerging `.agents/skills/` + `.claude/skills/` convention — see the `SkillRuntime`, `SkillLocation`, and `SkillChannel` types.
+
+## Temporary Config Override
+
+Run a CLI with a throwaway config directory (useful for injecting system prompts or custom settings without touching the user's real home).
+
+```typescript
+import { withTempConfig } from "@agentex/agent";
+
+const cfg = await withTempConfig({
+  runtime: "codex",
+  seedFromDefault: true,                          // optional: copy ~/.codex into the temp dir
+  overrides: { "config.toml": "model = \"o3\"\n" },
+});
+
+await codex.execute({ prompt: "...", env: cfg.env });
+await cfg.cleanup();
+```
+
+## AskUserQuestion / Elicitation / Hooks
+
+Sessions can surface three distinct user-input requests. Handle each via a `SessionContext` callback:
+
+- `onUserInputRequest` — tool permission requests (and interactive tools like Claude's `AskUserQuestion`). Use `parseAskUserQuestion(req)` to detect structured question payloads and return answers via `updatedInput`.
+- `onElicitation` — MCP servers asking the host to render a form or open a URL (`form` / `url` modes, with a JSON-Schema `requestedSchema`).
+- `onHookCallback` — CLI requesting the host to run a registered hook.
 
 ## Custom Providers
 
@@ -52,6 +346,15 @@ import type { ProviderModule } from "@agentex/agent";
 
 const myProvider: ProviderModule = {
   type: "my-agent",
+  capabilities: {
+    sessions: false,
+    modelDiscovery: false,
+    quotaProbing: false,
+    mcp: false,
+    skills: false,
+    instructions: false,
+    workspace: false,
+  },
   async execute(ctx) {
     const startedAt = new Date().toISOString();
     // Spawn your agent, stream events via ctx.onEvent...
@@ -59,7 +362,7 @@ const myProvider: ProviderModule = {
       runId: ctx.runId ?? "generated-id",
       exitCode: 0,
       signal: null,
-      timedOut: false,
+      status: "completed",
       startedAt,
       completedAt: new Date().toISOString(),
       durationMs: 0,
@@ -75,92 +378,69 @@ const myProvider: ProviderModule = {
     };
   },
   async testEnvironment(ctx) {
-    return { providerType: ctx.providerType, status: "pass", checks: [], testedAt: new Date().toISOString() };
+    return {
+      providerType: ctx.providerType,
+      status: "pass",
+      auth: { providerType: ctx.providerType, options: [] },
+      checks: [],
+      testedAt: new Date().toISOString(),
+    };
+  },
+  async resolveAuth() {
+    return { providerType: "my-agent", options: [] };
   },
 };
 
 registerProvider(myProvider);
 ```
 
-## API
-
-### `getProvider(type: string): ProviderModule`
+## API Reference
 
-Returns a registered provider by name. Throws if not found.
+### Registry
+- `getProvider(type)` — look up a registered provider. Throws if unknown.
+- `listProviders()` — list all registered provider type names.
+- `registerProvider(module)` — register a custom provider.
 
-### `listProviders(): string[]`
+### Execution
+- `provider.execute(ctx)` — run a single turn.
+- `provider.createSession?(ctx)` — start a multi-turn session (when `capabilities.sessions`).
+- `executeAll(tasks, { cancelOnFailure?, signal? })` — run multiple executions concurrently.
 
-Returns all registered provider type names.
+### Auth
+- `provider.resolveAuth(ctx?)` — structured report of every auth path.
+- `hasSubscription(provider, ctx?)` / `hasApiKey(provider, ctx?)` / `hasBedrock(provider, ctx?)` — presence sugar.
+- `detectAuth(providerType, env)` — env-only auth classification used for billing hints.
 
-### `registerProvider(provider: ProviderModule): void`
+### Environment
+- `provider.testEnvironment(ctx)` — full probe: binary, auth, optional hello-probe.
+- `provider.checkQuota?(ctx)` — rate-limit / quota status (when `capabilities.quotaProbing`).
+- `provider.listModels?(opts?)` — enumerate models the binary can drive.
 
-Registers a custom provider, making it available via `getProvider()`.
+### Workspace
+- `prepareWorkspace({ strategy, baseBranch?, branchName?, targetDir? })` → `PreparedWorkspace` with `cwd`, `diff()`, `cleanup()`.
 
-### `renderTemplate(template: string, context: Record<string, string>): string`
-
-Renders a template string with `{{variable}}` interpolation.
-
-### `redactEnvForLogs(env: Record<string, string>): Record<string, string>`
-
-Returns a copy of env vars with sensitive values redacted for safe logging.
-
-## Execution Context
-
-Only `prompt` is required. Everything else has sensible defaults.
-
-```typescript
-interface ExecutionContext {
-  prompt: string;             // The task to execute
-  model?: string;             // Model override (e.g. "claude-sonnet-4-20250514")
-  runId?: string;             // Auto-generated UUIDv7 if omitted
-  cwd?: string;               // Defaults to process.cwd()
-  env?: Record<string, string>;
-  sessionParams?: Record<string, unknown> | null;
-  config?: ProviderConfig;
-  onOutput?: (stream: "stdout" | "stderr", chunk: string) => void;
-  onEvent?: (event: StreamEvent) => void;
-}
-```
-
-## Execution Result
-
-```typescript
-interface ExecutionResult {
-  runId: string;
-  exitCode: number | null;
-  signal: string | null;
-  timedOut: boolean;
-  startedAt: string;          // ISO timestamp
-  completedAt: string;        // ISO timestamp
-  durationMs: number;         // Wall-clock duration
-  errorMessage: string | null;
-  errorCode: string | null;
-  usage?: { inputTokens: number; outputTokens: number; cachedInputTokens?: number };
-  costUsd: number | null;
-  model: string | null;
-  summary: string | null;
-  sessionParams: Record<string, unknown> | null;
-  sessionDisplayId: string | null;
-  clearSession: boolean;
-  billingType: "api" | "subscription" | null;
-}
-```
-
-## Stream Events
+### Skills
+- `installSkills(opts)` / `removeSkills(opts)` / `listInstalledSkills(opts)`
+- `resolveSkillsHome(channel)` / `resolveSkillsWorkspace(channel, cwd)`
+- `resolveNativeSkillsHome(runtime)` / `resolveNativeSkillsWorkspace(runtime, cwd)`
+- `ensureSkillSymlink(...)`
 
-Events emitted during execution via `onEvent`. All events include a `timestamp` field.
+### Runtime config
+- `withTempConfig({ runtime, seedFromDefault?, overrides? })` → env + configDir + cleanup.
+- `getRuntimeHomeEnvVar(runtime)` / `getDefaultRuntimeHome(runtime)` — introspect each CLI's home dir override.
 
-- `system` — Session init (`event.sessionId`, `event.model`)
-- `assistant` — Text output from the agent (`event.text`)
-- `thinking` — Agent's internal reasoning (`event.text`)
-- `tool_call` — Agent invoked a tool (`event.name`, `event.input`)
-- `tool_result` — Tool returned a result (`event.content`, `event.isError`)
-- `result` — Final result (`event.text`, `event.cost`)
+### Utilities
+- `aggregateUsage(usage)` — collapse `Record<string, TokenUsage>` to a single total.
+- `renderTemplate(template, ctx)` — `{{var}}` interpolation.
+- `redactEnvForLogs(env)` — redact sensitive values before logging.
+- `resolveInstructions(path?)` — read an instructions file, or `null` if no path.
+- `parseAskUserQuestion(req)` — extract structured question/option data from a `UserInputRequest`.
 
 ## Requirements
 
 - Node.js >= 18
-- The CLI for each provider must be installed and on `$PATH` (e.g., `claude` for the Claude provider)
+- Each provider's CLI installed and resolvable on `$PATH` (`claude`, `codex`, `gemini`, `agent` for Cursor, `opencode`, `pi`, or a reachable OpenClaw gateway)
+- For subscription auth, the relevant CLI must already be logged in (`codex login`, `claude login`, `gemini auth login`, etc.)
 
 ## License
 

package/dist/index.d.ts

@@ -1,5 +1,20 @@
 export { getProvider, listProviders, registerProvider } from "./registry.js";
 export { renderTemplate } from "./utils/template.js";
 export { redactEnvForLogs } from "./utils/env.js";
-export type { ProviderModule, ExecutionContext, ExecutionResult, ProviderConfig, McpServerConfig, StreamEvent, SessionCodec, EnvironmentTestContext, EnvironmentTestResult, EnvironmentCheck, ProviderModel, } from "./types.js";
+export { parseAskUserQuestion } from "./utils/ask-user-question.js";
+export { aggregateUsage } from "./types.js";
+export { resolveInstructions } from "./utils/instructions.js";
+export { getRuntimeHomeEnvVar, getDefaultRuntimeHome } from "./utils/runtime-homes.js";
+export { detectAuth, resolveAuthForProvider, hasSubscription, hasApiKey, hasBedrock, } from "./utils/auth.js";
+export type { ResolvedAuth } from "./utils/auth.js";
+export { prepareWorkspace } from "./utils/workspace.js";
+export type { WorkspaceOptions, PreparedWorkspace, DiffOptions } from "./utils/workspace.js";
+export { withTempConfig } from "./utils/runtime-config.js";
+export type { TempConfigResult, TempConfigOptions } from "./utils/runtime-config.js";
+export { executeAll } from "./utils/execute-all.js";
+export type { ExecuteAllOptions, ExecuteAllTask } from "./utils/execute-all.js";
+export { installSkills, removeSkills, listInstalledSkills, resolveSkillsHome, resolveSkillsWorkspace, resolveNativeSkillsHome, resolveNativeSkillsWorkspace, ensureSkillSymlink, } from "./utils/skills.js";
+export type { ProviderModule, ProviderCapabilities, ExecutionContext, ExecutionResult, ExecutionStatus, ProviderConfig, McpServerConfig, StreamEvent, SessionCodec, SessionState, TokenUsage, LifecycleEvent, QuotaStatus, QuotaContext, EnvironmentTestContext, EnvironmentTestResult, EnvironmentCheck, AuthMethod, AuthSource, AuthOption, AuthReport, AuthResolveContext, ProviderModel, SessionContext, AgentSession, TurnResult, UserInputRequest, UserInputResponse, ElicitationRequest, ElicitationResponse, HookCallbackRequest, HookCallbackResponse, } from "./types.js";
+export type { AskUserQuestion, QuestionOption, } from "./utils/ask-user-question.js";
+export type { SkillRuntime, SkillLocation, SkillChannel, InstallSkillsOptions, SkillInstallEntry, SkillInstallResult, RemoveSkillsOptions, SkillRemoveEntry, SkillRemoveResult, InstalledSkill, } from "./utils/skills.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EACL,UAAU,EACV,sBAAsB,EACtB,eAAe,EACf,SAAS,EACT,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGhF,OAAO,EACL,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,eAAe,EACf,cAAc,GACf,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,GACf,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -2,4 +2,14 @@
 export { getProvider, listProviders, registerProvider } from "./registry.js";
 export { renderTemplate } from "./utils/template.js";
 export { redactEnvForLogs } from "./utils/env.js";
+export { parseAskUserQuestion } from "./utils/ask-user-question.js";
+export { aggregateUsage } from "./types.js";
+export { resolveInstructions } from "./utils/instructions.js";
+export { getRuntimeHomeEnvVar, getDefaultRuntimeHome } from "./utils/runtime-homes.js";
+export { detectAuth, resolveAuthForProvider, hasSubscription, hasApiKey, hasBedrock, } from "./utils/auth.js";
+export { prepareWorkspace } from "./utils/workspace.js";
+export { withTempConfig } from "./utils/runtime-config.js";
+export { executeAll } from "./utils/execute-all.js";
+// Skills
+export { installSkills, removeSkills, listInstalledSkills, resolveSkillsHome, resolveSkillsWorkspace, resolveNativeSkillsHome, resolveNativeSkillsWorkspace, ensureSkillSymlink, } from "./utils/skills.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EACL,UAAU,EACV,sBAAsB,EACtB,eAAe,EACf,SAAS,EACT,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,SAAS;AACT,OAAO,EACL,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}

package/dist/providers/claude/execute.d.ts

@@ -1,3 +1,3 @@
 import type { ExecutionContext, ExecutionResult } from "../../types.js";
-export declare function executeClaudeAdapter(ctx: ExecutionContext): Promise<ExecutionResult>;
+export declare function executeClaudeProvider(ctx: ExecutionContext): Promise<ExecutionResult>;
 //# sourceMappingURL=execute.d.ts.map

package/dist/providers/claude/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/providers/claude/execute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAaxE,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA4M1F"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/providers/claude/execute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAWxE,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAgP3F"}