@electric-ax/agents 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,184 @@
+import { AgentTool, EntityRegistry, EntityStreamDBWithActions, HandlerContext, RuntimeHandler, WakeEvent } from "@electric-ax/agents-runtime";
+import { ChangeEvent } from "@durable-streams/state";
+import { AgentTool as AgentTool$1, StreamFn } from "@mariozechner/pi-agent-core";
+import { IncomingMessage, ServerResponse } from "node:http";
+
+//#region src/bootstrap.d.ts
+
+declare const DEFAULT_BUILTIN_AGENT_HANDLER_PATH = "/_electric/builtin-agent-handler";
+interface AgentHandlerResult {
+  handler: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+  runtime: RuntimeHandler;
+  registry: EntityRegistry;
+  typeNames: Array<string>;
+}
+interface BuiltinAgentHandlerOptions {
+  agentServerUrl: string;
+  serveEndpoint?: string;
+  workingDirectory?: string;
+  streamFn?: StreamFn;
+  createElectricTools?: (context: {
+    entityUrl: string;
+    entityType: string;
+    args: Readonly<Record<string, unknown>>;
+    db: EntityStreamDBWithActions;
+    events: Array<ChangeEvent>;
+    upsertCronSchedule: (opts: {
+      id: string;
+      expression: string;
+      timezone?: string;
+      payload?: unknown;
+      debounceMs?: number;
+      timeoutMs?: number;
+    }) => Promise<{
+      txid: string;
+    }>;
+    upsertFutureSendSchedule: (opts: {
+      id: string;
+      payload: unknown;
+      targetUrl?: string;
+      fireAt: string;
+      from?: string;
+      messageType?: string;
+    }) => Promise<{
+      txid: string;
+    }>;
+    deleteSchedule: (opts: {
+      id: string;
+    }) => Promise<{
+      txid: string;
+    }>;
+  }) => Array<AgentTool> | Promise<Array<AgentTool>>;
+}
+declare function createBuiltinAgentHandler(options: BuiltinAgentHandlerOptions): AgentHandlerResult | null;
+declare function createAgentHandler(agentServerUrl: string, workingDirectory?: string, streamFn?: StreamFn, createElectricTools?: BuiltinAgentHandlerOptions[`createElectricTools`], serveEndpoint?: string): AgentHandlerResult | null;
+declare function registerBuiltinAgentTypes(bootstrap: AgentHandlerResult): Promise<void>;
+declare const registerAgentTypes: typeof registerBuiltinAgentTypes; //#endregion
+//#region src/server.d.ts
+interface BuiltinAgentsServerOptions {
+  agentServerUrl: string;
+  baseUrl?: string;
+  port: number;
+  host?: string;
+  workingDirectory?: string;
+  mockStreamFn?: StreamFn;
+  webhookPath?: string;
+  createElectricTools?: (context: {
+    entityUrl: string;
+    entityType: string;
+    args: Readonly<Record<string, unknown>>;
+    db: EntityStreamDBWithActions;
+    events: Array<ChangeEvent>;
+    upsertCronSchedule: (opts: {
+      id: string;
+      expression: string;
+      timezone?: string;
+      payload?: unknown;
+      debounceMs?: number;
+      timeoutMs?: number;
+    }) => Promise<{
+      txid: string;
+    }>;
+    upsertFutureSendSchedule: (opts: {
+      id: string;
+      payload: unknown;
+      targetUrl?: string;
+      fireAt: string;
+      from?: string;
+      messageType?: string;
+    }) => Promise<{
+      txid: string;
+    }>;
+    deleteSchedule: (opts: {
+      id: string;
+    }) => Promise<{
+      txid: string;
+    }>;
+  }) => Array<AgentTool> | Promise<Array<AgentTool>>;
+}
+declare class BuiltinAgentsServer {
+  private server;
+  private bootstrap;
+  private _url;
+  private publicBaseUrl;
+  readonly options: BuiltinAgentsServerOptions;
+  constructor(options: BuiltinAgentsServerOptions);
+  get url(): string;
+  get registeredBaseUrl(): string;
+  start(): Promise<string>;
+  stop(): Promise<void>;
+  private handleRequest;
+}
+
+//#endregion
+//#region src/entrypoint-lib.d.ts
+type EnvSource = Record<string, string | undefined>;
+interface BuiltinAgentsEntrypointOptions extends BuiltinAgentsServerOptions {}
+interface BuiltinAgentsEntrypointServer {
+  start: () => Promise<string>;
+  stop: () => Promise<void>;
+}
+interface RunBuiltinAgentsEntrypointOptions {
+  env?: EnvSource;
+  cwd?: string;
+  createServer?: (options: BuiltinAgentsEntrypointOptions) => BuiltinAgentsEntrypointServer;
+}
+declare function resolveBuiltinAgentsEntrypointOptions(env?: EnvSource, cwd?: string): BuiltinAgentsEntrypointOptions;
+declare function runBuiltinAgentsEntrypoint({
+  env,
+  cwd,
+  createServer
+}?: RunBuiltinAgentsEntrypointOptions): Promise<{
+  options: BuiltinAgentsEntrypointOptions;
+  server: BuiltinAgentsEntrypointServer;
+  url: string;
+}>;
+
+//#endregion
+//#region src/agents/horton.d.ts
+declare const HORTON_MODEL = "claude-sonnet-4-5-20250929";
+declare function generateTitle(userMessage: string, llmCall?: (prompt: string) => Promise<string>): Promise<string>;
+declare function buildHortonSystemPrompt(workingDirectory: string, opts?: {
+  hasDocsSupport?: boolean;
+}): string;
+declare function createHortonTools(workingDirectory: string, ctx: HandlerContext, readSet: Set<string>, opts?: {
+  docsSearchTool?: AgentTool$1;
+}): Array<AgentTool$1>;
+declare function registerHorton(registry: EntityRegistry, options: {
+  workingDirectory: string;
+  streamFn?: StreamFn;
+}): Array<string>;
+
+//#endregion
+//#region src/agents/worker.d.ts
+declare function registerWorker(registry: EntityRegistry, options: {
+  workingDirectory: string;
+  streamFn?: StreamFn;
+}): void;
+
+//#endregion
+//#region src/tools/spawn-worker.d.ts
+declare const WORKER_TOOL_NAMES: readonly ["bash", "read", "write", "edit", "brave_search", "fetch_url", "spawn_worker"];
+type WorkerToolName = (typeof WORKER_TOOL_NAMES)[number];
+declare function createSpawnWorkerTool(ctx: HandlerContext): AgentTool$1;
+
+//#endregion
+//#region src/docs/knowledge-base.d.ts
+interface HortonDocsSupport {
+  createSearchTool: () => AgentTool;
+  resolveCurrentQuestion: (wake: WakeEvent, events: Array<Pick<ChangeEvent, `type` | `value`>>, inbox: Array<{
+    payload?: unknown;
+  }>) => string;
+  renderRetrievedDocsSource: (wake: WakeEvent, events: Array<Pick<ChangeEvent, `type` | `value`>>, inbox: Array<{
+    payload?: unknown;
+  }>) => Promise<string>;
+  renderCompressedToc: () => Promise<string>;
+  ensureReady: () => Promise<void>;
+}
+declare function createHortonDocsSupport(workingDirectory: string, opts?: {
+  docsRoot?: string;
+  dbPath?: string;
+}): HortonDocsSupport | null;
+
+//#endregion
+export { AgentHandlerResult, BuiltinAgentHandlerOptions, BuiltinAgentsEntrypointOptions, BuiltinAgentsEntrypointServer, BuiltinAgentsServer, BuiltinAgentsServerOptions, DEFAULT_BUILTIN_AGENT_HANDLER_PATH, HORTON_MODEL, RunBuiltinAgentsEntrypointOptions, WORKER_TOOL_NAMES, WorkerToolName, buildHortonSystemPrompt, createAgentHandler, createBuiltinAgentHandler, createHortonDocsSupport, createHortonTools, createSpawnWorkerTool, generateTitle, registerAgentTypes, registerBuiltinAgentTypes, registerHorton, registerWorker, resolveBuiltinAgentsEntrypointOptions, runBuiltinAgentsEntrypoint };

