@clinebot/core 0.0.36 → 0.0.37

package/dist/runtime/runtime-event-adapter.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Adapter from the new `AgentRuntimeEvent` union (13 variants, defined
+ * in `@clinebot/shared/src/agent.ts`) to the legacy `AgentEvent` union
+ * (9 top-level types, defined in
+ * `@clinebot/shared/src/agents/types.ts`) consumed by today's
+ * `Agent.subscribeEvents` callback.
+ *
+ * @see PLAN.md §3.1  — new file introduced alongside the core runtime port.
+ * @see PLAN.md §3.3.2 — variant-by-variant OLD → NEW mapping.
+ * @see PLAN.md §3.2.4 — called from `Agent.subscribeEvents` inside the
+ *                       legacy-agent facade.
+ *
+ * --- IMPLEMENTATION NOTE — PLAN §3.3.2 text/reasoning-delta rows ----------
+ *
+ * PLAN.md §3.3.2 describes `assistant-text-delta` as "first delta →
+ * content_start, subsequent → content_update". The **actual** legacy
+ * shape forbids this: `AgentContentUpdateEvent.contentType` is
+ * hard-typed as `"tool"` in
+ * `packages/shared/src/agents/types.ts:87`, and the legacy
+ * turn-processor
+ * (`packages/agents/src/runtime/turn-processor.ts:82-87,113-118`)
+ * emits a `content_start` event for **every** text delta and for
+ * **every** reasoning delta — not just the first. This adapter
+ * preserves that observable behavior (what every legacy consumer
+ * relies on today) over the description in §3.3.2.
+ *
+ *   text deltas      → content_start { contentType:"text", text,
+ *                        accumulated } (per delta)
+ *   reasoning deltas → content_start { contentType:"reasoning",
+ *                        reasoning, redacted } (per delta)
+ *   assistant-message → one content_end { contentType:"text", text }
+ *                        if any text parts; one
+ *                        content_end { contentType:"reasoning", reasoning }
+ *                        if any reasoning parts
+ *                        (turn-processor.ts:157-170).
+ *
+ * --- STATEFUL BOOK-KEEPING ------------------------------------------------
+ *
+ *  1. Rolling usage totals. `usage-updated` carries the already-
+ *     accumulated snapshot (agent-runtime.ts:668-683). Legacy
+ *     `AgentUsageEvent` wants both per-turn delta and accumulated
+ *     totals; the adapter subtracts the previous accumulated value
+ *     from the incoming one to produce the delta.
+ *  2. Tool timing. `tool-finished` does not carry `durationMs`. The
+ *     adapter records `Date.now()` on `tool-started` (keyed by
+ *     `toolCallId`) and computes `durationMs` at `tool-finished`.
+ *     Matches `tool-orchestrator.ts:112-131`.
+ *
+ * Both are scoped to a single adapter instance and cleared by
+ * `reset()`.
+ */
+import type { AgentEvent, AgentMessage, AgentRuntimeEvent } from "@clinebot/shared";
+declare function textFromMessage(message: AgentMessage | undefined): string;
+/**
+ * Per-subscriber adapter instance. Constructed once per
+ * `Agent.subscribeEvents` registration (or per `SessionRuntime`),
+ * used for the lifetime of that subscription, and `reset()` at the
+ * start of every new run.
+ *
+ * `translate(event)` returns zero, one, or two `AgentEvent`s. An
+ * array is needed because a single `assistant-message` may yield both
+ * a text `content_end` and a reasoning `content_end`. Empty array
+ * means the event is intentionally suppressed (§3.3.2 rows
+ * `run-started`, `message-added`).
+ */
+export declare class RuntimeEventAdapter {
+    private lastUsage;
+    private toolStartedAt;
+    translate(event: AgentRuntimeEvent): AgentEvent[];
+    reset(): void;
+    private translateAssistantMessage;
+    private translateToolStarted;
+    private translateToolFinished;
+    private translateUsage;
+    private translateRunFinished;
+}
+/**
+ * Stateless translator. Works correctly for every variant except
+ * those that require bookkeeping:
+ *
+ *  - `usage-updated` — deltas cannot be computed without a prior
+ *    snapshot; this function treats the prior snapshot as zero (so
+ *    delta == accumulated). Adequate for a single event, incorrect
+ *    across multiple.
+ *  - `tool-finished` — `durationMs` is reported as `undefined`
+ *    because the corresponding `tool-started` was never observed by
+ *    this one-shot adapter.
+ *
+ * Production code must use `RuntimeEventAdapter` for multi-event
+ * runs; this function exists for ad-hoc unit tests and one-shot
+ * translations where bookkeeping does not matter.
+ *
+ * Returns `undefined` when the event maps to zero legacy events
+ * (`run-started`, `message-added`, or an `assistant-message` that
+ * carries no text/reasoning parts). When an event produces multiple
+ * legacy events (e.g. `assistant-message` with both text and
+ * reasoning parts), only the first is returned; callers needing the
+ * full array must use `RuntimeEventAdapter.translate()`.
+ */
+export declare function toLegacyAgentEvent(event: AgentRuntimeEvent): AgentEvent | undefined;
+export { textFromMessage };
+//# sourceMappingURL=runtime-event-adapter.d.ts.map

