@hellohelen-ai/goliath 0.0.1 → 0.0.2
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 +50 -0
- package/README.md +18 -0
- package/package.json +2 -1
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to this project are recorded here.
|
|
4
|
+
|
|
5
|
+
The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project
|
|
6
|
+
adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). While the version is below
|
|
7
|
+
`1.0.0`, a minor bump may carry a breaking change; the entry will say so.
|
|
8
|
+
|
|
9
|
+
## [Unreleased]
|
|
10
|
+
|
|
11
|
+
## [0.0.2] - 2026-09-03
|
|
12
|
+
|
|
13
|
+
No changes to the library. This is the first release published from CI, and it exists to prove
|
|
14
|
+
that path works end to end.
|
|
15
|
+
|
|
16
|
+
### Added
|
|
17
|
+
|
|
18
|
+
- `CHANGELOG.md` now ships inside the package.
|
|
19
|
+
|
|
20
|
+
### Changed
|
|
21
|
+
|
|
22
|
+
- Releases are published from GitHub Actions over OIDC trusted publishing and carry a provenance
|
|
23
|
+
attestation. No npm token exists for this package. Verify with `npm audit signatures`.
|
|
24
|
+
|
|
25
|
+
## [0.0.1] - 2026-09-03
|
|
26
|
+
|
|
27
|
+
First release.
|
|
28
|
+
|
|
29
|
+
### Added
|
|
30
|
+
|
|
31
|
+
- `createGoliath` — the turn loop: recall, conduct, work, judge, answer, remember.
|
|
32
|
+
- Step-at-a-time planning with a JSON plan whose tool names are an enum, so constrained decoding
|
|
33
|
+
cannot invent one.
|
|
34
|
+
- A worker that runs each step in a fresh context with one tool and a ≤600-character result.
|
|
35
|
+
- `defineTool`, with `writes: true` marking a tool that must be confirmed before it runs.
|
|
36
|
+
- Structural compression of tool results: a head, an omitted count, and a tail, with error lines
|
|
37
|
+
kept through the cut.
|
|
38
|
+
- A token budget that drops the oldest non-system messages first and never drops the last one.
|
|
39
|
+
- Escalation to a cloud fallback on a stalled loop, a repeated call, an invalid plan, bad tool
|
|
40
|
+
arguments, or three turns of model errors.
|
|
41
|
+
- A scribe that keeps recent exchanges verbatim and folds evicted ones into a running brief.
|
|
42
|
+
- Memory adapters: `inMemory` and `keyValueMemory`.
|
|
43
|
+
- `httpFallback` for handing a turn to a cloud agent.
|
|
44
|
+
- `@hellohelen-ai/goliath/testing` with `fakeModel`, a scripted model for tests.
|
|
45
|
+
- An eval runner scoring fixtures with `pass^k` over repeated runs, per-fixture escalation
|
|
46
|
+
expectations, and forbidden words.
|
|
47
|
+
|
|
48
|
+
[unreleased]: https://github.com/hellohelen-ai/goliath/compare/v0.0.2...HEAD
|
|
49
|
+
[0.0.2]: https://github.com/hellohelen-ai/goliath/compare/v0.0.1...v0.0.2
|
|
50
|
+
[0.0.1]: https://github.com/hellohelen-ai/goliath/releases/tag/v0.0.1
|
package/README.md
CHANGED
|
@@ -1,5 +1,10 @@
|
|
|
1
1
|
# Goliath
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/@hellohelen-ai/goliath)
|
|
4
|
+
[](https://github.com/hellohelen-ai/goliath/actions/workflows/ci.yml)
|
|
5
|
+
[](https://www.npmjs.com/package/@hellohelen-ai/goliath#provenance)
|
|
6
|
+
[](./LICENSE)
|
|
7
|
+
|
|
3
8
|
**An agent harness for the phone's own model.**
|
|
4
9
|
|
|
5
10
|
Apple ships a ~3B language model on every iPhone with Apple Intelligence. It is free, private, and
|
|
@@ -10,6 +15,10 @@ phone cannot finish.
|
|
|
10
15
|
|
|
11
16
|
It only needs one stone.
|
|
12
17
|
|
|
18
|
+
```sh
|
|
19
|
+
npm i @hellohelen-ai/goliath
|
|
20
|
+
```
|
|
21
|
+
|
|
13
22
|
```ts
|
|
14
23
|
import { createGoliath, defineTool } from "@hellohelen-ai/goliath";
|
|
15
24
|
import { apple } from "@react-native-ai/apple";
|
|
@@ -137,6 +146,15 @@ Early. The core loop, compression, memory, judge, and eval runner are here and t
|
|
|
137
146
|
scripted model. On-device runs and the Apple provider adapter are next. See `docs/` for the
|
|
138
147
|
research behind the design.
|
|
139
148
|
|
|
149
|
+
## Contributing
|
|
150
|
+
|
|
151
|
+
Issues and pull requests are welcome. `CONTRIBUTING.md` covers the setup, what a good change looks
|
|
152
|
+
like, and how releases are cut. Please report security issues
|
|
153
|
+
[privately](./SECURITY.md) rather than as a public issue.
|
|
154
|
+
|
|
155
|
+
Released versions are listed in [`CHANGELOG.md`](./CHANGELOG.md). Every release is published from
|
|
156
|
+
CI over OIDC with a provenance attestation — `npm audit signatures` will verify it.
|
|
157
|
+
|
|
140
158
|
## License
|
|
141
159
|
|
|
142
160
|
MIT
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@hellohelen-ai/goliath",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.2",
|
|
4
4
|
"description": "An agent harness for the phone's own model. Apple Foundation Models, a 4k window, one stone.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -24,6 +24,7 @@
|
|
|
24
24
|
"files": [
|
|
25
25
|
"dist",
|
|
26
26
|
"README.md",
|
|
27
|
+
"CHANGELOG.md",
|
|
27
28
|
"LICENSE"
|
|
28
29
|
],
|
|
29
30
|
"main": "./dist/index.js",
|