@mono-agent/agent-app 0.3.0 → 0.4.1

package/dist/configured-agent.d.ts

@@ -0,0 +1,104 @@
+import type { AgentHarness, AgentHarnessOptions, AgentHarnessRuntimeOptionsExtension, AgentHarnessRuntimeOptionsInput, ConversationHistoryStore } from "@mono-agent/agent-harness";
+import type { AgentResponder, MemoryStore, RunEventSink } from "@mono-agent/agent-contracts";
+import type { MonoAgentConfig } from "@mono-agent/config";
+import type { PhoenixExporterConfig, RunExporter } from "@mono-agent/observability";
+import type { MonoRuntimeLike, RuntimeModelReference } from "@mono-agent/runtime-adapter";
+import type { SandboxEngine } from "@mono-agent/runtime-adapter";
+export interface ConfiguredAgentRuntimeOptions {
+    readonly config: MonoAgentConfig;
+    readonly model?: RuntimeModelReference;
+    readonly executionMode?: string;
+    readonly sandboxEngine?: SandboxEngine;
+}
+export type ConfiguredAgentSessionEventKind = "acquired" | "released" | "saved" | "evicted" | "isolated" | "cold";
+export interface ConfiguredAgentSessionSnapshot {
+    readonly conversationId: string;
+    readonly providerSessionId: string;
+    readonly createdAt: number;
+    readonly lastActivityAt: number;
+    readonly busy: boolean;
+}
+export interface ConfiguredAgentSessionEvent {
+    readonly kind: ConfiguredAgentSessionEventKind;
+    readonly conversationId: string;
+    readonly providerSessionId?: string;
+    readonly createdAt?: number;
+    readonly lastActivityAt?: number;
+    readonly busy?: boolean;
+    readonly reason?: string;
+    readonly snapshot?: readonly ConfiguredAgentSessionSnapshot[];
+}
+type ConfiguredAgentSessionEventHandler = (event: ConfiguredAgentSessionEvent) => void | Promise<void>;
+export interface ConfiguredAgentHarnessOptions {
+    readonly config: MonoAgentConfig;
+    readonly runtime?: MonoRuntimeLike;
+    readonly model?: RuntimeModelReference;
+    readonly executionMode?: string;
+    readonly memory?: MemoryStore;
+    readonly historyStore?: ConversationHistoryStore;
+    readonly createRunId?: AgentHarnessOptions["createRunId"];
+    readonly now?: AgentHarnessOptions["now"];
+    readonly runtimeOptions?: AgentHarnessOptions["runtimeOptions"];
+    readonly sandboxEngine?: SandboxEngine;
+    readonly runtimeOptionsForRequest?: (input: AgentHarnessRuntimeOptionsInput) => AgentHarnessRuntimeOptionsExtension | Promise<AgentHarnessRuntimeOptionsExtension>;
+    readonly onSessionEvent?: ConfiguredAgentSessionEventHandler;
+    /**
+     * Factory for a runtime bound to a per-request override model (cron/webhook
+     * per-trigger model). Wired by the app so override runtimes share the
+     * configured fallback chain and participate in config-reload disposal.
+     */
+    readonly runtimeForModel?: AgentHarnessOptions["runtimeForModel"];
+    /**
+     * Exporter-context fields the factory input cannot supply. Surfaced on the
+     * exported root span so Phoenix traces map back to the running host and its
+     * local artifacts.
+     */
+    readonly observabilityContext?: {
+        readonly sourceId?: string;
+        readonly sourceLabel?: string;
+        readonly configPath?: string;
+    };
+    /** Best-effort exporter warnings (timeouts, transport failures). */
+    readonly exporterWarn?: (warning: {
+        phase: string;
+        message: string;
+    }) => void;
+    /** Injection seam (tests); defaults to createPhoenixRunExporter. */
+    readonly exporterFactory?: (config: PhoenixExporterConfig) => RunExporter;
+    /**
+     * In-process live run-event bus. When present, every run's start/event/finish
+     * is ALSO published here (best-effort, additive) so a live operator surface can
+     * observe runs mid-flight. Wired by the app from its shared bus.
+     */
+    readonly runEventSink?: RunEventSink;
+}
+export interface ConfiguredAgentResponderOptions extends ConfiguredAgentHarnessOptions {
+}
+export declare function createConfiguredAgentRuntime(config: MonoAgentConfig): MonoRuntimeLike;
+export declare function createConfiguredAgentRuntime(options: ConfiguredAgentRuntimeOptions): MonoRuntimeLike;
+export declare function createConfiguredAgentHarness(options: ConfiguredAgentHarnessOptions): Promise<AgentHarness>;
+export declare function createConfiguredAgentResponder(options: ConfiguredAgentResponderOptions): Promise<AgentResponder>;
+export declare function createConfiguredMemory(config: MonoAgentConfig, deps?: {
+    logger?: {
+        warn(message: string): void;
+    };
+    /**
+     * Injection seam for the bujo memory LLM's runtime (tests). This runtime MUST
+     * NOT carry the channel runtime's fallback chain: the agent-runtime fallback
+     * router overrides each run's per-call `model` with the chain's primary entry,
+     * so a memory LLM riding the channel runtime would silently execute on
+     * `config.runtime.model` instead of `config.memory.llm.model`. When omitted the
+     * memory LLM builds its OWN fallback-free runtime from
+     * `runtimeHostOptionsForConfig(config)` (preserving the pi auth resolver) so the
+     * per-call `config.memory.llm.model` is the sole, effective primary.
+     */
+    memoryRuntime?: MonoRuntimeLike;
+    /**
+     * When supplied, the bujo memory LLM records each `complete()` as a run via
+     * the same JSONL + Phoenix pipeline as channel runs (subject to the
+     * `memory.llm.trace` toggle). Omitted → memory LLM runs unrecorded.
+     */
+    observability?: Pick<ConfiguredAgentHarnessOptions, "observabilityContext" | "exporterWarn" | "exporterFactory" | "runEventSink">;
+}): Promise<MemoryStore | undefined>;
+export {};
+//# sourceMappingURL=configured-agent.d.ts.map

package/dist/configured-agent.d.ts.map

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