@sschepis/oboto-agent 0.1.0

package/README.md

@@ -0,0 +1,204 @@
+# oboto-agent
+
+Event-driven dual-LLM orchestration library for autonomous AI agents.
+
+`oboto-agent` is a lightweight TypeScript library that acts as the central nervous system for AI agents. It binds three specialized primitives together through a typed event bus:
+
+- **[lmscript](https://github.com/sschepis/lmscript)** — LLM I/O, structured output, provider abstraction
+- **[swiss-army-tool](https://github.com/sschepis/swiss-army-tool)** — Hierarchical tool execution
+- **[as-agent](https://github.com/sschepis/as-agent)** — Session state and conversation history
+
+## Key Features
+
+- **Dual-LLM architecture** — Fast local model (Ollama/LMStudio) for triage, powerful cloud model (Anthropic/OpenAI/Gemini) for complex tasks
+- **Automatic triage** — Local model classifies each input and only escalates when needed
+- **Event-driven** — All state transitions emit typed events for CLI, web, or daemon integration
+- **Context management** — Automatic summarization when context window fills up
+- **Interruption handling** — Users can redirect the agent mid-execution
+- **Platform-agnostic** — No Node.js-specific APIs; works in browser, Deno, and Bun
+- **Headless** — No UI framework dependency; bring your own interface
+
+## Installation
+
+```bash
+npm install @sschepis/oboto-agent
+
+# Peer dependencies
+npm install @sschepis/lmscript @sschepis/swiss-army-tool @sschepis/as-agent zod
+```
+
+## Quick Start
+
+```typescript
+import { ObotoAgent } from "@sschepis/oboto-agent";
+import { OllamaProvider, AnthropicProvider } from "@sschepis/lmscript";
+import { TreeBuilder, Router, SessionManager } from "@sschepis/swiss-army-tool";
+
+// Build tools
+const builder = new TreeBuilder();
+builder.leaf("time", "Get current time", {}, () => new Date().toISOString());
+builder.leaf("greet", "Say hello", { name: "string" }, (args) => `Hello, ${args.name}!`);
+const { root } = builder.build();
+const router = new Router(root, new SessionManager("s1"));
+
+// Create agent
+const agent = new ObotoAgent({
+  localModel: new OllamaProvider({ baseUrl: "http://localhost:11434" }),
+  remoteModel: new AnthropicProvider({ apiKey: process.env.ANTHROPIC_API_KEY! }),
+  localModelName: "llama3:8b",
+  remoteModelName: "claude-sonnet-4-20250514",
+  router,
+});
+
+// Listen to events
+agent.on("agent_thought", (e) => console.log(e.payload.text));
+agent.on("tool_execution_complete", (e) => console.log("Tool:", e.payload.result));
+agent.on("error", (e) => console.error(e.payload.message));
+
+// Run
+await agent.submitInput("What time is it?");
+```
+
+## Architecture
+
+```
+User Input
+    │
+    ▼
+┌──────────────────────────┐
+│       ObotoAgent          │
+│                           │
+│  ┌─────────┐ ┌────────┐  │
+│  │ Event   │ │Context │  │
+│  │  Bus    │ │Manager │  │
+│  └─────────┘ └────────┘  │
+│                           │
+│  Triage (local LLM)      │
+│    ├── Simple → respond   │
+│    └── Complex → escalate │
+│                           │
+│  AgentLoop (remote LLM)  │
+│    └── Tool calls → Router│
+└──────────────────────────┘
+    │         │         │
+    ▼         ▼         ▼
+ as-agent  lmscript  swiss-army-tool
+ (state)   (LLM I/O)  (tools)
+```
+
+### Execution Flow
+
+1. **Input** — User submits text via `submitInput()`
+2. **Record** — Message appended to session (as-agent) and context window (lmscript ContextStack)
+3. **Triage** — Local LLM classifies: simple or complex?
+4. **Direct response** — If simple, local model responds immediately
+5. **Escalate** — If complex, remote model runs with tool access via AgentLoop
+6. **Tool execution** — LLM calls tools through the swiss-army-tool Router
+7. **Turn complete** — Response recorded, events emitted
+
+### Events
+
+| Event | Description |
+|---|---|
+| `user_input` | User submitted text |
+| `triage_result` | Local LLM classified the input |
+| `agent_thought` | LLM produced text output |
+| `tool_execution_start` | Tool call began |
+| `tool_execution_complete` | Tool call finished |
+| `state_updated` | Session or context changed |
+| `interruption` | User interrupted mid-execution |
+| `error` | Something failed |
+| `turn_complete` | Full turn finished |
+
+## API
+
+### `ObotoAgent`
+
+```typescript
+const agent = new ObotoAgent(config: ObotoAgentConfig);
+
+await agent.submitInput(text);        // Submit user input
+agent.interrupt(newDirectives?);      // Halt and redirect
+agent.on(event, handler);             // Subscribe (returns unsub fn)
+agent.once(event, handler);           // One-time subscribe
+agent.getSession();                   // Get session state
+agent.processing;                     // Is currently executing?
+agent.removeAllListeners();           // Clear all subscriptions
+```
+
+### Configuration
+
+```typescript
+interface ObotoAgentConfig {
+  localModel: LLMProvider;       // Fast local model
+  remoteModel: LLMProvider;      // Powerful cloud model
+  localModelName: string;        // e.g. "llama3:8b"
+  remoteModelName: string;       // e.g. "claude-sonnet-4-20250514"
+  router: Router;                // swiss-army-tool Router
+  session?: Session;             // Resume existing session
+  maxContextTokens?: number;     // Default: 8192
+  maxIterations?: number;        // Default: 10
+  systemPrompt?: string;         // Custom system prompt
+}
+```
+
+### Utility Exports
+
+```typescript
+// Adapters
+createRouterTool(router, root?)    // Router → lmscript ToolDefinition
+toChat(msg)                         // as-agent → lmscript message
+fromChat(msg)                       // lmscript → as-agent message
+sessionToHistory(session)           // Session → ChatMessage[]
+createEmptySession()                // Fresh empty session
+
+// Components
+AgentEventBus                       // Standalone event emitter
+ContextManager                      // Context window manager
+createTriageFunction(modelName)     // Triage LScriptFunction
+TriageSchema                        // Zod schema for triage output
+```
+
+## Examples
+
+See the [examples/](examples/) directory:
+
+- **[basic-cli.ts](examples/basic-cli.ts)** — Interactive CLI agent with triage
+- **[custom-tools.ts](examples/custom-tools.ts)** — Rich file system tool tree
+- **[event-monitoring.ts](examples/event-monitoring.ts)** — Log all agent events with colors
+- **[session-persistence.ts](examples/session-persistence.ts)** — Save/restore sessions across restarts
+
+## Documentation
+
+- **[Architecture](docs/architecture.md)** — System design, data flow, adapter layer
+- **[API Reference](docs/api.md)** — Complete API documentation
+- **[Guides](docs/guides.md)** — How-to guides for common tasks
+
+## Development
+
+```bash
+npm install         # Install dependencies
+npm run build       # Build with tsup
+npm test            # Run tests with vitest
+npm run typecheck   # Type-check without emitting
+npm run dev         # Watch mode build
+```
+
+## Supported Providers
+
+Any lmscript provider works as either the local or remote model:
+
+| Provider | Package | Typical Role |
+|---|---|---|
+| Ollama | `OllamaProvider` | Local |
+| LM Studio | `LMStudioProvider` | Local |
+| Anthropic | `AnthropicProvider` | Remote |
+| OpenAI | `OpenAIProvider` | Remote |
+| Google Gemini | `GeminiProvider` | Remote |
+| OpenRouter | `OpenRouterProvider` | Remote |
+| DeepSeek | `DeepSeekProvider` | Remote |
+| AWS Bedrock | `VertexAnthropicProvider` | Remote |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,188 @@
+import { Session, ConversationMessage } from '@sschepis/as-agent';
+import { LLMProvider, ToolDefinition, ChatMessage, LScriptRuntime, LScriptFunction } from '@sschepis/lmscript';
+import { Router, BranchNode } from '@sschepis/swiss-army-tool';
+import { z } from 'zod';
+
+interface ObotoAgentConfig {
+    /** Small, fast model for triage and summarization (e.g. Ollama, LMStudio) */
+    localModel: LLMProvider;
+    /** Powerful model for complex reasoning (e.g. Anthropic, OpenAI, Gemini) */
+    remoteModel: LLMProvider;
+    /** Model identifier for the local provider (e.g. "llama3:8b") */
+    localModelName: string;
+    /** Model identifier for the remote provider (e.g. "claude-sonnet-4-20250514") */
+    remoteModelName: string;
+    /** Pre-built swiss-army-tool Router for tool execution */
+    router: Router;
+    /** Existing session to resume (creates empty session if omitted) */
+    session?: Session;
+    /** Maximum tokens for context window management. Default: 8192 */
+    maxContextTokens?: number;
+    /** Maximum LLM iterations per turn. Default: 10 */
+    maxIterations?: number;
+    /** System prompt prepended to all LLM calls */
+    systemPrompt?: string;
+}
+type AgentEventType = "user_input" | "agent_thought" | "triage_result" | "tool_execution_start" | "tool_execution_complete" | "state_updated" | "interruption" | "error" | "turn_complete";
+interface AgentEvent<T = unknown> {
+    type: AgentEventType;
+    payload: T;
+    timestamp: number;
+}
+interface TriageResult {
+    /** Whether the input should be escalated to the remote model */
+    escalate: boolean;
+    /** Brief reasoning for the triage decision */
+    reasoning: string;
+    /** Direct response if the local model can answer immediately */
+    directResponse?: string;
+}
+interface ToolExecutionEvent {
+    command: string;
+    kwargs: Record<string, unknown>;
+    result?: string;
+    error?: string;
+    durationMs?: number;
+}
+
+type EventHandler$1 = (event: AgentEvent) => void;
+/**
+ * ObotoAgent is the central orchestrator for dual-LLM agent execution.
+ *
+ * It binds together:
+ * - lmscript (LLM I/O via local and remote providers)
+ * - swiss-army-tool (tool execution via Router)
+ * - as-agent (session state and conversation history)
+ *
+ * All interaction flows through an event-driven architecture.
+ */
+declare class ObotoAgent {
+    private bus;
+    private localRuntime;
+    private remoteRuntime;
+    private contextManager;
+    private routerTool;
+    private triageFn;
+    private session;
+    private isProcessing;
+    private interrupted;
+    private systemPrompt;
+    private maxIterations;
+    private config;
+    constructor(config: ObotoAgentConfig);
+    /** Subscribe to agent events. Returns an unsubscribe function. */
+    on(type: AgentEventType, handler: EventHandler$1): () => void;
+    /** Subscribe to an event for a single emission. */
+    once(type: AgentEventType, handler: EventHandler$1): () => void;
+    /** Submit user input to the agent. Triggers the execution loop. */
+    submitInput(text: string): Promise<void>;
+    /**
+     * Interrupt the current execution loop.
+     * Optionally inject new directives into the context.
+     */
+    interrupt(newDirectives?: string): void;
+    /** Get the current session state. */
+    getSession(): Session;
+    /** Whether the agent is currently processing input. */
+    get processing(): boolean;
+    /** Remove all event listeners. */
+    removeAllListeners(): void;
+    private executionLoop;
+    private triage;
+    private executeWithModel;
+}
+
+type EventHandler = (event: AgentEvent) => void;
+/**
+ * Platform-agnostic typed event bus.
+ * Uses a plain Map instead of Node.js EventEmitter for browser/Deno/Bun compatibility.
+ */
+declare class AgentEventBus {
+    private listeners;
+    /** Subscribe to an event type. Returns an unsubscribe function. */
+    on(type: AgentEventType, handler: EventHandler): () => void;
+    /** Unsubscribe a handler from an event type. */
+    off(type: AgentEventType, handler: EventHandler): void;
+    /** Subscribe to an event type for a single emission. */
+    once(type: AgentEventType, handler: EventHandler): () => void;
+    /** Emit an event to all subscribers. */
+    emit(type: AgentEventType, payload: unknown): void;
+    /** Remove all listeners for all event types. */
+    removeAllListeners(): void;
+}
+
+/** Parameter schema for the omni-tool bridge. */
+declare const RouterToolParams: z.ZodObject<{
+    command: z.ZodString;
+    kwargs: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    kwargs: Record<string, unknown>;
+}, {
+    command: string;
+    kwargs?: Record<string, unknown> | undefined;
+}>;
+/**
+ * Bridge a swiss-army-tool Router into an lmscript ToolDefinition.
+ *
+ * The LLM sees a single tool ("terminal_interface") with `command` and `kwargs`
+ * parameters. When called, it routes through the swiss-army-tool command tree.
+ */
+declare function createRouterTool(router: Router, root?: BranchNode): ToolDefinition<typeof RouterToolParams, string>;
+
+/** Convert an as-agent ConversationMessage to an lmscript ChatMessage. */
+declare function toChat(msg: ConversationMessage): ChatMessage;
+/** Convert an lmscript ChatMessage to an as-agent ConversationMessage. */
+declare function fromChat(msg: ChatMessage): ConversationMessage;
+/** Convert an entire as-agent Session to an array of lmscript ChatMessages. */
+declare function sessionToHistory(session: Session): ChatMessage[];
+/** Create an empty as-agent Session. */
+declare function createEmptySession(): Session;
+
+/**
+ * Manages the sliding context window with automatic summarization.
+ * Wraps lmscript's ContextStack and uses the local LLM for compression.
+ */
+declare class ContextManager {
+    private localRuntime;
+    private stack;
+    private summarizeFn;
+    constructor(localRuntime: LScriptRuntime, localModelName: string, maxTokens: number);
+    /** Append a message to the context. Triggers pruning if over budget. */
+    push(message: ChatMessage): Promise<void>;
+    /** Append multiple messages. */
+    pushAll(messages: ChatMessage[]): Promise<void>;
+    /** Get all messages in the current context window. */
+    getMessages(): ChatMessage[];
+    /** Get estimated token count. */
+    getTokenCount(): number;
+    /** Clear all context. */
+    clear(): void;
+}
+
+/** Zod schema for structured triage output. */
+declare const TriageSchema: z.ZodObject<{
+    escalate: z.ZodBoolean;
+    reasoning: z.ZodString;
+    directResponse: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    escalate: boolean;
+    reasoning: string;
+    directResponse?: string | undefined;
+}, {
+    escalate: boolean;
+    reasoning: string;
+    directResponse?: string | undefined;
+}>;
+type TriageInput = {
+    userInput: string;
+    recentContext: string;
+    availableTools: string;
+};
+/**
+ * Create an LScriptFunction for local-LLM triage classification.
+ * The local model evaluates whether input needs escalation to the remote model.
+ */
+declare function createTriageFunction(modelName: string): LScriptFunction<TriageInput, typeof TriageSchema>;
+
+export { type AgentEvent, AgentEventBus, type AgentEventType, ContextManager, ObotoAgent, type ObotoAgentConfig, type ToolExecutionEvent, type TriageResult, TriageSchema, createEmptySession, createRouterTool, createTriageFunction, fromChat, sessionToHistory, toChat };

package/dist/index.js

@@ -0,0 +1,431 @@
+// src/oboto-agent.ts
+import { z as z4 } from "zod";
+import {
+  LScriptRuntime,
+  AgentLoop
+} from "@sschepis/lmscript";
+import { MessageRole as MessageRole2 } from "@sschepis/as-agent";
+
+// src/event-bus.ts
+var AgentEventBus = class {
+  listeners = /* @__PURE__ */ new Map();
+  /** Subscribe to an event type. Returns an unsubscribe function. */
+  on(type, handler) {
+    if (!this.listeners.has(type)) {
+      this.listeners.set(type, /* @__PURE__ */ new Set());
+    }
+    this.listeners.get(type).add(handler);
+    return () => this.off(type, handler);
+  }
+  /** Unsubscribe a handler from an event type. */
+  off(type, handler) {
+    this.listeners.get(type)?.delete(handler);
+  }
+  /** Subscribe to an event type for a single emission. */
+  once(type, handler) {
+    const wrapper = (event) => {
+      this.off(type, wrapper);
+      handler(event);
+    };
+    return this.on(type, wrapper);
+  }
+  /** Emit an event to all subscribers. */
+  emit(type, payload) {
+    const event = {
+      type,
+      payload,
+      timestamp: Date.now()
+    };
+    const handlers = this.listeners.get(type);
+    if (handlers) {
+      for (const handler of handlers) {
+        handler(event);
+      }
+    }
+  }
+  /** Remove all listeners for all event types. */
+  removeAllListeners() {
+    this.listeners.clear();
+  }
+};
+
+// src/context-manager.ts
+import { z } from "zod";
+import { ContextStack } from "@sschepis/lmscript";
+var SummarySchema = z.object({
+  summary: z.string().describe("A dense summary of the conversation so far")
+});
+var ContextManager = class {
+  constructor(localRuntime, localModelName, maxTokens) {
+    this.localRuntime = localRuntime;
+    this.stack = new ContextStack({
+      maxTokens,
+      pruneStrategy: "summarize"
+    });
+    this.summarizeFn = {
+      name: "summarize_context",
+      model: localModelName,
+      system: "You are a summarization engine. Compress the given conversation into a dense, factual summary that preserves all key information, decisions, and context needed for continued operation. Be concise but thorough.",
+      prompt: ({ conversation }) => conversation,
+      schema: SummarySchema,
+      temperature: 0.2,
+      maxRetries: 1
+    };
+    this.stack.setSummarizer(async (messages) => {
+      const conversation = messages.map((m) => {
+        const text = typeof m.content === "string" ? m.content : m.content.filter((b) => b.type === "text").map((b) => b.text).join(" ");
+        return `${m.role}: ${text}`;
+      }).join("\n");
+      const result = await this.localRuntime.execute(this.summarizeFn, {
+        conversation
+      });
+      return result.data.summary;
+    });
+  }
+  localRuntime;
+  stack;
+  summarizeFn;
+  /** Append a message to the context. Triggers pruning if over budget. */
+  async push(message) {
+    await this.stack.push(message);
+  }
+  /** Append multiple messages. */
+  async pushAll(messages) {
+    await this.stack.pushAll(messages);
+  }
+  /** Get all messages in the current context window. */
+  getMessages() {
+    return this.stack.getMessages();
+  }
+  /** Get estimated token count. */
+  getTokenCount() {
+    return this.stack.getTokenCount();
+  }
+  /** Clear all context. */
+  clear() {
+    this.stack.clear();
+  }
+};
+
+// src/triage.ts
+import { z as z2 } from "zod";
+var TriageSchema = z2.object({
+  escalate: z2.boolean().describe("True if the request needs a powerful model, false if answerable directly"),
+  reasoning: z2.string().describe("Brief explanation of the triage decision"),
+  directResponse: z2.string().optional().describe("Direct answer if the request can be handled without escalation")
+});
+var TRIAGE_SYSTEM = `You are a fast triage classifier for an AI agent system.
+Your job is to decide whether a user's request can be answered directly (simple queries,
+casual chat, short lookups) or needs to be escalated to a more powerful model
+(complex reasoning, multi-step tool usage, code generation, analysis).
+
+Rules:
+- If the request is a greeting, simple question, or casual conversation: respond directly.
+- If the request needs tool calls, code analysis, or multi-step reasoning: escalate.
+- If unsure, escalate. It's better to over-escalate than to give a poor direct answer.
+- Keep directResponse under 200 words when answering directly.
+
+Respond with JSON matching the schema.`;
+function createTriageFunction(modelName) {
+  return {
+    name: "triage",
+    model: modelName,
+    system: TRIAGE_SYSTEM,
+    prompt: ({ userInput, recentContext, availableTools }) => `Recent context:
+${recentContext}
+
+Available tools: ${availableTools}
+
+User: ${userInput}`,
+    schema: TriageSchema,
+    temperature: 0.1,
+    maxRetries: 1
+  };
+}
+
+// src/adapters/tools.ts
+import { z as z3 } from "zod";
+import { generateToolSchema } from "@sschepis/swiss-army-tool";
+var RouterToolParams = z3.object({
+  command: z3.string().describe(
+    "The command or menu path (e.g., 'help', 'filesystem read', 'db query')"
+  ),
+  kwargs: z3.record(z3.unknown()).optional().default({}).describe("Key-value arguments for the command")
+});
+function createRouterTool(router, root) {
+  const schema = generateToolSchema({ root });
+  return {
+    name: schema.name,
+    description: schema.description,
+    parameters: RouterToolParams,
+    execute: async (params) => {
+      return router.execute(params.command, params.kwargs ?? {});
+    }
+  };
+}
+
+// src/adapters/memory.ts
+import {
+  MessageRole
+} from "@sschepis/as-agent";
+var ROLE_TO_STRING = {
+  [MessageRole.System]: "system",
+  [MessageRole.User]: "user",
+  [MessageRole.Assistant]: "assistant",
+  [MessageRole.Tool]: "user"
+};
+var STRING_TO_ROLE = {
+  system: MessageRole.System,
+  user: MessageRole.User,
+  assistant: MessageRole.Assistant
+};
+function blocksToText(blocks) {
+  return blocks.map((b) => {
+    switch (b.kind) {
+      case "text":
+        return b.text;
+      case "tool_use":
+        return `[Tool call: ${b.name}(${b.input})]`;
+      case "tool_result":
+        return b.isError ? `[Tool error (${b.toolName}): ${b.output}]` : `[Tool result (${b.toolName}): ${b.output}]`;
+    }
+  }).join("\n");
+}
+function toChat(msg) {
+  return {
+    role: ROLE_TO_STRING[msg.role] ?? "user",
+    content: blocksToText(msg.blocks)
+  };
+}
+function fromChat(msg) {
+  const text = typeof msg.content === "string" ? msg.content : msg.content.filter((b) => b.type === "text").map((b) => b.text).join("\n");
+  return {
+    role: STRING_TO_ROLE[msg.role] ?? MessageRole.User,
+    blocks: [{ kind: "text", text }]
+  };
+}
+function sessionToHistory(session) {
+  return session.messages.map(toChat);
+}
+function createEmptySession() {
+  return { version: 1, messages: [] };
+}
+
+// src/oboto-agent.ts
+var AgentResponseSchema = z4.object({
+  response: z4.string().describe("The agent's response to the user")
+});
+var ObotoAgent = class {
+  bus = new AgentEventBus();
+  localRuntime;
+  remoteRuntime;
+  contextManager;
+  routerTool;
+  triageFn;
+  session;
+  isProcessing = false;
+  interrupted = false;
+  systemPrompt;
+  maxIterations;
+  config;
+  constructor(config) {
+    this.config = config;
+    this.localRuntime = new LScriptRuntime({ provider: config.localModel });
+    this.remoteRuntime = new LScriptRuntime({ provider: config.remoteModel });
+    this.session = config.session ?? createEmptySession();
+    this.systemPrompt = config.systemPrompt ?? "You are a helpful AI assistant with access to tools.";
+    this.maxIterations = config.maxIterations ?? 10;
+    this.contextManager = new ContextManager(
+      this.localRuntime,
+      config.localModelName,
+      config.maxContextTokens ?? 8192
+    );
+    this.routerTool = createRouterTool(config.router);
+    this.triageFn = createTriageFunction(config.localModelName);
+    this.contextManager.push({
+      role: "system",
+      content: this.systemPrompt
+    });
+  }
+  // ── Public API ─────────────────────────────────────────────────────
+  /** Subscribe to agent events. Returns an unsubscribe function. */
+  on(type, handler) {
+    return this.bus.on(type, handler);
+  }
+  /** Subscribe to an event for a single emission. */
+  once(type, handler) {
+    return this.bus.once(type, handler);
+  }
+  /** Submit user input to the agent. Triggers the execution loop. */
+  async submitInput(text) {
+    if (this.isProcessing) {
+      this.interrupt(text);
+      return;
+    }
+    this.isProcessing = true;
+    this.interrupted = false;
+    try {
+      await this.executionLoop(text);
+    } catch (err) {
+      this.bus.emit("error", {
+        message: err instanceof Error ? err.message : String(err),
+        error: err
+      });
+    } finally {
+      this.isProcessing = false;
+    }
+  }
+  /**
+   * Interrupt the current execution loop.
+   * Optionally inject new directives into the context.
+   */
+  interrupt(newDirectives) {
+    this.interrupted = true;
+    this.bus.emit("interruption", { newDirectives });
+    if (newDirectives) {
+      const msg = {
+        role: MessageRole2.User,
+        blocks: [{ kind: "text", text: `[INTERRUPTION] ${newDirectives}` }]
+      };
+      this.session.messages.push(msg);
+      this.contextManager.push(toChat(msg));
+      this.bus.emit("state_updated", { reason: "interruption" });
+    }
+  }
+  /** Get the current session state. */
+  getSession() {
+    return this.session;
+  }
+  /** Whether the agent is currently processing input. */
+  get processing() {
+    return this.isProcessing;
+  }
+  /** Remove all event listeners. */
+  removeAllListeners() {
+    this.bus.removeAllListeners();
+  }
+  // ── Internal ───────────────────────────────────────────────────────
+  async executionLoop(userInput) {
+    this.bus.emit("user_input", { text: userInput });
+    const userMsg = {
+      role: MessageRole2.User,
+      blocks: [{ kind: "text", text: userInput }]
+    };
+    this.session.messages.push(userMsg);
+    await this.contextManager.push(toChat(userMsg));
+    this.bus.emit("state_updated", { reason: "user_input" });
+    const triageResult = await this.triage(userInput);
+    this.bus.emit("triage_result", triageResult);
+    if (this.interrupted) return;
+    if (!triageResult.escalate && triageResult.directResponse) {
+      const response = triageResult.directResponse;
+      this.bus.emit("agent_thought", { text: response, model: "local" });
+      const assistantMsg = {
+        role: MessageRole2.Assistant,
+        blocks: [{ kind: "text", text: response }]
+      };
+      this.session.messages.push(assistantMsg);
+      await this.contextManager.push(toChat(assistantMsg));
+      this.bus.emit("state_updated", { reason: "assistant_response" });
+      this.bus.emit("turn_complete", { model: "local", escalated: false });
+      return;
+    }
+    const runtime = triageResult.escalate ? this.remoteRuntime : this.localRuntime;
+    const modelName = triageResult.escalate ? this.config.remoteModelName : this.config.localModelName;
+    if (triageResult.escalate) {
+      this.bus.emit("agent_thought", {
+        text: triageResult.reasoning,
+        model: "local",
+        escalating: true
+      });
+    }
+    await this.executeWithModel(runtime, modelName, userInput);
+  }
+  async triage(userInput) {
+    const recentMessages = this.contextManager.getMessages().slice(-5);
+    const recentContext = recentMessages.map((m) => {
+      const text = typeof m.content === "string" ? m.content : "[complex content]";
+      return `${m.role}: ${text}`;
+    }).join("\n");
+    const result = await this.localRuntime.execute(this.triageFn, {
+      userInput,
+      recentContext,
+      availableTools: this.routerTool.description
+    });
+    return result.data;
+  }
+  async executeWithModel(runtime, modelName, userInput) {
+    const contextMessages = this.contextManager.getMessages();
+    const contextStr = contextMessages.filter((m) => m.role !== "system").map((m) => {
+      const text = typeof m.content === "string" ? m.content : "[complex content]";
+      return `${m.role}: ${text}`;
+    }).join("\n");
+    const agentFn = {
+      name: "agent_execute",
+      model: modelName,
+      system: this.systemPrompt,
+      prompt: ({ context }) => context ? `Conversation so far:
+${context}
+
+Respond to the user's latest message. Use tools when needed.` : `Respond to the user.`,
+      schema: AgentResponseSchema,
+      temperature: 0.7,
+      tools: [this.routerTool]
+    };
+    const agent = new AgentLoop(runtime, {
+      maxIterations: this.maxIterations,
+      onToolCall: (toolCall) => {
+        const args = toolCall.arguments;
+        this.bus.emit("tool_execution_start", {
+          command: args?.command ?? toolCall.name,
+          kwargs: args?.kwargs ?? {}
+        });
+        this.bus.emit("tool_execution_complete", {
+          command: args?.command ?? toolCall.name,
+          kwargs: args?.kwargs ?? {},
+          result: toolCall.result
+        });
+        if (this.interrupted) return false;
+      },
+      onIteration: (_iteration, response) => {
+        this.bus.emit("agent_thought", {
+          text: response,
+          model: modelName,
+          iteration: _iteration
+        });
+        if (this.interrupted) return false;
+      }
+    });
+    const result = await agent.run(agentFn, {
+      userInput,
+      context: contextStr
+    });
+    const responseText = result.data.response;
+    const assistantMsg = {
+      role: MessageRole2.Assistant,
+      blocks: [{ kind: "text", text: responseText }]
+    };
+    this.session.messages.push(assistantMsg);
+    await this.contextManager.push(toChat(assistantMsg));
+    this.bus.emit("state_updated", { reason: "assistant_response" });
+    this.bus.emit("turn_complete", {
+      model: modelName,
+      escalated: true,
+      iterations: result.iterations,
+      toolCalls: result.toolCalls.length
+    });
+  }
+};
+export {
+  AgentEventBus,
+  ContextManager,
+  ObotoAgent,
+  TriageSchema,
+  createEmptySession,
+  createRouterTool,
+  createTriageFunction,
+  fromChat,
+  sessionToHistory,
+  toChat
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/oboto-agent.ts","../src/event-bus.ts","../src/context-manager.ts","../src/triage.ts","../src/adapters/tools.ts","../src/adapters/memory.ts"],"sourcesContent":["import { z } from \"zod\";\nimport {\n  LScriptRuntime,\n  AgentLoop,\n  type LScriptFunction,\n  type ToolDefinition,\n  type ChatMessage,\n  type ToolCall,\n} from \"@sschepis/lmscript\";\nimport type { Session, ConversationMessage } from \"@sschepis/as-agent\";\nimport { MessageRole } from \"@sschepis/as-agent\";\nimport type { ObotoAgentConfig, AgentEventType, AgentEvent, TriageResult } from \"./types.js\";\nimport { AgentEventBus } from \"./event-bus.js\";\nimport { ContextManager } from \"./context-manager.js\";\nimport { createTriageFunction, type TriageInput } from \"./triage.js\";\nimport { createRouterTool } from \"./adapters/tools.js\";\nimport { toChat, fromChat, createEmptySession } from \"./adapters/memory.js\";\n\ntype EventHandler = (event: AgentEvent) => void;\n\n/** Free-form response schema for the main agent loop. */\nconst AgentResponseSchema = z.object({\n  response: z.string().describe(\"The agent's response to the user\"),\n});\n\ntype AgentInput = { userInput: string; context: string };\n\n/**\n * ObotoAgent is the central orchestrator for dual-LLM agent execution.\n *\n * It binds together:\n * - lmscript (LLM I/O via local and remote providers)\n * - swiss-army-tool (tool execution via Router)\n * - as-agent (session state and conversation history)\n *\n * All interaction flows through an event-driven architecture.\n */\nexport class ObotoAgent {\n  private bus = new AgentEventBus();\n  private localRuntime: LScriptRuntime;\n  private remoteRuntime: LScriptRuntime;\n  private contextManager: ContextManager;\n  private routerTool: ToolDefinition<any, any>;\n  private triageFn: ReturnType<typeof createTriageFunction>;\n  private session: Session;\n  private isProcessing = false;\n  private interrupted = false;\n  private systemPrompt: string;\n  private maxIterations: number;\n  private config: ObotoAgentConfig;\n\n  constructor(config: ObotoAgentConfig) {\n    this.config = config;\n    this.localRuntime = new LScriptRuntime({ provider: config.localModel });\n    this.remoteRuntime = new LScriptRuntime({ provider: config.remoteModel });\n    this.session = config.session ?? createEmptySession();\n    this.systemPrompt = config.systemPrompt ?? \"You are a helpful AI assistant with access to tools.\";\n    this.maxIterations = config.maxIterations ?? 10;\n\n    this.contextManager = new ContextManager(\n      this.localRuntime,\n      config.localModelName,\n      config.maxContextTokens ?? 8192\n    );\n\n    this.routerTool = createRouterTool(config.router);\n    this.triageFn = createTriageFunction(config.localModelName);\n\n    // Push system prompt into context\n    this.contextManager.push({\n      role: \"system\",\n      content: this.systemPrompt,\n    });\n  }\n\n  // ── Public API ─────────────────────────────────────────────────────\n\n  /** Subscribe to agent events. Returns an unsubscribe function. */\n  on(type: AgentEventType, handler: EventHandler): () => void {\n    return this.bus.on(type, handler);\n  }\n\n  /** Subscribe to an event for a single emission. */\n  once(type: AgentEventType, handler: EventHandler): () => void {\n    return this.bus.once(type, handler);\n  }\n\n  /** Submit user input to the agent. Triggers the execution loop. */\n  async submitInput(text: string): Promise<void> {\n    if (this.isProcessing) {\n      this.interrupt(text);\n      return;\n    }\n\n    this.isProcessing = true;\n    this.interrupted = false;\n\n    try {\n      await this.executionLoop(text);\n    } catch (err) {\n      this.bus.emit(\"error\", {\n        message: err instanceof Error ? err.message : String(err),\n        error: err,\n      });\n    } finally {\n      this.isProcessing = false;\n    }\n  }\n\n  /**\n   * Interrupt the current execution loop.\n   * Optionally inject new directives into the context.\n   */\n  interrupt(newDirectives?: string): void {\n    this.interrupted = true;\n    this.bus.emit(\"interruption\", { newDirectives });\n\n    if (newDirectives) {\n      const msg: ConversationMessage = {\n        role: MessageRole.User,\n        blocks: [{ kind: \"text\", text: `[INTERRUPTION] ${newDirectives}` }],\n      };\n      this.session.messages.push(msg);\n      this.contextManager.push(toChat(msg));\n      this.bus.emit(\"state_updated\", { reason: \"interruption\" });\n    }\n  }\n\n  /** Get the current session state. */\n  getSession(): Session {\n    return this.session;\n  }\n\n  /** Whether the agent is currently processing input. */\n  get processing(): boolean {\n    return this.isProcessing;\n  }\n\n  /** Remove all event listeners. */\n  removeAllListeners(): void {\n    this.bus.removeAllListeners();\n  }\n\n  // ── Internal ───────────────────────────────────────────────────────\n\n  private async executionLoop(userInput: string): Promise<void> {\n    // 1. Emit user_input and record in session + context\n    this.bus.emit(\"user_input\", { text: userInput });\n\n    const userMsg: ConversationMessage = {\n      role: MessageRole.User,\n      blocks: [{ kind: \"text\", text: userInput }],\n    };\n    this.session.messages.push(userMsg);\n    await this.contextManager.push(toChat(userMsg));\n    this.bus.emit(\"state_updated\", { reason: \"user_input\" });\n\n    // 2. Triage via local LLM\n    const triageResult = await this.triage(userInput);\n    this.bus.emit(\"triage_result\", triageResult);\n\n    if (this.interrupted) return;\n\n    // 3. If local can handle directly, emit and return\n    if (!triageResult.escalate && triageResult.directResponse) {\n      const response = triageResult.directResponse;\n      this.bus.emit(\"agent_thought\", { text: response, model: \"local\" });\n\n      const assistantMsg: ConversationMessage = {\n        role: MessageRole.Assistant,\n        blocks: [{ kind: \"text\", text: response }],\n      };\n      this.session.messages.push(assistantMsg);\n      await this.contextManager.push(toChat(assistantMsg));\n      this.bus.emit(\"state_updated\", { reason: \"assistant_response\" });\n      this.bus.emit(\"turn_complete\", { model: \"local\", escalated: false });\n      return;\n    }\n\n    // 4. Escalate to remote model with tool access\n    const runtime = triageResult.escalate ? this.remoteRuntime : this.localRuntime;\n    const modelName = triageResult.escalate\n      ? this.config.remoteModelName\n      : this.config.localModelName;\n\n    if (triageResult.escalate) {\n      this.bus.emit(\"agent_thought\", {\n        text: triageResult.reasoning,\n        model: \"local\",\n        escalating: true,\n      });\n    }\n\n    await this.executeWithModel(runtime, modelName, userInput);\n  }\n\n  private async triage(userInput: string): Promise<TriageResult> {\n    const recentMessages = this.contextManager.getMessages().slice(-5);\n    const recentContext = recentMessages\n      .map((m) => {\n        const text = typeof m.content === \"string\" ? m.content : \"[complex content]\";\n        return `${m.role}: ${text}`;\n      })\n      .join(\"\\n\");\n\n    const result = await this.localRuntime.execute(this.triageFn, {\n      userInput,\n      recentContext,\n      availableTools: this.routerTool.description,\n    });\n\n    return result.data;\n  }\n\n  private async executeWithModel(\n    runtime: LScriptRuntime,\n    modelName: string,\n    userInput: string\n  ): Promise<void> {\n    const contextMessages = this.contextManager.getMessages();\n    const contextStr = contextMessages\n      .filter((m) => m.role !== \"system\")\n      .map((m) => {\n        const text = typeof m.content === \"string\" ? m.content : \"[complex content]\";\n        return `${m.role}: ${text}`;\n      })\n      .join(\"\\n\");\n\n    const agentFn: LScriptFunction<AgentInput, typeof AgentResponseSchema> = {\n      name: \"agent_execute\",\n      model: modelName,\n      system: this.systemPrompt,\n      prompt: ({ context }) =>\n        context\n          ? `Conversation so far:\\n${context}\\n\\nRespond to the user's latest message. Use tools when needed.`\n          : `Respond to the user.`,\n      schema: AgentResponseSchema,\n      temperature: 0.7,\n      tools: [this.routerTool],\n    };\n\n    const agent = new AgentLoop(runtime, {\n      maxIterations: this.maxIterations,\n      onToolCall: (toolCall: ToolCall) => {\n        const args = toolCall.arguments as { command?: string; kwargs?: Record<string, unknown> } | undefined;\n        this.bus.emit(\"tool_execution_start\", {\n          command: args?.command ?? toolCall.name,\n          kwargs: args?.kwargs ?? {},\n        });\n        this.bus.emit(\"tool_execution_complete\", {\n          command: args?.command ?? toolCall.name,\n          kwargs: args?.kwargs ?? {},\n          result: toolCall.result,\n        });\n\n        // Check for interruption\n        if (this.interrupted) return false;\n      },\n      onIteration: (_iteration: number, response: string) => {\n        this.bus.emit(\"agent_thought\", {\n          text: response,\n          model: modelName,\n          iteration: _iteration,\n        });\n        if (this.interrupted) return false;\n      },\n    });\n\n    const result = await agent.run(agentFn, {\n      userInput,\n      context: contextStr,\n    });\n\n    // Record final response in session and context\n    const responseText = result.data.response;\n    const assistantMsg: ConversationMessage = {\n      role: MessageRole.Assistant,\n      blocks: [{ kind: \"text\", text: responseText }],\n    };\n    this.session.messages.push(assistantMsg);\n    await this.contextManager.push(toChat(assistantMsg));\n    this.bus.emit(\"state_updated\", { reason: \"assistant_response\" });\n    this.bus.emit(\"turn_complete\", {\n      model: modelName,\n      escalated: true,\n      iterations: result.iterations,\n      toolCalls: result.toolCalls.length,\n    });\n  }\n}\n","import type { AgentEventType, AgentEvent } from \"./types.js\";\n\ntype EventHandler = (event: AgentEvent) => void;\n\n/**\n * Platform-agnostic typed event bus.\n * Uses a plain Map instead of Node.js EventEmitter for browser/Deno/Bun compatibility.\n */\nexport class AgentEventBus {\n  private listeners = new Map<AgentEventType, Set<EventHandler>>();\n\n  /** Subscribe to an event type. Returns an unsubscribe function. */\n  on(type: AgentEventType, handler: EventHandler): () => void {\n    if (!this.listeners.has(type)) {\n      this.listeners.set(type, new Set());\n    }\n    this.listeners.get(type)!.add(handler);\n    return () => this.off(type, handler);\n  }\n\n  /** Unsubscribe a handler from an event type. */\n  off(type: AgentEventType, handler: EventHandler): void {\n    this.listeners.get(type)?.delete(handler);\n  }\n\n  /** Subscribe to an event type for a single emission. */\n  once(type: AgentEventType, handler: EventHandler): () => void {\n    const wrapper: EventHandler = (event) => {\n      this.off(type, wrapper);\n      handler(event);\n    };\n    return this.on(type, wrapper);\n  }\n\n  /** Emit an event to all subscribers. */\n  emit(type: AgentEventType, payload: unknown): void {\n    const event: AgentEvent = {\n      type,\n      payload,\n      timestamp: Date.now(),\n    };\n    const handlers = this.listeners.get(type);\n    if (handlers) {\n      for (const handler of handlers) {\n        handler(event);\n      }\n    }\n  }\n\n  /** Remove all listeners for all event types. */\n  removeAllListeners(): void {\n    this.listeners.clear();\n  }\n}\n","import { z } from \"zod\";\nimport { ContextStack, type LScriptRuntime, type ChatMessage, type LScriptFunction } from \"@sschepis/lmscript\";\n\nconst SummarySchema = z.object({\n  summary: z.string().describe(\"A dense summary of the conversation so far\"),\n});\n\ntype SummaryInput = { conversation: string };\n\n/**\n * Manages the sliding context window with automatic summarization.\n * Wraps lmscript's ContextStack and uses the local LLM for compression.\n */\nexport class ContextManager {\n  private stack: ContextStack;\n  private summarizeFn: LScriptFunction<SummaryInput, typeof SummarySchema>;\n\n  constructor(\n    private localRuntime: LScriptRuntime,\n    localModelName: string,\n    maxTokens: number\n  ) {\n    this.stack = new ContextStack({\n      maxTokens,\n      pruneStrategy: \"summarize\",\n    });\n\n    this.summarizeFn = {\n      name: \"summarize_context\",\n      model: localModelName,\n      system:\n        \"You are a summarization engine. Compress the given conversation into a dense, factual summary that preserves all key information, decisions, and context needed for continued operation. Be concise but thorough.\",\n      prompt: ({ conversation }) => conversation,\n      schema: SummarySchema,\n      temperature: 0.2,\n      maxRetries: 1,\n    };\n\n    this.stack.setSummarizer(async (messages: ChatMessage[]) => {\n      const conversation = messages\n        .map((m) => {\n          const text =\n            typeof m.content === \"string\"\n              ? m.content\n              : m.content\n                  .filter((b) => b.type === \"text\")\n                  .map((b) => (b as { text: string }).text)\n                  .join(\" \");\n          return `${m.role}: ${text}`;\n        })\n        .join(\"\\n\");\n\n      const result = await this.localRuntime.execute(this.summarizeFn, {\n        conversation,\n      });\n      return result.data.summary;\n    });\n  }\n\n  /** Append a message to the context. Triggers pruning if over budget. */\n  async push(message: ChatMessage): Promise<void> {\n    await this.stack.push(message);\n  }\n\n  /** Append multiple messages. */\n  async pushAll(messages: ChatMessage[]): Promise<void> {\n    await this.stack.pushAll(messages);\n  }\n\n  /** Get all messages in the current context window. */\n  getMessages(): ChatMessage[] {\n    return this.stack.getMessages();\n  }\n\n  /** Get estimated token count. */\n  getTokenCount(): number {\n    return this.stack.getTokenCount();\n  }\n\n  /** Clear all context. */\n  clear(): void {\n    this.stack.clear();\n  }\n}\n","import { z } from \"zod\";\nimport type { LScriptFunction } from \"@sschepis/lmscript\";\n\n/** Zod schema for structured triage output. */\nexport const TriageSchema = z.object({\n  escalate: z\n    .boolean()\n    .describe(\"True if the request needs a powerful model, false if answerable directly\"),\n  reasoning: z\n    .string()\n    .describe(\"Brief explanation of the triage decision\"),\n  directResponse: z\n    .string()\n    .optional()\n    .describe(\"Direct answer if the request can be handled without escalation\"),\n});\n\nexport type TriageInput = {\n  userInput: string;\n  recentContext: string;\n  availableTools: string;\n};\n\nconst TRIAGE_SYSTEM = `You are a fast triage classifier for an AI agent system.\nYour job is to decide whether a user's request can be answered directly (simple queries,\ncasual chat, short lookups) or needs to be escalated to a more powerful model\n(complex reasoning, multi-step tool usage, code generation, analysis).\n\nRules:\n- If the request is a greeting, simple question, or casual conversation: respond directly.\n- If the request needs tool calls, code analysis, or multi-step reasoning: escalate.\n- If unsure, escalate. It's better to over-escalate than to give a poor direct answer.\n- Keep directResponse under 200 words when answering directly.\n\nRespond with JSON matching the schema.`;\n\n/**\n * Create an LScriptFunction for local-LLM triage classification.\n * The local model evaluates whether input needs escalation to the remote model.\n */\nexport function createTriageFunction(\n  modelName: string\n): LScriptFunction<TriageInput, typeof TriageSchema> {\n  return {\n    name: \"triage\",\n    model: modelName,\n    system: TRIAGE_SYSTEM,\n    prompt: ({ userInput, recentContext, availableTools }) =>\n      `Recent context:\\n${recentContext}\\n\\nAvailable tools: ${availableTools}\\n\\nUser: ${userInput}`,\n    schema: TriageSchema,\n    temperature: 0.1,\n    maxRetries: 1,\n  };\n}\n","import { z } from \"zod\";\nimport type { Router } from \"@sschepis/swiss-army-tool\";\nimport { generateToolSchema } from \"@sschepis/swiss-army-tool\";\nimport type { ToolDefinition } from \"@sschepis/lmscript\";\nimport type { BranchNode } from \"@sschepis/swiss-army-tool\";\n\n/** Parameter schema for the omni-tool bridge. */\nconst RouterToolParams = z.object({\n  command: z.string().describe(\n    \"The command or menu path (e.g., 'help', 'filesystem read', 'db query')\"\n  ),\n  kwargs: z\n    .record(z.unknown())\n    .optional()\n    .default({})\n    .describe(\"Key-value arguments for the command\"),\n});\n\n/**\n * Bridge a swiss-army-tool Router into an lmscript ToolDefinition.\n *\n * The LLM sees a single tool (\"terminal_interface\") with `command` and `kwargs`\n * parameters. When called, it routes through the swiss-army-tool command tree.\n */\nexport function createRouterTool(\n  router: Router,\n  root?: BranchNode\n): ToolDefinition<typeof RouterToolParams, string> {\n  const schema = generateToolSchema({ root });\n\n  return {\n    name: schema.name,\n    description: schema.description,\n    parameters: RouterToolParams,\n    execute: async (params) => {\n      return router.execute(params.command, params.kwargs ?? {});\n    },\n  };\n}\n","import {\n  MessageRole,\n  type ConversationMessage,\n  type ContentBlock as AsContentBlock,\n  type Session,\n} from \"@sschepis/as-agent\";\nimport type { ChatMessage, Role } from \"@sschepis/lmscript\";\n\nconst ROLE_TO_STRING: Record<MessageRole, Role> = {\n  [MessageRole.System]: \"system\",\n  [MessageRole.User]: \"user\",\n  [MessageRole.Assistant]: \"assistant\",\n  [MessageRole.Tool]: \"user\",\n};\n\nconst STRING_TO_ROLE: Record<Role, MessageRole> = {\n  system: MessageRole.System,\n  user: MessageRole.User,\n  assistant: MessageRole.Assistant,\n};\n\n/** Extract plain text from as-agent content blocks. */\nfunction blocksToText(blocks: AsContentBlock[]): string {\n  return blocks\n    .map((b) => {\n      switch (b.kind) {\n        case \"text\":\n          return b.text;\n        case \"tool_use\":\n          return `[Tool call: ${b.name}(${b.input})]`;\n        case \"tool_result\":\n          return b.isError\n            ? `[Tool error (${b.toolName}): ${b.output}]`\n            : `[Tool result (${b.toolName}): ${b.output}]`;\n      }\n    })\n    .join(\"\\n\");\n}\n\n/** Convert an as-agent ConversationMessage to an lmscript ChatMessage. */\nexport function toChat(msg: ConversationMessage): ChatMessage {\n  return {\n    role: ROLE_TO_STRING[msg.role] ?? \"user\",\n    content: blocksToText(msg.blocks),\n  };\n}\n\n/** Convert an lmscript ChatMessage to an as-agent ConversationMessage. */\nexport function fromChat(msg: ChatMessage): ConversationMessage {\n  const text = typeof msg.content === \"string\"\n    ? msg.content\n    : msg.content\n        .filter((b) => b.type === \"text\")\n        .map((b) => (b as { text: string }).text)\n        .join(\"\\n\");\n\n  return {\n    role: STRING_TO_ROLE[msg.role] ?? MessageRole.User,\n    blocks: [{ kind: \"text\", text }],\n  };\n}\n\n/** Convert an entire as-agent Session to an array of lmscript ChatMessages. */\nexport function sessionToHistory(session: Session): ChatMessage[] {\n  return session.messages.map(toChat);\n}\n\n/** Create an empty as-agent Session. */\nexport function createEmptySession(): Session {\n  return { version: 1, messages: [] };\n}\n"],"mappings":"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","names":["z","MessageRole","z","z","z","MessageRole"]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@sschepis/oboto-agent",
+  "version": "0.1.0",
+  "description": "Event-driven dual-LLM orchestration library for autonomous AI agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sschepis/oboto-agent.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sschepis/oboto-agent/issues"
+  },
+  "homepage": "https://github.com/sschepis/oboto-agent#readme",
+  "keywords": [
+    "ai",
+    "agent",
+    "llm",
+    "orchestration",
+    "dual-llm",
+    "event-driven",
+    "tool-calling",
+    "typescript"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^3.23.0"
+  },
+  "peerDependencies": {
+    "@sschepis/lmscript": "^0.1.0",
+    "@sschepis/swiss-army-tool": "^0.1.0",
+    "@sschepis/as-agent": "^0.1.0"
+  },
+  "optionalDependencies": {
+    "@aleph-ai/tinyaleph": "^1.7.0",
+    "@sschepis/resolang": "^0.5.0"
+  },
+  "devDependencies": {
+    "@sschepis/lmscript": "file:../lmscript",
+    "@sschepis/swiss-army-tool": "file:../swiss-army-tool",
+    "@sschepis/as-agent": "file:../claw-code/assembly",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "license": "MIT",
+  "author": "Sebastian Schepis"
+}