package/dist/runtime/runtime-event-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-event-adapter.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime-event-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,KAAK,EACX,UAAU,EAEV,YAAY,EAEZ,iBAAiB,EAKjB,MAAM,kBAAkB,CAAC;AAuC1B,iBAAS,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,CAKlE;AAsCD;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,SAAS,CAMf;IAEF,OAAO,CAAC,aAAa,CAA6B;IAElD,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,UAAU,EAAE;IAuEjD,KAAK,IAAI,IAAI;IAab,OAAO,CAAC,yBAAyB;IAiBjC,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,qBAAqB;IAwB7B,OAAO,CAAC,cAAc;IAsCtB,OAAO,CAAC,oBAAoB;CA6B5B;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,iBAAiB,GACtB,UAAU,GAAG,SAAS,CAIxB;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

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

@@ -1,14 +1,14 @@
 import type * as LlmsProviders from "@clinebot/llms";
-import type { AgentResult, ToolApprovalRequest, ToolApprovalResult } from "@clinebot/shared";
+import type { AgentResult, RuntimeConfigExtensionKind, ToolApprovalRequest, ToolApprovalResult } from "@clinebot/shared";
 import type { ToolExecutors } from "../extensions/tools";
 import type { HookEventPayload } from "../hooks";
 import type { ProviderSettings } from "../llms/provider-settings";
 import type { SessionManifest } from "../session/session-manifest";
 import type { SessionSource } from "../types/common";
 import type { CoreSessionConfig } from "../types/config";
-import type { CoreSessionEvent } from "../types/events";
+import type { CoreSessionEvent, SessionPendingPrompt } from "../types/events";
 import type { SessionRecord } from "../types/sessions";
