@lloyal-labs/lloyal-agents 1.0.0

package/dist/shared-root.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withSharedRoot = withSharedRoot;
+const effection_1 = require("effection");
+const sdk_1 = require("@lloyal-labs/sdk");
+const context_1 = require("./context");
+/**
+ * Scoped shared root branch with guaranteed cleanup
+ *
+ * Creates a root branch, prefills the system prompt, and passes it to
+ * the body function. The root is pruned via try/finally when the body
+ * returns or throws, regardless of whether children still exist.
+ *
+ * Use this for the cold-path pattern where multiple agents share a
+ * tokenized system prompt prefix. The `sharedPrefixLength` passed to
+ * the body enables KV savings calculation.
+ *
+ * @param opts - System prompt, tools, and sampling parameters
+ * @param body - Operation that receives the root branch and prefix length.
+ *   Typically calls {@link runAgents} or {@link useAgentPool} inside.
+ * @returns The body's return value
+ *
+ * @example Cold-path research with shared prefix
+ * ```typescript
+ * const { result, prefixLen } = yield* withSharedRoot(
+ *   { systemPrompt: RESEARCH_PROMPT, tools: toolsJson },
+ *   function*(root, prefixLen) {
+ *     const result = yield* runAgents({
+ *       tasks: questions.map(q => ({
+ *         systemPrompt: RESEARCH_PROMPT,
+ *         content: q,
+ *         tools: toolsJson,
+ *         parent: root,
+ *       })),
+ *       tools: toolMap,
+ *     });
+ *     return { result, prefixLen };
+ *   },
+ * );
+ * ```
+ *
+ * @category Agents
+ */
+function* withSharedRoot(opts, body) {
+    const ctx = yield* context_1.Ctx.expect();
+    const messages = [{ role: 'system', content: opts.systemPrompt }];
+    const fmtOpts = opts.tools
+        ? { tools: opts.tools, addGenerationPrompt: false }
+        : { addGenerationPrompt: false };
+    const fmt = ctx.formatChatSync(JSON.stringify(messages), fmtOpts);
+    const sharedTokens = ctx.tokenizeSync(fmt.prompt);
+    const root = sdk_1.Branch.create(ctx, 0, opts.params ?? { temperature: 0.5 });
+    yield* (0, effection_1.call)(() => root.prefill(sharedTokens));
+    try {
+        return yield* body(root, sharedTokens.length);
+    }
+    finally {
+        if (!root.disposed)
+            root.pruneSubtreeSync();
+    }
+}
+//# sourceMappingURL=shared-root.js.map

package/dist/shared-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-root.js","sourceRoot":"","sources":["../src/shared-root.ts"],"names":[],"mappings":";;AA0DA,wCAqBC;AA/ED,yCAAiC;AAEjC,0CAA0C;AAE1C,uCAAgC;AAiBhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,QAAe,CAAC,CAAC,cAAc,CAC7B,IAAuB,EACvB,IAAgE;IAEhE,MAAM,GAAG,GAAmB,KAAK,CAAC,CAAC,aAAG,CAAC,MAAM,EAAE,CAAC;IAEhD,MAAM,QAAQ,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK;QACxB,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE;QACnD,CAAC,CAAC,EAAE,mBAAmB,EAAE,KAAK,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAElD,MAAM,IAAI,GAAG,YAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;IACxE,KAAK,CAAC,CAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAE9C,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/dist/toolkit.d.ts

