@roj-ai/sdk 0.0.2

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

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

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

@@ -0,0 +1,74 @@
+/**
+ * LLM Request/Response Logger
+ *
+ * Logs LLM calls as individual JSON files for debugging and audit.
+ * Per spec.md 9.1: "Pro debugging a audit se bude logovat kompletní LLM komunikace"
+ *
+ * Calls are stored in the session folder: {dataPath}/sessions/{sessionId}/calls/
+ */
+import type { AgentId } from '../../core/agents/schema.js';
+import { LLMCallId } from '../../core/llm/schema.js';
+import type { SessionId } from '../../core/sessions/schema.js';
+import type { FileSystem } from '../../platform/fs.js';
+import type { LLMCallLogEntry } from './llm-log-types.js';
+import type { InferenceRequest, InferenceResponse, LLMError } from './provider.js';
+/**
+ * Configuration for LLM logger
+ */
+export interface LLMLoggerConfig {
+    /** Base data path (same as event store dataPath) */
+    basePath: string;
+    enabled: boolean;
+    fs: FileSystem;
+}
+/**
+ * Logger for LLM requests and responses.
+ * Stores individual JSON files per LLM call in the session folder.
+ */
+export declare class LLMLogger {
+    private config;
+    private dirCache;
+    private readonly fs;
+    constructor(config: LLMLoggerConfig);
+    /**
+     * Check if logging is enabled.
+     */
+    isEnabled(): boolean;
+    /**
+     * Ensure the calls directory exists for a session.
+     * Calls are stored in {basePath}/sessions/{sessionId}/calls/
+     */
+    private ensureCallsDir;
+    /**
+     * Get the path to an individual call file.
+     */
+    private getCallFilePath;
+    /**
+     * Create a new LLM call entry when a request starts.
+     * Returns the generated call ID.
+     */
+    createCall(sessionId: SessionId, agentId: AgentId, request: InferenceRequest): Promise<LLMCallId>;
+    /**
+     * Update a call entry with a successful response.
+     */
+    completeCall(sessionId: SessionId, callId: LLMCallId, response: InferenceResponse, durationMs: number): Promise<void>;
+    /**
+     * Update a call entry with an error.
+     */
+    failCall(sessionId: SessionId, callId: LLMCallId, error: LLMError, durationMs: number): Promise<void>;
+    /**
+     * Get a single LLM call entry.
+     */
+    getCall(sessionId: SessionId, callId: LLMCallId): Promise<LLMCallLogEntry | null>;
+    /**
+     * List all LLM calls for a session.
+     */
+    listCalls(sessionId: SessionId, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        calls: LLMCallLogEntry[];
+        total: number;
+    }>;
+}
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/llm/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAqB,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAgB,eAAe,EAAmE,MAAM,oBAAoB,CAAA;AACxI,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAMlF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,EAAE,EAAE,UAAU,CAAA;CACd;AAMD;;;GAGG;AACH,qBAAa,SAAS;IAIT,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAY;gBAEX,MAAM,EAAE,eAAe;IAI3C;;OAEG;IACH,SAAS,IAAI,OAAO;IAQpB;;;OAGG;YACW,cAAc;IAS5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;;OAGG;IACG,UAAU,CACf,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,gBAAgB,GACvB,OAAO,CAAC,SAAS,CAAC;IAsErB;;OAEG;IACG,YAAY,CACjB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,iBAAiB,EAC3B,UAAU,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IA+ChB;;OAEG;IACG,QAAQ,CACb,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,QAAQ,EACf,UAAU,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IA4BhB;;OAEG;IACG,OAAO,CACZ,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,SAAS,GACf,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAWlC;;OAEG;IACG,SAAS,CACd,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC;QAAE,KAAK,EAAE,eAAe,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAmCvD"}

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

@@ -0,0 +1,7 @@
+/**
+ * Tests for LLM Logger
+ *
+ * Tests individual LLM call file storage in session folders.
+ */
+export {};
+//# sourceMappingURL=logger.test.d.ts.map

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

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

