@robota-sdk/agent-core 3.0.0-beta.7 → 3.0.0-beta.70

package/CHANGELOG.md

@@ -1,5 +1,121 @@
 # @robota-sdk/agent-core
 
+## 3.0.0-beta.70
+
+## 3.0.0-beta.69
+
+## 3.0.0-beta.68
+
+## 3.0.0-beta.67
+
+## 3.0.0-beta.66
+
+## 3.0.0-beta.65
+
+## 3.0.0-beta.64
+
+## 3.0.0-beta.63
+
+## 3.0.0-beta.62
+
+### Patch Changes
+
+- Add CLI second-screen browser monitor (PLG-002)
+  - New `@robota-sdk/agent-web` package: WebSocket client, `useWsSession` hook, `SessionMonitor` component with Markdown rendering
+  - `--web` flag on `agent-cli`: starts WebSocket sidecar server and auto-opens browser monitor
+  - `--no-open` flag and `ROBOTA_NO_OPEN` env var to suppress browser launch
+  - `user_message` event added to `IInteractiveSessionEvents` so user prompts stream to browser in real-time
+  - `TServerMessage` protocol extended with `user_message` type
+
+## 3.0.0-beta.61
+
+### Patch Changes
+
+- 1c0d44c: Align context usage estimation across session display, auto-compaction, and core hard-capacity guards so mid-window sessions do not block prematurely.
+- 36eb7a9: Add provider-owned native replay payload hooks, replay validation coverage, and a session log validation command.
+- d97bdf2: Add provider-owned model catalog metadata, route `/model` suggestions through the active provider, and make `cli:dev` resolve the CLI workspace dependency closure through source export conditions.
+
+## 3.0.0-beta.60
+
+### Minor Changes
+
+- 7439391: Add provider-neutral native web search/fetch capability contracts, explicit unsupported handling for OpenAI-compatible/LM Studio profiles, and local WebFetch/WebSearch permission/documentation alignment.
+
+## 3.0.0-beta.59
+
+## 3.0.0-beta.58
+
+### Patch Changes
+
+- Refresh package docs and robota.io content for the beta 57 feature set.
+
+## 3.0.0-beta.57
+
+### Minor Changes
+
+- f61e2cb: Add Qwen provider-owned Responses API support for built-in web search/fetch tools and pass provider-owned profile options through generic CLI/runtime configuration.
+
+### Patch Changes
+
+- 16c3b6f: Persist and render provider-neutral per-turn usage summaries with pre-send context updates in CLI sessions.
+
+## 3.0.0-beta.56
+
+### Patch Changes
+
+- Prepare a coordinated beta release for batch npm publishing.
+
+## 3.0.0-beta.55
+
+### Patch Changes
+
+- 38a72bf: fix: resolve ESLint tsconfig parsing errors and improve pnpm CI reliability
+  - Add tsconfig.eslint.json to all packages for per-package ESLint runs
+  - Migrate typecheck from pnpm -r exec tsc to per-package typecheck scripts
+  - Add --if-present to all recursive pnpm run scripts
+  - Fix React type imports, dynamic imports in tests, Express.Multer types
+
+## 3.0.0-beta.54
+
+### Patch Changes
+
+- fix: resolve all typecheck errors across packages
+
+## 3.0.0-beta.53
+
+### Patch Changes
+
+- refactor: monolith decomposition — all agent-\* files under 300 lines
+- fix: PR #69 code review — session resume tool messages, type SSOT, fork isolation, settings crash, Notification removal, chat validation
+
+## 3.0.0-beta.52
+
+## 3.0.0-beta.51
+
+## 3.0.0-beta.50
+
+## 3.0.0-beta.49
+
+## 3.0.0-beta.48
+
+## 3.0.0-beta.47
+
+## 3.0.0-beta.46
+
+## 3.0.0-beta.45
+
+## 3.0.0-beta.44
+
+### Patch Changes
+
+- feat: IHistoryEntry universal history architecture + test quality cleanup
+  - IHistoryEntry as universal history type across all 4 packages (core → sessions → sdk → cli)
+  - Tool summary stored as event entry in history (category: 'event', type: 'tool-summary')
+  - TuiStateManager pure TypeScript class for CLI rendering state
+  - MessageList renders IHistoryEntry[] with Tool:/System:/You:/Robota: labels
+  - Display order fixed: Tool → Robota (both streaming and abort)
+  - Remove 25 tautological, duplicate, and hardcoded tests
+
 ## 2.0.9
 
 ### Patch Changes

