@schlenkr/ragents 0.1.6 → 0.1.7

package/bundles/ragents.processes/ragents-bundle.json

@@ -78,7 +78,7 @@
     }
   },
   "stand": "987603befb33bb6cbdf130bf48c606f09549cfcce8811ffcef62a235640d79f5",
-  "sourceStand": "c53ca466e231c776b26f8a82620cbe18b992fc8698272bdc30468a7b2965454a",
+  "sourceStand": "8c4a54ab7237c74d3fc000b6e0fcc400a7a9b2f9b53219a3b78587f37f978abe",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.product/ragents-bundle.json

@@ -76,7 +76,7 @@
     }
   },
   "stand": "83bcb0d455b8559983cc7811b8c3ba4a9ec5d2d595c7489c322d8a7e193a2f0c",
-  "sourceStand": "5ff99fc7488a7f23083d596ffa4eb0bf8d01431856fec65d33295379439346a8",
+  "sourceStand": "5a31a5884bbdecb161987cea6fb768a81fdb6bf774a3d6687ad725f2667bd53e",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.profile-distribution/ragents-bundle.json

@@ -53,7 +53,7 @@
     "web": {}
   },
   "stand": "bfbd7567f9d0fe8aa6b6600c5e9750caab844053d93fbce389e02a169d151b18",
-  "sourceStand": "0ae80be7482ac722feed6a2c715d5c5c9ecaf617d806839d9e9c68f8605a2777",
+  "sourceStand": "31d397812908e9f38efe5ba5923ba6f6f53624607453b41ffd7d62e688685cbb",
   "server": "server/index.js",
   "exports": {
     "server": {},

package/bundles/ragents.reference/ragents-bundle.json

@@ -20,8 +20,8 @@
       ]
     }
   },
-  "stand": "c158c80b63caca976d55e47cdc8d9718075cbc4a50ad916aecd32f3c449d1be3",
-  "sourceStand": "d7eef6dbb6060fab2555a85ef5bc28cf4f43558660d79d48fc5cfb9260103b18",
+  "stand": "b3fa5275dc209c315f26ec832458603d442d2a56974471ee83292e7d26079a12",
+  "sourceStand": "6db28f060bf31d72dc73f716a86c7122ce25d67e6b9c81ceba034e96fe735fd9",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.reference/run-scripts/learning-afternoon/tests/program.test.ts

@@ -214,5 +214,5 @@ test("der gemeinsame Ablauf liefert Helferaufträge, Prompt und parallele Graphz
   await program.onInput(eventOf("experiment", "actor.stopped", {}), context);
   const failed = workflowGraph(learningWorkflow, learningWorkflowState(context.state.read().board!));
   assert.deepEqual(failed.nodes.map((node) => [node.id, node.status]), [["experiment", "blocked"], ["quiz", "done"], ["collect", "blocked"]]);
-  assert.match(failed.nodes.find((node) => node.id === "collect")!.detail!, /1 von 2/);
+  assert.match(failed.nodes.find((node) => node.id === "collect")!.detail!, /1 of 2/);
 });

package/bundles/ragents.reference/run-scripts/word-game/tests/program.test.ts

@@ -96,7 +96,7 @@ test("wartet auf spätere Ereignisse, zählt zwölf Beiträge und beendet die We
   assert.deepEqual(inputs.map((call) => (call.input as { actor: string }).actor), words.map((_word, index) => `actor-${participants[index % 4]!.handle}`));
   assert.equal(context.state.read().status, "completed");
   assert.equal(context.state.read().entries?.length, 12);
-  assert.match(context.state.read().document!, /12\. Grün: Blume/);
+  assert.match(context.state.read().document!, /12\. Green: Blume/);
   assert.equal(context.state.read().pendingInputId, undefined);
   assert.deepEqual(await program.functions.start({}, context), { accepted: false });
 });
