@zenera/neo 1.1.15 → 1.1.16
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/README.md +16 -16
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
an append-only trajectory.**
|
|
17
17
|
|
|
18
18
|
> Part of [ZeneraNeo](https://github.com/andreyryabov/ZeneraNeo). This is an
|
|
19
|
-
> open-source side project for experimentation and chore work
|
|
19
|
+
> open-source side project for experimentation and chore work - **not** the
|
|
20
20
|
> official Zenera AI Platform. It carries no support or stability promises.
|
|
21
21
|
|
|
22
22
|
## Install
|
|
@@ -41,7 +41,7 @@ or load them from a folder.
|
|
|
41
41
|
### In code
|
|
42
42
|
|
|
43
43
|
An agent is an instruction, a model, some tools, and who it may hand work to.
|
|
44
|
-
That is the whole list
|
|
44
|
+
That is the whole list - there is no orchestration layer underneath.
|
|
45
45
|
|
|
46
46
|
```ts
|
|
47
47
|
import { AgentRunner, createModel, tool } from '@zenera/neo';
|
|
@@ -72,7 +72,7 @@ console.log(result.output);
|
|
|
72
72
|
```
|
|
73
73
|
|
|
74
74
|
`run()` returns a handle: `await` it for the answer, or iterate it for the
|
|
75
|
-
stream
|
|
75
|
+
stream - token deltas plus a checkpoint for every model call, tool call,
|
|
76
76
|
handoff, fork and join.
|
|
77
77
|
|
|
78
78
|
```ts
|
|
@@ -88,7 +88,7 @@ them.
|
|
|
88
88
|
|
|
89
89
|
### From a folder
|
|
90
90
|
|
|
91
|
-
An agentic project is a folder
|
|
91
|
+
An agentic project is a folder - prompts, agent wiring, skills and tool
|
|
92
92
|
selections are Markdown and YAML files, not code buried inside an application.
|
|
93
93
|
Load one and run it:
|
|
94
94
|
|
|
@@ -127,29 +127,29 @@ agents:
|
|
|
127
127
|
```
|
|
128
128
|
|
|
129
129
|
It is validated strictly at load: an unknown tool, a handoff to nobody, a
|
|
130
|
-
missing prompt file
|
|
130
|
+
missing prompt file - each fails immediately, naming the offending key, instead
|
|
131
131
|
of surfacing three turns into a run as a confused model.
|
|
132
132
|
|
|
133
133
|
## What it gives you
|
|
134
134
|
|
|
135
|
-
- **Agents**
|
|
135
|
+
- **Agents** - an instruction, a model, tools, skills, who it may hand the work
|
|
136
136
|
to, and how it splits into parallel branches. There is no hidden orchestration
|
|
137
137
|
layer.
|
|
138
|
-
- **Models**
|
|
138
|
+
- **Models** - OpenAI, Anthropic, Google/Vertex and OpenRouter behind one
|
|
139
139
|
interface, each through its own SDK, plus any OpenAI-compatible endpoint.
|
|
140
140
|
Named providers and model aliases resolve from config or from the host.
|
|
141
|
-
- **Tools**
|
|
141
|
+
- **Tools** - plain typed functions, selectable per agent by name, group or
|
|
142
142
|
wildcard. Workspace file tools and a Podman sandbox ship with the library.
|
|
143
|
-
- **Skills**
|
|
143
|
+
- **Skills** - instruction bundles discovered and loaded on demand instead of
|
|
144
144
|
permanently occupying the prompt, optionally owning their own tools.
|
|
145
|
-
- **Memory**
|
|
145
|
+
- **Memory** - a timed, masked knowledge graph that outlives a run: recall
|
|
146
146
|
returns a stitched subgraph rather than a ranked list, remembered files are
|
|
147
147
|
mounted at `/memory`, and standing preferences go into the system prompt.
|
|
148
|
-
- **Trajectory**
|
|
148
|
+
- **Trajectory** - an append-only log of everything that happened. What is sent
|
|
149
149
|
to a provider is derived from it, and compaction _covers_ nodes rather than
|
|
150
150
|
deleting them, so the full record survives even when older turns have to be
|
|
151
151
|
pushed out of the context window.
|
|
152
|
-
- **Inspection**
|
|
152
|
+
- **Inspection** - `renderReportHtml` turns any run into one self-contained HTML
|
|
153
153
|
file: the graph, every request, every token.
|
|
154
154
|
|
|
155
155
|
## Entry points
|
|
@@ -174,14 +174,14 @@ folder.
|
|
|
174
174
|
|
|
175
175
|
| Package | What it is |
|
|
176
176
|
| ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
|
|
177
|
-
| [`@zenera/cli`](https://github.com/andreyryabov/ZeneraNeo/blob/main/packages/cli/README.md) | `zen`
|
|
178
|
-
| [`@zenera/faker`](https://github.com/andreyryabov/ZeneraNeo/blob/main/packages/faker/README.md) | `zen faker`
|
|
179
|
-
| [`@zenera/rag`](https://github.com/andreyryabov/ZeneraNeo/blob/main/packages/rag/README.md) | `zen rag`
|
|
177
|
+
| [`@zenera/cli`](https://github.com/andreyryabov/ZeneraNeo/blob/main/packages/cli/README.md) | `zen` - this runtime on the command line, with a TUI |
|
|
178
|
+
| [`@zenera/faker`](https://github.com/andreyryabov/ZeneraNeo/blob/main/packages/faker/README.md) | `zen faker` - a mock API from an openapi/swagger document |
|
|
179
|
+
| [`@zenera/rag`](https://github.com/andreyryabov/ZeneraNeo/blob/main/packages/rag/README.md) | `zen rag` - an API description as a searchable graph, + tools |
|
|
180
180
|
|
|
181
181
|
`@zenera/rag` also exports tools you can hand straight to `loadProject`, so an
|
|
182
182
|
agent can search an API it has never read.
|
|
183
183
|
|
|
184
184
|
## License
|
|
185
185
|
|
|
186
|
-
Early days and moving fast
|
|
186
|
+
Early days and moving fast - issues, questions and pull requests are welcome.
|
|
187
187
|
[MIT](LICENSE).
|