@clinebot/core 0.0.35 → 0.0.37

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, TeamTeammateSpec, 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,26 +24,9 @@ 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 TeamToolsFactoryOptions {
-    runtime: AgentTeamsRuntime;
-    teammateConfigProvider: DelegatedAgentConfigProvider;
-    createBaseTools?: () => Tool[];
-    leadAgentId?: string;
-    restoredTeammates?: TeamTeammateSpec[];
-    restoredFromPersistence?: boolean;
-    includeLeadSpawnTool?: boolean;
-    includeLeadManagementTools?: boolean;
-    onLeadToolsUnlocked?: (tools: Tool[]) => void;
-}
-export interface TeamToolsFactoryResult {
-    tools: Tool[];
-    restoredFromPersistence: boolean;
-    restoredTeammates: string[];
-}
-export type TeamToolsFactory = (options: TeamToolsFactoryOptions) => TeamToolsFactoryResult;
 export interface RuntimeBuilderInput {
     config: CoreSessionConfig;
     hooks?: AgentHooks;
@@ -41,10 +35,10 @@ export interface RuntimeBuilderInput {
     createSpawnTool?: () => Tool;
     onTeamRestored?: () => void;
     userInstructionWatcher?: UserInstructionConfigWatcher;
+    configExtensions?: RuntimeConfigExtensionKind[];
     defaultToolExecutors?: Partial<ToolExecutors>;
     logger?: BasicLogger;
     telemetry?: ITelemetryService;
-    teamToolsFactory?: TeamToolsFactory;
 }
 export interface RuntimeBuilder {
     build(input: RuntimeBuilderInput): Promise<BuiltRuntime> | BuiltRuntime;
@@ -58,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":"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"}
+{"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"}

package/dist/services/global-settings.d.ts

@@ -0,0 +1,12 @@
+import type { AgentConfig, Tool } from "@clinebot/shared";
+export interface GlobalSettings {
+    disabledTools?: string[];
+}
+export declare function readGlobalSettings(): GlobalSettings;
+export declare function writeGlobalSettings(settings: GlobalSettings): void;
+export declare function resolveDisabledToolNames(disabledToolNames?: ReadonlyArray<string>): Set<string>;
+export declare function isToolDisabledGlobally(toolName: string): boolean;
+export declare function toggleDisabledTool(toolName: string): boolean;
+export declare function filterDisabledTools<T extends Pick<Tool, "name">>(tools: ReadonlyArray<T>, disabledToolNames?: ReadonlyArray<string>): T[];
+export declare function filterExtensionToolRegistrations(extensions: AgentConfig["extensions"], disabledToolNames?: ReadonlyArray<string>): AgentConfig["extensions"];
+//# sourceMappingURL=global-settings.d.ts.map

package/dist/services/global-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-settings.d.ts","sourceRoot":"","sources":["../../src/services/global-settings.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAM1D,MAAM,WAAW,cAAc;IAC9B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAmBD,wBAAgB,kBAAkB,IAAI,cAAc,CAUnD;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAUlE;AAED,wBAAgB,wBAAwB,CACvC,iBAAiB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GACvC,GAAG,CAAC,MAAM,CAAC,CAEb;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAW5D;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAC/D,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,iBAAiB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GACvC,CAAC,EAAE,CAML;AAED,wBAAgB,gCAAgC,CAC/C,UAAU,EAAE,WAAW,CAAC,YAAY,CAAC,EACrC,iBAAiB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GACvC,WAAW,CAAC,YAAY,CAAC,CA+B3B"}