general-agent-runtime 0.0.1

package/README.md

@@ -0,0 +1,311 @@
+# General Agent Runtime
+
+A small, composable TypeScript runtime for building tool-using AI agents with streaming events, persistent sessions, hooks, and long-context compaction.
+
+## Status
+
+The core v0 Runtime architecture is complete through Phase 11.
+
+Current verification baseline:
+
+```text
+npm run typecheck      ✅
+npm test               ✅ 15 files / 121 tests
+npm run test:coverage  ✅ 88.22% statements / 80.83% branches / 93.56% functions
+npm run build          ✅
+git diff --check       ✅
+```
+
+v0 is complete: the core Runtime, public-API examples, live integration tests, and minimal CLI have all been implemented and verified against a real OpenAI-compatible llama.cpp endpoint. MCP, Skills, Memory, Approval, and SubAgent are intentionally v1+.
+
+## Installation
+
+```bash
+npm install general-agent-runtime
+```
+
+The package is ESM-only and requires Node.js 22 or newer.
+
+## Quick start
+
+Set an OpenAI-compatible endpoint:
+
+```bash
+set AGENT_BASE_URL=https://api.openai.com/v1
+set AGENT_API_KEY=your-key
+set AGENT_MODEL=gpt-5.6
+```
+
+Then:
+
+```ts
+import { createAgent } from "general-agent-runtime";
+
+const agent = await createAgent();
+
+for await (const event of agent.run("Explain what this project does in one paragraph.")) {
+  if (event.type === "message_delta") {
+    process.stdout.write(event.data.delta);
+  }
+}
+```
+
+`createAgent()` resolves defaults, `agent.config.json`, environment variables, and explicit runtime overrides, then assembles the default Runtime.
+
+## Agent API
+
+The main SDK surface is intentionally small:
+
+```ts
+interface Agent {
+  run(input, options?): AsyncIterable<AgentEvent>;
+  resume(sessionId, options?): Promise<void>;
+  abort(runId): void;
+  getState(runId): Readonly<AgentRunState> | undefined;
+}
+```
+
+### Streaming events
+
+`agent.run()` returns an `AsyncIterable<AgentEvent>`. Common events include:
+
+```text
+run_start
+turn_start
+message_start
+message_delta
+tool_start
+tool_end
+compact_start
+compact_end
+message_end
+turn_end
+error
+run_end
+```
+
+The same logical event sequence is visible to registered Event sinks and the Agent stream.
+
+### Session resume
+
+A new run creates a JSONL Session automatically. Capture its `sessionId` from the event stream and pass it back later:
+
+```ts
+let sessionId;
+
+for await (const event of agent.run("Remember that the project codename is Atlas.")) {
+  sessionId ??= event.sessionId;
+}
+
+await agent.resume(sessionId);
+
+for await (const event of agent.run(
+  "What is the project codename?",
+  { sessionId },
+)) {
+  if (event.type === "message_delta") {
+    process.stdout.write(event.data.delta);
+  }
+}
+```
+
+`resume()` validates that the persisted Session can be reopened and projected. Continuing the conversation is still done through `run(..., { sessionId })`.
+
+### Abort
+
+Use an `AbortSignal` when the caller owns cancellation:
+
+```ts
+const controller = new AbortController();
+
+const stream = agent.run("Do a long task", {
+  signal: controller.signal,
+});
+
+controller.abort("user_cancelled");
+```
+
+When a `runId` is already known, `agent.abort(runId)` can cancel that active run directly.
+
+## Tools
+
+The default builder registers four core tools:
+
+- `read_file`
+- `write_file`
+- `list_directory`
+- `run_command`
+
+All model tool calls pass through `ToolExecutor` for input validation, Hook control, timeout/abort handling, bounded parallelism, error normalization, and output truncation.
+
+For custom composition, use the public `DefaultAgentBuilder` API:
+
+```ts
+import {
+  DefaultAgentBuilder,
+  type Tool,
+} from "general-agent-runtime";
+
+const echoTool: Tool = {
+  name: "echo",
+  description: "Echo a JSON value.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      text: { type: "string" },
+    },
+    required: ["text"],
+    additionalProperties: false,
+  },
+  async execute(input) {
+    return input;
+  },
+};
+
+const agent = new DefaultAgentBuilder()
+  .withTool(echoTool)
+  .build();
+```
+
+Use `createAgent()` for normal application setup; use `DefaultAgentBuilder` when replacing or extending Runtime components. The Builder uses the config you give it (or built-in defaults); unlike `createAgent()`, it does not automatically resolve file/environment configuration sources.
+
+## Hooks
+
+Hooks form the Runtime control plane. They can observe or control lifecycle points without placing policy inside the Loop.
+
+Typical uses:
+
+- modify or block a tool call with `before_tool`;
+- inspect tool output with `after_tool`;
+- modify the final model request with `before_model`;
+- stop a run at lifecycle boundaries;
+- observe compaction and errors.
+
+`before_model` may modify messages, tools, temperature, max output tokens, and provider options, but it cannot change the resolved model.
+
+## Long-context handling
+
+The Runtime separates projection from compaction:
+
+```text
+Context sources
+   ↓
+Context snapshot
+   ↓
+Projection
+   ↓
+Budget evaluation
+   ↓
+Compaction when required
+   ↓
+ModelRequest
+```
+
+Compaction supports deterministic compression, semantic compaction, durable checkpoints, and bounded reactive recovery from provider context-limit errors. Original Session history remains append-only.
+
+## Examples
+
+```text
+examples/basic-chat.ts
+examples/tool-call.ts
+examples/resume-session.ts
+```
+
+Run one with:
+
+```bash
+npm run dev -- examples/basic-chat.ts "Hello"
+npm run dev -- examples/tool-call.ts
+npm run dev -- examples/resume-session.ts
+```
+
+## CLI
+
+From this repository, run the minimal interactive CLI with:
+
+```bash
+npm run cli
+```
+
+After installing the npm package, run:
+
+```bash
+npx general-agent-runtime
+```
+
+Continue an existing Session:
+
+```bash
+npx general-agent-runtime --session <session-id>
+```
+
+The CLI only consumes the public Agent API and Agent events. It does not implement Runtime behavior.
+
+## Tests
+
+Default tests are deterministic unit tests:
+
+```bash
+npm test
+```
+
+Coverage uses V8 and enforces minimum global thresholds:
+
+```bash
+npm run test:coverage
+```
+
+Current thresholds are 87% statements/lines, 80% branches, and 93% functions. Pure TypeScript declarations and the CLI process entrypoint are excluded from the core Runtime coverage denominator; executable Runtime modules remain included.
+
+Live OpenAI-compatible integration tests are separate:
+
+```bash
+npm run test:integration
+```
+
+Live tests read the same Runtime configuration as the SDK. Configure `agent.config.json`, or provide `AGENT_BASE_URL` and `AGENT_MODEL` environment variables; set `AGENT_API_KEY` when the endpoint requires authentication. If neither explicit file nor environment configuration is present, live tests skip.
+
+## Package verification
+
+Before publishing, build a real tarball and verify it from a clean TypeScript consumer:
+
+```bash
+npm run test:package
+```
+
+`test:package` creates the real tarball in a temporary directory, installs it into a clean consumer, checks TypeScript declaration resolution, verifies the root ESM import, and runs the installed CLI. `prepack` automatically runs a clean build, typecheck, and unit tests before npm creates the package. The published tarball is restricted to `dist/`, `README.md`, and npm metadata; tests, examples, local configuration, sessions, coverage, design documents, and release scripts are not published.
+
+Publish with:
+
+```bash
+npm publish
+```
+
+The current package name is `general-agent-runtime`. Confirm the name is still available immediately before the first publish.
+
+## Architecture
+
+The main ownership model is:
+
+```text
+createAgent / DefaultAgentBuilder
+        ↓
+      Agent
+        ↓
+   RunManager
+        ↓
+    AgentLoop
+   ↙   ↓   ↘
+Context Model Tools
+        ↓
+   Compaction
+```
+
+The Loop owns orchestration and state transitions, not component algorithms. Session and Context integration are bridged through top-level adapters, preserving one-way core dependencies.
+
+## Design documents
+
+- `ARCHITECTURE.md`
+- `INTERFACE_DESIGN.md`
+- `IMPLEMENTATION_PLAN.md`
+- `REFACTOR_PLAN.md`

