export declare const DEFAULT_CLAUDE_LOCAL_MODEL = "claude-opus-5-5";
/** Resolve Paperclip's default without replacing an explicit provider model. */
export declare function resolveClaudeModel(model: unknown, env?: Record<string, unknown>): string;
export declare const type = "claude_local";
export declare function claudeLocalReasoningEffortsForModel(model: string): readonly string[];
export declare const label = "Claude Code";
export declare const SANDBOX_INSTALL_COMMAND = "npm install -g @anthropic-ai/claude-code";
export declare const models: {
    id: string;
    label: string;
}[];
export declare const agentConfigurationDoc = "# claude_local agent configuration\n\nAdapter: claude_local\n\nCore fields:\n- engine (string, optional): defaults to ACP, including legacy unset/\"auto\" values. Missing prerequisites and execution failures fail the run without changing engines. Set \"cli\" to explicitly select the CLI engine.\n- cwd (string, optional): default absolute working directory fallback for the agent process (created if missing when possible)\n- instructionsFilePath (string, optional): absolute path to a markdown instructions file injected at runtime\n- model (string, optional): Claude model id. Missing or blank defaults to claude-opus-5-5 in both CLI and ACP, including existing agents. Explicit model IDs and ANTHROPIC_MODEL overrides are preserved. Bedrock/Vertex without an explicit model retain their provider default.\n- effort (string, optional): model-specific reasoning effort passed via --effort (low|medium|high; current Opus, Sonnet 5/5.5, and Fable models also support xhigh|max)\n- chrome (boolean, optional): pass --chrome when running Claude\n- promptTemplate (string, optional): run prompt template\n- maxTurnsPerRun (number, optional): max turns for one run\n- dangerouslySkipPermissions (boolean, optional, default true): allow non-interactive Claude runs to proceed without approval prompts. Local and remote targets receive --dangerously-skip-permissions for all built-in and connected tools. Managed sandbox targets also identify themselves to Claude so root container launches support bypass. Non-sandbox root processes must run Claude as a non-root user; Paperclip does not silently downgrade the requested mode.\n- command (string, optional): defaults to \"claude\"\n- extraArgs (string[], optional): additional CLI args\n- env (object, optional): KEY=VALUE environment variables\n- workspaceStrategy (object, optional): execution workspace strategy; currently supports { type: \"git_worktree\", baseRef?, branchTemplate?, worktreeParentDir? }\n- workspaceRuntime (object, optional): reserved for workspace runtime metadata; workspace runtime services are manually controlled from the workspace UI and are not auto-started by heartbeats\n- filesystemScope (string, optional): set to \"workspace\" to confine local CLI filesystem access with Bubblewrap. Off by default. The workspace and Claude config remain writable; other host paths are hidden.\n- filesystemExtraPaths (array, optional): additional absolute host paths exposed inside the workspace sandbox. String entries are read-only; object entries use { path: \"/absolute/path\", access: \"ro\" | \"rw\" }.\n- filesystemSandboxCommand (string, optional): Bubblewrap executable name or absolute path; defaults to \"bwrap\". Linux only.\n- networkScope (string, optional): \"deny\" blocks all network egress; \"allowlist\" permits only networkAllowlist targets through Paperclip's HTTP(S) proxy. Off by default.\n- networkAllowlist (string[], optional): exact hostnames, hostname:port entries, or origin URLs. Include the configured Claude provider origin, such as \"api.anthropic.com\", Bedrock/Vertex endpoints, or a custom gateway.\n\nACP fields (only when engine=\"acp\"):\n- agentCommand (string, optional): override for the Claude ACP server command; defaults to the package-local claude-agent-acp binary\n- mode (string, optional, default \"persistent\"): ACP session mode (\"persistent\" or \"oneshot\")\n- stateDir (string, optional): ACP session state directory; defaults to Paperclip-managed company/agent scoped storage\n- nonInteractivePermissions (string, optional, default \"deny\"): fallback when the ACP agent asks for input outside an interactive session\n- warmHandleIdleMs (number, optional, default 0): keep the ACP process warm for this many ms after a successful run\n- stalledToolTimeoutSec (number, optional, default 1800): end the turn as failed (\"acpx_tool_stalled\") when a pending tool call gets no ACP update for this many seconds; 0 disables it. The default stays at least 15 minutes above MCP_TOOL_TIMEOUT and BASH_MAX_TIMEOUT_MS\n\nOperational fields:\n- timeoutSec (number, optional): run timeout in seconds\n- graceSec (number, optional): SIGTERM grace period in seconds\n\nNotes:\n- Claude Opus 5.5 uses model ID `claude-opus-5-5` and requires Claude Code v2.1.280 or later.\n- Claude Sonnet 5.5 uses model ID `claude-sonnet-5-5` and requires Claude Code v2.1.284 or later.\n- filesystemScope and networkScope are spawn-level confinement and are orthogonal to Claude permission flags. Both require Bubblewrap on the host and explicit engine=\"cli\"; default or explicit ACP is rejected because ACP confinement is not yet supported. networkScope=\"allowlist\" injects HTTP_PROXY/HTTPS_PROXY for the CLI while its private network namespace blocks direct sockets, so every required provider/API hostname must be listed explicitly.\n- The Claude ACP lane requires Node >=24.11.0 and @agentclientprotocol/claude-agent-acp to be installed with this adapter package. Missing prerequisites fail both default and explicit ACP runs with an actionable setup error; the adapter never switches engines automatically.\n- For ACP runs, model selection is passed through ANTHROPIC_MODEL at ACP server startup; Paperclip-managed Claude permissions and ephemeral skill materialization are handled by the shared ACP engine.\n- When Paperclip realizes a workspace/runtime for a run, it injects PAPERCLIP_WORKSPACE_* and PAPERCLIP_RUNTIME_* env vars for agent-side tooling.\n";
//# sourceMappingURL=index.d.ts.map