package/dist/core/llm/logging-provider.d.ts

@@ -0,0 +1,20 @@
+/**
+ * LoggingLLMProvider - Wrapper that adds logging to any LLM provider
+ */
+import type { Logger } from '../../lib/logger/logger.js';
+import type { Result } from '../../lib/utils/result.js';
+import type { LLMLogger } from './logger.js';
+import type { InferenceContext, InferenceRequest, InferenceResponse, LLMError, LLMProvider, ProviderHttpRequest, RawInferenceRequest } from './provider.js';
+/**
+ * Wraps an LLM provider to add request/response logging.
+ */
+export declare class LoggingLLMProvider implements LLMProvider {
+    private readonly provider;
+    private readonly logger;
+    private readonly runtimeLogger?;
+    readonly name: string;
+    constructor(provider: LLMProvider, logger: LLMLogger, runtimeLogger?: Logger | undefined);
+    inference(request: InferenceRequest, context?: InferenceContext): Promise<Result<InferenceResponse, LLMError>>;
+    buildHttpRequest(request: RawInferenceRequest, context?: InferenceContext): Promise<ProviderHttpRequest>;
+}
+//# sourceMappingURL=logging-provider.d.ts.map

package/dist/core/llm/logging-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-provider.d.ts","sourceRoot":"","sources":["../../../src/core/llm/logging-provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EACX,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,MAAM,eAAe,CAAA;AAEtB;;GAEG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IAIpD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IALhC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAGH,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,SAAS,EACjB,aAAa,CAAC,EAAE,MAAM,YAAA;IAKlC,SAAS,CACd,OAAO,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IA2BzC,gBAAgB,CACrB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC;CAM/B"}

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

@@ -0,0 +1,79 @@
+/**
+ * LLM Middleware
+ *
+ * Composable middleware chain for LLM inference requests.
+ * Middleware can modify requests, set provider-specific options,
+ * force a specific provider, or implement retry/fallback logic.
+ *
+ * Chain order: preset middleware → agent middleware → base provider (RoutingLLMProvider).
+ */
+import type { Result } from '../../lib/utils/result.js';
+import type { AnthropicRequestOptions, InferenceContext, InferenceRequest, InferenceResponse, LLMError, LLMProvider, OpenRouterRequestOptions } from './provider.js';
+/**
+ * Next function in the middleware chain.
+ * Call this to pass the (potentially modified) request to the next middleware or the base provider.
+ */
+export type InferenceNext = (request: InferenceRequest, context: InferenceContext) => Promise<Result<InferenceResponse, LLMError>>;
+/**
+ * LLM middleware function.
+ *
+ * Can:
+ * - Modify the request and call `next` (pass-through with modifications)
+ * - Call a provider directly from `context.providers` (terminal — bypasses routing)
+ * - Implement retry, fallback, or A/B logic around `next`
+ */
+export type LLMMiddleware = (request: InferenceRequest, context: InferenceContext, next: InferenceNext) => Promise<Result<InferenceResponse, LLMError>>;
+/**
+ * Wrap an LLMProvider with a middleware chain.
+ *
+ * Middleware is applied in order: first middleware in the array is outermost (runs first).
+ * The base provider sits at the end of the chain.
+ */
+export declare function applyMiddleware(provider: LLMProvider, middleware: LLMMiddleware[]): LLMProvider;
+/**
+ * Force a specific provider by name. Terminal — does NOT call `next`.
+ *
+ * The provider is resolved from `context.providers` at call time.
+ *
+ * @example
+ * ```ts
+ * // All agents in this preset use Anthropic directly:
+ * createPreset({
+ *   llmMiddleware: [useProvider('anthropic')],
+ *   orchestrator: { model: ModelId('claude-sonnet-4'), ... },
+ * })
+ * ```
+ */
+export declare function useProvider(name: string): LLMMiddleware;
+/**
+ * Set OpenRouter-specific request options.
+ *
+ * @example
+ * ```ts
+ * // Exclude Google providers:
+ * llmMiddleware: [withOpenRouter({ providers: { deny: ['Google'] } })]
+ *
+ * // Prefer specific providers:
+ * llmMiddleware: [withOpenRouter({ providers: { order: ['Anthropic', 'AWS Bedrock'] } })]
+ * ```
+ */
+export declare function withOpenRouter(opts: OpenRouterRequestOptions): LLMMiddleware;
+/**
+ * Set Anthropic-specific request options.
+ *
+ * @example
+ * ```ts
+ * // Enable extended thinking for this agent:
+ * llmMiddleware: [withAnthropic({ thinkingBudget: 50000 })]
+ * ```
+ */
+export declare function withAnthropic(opts: AnthropicRequestOptions): LLMMiddleware;
+/**
+ * Override max tokens for the request.
+ */
+export declare function withMaxTokens(maxTokens: number): LLMMiddleware;
+/**
+ * Override temperature for the request.
+ */
+export declare function withTemperature(temperature: number): LLMMiddleware;
+//# sourceMappingURL=middleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/core/llm/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EACX,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,wBAAwB,EACxB,MAAM,eAAe,CAAA;AAMtB;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAC3B,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,gBAAgB,KACrB,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC,CAAA;AAEjD;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,CAC3B,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,aAAa,KACf,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC,CAAA;AAMjD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,aAAa,EAAE,GACzB,WAAW,CAYb;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAWvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,wBAAwB,GAAG,aAAa,CAY5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,uBAAuB,GAAG,aAAa,CAY1E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAI9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAIlE"}

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

