Reference
Public API surface
Every export from every subpath, at a glance. Treat anything not listed here as internal and subject to change without notice.
#Surface
| Subpath | Exports |
|---|---|
| @skawld/agent-sdk | Agent, Session, defaultTools, connectMcpServers, isSubagentEvent, core types (Message, ContentBlock, StopReason, Usage, ModelId, PermissionMode), every Event shape, the full SkawldError hierarchy, and CompactionStrategy. |
| @skawld/agent-sdk/providers | BaseProvider, AnthropicProvider, OpenAIChatCompletionsProvider, OpenAIResponsesProvider, withRetry, and provider options types. |
| @skawld/agent-sdk/tools | ToolRegistry, defaultTools, the Tool / ToolContext / ToolResult / JSONSchema types, FileReadTracker, built-in tool classes (ReadTool, WriteTool, EditTool, BashTool, GlobTool, GrepTool, the Task* tools), plus MCP helpers. |
| @skawld/agent-sdk/sessions | SqliteSessionStore, InMemorySessionStore, the SessionStore / SessionRecord / StoredMessage types, and the task-persistence types (Task, TaskStatus, CreateTaskInput, TaskPatch). |
| @skawld/agent-sdk/permissions | PermissionEngine, the CanUseTool callback type, request/response shapes, and rule types (ToolRule, PathRule, BashRule). |
#Versioning
The package follows semver. The 0.x range is pre-1.0 — we’ll mark breaking changes in the changelog, but reserve the right to make them on minor bumps. Pin to a minor in production.