@@ -0,0 +1,38 @@
+import type { Tool } from './Tool';
+/**
+ * Aggregated tool registry for agent pool consumption
+ *
+ * Contains the `toolMap` for dispatch and `toolsJson` for prompt
+ * formatting. Created by {@link createToolkit}.
+ *
+ * @category Agents
+ */
+export interface Toolkit {
+    /** Name-to-instance map used by {@link useAgentPool} for tool dispatch */
+    toolMap: Map<string, Tool>;
+    /** JSON-serialized tool schemas passed to `formatChat()` via task specs */
+    toolsJson: string;
+}
+/**
+ * Aggregate an array of {@link Tool} instances into a toolkit
+ *
+ * Builds both the dispatch map and the JSON schema string from the
+ * tool array. Pass the result directly to {@link AgentPoolOptions}
+ * and {@link AgentTaskSpec}.
+ *
+ * @param tools - Tool instances to aggregate
+ * @returns Toolkit with `toolMap` and `toolsJson`
+ *
+ * @example
+ * ```typescript
+ * const { toolMap, toolsJson } = createToolkit([
+ *   new SearchTool(chunks, reranker),
+ *   new ReadFileTool(resources),
+ *   new GrepTool(resources),
+ * ]);
+ * ```
+ *
+ * @category Agents
+ */
+export declare function createToolkit(tools: Tool[]): Toolkit;
+//# sourceMappingURL=toolkit.d.ts.map

package/dist/toolkit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolkit.d.ts","sourceRoot":"","sources":["../src/toolkit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,0EAA0E;IAC1E,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3B,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAKpD"}

package/dist/toolkit.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createToolkit = createToolkit;
+/**
+ * Aggregate an array of {@link Tool} instances into a toolkit
+ *
+ * Builds both the dispatch map and the JSON schema string from the
+ * tool array. Pass the result directly to {@link AgentPoolOptions}
+ * and {@link AgentTaskSpec}.
+ *
+ * @param tools - Tool instances to aggregate
+ * @returns Toolkit with `toolMap` and `toolsJson`
+ *
+ * @example
+ * ```typescript
+ * const { toolMap, toolsJson } = createToolkit([
+ *   new SearchTool(chunks, reranker),
+ *   new ReadFileTool(resources),
+ *   new GrepTool(resources),
+ * ]);
+ * ```
+ *
+ * @category Agents
+ */
+function createToolkit(tools) {
+    return {
+        toolMap: new Map(tools.map(t => [t.name, t])),
+        toolsJson: JSON.stringify(tools.map(t => t.schema)),
+    };
+}
+//# sourceMappingURL=toolkit.js.map