@@ -0,0 +1,79 @@
+import type { Result } from '../../lib/utils/result.js';
+import type { InferenceRequest, InferenceResponse, LLMError, LLMMetrics, LLMProvider } from './provider.js';
+/**
+ * Handler type pro mock inference
+ */
+export type MockInferenceHandler = (request: InferenceRequest) => InferenceResponse | Promise<InferenceResponse>;
+/**
+ * MockLLMProvider - callback-based mock pro testy
+ */
+export declare class MockLLMProvider implements LLMProvider {
+    readonly name = "mock";
+    private handler;
+    private callHistory;
+    constructor(handler: MockInferenceHandler);
+    inference(request: InferenceRequest): Promise<Result<InferenceResponse, LLMError>>;
+    private isLLMError;
+    /**
+     * Vrátí historii všech volání.
+     */
+    getCallHistory(): InferenceRequest[];
+    /**
+     * Vrátí počet volání.
+     */
+    getCallCount(): number;
+    /**
+     * Vymaže historii volání.
+     */
+    clearHistory(): void;
+    /**
+     * Vrátí poslední request.
+     */
+    getLastRequest(): InferenceRequest | undefined;
+    /**
+     * Vytvoří mock s fixní response.
+     */
+    static withFixedResponse(response: Partial<InferenceResponse>): MockLLMProvider;
+    /**
+     * Vytvoří mock se sekvencí responses.
+     */
+    static withSequence(responses: Partial<InferenceResponse>[]): MockLLMProvider;
+    /**
+     * Vytvoří mock který vždy selže.
+     */
+    static withError(error: LLMError): MockLLMProvider;
+    /**
+     * Vytvoří mock který odpoví podle obsahu zpráv.
+     */
+    static withMatcher(matchers: Array<{
+        match: (request: InferenceRequest) => boolean;
+        response: Partial<InferenceResponse>;
+    }>, defaultResponse?: Partial<InferenceResponse>): MockLLMProvider;
+    /**
+     * Default metrics pro mock responses.
+     */
+    static defaultMetrics(): LLMMetrics;
+    /**
+     * Default metrics with cost for mock responses.
+     */
+    static defaultMetricsWithCost(cost: number): LLMMetrics;
+}
+export declare const RequestMatchers: {
+    /**
+     * Match pokud poslední message obsahuje text.
+     */
+    lastMessageContains: (text: string) => (request: InferenceRequest) => boolean;
+    /**
+     * Match pokud system prompt obsahuje text.
+     */
+    systemPromptContains: (text: string) => (request: InferenceRequest) => boolean;
+    /**
+     * Match pokud je k dispozici určitý tool.
+     */
+    hasTool: (toolName: string) => (request: InferenceRequest) => boolean;
+    /**
+     * Match vždy.
+     */
+    always: () => (request: InferenceRequest) => boolean;
+};
+//# sourceMappingURL=mock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/core/llm/mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAM3G;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAClC,OAAO,EAAE,gBAAgB,KACrB,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;AAMnD;;GAEG;AACH,qBAAa,eAAgB,YAAW,WAAW;IAClD,QAAQ,CAAC,IAAI,UAAS;IACtB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,WAAW,CAAyB;gBAEhC,OAAO,EAAE,oBAAoB;IAInC,SAAS,CACd,OAAO,EAAE,gBAAgB,GACvB,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAiB/C,OAAO,CAAC,UAAU;IAalB;;OAEG;IACH,cAAc,IAAI,gBAAgB,EAAE;IAIpC;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,cAAc,IAAI,gBAAgB,GAAG,SAAS;IAQ9C;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACvB,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,eAAe;IASlB;;OAEG;IACH,MAAM,CAAC,YAAY,CAClB,SAAS,EAAE,OAAO,CAAC,iBAAiB,CAAC,EAAE,GACrC,eAAe;IAgBlB;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,eAAe;IAMlD;;OAEG;IACH,MAAM,CAAC,WAAW,CACjB,QAAQ,EAAE,KAAK,CAAC;QACf,KAAK,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAA;QAC7C,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;KACpC,CAAC,EACF,eAAe,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAC1C,eAAe;IA0BlB;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,UAAU;IAUnC;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;CAMvD;AAMD,eAAO,MAAM,eAAe;IAC3B;;OAEG;gCACyB,MAAM,MAAM,SAAS,gBAAgB,KAAG,OAAO;IAS3E;;OAEG;iCAC0B,MAAM,MAAM,SAAS,gBAAgB,KAAG,OAAO;IAI5E;;OAEG;wBACiB,MAAM,MAAM,SAAS,gBAAgB,KAAG,OAAO;IAInE;;OAEG;kBACS,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO;CAClD,CAAA"}

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

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

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

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

