agentick 0.3.0 → 0.5.0

package/README.md

@@ -85,6 +85,7 @@ Everything in the component tree compiles to what the model sees. Components are
 | `<Timeline.Provider>` | Context provider exposing timeline entries to descendants via `useTimelineContext()`.                                                                                                 |
 | `<Timeline.Messages>` | Renders messages from `Timeline.Provider` context. Optional `renderEntry` prop for custom rendering.                                                                                  |
 | `<Section>`           | Structured context block injected every tick. `audience` controls visibility: `"model"`, `"user"`, or `"all"`.                                                                        |
+| `<Tool>`              | Tool the model can call. Use inline (`<Tool name="..." handler={...} />`) or via `createTool()`. Supports `render()` for persistent state, `use()` for context injection.             |
 | `<Model>`             | Model configuration. Pass `engine` prop, or use adapter-specific components like `<OpenAIModel>` or `<GoogleModel>`.                                                                  |
 
 ### Messages
@@ -561,20 +562,20 @@ function AdaptiveAgent({ task }: { task: string }) {
 }
 ```
 
-## Execution Environments
+## Execution Runners
 
 The context window is JSX. But what _consumes_ that context — and how tool calls _execute_ — is pluggable.
 
-An `ExecutionEnvironment` is a swappable backend that sits between the compiled context and execution. It transforms what the model sees, intercepts how tools run, and manages its own lifecycle state. Your agent code doesn't change — the environment changes the execution model underneath it.
+An `ExecutionRunner` is a swappable backend that sits between the compiled context and execution. It transforms what the model sees, intercepts how tools run, and manages its own lifecycle state. Your agent code doesn't change — the runner changes the execution model underneath it.
 
 ```tsx
-import { type ExecutionEnvironment } from "@agentick/core";
+import { type ExecutionRunner } from "@agentick/core";
 
-const repl: ExecutionEnvironment = {
+const repl: ExecutionRunner = {
   name: "repl",
 
   // The model sees command descriptions instead of tool schemas
-  prepareModelInput(compiled, tools) {
+  transformCompiled(compiled, tools) {
     return { ...compiled, tools: [executeTool] };
   },
 
@@ -592,15 +593,15 @@ const repl: ExecutionEnvironment = {
   },
 };
 
-const app = createApp(Agent, { model, environment: repl });
+const app = createApp(Agent, { model, runner: repl });
 ```
 
 Same agent, same JSX, different execution model. Build once — run against standard tool_use in production, a sandboxed REPL for code execution, a human-approval gateway for sensitive operations.
 
-All hooks are optional. Without an environment, standard model → tool_use behavior applies. Environments are inherited by spawned child sessions — override per-child via `SpawnOptions`:
+All hooks are optional. Without a runner, standard model → tool_use behavior applies. Runners are inherited by spawned child sessions — override per-child via `SpawnOptions`:
 
 ```tsx
-await session.spawn(CodeAgent, { messages }, { environment: sandboxEnv });
+await session.spawn(CodeAgent, { messages }, { runner: replEnv });
 ```
 
 ## Testing
@@ -668,7 +669,7 @@ adapter.stream([
 | `createMockApp()`             | Mock app for client/transport tests.                  |
 | `createMockSession()`         | Mock session with send/close/abort.                   |
 | `createMockExecutionHandle()` | Mock execution handle (async iterable + result).      |
-| `createTestEnvironment()`     | Mock execution environment with call tracking.        |
+| `createTestRunner()`          | Mock execution runner with call tracking.             |
 | `createMockCom()`             | Mock COM for hook tests.                              |
 | `createMockTickState()`       | Mock tick state.                                      |
 | `createMockTickResult()`      | Mock tick result for `useOnTickEnd` tests.            |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentick",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "The component framework for AI.",
   "keywords": [
     "agent",
@@ -31,9 +31,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@agentick/agent": "0.3.0",
-    "@agentick/core": "0.3.0",
-    "@agentick/guardrails": "0.2.1"
+    "@agentick/agent": "0.5.0",
+    "@agentick/core": "0.5.0",
+    "@agentick/guardrails": "0.4.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",