@roj-ai/sdk 0.0.2

package/dist/core/events/metadata-utils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Utility functions for computing session metadata from events.
+ * Used for metadata reconciliation after crashes.
+ */
+import type { agentEvents } from '../../core/agents/state.js';
+import type { DomainEvent, FactoryEventType } from '../../core/events/types.js';
+import type { llmEvents } from '../../core/llm/state.js';
+import type { SessionId, SessionMetadata, SessionMetadataMetrics } from '../../core/sessions/schema.js';
+import type { sessionEvents } from '../../core/sessions/state.js';
+import type { toolEvents } from '../../core/tools/state.js';
+import type { mailboxEvents } from '../../plugins/mailbox/state.js';
+export type MetadataEvent = FactoryEventType<typeof sessionEvents | typeof agentEvents | typeof llmEvents | typeof mailboxEvents | typeof toolEvents>;
+/**
+ * Compute metrics from a list of events.
+ * This is the source of truth for what metrics should be.
+ */
+export declare function computeMetricsFromEvents(events: DomainEvent[]): SessionMetadataMetrics;
+/**
+ * Compute full metadata from events (for initial creation or full reconciliation).
+ */
+export declare function computeMetadataFromEvents(sessionId: SessionId, events: DomainEvent[]): SessionMetadata | null;
+/**
+ * Check if stored metadata needs reconciliation by comparing key metrics.
+ * Returns true if reconciliation is needed.
+ */
+export declare function needsReconciliation(stored: SessionMetadata | null, computed: SessionMetadata): boolean;
+//# sourceMappingURL=metadata-utils.d.ts.map

package/dist/core/events/metadata-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-utils.d.ts","sourceRoot":"","sources":["../../../src/core/events/metadata-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AACnG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE/D,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,aAAa,GAAG,OAAO,WAAW,GAAG,OAAO,SAAS,GAAG,OAAO,aAAa,GAAG,OAAO,UAAU,CAAC,CAAA;AAErJ;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,sBAAsB,CA0CtF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACxC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,WAAW,EAAE,GACnB,eAAe,GAAG,IAAI,CAkCxB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,eAAe,GAAG,IAAI,EAC9B,QAAQ,EAAE,eAAe,GACvB,OAAO,CAoBT"}