package/dist/core/llm/openrouter-mapping.test.d.ts

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

package/dist/core/llm/openrouter-mapping.test.d.ts.map

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

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

@@ -0,0 +1,37 @@
+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, LLMProvider, ProviderHttpRequest, RawInferenceRequest } from './provider.js';
+export interface OpenRouterConfig {
+    apiKey: string;
+    defaultModel?: string;
+    timeout?: number;
+    logger?: Logger;
+    imageProcessor: ImageProcessor;
+    /** Custom fetch function (for testing/caching). Defaults to globalThis.fetch. */
+    fetch?: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+}
+export declare class OpenRouterProvider implements LLMProvider {
+    readonly name = "openrouter";
+    private apiKey;
+    private defaultModel;
+    private logger?;
+    private imageProcessor;
+    private timeout;
+    private fetchFn;
+    constructor(config: OpenRouterConfig);
+    inference(request: InferenceRequest, context?: InferenceContext): Promise<Result<InferenceResponse, LLMError>>;
+    buildHttpRequest(request: RawInferenceRequest, context?: InferenceContext): Promise<ProviderHttpRequest>;
+    private mapMessage;
+    private mapMessageContent;
+    /**
+     * Map internal ChatMessageContentItem[] (camelCase imageUrl) to OpenRouter format (snake_case image_url).
+     */
+    private mapContentToOpenRouter;
+    private extractContent;
+    private parseToolArguments;
+    private mapFinishReason;
+    private mapHttpError;
+    private mapError;
+}
+//# sourceMappingURL=openrouter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../../../src/core/llm/openrouter.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,EAGR,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,MAAM,eAAe,CAAA;AAMtB,MAAM,WAAW,gBAAgB;IAChC,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,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;AAgID,qBAAa,kBAAmB,YAAW,WAAW;IACrD,QAAQ,CAAC,IAAI,gBAAe;IAC5B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAA0E;gBAE7E,MAAM,EAAE,gBAAgB;IAS9B,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAuF9G,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC;YAwDhG,UAAU;YAQV,iBAAiB;IA0C/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,QAAQ;CAShB"}

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

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

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

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

