@lloyal-labs/lloyal-agents 2.0.0 → 2.1.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.
- package/README.md +14 -14
- package/dist/Agent.d.ts +3 -3
- package/dist/Agent.d.ts.map +1 -1
- package/dist/Agent.js +2 -2
- package/dist/Agent.js.map +1 -1
- package/dist/AgentPolicy.d.ts +8 -8
- package/dist/AgentPolicy.d.ts.map +1 -1
- package/dist/AgentPolicy.js +10 -10
- package/dist/AgentPolicy.js.map +1 -1
- package/dist/Tool.d.ts +1 -1
- package/dist/Tool.js +1 -1
- package/dist/agent-pool.d.ts +4 -4
- package/dist/agent-pool.js +42 -42
- package/dist/agent-pool.js.map +1 -1
- package/dist/context.d.ts +10 -10
- package/dist/context.d.ts.map +1 -1
- package/dist/context.js +11 -11
- package/dist/context.js.map +1 -1
- package/dist/create-agent-pool.d.ts +10 -10
- package/dist/create-agent-pool.d.ts.map +1 -1
- package/dist/create-agent-pool.js +27 -27
- package/dist/create-agent-pool.js.map +1 -1
- package/dist/index.d.ts +3 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -4
- package/dist/index.js.map +1 -1
- package/dist/orchestrators.d.ts +8 -8
- package/dist/orchestrators.d.ts.map +1 -1
- package/dist/orchestrators.js +10 -10
- package/dist/orchestrators.js.map +1 -1
- package/dist/replay.d.ts +19 -19
- package/dist/replay.d.ts.map +1 -1
- package/dist/replay.js +29 -29
- package/dist/replay.js.map +1 -1
- package/dist/spine.d.ts +106 -0
- package/dist/spine.d.ts.map +1 -0
- package/dist/{shared-root.js → spine.js} +40 -37
- package/dist/spine.js.map +1 -0
- package/dist/trace-types.d.ts +4 -4
- package/dist/trace-types.d.ts.map +1 -1
- package/dist/types.d.ts +20 -14
- package/dist/types.d.ts.map +1 -1
- package/dist/use-agent.d.ts +3 -3
- package/dist/use-agent.d.ts.map +1 -1
- package/dist/use-agent.js +5 -5
- package/dist/use-agent.js.map +1 -1
- package/package.json +2 -2
- package/dist/shared-root.d.ts +0 -96
- package/dist/shared-root.d.ts.map +0 -1
- package/dist/shared-root.js.map +0 -1
package/dist/spine.d.ts
ADDED
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
import type { Operation } from "effection";
|
|
2
|
+
import { Branch } from "@lloyal-labs/sdk";
|
|
3
|
+
import type { Tool } from "./Tool";
|
|
4
|
+
import type { SamplingParams } from "./types";
|
|
5
|
+
/**
|
|
6
|
+
* Configuration for {@link withSpine}
|
|
7
|
+
*
|
|
8
|
+
* @category Agents
|
|
9
|
+
*/
|
|
10
|
+
export interface SpineOptions {
|
|
11
|
+
/** Sampling parameters for the spine branch */
|
|
12
|
+
params?: SamplingParams;
|
|
13
|
+
/**
|
|
14
|
+
* Set ScratchpadParent context so tools can fork from the spine
|
|
15
|
+
* for scratchpad extraction (fork-attend-extract-prune pattern).
|
|
16
|
+
* @default false
|
|
17
|
+
*/
|
|
18
|
+
enableScratchpad?: boolean;
|
|
19
|
+
/**
|
|
20
|
+
* Fork the spine from this branch instead of creating at position 0.
|
|
21
|
+
*
|
|
22
|
+
* When provided, the spine inherits the parent's full KV state —
|
|
23
|
+
* every tool call, tool result, and generated token the parent
|
|
24
|
+
* accumulated. Sub-agents forking from this spine attend over the
|
|
25
|
+
* parent's complete attention state (Continuous Context).
|
|
26
|
+
*
|
|
27
|
+
* When omitted, creates a fresh spine at position 0 (cold start).
|
|
28
|
+
*/
|
|
29
|
+
parent?: Branch;
|
|
30
|
+
/**
|
|
31
|
+
* When set, prefill the chat-format `[system + tools]` header onto the
|
|
32
|
+
* spine once at setup. Every agent forking from the spine inherits these
|
|
33
|
+
* tokens via `forkSync`'s metadata-only KV prefix-share — the role and
|
|
34
|
+
* tool schemas appear ONCE in physical KV regardless of how many agents
|
|
35
|
+
* the pool spawns.
|
|
36
|
+
*
|
|
37
|
+
* The resulting `FormatConfig` (parser/grammar/format/triggers) is set
|
|
38
|
+
* on the {@link SpineFmt} context so `setupAgent` can detect shared mode,
|
|
39
|
+
* skip its own system+tools formatting, and inherit the dispatch-side
|
|
40
|
+
* fmt from the spine.
|
|
41
|
+
*
|
|
42
|
+
* Use this for orchestrators where every agent shares the same role —
|
|
43
|
+
* chain-mode research pools, fanout-style same-role pools, etc. Mixed-
|
|
44
|
+
* role workflows (research → compare → synthesize) keep using per-spec
|
|
45
|
+
* `SpawnSpec.systemPrompt` and don't pass this option.
|
|
46
|
+
*/
|
|
47
|
+
systemPrompt?: string;
|
|
48
|
+
/**
|
|
49
|
+
* Tools whose schemas embed into the chat-format header prefilled at setup.
|
|
50
|
+
* Their JSON schemas are decoded into the spine's KV ONCE; every agent
|
|
51
|
+
* forking from the spine inherits the schema tokens via fork prefix-share
|
|
52
|
+
* instead of re-emitting them in its own suffix.
|
|
53
|
+
*
|
|
54
|
+
* The same `Tool[]` is typically also passed to `agentPool` (where it
|
|
55
|
+
* becomes the dispatcher registry). Two roles, one input — schemas
|
|
56
|
+
* decoded once into the spine, instances registered for runtime
|
|
57
|
+
* `tool.execute()` dispatch.
|
|
58
|
+
*
|
|
59
|
+
* Only applied when `systemPrompt` is also set (shared mode); ignored
|
|
60
|
+
* otherwise.
|
|
61
|
+
*/
|
|
62
|
+
tools?: Tool[];
|
|
63
|
+
/**
|
|
64
|
+
* Whether to enable thinking-mode tokens (e.g. `<think>` blocks) when
|
|
65
|
+
* formatting the spine's chat-format header. Threaded through to the
|
|
66
|
+
* chat-format call AND stored on the `SpineFmt` FormatConfig so
|
|
67
|
+
* `setupAgent`'s shared-mode shortcut copies a parser/grammar/triggers
|
|
68
|
+
* configuration consistent with the per-agent suffix formatting.
|
|
69
|
+
*
|
|
70
|
+
* Should match the `enableThinking` value the caller passes to the agent
|
|
71
|
+
* pool — divergent values produce inconsistent grammar between the
|
|
72
|
+
* prefilled spine and per-agent suffixes.
|
|
73
|
+
*
|
|
74
|
+
* @default false
|
|
75
|
+
*/
|
|
76
|
+
enableThinking?: boolean;
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* Scoped spine branch with guaranteed cleanup
|
|
80
|
+
*
|
|
81
|
+
* Creates (or forks) the pool's spine — the shared KV line that agents
|
|
82
|
+
* fork from and that `ctx.extendSpine` writes onto between tasks. The
|
|
83
|
+
* spine is pruned via try/finally when the body returns or throws,
|
|
84
|
+
* regardless of whether children still exist.
|
|
85
|
+
*
|
|
86
|
+
* Each agent's chat format (system + user + generation prompt) is rendered
|
|
87
|
+
* fresh inside `setupAgent`, so this spine carries no chat context itself —
|
|
88
|
+
* it exists as the pool's branching point and as the line that
|
|
89
|
+
* `ctx.extendSpine` writes onto between tasks.
|
|
90
|
+
*
|
|
91
|
+
* **Cold path** (no `parent`): creates a spine at position 0 with no prefill.
|
|
92
|
+
* Agents fork at position 0; their full chat context lives in their own suffix.
|
|
93
|
+
*
|
|
94
|
+
* **Warm path** (`parent` provided): forks from parent and prefills a turn
|
|
95
|
+
* separator so subsequent agent suffixes land on a clean turn boundary.
|
|
96
|
+
* Sub-agents inherit the parent's full KV state via the fork.
|
|
97
|
+
*
|
|
98
|
+
* @param opts - Sampling parameters and optional parent branch
|
|
99
|
+
* @param body - Operation that receives the spine branch and prefix length.
|
|
100
|
+
* Typically calls {@link useAgentPool} inside.
|
|
101
|
+
* @returns The body's return value
|
|
102
|
+
*
|
|
103
|
+
* @category Agents
|
|
104
|
+
*/
|
|
105
|
+
export declare function withSpine<T>(opts: SpineOptions, body: (spine: Branch, prefixLength: number) => Operation<T>): Operation<T>;
|
|
106
|
+
//# sourceMappingURL=spine.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"spine.d.ts","sourceRoot":"","sources":["../src/spine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAK1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAiB,SAAS,CAAC,CAAC,EAC1B,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAC1D,SAAS,CAAC,CAAC,CAAC,CAwHd"}
|
|
@@ -1,23 +1,25 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.
|
|
3
|
+
exports.withSpine = withSpine;
|
|
4
4
|
const effection_1 = require("effection");
|
|
5
5
|
const sdk_1 = require("@lloyal-labs/sdk");
|
|
6
6
|
const context_1 = require("./context");
|
|
7
7
|
const trace_scope_1 = require("./trace-scope");
|
|
8
|
+
const toolkit_1 = require("./toolkit");
|
|
8
9
|
/**
|
|
9
|
-
* Scoped
|
|
10
|
+
* Scoped spine branch with guaranteed cleanup
|
|
10
11
|
*
|
|
11
|
-
* Creates (or forks)
|
|
12
|
-
*
|
|
12
|
+
* Creates (or forks) the pool's spine — the shared KV line that agents
|
|
13
|
+
* fork from and that `ctx.extendSpine` writes onto between tasks. The
|
|
14
|
+
* spine is pruned via try/finally when the body returns or throws,
|
|
13
15
|
* regardless of whether children still exist.
|
|
14
16
|
*
|
|
15
17
|
* Each agent's chat format (system + user + generation prompt) is rendered
|
|
16
|
-
* fresh inside `setupAgent`, so this
|
|
17
|
-
* it exists as the pool's branching point and as the
|
|
18
|
-
* `ctx.
|
|
18
|
+
* fresh inside `setupAgent`, so this spine carries no chat context itself —
|
|
19
|
+
* it exists as the pool's branching point and as the line that
|
|
20
|
+
* `ctx.extendSpine` writes onto between tasks.
|
|
19
21
|
*
|
|
20
|
-
* **Cold path** (no `parent`): creates a
|
|
22
|
+
* **Cold path** (no `parent`): creates a spine at position 0 with no prefill.
|
|
21
23
|
* Agents fork at position 0; their full chat context lives in their own suffix.
|
|
22
24
|
*
|
|
23
25
|
* **Warm path** (`parent` provided): forks from parent and prefills a turn
|
|
@@ -25,13 +27,13 @@ const trace_scope_1 = require("./trace-scope");
|
|
|
25
27
|
* Sub-agents inherit the parent's full KV state via the fork.
|
|
26
28
|
*
|
|
27
29
|
* @param opts - Sampling parameters and optional parent branch
|
|
28
|
-
* @param body - Operation that receives the
|
|
30
|
+
* @param body - Operation that receives the spine branch and prefix length.
|
|
29
31
|
* Typically calls {@link useAgentPool} inside.
|
|
30
32
|
* @returns The body's return value
|
|
31
33
|
*
|
|
32
34
|
* @category Agents
|
|
33
35
|
*/
|
|
34
|
-
function*
|
|
36
|
+
function* withSpine(opts, body) {
|
|
35
37
|
const ctx = yield* context_1.Ctx.expect();
|
|
36
38
|
const tw = yield* context_1.Trace.expect();
|
|
37
39
|
// Read parent trace ID — connects nested pools to the outer DISPATCH that spawned them
|
|
@@ -44,21 +46,21 @@ function* withSharedRoot(opts, body) {
|
|
|
44
46
|
catch {
|
|
45
47
|
/* no parent — top level */
|
|
46
48
|
}
|
|
47
|
-
const scope = (0, trace_scope_1.traceScope)(tw, parentTraceId, "
|
|
49
|
+
const scope = (0, trace_scope_1.traceScope)(tw, parentTraceId, "withSpine", {
|
|
48
50
|
hasParent: !!opts.parent,
|
|
49
51
|
});
|
|
50
52
|
// Warm path: fork from parent branch (inherits full KV state), prefill a
|
|
51
53
|
// turn separator so the next agent's suffix lands on a clean boundary.
|
|
52
|
-
// Cold path: create fresh
|
|
54
|
+
// Cold path: create fresh spine at position 0 with no prefill — agents
|
|
53
55
|
// fork at 0 and carry their full chat context in their own suffix.
|
|
54
|
-
let
|
|
56
|
+
let spine;
|
|
55
57
|
let prefillTokens;
|
|
56
58
|
if (opts.parent) {
|
|
57
|
-
|
|
59
|
+
spine = opts.parent.forkSync();
|
|
58
60
|
prefillTokens = ctx.getTurnSeparator();
|
|
59
61
|
}
|
|
60
62
|
else {
|
|
61
|
-
|
|
63
|
+
spine = sdk_1.Branch.create(ctx, 0, opts.params ?? { temperature: 0.5 });
|
|
62
64
|
prefillTokens = [];
|
|
63
65
|
}
|
|
64
66
|
tw.write({
|
|
@@ -66,30 +68,30 @@ function* withSharedRoot(opts, body) {
|
|
|
66
68
|
parentTraceId: scope.traceId,
|
|
67
69
|
ts: performance.now(),
|
|
68
70
|
type: "branch:create",
|
|
69
|
-
branchHandle:
|
|
71
|
+
branchHandle: spine.handle,
|
|
70
72
|
parentHandle: opts.parent?.handle ?? null,
|
|
71
73
|
position: opts.parent ? opts.parent.position : 0,
|
|
72
|
-
role: "
|
|
74
|
+
role: "spine",
|
|
73
75
|
});
|
|
74
76
|
if (prefillTokens.length > 0) {
|
|
75
|
-
yield* (0, effection_1.call)(() =>
|
|
77
|
+
yield* (0, effection_1.call)(() => spine.prefill(prefillTokens));
|
|
76
78
|
tw.write({
|
|
77
79
|
traceId: tw.nextId(),
|
|
78
80
|
parentTraceId: scope.traceId,
|
|
79
81
|
ts: performance.now(),
|
|
80
82
|
type: "branch:prefill",
|
|
81
|
-
branchHandle:
|
|
83
|
+
branchHandle: spine.handle,
|
|
82
84
|
tokenCount: prefillTokens.length,
|
|
83
|
-
role: "
|
|
85
|
+
role: "spineHeader",
|
|
84
86
|
});
|
|
85
87
|
}
|
|
86
88
|
// Shared role+tools mode: format the chat header once and prefill onto
|
|
87
|
-
// the
|
|
89
|
+
// the spine. Agents forking from this spine inherit system+tools tokens
|
|
88
90
|
// via metadata-only prefix-share (no per-spawn re-prefill). The resulting
|
|
89
|
-
// FormatConfig is stashed on
|
|
91
|
+
// FormatConfig is stashed on SpineFmt so setupAgent can detect shared
|
|
90
92
|
// mode and copy parser/grammar/format/triggers without re-emitting the
|
|
91
93
|
// tool schemas in each agent's suffix.
|
|
92
|
-
let
|
|
94
|
+
let spineFmt = null;
|
|
93
95
|
if (opts.systemPrompt !== undefined) {
|
|
94
96
|
const enableThinking = opts.enableThinking ?? false;
|
|
95
97
|
const messages = JSON.stringify([{ role: "system", content: opts.systemPrompt }]);
|
|
@@ -100,23 +102,24 @@ function* withSharedRoot(opts, body) {
|
|
|
100
102
|
// trailing assistant generation prompt and corrupt the boundary.
|
|
101
103
|
addGenerationPrompt: false,
|
|
102
104
|
};
|
|
103
|
-
if (opts.
|
|
104
|
-
fmtOpts.tools = opts.toolsJson;
|
|
105
|
+
if (opts.tools && opts.tools.length > 0) {
|
|
106
|
+
fmtOpts.tools = (0, toolkit_1.createToolkit)(opts.tools).toolsJson;
|
|
107
|
+
}
|
|
105
108
|
const formatted = ctx.formatChatSync(messages, fmtOpts);
|
|
106
109
|
const headerTokens = ctx.tokenizeSync(formatted.prompt, false);
|
|
107
110
|
if (headerTokens.length > 0) {
|
|
108
|
-
yield* (0, effection_1.call)(() =>
|
|
111
|
+
yield* (0, effection_1.call)(() => spine.prefill(headerTokens));
|
|
109
112
|
tw.write({
|
|
110
113
|
traceId: tw.nextId(),
|
|
111
114
|
parentTraceId: scope.traceId,
|
|
112
115
|
ts: performance.now(),
|
|
113
116
|
type: "branch:prefill",
|
|
114
|
-
branchHandle:
|
|
117
|
+
branchHandle: spine.handle,
|
|
115
118
|
tokenCount: headerTokens.length,
|
|
116
|
-
role: "
|
|
119
|
+
role: "spineHeader",
|
|
117
120
|
});
|
|
118
121
|
}
|
|
119
|
-
|
|
122
|
+
spineFmt = {
|
|
120
123
|
format: formatted.format,
|
|
121
124
|
reasoningFormat: formatted.reasoningFormat,
|
|
122
125
|
generationPrompt: formatted.generationPrompt,
|
|
@@ -129,24 +132,24 @@ function* withSharedRoot(opts, body) {
|
|
|
129
132
|
}
|
|
130
133
|
try {
|
|
131
134
|
if (opts.enableScratchpad)
|
|
132
|
-
yield* context_1.ScratchpadParent.set(
|
|
133
|
-
if (
|
|
134
|
-
yield* context_1.
|
|
135
|
-
return yield* body(
|
|
135
|
+
yield* context_1.ScratchpadParent.set(spine);
|
|
136
|
+
if (spineFmt)
|
|
137
|
+
yield* context_1.SpineFmt.set(spineFmt);
|
|
138
|
+
return yield* body(spine, prefillTokens.length);
|
|
136
139
|
}
|
|
137
140
|
finally {
|
|
138
|
-
if (!
|
|
141
|
+
if (!spine.disposed) {
|
|
139
142
|
tw.write({
|
|
140
143
|
traceId: tw.nextId(),
|
|
141
144
|
parentTraceId: scope.traceId,
|
|
142
145
|
ts: performance.now(),
|
|
143
146
|
type: "branch:prune",
|
|
144
|
-
branchHandle:
|
|
147
|
+
branchHandle: spine.handle,
|
|
145
148
|
position: 0,
|
|
146
149
|
});
|
|
147
|
-
|
|
150
|
+
spine.pruneSubtreeSync();
|
|
148
151
|
}
|
|
149
152
|
scope.close();
|
|
150
153
|
}
|
|
151
154
|
}
|
|
152
|
-
//# sourceMappingURL=
|
|
155
|
+
//# sourceMappingURL=spine.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"spine.js","sourceRoot":"","sources":["../src/spine.ts"],"names":[],"mappings":"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"}
|
package/dist/trace-types.d.ts
CHANGED
|
@@ -45,18 +45,18 @@ export type TraceEvent = (TraceEventBase & {
|
|
|
45
45
|
messages: string;
|
|
46
46
|
tools?: string;
|
|
47
47
|
grammar?: string;
|
|
48
|
-
role: '
|
|
48
|
+
role: 'spine' | 'agentSuffix' | 'generate' | 'diverge' | 'toolResultDelta';
|
|
49
49
|
}) | (TraceEventBase & {
|
|
50
50
|
type: 'branch:create';
|
|
51
51
|
branchHandle: number;
|
|
52
52
|
parentHandle: number | null;
|
|
53
53
|
position: number;
|
|
54
|
-
role: 'root' | '
|
|
54
|
+
role: 'root' | 'spine' | 'agentFork' | 'scratchpad' | 'divergeAttempt';
|
|
55
55
|
}) | (TraceEventBase & {
|
|
56
56
|
type: 'branch:prefill';
|
|
57
57
|
branchHandle: number;
|
|
58
58
|
tokenCount: number;
|
|
59
|
-
role: '
|
|
59
|
+
role: 'spineHeader' | 'agentSuffix' | 'toolResult' | 'warmDelta' | 'scratchpad' | 'probe' | 'recovery';
|
|
60
60
|
probeText?: string;
|
|
61
61
|
}) | (TraceEventBase & {
|
|
62
62
|
type: 'branch:prune';
|
|
@@ -120,7 +120,7 @@ export type TraceEvent = (TraceEventBase & {
|
|
|
120
120
|
tokenCount: number;
|
|
121
121
|
outputLength: number;
|
|
122
122
|
}) | (TraceEventBase & {
|
|
123
|
-
type: 'pool:
|
|
123
|
+
type: 'pool:recoveryReturn';
|
|
124
124
|
agentId: number;
|
|
125
125
|
resultLength: number;
|
|
126
126
|
}) | (TraceEventBase & {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"trace-types.d.ts","sourceRoot":"","sources":["../src/trace-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,sCAAsC;AACtC,UAAU,cAAc;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,UAAU,GAEpB,CAAE,cAAc,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,KACrF,cAAc,GAAG;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,KAG1E,cAAc,GAAG;IACf,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,
|
|
1
|
+
{"version":3,"file":"trace-types.d.ts","sourceRoot":"","sources":["../src/trace-types.ts"],"names":[],"mappings":"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"}
|
package/dist/types.d.ts
CHANGED
|
@@ -56,7 +56,7 @@ export interface ToolContext {
|
|
|
56
56
|
agentId: number;
|
|
57
57
|
/**
|
|
58
58
|
* The calling agent's branch — use for recursive tools that spawn
|
|
59
|
-
* sub-agents via {@link
|
|
59
|
+
* sub-agents via {@link withSpine} with `parent` option.
|
|
60
60
|
* Sub-agents forking from this branch inherit the agent's full
|
|
61
61
|
* KV state (Continuous Context).
|
|
62
62
|
*/
|
|
@@ -202,10 +202,10 @@ export interface PressureThresholds {
|
|
|
202
202
|
*/
|
|
203
203
|
export interface AgentPoolOptions {
|
|
204
204
|
/**
|
|
205
|
-
*
|
|
206
|
-
* Produced by {@link
|
|
205
|
+
* Spine branch. Orchestrator-spawned agents fork from this by default.
|
|
206
|
+
* Produced by {@link withSpine} in the {@link agentPool} wrapper.
|
|
207
207
|
*/
|
|
208
|
-
|
|
208
|
+
spine: Branch;
|
|
209
209
|
/**
|
|
210
210
|
* Orchestrator callback — declares the execution pattern (parallel, chain,
|
|
211
211
|
* fanout, dag, or a custom shape). Drives task spawning, waiting, and
|
|
@@ -233,17 +233,19 @@ export interface AgentPoolOptions {
|
|
|
233
233
|
/** Maximum tool-call turns per agent before forced termination */
|
|
234
234
|
maxTurns?: number;
|
|
235
235
|
/** Tool name that signals agent completion. When the model calls this tool,
|
|
236
|
-
*
|
|
237
|
-
* The tool
|
|
238
|
-
*
|
|
239
|
-
|
|
236
|
+
* the result is extracted from its arguments and the agent is marked done.
|
|
237
|
+
* The tool's execute() code-path is not reached — the framework intercepts
|
|
238
|
+
* the call at the policy layer and treats it as the agent's return. If
|
|
239
|
+
* omitted, agents complete only via stop token, free-text return, or
|
|
240
|
+
* hard-cut. */
|
|
241
|
+
terminalToolName?: string;
|
|
240
242
|
/** Enable per-token entropy/surprisal on `agent:produce` events */
|
|
241
243
|
trace?: boolean;
|
|
242
|
-
/** Prune agent branches immediately when they
|
|
243
|
-
* Frees KV for remaining agents mid-pool. Only agents
|
|
244
|
-
*
|
|
245
|
-
*
|
|
246
|
-
|
|
244
|
+
/** Prune agent branches immediately when they voluntarily return via the
|
|
245
|
+
* terminal tool. Frees KV for remaining agents mid-pool. Only agents
|
|
246
|
+
* that voluntarily returned are pruned — hard-cut agents keep their
|
|
247
|
+
* branches for scratchpad recovery. @default false */
|
|
248
|
+
pruneOnReturn?: boolean;
|
|
247
249
|
/** Custom agent policy. Configure recovery (scratchpad extraction),
|
|
248
250
|
* time limits, explore/exploit threshold, and tool guards via
|
|
249
251
|
* {@link DefaultAgentPolicyOpts}. @default DefaultAgentPolicy with default opts */
|
|
@@ -446,7 +448,11 @@ export type AgentEvent = {
|
|
|
446
448
|
filled: number;
|
|
447
449
|
total: number;
|
|
448
450
|
} | {
|
|
449
|
-
type: 'agent:
|
|
451
|
+
type: 'agent:return';
|
|
452
|
+
agentId: number;
|
|
453
|
+
result: string;
|
|
454
|
+
} | {
|
|
455
|
+
type: 'agent:recovered';
|
|
450
456
|
agentId: number;
|
|
451
457
|
result: string;
|
|
452
458
|
} | {
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/dist/use-agent.d.ts
CHANGED
|
@@ -18,7 +18,7 @@ export interface UseAgentOpts {
|
|
|
18
18
|
/** Tools available to the agent. Optional — pool degenerates cleanly without tools. */
|
|
19
19
|
tools?: Tool[];
|
|
20
20
|
/** Terminal tool name — tool must be in the tools array. */
|
|
21
|
-
|
|
21
|
+
terminalToolName?: string;
|
|
22
22
|
/** Max tool-use turns before hard cut. @default 100 */
|
|
23
23
|
maxTurns?: number;
|
|
24
24
|
/** JSON Schema for eager grammar constraint (deferred: Zod support). */
|
|
@@ -44,7 +44,7 @@ export interface UseAgentOpts {
|
|
|
44
44
|
* root and agent branch alive until the caller's scope exits — caller can
|
|
45
45
|
* fork from the Agent's branch for verification or follow-up.
|
|
46
46
|
*
|
|
47
|
-
* Root managed via `ensure()` (not `
|
|
47
|
+
* Root managed via `ensure()` (not `withSpine`) because the resource
|
|
48
48
|
* lifetime requires the root alive until the caller's scope exits.
|
|
49
49
|
*
|
|
50
50
|
* Events stream passively to the broadcast Channel during the inline drain.
|
|
@@ -58,7 +58,7 @@ export interface UseAgentOpts {
|
|
|
58
58
|
* systemPrompt: "You are a research assistant.",
|
|
59
59
|
* task: "Find information about X",
|
|
60
60
|
* tools: [searchTool, reportTool],
|
|
61
|
-
*
|
|
61
|
+
* terminalToolName: 'report',
|
|
62
62
|
* });
|
|
63
63
|
* // agent.result — findings
|
|
64
64
|
* // agent.branch — alive, can fork from
|
package/dist/use-agent.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"use-agent.d.ts","sourceRoot":"","sources":["../src/use-agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAMhC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAc,MAAM,SAAS,CAAC;AAEtE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,4DAA4D;IAC5D,
|
|
1
|
+
{"version":3,"file":"use-agent.d.ts","sourceRoot":"","sources":["../src/use-agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAMhC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAc,MAAM,SAAS,CAAC;AAEtE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,CA+D7D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAiB,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,CAI3D"}
|
package/dist/use-agent.js
CHANGED
|
@@ -19,7 +19,7 @@ const orchestrators_1 = require("./orchestrators");
|
|
|
19
19
|
* root and agent branch alive until the caller's scope exits — caller can
|
|
20
20
|
* fork from the Agent's branch for verification or follow-up.
|
|
21
21
|
*
|
|
22
|
-
* Root managed via `ensure()` (not `
|
|
22
|
+
* Root managed via `ensure()` (not `withSpine`) because the resource
|
|
23
23
|
* lifetime requires the root alive until the caller's scope exits.
|
|
24
24
|
*
|
|
25
25
|
* Events stream passively to the broadcast Channel during the inline drain.
|
|
@@ -33,7 +33,7 @@ const orchestrators_1 = require("./orchestrators");
|
|
|
33
33
|
* systemPrompt: "You are a research assistant.",
|
|
34
34
|
* task: "Find information about X",
|
|
35
35
|
* tools: [searchTool, reportTool],
|
|
36
|
-
*
|
|
36
|
+
* terminalToolName: 'report',
|
|
37
37
|
* });
|
|
38
38
|
* // agent.result — findings
|
|
39
39
|
* // agent.branch — alive, can fork from
|
|
@@ -52,7 +52,7 @@ function useAgent(opts) {
|
|
|
52
52
|
hasTools: !!(opts.tools?.length),
|
|
53
53
|
hasParent: !!warmParent,
|
|
54
54
|
});
|
|
55
|
-
// Create root — ensure() for resource lifetime (not
|
|
55
|
+
// Create root — ensure() for resource lifetime (not withSpine's try/finally).
|
|
56
56
|
// The root carries no chat context; the agent's suffix (formatted fresh in
|
|
57
57
|
// setupAgent) is the agent's full chat. Warm path prefills a turn separator
|
|
58
58
|
// so the suffix lands on a clean turn boundary.
|
|
@@ -76,11 +76,11 @@ function useAgent(opts) {
|
|
|
76
76
|
// Delegate to useAgentPool N=1 via a trivial parallel orchestrator
|
|
77
77
|
const hasTools = !!(opts.tools?.length);
|
|
78
78
|
const sub = yield* (0, agent_pool_1.useAgentPool)({
|
|
79
|
-
root,
|
|
79
|
+
spine: root,
|
|
80
80
|
orchestrate: (0, orchestrators_1.parallel)([{ content: opts.task, systemPrompt: opts.systemPrompt }]),
|
|
81
81
|
toolsJson: hasTools ? toolkit.toolsJson : '',
|
|
82
82
|
tools: toolkit.toolMap,
|
|
83
|
-
|
|
83
|
+
terminalToolName: opts.terminalToolName,
|
|
84
84
|
maxTurns: opts.maxTurns,
|
|
85
85
|
policy: opts.policy,
|
|
86
86
|
trace: opts.trace,
|
package/dist/use-agent.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"use-agent.js","sourceRoot":"","sources":["../src/use-agent.ts"],"names":[],"mappings":";;AA4EA,4BA+DC;AAuBD,sBAIC;AAtKD,yCAA2D;AAE3D,0CAA0C;AAG1C,uCAA+C;AAC/C,6CAA4C;AAC5C,uCAA0C;AAC1C,+CAA2C;AAC3C,mDAA2C;AAmC3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,SAAgB,QAAQ,CAAC,IAAkB;IACzC,OAAO,IAAA,oBAAQ,EAAC,QAAQ,CAAC,EAAC,OAAO;QAC/B,MAAM,GAAG,GAAmB,KAAK,CAAC,CAAC,aAAG,CAAC,MAAM,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,gBAAM,CAAC,MAAM,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,eAAK,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,IAAA,uBAAa,EAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,SAAS,CAAC;QAEnE,MAAM,KAAK,GAAG,IAAA,wBAAU,EAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;YAC7C,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC;YAChC,SAAS,EAAE,CAAC,CAAC,UAAU;SACxB,CAAC,CAAC;QAEH,
|
|
1
|
+
{"version":3,"file":"use-agent.js","sourceRoot":"","sources":["../src/use-agent.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lloyal-labs/lloyal-agents",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.1.0",
|
|
4
4
|
"description": "Multi-agent inference inside the decode loop — structured concurrency over shared KV state",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -31,7 +31,7 @@
|
|
|
31
31
|
"build": "tsc -b"
|
|
32
32
|
},
|
|
33
33
|
"dependencies": {
|
|
34
|
-
"@lloyal-labs/sdk": "^2.
|
|
34
|
+
"@lloyal-labs/sdk": "^2.1.0",
|
|
35
35
|
"effection": "^4.0.2",
|
|
36
36
|
"eta": "^4.5.1"
|
|
37
37
|
},
|