package/dist/core/events/test-helpers.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Helpers for creating branded DomainEvent objects.
+ *
+ * Event factories (sessionEvents, agentEvents, etc.) produce events
+ * without `sessionId` (it's added by `emitEvent()` at runtime).
+ * `withSessionId` adds the missing field and returns a full DomainEvent.
+ *
+ * Usage:
+ *   const event = withSessionId(sessionId, sessionEvents.create('session_created', { presetId: 'test' }))
+ */
+import type { BaseEvent } from '../../core/events/types.js';
+import type { DomainEvent } from '../../core/events/types.js';
+import type { SessionId } from '../../core/sessions/schema.js';
+/**
+ * Add `sessionId` to a factory-created event, producing a full DomainEvent.
+ *
+ * The factory `.create()` returns `Omit<BaseEvent<K>, 'sessionId'> & payload`
+ * (branded but missing sessionId). This function adds the missing field.
+ *
+ * TypeScript cannot prove `Omit<Union, 'key'> & { key }` reconstructs the
+ * original union (Omit destroys discriminants). The return type uses the same
+ * brand-bridging pattern as `createEventsFactory` — safe because all factory
+ * events with sessionId are structurally valid DomainEvent members.
+ */
+export declare function withSessionId<T extends Omit<BaseEvent<string>, 'sessionId'>>(sessionId: SessionId, event: T): T & {
+    sessionId: SessionId;
+} & DomainEvent;
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/core/events/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../../src/core/events/test-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAE1D;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,EAC3E,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,CAAC,GACN,CAAC,GAAG;IAAE,SAAS,EAAE,SAAS,CAAA;CAAE,GAAG,WAAW,CAE5C"}

package/dist/core/events/types.d.ts

@@ -0,0 +1,46 @@
+import z4 from 'zod/v4';
+import { SessionId } from '../../core/sessions/schema';
+declare const __brand: unique symbol;
+type TheBrand<B> = {
+    [__brand]: B;
+};
+type Brand<T, B> = T & TheBrand<B>;
+export type BaseEvent<T extends string> = Brand<{
+    sessionId: SessionId;
+    timestamp: number;
+    type: T;
+}, 'Event'>;
+export type EventsMap = Record<string, z4.ZodObject<z4.ZodRawShape>>;
+export type EventUnion<TEvents extends EventsMap> = {
+    [K in keyof TEvents & string]: BaseEvent<K> & z4.infer<TEvents[K]>;
+}[keyof TEvents & string];
+type EventsOf<TEvents extends EventsMap> = {
+    [K in keyof TEvents & string]: BaseEvent<K> & z4.infer<TEvents[K]>;
+};
+export interface EventsFactory<TEvents extends EventsMap> {
+    create<K extends keyof TEvents & string>(type: K, input: z4.infer<TEvents[K]>): Omit<BaseEvent<K>, 'sessionId'> & z4.infer<TEvents[K]>;
+    EventType: EventUnion<TEvents>;
+    Events: EventsOf<TEvents>;
+}
+/**
+ * Extract the event union type from an EventsFactory instance.
+ * Usage: FactoryEventType<typeof sessionEvents | typeof agentEvents>
+ */
+export type FactoryEventType<F extends {
+    EventType: unknown;
+}> = F['EventType'] & BaseEvent<string>;
+/**
+ * Generic domain event type — any event with sessionId, timestamp, and type.
+ * Replaces the monolithic DomainEvent union from events.ts.
+ * Individual reducers use their own narrower event types via EventsFactory.
+ */
+export type DomainEvent = BaseEvent<string>;
+/**
+ * Type guard to check if an unknown value is a DomainEvent.
+ */
+export declare const isDomainEvent: (event: unknown) => event is DomainEvent;
+export declare const createEventsFactory: <TEvents extends EventsMap>(_args: {
+    events: TEvents;
+}) => EventsFactory<TEvents>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/events/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/events/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,QAAQ,CAAA;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAElD,OAAO,CAAC,MAAM,OAAO,EAAE,OAAO,MAAM,CAAA;AACpC,KAAK,QAAQ,CAAC,CAAC,IAAI;IAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA;AACnC,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;AAElC,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,KAAK,CAAC;IAC/C,SAAS,EAAE,SAAS,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,CAAC,CAAA;CACP,EAAE,OAAO,CAAC,CAAA;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAA;AAEpE,MAAM,MAAM,UAAU,CAAC,OAAO,SAAS,SAAS,IAAI;KAClD,CAAC,IAAI,MAAM,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAClE,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAA;AAEzB,KAAK,QAAQ,CAAC,OAAO,SAAS,SAAS,IAAI;KACzC,CAAC,IAAI,MAAM,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAClE,CAAA;AAED,MAAM,WAAW,aAAa,CAAC,OAAO,SAAS,SAAS;IACvD,MAAM,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;IACtI,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;IAC9B,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;CACzB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,IAAI,CAAC,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;AAEnG;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;AAE3C;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,WAKhC,CAAA;AAExB,eAAO,MAAM,mBAAmB,GAAI,OAAO,SAAS,SAAS,EAAE,OAAO;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,KAAG,aAAa,CAAC,OAAO,CAWhH,CAAA"}

package/dist/core/file-store/file-store.d.ts

@@ -0,0 +1,56 @@
+/**
+ * SessionFileStore - single FileStore implementation with path resolution.
+ *
+ * Encapsulates all path resolution logic (sandboxed virtual paths, traversal
+ * validation, agent-visible path mapping). Replaces the separate path-resolver
+ * functions for FileStore consumers.
+ *
+ * Three scopes:
+ * - 'full': accepts agent-visible paths (/home/user/session/... or real paths)
+ * - 'session': paths relative to sessionDir
+ * - 'workspace': paths relative to workspaceDir
+ */
+import type { FileEntry, FileStore } from '../../core/file-store/types.js';
+import type { FileSystem } from '../../platform/fs.js';
+import type { Result } from '../../lib/utils/result.js';
+type FileStoreScope = 'full' | 'session' | 'workspace';
+export declare class SessionFileStore implements FileStore {
+    private readonly sessionDir;
+    private readonly workspaceDir;
+    private readonly sandboxed;
+    private readonly fs;
+    private readonly scope;
+    constructor(sessionDir: string, workspaceDir: string | undefined, sandboxed: boolean, fs: FileSystem, scope?: FileStoreScope);
+    /** Create a session-scoped FileStore (relative paths → sessionDir) */
+    get session(): SessionFileStore;
+    /** Create a workspace-scoped FileStore (relative paths → workspaceDir), or undefined if no workspace */
+    get workspace(): SessionFileStore | undefined;
+    write(path: string, content: string | Buffer): Promise<Result<{
+        path: string;
+    }, string>>;
+    read(path: string): Promise<Result<string, string>>;
+    read(path: string, opts: {
+        type: 'buffer';
+    }): Promise<Result<Buffer, string>>;
+    exists(path: string): Promise<Result<boolean, string>>;
+    stat(path: string): Promise<Result<FileEntry, string>>;
+    list(path: string): Promise<Result<FileEntry[], string>>;
+    remove(path: string): Promise<Result<void, string>>;
+    getRoots(): {
+        session: string;
+        workspace?: string;
+    };
+    realPath(path: string): Result<string, string>;
+    scoped(basePath: string): SessionFileStore;
+    private resolvePath;
+    /** Resolve a relative path within a root directory */
+    private resolveRelativePath;
+    /** Resolve an agent-visible path to real filesystem path (handles sandboxed virtual paths) */
+    private resolveAgentPath;
+    private resolveSandboxedPath;
+    private resolveNonSandboxedPath;
+    private validateWithinRoot;
+    private toAgentPath;
+}
+export {};
+//# sourceMappingURL=file-store.d.ts.map

package/dist/core/file-store/file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["../../../src/core/file-store/file-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAMnD,KAAK,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAA;AAEtD,qBAAa,gBAAiB,YAAW,SAAS;IAEhD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAJL,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,SAAS,EAAE,OAAO,EAClB,EAAE,EAAE,UAAU,EACd,KAAK,GAAE,cAAuB;IAGhD,sEAAsE;IACtE,IAAI,OAAO,IAAI,gBAAgB,CAE9B;IAED,wGAAwG;IACxG,IAAI,SAAS,IAAI,gBAAgB,GAAG,SAAS,CAG5C;IAEK,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,MAAM,CAAC,CAAC;IAUxF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAe7E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAOtD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAgBtD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;IA6BxD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAYzD,QAAQ,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAanD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAI9C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAa1C,OAAO,CAAC,WAAW;IAYnB,sDAAsD;IACtD,OAAO,CAAC,mBAAmB;IAY3B,8FAA8F;IAC9F,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,uBAAuB;IAgB/B,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,WAAW;CAsBnB"}

package/dist/core/file-store/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * FileStore interface for centralized file operations.
+ * All paths are relative to the store's root directory.
+ * Used by tools, lib functions, and the LLM provider.
+ */
+import type { Result } from '../../lib/utils/result.js';
+export interface FileStat {
+    size: number;
+    isFile: boolean;
+    isDirectory: boolean;
+}
+export interface FileEntry {
+    name: string;
+    type: 'file' | 'directory' | 'symlink' | 'other';
+    size?: number;
+}
+export interface FileStore {
+    /** Write text or binary content. Auto-creates parent dirs. Returns the agent-visible path. */
+    write(path: string, content: string | Buffer): Promise<Result<{
+        path: string;
+    }, string>>;
+    /** Read file as UTF-8 text. */
+    read(path: string): Promise<Result<string, string>>;
+    /** Read file as Buffer. */
+    read(path: string, opts: {
+        type: 'buffer';
+    }): Promise<Result<Buffer, string>>;
+    /** Check if a file exists. */
+    exists(path: string): Promise<Result<boolean, string>>;
+    /** Get file/directory stats. */
+    stat(path: string): Promise<Result<FileEntry, string>>;
+    /** List entries in a directory with type and size info. */
+    list(path: string, options?: {
+        maxDepth?: number;
+        gitIgnore?: boolean;
+    }): Promise<Result<FileEntry[], string>>;
+    /** Remove a file. */
+    remove(path: string): Promise<Result<void, string>>;
+    /** Resolve an agent-visible path to real filesystem path. */
+    realPath(path: string): Result<string, string>;
+    /** Get the agent-visible root paths (virtual when sandboxed, real otherwise) */
+    getRoots(): {
+        session: string;
+        workspace?: string;
+    };
+    scoped(subPath: string): FileStore;
+    session: FileStore;
+    workspace?: FileStore;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/file-store/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/file-store/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAEnD,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAA;IAChD,IAAI,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,SAAS;IACzB,8FAA8F;IAC9F,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,MAAM,CAAC,CAAC,CAAA;IAExF,+BAA+B;IAC/B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACnD,2BAA2B;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAE7E,8BAA8B;IAC9B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;IAEtD,gCAAgC;IAChC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA;IAEtD,2DAA2D;IAC3D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC,CAAA;IAE9G,qBAAqB;IACrB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;IAEnD,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,gFAAgF;IAChF,QAAQ,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAEnD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAElC,OAAO,EAAE,SAAS,CAAA;IAClB,SAAS,CAAC,EAAE,SAAS,CAAA;CACrB"}

package/dist/core/image/image-processor.d.ts

@@ -0,0 +1,15 @@
+import type { FileStore } from '../../core/file-store/types.js';
+import type { ToolResultContent } from '../../core/llm/llm-log-types.js';
+import type { FileSystem } from '../../platform/fs.js';
+import type { ImageProcessor, ImageProcessorConfig, ImageResizer } from './types.js';
+export declare class DefaultImageProcessor implements ImageProcessor {
+    private resizer;
+    private fs;
+    private config;
+    constructor(resizer: ImageResizer, fs: FileSystem, config?: ImageProcessorConfig);
+    resolveContent(content: ToolResultContent, fileStore?: FileStore): Promise<ToolResultContent>;
+    private resolveDirect;
+    private resolveViaStore;
+    private readAndEncode;
+}
+//# sourceMappingURL=image-processor.d.ts.map

package/dist/core/image/image-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-processor.d.ts","sourceRoot":"","sources":["../../../src/core/image/image-processor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAA0B,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAE5F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAMpF,qBAAa,qBAAsB,YAAW,cAAc;IAE1D,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,MAAM;gBAFN,OAAO,EAAE,YAAY,EACrB,EAAE,EAAE,UAAU,EACd,MAAM,GAAE,oBAA4D;IAGvE,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAiCrF,aAAa;YAqBb,eAAe;YAsBf,aAAa;CAgC3B"}

package/dist/core/image/image-processor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=image-processor.test.d.ts.map

package/dist/core/image/image-processor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-processor.test.d.ts","sourceRoot":"","sources":["../../../src/core/image/image-processor.test.ts"],"names":[],"mappings":""}

package/dist/core/image/index.d.ts

@@ -0,0 +1,5 @@
+export { DefaultImageProcessor } from './image-processor.js';
+export { NoopImageResizer } from './noop-resizer.js';
+export type { ImageProcessor, ImageProcessorConfig, ImageResizeOptions, ImageResizer, ImageResizeResult } from './types.js';
+export { VipsImageResizer } from './vips-resizer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/image/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/image/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC3H,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/core/image/noop-resizer.d.ts

@@ -0,0 +1,5 @@
+import type { ImageResizeOptions, ImageResizer, ImageResizeResult } from './types.js';
+export declare class NoopImageResizer implements ImageResizer {
+    resize(filePath: string, mimeType: string, _options?: ImageResizeOptions): Promise<ImageResizeResult>;
+}
+//# sourceMappingURL=noop-resizer.d.ts.map

package/dist/core/image/noop-resizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-resizer.d.ts","sourceRoot":"","sources":["../../../src/core/image/noop-resizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAErF,qBAAa,gBAAiB,YAAW,YAAY;IAC9C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAG3G"}

package/dist/core/image/types.d.ts

@@ -0,0 +1,20 @@
+import type { FileStore } from '../../core/file-store/types.js';
+import type { ToolResultContent } from '../../core/llm/llm-log-types.js';
+export interface ImageResizeOptions {
+    maxFileSizeBytes?: number;
+}
+export interface ImageResizer {
+    resize(filePath: string, mimeType: string, options?: ImageResizeOptions): Promise<ImageResizeResult>;
+}
+export interface ImageResizeResult {
+    path: string;
+    mimeType: string;
+    tempFile?: string;
+}
+export interface ImageProcessorConfig {
+    maxFileSizeBytes: number;
+}
+export interface ImageProcessor {
+    resolveContent(content: ToolResultContent, fileStore?: FileStore): Promise<ToolResultContent>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/image/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/image/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAEpE,MAAM,WAAW,kBAAkB;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,YAAY;IAC5B,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACpG;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,oBAAoB;IACpC,gBAAgB,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC9B,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;CAC7F"}

package/dist/core/image/vips-resizer.d.ts

@@ -0,0 +1,21 @@
+import type { FileSystem } from '../../platform/fs.js';
+import type { ProcessRunner } from '../../platform/process.js';
+import type { ImageResizeOptions, ImageResizer, ImageResizeResult } from './types.js';
+export interface VipsImageResizerOptions {
+    fs: FileSystem;
+    process: ProcessRunner;
+    tmpDir: string;
+    maxDimension?: number;
+}
+export declare class VipsImageResizer implements ImageResizer {
+    private readonly fs;
+    private readonly process;
+    private readonly tmpDir;
+    private readonly maxDimension;
+    constructor(options: VipsImageResizerOptions);
+    resize(filePath: string, mimeType: string, options?: ImageResizeOptions): Promise<ImageResizeResult>;
+    private getImageDimensions;
+    private dimensionResize;
+    private compressToFit;
+}
+//# sourceMappingURL=vips-resizer.d.ts.map

package/dist/core/image/vips-resizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vips-resizer.d.ts","sourceRoot":"","sources":["../../../src/core/image/vips-resizer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAErF,MAAM,WAAW,uBAAuB;IACvC,EAAE,EAAE,UAAU,CAAA;IACd,OAAO,EAAE,aAAa,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,qBAAa,gBAAiB,YAAW,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAY;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;gBAEzB,OAAO,EAAE,uBAAuB;IAOtC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAwB5F,kBAAkB;YAUlB,eAAe;YAuBf,aAAa;CAyC3B"}

package/dist/core/image/vips-resizer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vips-resizer.test.d.ts.map

package/dist/core/image/vips-resizer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vips-resizer.test.d.ts","sourceRoot":"","sources":["../../../src/core/image/vips-resizer.test.ts"],"names":[],"mappings":""}

package/dist/core/llm/anthropic.d.ts

@@ -0,0 +1,51 @@
+import type { ImageProcessor } from '../../core/image/types.js';
+import type { Logger } from '../../lib/logger/logger.js';
+import type { Result } from '../../lib/utils/result.js';
+import type { InferenceContext, InferenceRequest, InferenceResponse, LLMError, ProviderHttpRequest, RawInferenceRequest } from './provider.js';
+import type { RoutableLLMProvider } from './routing-provider.js';
+export interface AnthropicConfig {
+    apiKey: string;
+    defaultModel?: string;
+    timeout?: number;
+    logger?: Logger;
+    imageProcessor: ImageProcessor;
+    /** When set, enables extended thinking with this token budget. Min 1024. */
+    thinkingBudget?: number;
+    /** Custom fetch function (for testing/caching). Defaults to globalThis.fetch. */
+    fetch?: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+}
+export declare class AnthropicProvider implements RoutableLLMProvider {
+    readonly name = "anthropic";
+    private apiKey;
+    private defaultModel;
+    private logger?;
+    private imageProcessor;
+    private thinkingBudget?;
+    private timeout;
+    private fetchFn;
+    constructor(config: AnthropicConfig);
+    /**
+     * Returns true for models with `anthropic/` prefix or starting with `claude-`.
+     */
+    canHandle(model: string): boolean;
+    /**
+     * Normalizes model ID for the Anthropic API:
+     * 1. Strips `anthropic/` prefix if present
+     * 2. Converts version dots to dashes (OpenRouter `claude-opus-4.6` → Anthropic `claude-opus-4-6`)
+     */
+    normalizeModel(model: string): string;
+    inference(request: InferenceRequest, context?: InferenceContext): Promise<Result<InferenceResponse, LLMError>>;
+    buildHttpRequest(request: RawInferenceRequest, context?: InferenceContext): Promise<ProviderHttpRequest>;
+    private mapMessage;
+    private mapMessageContent;
+    private mapToolResultContent;
+    private mapUserContentItems;
+    private mapImageContent;
+    private mergeConsecutiveMessages;
+    private normalizeContent;
+    private mapStopReason;
+    private calculateCost;
+    private mapHttpError;
+    private mapError;
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/core/llm/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/core/llm/anthropic.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAG3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,KAAK,EACX,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EAIR,mBAAmB,EACnB,mBAAmB,EAEnB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAMhE,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,cAAc,CAAA;IAC9B,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iFAAiF;IACjF,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAChF;AAsJD,qBAAa,iBAAkB,YAAW,mBAAmB;IAC5D,QAAQ,CAAC,IAAI,eAAc;IAC3B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,cAAc,CAAC,CAAQ;IAC/B,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAA0E;gBAE7E,MAAM,EAAE,eAAe;IAUnC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAKjC;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAS/B,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IA0F9G,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC;YAgDhG,UAAU;YAQV,iBAAiB;IA+C/B,OAAO,CAAC,oBAAoB;IAmB5B,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,wBAAwB;IAkBhC,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,YAAY;IA8BpB,OAAO,CAAC,QAAQ;CAShB"}

package/dist/core/llm/anthropic.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=anthropic.test.d.ts.map

package/dist/core/llm/anthropic.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.test.d.ts","sourceRoot":"","sources":["../../../src/core/llm/anthropic.test.ts"],"names":[],"mappings":""}

package/dist/core/llm/cache-breakpoints.d.ts

@@ -0,0 +1,17 @@
+import type { LLMMessage } from '../../core/agents/state.js';
+/**
+ * Mark the prompt cache breakpoint on a message list.
+ *
+ * Flag-based: the target message gets a `cacheControl` marker. Providers that
+ * support ephemeral prompt caching (anthropic, openrouter) react to the flag
+ * during `buildHttpRequest` and place `cache_control: { type: 'ephemeral' }`
+ * on the LAST content block of the mapped message — regardless of block type
+ * (text / tool_use / tool_result / image). This matches the API semantics
+ * "cache the prefix up to and including this block".
+ *
+ * Target index is `messages.length - 1 - uncachedSuffixCount`. The suffix is
+ * the tail of messages that must remain fresh (e.g. ephemeral session context
+ * rebuilt each inference).
+ */
+export declare function applyCacheBreakpoint(messages: LLMMessage[], uncachedSuffixCount: number): LLMMessage[];
+//# sourceMappingURL=cache-breakpoints.d.ts.map

package/dist/core/llm/cache-breakpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-breakpoints.d.ts","sourceRoot":"","sources":["../../../src/core/llm/cache-breakpoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAExD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,mBAAmB,EAAE,MAAM,GAAG,UAAU,EAAE,CAqBtG"}

package/dist/core/llm/cache-live.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Live cache verification tests for Anthropic + OpenRouter providers.
+ *
+ * Opt-in: run with `LIVE_TESTS=1 ANTHROPIC_API_KEY=… OPENROUTER_API_KEY=…`.
+ * Skipped otherwise so the default `bun test` run stays hermetic.
+ *
+ * These tests bypass snapshot-fetch entirely (use real `globalThis.fetch`) so
+ * two sequential identical calls actually land on the live API — proving that
+ * the new message-level `cacheControl` flag → last-block placement is both
+ * accepted and honored as a prompt cache checkpoint.
+ *
+ * The system prompt is padded to comfortably exceed Anthropic's 1024-token
+ * minimum cacheable prefix for Haiku / Sonnet.
+ */
+export {};
+//# sourceMappingURL=cache-live.test.d.ts.map

package/dist/core/llm/cache-live.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-live.test.d.ts","sourceRoot":"","sources":["../../../src/core/llm/cache-live.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/core/llm/index.d.ts

@@ -0,0 +1,16 @@
+export { AnthropicProvider } from './anthropic.js';
+export type { AnthropicConfig } from './anthropic.js';
+export { OpenRouterProvider } from './openrouter.js';
+export type { OpenRouterConfig } from './openrouter.js';
+export { RoutingLLMProvider } from './routing-provider.js';
+export type { RoutableLLMProvider } from './routing-provider.js';
+export { LoggingLLMProvider } from './logging-provider.js';
+export { MockLLMProvider, RequestMatchers } from './mock.js';
+export type { MockInferenceHandler } from './mock.js';
+export { LLMLogger } from './logger.js';
+export type { LLMLoggerConfig } from './logger.js';
+export { applyMiddleware, useProvider, withAnthropic, withMaxTokens, withOpenRouter, withTemperature } from './middleware.js';
+export type { InferenceNext, LLMMiddleware } from './middleware.js';
+export { composeStrippers, createSnapshotLLMMiddleware, normalizeStripRuntime, normalizeStripUuids, normalizeWith, stripEphemeralPorts, stripUuids, } from './snapshot-middleware.js';
+export type { SnapshotLLMMiddlewareOptions } from './snapshot-middleware.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/llm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/llm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAErD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC1D,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE1D,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC5D,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAErD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAC7H,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEnE,OAAO,EACN,gBAAgB,EAChB,2BAA2B,EAC3B,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,UAAU,GACV,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/core/llm/llm-log-types.d.ts

@@ -0,0 +1,148 @@
+import type { AgentId } from '../../core/agents/schema.js';
+import type { AnthropicRequestOptions, OpenRouterRequestOptions } from '../../core/llm/provider.js';
+import type { LLMCallId } from '../../core/llm/schema.js';
+import type { SessionId } from '../../core/sessions/schema.js';
+import type { ToolCallId } from '../../core/tools/schema.js';
+import type { LLMToolCall } from './state.js';
+export type ChatMessageContentItemText = {
+    type: 'text';
+    text: string;
+    cacheControl?: {
+        type: 'ephemeral';
+    };
+};
+export type ChatMessageContentItemImageDetail = 'auto' | 'low' | 'high';
+export type ChatMessageContentItemImage = {
+    type: 'image_url';
+    imageUrl: {
+        url: string;
+        detail?: ChatMessageContentItemImageDetail;
+    };
+};
+/**
+ * Union of all content item types.
+ * Start with text and image, extend with audio/video as needed.
+ */
+export type ChatMessageContentItem = ChatMessageContentItemText | ChatMessageContentItemImage;
+/**
+ * Tool result content - string or array of content items.
+ * Matches OpenRouter's ToolResponseMessageContent type.
+ */
+export type ToolResultContent = string | ChatMessageContentItem[];
+/**
+ * Helper to normalize content to string (for display/logging).
+ */
+export declare const contentToString: (content: ToolResultContent) => string;
+/**
+ * Represents an LLM message in the request.
+ */
+export type LLMCallMessage = {
+    role: 'user' | 'assistant' | 'tool' | 'system';
+    content: string | ChatMessageContentItem[];
+    toolCalls?: LLMToolCall[];
+    toolCallId?: ToolCallId;
+    /** Assistant reasoning (for models that support it) */
+    reasoning?: string;
+    /** Prompt cache breakpoint marker (ephemeral cache checkpoint after this message) */
+    cacheControl?: {
+        type: 'ephemeral';
+    };
+};
+/**
+ * Tool definition for logging (includes full JSON schema).
+ */
+export type LLMCallToolDefinition = {
+    name: string;
+    description: string;
+    /** JSON Schema for tool parameters */
+    parameters?: Record<string, unknown>;
+};
+/**
+ * Request data stored in the log entry.
+ */
+export type LLMCallRequest = {
+    model: string;
+    systemPrompt: string;
+    messages: LLMCallMessage[];
+    tools?: LLMCallToolDefinition[];
+    toolsCount: number;
+    maxTokens?: number;
+    temperature?: number;
+    /** Provider-specific options set by middleware */
+    providerOptions?: {
+        openrouter?: OpenRouterRequestOptions;
+        anthropic?: AnthropicRequestOptions;
+    };
+};
+/**
+ * Response data stored in the log entry.
+ */
+export type LLMCallResponse = {
+    content: string | null;
+    toolCalls: LLMToolCall[];
+    finishReason: 'stop' | 'tool_calls' | 'length' | 'error';
+    /** Assistant reasoning (for models that support extended thinking) */
+    reasoning?: string;
+};
+/**
+ * Extended metrics with detailed token breakdown.
+ */
+export type LLMCallMetrics = {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    /** Reasoning/thinking tokens (for models like o1, Claude with extended thinking) */
+    reasoningTokens?: number;
+    /** Cached prompt tokens (for providers with prompt caching) */
+    cachedTokens?: number;
+    /** Tokens written to prompt cache */
+    cacheWriteTokens?: number;
+    latencyMs: number;
+    /** Generation time (actual model inference time) */
+    generationTimeMs?: number;
+    model: string;
+    /** Provider name (e.g., "anthropic", "openai") */
+    provider?: string;
+    cost?: number;
+    /** Cache status */
+    cacheStatus?: 'hit' | 'miss' | 'none';
+};
+/**
+ * Error data stored in the log entry.
+ */
+export type LLMCallError = {
+    type: string;
+    message: string;
+    retryAfterMs?: number;
+    /** HTTP status code from the provider response */
+    statusCode?: number;
+    /** Raw HTTP response body from the provider */
+    responseBody?: string;
+};
+/**
+ * Complete LLM call log entry.
+ * Each entry represents a single LLM API call with full request/response details.
+ */
+export type LLMCallLogEntry = {
+    id: LLMCallId;
+    sessionId: SessionId;
+    agentId: AgentId;
+    createdAt: number;
+    completedAt?: number;
+    durationMs?: number;
+    status: 'running' | 'success' | 'error';
+    request: LLMCallRequest;
+    response?: LLMCallResponse;
+    metrics?: LLMCallMetrics;
+    error?: LLMCallError;
+    /** Provider-specific request ID (e.g., OpenRouter generation ID) */
+    providerRequestId?: string;
+};
+/**
+ * Response for listing LLM calls.
+ */
+export type GetLLMCallsResponse = {
+    calls: LLMCallLogEntry[];
+    total: number;
+};
+//# sourceMappingURL=llm-log-types.d.ts.map