package/dist/core/llm/provider-integration.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Integration tests for LLM providers against real APIs.
+ *
+ * Uses snapshot-caching fetch: first run hits the real API and saves the
+ * request+response; subsequent runs with the same request use the cache.
+ *
+ * Env vars: ANTHROPIC_API_KEY, OPENROUTER_API_KEY
+ * When snapshots exist, tests run without API keys (using cached responses).
+ * API keys are only needed to record new snapshots.
+ */
+export {};
+//# sourceMappingURL=provider-integration.test.d.ts.map

package/dist/core/llm/provider-integration.test.d.ts.map

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

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

@@ -0,0 +1,175 @@
+import type { AssistantLLMMessage, LLMMessage, SystemLLMMessage, ToolCall, ToolLLMMessage, UserLLMMessage } from '../../core/agents/state.js';
+import type { FileStore } from '../../core/file-store/types.js';
+import type { ToolResultContent } from '../../core/llm/llm-log-types.js';
+import type { ToolDefinition } from '../../core/tools/definition.js';
+import type { ToolCallId } from '../../core/tools/schema.js';
+import type { Result } from '../../lib/utils/result.js';
+import { ModelId } from './schema';
+export type { AssistantLLMMessage, LLMMessage, SystemLLMMessage, ToolCall, ToolLLMMessage, UserLLMMessage };
+/**
+ * Raw tool spec without Zod dependency (for buildHttpRequest / curl export).
+ */
+export interface RawToolSpec {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+/**
+ * OpenRouter-specific request options.
+ * Set via `withOpenRouter()` middleware.
+ *
+ * @see https://openrouter.ai/docs/api-reference/overview
+ */
+export interface OpenRouterRequestOptions {
+    /** Provider routing preferences */
+    providers?: {
+        /** Preferred provider ordering */
+        order?: string[];
+        /** Only allow these providers */
+        allow?: string[];
+        /** Exclude these providers */
+        deny?: string[];
+        /** Allowed quantizations (e.g. "bf16", "int8") */
+        quantizations?: string[];
+    };
+    /** Routing strategy */
+    route?: 'fallback';
+    /** Model transforms */
+    transforms?: string[];
+    /** OpenRouter saved preset ID */
+    preset?: string;
+}
+/**
+ * Anthropic-specific request options.
+ * Set via `withAnthropic()` middleware.
+ */
+export interface AnthropicRequestOptions {
+    /** Extended thinking token budget. Min 1024. Overrides server-level default. */
+    thinkingBudget?: number;
+}
+/**
+ * Request pro LLM inference
+ */
+export interface InferenceRequest {
+    model: ModelId;
+    systemPrompt: string;
+    messages: LLMMessage[];
+    tools?: ToolDefinition<any>[];
+    maxTokens?: number;
+    temperature?: number;
+    /** Stop sequences - LLM will stop generating when any of these are encountered */
+    stopSequences?: string[];
+    /** OpenRouter-specific options, set by middleware */
+    openrouter?: OpenRouterRequestOptions;
+    /** Anthropic-specific options, set by middleware */
+    anthropic?: AnthropicRequestOptions;
+}
+/**
+ * Raw inference request — uses plain JSON schemas instead of ToolDefinition.
+ * Used by buildHttpRequest (and curl export from stored log entries).
+ */
+export interface RawInferenceRequest {
+    model: ModelId;
+    systemPrompt: string;
+    messages: LLMMessage[];
+    tools?: RawToolSpec[];
+    maxTokens?: number;
+    temperature?: number;
+    stopSequences?: string[];
+    /** OpenRouter-specific options, set by middleware */
+    openrouter?: OpenRouterRequestOptions;
+    /** Anthropic-specific options, set by middleware */
+    anthropic?: AnthropicRequestOptions;
+}
+/**
+ * Context for inference (for logging and call tracking).
+ */
+export interface InferenceContext {
+    sessionId: string;
+    agentId: string;
+    /** Callback invoked when an LLM call entry is created, providing the call ID */
+    onLLMCallCreated?: (callId: string) => void;
+    /** Signal to abort the inference request */
+    signal?: AbortSignal;
+    /** FileStore for resolving file:// URLs in message content */
+    fileStore: FileStore;
+    /** Named provider instances, available for middleware routing via useProvider() */
+    providers?: ReadonlyMap<string, LLMProvider>;
+}
+/**
+ * Raw HTTP request as it would be sent to the provider API (without auth).
+ */
+export interface ProviderHttpRequest {
+    url: string;
+    method: 'POST';
+    headers: Record<string, string>;
+    body: unknown;
+}
+/**
+ * Response z LLM inference
+ */
+export interface InferenceResponse {
+    content: string | null;
+    toolCalls: ToolCall[];
+    finishReason: 'stop' | 'tool_calls' | 'length' | 'error';
+    metrics: LLMMetrics;
+    /** Provider-specific request ID (e.g., OpenRouter generation ID for fetching stats) */
+    providerRequestId?: string;
+    /** Extended thinking / reasoning content (for models that support it) */
+    reasoning?: string;
+}
+/**
+ * Metriky z LLM volání
+ */
+export interface LLMMetrics {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    latencyMs: number;
+    model: string;
+    /** Provider name (e.g. "anthropic", "openrouter") */
+    provider?: string;
+    cost?: number;
+    /** Tokens served from prompt cache */
+    cachedTokens?: number;
+    /** Tokens written to prompt cache */
+    cacheWriteTokens?: number;
+    /** Reasoning/thinking tokens */
+    reasoningTokens?: number;
+}
+/**
+ * LLM error types
+ */
+export interface LLMError {
+    type: 'rate_limit' | 'invalid_request' | 'context_length' | 'server_error' | 'network_error' | 'timeout' | 'aborted';
+    message: string;
+    retryAfterMs?: number;
+    /** HTTP status code from the provider response */
+    statusCode?: number;
+    /** Raw HTTP response body from the provider */
+    responseBody?: string;
+    cause?: unknown;
+}
+/**
+ * LLMProvider interface
+ */
+export interface LLMProvider {
+    /**
+     * Provede inference a vrátí response.
+     */
+    inference(request: InferenceRequest, context?: InferenceContext): Promise<Result<InferenceResponse, LLMError>>;
+    /**
+     * Build the raw HTTP request that would be sent to the provider API.
+     * Returns URL, headers (without auth), and body with resolved images.
+     * Used for curl export from debug UI.
+     */
+    buildHttpRequest?(request: RawInferenceRequest, context?: InferenceContext): Promise<ProviderHttpRequest>;
+    readonly name: string;
+}
+export declare const LLMMessageFactory: {
+    user: (content: string) => UserLLMMessage;
+    assistant: (content: string, toolCalls?: ToolCall[]) => AssistantLLMMessage;
+    toolResult: (toolCallId: ToolCallId, content: ToolResultContent) => ToolLLMMessage;
+    system: (content: string) => SystemLLMMessage;
+};
+//# sourceMappingURL=provider.d.ts.map

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

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

package/dist/core/llm/routing-provider.d.ts

@@ -0,0 +1,31 @@
+/**
+ * RoutingLLMProvider - Routes requests to the appropriate provider based on model ID.
+ *
+ * Each registered provider declares which models it can handle via `canHandle()`.
+ * The last registered provider acts as the fallback (typically OpenRouter).
+ */
+import type { Result } from '../../lib/utils/result.js';
+import type { InferenceContext, InferenceRequest, InferenceResponse, LLMError, LLMProvider, ProviderHttpRequest, RawInferenceRequest } from './provider.js';
+/**
+ * A provider that can declare which models it supports.
+ */
+export interface RoutableLLMProvider extends LLMProvider {
+    /** Returns true if this provider can handle the given model ID. */
+    canHandle(model: string): boolean;
+    /** Normalizes the model ID for this provider (e.g. strips vendor prefix). */
+    normalizeModel(model: string): string;
+}
+/**
+ * Routes inference requests to the appropriate provider based on model ID.
+ * Providers are checked in order; first match wins.
+ * If no provider matches, the fallback provider is used.
+ */
+export declare class RoutingLLMProvider implements LLMProvider {
+    private readonly providers;
+    private readonly fallback?;
+    readonly name = "routing";
+    constructor(providers: RoutableLLMProvider[], fallback?: LLMProvider | undefined);
+    inference(request: InferenceRequest, context?: InferenceContext): Promise<Result<InferenceResponse, LLMError>>;
+    buildHttpRequest(request: RawInferenceRequest, context?: InferenceContext): Promise<ProviderHttpRequest>;
+}
+//# sourceMappingURL=routing-provider.d.ts.map

package/dist/core/llm/routing-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-provider.d.ts","sourceRoot":"","sources":["../../../src/core/llm/routing-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,KAAK,EACX,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,MAAM,eAAe,CAAA;AAGtB;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACvD,mEAAmE;IACnE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IACjC,6EAA6E;IAC7E,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CACrC;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IAIpD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAJ3B,QAAQ,CAAC,IAAI,aAAY;gBAGP,SAAS,EAAE,mBAAmB,EAAE,EAChC,QAAQ,CAAC,EAAE,WAAW,YAAA;IAGlC,SAAS,CACd,OAAO,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAoBzC,gBAAgB,CACrB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC;CAgB/B"}

package/dist/core/llm/routing-provider.test.d.ts

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

package/dist/core/llm/routing-provider.test.d.ts.map

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

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

@@ -0,0 +1,24 @@
+/**
+ * LLM domain types and schemas
+ *
+ * Contains all types related to LLM:
+ * - Branded ID types and constructors (LLMCallId, ModelId)
+ * - LLM response types
+ * - Zod schemas for validation
+ */
+import z from 'zod/v4';
+/** LLMCallId schema - validates any string and brands as LLMCallId. */
+export declare const llmCallIdSchema: z.core.$ZodBranded<z.ZodString, "LLMCallId", "out">;
+/** Branded LLMCallId type */
+export type LLMCallId = z.infer<typeof llmCallIdSchema>;
+/** Constructor for LLMCallId */
+export declare const LLMCallId: (id: string) => LLMCallId;
+/** Generate a new LLMCallId (UUIDv7) */
+export declare const generateLLMCallId: () => LLMCallId;
+/** ModelId schema - validates any string and brands as ModelId. */
+export declare const modelIdSchema: z.core.$ZodBranded<z.ZodString, "ModelId", "out">;
+/** Branded ModelId type */
+export type ModelId = z.infer<typeof modelIdSchema>;
+/** Constructor for ModelId */
+export declare const ModelId: (id: string) => ModelId;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/core/llm/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,CAAC,MAAM,QAAQ,CAAA;AAOtB,uEAAuE;AACvE,eAAO,MAAM,eAAe,qDAAgC,CAAA;AAE5D,6BAA6B;AAC7B,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEvD,gCAAgC;AAChC,eAAO,MAAM,SAAS,GAAI,IAAI,MAAM,KAAG,SAA4B,CAAA;AAEnE,wCAAwC;AACxC,eAAO,MAAM,iBAAiB,QAAO,SAAgC,CAAA;AAUrE,mEAAmE;AACnE,eAAO,MAAM,aAAa,mDAA8B,CAAA;AAExD,2BAA2B;AAC3B,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEnD,8BAA8B;AAC9B,eAAO,MAAM,OAAO,GAAI,IAAI,MAAM,KAAG,OAAwB,CAAA"}