@clinebot/core 0.0.36 → 0.0.37

package/dist/llms/cline-recommended-models.d.ts

@@ -0,0 +1,20 @@
+import { ProviderSettingsManager } from "../services/storage/provider-settings-manager";
+export interface ClineRecommendedModel {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+}
+export interface ClineRecommendedModelsData {
+    recommended: ClineRecommendedModel[];
+    free: ClineRecommendedModel[];
+}
+export interface FetchClineRecommendedModelsOptions {
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+    providerSettingsManager?: Pick<ProviderSettingsManager, "getProviderSettings">;
+    timeoutMs?: number;
+}
+export declare const FALLBACK_CLINE_RECOMMENDED_MODELS: ClineRecommendedModelsData;
+export declare function fetchClineRecommendedModels(options?: FetchClineRecommendedModelsOptions): Promise<ClineRecommendedModelsData>;
+//# sourceMappingURL=cline-recommended-models.d.ts.map

package/dist/llms/cline-recommended-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cline-recommended-models.d.ts","sourceRoot":"","sources":["../../src/llms/cline-recommended-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AAExF,MAAM,WAAW,qBAAqB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IAC1C,WAAW,EAAE,qBAAqB,EAAE,CAAC;IACrC,IAAI,EAAE,qBAAqB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,kCAAkC;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,uBAAuB,CAAC,EAAE,IAAI,CAC7B,uBAAuB,EACvB,qBAAqB,CACrB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD,eAAO,MAAM,iCAAiC,EAAE,0BAyC/C,CAAC;AA8EF,wBAAsB,2BAA2B,CAChD,OAAO,GAAE,kCAAuC,GAC9C,OAAO,CAAC,0BAA0B,CAAC,CAkBrC"}

package/dist/llms/handler-factory.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Build a concrete `LlmsProviders.ApiHandler` from an `AgentConfig`.
+ *
+ * @see PLAN.md §3.1 — moved from `packages/agents/src/utils/config-helpers.ts` lines 15–55.
+ * @see PLAN.md §3.2.1 — `AgentConfig → AgentRuntimeConfig` mapping for
+ *                      the `model` field.
+ *
+ * Pure port. Core calls this once per session (and again on
+ * `updateConnection`) to produce the `AgentModel` adapter handed to
+ * `new AgentRuntime({ model, ... })`.
+ */
+import * as LlmsProviders from "@clinebot/llms";
+import type { AgentConfig, BasicLogger } from "@clinebot/shared";
+export declare function resolveKnownModelsFromConfig(config: AgentConfig): Record<string, LlmsProviders.ModelInfo> | undefined;
+export declare function createHandlerFromConfig(config: AgentConfig, logger: BasicLogger | undefined): LlmsProviders.ApiHandler;
+//# sourceMappingURL=handler-factory.d.ts.map

package/dist/llms/handler-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-factory.d.ts","sourceRoot":"","sources":["../../src/llms/handler-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,aAAa,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEjE,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,WAAW,GACjB,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,SAAS,CAYrD;AAED,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC7B,aAAa,CAAC,UAAU,CAqB1B"}