package/README.md

@@ -1,4 +1,4 @@
-# @robota-sdk/agent-core
+# Agent Core
 
 The foundation layer of the Robota SDK. Provides the `Robota` agent class, abstract base classes for providers/tools/plugins, the permission system, hook system, event services, and error hierarchy.
 
@@ -12,7 +12,7 @@ npm install @robota-sdk/agent-core
 
 ```typescript
 import { Robota } from '@robota-sdk/agent-core';
-import { AnthropicProvider } from '@robota-sdk/agent-provider-anthropic';
+import { AnthropicProvider } from '@robota-sdk/agent-provider/anthropic';
 
 const provider = new AnthropicProvider({ apiKey: process.env.ANTHROPIC_API_KEY });
 
@@ -33,12 +33,20 @@ console.log(response);
 ## Key Features
 
 - **Robota class**: AI agent with conversation history, tool execution, and plugin support
+- **ConversationStore**: Append-only conversation history with streaming buffer (`beginAssistant`/`appendStreaming`/`commitAssistant`)
+- **IBaseMessage**: Every message has a unique `id` (UUID) and `state` (`'complete'` | `'interrupted'`)
 - **Multi-provider**: Register multiple providers, switch dynamically with `setModel()`
+- **Provider capabilities**: Provider-neutral capability reports distinguish local tools from provider-native hosted web search/fetch
+- **AbstractAIProvider.streamWithAbort()**: Standard streaming wrapper for all providers — handles AbortSignal, returns partial content on abort
 - **Permission system**: Deterministic 3-step policy evaluation (`evaluatePermission`)
 - **Hook system**: Shell command-based lifecycle hooks (`runHooks`)
 - **Plugin system**: `AbstractPlugin` base class with lifecycle hooks (beforeRun, afterRun, onError, etc.)
 - **Event services**: Unified event emission with owner path tracking
 - **Error hierarchy**: Typed errors extending `RobotaError` (ProviderError, RateLimitError, etc.)
+- **Model definitions**: Central `CLAUDE_MODELS` registry with context windows, output limits, and human-readable names
+- **callProviderWithCache**: Accepts `Partial<IChatOptions>` overrides for per-call configuration
+- **AbortSignal propagation**: Signal flows through the entire execution chain (Session -> Robota -> Provider)
+- **Execution boundary events**: `Robota.run()` can emit provider/tool provenance events through `onExecutionEvent`
 - **Type safety**: Strict TypeScript, zero `any` in production code
 
 ## Robota API
@@ -57,6 +65,24 @@ agent.clearHistory();
 agent.setModel({ provider: 'openai', model: 'gpt-4o' });
 ```
 
+### Execution Boundary Events
+
+`run()` accepts `onExecutionEvent` in run options. The execution loop emits provider-neutral events that higher layers can persist as append-only session provenance:
+
+- `provider_request`
+- `provider_native_raw_payload`
+- `provider_stream_raw_delta`
+- `provider_response_raw`
+- `provider_response_normalized`
+- `assistant_message_committed`
+- `tool_batch_started`
+- `tool_execution_request`
+- `tool_execution_result`
+- `tool_message_committed`
+- `history_mutation`
+
+Provider-specific SDK payload capture remains provider-owned. Providers may call `IChatOptions.onProviderNativeRawPayload` with exact SDK request, response, or stream event objects; `Robota` forwards those callbacks as provider-neutral `provider_native_raw_payload` execution events without importing concrete provider SDK types. `provider_response_raw.responseKind` remains `provider-normalized-message`, which keeps common replay validation provider-neutral.
+
 ## IAgentConfig
 
 | Field                        | Type                       | Description                    |
