@lloyal-labs/lloyal-agents 2.0.0 → 2.1.0

package/dist/shared-root.d.ts

@@ -1,96 +0,0 @@
-import type { Operation } from "effection";
-import { Branch } from "@lloyal-labs/sdk";
-import type { SamplingParams } from "./types";
-/**
- * Configuration for {@link withSharedRoot}
- *
- * @category Agents
- */
-export interface SharedRootOptions {
-    /** Sampling parameters for the root branch */
-    params?: SamplingParams;
-    /**
-     * Set ScratchpadParent context so tools can fork from the shared root
-     * for scratchpad extraction (fork-attend-extract-prune pattern).
-     * @default false
-     */
-    enableScratchpad?: boolean;
-    /**
-     * Fork root from this branch instead of creating at position 0.
-     *
-     * When provided, the root inherits the parent's full KV state —
-     * every tool call, tool result, and generated token the parent
-     * accumulated. Sub-agents forking from this root attend over the
-     * parent's complete attention state (Continuous Context).
-     *
-     * When omitted, creates a fresh root at position 0 (cold start).
-     */
-    parent?: Branch;
-    /**
-     * When set, prefill the chat-format `[system + tools]` header onto the
-     * root once at setup. Every agent forking from the root inherits these
-     * tokens via `forkSync`'s metadata-only KV prefix-share — the role and
-     * tool schemas appear ONCE in physical KV regardless of how many agents
-     * the pool spawns.
-     *
-     * The resulting `FormatConfig` (parser/grammar/format/triggers) is set
-     * on the {@link RootFmt} context so `setupAgent` can detect shared mode,
-     * skip its own system+tools formatting, and inherit the dispatch-side
-     * fmt from the root.
-     *
-     * Use this for orchestrators where every agent shares the same role —
-     * chain-mode research pools, fanout-style same-role pools, etc. Mixed-
-     * role workflows (research → compare → synthesize) keep using per-spec
-     * `SpawnSpec.systemPrompt` and don't pass this option.
-     */
-    systemPrompt?: string;
-    /**
-     * JSON-serialized tool schemas to embed in the chat-format header
-     * prefilled at setup. Format matches `FormatChatOptions.tools` — output
-     * of `createToolkit(...).toolsJson`. Only applied when `systemPrompt` is
-     * also set; ignored otherwise.
-     */
-    toolsJson?: string;
-    /**
-     * Whether to enable thinking-mode tokens (e.g. `<think>` blocks) when
-     * formatting the shared root header. Threaded through to the chat-format
-     * call AND stored on the `RootFmt` FormatConfig so `setupAgent`'s
-     * shared-mode shortcut copies a parser/grammar/triggers configuration
-     * consistent with the per-agent suffix formatting.
-     *
-     * Should match the `enableThinking` value the caller passes to the agent
-     * pool — divergent values produce inconsistent grammar between the
-     * prefilled root and per-agent suffixes.
-     *
-     * @default false
-     */
-    enableThinking?: boolean;
-}
-/**
- * Scoped shared root branch with guaranteed cleanup
- *
- * Creates (or forks) a root branch for the pool's agents to fork from.
- * The root is pruned via try/finally when the body returns or throws,
- * regardless of whether children still exist.
- *
- * Each agent's chat format (system + user + generation prompt) is rendered
- * fresh inside `setupAgent`, so this root carries no chat context itself —
- * it exists as the pool's branching point and as the spine that
- * `ctx.extendRoot` writes onto between tasks.
- *
- * **Cold path** (no `parent`): creates a root at position 0 with no prefill.
- * Agents fork at position 0; their full chat context lives in their own suffix.
- *
- * **Warm path** (`parent` provided): forks from parent and prefills a turn
- * separator so subsequent agent suffixes land on a clean turn boundary.
- * Sub-agents inherit the parent's full KV state via the fork.
- *
- * @param opts - Sampling parameters and optional parent branch
- * @param body - Operation that receives the root branch and prefix length.
- *   Typically calls {@link useAgentPool} inside.
- * @returns The body's return value
- *
- * @category Agents
- */
-export declare function withSharedRoot<T>(opts: SharedRootOptions, body: (root: Branch, sharedPrefixLength: number) => Operation<T>): Operation<T>;
-//# sourceMappingURL=shared-root.d.ts.map

package/dist/shared-root.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shared-root.d.ts","sourceRoot":"","sources":["../src/shared-root.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,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;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAiB,cAAc,CAAC,CAAC,EAC/B,IAAI,EAAE,iBAAiB,EACvB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAC/D,SAAS,CAAC,CAAC,CAAC,CAsHd"}