@@ -122,7 +122,7 @@ for (const scenario of [
   { name: "Modellfehler", word: "Strand", options: { outcome: "failed" } },
   { name: "Unterbrechung", word: "Strand", options: { type: "turn.interrupted" } },
   { name: "Mehrwortantwort", word: "Schöner Strand", options: {} },
-  { name: "wiederholtes Ausgangswort", word: "sonne", options: {} },
+  { name: "wiederholtes Ausgangswort", word: "sun", options: {} },
 ]) {
   test(`${scenario.name} bleibt als Fehler sichtbar und startet nicht erneut`, async () => {
     const { context, calls, response, start } = fixture();
@@ -247,6 +247,6 @@ test("ein gestoppter aktueller Teilnehmer hält das Spiel an", async () => {
   await start();
   await program.onInput(response("Strand", { type: "actor.stopped" }), context);
   assert.equal(context.state.read().status, "error");
-  assert.match(context.state.read().error!, /Rot wurde gestoppt/);
+  assert.match(context.state.read().error!, /Red wurde gestoppt/);
   assert.equal(context.state.read().entries?.length, 0);
 });

package/bundles/ragents.todo/ragents-bundle.json

@@ -33,7 +33,7 @@
     }
   },
   "stand": "3dd3347780b8ddbe369e9024096d5da94ba34cf37b1003b55e03e3cbc8cd4779",
-  "sourceStand": "645e499eed8fb1fb1848f82407f093c05acf7d0f217819910d53db047c1b19e0",
+  "sourceStand": "dfb507ba9b2a9f99023f75cdb676872db58dcd0f33fab1d1e468c3f09bdebebe",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.transcript/ragents-bundle.json

@@ -23,7 +23,7 @@
     "web": {}
   },
   "stand": "98d8ba054df383ac3d2d13e25de7f1930a7e4301654e188847cfc1fcf135490b",
-  "sourceStand": "fe1837e356cd3f36fe94c4e7105800289032929ed9f9bd9ef2aa13b4654fe674",
+  "sourceStand": "047848b91abec440121b9d392fd4c268799e674198b9497cd9ad842d32522025",
   "server": "server/index.js",
   "exports": {
     "server": {},

package/bundles/ragents.watch/ragents-bundle.json

@@ -25,7 +25,7 @@
     "web": {}
   },
   "stand": "f5cade80192041cee54457035b293425a10f1de42b49f1d804117ad7951c1b00",
-  "sourceStand": "1137b9394272596b02d57f2257b2da60503cc1f0ca9a92745f999f6ad7f32512",
+  "sourceStand": "9b701a2a9708f14452ca7548677c735f70b6d013e1e0438bbd7a19c38bc96545",
   "server": "server/index.js",
   "exports": {
     "server": {

package/bundles/ragents.workspace/ragents-bundle.json

@@ -131,7 +131,7 @@
     }
   },
   "stand": "014f6c3e925196716315c4827b73e71a9b98579e620f0cc1beeb3bec763520a8",
-  "sourceStand": "86fdc3445cc414067d94d110f8c5f351a9285949aa1244a286ae49cbd9db0652",
+  "sourceStand": "dabaf431c288a40f14c521ca52da35a66e80e1a5352b5486d464b91a7cbecd5e",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schlenkr/ragents",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "RAgents-Host: Server, Engine, Plugins und Werkzeuge ohne Quell-Checkout",
   "keywords": [
     "agents",
@@ -70,6 +70,6 @@
     "yaml": "2.9.0"
   },
   "ragents": {
-    "hostVersion": "b3d22f501459de3458397f4384273ec283dba6fc"
+    "hostVersion": "765802e9cb0252b2a312b2b1b09a557ef8bf13cc"
   }
 }

package/packages/agent/dist/core/agent-settings.d.ts