-type LocalOnlyCoreSessionConfigKeys = "hooks" | "logger" | "telemetry" | "extraTools" | "extensions" | "onTeamEvent" | "onConsecutiveMistakeLimitReached";
+type LocalOnlyCoreSessionConfigKeys = "hooks" | "logger" | "telemetry" | "extensionContext" | "extraTools" | "extensions" | "onTeamEvent" | "onConsecutiveMistakeLimitReached";
 export type RuntimeSessionConfig = Omit<CoreSessionConfig, LocalOnlyCoreSessionConfigKeys | "checkpoint" | "compaction"> & {
     checkpoint?: Omit<NonNullable<CoreSessionConfig["checkpoint"]>, "createCheckpoint">;
     compaction?: Omit<NonNullable<CoreSessionConfig["compaction"]>, "compact">;
@@ -21,6 +21,7 @@ export interface LocalRuntimeStartOptions {
     configOverrides?: Partial<LocalRuntimeConfigOverrides>;
     modelCatalogDefaults?: Partial<NonNullable<ProviderSettings["modelCatalog"]>>;
     userInstructionWatcher?: import("../extensions/config").UserInstructionConfigWatcher;
+    configExtensions?: RuntimeConfigExtensionKind[];
     onTeamRestored?: () => void;
     defaultToolExecutors?: Partial<ToolExecutors>;
 }
@@ -67,6 +68,27 @@ export interface SessionAccumulatedUsage {
     cacheWriteTokens: number;
     totalCost: number;
 }
+export interface PendingPromptMutationResult {
+    sessionId: string;
+    prompts: SessionPendingPrompt[];
+    prompt?: SessionPendingPrompt;
+    updated?: boolean;
+    removed?: boolean;
+}
+export type PendingPromptsAction = "list" | "update" | "delete";
+export interface PendingPromptsListInput {
+    sessionId: string;
+}
+export interface PendingPromptsUpdateInput {
+    sessionId: string;
+    promptId: string;
+    prompt?: string;
+    delivery?: "queue" | "steer";
+}
+export interface PendingPromptsDeleteInput {
+    sessionId: string;
+    promptId: string;
+}
 export interface RuntimeHostSubscribeOptions {
     sessionId?: string;
 }
@@ -79,6 +101,9 @@ export interface RuntimeHost {
     readonly runtimeAddress?: string;
     start(input: StartSessionInput): Promise<StartSessionResult>;
     send(input: SendSessionInput): Promise<AgentResult | undefined>;
+    pendingPrompts(action: "list", input: PendingPromptsListInput): Promise<SessionPendingPrompt[]>;
+    pendingPrompts(action: "update", input: PendingPromptsUpdateInput): Promise<PendingPromptMutationResult>;
+    pendingPrompts(action: "delete", input: PendingPromptsDeleteInput): Promise<PendingPromptMutationResult>;
     getAccumulatedUsage(sessionId: string): Promise<SessionAccumulatedUsage | undefined>;
     abort(sessionId: string, reason?: unknown): Promise<void>;
     stop(sessionId: string): Promise<void>;

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

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

package/dist/runtime/session-runtime-orchestrator.d.ts

@@ -0,0 +1,261 @@
+/**
+ * Per-session `SessionRuntime` orchestrator (PLAN.md §3.2.3).
+ *
+ * Owns all cross-turn state for one logical agent session:
+ *
+ *   - `ConversationStore`      — message transcript + session-started gate
+ *   - `MistakeTracker`         — per-session consecutive-mistake counter
+ *   - `LoopDetectionTracker`   — per-session repeated-tool-call detector
+ *   - `MessageBuilder`         — provider-message assembly cache
+ *   - `HookEngine` + `HookBridge` — legacy `AgentHooks`/`AgentExtension[]`
+ *                                   → runtime-hook synthesis
+ *   - `RuntimeEventAdapter`    — per-run stateful `AgentRuntimeEvent`
+ *                                → legacy `AgentEvent` translator
+ *   - listener registry        — host subscribers see legacy `AgentEvent`s
+ *   - pending tool set, abort  — per-run lifecycle housekeeping
+ *
+ * A fresh `AgentRuntime` is instantiated per run via
+ * `createAgentRuntime(createAgentRuntimeConfig({...}))`; it is the
+ * only class that depends on `@clinebot/agents`. All session-level
+ * state outlives any one `AgentRuntime`, making OAuth-retry + run
+ * replay feasible (§3.2.2 invariant #3).
+ *
+ * NOTE: this class lives alongside the pre-existing
+ * `packages/core/src/runtime/session-runtime.ts`, which exports
+ * transport-level `SessionRuntime`/`RuntimeBuilder` interfaces
+ * consumed by `LocalRuntimeHost`. Both coexist through Step 8/9; the
+ * transport-level interface is retired in Step 10 (§3.6 Step 10).
+ *
+ * @see PLAN.md §3.2.3 — public surface.
+ * @see PLAN.md §3.2.2 — call graph and invariants.
+ * @see PLAN.md §3.6 Step 8d — landing commit.
+ */
+import type { AgentRuntime } from "@clinebot/agents";
+import { createAgentRuntime } from "@clinebot/agents";
+import { type AgentConfig, type AgentEvent, type AgentExtensionRegistry, type AgentResult, type BasicLogger, HookEngine, type ITelemetryService, type Message, type MessageWithMetadata, type Tool } from "@clinebot/shared";
+import { MessageBuilder } from "../session/message-builder";
+/**
+ * Listener invoked for every legacy `AgentEvent` produced by the
+ * session runtime. Use `subscribeEvents(listener)` — it returns an
+ * `unsubscribe` function.
+ */
+export type SessionEventListener = (event: AgentEvent) => void;
+/** Subset of host-side deps needed by the session orchestrator. */
+export interface SessionRuntimeOrchestratorDeps {
+    readonly logger?: BasicLogger;
+    readonly telemetry?: ITelemetryService;
+    /** Optional pre-constructed `HookEngine`. A fresh one is built when omitted. */
+    readonly hookEngine?: HookEngine;
+    /**
+     * Test hook: override the `AgentRuntime` factory. Production
+     * callers leave this undefined and get the real `createAgentRuntime`.
+     */
+    readonly createAgentRuntimeImpl?: (config: Parameters<typeof createAgentRuntime>[0]) => AgentRuntime;
+}
+/** Connection overrides applied via `updateConnection`. */
+export interface ConnectionOverrides {
+    providerId?: string;
+    modelId?: string;
+    apiKey?: string;
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    providerConfig?: unknown;
+    reasoningEffort?: AgentConfig["reasoningEffort"];
+    thinking?: boolean;
+    thinkingBudgetTokens?: number;
+}
+/**
+ * Per-session orchestrator. Construct once per agent session; call
+ * `run` / `continue` repeatedly. The class matches the subset of
+ * legacy `Agent` surface that `legacy-agent-facade` needs in Step 8e.
+ *
+ * Named `SessionRuntime` to match PLAN.md §3.2.3. To avoid a symbol
+ * collision with the pre-existing transport-level `SessionRuntime`
+ * interface in `session-runtime.ts`, this file is **not** re-exported
+ * from `runtime/index.ts` or `src/index.ts`. Consumers (facade in
+ * Step 8e) import directly from this module.
+ */
+export declare class SessionRuntime {
+    private config;
+    private readonly agentId;
+    private readonly parentAgentId?;
+    private readonly logger?;
+    readonly telemetry?: ITelemetryService;
+    private readonly hookEngine;
+    private readonly hookBridge;
+    private readonly conversation;
+    private readonly mistakeTracker;
+    private readonly loopTracker;
+    /**
+     * True when `execution.loopDetection === false` at construction
+     * time. Loop inspection is skipped entirely — the tracker still
+     * exists for API compatibility but is never fed.
+     */
+    private readonly loopDetectionDisabled;
+    readonly messageBuilder: MessageBuilder;
+    /**
+     * Contribution registry that hosts extension-provided tools,
+     * commands, message builders, and providers. Lazily initialized
+     * on first run (parity with legacy `Agent.ensureExtensionsInitialized`
+     * at `packages/agents/src/agent.ts:1122-1147`).
+     */
+    private readonly contributionRegistry;
+    private extensionsInitialized;
+    private readonly listeners;
+    private readonly createAgentRuntimeImpl;
+    /** Stable run id shared with the HookBridge during an active run. */
+    private activeRunId;
+    /** True while a run is in flight. `canStartRun()` is the negation. */
+    private running;
+    /** True once `abort()` has been requested for the active run. */
+    private abortRequested;
+    /** Last abort reason requested for the active run. */
+    private abortReason;
+    /** Reference to the current run's `AgentRuntime` so `abort` can forward. */
+    private activeRuntime;
+    /** Promise for the current run so shutdown can await an aborted run's drain. */
+    private activeRunPromise;
+    /** Per-run `Agent → AgentEvent` adapter; `reset()` each run. */
+    private readonly eventAdapter;
+    /** Session-shutdown gate — rejects late runs. */
+    private shutdownCalled;
+    /** Running tally of tool-call records for `AgentResult.toolCalls`. */
+    private currentRunToolCalls;
+    /** Aggregated usage across the current run. */
+    private currentRunUsage;
+    /** Tool-start timestamps for `ToolCallRecord.durationMs`. */
+    private toolStartedAt;
+    /** Tool-call input snapshot for `ToolCallRecord.input`. */
+    private toolInputs;
+    /**
+     * Per-turn tool outcome counters used by the MistakeTracker wiring.
+     * Reset on every `turn-started` event; consumed on `turn-finished`
+     * to feed `mistakeTracker.record` when every tool call erred and no
+     * successful call landed. Matches legacy `agent.ts` tool-failure
+     * mistake-feed path (§3.4.6 + pre-Step-9 oracle lines 972-997).
+     */
+    private currentTurnSuccessfulTools;
+    private currentTurnFailedTools;
+    private currentTurnFailureDetails;
+    /**
+     * Serial queue for `MistakeTracker.record(...)` + loop-detection
+     * side-effects fired from the sync `handleRuntimeEvent` stream. The
+     * tracker's `record()` is async but the runtime event stream is
+     * synchronous, so we chain tracker work onto a promise and await it
+     * in `executeRun` before returning the `AgentResult`.
+     */
+    private activeTrackerWork;
+    /** True when tracker logic has issued an abort for the active run. */
+    private trackerAbortInFlight;
+    constructor(config: AgentConfig, deps?: SessionRuntimeOrchestratorDeps);
+    getAgentId(): string;
+    getConversationId(): string;
+    getMessages(): MessageWithMetadata[];
+    /** True when no run is currently active and the session is not shut down. */
+    canStartRun(): boolean;
+    /**
+     * Snapshot of the contribution registry (tools, commands, and other
+     * extension contributions).
+     *
+     * Before the first run, the registry is in the `validate` phase:
+     * extensions are validated but their `setup()` callbacks have not
+     * run yet, so the snapshot only reflects eagerly-declared
+     * contributions. After the first `run()`/`continue()`, the
+     * registry is initialized (§`ensureExtensionsInitialized`), and
+     * the snapshot reflects everything extensions registered via
+     * `api.registerTool` / `registerCommand` / `registerMessageBuilder`
+     * / `registerProvider` / `registerAutomationEventType`.
+     */
+    getExtensionRegistry(): AgentExtensionRegistry<Tool, Message[]>;
+    /** Append additional tools to every subsequent turn's runtime config. */
+    addTools(tools: Tool[]): void;
+    /** Mutate provider / reasoning fields for subsequent runs. */
+    updateConnection(overrides: ConnectionOverrides): void;
+    clearHistory(): void;
+    restore(messages: readonly MessageWithMetadata[]): void;
+    private resetConversationBoundaryTrackers;
+    /**
+     * Subscribe to **legacy** `AgentEvent`s. The session runtime
+     * translates the new `AgentRuntimeEvent` stream via
+     * `RuntimeEventAdapter` before fanout, so consumers see the
+     * pre-swap shape.
+     */
+    subscribeEvents(listener: SessionEventListener): () => void;
+    abort(reason?: unknown): void;
+    /**
+     * Shut the session down. Fires `hook.session_shutdown` exactly once
+     * (legacy parity with `Agent.shutdown` at pre-Step-9 `agent.ts:325`)
+     * and drains any in-flight async hooks through the hook engine.
+     *
+     * @param reason    Optional caller-supplied reason string (e.g.
+     *                  `"session_complete"`, `"session_error"`,
+     *                  `"session_stop"`, `"ctrl_d"`). Propagated into
+     *                  the `session_shutdown` hook payload as
+     *                  `AgentHookSessionShutdownContext.reason` so hook
+     *                  handlers (e.g. hook-file runners) can route on
+     *                  it — this matches the legacy `Agent.shutdown(reason)`
+     *                  contract and keeps `isAbortReason(ctx.reason)`
+     *                  checks in `hook-file-hooks.ts` working.
+     * @param timeoutMs Optional drain timeout forwarded to
+     *                  `HookEngine.shutdown`. Defaults to the engine's
+     *                  own default (3000 ms) when omitted.
+     */
+    shutdown(reason?: string, timeoutMs?: number): Promise<void>;
+    run(userMessage: string, userImages?: string[], userFiles?: string[]): Promise<AgentResult>;
+    continue(userMessage?: string, userImages?: string[], userFiles?: string[]): Promise<AgentResult>;
+    private executeRun;
+    private executeRunInternal;
+    /**
+     * Build an aborted `AgentResult` without invoking the AgentRuntime.
+     * Used by the `hook.session_start` / `hook.input` cancel paths —
+     * legacy parity: a hook that returns `{ cancel: true }` short-circuits
+     * the run and yields `finishReason: "aborted"`.
+     */
+    private finalizeAbortedRun;
+    /**
+     * Initialize the contribution registry once per session. Runs
+     * extension `setup()` callbacks so they can `registerTool`,
+     * `registerCommand`, `registerMessageBuilder`, and
+     * `registerProvider`. Matches legacy `Agent.ensureExtensionsInitialized`
+     * at pre-Step-9 `agent.ts:1122-1147`:
+     *
+     *   - on `hookErrorMode === "throw"`, setup failures propagate;
+     *   - otherwise setup failures emit a recoverable `error` event
+     *     via the legacy event channel and leave the registry
+     *     partially initialized.
+     *
+     * Idempotent: subsequent calls are no-ops once the registry has
+     * been activated.
+     */
+    private ensureExtensionsInitialized;
+    private prepareMessagesForApi;
+    private handleRuntimeEvent;
+    private emitLegacyEvent;
+    /**
+     * Feed the `LoopDetectionTracker` with a tool-call and react to
+     * the returned verdict. Parity with pre-Step-9 agent.ts L917-954:
+     *
+     *   - `"soft"`  → append a recovery notice telling the model to
+     *                 change approach;
+     *   - `"hard"`  → feed `MistakeTracker.record` with
+     *                 `forceAtLimit:true`. When the tracker returns
+     *                 `action: "stop"`, append the stop notice and
+     *                 abort the active runtime.
+     */
+    private inspectLoopForToolCall;
+    /**
+     * Enqueue a mistake-record onto the serial tracker work chain. The
+     * runtime event stream is synchronous but `MistakeTracker.record`
+     * is async — chaining onto a shared promise preserves ordering
+     * (legacy parity) and lets `executeRun` await draining before
+     * returning the `AgentResult`.
+     *
+     * When the tracker returns `action: "stop"`, append the stop notice
+     * to the conversation and abort the active runtime so the run ends
+     * with `finishReason: "aborted"`.
+     */
+    private enqueueMistakeRecord;
+    private buildLegacyResult;
+    private dispatchRunEnd;
+}
+//# sourceMappingURL=session-runtime-orchestrator.d.ts.map

package/dist/runtime/session-runtime-orchestrator.d.ts.map

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

package/dist/runtime/session-runtime.d.ts

@@ -1,9 +1,20 @@
-import type { Agent } from "@clinebot/agents";
-import type { AgentConfig, AgentHooks, AgentResult, BasicLogger, ITelemetryService, Tool } from "@clinebot/shared";
+import type { AgentConfig, AgentHooks, AgentResult, BasicLogger, ITelemetryService, RuntimeConfigExtensionKind, Tool } from "@clinebot/shared";
 import type { UserInstructionConfigWatcher } from "../extensions/config";
 import type { ToolExecutors } from "../extensions/tools";
 import type { AgentTeamsRuntime, DelegatedAgentConfigProvider, TeamEvent } from "../extensions/tools/team";
 import type { CoreSessionConfig } from "../types/config";
+/**
+ * Internal structural alias for the lead-agent handle that
+ * {@link BuiltRuntime.registerLeadAgent} hands off to
+ * `runtime-builder.ts`. Narrowed to only the `.addTools()` surface the
+ * callback exercises; avoids depending on `@clinebot/agents`' `Agent`
+ * class during the PLAN.md §3.6 Step 5 type-only migration. When
+ * SessionRuntime is rebuilt in Step 6, this field is expected to be
+ * dropped entirely per §3.5 row #2.
+ */
+type LeadAgentHandle = {
+    addTools(tools: Tool[]): unknown;
+};
 export interface BuiltRuntime {
     tools: Tool[];
     hooks?: AgentHooks;
@@ -13,7 +24,7 @@ export interface BuiltRuntime {
     teamRestoredFromPersistence?: boolean;
     delegatedAgentConfigProvider?: DelegatedAgentConfigProvider;
     completionGuard?: () => string | undefined;
-    registerLeadAgent?: (agent: Agent) => void;
+    registerLeadAgent?: (agent: LeadAgentHandle) => void;
     shutdown: (reason: string) => Promise<void> | void;
 }
 export interface RuntimeBuilderInput {
@@ -24,6 +35,7 @@ export interface RuntimeBuilderInput {
     createSpawnTool?: () => Tool;
     onTeamRestored?: () => void;
     userInstructionWatcher?: UserInstructionConfigWatcher;
+    configExtensions?: RuntimeConfigExtensionKind[];
     defaultToolExecutors?: Partial<ToolExecutors>;
     logger?: BasicLogger;
     telemetry?: ITelemetryService;
@@ -40,4 +52,5 @@ export interface SessionRuntime {
     stop(sessionId: string): Promise<void>;
     poll(): Promise<string[]>;
 }
+export {};
 //# sourceMappingURL=session-runtime.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"session-runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/session-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,IAAI,EACJ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EACX,iBAAiB,EACjB,4BAA4B,EAC5B,SAAS,EACT,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;IAC5D,eAAe,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC3C,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC3C,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACzC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,sBAAsB,CAAC,EAAE,4BAA4B,CAAC;IACtD,oBAAoB,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;CACxE;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAC1E,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1B"}
+{"version":3,"file":"session-runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/session-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,0BAA0B,EAC1B,IAAI,EACJ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EACX,iBAAiB,EACjB,4BAA4B,EAC5B,SAAS,EACT,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;;;;;;;GAQG;AACH,KAAK,eAAe,GAAG;IACtB,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;IAC5D,eAAe,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC3C,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACrD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACzC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,sBAAsB,CAAC,EAAE,4BAA4B,CAAC;IACtD,gBAAgB,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAChD,oBAAoB,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;CACxE;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAC1E,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1B"}

package/dist/runtime/user-input-builder.d.ts

@@ -0,0 +1,24 @@
+/**
+ * User-input / first-turn content assembler.
+ *
+ * @see PLAN.md §3.1 — moved from `packages/agents/src/utils/agent-input.ts`.
+ * @see PLAN.md §3.2.4 — called from the `Agent.run/continue` facade via
+ *                      the `buildInitialUserContent` helper.
+ *
+ * Pure port. Opens the first user ContentBlock[] for a turn, loading user
+ * file contents via the injected `userFileContentLoader` (already
+ * core-owned per §3.1 notes on `packages/core/src/transports/local.ts`).
+ */
+import type * as LlmsProviders from "@clinebot/llms";
+export declare function buildInitialUserContent(userMessage: string, userImages?: string[], userFiles?: string[], userFileContentLoader?: (path: string) => Promise<string>): Promise<string | LlmsProviders.ContentBlock[]>;
+/**
+ * Normalize a user message shape into a plain string when possible.
+ *
+ * @see PLAN.md §3.1 — exported from the user-input-builder module so
+ *                    SessionRuntime can use it to sanitise ad-hoc input.
+ *
+ * Accepts either a string or a LlmsProviders.Message; returns the best-effort
+ * concatenated plain-text body. Non-text content is ignored.
+ */
+export declare function normalizeUserMessage(input: string | LlmsProviders.Message | undefined): string;
+//# sourceMappingURL=user-input-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"user-input-builder.d.ts","sourceRoot":"","sources":["../../src/runtime/user-input-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,KAAK,aAAa,MAAM,gBAAgB,CAAC;AAErD,wBAAsB,uBAAuB,CAC5C,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,SAAS,CAAC,EAAE,MAAM,EAAE,EACpB,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACvD,OAAO,CAAC,MAAM,GAAG,aAAa,CAAC,YAAY,EAAE,CAAC,CAsBhD;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,OAAO,GAAG,SAAS,GAC/C,MAAM,CAwBR"}