package/dist/shared-root.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"shared-root.js","sourceRoot":"","sources":["../src/shared-root.ts"],"names":[],"mappings":";;AAqGA,wCAyHC;AA9ND,yCAAiC;AAEjC,0CAA0C;AAE1C,uCAA+E;AAC/E,+CAA2C;AAsE3C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,QAAe,CAAC,CAAC,cAAc,CAC7B,IAAuB,EACvB,IAAgE;IAEhE,MAAM,GAAG,GAAmB,KAAK,CAAC,CAAC,aAAG,CAAC,MAAM,EAAE,CAAC;IAChD,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,eAAK,CAAC,MAAM,EAAE,CAAC;IAEjC,uFAAuF;IACvF,IAAI,aAAa,GAAkB,IAAI,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,qBAAW,CAAC,GAAG,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,IAAI;YAAE,aAAa,GAAG,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;IAC7B,CAAC;IAED,MAAM,KAAK,GAAG,IAAA,wBAAU,EAAC,EAAE,EAAE,aAAa,EAAE,gBAAgB,EAAE;QAC5D,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM;KACzB,CAAC,CAAC;IAEH,yEAAyE;IACzE,uEAAuE;IACvE,sEAAsE;IACtE,mEAAmE;IACnE,IAAI,IAAY,CAAC;IACjB,IAAI,aAAuB,CAAC;IAE5B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC9B,aAAa,GAAG,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,YAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QAClE,aAAa,GAAG,EAAE,CAAC;IACrB,CAAC;IAED,EAAE,CAAC,KAAK,CAAC;QACP,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE;QACpB,aAAa,EAAE,KAAK,CAAC,OAAO;QAC5B,EAAE,EAAE,WAAW,CAAC,GAAG,EAAE;QACrB,IAAI,EAAE,eAAe;QACrB,YAAY,EAAE,IAAI,CAAC,MAAM;QACzB,YAAY,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,IAAI,IAAI;QACzC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAChD,IAAI,EAAE,YAAY;KACnB,CAAC,CAAC;IAEH,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,CAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;QAC/C,EAAE,CAAC,KAAK,CAAC;YACP,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE;YACpB,aAAa,EAAE,KAAK,CAAC,OAAO;YAC5B,EAAE,EAAE,WAAW,CAAC,GAAG,EAAE;YACrB,IAAI,EAAE,gBAAgB;YACtB,YAAY,EAAE,IAAI,CAAC,MAAM;YACzB,UAAU,EAAE,aAAa,CAAC,MAAM;YAChC,IAAI,EAAE,cAAc;SACrB,CAAC,CAAC;IACL,CAAC;IAED,uEAAuE;IACvE,sEAAsE;IACtE,0EAA0E;IAC1E,qEAAqE;IACrE,uEAAuE;IACvE,uCAAuC;IACvC,IAAI,OAAO,GAAwB,IAAI,CAAC;IACxC,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QAClF,MAAM,OAAO,GAA4B;YACvC,cAAc;YACd,sEAAsE;YACtE,mEAAmE;YACnE,iEAAiE;YACjE,mBAAmB,EAAE,KAAK;SAC3B,CAAC;QACF,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;QACnD,MAAM,SAAS,GAAG,GAAG,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC/D,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,CAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;YAC9C,EAAE,CAAC,KAAK,CAAC;gBACP,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE;gBACpB,aAAa,EAAE,KAAK,CAAC,OAAO;gBAC5B,EAAE,EAAE,WAAW,CAAC,GAAG,EAAE;gBACrB,IAAI,EAAE,gBAAgB;gBACtB,YAAY,EAAE,IAAI,CAAC,MAAM;gBACzB,UAAU,EAAE,YAAY,CAAC,MAAM;gBAC/B,IAAI,EAAE,cAAc;aACrB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,GAAG;YACR,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,eAAe,EAAE,SAAS,CAAC,eAAe;YAC1C,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;YAC5C,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,eAAe,EAAE,SAAS,CAAC,eAAe;YAC1C,cAAc;SACf,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,gBAAgB;YAAE,KAAK,CAAC,CAAC,0BAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,OAAO;YAAE,KAAK,CAAC,CAAC,iBAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,OAAO,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,EAAE,CAAC,KAAK,CAAC;gBACP,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE;gBACpB,aAAa,EAAE,KAAK,CAAC,OAAO;gBAC5B,EAAE,EAAE,WAAW,CAAC,GAAG,EAAE;gBACrB,IAAI,EAAE,cAAc;gBACpB,YAAY,EAAE,IAAI,CAAC,MAAM;gBACzB,QAAQ,EAAE,CAAC;aACZ,CAAC,CAAC;YACH,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,CAAC;QACD,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;AACH,CAAC"}