@@ -84,16 +110,19 @@ agent-sdk         ← Assembly layer
 agent-cli         ← Terminal UI
 ```
 
-## What This Package Provides
-
-| Category        | Exports                                                                                                                |
-| --------------- | ---------------------------------------------------------------------------------------------------------------------- |
-| **Core**        | `Robota`, `AbstractAgent`, `AbstractAIProvider`, `AbstractPlugin`, `AbstractTool`, `AbstractExecutor`, `LocalExecutor` |
-| **Permissions** | `evaluatePermission`, `MODE_POLICY`, `TRUST_TO_MODE`, `TPermissionMode`, `TToolArgs`                                   |
-| **Hooks**       | `runHooks`, `THookEvent` (PreToolUse, PostToolUse, PreCompact, PostCompact, SessionStart, Stop)                        |
-| **Events**      | `AbstractEventService`, `DefaultEventService`, `StructuredEventService`, `EventEmitterPlugin`                          |
-| **Types**       | `TUniversalMessage`, `IAgentConfig`, `IAIProvider`, `IToolSchema`, `IContextWindowState`                               |
-| **Errors**      | `RobotaError`, `ProviderError`, `RateLimitError`, `AuthenticationError`, `ToolExecutionError`, etc.                    |
+## Public API Surface
+
+| Category        | Exports                                                                                                                                                                                                                               |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Core**        | `Robota`, `ConversationStore`, `AbstractAgent`, `AbstractAIProvider` (+ `streamWithAbort`), `AbstractPlugin`, `AbstractTool`, `AbstractExecutor`, `LocalExecutor`, `getProviderCapabilities`, `assertProviderNativeWebToolsAvailable` |
+| **Permissions** | `evaluatePermission`, `MODE_POLICY`, `TRUST_TO_MODE`, `UNKNOWN_TOOL_FALLBACK`, `TPermissionMode`, `TTrustLevel`, `TPermissionDecision`, `TToolArgs`, `IPermissionLists`, `TKnownToolName`                                             |
+| **Hooks**       | `runHooks`, `CommandExecutor`, `HttpExecutor`, `IHookTypeExecutor`, `THookEvent`, `THooksConfig`, `IHookGroup`, `IHookDefinition`, `IHookInput`, `IHookResult`                                                                        |
+| **Events**      | `EventEmitterPlugin`, `IEventService`, `IOwnerPathSegment`                                                                                                                                                                            |
+| **Models**      | `CLAUDE_MODELS`, `DEFAULT_CONTEXT_WINDOW`, `DEFAULT_MAX_OUTPUT`, `getModelContextWindow()`, `getModelMaxOutput()`, `getModelName()`, `formatTokenCount()`, `IModelDefinition`                                                         |
+| **Context**     | `estimateContextTokensFromMessages()`, `estimateSerializedContextTokens()`, `readTokenUsageFromMessage()`, `IContextTokenEstimate`, `IMessageTokenUsage`, `IContextWindowState`, `IContextTokenUsage`                                 |
+| **Types**       | `TUniversalMessage`, `IBaseMessage` (`id`, `state`), `TMessageState`, `IAgentConfig`, `IAIProvider`, `IProviderCapabilities`, `IProviderNativeWebToolRequest`, `IToolSchema`, `TTextDeltaCallback`                                    |
+| **Errors**      | `RobotaError`, `ProviderError`, `RateLimitError`, `AuthenticationError`, `ToolExecutionError`, etc.                                                                                                                                   |
+| **Managers**    | `AgentFactory`, `AgentTemplates`, `ConversationHistory`, `EventHistoryModule`                                                                                                                                                         |
 
 ## What Moved Out in v3