@@ -1,11 +1,11 @@
-/** The few knobs of an agent session; everything else is fixed. */
+/** The few knobs of an agent's runtime; everything else is fixed. */
 export interface AgentSettings {
     compaction: {
         enabled: boolean;
         reserveTokens: number;
         keepRecentTokens: number;
     };
-    /** Retries of the session after a retryable model error, with exponential backoff. */
+    /** Retries after a retryable model error, with exponential backoff. */
     retry: {
         enabled: boolean;
         maxRetries: number;

package/packages/agent/dist/core/compaction/compaction.d.ts

@@ -1,26 +1,16 @@
-/**
- * Context compaction for long sessions.
- *
- * Pure functions for compaction logic. The session manager handles I/O,
- * and after compaction the session is reloaded.
- */
+/** Context compaction over the context log of one agent; pure functions, the caller persists the result. */
 import type { AgentMessage, StreamFn, ThinkingLevel } from "../../loop/index.ts";
 import type { Model, Usage } from "@ragents/ai";
-import { type SessionEntry } from "../session-manager.ts";
+import { type ContextLogEntry } from "../context-log.ts";
 import { type FileOperations } from "./utils.ts";
-/** Details stored in CompactionEntry.details for file tracking */
-export interface CompactionDetails {
-    readFiles: string[];
-    modifiedFiles: string[];
-}
-/** Result from compact() - SessionManager adds uuid/parentUuid when saving */
-export interface CompactionResult<T = unknown> {
+/** Result of compact(); the caller records it as a compaction entry. */
+export interface CompactionResult {
     summary: string;
-    firstKeptEntryId: string;
+    firstKeptId: string;
     tokensBefore: number;
     estimatedTokensAfter?: number;
-    /** Extension-specific data (e.g., ArtifactIndex, version markers for structured compaction) */
-    details?: T;
+    readFiles: string[];
+    modifiedFiles: string[];
 }
 export interface CompactionSettings {
     enabled: boolean;
@@ -52,11 +42,8 @@ export declare function shouldCompact(contextTokens: number, contextWindow: numb
  * This is conservative (overestimates tokens).
  */
 export declare function estimateTokens(message: AgentMessage): number;
-/**
- * Find the context-visible user-role message that starts the turn containing the given entry index.
- * Returns -1 if no turn start found before the index.
- */
-export declare function findTurnStartIndex(entries: SessionEntry[], entryIndex: number, startIndex: number): number;
+/** The user-like message that starts the turn containing the given index, or -1. */
+export declare function findTurnStartIndex(entries: ContextLogEntry[], entryIndex: number, startIndex: number): number;
 export interface CutPointResult {
     /** Index of first entry to keep */
     firstKeptEntryIndex: number;
@@ -65,31 +52,16 @@ export interface CutPointResult {
     /** Whether this cut splits a turn (cut point is not a user message) */
     isSplitTurn: boolean;
 }
-/**
- * Find the cut point in session entries that keeps approximately `keepRecentTokens`.
- *
- * Algorithm: Walk backwards from newest, accumulating estimated message sizes.
- * Stop when we've accumulated >= keepRecentTokens. Cut at that point.
- *
- * Can cut at user OR assistant messages (never tool results). When cutting at an
- * assistant message with tool calls, its tool results come after and will be kept.
- *
- * Returns CutPointResult with:
- * - firstKeptEntryIndex: the entry index to start keeping from
- * - turnStartIndex: if cutting mid-turn, the user message that started that turn
- * - isSplitTurn: whether we're cutting in the middle of a turn
- *
- * Only considers entries between `startIndex` and `endIndex` (exclusive).
- */
-export declare function findCutPoint(entries: SessionEntry[], startIndex: number, endIndex: number, keepRecentTokens: number): CutPointResult;
+/** The valid cut point that keeps about `keepRecentTokens` of the entries between `startIndex` and `endIndex`, counted from the newest. */
+export declare function findCutPoint(entries: ContextLogEntry[], startIndex: number, endIndex: number, keepRecentTokens: number): CutPointResult;
 /**
  * Generate a summary of the conversation using the LLM.
  * If previousSummary is provided, uses the update prompt to merge.
  */
 export declare function generateSummary(currentMessages: AgentMessage[], model: Model<any>, reserveTokens: number, apiKey: string | undefined, headers?: Record<string, string>, signal?: AbortSignal, customInstructions?: string, previousSummary?: string, thinkingLevel?: ThinkingLevel, streamFn?: StreamFn, env?: Record<string, string>): Promise<string>;
 export interface CompactionPreparation {
-    /** UUID of first entry to keep */
-    firstKeptEntryId: string;
+    /** Id of the first entry to keep */
+    firstKeptId: string;
     /** Messages that will be summarized and discarded */
     messagesToSummarize: AgentMessage[];
     /** Messages that will be turned into turn prefix summary (if splitting) */
@@ -101,16 +73,10 @@ export interface CompactionPreparation {
     previousSummary?: string;
     /** File operations extracted from messagesToSummarize */
     fileOps: FileOperations;
-    /** Compaction settions from settings.jsonl	*/
     settings: CompactionSettings;
 }
-export declare function prepareCompaction(pathEntries: SessionEntry[], settings: CompactionSettings): CompactionPreparation | undefined;
-/**
- * Generate summaries for compaction using prepared data.
- * Returns CompactionResult - SessionManager adds uuid/parentUuid when saving.
- *
- * @param preparation - Pre-calculated preparation from prepareCompaction()
- * @param customInstructions - Optional custom focus for the summary
- */
+/** Prepares a compaction of the whole context log; undefined when there is nothing to summarize. */
+export declare function prepareCompaction(entries: ContextLogEntry[], settings: CompactionSettings): CompactionPreparation | undefined;
+/** Summarizes a prepared compaction; the caller records the result. */
 export declare function compact(preparation: CompactionPreparation, model: Model<any>, apiKey: string | undefined, headers?: Record<string, string>, customInstructions?: string, signal?: AbortSignal, thinkingLevel?: ThinkingLevel, streamFn?: StreamFn, env?: Record<string, string>): Promise<CompactionResult>;
 //# sourceMappingURL=compaction.d.ts.map

package/packages/agent/dist/core/context-log.d.ts

@@ -0,0 +1,25 @@
+import type { AgentMessage } from "../loop/index.ts";
+/** A compaction replaces every entry before its first kept entry with its summary. */
+export interface ContextCompaction {
+    kind: "compaction";
+    id: string;
+    summary: string;
+    firstKeptId: string;
+    tokensBefore: number;
+    timestamp: number;
+    readFiles: string[];
+    modifiedFiles: string[];
+}
+/** One entry of an agent's model context in the order the conversation produced it. */
+export type ContextLogEntry = {
+    kind: "message";
+    id: string;
+    message: AgentMessage;
+} | ContextCompaction;
+export declare function latestCompaction(entries: readonly ContextLogEntry[]): ContextCompaction | undefined;
+/** The entries the model sees: the latest compaction, the entries it keeps, and everything after it. */
+export declare function activeContextEntries(entries: readonly ContextLogEntry[]): ContextLogEntry[];
+export declare function contextEntryMessages(entry: ContextLogEntry): AgentMessage[];
+/** The messages of the model context, compaction-aware; the order is the order of the log. */
+export declare function contextMessages(entries: readonly ContextLogEntry[]): AgentMessage[];
+//# sourceMappingURL=context-log.d.ts.map

package/packages/agent/dist/core/messages.d.ts

@@ -3,7 +3,7 @@ import type { AgentMessage } from "../loop/index.ts";
 import type { Message, UserContent } from "@ragents/ai";
 export declare const COMPACTION_SUMMARY_PREFIX = "The conversation history before this point was compacted into the following summary:\n\n<summary>\n";
 export declare const COMPACTION_SUMMARY_SUFFIX = "\n</summary>";
-/** Message that an extension injects into the context of a model call. */
+/** A hidden note that a hook adds to one model call; it is not part of the context. */
 export interface CustomMessage<T = unknown> {
     role: "custom";
     customType: string;
@@ -24,14 +24,7 @@ declare module "../loop/types.ts" {
         compactionSummary: CompactionSummaryMessage;
     }
 }
-export declare function createCompactionSummaryMessage(summary: string, tokensBefore: number, timestamp: string): CompactionSummaryMessage;
-/**
- * Transform AgentMessages (including custom types) to LLM-compatible Messages.
- *
- * This is used by:
- * - Agent's transormToLlm option (for prompt calls and queued messages)
- * - Compaction's generateSummary (for summarization)
- * - Custom extensions and tools
- */
+export declare function createCompactionSummaryMessage(summary: string, tokensBefore: number, timestamp: number): CompactionSummaryMessage;
+/** Transform AgentMessages, including hook notes and compaction summaries, to LLM messages. */
 export declare function convertToLlm(messages: AgentMessage[]): Message[];
 //# sourceMappingURL=messages.d.ts.map

package/packages/agent/dist/core/tool-definition.d.ts

@@ -0,0 +1,17 @@
+/** The form of the read, write, edit and bash tools; the host runs them in its workspace executor. */
+import type { AgentToolResult, AgentToolUpdateCallback, ToolExecutionMode } from "../loop/index.ts";
+import type { Static, TSchema } from "typebox";
+export type { AgentToolResult, AgentToolUpdateCallback, ToolExecutionMode };
+export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = unknown> {
+    name: string;
+    label: string;
+    description: string;
+    parameters: TParams;
+    /** Optional compatibility shim to prepare raw tool call arguments before schema validation. */
+    prepareArguments?: (args: unknown) => Static<TParams>;
+    executionMode?: ToolExecutionMode;
+    execute(toolCallId: string, params: Static<TParams>, signal: AbortSignal | undefined, onUpdate: AgentToolUpdateCallback<TDetails> | undefined): Promise<AgentToolResult<TDetails>>;
+}
+/** Preserve parameter inference for standalone tool definitions. */
+export declare function defineTool<TParams extends TSchema, TDetails = unknown>(tool: ToolDefinition<TParams, TDetails>): ToolDefinition<TParams, TDetails>;
+//# sourceMappingURL=tool-definition.d.ts.map

package/packages/agent/dist/core/tools/bash.d.ts

@@ -1,5 +1,5 @@
 import { Type } from "typebox";
-import type { ToolDefinition } from "../extensions/types.ts";
+import type { ToolDefinition } from "../tool-definition.ts";
 import { type TruncationResult } from "./truncate.ts";
 export declare const BASH_MAX_BYTES: number;
 export declare const BASH_MAX_LINE_CHARS = 1000;
@@ -33,12 +33,7 @@ export interface BashOperations {
         exitCode: number | null;
     }>;
 }
-/**
- * Create bash operations using the built-in local shell execution backend.
- *
- * This is useful for extensions that intercept user_bash and still want the
- * standard local shell behavior while wrapping or rewriting commands.
- */
+/** Bash operations on the built-in local shell. */
 export declare function createLocalBashOperations(options?: {
     shellPath?: string;
 }): BashOperations;

package/packages/agent/dist/core/tools/edit.d.ts

@@ -1,5 +1,5 @@
 import { type Static, Type } from "typebox";
-import type { ToolDefinition } from "../extensions/types.ts";
+import type { ToolDefinition } from "../tool-definition.ts";
 declare const editSchema: Type.TObject<{
     path: Type.TString;
     edits: Type.TArray<Type.TObject<{

package/packages/agent/dist/core/tools/read.d.ts

@@ -1,5 +1,5 @@
 import { Type } from "typebox";
-import type { ToolDefinition } from "../extensions/types.ts";
+import type { ToolDefinition } from "../tool-definition.ts";
 import { type TruncationResult } from "./truncate.ts";
 declare const readSchema: Type.TObject<{
     path: Type.TString;

package/packages/agent/dist/core/tools/write.d.ts

@@ -1,5 +1,5 @@
 import { Type } from "typebox";
-import type { ToolDefinition } from "../extensions/types.ts";
+import type { ToolDefinition } from "../tool-definition.ts";
 declare const writeSchema: Type.TObject<{
     path: Type.TString;
     content: Type.TString;

package/packages/agent/dist/index.d.ts

@@ -1,13 +1,12 @@
-export type { AgentSession } from "./core/agent-session.ts";
-export type { ExtensionAPI, ExtensionContext, ExtensionError, InlineExtension, ToolDefinition } from "./core/extensions/index.ts";
-export { defineTool } from "./core/extensions/index.ts";
 export { aliasedModel, type ModelAlias, ModelRuntime } from "./core/model-runtime.ts";
-export { DefaultResourceLoader } from "./core/resource-loader.ts";
-export { type AgentSessionRuntime, type CreateAgentSessionRuntimeFactory, createAgentSession, createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, } from "./core/sdk.ts";
-export { CURRENT_SESSION_VERSION, type SessionEntry, SessionManager } from "./core/session-manager.ts";
-export type { AgentSettingsInput } from "./core/agent-settings.ts";
-export type { Skill } from "./core/skills.ts";
+export { type AgentSettings, type AgentSettingsInput, agentSettings } from "./core/agent-settings.ts";
+export { activeContextEntries, type ContextCompaction, type ContextLogEntry, contextMessages, latestCompaction, } from "./core/context-log.ts";
+export { calculateContextTokens, compact, estimateContextTokens, prepareCompaction, shouldCompact, } from "./core/compaction/index.ts";
+export { convertToLlm } from "./core/messages.ts";
+export { formatSkillsForPrompt, type Skill } from "./core/skills.ts";
+export { defineTool, type ToolDefinition } from "./core/tool-definition.ts";
 export { type BashOperations, createBashToolDefinition, createEditToolDefinition, createReadToolDefinition, createWriteToolDefinition, } from "./core/tools/index.ts";
+export { Agent, type AgentEvent, type AgentLoopTurnUpdate, type AgentMessage, type AgentTool, type AgentToolResult, EMPTY_RESPONSE_NUDGE, isRunFailure, type ThinkingLevel, } from "./loop/index.ts";
 export { parseFrontmatter, stripFrontmatter } from "./utils/frontmatter.ts";
 export { getShellConfig, killProcessTree, type ShellConfig } from "./utils/shell.ts";
 //# sourceMappingURL=index.d.ts.map

package/packages/agent/dist/loop/agent.d.ts

@@ -18,12 +18,8 @@ export interface AgentOptions {
     maxRetryDelayMs?: number;
     toolExecution?: ToolExecutionMode;
 }
-/**
- * Stateful wrapper around the low-level agent loop.
- *
- * `Agent` owns the current transcript, emits lifecycle events, executes tools,
- * and polls its steering source before each model request.
- */
+/** Whether a message is the stand-in the agent reports for a failed run; no model produced it. */
+export declare const isRunFailure: (message: AgentMessage) => boolean;
 export declare class Agent {
     private _state;
     private readonly listeners;

package/packages/agent/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@ragents/agent",
 	"version": "0.80.10",
-	"description": "The agent runtime of RAgents: agent loop, sessions, compaction, extension hooks and the read, write, edit and bash tools",
+	"description": "The agent runtime of RAgents: agent loop, compaction, model runtime and the read, write, edit and bash tools",
 	"type": "module",
 	"main": "./src/index.ts",
 	"types": "./dist/index.d.ts",

package/packages/agent/src/core/agent-settings.ts

@@ -1,7 +1,7 @@
-/** The few knobs of an agent session; everything else is fixed. */
+/** The few knobs of an agent's runtime; everything else is fixed. */
 export interface AgentSettings {
 	compaction: { enabled: boolean; reserveTokens: number; keepRecentTokens: number };
-	/** Retries of the session after a retryable model error, with exponential backoff. */
+	/** Retries after a retryable model error, with exponential backoff. */
 	retry: { enabled: boolean; maxRetries: number; baseDelayMs: number };
 	/** Timeout and retries of a single provider request; unset values leave the SDK defaults. */
 	providerRequest: { timeoutMs: number; maxRetries?: number; maxRetryDelayMs: number };