package/dist/toolkit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolkit.js","sourceRoot":"","sources":["../src/toolkit.ts"],"names":[],"mappings":";;AAsCA,sCAKC;AA1BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,aAAa,CAAC,KAAa;IACzC,OAAO;QACL,OAAO,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;KACpD,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,380 @@
+import type { Branch } from '@lloyal-labs/sdk';
+/**
+ * JSON Schema definition for tool parameter validation
+ *
+ * Describes the shape of arguments a {@link Tool} accepts. Passed to the
+ * model via `formatChat()` so it can generate valid tool-call arguments.
+ *
+ * @category Agents
+ */
+export interface JsonSchema {
+    /** JSON Schema type (e.g. `"object"`, `"string"`, `"array"`) */
+    type: string;
+    /** Property definitions when `type` is `"object"` */
+    properties?: Record<string, unknown>;
+    /** Required property names when `type` is `"object"` */
+    required?: string[];
+    /** Additional schema constraints (minItems, enum, etc.) */
+    [key: string]: unknown;
+}
+/**
+ * OpenAI-compatible function tool schema
+ *
+ * The wrapper format expected by `formatChat()` when passing tools to the
+ * model. {@link Tool.schema} generates this automatically from the tool's
+ * `name`, `description`, and `parameters`.
+ *
+ * @category Agents
+ */
+export interface ToolSchema {
+    /** Always `"function"` for function-calling tools */
+    type: 'function';
+    /** Function definition containing name, description, and parameter schema */
+    function: {
+        /** Tool name — used as the function identifier in tool calls */
+        name: string;
+        /** Human-readable description shown to the model */
+        description: string;
+        /** JSON Schema describing the tool's arguments */
+        parameters: JsonSchema;
+    };
+}
+/**
+ * Execution context passed to {@link Tool.execute}
+ *
+ * Provides callbacks for reporting progress during long-running tool
+ * operations (e.g. reranker scoring chunks).
+ *
+ * @category Agents
+ */
+export interface ToolContext {
+    /** Progress callback for long-running operations */
+    onProgress?: (p: {
+        filled: number;
+        total: number;
+    }) => void;
+}
+/**
+ * Per-token trace entry captured when {@link AgentPoolOptions.trace} is true
+ *
+ * Each entry corresponds to one sampled token and the distribution state
+ * at the moment it was drawn. Available on {@link AgentResult.trace} after
+ * pool completion.
+ *
+ * @category Agents
+ */
+export interface TraceToken {
+    /** Decoded text for this token */
+    text: string;
+    /** Shannon entropy of the full vocabulary distribution (bits, base-2) */
+    entropy: number;
+    /** Surprisal of the chosen token: -log2(p) */
+    surprisal: number;
+}
+/**
+ * Task specification for a single agent in {@link useAgentPool}
+ *
+ * Each task defines the agent's system prompt, user content, available
+ * tools, and parent branch to fork from. The parent branch determines
+ * the agent's KV prefix — fork from a shared root to amortize system
+ * prompt tokenization across agents.
+ *
+ * @category Agents
+ */
+export interface AgentTaskSpec {
+    /** System prompt defining the agent's role and behavior */
+    systemPrompt: string;
+    /** User message content — the agent's specific sub-question or task */
+    content: string;
+    /** JSON-serialized tool schemas (from {@link createToolkit}) */
+    tools?: string;
+    /** PRNG seed for sampler diversity — pass different seeds per agent */
+    seed?: number;
+    /** Parent branch to fork from (required by {@link useAgentPool}) */
+    parent?: Branch;
+}
+/**
+ * Sampling parameters for generation
+ *
+ * Controls the sampler chain applied during token generation. Passed to
+ * {@link Branch.create}, {@link generate}, {@link diverge}, and agent
+ * pool tasks.
+ *
+ * @category Agents
+ */
+export interface SamplingParams {
+    /** Temperature for softmax scaling (0 = greedy, higher = more random) */
+    temperature?: number;
+    /** Nucleus sampling threshold — cumulative probability cutoff */
+    topP?: number;
+    /** Top-K sampling — keep only the K most likely tokens */
+    topK?: number;
+    /** Minimum probability threshold relative to the most likely token */
+    minP?: number;
+    /** Additional sampler-specific parameters */
+    [key: string]: unknown;
+}
+/**
+ * KV pressure thresholds controlling agent shutdown under context exhaustion
+ *
+ * Two thresholds govern what happens as remaining KV shrinks:
+ *
+ * **softLimit** (default 1024) — remaining KV floor for new work.
+ * Enforced at three points:
+ * - **SETTLE**: tool results that would cross this floor are rejected and
+ *   the agent is marked done. This is the primary enforcement point — tool
+ *   results (search results, etc.) are the largest KV consumers.
+ * - **PRODUCE (stop-token boundary)**: agents that want a non-terminal tool
+ *   call are hard-cut. Terminal tools (e.g. `report()`) still pass.
+ * - **INIT prefill**: agents that don't fit above this floor are dropped.
+ *
+ * Set to account for downstream pool needs (reporters, verification).
+ *
+ * **hardLimit** (default 128) — crash-prevention floor.
+ * When remaining drops below this, agents are killed immediately before
+ * `produceSync()`. Prevents `llama_decode` "no memory slot" failures.
+ * Pure safety net — should never be the primary budget control.
+ *
+ * @category Agents
+ */
+export interface PressureThresholds {
+    /**
+     * Remaining KV floor for new work (tokens). When remaining drops below
+     * this, SETTLE rejects tool results, PRODUCE hard-cuts non-terminal tool
+     * calls, and INIT drops agents that don't fit.
+     *
+     * Set to account for downstream pool needs (reporters, verification).
+     * Default: 1024
+     */
+    softLimit?: number;
+    /**
+     * Crash-prevention floor (tokens). When remaining drops below this,
+     * agents are killed immediately before `produceSync()`. Prevents
+     * `llama_decode` "no memory slot for batch" failures.
+     * Default: 128
+     */
+    hardLimit?: number;
+}
+/**
+ * Configuration for {@link useAgentPool} and {@link runAgents}
+ *
+ * @category Agents
+ */
+export interface AgentPoolOptions {
+    /** Agent task specifications — one per concurrent agent */
+    tasks: AgentTaskSpec[];
+    /**
+     * Tool registry mapping tool names to {@link Tool} instances.
+     *
+     * This is the **execution registry** — it determines which tools can be
+     * dispatched at runtime. It is distinct from the per-task `task.tools`
+     * JSON schema that tells the model which tools are available.
+     *
+     * The registry also controls {@link AgentPoolOptions.terminalTool | terminalTool}
+     * gating: if the registry contains only the terminal tool, agents are
+     * allowed to call it as their first action (e.g. reporter sub-agents).
+     * If the registry contains other tools, the first call must be
+     * non-terminal to prevent agents from reporting without doing work.
+     */
+    tools: Map<string, import('./Tool').Tool>;
+    /** Sampling parameters applied to all agents */
+    params?: SamplingParams;
+    /** Maximum tool-call turns per agent before forced termination */
+    maxTurns?: number;
+    /** Tool name that signals agent completion. When the model calls this tool,
+     *  findings are extracted from arguments and the agent is marked done.
+     *  The tool is intercepted — never dispatched to execute(). If omitted,
+     *  agents complete only via stop token or hard-cut. */
+    terminalTool?: string;
+    /** Enable per-token entropy/surprisal on `agent:produce` events */
+    trace?: boolean;
+    /** KV pressure thresholds — tune per pool. Reporter pools typically use
+     *  lower thresholds than research pools since they complete in a single
+     *  terminal tool call. See {@link PressureThresholds} for tuning guidance. */
+    pressure?: PressureThresholds;
+}
+/**
+ * Result for a single completed agent
+ *
+ * @category Agents
+ */
+export interface AgentResult {
+    /** Stable agent identifier (branch handle at creation time) */
+    agentId: number;
+    /** Parent branch handle — shared root for top-level agents, parent agentId for sub-agents */
+    parentAgentId: number;
+    /** The agent's branch — still alive when returned from {@link useAgentPool} */
+    branch: Branch;
+    /** Agent's research findings (from terminal tool or final output), or null */
+    findings: string | null;
+    /** Number of tool calls the agent made */
+    toolCallCount: number;
+    /** Total tokens generated by this agent */
+    tokenCount: number;
+    /** Model-level perplexity at completion (exp of mean NLL from raw logits) */
+    ppl: number;
+    /** Sampling-level perplexity at completion (from filtered distribution) */
+    samplingPpl: number;
+    /** Per-token trace data (present only when {@link AgentPoolOptions.trace} is true) */
+    trace?: TraceToken[];
+}
+/**
+ * Aggregate result from a completed agent pool run
+ *
+ * Returned by both {@link useAgentPool} and {@link runAgents}. Contains
+ * per-agent results plus aggregate statistics for display and telemetry.
+ *
+ * @category Agents
+ */
+export interface AgentPoolResult {
+    /** Per-agent results in task order */
+    agents: AgentResult[];
+    /** Sum of all agent token counts */
+    totalTokens: number;
+    /** Sum of all agent tool calls */
+    totalToolCalls: number;
+    /** Number of batched commit steps in the tick loop */
+    steps: number;
+    /** Internal performance counters for telemetry */
+    counters: {
+        /** Number of batch prefill calls for tool result injection */
+        warmPrefillCalls: number;
+        /** Total branches across all warm prefill batches */
+        warmPrefillBranches: number;
+        /** Ticks where no agent was generating (all awaiting tools) */
+        stalledTicks: number;
+        /** Peak concurrent tool executions */
+        maxConcurrentTools: number;
+        /** Ticks spent idle-waiting via action() */
+        idleTicks: number;
+    };
+}
+/**
+ * Options for single-branch {@link generate}
+ *
+ * @category Agents
+ */
+export interface GenerateOptions {
+    /** Pre-formatted prompt string (from `formatChat()` + `tokenize()`) */
+    prompt: string;
+    /** GBNF grammar string for constrained generation */
+    grammar?: string;
+    /** Sampling parameters */
+    params?: SamplingParams;
+    /** Optional parser applied to the raw output string */
+    parse?: (output: string) => unknown;
+}
+/**
+ * Result from single-branch {@link generate}
+ *
+ * @category Agents
+ */
+export interface GenerateResult<T = unknown> {
+    /** Raw generated text */
+    output: string;
+    /** Number of tokens generated */
+    tokenCount: number;
+    /** Parsed output (present only when `parse` was provided in options) */
+    parsed?: T;
+}
+/**
+ * Options for multi-branch {@link diverge}
+ *
+ * Either `parent` or `prompt` must be provided. When `parent` is given,
+ * branches fork from it and no new root is created. When only `prompt`
+ * is given, a fresh root is created, prefilled, and cleaned up on error.
+ *
+ * @category Agents
+ */
+export interface DivergeOptions {
+    /** Pre-formatted prompt for creating a fresh root (mutually exclusive with parent) */
+    prompt?: string;
+    /** Number of parallel generation attempts */
+    attempts: number;
+    /** Parent branch to fork from (mutually exclusive with prompt) */
+    parent?: Branch;
+    /** Sampling parameters for all attempts */
+    params?: SamplingParams;
+}
+/**
+ * Single attempt result from {@link diverge}
+ *
+ * @category Agents
+ */
+export interface DivergeAttempt {
+    /** The attempt's branch (only the best branch survives after diverge) */
+    branch: Branch;
+    /** Generated text for this attempt */
+    output: string;
+    /** Number of tokens generated */
+    tokenCount: number;
+    /** Model perplexity — lower indicates more coherent generation */
+    ppl: number;
+}
+/**
+ * Aggregate result from {@link diverge}
+ *
+ * The `best` branch is still alive; all other attempt branches have been
+ * pruned. The caller owns cleanup — typically via {@link Session.promote}
+ * to make the best branch the new conversation trunk.
+ *
+ * @category Agents
+ */
+export interface DivergeResult {
+    /** Lowest-perplexity branch — still alive, caller owns cleanup */
+    best: Branch;
+    /** Text output from the best attempt */
+    bestOutput: string;
+    /** All attempts (losers already pruned, branches disposed) */
+    attempts: DivergeAttempt[];
+    /** Sum of all attempt token counts */
+    totalTokens: number;
+    /** Number of batched commit steps */
+    steps: number;
+    /** Shared prefix length in tokens (for KV savings calculation) */
+    prefixLength: number;
+}
+/**
+ * Events emitted by the runtime during agent pool execution
+ *
+ * Subscribe to these via the `events` channel from {@link initAgents}.
+ * Harnesses can extend this union with phase-level events for display.
+ *
+ * @category Agents
+ */
+export type AgentEvent = {
+    type: 'agent:spawn';
+    agentId: number;
+    parentAgentId: number;
+} | {
+    type: 'agent:produce';
+    agentId: number;
+    text: string;
+    tokenCount: number;
+    entropy?: number;
+    surprisal?: number;
+} | {
+    type: 'agent:tool_call';
+    agentId: number;
+    tool: string;
+    args: string;
+} | {
+    type: 'agent:tool_result';
+    agentId: number;
+    tool: string;
+    result: string;
+} | {
+    type: 'agent:tool_progress';
+    agentId: number;
+    tool: string;
+    filled: number;
+    total: number;
+} | {
+    type: 'agent:report';
+    agentId: number;
+    findings: string;
+} | {
+    type: 'agent:done';
+    agentId: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@lloyal-labs/lloyal-agents",
+  "version": "1.0.0",
+  "description": "Multi-agent inference inside the decode loop — structured concurrency over shared KV state",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lloyal-ai/sdk.git",
+    "directory": "packages/agents"
+  },
+  "homepage": "https://github.com/lloyal-ai/sdk/tree/main/packages/agents#readme",
+  "bugs": {
+    "url": "https://github.com/lloyal-ai/sdk/issues"
+  },
+  "keywords": [
+    "llm",
+    "agents",
+    "multi-agent",
+    "inference",
+    "structured-concurrency",
+    "effection",
+    "llama.cpp"
+  ],
+  "license": "Apache-2.0",
+  "type": "commonjs",
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@lloyal-labs/sdk": "*",
+    "effection": "^4.0.2"
+  },
+  "files": [
+    "dist/"
+  ]
+}