@robota-sdk/agent-sdk 3.0.0-beta.59 → 3.0.0-beta.60

package/README.md

@@ -32,18 +32,18 @@ const response = await query('Analyze the code', {
 ## Features
 
 - **InteractiveSession** — Event-driven session wrapper (composition over Session). Central client-facing API for CLI, web, API server, or any other client
-- **SystemCommandExecutor + ISystemCommand** — SDK-level command execution. Built-in commands: `help`, `clear`, `compact`, `mode`, `model`, `language`, `cost`, `context`, `permissions`, `reset`
+- **SystemCommandExecutor + ISystemCommand** — SDK-level command execution infrastructure for product-composed command modules
 - **CommandRegistry, BuiltinCommandSource, SkillCommandSource** — Slash command registry and discovery (owned by SDK; agent-cli re-exports `CommandRegistry` from here)
 - **query()** — Single entry point for one-shot AI agent interactions with streaming support
 - **createSession()** — Assembly factory: wires tools, provider, config, and context into a Session
-- **Built-in Tools** — Bash, Read, Write, Edit, Glob, Grep (re-exported from `@robota-sdk/agent-tools`)
+- **Built-in Tools** — Bash, Read, Write, Edit, Glob, Grep, WebFetch, WebSearch are assembled for sessions; six local file/process/search exports are re-exported from `@robota-sdk/agent-tools`
 - **Agent Tool** — Sub-agent session creation for multi-agent workflows
 - **Permissions** — 3-step evaluation (deny list, allow list, mode policy) with four modes: `plan`, `default`, `acceptEdits`, `bypassPermissions`
 - **Hooks** — `PreToolUse`, `PostToolUse`, `PreCompact`, `PostCompact`, `SessionStart`, `UserPromptSubmit`, `Stop` events with shell command execution
 - **Streaming** — Real-time text delta callbacks via `onTextDelta`
 - **Context Loading** — AGENTS.md / CLAUDE.md walk-up discovery and system prompt assembly
 - **Config Loading** — 6-file settings merge with provider profiles, legacy provider compatibility, and `$ENV:VAR` substitution for provider API keys
-- **Context Window Management** — Token tracking, auto-compaction at ~83.5%, manual `session.compact()`
+- **Context Window Management** — Token tracking, configurable auto-compaction (default ~83.5%), manual `session.compact()`
 - **Background Jobs** — Runtime-managed subagent tasks with transcripts and task snapshots
 - **Agent Batch Jobs** — `Agent({ jobs: [...] })` starts explicit parallel subagent requests deterministically
 - **Edit Checkpoints** — Checkpoint/rewind support for safer edit workflows
@@ -167,13 +167,12 @@ session.getSession(); // Session
 import { SystemCommandExecutor, createSystemCommands } from '@robota-sdk/agent-sdk';
 import type { ICommandResult } from '@robota-sdk/agent-sdk';
 
-const executor = new SystemCommandExecutor(); // loads built-in commands by default
+const executor = new SystemCommandExecutor(); // starts empty unless commands are supplied
 
 // Execute a command
-const result: ICommandResult | null = await executor.execute('context', session, '');
+const result: ICommandResult | null = await executor.execute('status', session, '');
 if (result) {
-  console.log(result.message); // "Context: 12,345 / 200,000 tokens (6%)"
-  console.log(result.data); // { usedTokens, maxTokens, percentage }
+  console.log(result.message); // "OK"
 }
 
 // Register a custom command
@@ -188,20 +187,7 @@ executor.listCommands(); // ISystemCommand[]
 executor.hasCommand('mode'); // boolean
 ```
 
-Built-in commands:
-
-| Command       | Description                                             |
-| ------------- | ------------------------------------------------------- |
-| `help`        | Show available commands                                 |
-| `clear`       | Clear conversation history                              |
-| `compact`     | Compress context window (optional focus instructions)   |
-| `mode [m]`    | Show or change permission mode                          |
-| `model <id>`  | Change AI model                                         |
-| `language`    | Set response language (ko, en, ja, zh)                  |
-| `cost`        | Show session info (session ID, message count)           |
-| `context`     | Context window token usage                              |
-| `permissions` | Show current permission mode and session-approved tools |
-| `reset`       | Delete settings (caller handles file I/O and exit)      |
+Product built-ins are supplied as `agent-command-*` modules. For example, `/help` is owned by `@robota-sdk/agent-command-help`, while `/compact` is owned by `@robota-sdk/agent-command-compact`.
 
 ### CommandRegistry, BuiltinCommandSource, SkillCommandSource
 
@@ -242,6 +228,7 @@ const response = await query('Analyze the code', {
   cwd: '/path/to/project',
   permissionMode: 'acceptEdits',
   maxTurns: 10,
+  autoCompactThreshold: 0.75,
   onTextDelta: (delta) => process.stdout.write(delta),
   onCompact: () => console.log('Context compacted'),
 });