agentick 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +8 -8
  2. package/package.json +4 -4
package/README.md CHANGED
@@ -561,16 +561,16 @@ function AdaptiveAgent({ task }: { task: string }) {
561
561
  }
562
562
  ```
563
563
 
564
- ## Execution Environments
564
+ ## Execution Runners
565
565
 
566
566
  The context window is JSX. But what _consumes_ that context — and how tool calls _execute_ — is pluggable.
567
567
 
568
- 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.
568
+ 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.
569
569
 
570
570
  ```tsx
571
- import { type ExecutionEnvironment } from "@agentick/core";
571
+ import { type ExecutionRunner } from "@agentick/core";
572
572
 
573
- const repl: ExecutionEnvironment = {
573
+ const repl: ExecutionRunner = {
574
574
  name: "repl",
575
575
 
576
576
  // The model sees command descriptions instead of tool schemas
@@ -592,15 +592,15 @@ const repl: ExecutionEnvironment = {
592
592
  },
593
593
  };
594
594
 
595
- const app = createApp(Agent, { model, environment: repl });
595
+ const app = createApp(Agent, { model, runner: repl });
596
596
  ```
597
597
 
598
598
  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.
599
599
 
600
- 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`:
600
+ 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`:
601
601
 
602
602
  ```tsx
603
- await session.spawn(CodeAgent, { messages }, { environment: sandboxEnv });
603
+ await session.spawn(CodeAgent, { messages }, { runner: replEnv });
604
604
  ```
605
605
 
606
606
  ## Testing
@@ -668,7 +668,7 @@ adapter.stream([
668
668
  | `createMockApp()` | Mock app for client/transport tests. |
669
669
  | `createMockSession()` | Mock session with send/close/abort. |
670
670
  | `createMockExecutionHandle()` | Mock execution handle (async iterable + result). |
671
- | `createTestEnvironment()` | Mock execution environment with call tracking. |
671
+ | `createTestRunner()` | Mock execution runner with call tracking. |
672
672
  | `createMockCom()` | Mock COM for hook tests. |
673
673
  | `createMockTickState()` | Mock tick state. |
674
674
  | `createMockTickResult()` | Mock tick result for `useOnTickEnd` tests. |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agentick",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "description": "The component framework for AI.",
5
5
  "keywords": [
6
6
  "agent",
@@ -31,9 +31,9 @@
31
31
  "access": "public"
32
32
  },
33
33
  "dependencies": {
34
- "@agentick/agent": "0.3.0",
35
- "@agentick/core": "0.3.0",
36
- "@agentick/guardrails": "0.2.1"
34
+ "@agentick/agent": "0.4.0",
35
+ "@agentick/core": "0.4.0",
36
+ "@agentick/guardrails": "0.4.0"
37
37
  },
38
38
  "scripts": {
39
39
  "build": "tsc -p tsconfig.build.json",