package/dist/agent/agent.d.ts

@@ -0,0 +1,14 @@
+import type { AgentMessage, AgentRunState, RunId } from "../types/index.js";
+import type { RunManager } from "./run-manager.js";
+import type { Agent, AgentRunOptions } from "./types.js";
+export interface DefaultAgentDependencies {
+    readonly runManager: RunManager;
+}
+export declare class DefaultAgent implements Agent {
+    private readonly dependencies;
+    constructor(dependencies: DefaultAgentDependencies);
+    run(input: string | AgentMessage, options?: AgentRunOptions): AsyncGenerator<import("../index.js").AgentEvent, void, any>;
+    resume(sessionId: Parameters<Agent["resume"]>[0], options?: Parameters<Agent["resume"]>[1]): Promise<void>;
+    abort(runId: RunId): void;
+    getState(runId: RunId): Readonly<AgentRunState> | undefined;
+}

package/dist/agent/agent.js

@@ -0,0 +1,25 @@
+import { createUserMessage } from "../utils/message.js";
+export class DefaultAgent {
+    dependencies;
+    constructor(dependencies) {
+        this.dependencies = dependencies;
+    }
+    async *run(input, options = {}) {
+        const message = typeof input === "string"
+            ? createUserMessage(input, options.metadata === undefined
+                ? undefined
+                : structuredClone(options.metadata))
+            : structuredClone(input);
+        yield* this.dependencies.runManager.run(message, options);
+    }
+    resume(sessionId, options = {}) {
+        return this.dependencies.runManager.resume(sessionId, options);
+    }
+    abort(runId) {
+        this.dependencies.runManager.abort(runId);
+    }
+    getState(runId) {
+        return this.dependencies.runManager.getState(runId);
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAWxD,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,YAAsC;QAAtC,iBAAY,GAAZ,YAAY,CAA0B;IAAG,CAAC;IAEvE,KAAK,CAAC,CAAC,GAAG,CACR,KAA4B,EAC5B,UAA2B,EAAE;QAE7B,MAAM,OAAO,GACX,OAAO,KAAK,KAAK,QAAQ;YACvB,CAAC,CAAC,iBAAiB,CACf,KAAK,EACL,OAAO,CAAC,QAAQ,KAAK,SAAS;gBAC5B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,CACtC;YACH,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAE7B,KAAK,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,CACJ,SAAyC,EACzC,UAA0C,EAAE;QAE5C,OAAO,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,KAAY;QAChB,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,QAAQ,CAAC,KAAY;QACnB,OAAO,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/agent/builder.d.ts

@@ -0,0 +1,28 @@
+import { type CompactionStrategy } from "../compaction/index.js";
+import { type ContextSource } from "../context/index.js";
+import { type EventSink } from "../events/index.js";
+import { type Hook } from "../hooks/index.js";
+import { type ModelProvider } from "../model/index.js";
+import { type SessionStore } from "../session/index.js";
+import { type RuntimeConfig } from "../settings/index.js";
+import { type Tool } from "../tools/index.js";
+import type { Agent, AgentBuilder } from "./types.js";
+export declare class DefaultAgentBuilder implements AgentBuilder {
+    private config;
+    private modelProvider?;
+    private sessionStore?;
+    private readonly contextSources;
+    private readonly tools;
+    private readonly hooks;
+    private readonly eventSinks;
+    private readonly compactionStrategies;
+    withConfig(config: RuntimeConfig): AgentBuilder;
+    withModelProvider(provider: ModelProvider): AgentBuilder;
+    withSessionStore(store: SessionStore): AgentBuilder;
+    withContextSource(source: ContextSource): AgentBuilder;
+    withTool(tool: Tool): AgentBuilder;
+    withHook(hook: Hook): AgentBuilder;
+    withEventSink(sink: EventSink): AgentBuilder;
+    withCompactionStrategy(strategy: CompactionStrategy): AgentBuilder;
+    build(): Agent;
+}

package/dist/agent/builder.js

@@ -0,0 +1,178 @@
+import { DefaultCompactionManager, DeterministicCompactionStrategy, SemanticCompactionStrategy, } from "../compaction/index.js";
+import { DefaultContextManager, DefaultProjectionBudgetPolicy, DefaultProjectionPipeline, } from "../context/index.js";
+import { DefaultEventBus, DefaultEventPublisher, } from "../events/index.js";
+import { DefaultHookBus, DefaultHookRegistry, } from "../hooks/index.js";
+import { createDefaultLoopPolicy } from "../loop/index.js";
+import { OpenAICompatibleProvider, } from "../model/index.js";
+import { DefaultSessionFactory, DefaultSessionProjector, JsonlSessionStore, SESSION_SCHEMA_VERSION, } from "../session/index.js";
+import { DEFAULT_RUNTIME_CONFIG, } from "../settings/index.js";
+import { DefaultToolExecutor, DefaultToolRegistry, DefaultToolResultProcessor, JsonSchemaToolInputValidator, ListDirectoryTool, ReadFileTool, RunCommandTool, WriteFileTool, } from "../tools/index.js";
+import { RuntimeError } from "../errors/runtime-error.js";
+import { DefaultAgent } from "./agent.js";
+import { DefaultAgentLoopFactory } from "./loop-factory.js";
+import { DefaultRunManager } from "./run-manager.js";
+import { SessionContextSource } from "./integrations/session-context-source.js";
+import { SessionRunRecorderFactory } from "./integrations/session-run-recorder.js";
+function createDefaultProvider(config) {
+    if (config.model.provider !== "openai-compatible") {
+        throw new RuntimeError({
+            code: "CONFIG_INVALID",
+            category: "config",
+            message: `No default provider implementation for: ${config.model.provider}`,
+        });
+    }
+    return new OpenAICompatibleProvider({
+        baseUrl: config.model.baseUrl ?? "https://api.openai.com/v1",
+        ...(config.model.apiKey === undefined
+            ? {}
+            : { apiKey: config.model.apiKey }),
+        defaultCapabilities: {
+            ...(config.model.maxOutputTokens === undefined
+                ? {}
+                : { maxOutputTokens: config.model.maxOutputTokens }),
+        },
+    });
+}
+function coreTools() {
+    return [
+        new ReadFileTool(),
+        new WriteFileTool(),
+        new ListDirectoryTool(),
+        new RunCommandTool(),
+    ];
+}
+function withDefaultCompactionStrategies(custom, provider) {
+    const strategies = [...custom];
+    if (!strategies.some((strategy) => strategy.supports("soft_limit"))) {
+        strategies.push(new DeterministicCompactionStrategy());
+    }
+    const semanticReasons = [
+        "hard_limit",
+        "provider_context_error",
+        "manual",
+    ];
+    if (semanticReasons.some((reason) => !strategies.some((strategy) => strategy.supports(reason)))) {
+        strategies.push(new SemanticCompactionStrategy(provider));
+    }
+    return strategies;
+}
+export class DefaultAgentBuilder {
+    config = structuredClone(DEFAULT_RUNTIME_CONFIG);
+    modelProvider;
+    sessionStore;
+    contextSources = [];
+    tools = [];
+    hooks = [];
+    eventSinks = [];
+    compactionStrategies = [];
+    withConfig(config) {
+        this.config = structuredClone(config);
+        return this;
+    }
+    withModelProvider(provider) {
+        this.modelProvider = provider;
+        return this;
+    }
+    withSessionStore(store) {
+        this.sessionStore = store;
+        return this;
+    }
+    withContextSource(source) {
+        this.contextSources.push(source);
+        return this;
+    }
+    withTool(tool) {
+        this.tools.push(tool);
+        return this;
+    }
+    withHook(hook) {
+        this.hooks.push(hook);
+        return this;
+    }
+    withEventSink(sink) {
+        this.eventSinks.push(sink);
+        return this;
+    }
+    withCompactionStrategy(strategy) {
+        this.compactionStrategies.push(strategy);
+        return this;
+    }
+    build() {
+        const config = structuredClone(this.config);
+        if (config.session.schemaVersion !== SESSION_SCHEMA_VERSION) {
+            throw new RuntimeError({
+                code: "CONFIG_INVALID",
+                category: "config",
+                message: `Unsupported session schema version: ${config.session.schemaVersion}; supported version: ${SESSION_SCHEMA_VERSION}`,
+            });
+        }
+        const provider = this.modelProvider ?? createDefaultProvider(config);
+        const store = this.sessionStore ?? new JsonlSessionStore(config.session.directory);
+        const hookRegistry = new DefaultHookRegistry();
+        for (const hook of this.hooks) {
+            hookRegistry.register(hook);
+        }
+        const hookBus = new DefaultHookBus(hookRegistry, {
+            defaultTimeoutMs: config.hooks.defaultTimeoutMs,
+        });
+        const toolRegistry = new DefaultToolRegistry();
+        for (const tool of this.tools) {
+            toolRegistry.register(tool);
+        }
+        for (const tool of coreTools()) {
+            if (toolRegistry.get(tool.name) === undefined) {
+                toolRegistry.register(tool);
+            }
+        }
+        const toolExecutor = new DefaultToolExecutor(toolRegistry, new JsonSchemaToolInputValidator(), new DefaultToolResultProcessor(), hookBus, {
+            timeoutMs: config.tools.timeoutMs,
+            maxParallel: config.tools.parallelism,
+            maxResultChars: config.tools.maxOutputChars,
+            maxResultLines: config.tools.maxOutputLines,
+        });
+        const projector = new DefaultSessionProjector();
+        const sources = [...this.contextSources];
+        if (!sources.some((source) => source.scope === "session")) {
+            sources.push(new SessionContextSource(store, projector));
+        }
+        const contextManager = new DefaultContextManager(sources, new DefaultProjectionPipeline());
+        const eventBus = new DefaultEventBus();
+        for (const sink of this.eventSinks) {
+            eventBus.subscribe(sink);
+        }
+        const eventPublisher = new DefaultEventPublisher(eventBus);
+        const compactionManager = new DefaultCompactionManager(withDefaultCompactionStrategies(this.compactionStrategies, provider), undefined, {
+            enabled: config.compaction.enabled,
+            softLimitRatio: config.compaction.softLimitRatio,
+            hardLimitRatio: config.compaction.hardLimitRatio,
+            retainRecentTokens: config.compaction.retainRecentTokens,
+        });
+        const loopFactory = new DefaultAgentLoopFactory({
+            modelProvider: provider,
+            contextManager,
+            compactionManager,
+            projectionBudgetPolicy: new DefaultProjectionBudgetPolicy(),
+            toolExecutor,
+            toolRegistry,
+            hookBus,
+            eventPublisher,
+            policy: createDefaultLoopPolicy({
+                maxTurns: config.loop.maxTurns,
+                maxToolRounds: config.loop.maxToolRounds,
+            }),
+        }, {
+            maxReactiveCompactions: config.compaction.maxReactiveCompactions,
+            maxCompactionReprojects: config.compaction.maxCompactionReprojects,
+        });
+        const runManager = new DefaultRunManager({
+            config,
+            modelProvider: provider,
+            sessionFactory: new DefaultSessionFactory(store),
+            sessionProjector: projector,
+            recorderFactory: new SessionRunRecorderFactory(),
+            loopFactory,
+        });
+        return new DefaultAgent({ runManager });
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/agent/builder.js.map

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

package/dist/agent/create-agent.d.ts

@@ -0,0 +1,2 @@
+import type { Agent, CreateAgentOptions } from "./types.js";
+export declare function createAgent(options?: CreateAgentOptions): Promise<Agent>;

package/dist/agent/create-agent.js

@@ -0,0 +1,29 @@
+import { DefaultConfigResolver, DefaultConfigSource, EnvironmentConfigSource, FileConfigSource, RuntimeOverrideSource, } from "../settings/index.js";
+import { DefaultAgentBuilder } from "./builder.js";
+function runtimeOverrides(options) {
+    const overrides = options?.config === undefined
+        ? {}
+        : structuredClone(options.config);
+    const model = {
+        ...(overrides.model ?? {}),
+        ...(options?.model === undefined ? {} : { model: options.model }),
+        ...(options?.apiKey === undefined ? {} : { apiKey: options.apiKey }),
+        ...(options?.baseUrl === undefined ? {} : { baseUrl: options.baseUrl }),
+    };
+    if (Object.keys(model).length > 0) {
+        overrides.model = model;
+    }
+    return overrides;
+}
+export async function createAgent(options) {
+    const config = await new DefaultConfigResolver().resolve([
+        new DefaultConfigSource(),
+        new FileConfigSource(),
+        new EnvironmentConfigSource(),
+        new RuntimeOverrideSource(runtimeOverrides(options)),
+    ]);
+    return new DefaultAgentBuilder()
+        .withConfig(config)
+        .build();
+}
+//# sourceMappingURL=create-agent.js.map

package/dist/agent/create-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent.js","sourceRoot":"","sources":["../../src/agent/create-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,GAGtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAMnD,SAAS,gBAAgB,CACvB,OAAuC;IAEvC,MAAM,SAAS,GACb,OAAO,EAAE,MAAM,KAAK,SAAS;QAC3B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtC,MAAM,KAAK,GAAG;QACZ,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1B,GAAG,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QACjE,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACpE,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;KACxE,CAAC;IAEF,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAA4B;IAE5B,MAAM,MAAM,GAAG,MAAM,IAAI,qBAAqB,EAAE,CAAC,OAAO,CAAC;QACvD,IAAI,mBAAmB,EAAE;QACzB,IAAI,gBAAgB,EAAE;QACtB,IAAI,uBAAuB,EAAE;QAC7B,IAAI,qBAAqB,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;KACrD,CAAC,CAAC;IAEH,OAAO,IAAI,mBAAmB,EAAE;SAC7B,UAAU,CAAC,MAAM,CAAC;SAClB,KAAK,EAAE,CAAC;AACb,CAAC"}

package/dist/agent/index.d.ts

@@ -0,0 +1,8 @@
+export type * from "./types.js";
+export { DefaultAgent, type DefaultAgentDependencies, } from "./agent.js";
+export { DefaultAgentBuilder } from "./builder.js";
+export { createAgent } from "./create-agent.js";
+export { DefaultAgentLoopFactory, type AgentLoopFactory, type DefaultAgentLoopFactoryDependencies, } from "./loop-factory.js";
+export { DefaultRunManager, type RunManager, type RunRecorderFactory, type DefaultRunManagerDependencies, } from "./run-manager.js";
+export { SessionRunRecorder, SessionRunRecorderFactory, } from "./integrations/session-run-recorder.js";
+export { SessionContextSource } from "./integrations/session-context-source.js";

package/dist/agent/index.js

@@ -0,0 +1,8 @@
+export { DefaultAgent, } from "./agent.js";
+export { DefaultAgentBuilder } from "./builder.js";
+export { createAgent } from "./create-agent.js";
+export { DefaultAgentLoopFactory, } from "./loop-factory.js";
+export { DefaultRunManager, } from "./run-manager.js";
+export { SessionRunRecorder, SessionRunRecorderFactory, } from "./integrations/session-run-recorder.js";
+export { SessionContextSource } from "./integrations/session-context-source.js";
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,GAEb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,uBAAuB,GAGxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,GAIlB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC"}

package/dist/agent/integrations/session-context-source.d.ts

@@ -0,0 +1,12 @@
+import type { ContextSource } from "../../context/source.js";
+import type { ContextItem, ContextLoadRequest } from "../../context/types.js";
+import type { SessionStore } from "../../session/store.js";
+import type { SessionProjector } from "../../session/types.js";
+export declare class SessionContextSource implements ContextSource {
+    private readonly store;
+    private readonly projector;
+    readonly id = "session";
+    readonly scope: "session";
+    constructor(store: SessionStore, projector: SessionProjector);
+    load(request: ContextLoadRequest, signal?: AbortSignal): Promise<readonly ContextItem[]>;
+}