package/dist/index.d.ts

@@ -0,0 +1,184 @@
+import { AgentTool, EntityRegistry, EntityStreamDBWithActions, HandlerContext, RuntimeHandler, WakeEvent } from "@electric-ax/agents-runtime";
+import { IncomingMessage, ServerResponse } from "node:http";
+import { ChangeEvent } from "@durable-streams/state";
+import { AgentTool as AgentTool$1, StreamFn } from "@mariozechner/pi-agent-core";
+
+//#region src/bootstrap.d.ts
+
+declare const DEFAULT_BUILTIN_AGENT_HANDLER_PATH = "/_electric/builtin-agent-handler";
+interface AgentHandlerResult {
+  handler: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+  runtime: RuntimeHandler;
+  registry: EntityRegistry;
+  typeNames: Array<string>;
+}
+interface BuiltinAgentHandlerOptions {
+  agentServerUrl: string;
+  serveEndpoint?: string;
+  workingDirectory?: string;
+  streamFn?: StreamFn;
+  createElectricTools?: (context: {
+    entityUrl: string;
+    entityType: string;
+    args: Readonly<Record<string, unknown>>;
+    db: EntityStreamDBWithActions;
+    events: Array<ChangeEvent>;
+    upsertCronSchedule: (opts: {
+      id: string;
+      expression: string;
+      timezone?: string;
+      payload?: unknown;
+      debounceMs?: number;
+      timeoutMs?: number;
+    }) => Promise<{
+      txid: string;
+    }>;
+    upsertFutureSendSchedule: (opts: {
+      id: string;
+      payload: unknown;
+      targetUrl?: string;
+      fireAt: string;
+      from?: string;
+      messageType?: string;
+    }) => Promise<{
+      txid: string;
+    }>;
+    deleteSchedule: (opts: {
+      id: string;
+    }) => Promise<{
+      txid: string;
+    }>;
+  }) => Array<AgentTool> | Promise<Array<AgentTool>>;
+}
+declare function createBuiltinAgentHandler(options: BuiltinAgentHandlerOptions): AgentHandlerResult | null;
+declare function createAgentHandler(agentServerUrl: string, workingDirectory?: string, streamFn?: StreamFn, createElectricTools?: BuiltinAgentHandlerOptions[`createElectricTools`], serveEndpoint?: string): AgentHandlerResult | null;
+declare function registerBuiltinAgentTypes(bootstrap: AgentHandlerResult): Promise<void>;
+declare const registerAgentTypes: typeof registerBuiltinAgentTypes; //#endregion
+//#region src/server.d.ts
+interface BuiltinAgentsServerOptions {
+  agentServerUrl: string;
+  baseUrl?: string;
+  port: number;
+  host?: string;
+  workingDirectory?: string;
+  mockStreamFn?: StreamFn;
+  webhookPath?: string;
+  createElectricTools?: (context: {
+    entityUrl: string;
+    entityType: string;
+    args: Readonly<Record<string, unknown>>;
+    db: EntityStreamDBWithActions;
+    events: Array<ChangeEvent>;
+    upsertCronSchedule: (opts: {
+      id: string;
+      expression: string;
+      timezone?: string;
+      payload?: unknown;
+      debounceMs?: number;
+      timeoutMs?: number;
+    }) => Promise<{
+      txid: string;
+    }>;
+    upsertFutureSendSchedule: (opts: {
+      id: string;
+      payload: unknown;
+      targetUrl?: string;
+      fireAt: string;
+      from?: string;
+      messageType?: string;
+    }) => Promise<{
+      txid: string;
+    }>;
+    deleteSchedule: (opts: {
+      id: string;
+    }) => Promise<{
+      txid: string;
+    }>;
+  }) => Array<AgentTool> | Promise<Array<AgentTool>>;
+}
+declare class BuiltinAgentsServer {
+  private server;
+  private bootstrap;
+  private _url;
+  private publicBaseUrl;
+  readonly options: BuiltinAgentsServerOptions;
+  constructor(options: BuiltinAgentsServerOptions);
+  get url(): string;
+  get registeredBaseUrl(): string;
+  start(): Promise<string>;
+  stop(): Promise<void>;
+  private handleRequest;
+}
+
+//#endregion
+//#region src/entrypoint-lib.d.ts
+type EnvSource = Record<string, string | undefined>;
+interface BuiltinAgentsEntrypointOptions extends BuiltinAgentsServerOptions {}
+interface BuiltinAgentsEntrypointServer {
+  start: () => Promise<string>;
+  stop: () => Promise<void>;
+}
+interface RunBuiltinAgentsEntrypointOptions {
+  env?: EnvSource;
+  cwd?: string;
+  createServer?: (options: BuiltinAgentsEntrypointOptions) => BuiltinAgentsEntrypointServer;
+}
+declare function resolveBuiltinAgentsEntrypointOptions(env?: EnvSource, cwd?: string): BuiltinAgentsEntrypointOptions;
+declare function runBuiltinAgentsEntrypoint({
+  env,
+  cwd,
+  createServer
+}?: RunBuiltinAgentsEntrypointOptions): Promise<{
+  options: BuiltinAgentsEntrypointOptions;
+  server: BuiltinAgentsEntrypointServer;
+  url: string;
+}>;
+
+//#endregion
+//#region src/agents/horton.d.ts
+declare const HORTON_MODEL = "claude-sonnet-4-5-20250929";
+declare function generateTitle(userMessage: string, llmCall?: (prompt: string) => Promise<string>): Promise<string>;
+declare function buildHortonSystemPrompt(workingDirectory: string, opts?: {
+  hasDocsSupport?: boolean;
+}): string;
+declare function createHortonTools(workingDirectory: string, ctx: HandlerContext, readSet: Set<string>, opts?: {
+  docsSearchTool?: AgentTool$1;
+}): Array<AgentTool$1>;
+declare function registerHorton(registry: EntityRegistry, options: {
+  workingDirectory: string;
+  streamFn?: StreamFn;
+}): Array<string>;
+
+//#endregion
+//#region src/agents/worker.d.ts
+declare function registerWorker(registry: EntityRegistry, options: {
+  workingDirectory: string;
+  streamFn?: StreamFn;
+}): void;
+
+//#endregion
+//#region src/tools/spawn-worker.d.ts
+declare const WORKER_TOOL_NAMES: readonly ["bash", "read", "write", "edit", "brave_search", "fetch_url", "spawn_worker"];
+type WorkerToolName = (typeof WORKER_TOOL_NAMES)[number];
+declare function createSpawnWorkerTool(ctx: HandlerContext): AgentTool$1;
+
+//#endregion
+//#region src/docs/knowledge-base.d.ts
+interface HortonDocsSupport {
+  createSearchTool: () => AgentTool;
+  resolveCurrentQuestion: (wake: WakeEvent, events: Array<Pick<ChangeEvent, `type` | `value`>>, inbox: Array<{
+    payload?: unknown;
+  }>) => string;
+  renderRetrievedDocsSource: (wake: WakeEvent, events: Array<Pick<ChangeEvent, `type` | `value`>>, inbox: Array<{
+    payload?: unknown;
+  }>) => Promise<string>;
+  renderCompressedToc: () => Promise<string>;
+  ensureReady: () => Promise<void>;
+}
+declare function createHortonDocsSupport(workingDirectory: string, opts?: {
+  docsRoot?: string;
+  dbPath?: string;
+}): HortonDocsSupport | null;
+
+//#endregion
+export { AgentHandlerResult, BuiltinAgentHandlerOptions, BuiltinAgentsEntrypointOptions, BuiltinAgentsEntrypointServer, BuiltinAgentsServer, BuiltinAgentsServerOptions, DEFAULT_BUILTIN_AGENT_HANDLER_PATH, HORTON_MODEL, RunBuiltinAgentsEntrypointOptions, WORKER_TOOL_NAMES, WorkerToolName, buildHortonSystemPrompt, createAgentHandler, createBuiltinAgentHandler, createHortonDocsSupport, createHortonTools, createSpawnWorkerTool, generateTitle, registerAgentTypes, registerBuiltinAgentTypes, registerHorton, registerWorker, resolveBuiltinAgentsEntrypointOptions, runBuiltinAgentsEntrypoint };