package/dist/llms/provider-defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-defaults.d.ts","sourceRoot":"","sources":["../../src/llms/provider-defaults.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,EACX,kBAAkB,EAClB,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,uBAAuB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,CAAC;IAChD,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC;IAC5B,QAAQ,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC;CACjC;AAkED,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAmBD,eAAO,MAAM,0BAA0B,gCAAgC,CAAC;AA0ZxE,wBAAsB,oBAAoB,CACzC,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,KAAK,GAAG,YAAY,CAAM,GAC1D,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CA0BpD;AAED,wBAAgB,2BAA2B,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAS9D;AAED,wBAAgB,8BAA8B,IAAI,IAAI,CAGrD;AAiBD,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CACP,CAAC;AAEnE,wBAAgB,iBAAiB,CAChC,UAAU,EAAE,MAAM,GAChB,gBAAgB,GAAG,SAAS,CAY9B;AAED,wBAAsB,qBAAqB,CAC1C,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,kBAAkB,EACjC,MAAM,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAiCvC"}
+{"version":3,"file":"provider-defaults.d.ts","sourceRoot":"","sources":["../../src/llms/provider-defaults.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,EACX,kBAAkB,EAClB,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,uBAAuB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,CAAC;IAChD,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC;IAC5B,QAAQ,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC;CACjC;AAkED,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAmBD,eAAO,MAAM,0BAA0B,gCAAgC,CAAC;AAwaxE,wBAAsB,oBAAoB,CACzC,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,KAAK,GAAG,YAAY,CAAM,GAC1D,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CA0BpD;AAED,wBAAgB,2BAA2B,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAS9D;AAED,wBAAgB,8BAA8B,IAAI,IAAI,CAGrD;AAiBD,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CACP,CAAC;AAEnE,wBAAgB,iBAAiB,CAChC,UAAU,EAAE,MAAM,GAChB,gBAAgB,GAAG,SAAS,CAY9B;AAED,wBAAsB,qBAAqB,CAC1C,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,kBAAkB,EACjC,MAAM,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAmCvC"}

package/dist/llms/provider-settings.d.ts

@@ -14,6 +14,27 @@ export declare const isBuiltInProviderId: typeof Llms.isBuiltInProviderId;
 export declare const normalizeProviderId: typeof Llms.normalizeProviderId;
 export type ProviderDefaultsConfig = ProviderDefaults;
 export declare const ProviderIdSchema: z.ZodString;
+export declare const ProviderProtocolSchema: z.ZodEnum<{
+    "openai-responses": "openai-responses";
+    anthropic: "anthropic";
+    gemini: "gemini";
+    "openai-chat": "openai-chat";
+    "openai-r1": "openai-r1";
+    "ai-sdk": "ai-sdk";
+}>;
+export declare const ProviderClientSchema: z.ZodEnum<{
+    custom: "custom";
+    anthropic: "anthropic";
+    gemini: "gemini";
+    "openai-r1": "openai-r1";
+    "ai-sdk": "ai-sdk";
+    "ai-sdk-community": "ai-sdk-community";
+    openai: "openai";
+    "openai-compatible": "openai-compatible";
+    bedrock: "bedrock";
+    fetch: "fetch";
+    vertex: "vertex";
+}>;
 export declare const AuthSettingsSchema: z.ZodObject<{
     apiKey: z.ZodOptional<z.ZodString>;
     accessToken: z.ZodOptional<z.ZodString>;
@@ -104,6 +125,28 @@ export declare const ProviderSettingsSchema: z.ZodObject<{
         accountId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     model: z.ZodOptional<z.ZodString>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        "openai-responses": "openai-responses";
+        anthropic: "anthropic";
+        gemini: "gemini";
+        "openai-chat": "openai-chat";
+        "openai-r1": "openai-r1";
+        "ai-sdk": "ai-sdk";
+    }>>;
+    client: z.ZodOptional<z.ZodEnum<{
+        custom: "custom";
+        anthropic: "anthropic";
+        gemini: "gemini";
+        "openai-r1": "openai-r1";
+        "ai-sdk": "ai-sdk";
+        "ai-sdk-community": "ai-sdk-community";
+        openai: "openai";
+        "openai-compatible": "openai-compatible";
+        bedrock: "bedrock";
+        fetch: "fetch";
+        vertex: "vertex";
+    }>>;
+    routingProviderId: z.ZodOptional<z.ZodString>;
     maxTokens: z.ZodOptional<z.ZodNumber>;
     contextWindow: z.ZodOptional<z.ZodNumber>;
     baseUrl: z.ZodOptional<z.ZodString>;
@@ -171,13 +214,13 @@ export declare const ProviderSettingsSchema: z.ZodObject<{
         international: "international";
     }>>;
     capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        reasoning: "reasoning";
         tools: "tools";
         streaming: "streaming";
         "prompt-cache": "prompt-cache";
-        reasoning: "reasoning";
         "computer-use": "computer-use";
-        vision: "vision";
         oauth: "oauth";
+        vision: "vision";
     }>>>;
     modelCatalog: z.ZodOptional<z.ZodObject<{
         loadLatestOnInit: z.ZodOptional<z.ZodBoolean>;

package/dist/llms/provider-settings.d.ts.map

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

package/dist/llms/runtime-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-registry.d.ts","sourceRoot":"","sources":["../../src/llms/runtime-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAgBjD,OAAO,KAAK,EACX,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,EACV,OAAO,EACP,4BAA4B,EAC5B,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,cAAe,YAAW,OAAO;IAC7C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAoC;gBAE5D,MAAM,EAAE,UAAU;IAI9B,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,UAAU;IAM9C,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAMxE,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI;IAyBpD,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,IAAI;IA+BlE,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAK9C,YAAY,IAAI,yBAAyB,EAAE;IAI3C,qBAAqB;IAIf,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAc9D,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAIvC,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIjD,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAI/D,OAAO,CAAC,WAAW;CAyBnB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEzD"}
+{"version":3,"file":"runtime-registry.d.ts","sourceRoot":"","sources":["../../src/llms/runtime-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAgBjD,OAAO,KAAK,EACX,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,EACV,OAAO,EACP,4BAA4B,EAC5B,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,cAAe,YAAW,OAAO;IAC7C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAoC;gBAE5D,MAAM,EAAE,UAAU;IAI9B,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,UAAU;IAM9C,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAMxE,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI;IAyBpD,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,IAAI;IAgClE,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAK9C,YAAY,IAAI,yBAAyB,EAAE;IAI3C,qBAAqB;IAIf,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAc9D,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAIvC,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIjD,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAI/D,OAAO,CAAC,WAAW;CAyBnB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEzD"}

package/dist/runtime/agent-config-adapter.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Cross-shape adapters between the **legacy host API** types
+ * (`ApiHandler`, `Tool`, `MessageWithMetadata`) and the **new
+ * runtime contract** types (`AgentModel`, `AgentTool`,
+ * `AgentMessage`) consumed by `AgentRuntime`.
+ *
+ * @see PLAN.md §3.1   — pure adapters; introduced alongside the core
+ *                       runtime port.
+ * @see PLAN.md §3.2.1 — consumed by `createAgentRuntimeConfig` to
+ *                       populate the `model`, `tools`, and
+ *                       `initialMessages` fields.
+ *
+ * These functions are intentionally **pure** (stateless adapters —
+ * they allocate fresh closures / arrays on every call and hold no
+ * internal state). Any state a consumer needs (e.g. an `AbortSignal`
+ * or a conversation id for `ToolContext.conversationId`) is injected
+ * per-call via the second-arg options object.
+ */
+import type { ApiHandler, ApiStreamChunk, ToolDefinition } from "@clinebot/llms";
+import type { AgentMessage, AgentModel, AgentModelEvent, AgentModelRequest, AgentTool, Message, MessageWithMetadata, Tool } from "@clinebot/shared";
+/**
+ * Context describing the model the `ApiHandler` talks to. This is
+ * used to populate `AgentMessage.modelInfo` on assistant messages
+ * emitted by the runtime. Matches PLAN.md §3.2.1 —
+ * `messageModelInfo = { id: modelId, provider: providerId, family:
+ * providerConfig?.family }`.
+ */
+export interface ApiHandlerAgentModelOptions {
+    /** Optional provider-family hint (e.g. `"claude-3.5"`). Attached as metadata. */
+    readonly family?: string;
+    /**
+     * Optional abort-signal factory. When provided, the returned
+     * `AgentModel.stream()` installs the signal on the handler via
+     * `handler.setAbortSignal()` before each call, and threads
+     * `request.signal` through for per-turn abort semantics.
+     */
+    readonly getAbortSignal?: () => AbortSignal | undefined;
+    /**
+     * Last-mile message preparation before the legacy handler builds a provider
+     * request. SessionRuntime uses this to apply API-safe normalization,
+     * tool-result truncation, and stale read-result rewriting with its
+     * session-owned MessageBuilder.
+     */
+    readonly prepareMessages?: (messages: Message[]) => Message[] | Promise<Message[]>;
+}
+/**
+ * Build an `AgentModel` adapter around an existing `ApiHandler`.
+ *
+ * The returned adapter:
+ *
+ *  1. Converts `AgentModelRequest.messages` (`AgentMessage[]`) back
+ *     into `LlmsProviders.Message[]` via
+ *     {@link agentMessagesToMessages}.
+ *  2. Converts `AgentModelRequest.tools`
+ *     (`AgentToolDefinition[]`) to `LlmsProviders.ToolDefinition[]`.
+ *  3. Invokes `handler.createMessage(systemPrompt, messages, tools)`.
+ *  4. Iterates the returned `ApiStream` and yields
+ *     `AgentModelEvent`s produced by {@link apiStreamChunkToAgentModelEvent}.
+ */
+export declare function apiHandlerToAgentModel(handler: ApiHandler, options?: ApiHandlerAgentModelOptions): AgentModel;
+/**
+ * Translate an `ApiStream` (async generator of `ApiStreamChunk`)
+ * into an async iterable of `AgentModelEvent`. Exposed for tests;
+ * production callers go through {@link apiHandlerToAgentModel}.
+ */
+export declare function translateApiStream(stream: AsyncIterable<ApiStreamChunk>): AsyncIterable<AgentModelEvent>;
+/**
+ * Map a single `ApiStreamChunk` to the corresponding
+ * `AgentModelEvent`. Returns `undefined` for chunks that carry no
+ * runtime-observable payload (currently none — but the hook exists
+ * so we can silently drop future additions without type breakage).
+ */
+export declare function apiStreamChunkToAgentModelEvent(chunk: ApiStreamChunk): AgentModelEvent | undefined;
+/**
+ * Options threaded into every adapted tool's `ToolContext`.
+ */
+export interface ToolAdapterOptions {
+    /**
+     * Conversation id bound to every `ToolContext.conversationId`
+     * the tool's `execute()` receives. The new runtime scopes tools
+     * by `AgentToolContext.agentId`/`.runId`; the legacy `ToolContext`
+     * requires `conversationId` separately, so the caller
+     * (`SessionRuntime`) supplies it once at adapter-construction
+     * time.
+     */
+    readonly conversationId: string;
+    /**
+     * Optional metadata merged into every tool execution
+     * (`AgentConfig.toolContextMetadata` equivalent).
+     */
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Adapt a legacy `Tool<TInput, TOutput>` to the new
+ * `AgentTool<TInput, TOutput>`.
+ *
+ *  - name/description/inputSchema flow through verbatim;
+ *  - `execute(input, AgentToolContext)` is wrapped so the legacy
+ *    signature `execute(input, ToolContext, onChange)` receives the
+ *    correct fields and the return value is boxed into an
+ *    `AgentToolResult`.
+ */
+export declare function toolToAgentTool<TInput, TOutput>(tool: Tool<TInput, TOutput>, options: ToolAdapterOptions): AgentTool<TInput, TOutput>;
+/**
+ * Convenience bulk-adapter for `AgentConfig.tools`.
+ */
+export declare function toolsToAgentTools(tools: readonly Tool[], options: ToolAdapterOptions): AgentTool[];
+/**
+ * Normalize a single `MessageWithMetadata` into an `AgentMessage`.
+ *
+ * Role mapping: the legacy `MessageRole` is `"user" | "assistant"`.
+ * `tool_result` content blocks on user messages are hoisted into a
+ * dedicated `AgentMessage` with role `"tool"` — matching how the new
+ * runtime's tool executor emits tool messages
+ * (`packages/agents/src/agent-runtime.ts` tool-finished path).
+ */
+export declare function messageToAgentMessages(message: MessageWithMetadata): AgentMessage[];
+/**
+ * Bulk-adapter: `MessageWithMetadata[]` → `AgentMessage[]`. A single
+ * legacy message with both text and tool-result blocks may expand
+ * into multiple agent messages (see {@link messageToAgentMessages}).
+ */
+export declare function messagesToAgentMessages(messages: readonly MessageWithMetadata[]): AgentMessage[];
+/**
+ * Reverse adapter: `AgentMessage` → `MessageWithMetadata`. Best-effort
+ * preservation of id/metadata/modelInfo/metrics; tool-message
+ * tool-result parts are rendered as `tool_result` content blocks on
+ * a user message (matching legacy storage conventions).
+ */
+export declare function agentMessageToMessageWithMetadata(message: AgentMessage): MessageWithMetadata;
+/**
+ * Bulk-adapter for the reverse direction.
+ */
+export declare function agentMessagesToMessagesWithMetadata(messages: readonly AgentMessage[]): MessageWithMetadata[];
+/**
+ * Lossy but adequate: `AgentMessage[]` → `LlmsProviders.Message[]`.
+ * Used to feed the legacy `ApiHandler.createMessage()` in
+ * {@link apiHandlerToAgentModel}. Drops fields that the handler
+ * does not consume (id, ts, metrics, modelInfo).
+ */
+export declare function agentMessagesToMessages(messages: readonly AgentMessage[]): Message[];
+/**
+ * Map runtime `AgentToolDefinition[]` to legacy
+ * `LlmsProviders.ToolDefinition[]`. Structurally identical today —
+ * but typing them separately keeps the adapter explicit.
+ */
+export declare function agentToolDefinitionsToToolDefinitions(tools: AgentModelRequest["tools"]): ToolDefinition[];
+//# sourceMappingURL=agent-config-adapter.d.ts.map

package/dist/runtime/agent-config-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-config-adapter.d.ts","sourceRoot":"","sources":["../../src/runtime/agent-config-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACX,UAAU,EACV,cAAc,EACd,cAAc,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACX,YAAY,EAEZ,UAAU,EACV,eAAe,EACf,iBAAiB,EAEjB,SAAS,EAMT,OAAO,EACP,mBAAmB,EAInB,IAAI,EAIJ,MAAM,kBAAkB,CAAC;AAM1B;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC3C,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,WAAW,GAAG,SAAS,CAAC;IACxD;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,CAC1B,QAAQ,EAAE,OAAO,EAAE,KACf,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,2BAAgC,GACvC,UAAU,CAkBZ;AAED;;;;GAIG;AACH,wBAAuB,kBAAkB,CACxC,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,GACnC,aAAa,CAAC,eAAe,CAAC,CAuBhC;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,cAAc,GACnB,eAAe,GAAG,SAAS,CA8D7B;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAC9C,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,OAAO,EAAE,kBAAkB,GACzB,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAgC5B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,OAAO,EAAE,kBAAkB,GACzB,SAAS,EAAE,CAEb;AAMD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,mBAAmB,GAC1B,YAAY,EAAE,CAgChB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,GACtC,YAAY,EAAE,CAMhB;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAChD,OAAO,EAAE,YAAY,GACnB,mBAAmB,CAarB;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAClD,QAAQ,EAAE,SAAS,YAAY,EAAE,GAC/B,mBAAmB,EAAE,CAEvB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAC/B,OAAO,EAAE,CA6BX;AAED;;;;GAIG;AACH,wBAAgB,qCAAqC,CACpD,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAC/B,cAAc,EAAE,CAMlB"}

package/dist/runtime/agent-runtime-config-builder.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Build an `AgentRuntimeConfig` from an `AgentConfig` plus session-owned
+ * supporting objects (model handler, tools, hooks, plugins, telemetry).
+ *
+ * @see PLAN.md §3.1 — new file introduced alongside the core runtime port.
+ * @see PLAN.md §3.2.1 — field-by-field mapping.
+ *
+ * Implemented in Step 8c. The function is intentionally **pure** — it
+ * does not create handlers or tools itself; it receives them already
+ * adapted (via `agent-config-adapter.ts`) from the caller
+ * (`SessionRuntime`) and wires them into an `AgentRuntimeConfig`.
+ *
+ * Fields that do **not** round-trip into `AgentRuntimeConfig`
+ * (e.g. `execution.maxConsecutiveMistakes`,
+ * `execution.loopDetection`, `hookPolicies`) are
+ * consumed by `SessionRuntime` / `MistakeTracker` /
+ * `LoopDetectionTracker` — not passed through here. See §3.2.1's
+ * "Fields with no corresponding AgentRuntimeConfig slot" note.
+ */
+import type { AgentConfig, AgentMessage, AgentModel, AgentRuntimeConfig, AgentRuntimePlugin, AgentTelemetry, AgentTool, BasicLogger } from "@clinebot/shared";
+import type { HookBridge } from "../hooks/hook-bridge";
+/**
+ * Inputs required to assemble an `AgentRuntimeConfig`. Distinct from
+ * `AgentConfig` because some of these (the model adapter, the hook
+ * bridge's runtime-hooks bag, a resolved plugin list) can only be
+ * produced inside `SessionRuntime`.
+ */
+export interface CreateAgentRuntimeConfigInput {
+    readonly agentConfig: AgentConfig;
+    /**
+     * Core/hub runtime session identifier used for host lifecycle operations,
+     * event routing, persistence, and approval delivery.
+     */
+    readonly sessionId?: string;
+    readonly agentId: string;
+    /**
+     * Agent conversation/transcript identifier used by tools, hooks, telemetry,
+     * and model history correlation.
+     */
+    readonly conversationId?: string;
+    readonly parentAgentId?: string;
+    /** The role label for teammates (`AgentConfig.role` in sub-agent configs). */
+    readonly agentRole?: string;
+    /** Pre-built model adapter (produced by `apiHandlerToAgentModel`). */
+    readonly model: AgentModel;
+    readonly logger?: BasicLogger;
+    readonly telemetry?: AgentTelemetry;
+    /** Pre-built tool array (builtins + plugin-contributed + session extras). */
+    readonly tools?: readonly AgentTool<unknown, unknown>[];
+    /** Pre-resolved plugin list from the plugin loader. */
+    readonly plugins?: readonly AgentRuntimePlugin[];
+    /**
+     * Optional hook bridge. When provided, `AgentRuntimeConfig.hooks`
+     * is populated from `hookBridge.toRuntimeHooks()`. Omit for
+     * runtimes that do not need hook dispatch (e.g. unit tests).
+     */
+    readonly hookBridge?: HookBridge;
+    /** Seed messages (usually `session.conversation.getMessages()`). */
+    readonly initialMessages?: readonly AgentMessage[];
+    /**
+     * Override for `AgentRuntimeConfig.systemPrompt` — useful when
+     * the caller has composed additional guidance (e.g. via
+     * `LocalRuntimeHost.composeSystemPrompt`). Defaults to
+     * `agentConfig.systemPrompt`.
+     */
+    readonly systemPrompt?: string;
+}
+/**
+ * Produce an `AgentRuntimeConfig` per PLAN.md §3.2.1 mapping.
+ */
+export declare function createAgentRuntimeConfig(input: CreateAgentRuntimeConfigInput): AgentRuntimeConfig;
+/**
+ * Collect the provider-/reasoning-related fields from `AgentConfig`
+ * into `AgentRuntimeConfig.modelOptions`. Kept undefined when every
+ * field is undefined so the runtime does not receive an empty object.
+ */
+export declare function buildModelOptions(config: AgentConfig): Record<string, unknown> | undefined;
+/**
+ * Compose `messageModelInfo` from the provider-related fields per
+ * §3.2.1: `{ id: modelId, provider: providerId, family:
+ * providerConfig?.family }`.
+ */
+export declare function buildMessageModelInfo(config: AgentConfig): AgentMessage["modelInfo"];
+/**
+ * `"parallel"` when `maxParallelToolCalls ≥ 2`, `"sequential"` when
+ * `1`, `undefined` when the caller did not specify.
+ */
+export declare function resolveToolExecution(maxParallelToolCalls: number | undefined): "sequential" | "parallel" | undefined;
+/**
+ * Adapt the full `ITelemetryService` to the minimal `AgentTelemetry`
+ * shape. The runtime only calls `capture(event, properties)`; the
+ * remaining methods are host concerns and stay on the
+ * `ITelemetryService` instance owned by `SessionRuntime`.
+ */
+export declare function mapTelemetry(telemetry: AgentConfig["telemetry"]): AgentTelemetry | undefined;
+//# sourceMappingURL=agent-runtime-config-builder.d.ts.map

package/dist/runtime/agent-runtime-config-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runtime-config-builder.d.ts","sourceRoot":"","sources":["../../src/runtime/agent-runtime-config-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACX,WAAW,EACX,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,WAAW,EACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;IACxD,uDAAuD;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,oEAAoE;IACpE,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACnD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,6BAA6B,GAClC,kBAAkB,CA8BpB;AAMD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,WAAW,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAkBrC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,WAAW,GACjB,YAAY,CAAC,WAAW,CAAC,CAQ3B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CACnC,oBAAoB,EAAE,MAAM,GAAG,SAAS,GACtC,YAAY,GAAG,UAAU,GAAG,SAAS,CAKvC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC3B,SAAS,EAAE,WAAW,CAAC,WAAW,CAAC,GACjC,cAAc,GAAG,SAAS,CAmB5B"}

package/dist/runtime/history.d.ts

@@ -1,4 +1,10 @@
 import type { SessionHistoryRecord, SessionRecord } from "../types/sessions";
 import type { RuntimeHost } from "./runtime-host";
+export interface SessionHistoryListOptions {
+    limit?: number;
+    includeManifestFallback?: boolean;
+    hydrate?: boolean;
+}
 export declare function hydrateSessionHistory(host: Pick<RuntimeHost, "readMessages">, rows: SessionRecord[]): Promise<SessionHistoryRecord[]>;
+export declare function listSessionHistory(host: Pick<RuntimeHost, "list" | "readMessages">, options?: SessionHistoryListOptions): Promise<SessionHistoryRecord[]>;
 //# sourceMappingURL=history.d.ts.map

package/dist/runtime/history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/runtime/history.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEX,oBAAoB,EACpB,aAAa,EACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAwMlD,wBAAsB,qBAAqB,CAC1C,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EACvC,IAAI,EAAE,aAAa,EAAE,GACnB,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA0BjC"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/runtime/history.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEX,oBAAoB,EACpB,aAAa,EACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,yBAAyB;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAySD,wBAAsB,qBAAqB,CAC1C,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EACvC,IAAI,EAAE,aAAa,EAAE,GACnB,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA0BjC;AAED,wBAAsB,kBAAkB,CACvC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC,EAChD,OAAO,GAAE,yBAA8B,GACrC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAwBjC"}

package/dist/runtime/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/runtime/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAOrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAIhE,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,gBAAgB,CAAC;AAkBnE,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAqDrE,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,gBAAgB,GACvB,OAAO,CAAC,cAAc,CAAC,CAiBzB;AAED,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,gBAAgB,GACvB,OAAO,CAAC,WAAW,CAAC,CA6FtB"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/runtime/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAQrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAIhE,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,gBAAgB,CAAC;AAkBnE,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAsErE,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,gBAAgB,GACvB,OAAO,CAAC,cAAc,CAAC,CAiBzB;AAED,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,gBAAgB,GACvB,OAAO,CAAC,WAAW,CAAC,CAiGtB"}

package/dist/runtime/loop-detection.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Repeated tool-call loop detection.
+ *
+ * @see PLAN.md §3.1 — helpers moved from `packages/agents/src/context/loop-detection.ts`.
+ * @see PLAN.md §3.2.3 — public surface of `LoopDetectionTracker`.
+ *
+ * The pure helpers (`createLoopDetectionState`, `resetLoopDetectionState`,
+ * `toolCallSignature`, `checkRepeatedToolCall`) are ported verbatim. The
+ * `LoopDetectionTracker` class is a thin wrapper that owns a
+ * `LoopDetectionState` and exposes the `inspect()` / `reset()` surface that
+ * `SessionRuntime` installs as a `beforeTool` hook per §3.2.3.
+ */
+import type { LoopDetectionConfig } from "@clinebot/shared";
+export interface LoopDetectionState {
+    lastToolName: string;
+    lastToolSignature: string;
+    consecutiveIdenticalCount: number;
+}
+export declare function createLoopDetectionState(): LoopDetectionState;
+export declare function resetLoopDetectionState(state: LoopDetectionState): void;
+export declare function toolCallSignature(input: unknown): string;
+export interface LoopCheckResult {
+    softWarning: boolean;
+    hardEscalation: boolean;
+}
+export declare function checkRepeatedToolCall(state: LoopDetectionState, toolName: string, signature: string, config: LoopDetectionConfig): LoopCheckResult;
+/**
+ * Verdict returned by {@link LoopDetectionTracker.inspect}.
+ *
+ * - `"ok"`   — no repeated call detected.
+ * - `"soft"` — soft-warning threshold reached; SessionRuntime may surface a
+ *              recovery notice but should not block the call.
+ * - `"hard"` — hard-escalation threshold reached; SessionRuntime should
+ *              stop the run with the provided `message`.
+ */
+export interface LoopDetectionVerdict {
+    kind: "ok" | "soft" | "hard";
+    message?: string;
+}
+/** Minimal call shape the tracker needs; matches `AgentToolCallPart` subset. */
+export interface LoopDetectionCall {
+    name: string;
+    input: unknown;
+}
+/**
+ * Per-session repeated-tool-call detector.
+ *
+ * `SessionRuntime` owns the instance and installs a `beforeTool` hook
+ * (see `AgentRuntimeHooks.beforeTool`) that calls `inspect()` to decide
+ * whether to return `{ skip, stop, reason }`.
+ */
+export declare class LoopDetectionTracker {
+    private readonly config;
+    private readonly state;
+    constructor(config?: Partial<LoopDetectionConfig>);
+    inspect(call: LoopDetectionCall): LoopDetectionVerdict;
+    reset(): void;
+}
+//# sourceMappingURL=loop-detection.d.ts.map

package/dist/runtime/loop-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-detection.d.ts","sourceRoot":"","sources":["../../src/runtime/loop-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAM5D,MAAM,WAAW,kBAAkB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yBAAyB,EAAE,MAAM,CAAC;CAClC;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAM7D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAIvE;AAYD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASxD;AAED,MAAM,WAAW,eAAe;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,GACzB,eAAe,CAgBjB;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CACf;AAOD;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkD;gBAE5D,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAOjD,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,oBAAoB;IAuBtD,KAAK,IAAI,IAAI;CAGb"}

package/dist/runtime/mistake-tracker.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Per-session consecutive-mistake tracker.
+ *
+ * @see PLAN.md §3.1 — wrapped around `recordMistake` moved from
+ *                    `packages/agents/src/api/error-handling.ts` lines 147–311.
+ * @see PLAN.md §3.2.3 — public surface of `MistakeTracker`.
+ *
+ * The pure procedural `recordMistake(input, deps)` becomes `record(input)`
+ * on the class; `consecutiveMistakes` is internal state. Other deps flow
+ * through the constructor instead.
+ *
+ * NOTE: the §3.2.3 constructor shape omits some fields (agentId,
+ * conversationId/runId getters, appendRecoveryNotice). They are retained
+ * here for log + notice parity per PLAN.md §3.4.3/§3.4.5. Step 8
+ * (`impl-runtime-porter`) may refactor once SessionRuntime is wired up.
+ */
+import type { AgentEvent, BasicLogMetadata, ConsecutiveMistakeLimitContext, ConsecutiveMistakeLimitDecision } from "@clinebot/shared";
+/**
+ * Legacy-agents-style leveled log function. The sdk-re `BasicLogger`
+ * does not carry a level argument (§shared/logging/logger.ts); callers
+ * are expected to bridge via `metadata.severity` or dispatch to
+ * `debug`/`log`/`error`. `MistakeTracker` accepts a leveled callable
+ * here so Step 8 can plug in whichever bridging shape `SessionRuntime`
+ * ends up using.
+ */
+export type LeveledLog = (level: "debug" | "info" | "warn" | "error", message: string, metadata?: BasicLogMetadata) => void;
+export type MistakeReason = "api_error" | "invalid_tool_call" | "tool_execution_failed";
+export interface RecordMistakeInput {
+    iteration: number;
+    reason: MistakeReason;
+    details?: string;
+    /** When true, jump straight to maxConsecutiveMistakes instead of incrementing by 1. */
+    forceAtLimit?: boolean;
+}
+export type MistakeOutcome = {
+    action: "continue";
+    guidance?: string;
+} | {
+    action: "stop";
+    message: string;
+    reason?: string;
+};
+export interface MistakeTrackerOptions {
+    readonly maxConsecutiveMistakes: number;
+    readonly onLimitReached?: (ctx: ConsecutiveMistakeLimitContext) => Promise<ConsecutiveMistakeLimitDecision> | ConsecutiveMistakeLimitDecision;
+    readonly emit: (event: AgentEvent) => void;
+    readonly log: LeveledLog;
+    readonly agentId: string;
+    readonly getConversationId: () => string;
+    readonly getActiveRunId: () => string;
+    readonly appendRecoveryNotice: (message: string, reason: MistakeReason) => void;
+}
+export declare class MistakeTracker {
+    private consecutiveMistakes;
+    private readonly options;
+    constructor(options: MistakeTrackerOptions);
+    record(input: RecordMistakeInput): Promise<MistakeOutcome>;
+    reset(): void;
+    get value(): number;
+}
+export declare function buildMistakeLimitStopMessage(input: {
+    iteration: number;
+    consecutiveMistakes: number;
+    maxConsecutiveMistakes: number;
+    reason: "api_error" | "invalid_tool_call" | "completion_without_submit" | "tool_execution_failed";
+    details?: string;
+    stopReason?: string;
+}): string;
+//# sourceMappingURL=mistake-tracker.d.ts.map

package/dist/runtime/mistake-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mistake-tracker.d.ts","sourceRoot":"","sources":["../../src/runtime/mistake-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACX,UAAU,EACV,gBAAgB,EAChB,8BAA8B,EAC9B,+BAA+B,EAC/B,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,CACxB,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1C,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,gBAAgB,KACvB,IAAI,CAAC;AAEV,MAAM,MAAM,aAAa,GACtB,WAAW,GACX,mBAAmB,GACnB,uBAAuB,CAAC;AAE3B,MAAM,WAAW,kBAAkB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,cAAc,GACvB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,CACzB,GAAG,EAAE,8BAA8B,KAEjC,OAAO,CAAC,+BAA+B,CAAC,GACxC,+BAA+B,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,MAAM,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,MAAM,CAAC;IACtC,QAAQ,CAAC,oBAAoB,EAAE,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,aAAa,KACjB,IAAI,CAAC;CACV;AAED,qBAAa,cAAc;IAC1B,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;gBAEpC,OAAO,EAAE,qBAAqB;IAIpC,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IA8DhE,KAAK,IAAI,IAAI;IAIb,IAAI,KAAK,IAAI,MAAM,CAElB;CACD;AAMD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,MAAM,EACH,WAAW,GACX,mBAAmB,GACnB,2BAA2B,GAC3B,uBAAuB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAgBT"}

package/dist/runtime/runtime-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-builder.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime-builder.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EACX,cAAc,EACd,mBAAmB,EACnB,YAAY,IAAI,kBAAkB,EAClC,MAAM,mBAAmB,CAAC;AA2C3B,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAyXD,qBAAa,qBAAsB,YAAW,cAAc;IAC3D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAQ/B;IAEE,KAAK,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAwRpE"}
+{"version":3,"file":"runtime-builder.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime-builder.ts"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EACX,cAAc,EACd,mBAAmB,EACnB,YAAY,IAAI,kBAAkB,EAClC,MAAM,mBAAmB,CAAC;AAwD3B,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AA+YD,qBAAa,qBAAsB,YAAW,cAAc;IAC3D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAQ/B;IAEE,KAAK,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAwSpE"}