@elie-laloum/outpost 9.0.0 → 9.0.1
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.
- package/CHANGELOG.md +7 -0
- package/README.md +8 -8
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 9.0.1
|
|
4
|
+
|
|
5
|
+
- Rewrite the English and French Guide by reader task: twelve chapters in reading order, six complete use-case recipes, and pages drawn with feature cells, reading paths, flows and file trees. Moved Guide URLs redirect to their new pages.
|
|
6
|
+
- Rewrite the Reference: each family overview picks between its entry points with decision and outcome tables, and every symbol and field description was checked against the source and corrected where it was wrong, vague or outdated. Each symbol links to its own Guide page.
|
|
7
|
+
- List the values of 35 type aliases such as `FaultCode`, `TaskStatus` and `SteeringMode`, keep placeholders such as `<name>` visible, and print types from other modules without `import("…")` qualifiers. Documentation sync now rejects descriptions that no page uses.
|
|
8
|
+
- Mark the speculation API experimental in the Reference, as the 9.0.0 notes stated. Add numbered runnable examples under `examples/`. Public library contracts are unchanged.
|
|
9
|
+
|
|
3
10
|
## 9.0.0
|
|
4
11
|
|
|
5
12
|
This major release renames public factories and declarations and removes the previous names, changes conversation and reporter contracts, and extends public event, fault and stop-reason unions. Replace previous names with their `create*`/`define*` equivalents, pass a store instead of a format name to `createTransportConversations()`, use each agent's native store instead of the format-keyed `conversations` helpers, and update exhaustive handling of `AgentEvent` (`fallback`, `steer`), `FaultCode` (`steering`) and stop reasons (`steered`). Firecracker is no longer experimental; speculation remains experimental. Live validation campaigns listed in the roadmap remain outstanding.
|
package/README.md
CHANGED
|
@@ -34,7 +34,7 @@ Outpost is a TypeScript library and CLI for running coding agents in sandboxes a
|
|
|
34
34
|
|
|
35
35
|
## Quickstart
|
|
36
36
|
|
|
37
|
-
You need **Node.js 24+**, **Git**, a repository with at least one commit, and **Docker** running. This example uses Codex with account authentication: prepare its host login using the [setup guide](https://elie-laloum.github.io/outpost/guide/setup/) before running a task. [Authentication](https://elie-laloum.github.io/outpost/guide/
|
|
37
|
+
You need **Node.js 24+**, **Git**, a repository with at least one commit, and **Docker** running. This example uses Codex with account authentication: prepare its host login using the [setup guide](https://elie-laloum.github.io/outpost/guide/setup/) before running a task. [Authentication](https://elie-laloum.github.io/outpost/guide/authentication/) covers other agents and API-key billing.
|
|
38
38
|
|
|
39
39
|
Create a workflow directory and point it at your checkout:
|
|
40
40
|
|
|
@@ -52,7 +52,7 @@ Run your first task:
|
|
|
52
52
|
node run.ts "Describe this repository and suggest one small improvement. Do not edit files."
|
|
53
53
|
```
|
|
54
54
|
|
|
55
|
-
The generated script prints the branch, collected commits and conversation reference. It uses **local branch integration**: when you later ask the agent to change and commit code, those commits are integrated into the target checkout. Use a named branch, as below, to keep changes separate for review. See [branch strategies](https://elie-laloum.github.io/outpost/guide/branch
|
|
55
|
+
The generated script prints the branch, collected commits and conversation reference. It uses **local branch integration**: when you later ask the agent to change and commit code, those commits are integrated into the target checkout. Use a named branch, as below, to keep changes separate for review. See [branch strategies](https://elie-laloum.github.io/outpost/guide/repository-and-branch/).
|
|
56
56
|
|
|
57
57
|
## Use the library
|
|
58
58
|
|
|
@@ -89,14 +89,14 @@ console.log(result.usage);
|
|
|
89
89
|
|
|
90
90
|
| You want to… | Start here |
|
|
91
91
|
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
|
|
92
|
-
| Choose an agent, model and credentials | [Agent configuration](https://elie-laloum.github.io/outpost/guide/agent
|
|
93
|
-
| Run locally in containers or in the cloud | [Execution backends](https://elie-laloum.github.io/outpost/guide/
|
|
92
|
+
| Choose an agent, model and credentials | [Agent configuration](https://elie-laloum.github.io/outpost/guide/choose-an-agent/) |
|
|
93
|
+
| Run locally in containers or in the cloud | [Execution backends](https://elie-laloum.github.io/outpost/guide/choose-a-sandbox/) |
|
|
94
94
|
| Reuse a sandbox across commands and agent turns | [Sandbox sessions](https://elie-laloum.github.io/outpost/guide/sandbox-sessions/) |
|
|
95
95
|
| Connect tasks and run independent work in parallel | [Task dependencies](https://elie-laloum.github.io/outpost/guide/task-dependencies/) |
|
|
96
|
-
| Coordinate changes across repositories | [Multi-repository workflows](https://elie-laloum.github.io/outpost/guide/
|
|
97
|
-
| Return data your application can validate | [Validated output](https://elie-laloum.github.io/outpost/guide/
|
|
98
|
-
| Build an agent with your own tools and instructions | [Custom harness](https://elie-laloum.github.io/outpost/guide/
|
|
99
|
-
| Resume or recover interrupted work | [Failure recovery](https://elie-laloum.github.io/outpost/guide/
|
|
96
|
+
| Coordinate changes across repositories | [Multi-repository workflows](https://elie-laloum.github.io/outpost/guide/multiple-repositories/) |
|
|
97
|
+
| Return data your application can validate | [Validated output](https://elie-laloum.github.io/outpost/guide/typed-responses/) |
|
|
98
|
+
| Build an agent with your own tools and instructions | [Custom harness](https://elie-laloum.github.io/outpost/guide/harness/) |
|
|
99
|
+
| Resume or recover interrupted work | [Failure recovery](https://elie-laloum.github.io/outpost/guide/recovery/) |
|
|
100
100
|
|
|
101
101
|
The [Guide](https://elie-laloum.github.io/outpost/guide/introduction/) explains behavior with focused examples. The [Reference](https://elie-laloum.github.io/outpost/reference/) documents exact contracts. Both are available in English and French.
|
|
102
102
|
|