@theokit/sdk 2.9.0 → 2.11.0

package/dist/{cron-CRPY-aKq.d.cts → cron-BNI8pyn_.d.cts}

@@ -847,6 +847,120 @@ interface SDKProvider {
     setupSchema: object;
 }
 
+/**
+ * ProviderProfile + ApiMode types (T3.1, ADR D105).
+ *
+ * Profile is **data-only** — no methods. Adding a provider is declaring an
+ * object literal; the Transport layer (D106) consumes `apiMode` to pick
+ * the HTTP dialect.
+ *
+ * @public
+ */
+type ApiMode = "chat_completions" | "anthropic_messages" | "responses_api" | "bedrock" | "bedrock_anthropic";
+type AuthType = "api_key" | "oauth_device_code" | "oauth_external" | "aws_sdk" | "aws_bearer" | "gcp_oauth" | "none";
+interface ProviderProfile {
+    name: string;
+    apiMode: ApiMode;
+    aliases?: ReadonlyArray<string>;
+    displayName?: string;
+    description?: string;
+    signupUrl?: string;
+    envVars: ReadonlyArray<string>;
+    authType: AuthType;
+    baseUrl: string;
+    modelsUrl?: string;
+    hostname?: string;
+    fallbackModels: ReadonlyArray<string>;
+    extraHeaders?: Record<string, string>;
+    bodyOverrides?: Record<string, unknown>;
+}
+
+type HookName = "pre_tool_call" | "post_tool_call" | "pre_llm_call" | "post_llm_call" | "on_session_start" | "on_session_end" | "transform_tool_result" | "transform_llm_output" | "pre_user_send" | "post_assistant_reply";
+interface PreToolCallContext {
+    name: string;
+    args: Record<string, unknown>;
+    agentId: string;
+    runId: string;
+}
+interface PreToolCallDecision {
+    block: true;
+    message: string;
+}
+/**
+ * Context passed to `pre_user_send` hook handlers (ADR D145).
+ *
+ * @public
+ */
+interface PreUserSendContext {
+    prompt: string;
+    agentId: string;
+    runId: string;
+    /** Caller-supplied memory context, flowing through from `AgentOptions.memoryContext`. */
+    memoryContext?: MemoryContext;
+    /** Forwarded `AbortSignal` so adapter recall HTTP can be cancelled mid-flight (EC-H). */
+    signal?: AbortSignal;
+}
+/**
+ * Optional result returned by `pre_user_send` handlers. The agent loop
+ * concatenates `recalledContext` from all handlers and injects it as a
+ * `<memory-context>...</memory-context>` block before the user prompt.
+ *
+ * @public
+ */
+interface PreUserSendResult {
+    recalledContext?: string;
+}
+/**
+ * Context passed to `post_assistant_reply` hook handlers (ADR D145).
+ * Fire-and-forget — exceptions are caught and surfaced to stderr; the
+ * caller's `wait()` never blocks on this dispatch.
+ *
+ * @public
+ */
+interface PostAssistantReplyContext {
+    prompt: string;
+    reply: string;
+    agentId: string;
+    runId: string;
+    memoryContext?: MemoryContext;
+}
+type HookHandler = (ctx: unknown) => unknown | Promise<unknown>;
+type CommandHandler = (args: Record<string, unknown>) => Promise<string> | string;
+interface CommandOptions {
+    description?: string;
+}
+interface PluginContext {
+    /** Register a custom tool. Equivalent to passing in `AgentOptions.tools`. */
+    registerTool(tool: CustomTool): void;
+    /** Register a slash-command-style handler. Consumed by CLI/bot wrappers; NOT used by the agent loop. */
+    registerCommand(name: string, handler: CommandHandler, opts?: CommandOptions): void;
+    /** Attach a hook handler. `pre_tool_call` supports veto via `PreToolCallDecision`. */
+    on(hook: HookName, handler: HookHandler): void;
+    /** Inject a user/system message into the next agent turn. v1 supports only `on_session_start` context. */
+    injectMessage(content: string, role?: "user" | "system"): void;
+}
+interface BasePlugin {
+    name: string;
+    version: string;
+}
+type Plugin = (BasePlugin & {
+    kind: "general";
+    register: (ctx: PluginContext) => void | Promise<void>;
+}) | (BasePlugin & {
+    kind: "model-provider";
+    profile: ProviderProfile;
+}) | (BasePlugin & {
+    kind: "memory";
+    createProvider: MemoryProviderFactory;
+});
+/**
+ * Identity helper for plugin authors. TS-only convenience — preserves
+ * inferred type without forcing manual `Plugin` annotation.
+ *
+ * @public
+ */
+declare function definePlugin<P extends Plugin>(p: P): P;
+
 /**
  * Which on-disk settings layers a local agent loads.
  *
@@ -1149,8 +1263,19 @@ interface AgentOptions {
     context?: ContextSettings;
     /** Provider routing configuration. See `agent.providers`. */
     providers?: ProviderRoutingSettings;
-    /** Plugins to enable. Plugin sources must also be active via `local.settingSources`. */
-    plugins?: PluginsSettings;
+    /**
+     * Plugins for this agent, in one of two forms:
+     *
+     * - **Named-enable settings** — `{ enabled: ["name", ...] }`. Selects which
+     *   file-discovered plugin providers (under `.theokit/plugins/`) are active.
+     *   Plugin sources must also be active via `local.settingSources`.
+     * - **Code `Plugin` objects** — an array of `Plugin` instances, e.g.
+     *   `plugins: [Handoff.asPlugin({ ... })]`. These are registered directly by
+     *   the runtime (`extractCodePlugins`); no `settingSources` entry is needed.
+     *
+     * The two forms are mutually exclusive — pass one or the other.
+     */
+    plugins?: PluginsSettings | readonly Plugin[];
     /** Skills configuration. See `agent.skills`. */
     skills?: SkillsSettings;
     /** Memory configuration. Persists durable facts; auto-recalled on send. */
@@ -1866,4 +1991,4 @@ declare class Cron {
     static status(_options?: CronStartOptions): Promise<CronSchedulerStatus>;
 }
 
-export { type MemoryAdapter as $, type AgentOptions as A, type BudgetTracker as B, type CloudOptions as C, type ContextManagerKind as D, type ContextSnapshot as E, type ContextSource as F, type GetAgentOptions as G, type ContextSourceStatus as H, Cron as I, type CronCreateOptions as J, type CronGetOptions as K, type LocalOptions as L, type MemorySettings as M, type CronJob as N, type CronJobStatus as O, type ProviderRoutingSettings as P, type CronListOptions as Q, type CronOperationOptions as R, type SystemPromptResolver as S, type CronRunOptions as T, type CronRuntime as U, type CronSchedulerStatus as V, type CronStartOptions as W, type GoalEvent as X, type GoalOptions as Y, type GoalResult as Z, type InvalidateCacheOptions as _, type AgentDefinition as a, type MemoryAdapterCapabilities as a0, type MemoryFact as a1, type MemoryProviderHandle as a2, type MemoryProviderInitOptions as a3, type MemoryRevision as a4, type MemoryToolSchema as a5, type MemoryTurnMessage as a6, type PersonalityPreset as a7, type ProviderCapability as a8, type ProviderRoute as a9, type RecordSessionSummaryArgs as aa, type ResolvedProviderRoute as ab, type RunUntilIterator as ac, type SDKAgentPlugins as ad, type SDKAgentSkills as ae, type SDKArtifact as af, type SDKContextManager as ag, type SDKPluginMetadata as ah, type SDKProvidersManager as ai, type SettingSource as aj, type SystemPromptContext as ak, type SystemPromptMemoryFact as al, type SystemPromptSkillRef as am, type TelemetrySettings as an, type ContextSettings as b, type PluginsSettings as c, type SkillsSettings as d, type SDKAgent as e, type ListAgentsOptions as f, type ListResult as g, type SDKAgentInfo as h, type ListRunsOptions as i, type GetRunOptions as j, type AgentOperationOptions as k, type MemoryContext as l, type ConversationStorageAdapter as m, type StoredMessage as n, type MemoryProvider as o, type MemoryId as p, type SDKProvider as q, type ActiveMemoryPassArgs as r, type ActiveMemoryPassResult as s, type AgentMemory as t, type BudgetCheck as u, type BudgetTotal as v, type BudgetUsageEvent as w, type CloudEnv as x, type CloudRepo as y, type ContextBudget as z };
+export { type GoalResult as $, type AgentOptions as A, type BudgetTracker as B, type CloudOptions as C, type CloudRepo as D, type ContextBudget as E, type ContextManagerKind as F, type GetAgentOptions as G, type ContextSnapshot as H, type ContextSource as I, type ContextSourceStatus as J, Cron as K, type LocalOptions as L, type MemorySettings as M, type CronCreateOptions as N, type CronGetOptions as O, type ProviderRoutingSettings as P, type CronJob as Q, type CronJobStatus as R, type SystemPromptResolver as S, type CronListOptions as T, type CronOperationOptions as U, type CronRunOptions as V, type CronRuntime as W, type CronSchedulerStatus as X, type CronStartOptions as Y, type GoalEvent as Z, type GoalOptions as _, type AgentDefinition as a, type HookName as a0, type InvalidateCacheOptions as a1, type MemoryAdapter as a2, type MemoryAdapterCapabilities as a3, type MemoryContext as a4, type MemoryFact as a5, type MemoryProviderHandle as a6, type MemoryProviderInitOptions as a7, type MemoryRevision as a8, type MemoryToolSchema as a9, type MemoryTurnMessage as aa, type PersonalityPreset as ab, type PluginContext as ac, type PostAssistantReplyContext as ad, type PreToolCallContext as ae, type PreUserSendContext as af, type PreUserSendResult as ag, type ProviderCapability as ah, type ProviderRoute as ai, type RecordSessionSummaryArgs as aj, type ResolvedProviderRoute as ak, type RunUntilIterator as al, type SDKAgentPlugins as am, type SDKAgentSkills as an, type SDKArtifact as ao, type SDKContextManager as ap, type SDKPluginMetadata as aq, type SDKProvidersManager as ar, type SettingSource as as, type SystemPromptContext as at, type SystemPromptMemoryFact as au, type SystemPromptSkillRef as av, type TelemetrySettings as aw, definePlugin as ax, type ContextSettings as b, type PluginsSettings as c, type SkillsSettings as d, type SDKAgent as e, type ListAgentsOptions as f, type ListResult as g, type SDKAgentInfo as h, type ListRunsOptions as i, type GetRunOptions as j, type AgentOperationOptions as k, type ProviderProfile as l, type Plugin as m, type ConversationStorageAdapter as n, type StoredMessage as o, type MemoryProvider as p, type MemoryId as q, type PreToolCallDecision as r, type SDKProvider as s, type ActiveMemoryPassArgs as t, type ActiveMemoryPassResult as u, type AgentMemory as v, type BudgetCheck as w, type BudgetTotal as x, type BudgetUsageEvent as y, type CloudEnv as z };

package/dist/{cron-Bhp8rP8i.d.ts → cron-CZlMLA1K.d.ts}

@@ -847,6 +847,120 @@ interface SDKProvider {
     setupSchema: object;
 }
 
+/**
+ * ProviderProfile + ApiMode types (T3.1, ADR D105).
+ *
+ * Profile is **data-only** — no methods. Adding a provider is declaring an
+ * object literal; the Transport layer (D106) consumes `apiMode` to pick
+ * the HTTP dialect.
+ *
+ * @public
+ */
+type ApiMode = "chat_completions" | "anthropic_messages" | "responses_api" | "bedrock" | "bedrock_anthropic";
+type AuthType = "api_key" | "oauth_device_code" | "oauth_external" | "aws_sdk" | "aws_bearer" | "gcp_oauth" | "none";
+interface ProviderProfile {
+    name: string;
+    apiMode: ApiMode;
+    aliases?: ReadonlyArray<string>;
+    displayName?: string;
+    description?: string;
+    signupUrl?: string;
+    envVars: ReadonlyArray<string>;
+    authType: AuthType;
+    baseUrl: string;
+    modelsUrl?: string;
+    hostname?: string;
+    fallbackModels: ReadonlyArray<string>;
+    extraHeaders?: Record<string, string>;
+    bodyOverrides?: Record<string, unknown>;
+}
+
+type HookName = "pre_tool_call" | "post_tool_call" | "pre_llm_call" | "post_llm_call" | "on_session_start" | "on_session_end" | "transform_tool_result" | "transform_llm_output" | "pre_user_send" | "post_assistant_reply";
+interface PreToolCallContext {
+    name: string;
+    args: Record<string, unknown>;
+    agentId: string;
+    runId: string;
+}
+interface PreToolCallDecision {
+    block: true;
+    message: string;
+}
+/**
+ * Context passed to `pre_user_send` hook handlers (ADR D145).
+ *
+ * @public
+ */
+interface PreUserSendContext {
+    prompt: string;
+    agentId: string;
+    runId: string;
+    /** Caller-supplied memory context, flowing through from `AgentOptions.memoryContext`. */
+    memoryContext?: MemoryContext;
+    /** Forwarded `AbortSignal` so adapter recall HTTP can be cancelled mid-flight (EC-H). */
+    signal?: AbortSignal;
+}
+/**
+ * Optional result returned by `pre_user_send` handlers. The agent loop
+ * concatenates `recalledContext` from all handlers and injects it as a
+ * `<memory-context>...</memory-context>` block before the user prompt.
+ *
+ * @public
+ */
+interface PreUserSendResult {
+    recalledContext?: string;
+}
+/**
+ * Context passed to `post_assistant_reply` hook handlers (ADR D145).
+ * Fire-and-forget — exceptions are caught and surfaced to stderr; the
+ * caller's `wait()` never blocks on this dispatch.
+ *
+ * @public
+ */
+interface PostAssistantReplyContext {
+    prompt: string;
+    reply: string;
+    agentId: string;
+    runId: string;
+    memoryContext?: MemoryContext;
+}
+type HookHandler = (ctx: unknown) => unknown | Promise<unknown>;
+type CommandHandler = (args: Record<string, unknown>) => Promise<string> | string;
+interface CommandOptions {
+    description?: string;
+}
+interface PluginContext {
+    /** Register a custom tool. Equivalent to passing in `AgentOptions.tools`. */
+    registerTool(tool: CustomTool): void;
+    /** Register a slash-command-style handler. Consumed by CLI/bot wrappers; NOT used by the agent loop. */
+    registerCommand(name: string, handler: CommandHandler, opts?: CommandOptions): void;
+    /** Attach a hook handler. `pre_tool_call` supports veto via `PreToolCallDecision`. */
+    on(hook: HookName, handler: HookHandler): void;
+    /** Inject a user/system message into the next agent turn. v1 supports only `on_session_start` context. */
+    injectMessage(content: string, role?: "user" | "system"): void;
+}
+interface BasePlugin {
+    name: string;
+    version: string;
+}
+type Plugin = (BasePlugin & {
+    kind: "general";
+    register: (ctx: PluginContext) => void | Promise<void>;
+}) | (BasePlugin & {
+    kind: "model-provider";
+    profile: ProviderProfile;
+}) | (BasePlugin & {
+    kind: "memory";
+    createProvider: MemoryProviderFactory;
+});
+/**
+ * Identity helper for plugin authors. TS-only convenience — preserves
+ * inferred type without forcing manual `Plugin` annotation.
+ *
+ * @public
+ */
+declare function definePlugin<P extends Plugin>(p: P): P;
+
 /**
  * Which on-disk settings layers a local agent loads.
  *
@@ -1149,8 +1263,19 @@ interface AgentOptions {
     context?: ContextSettings;
     /** Provider routing configuration. See `agent.providers`. */
     providers?: ProviderRoutingSettings;
-    /** Plugins to enable. Plugin sources must also be active via `local.settingSources`. */
-    plugins?: PluginsSettings;
+    /**
+     * Plugins for this agent, in one of two forms:
+     *
+     * - **Named-enable settings** — `{ enabled: ["name", ...] }`. Selects which
+     *   file-discovered plugin providers (under `.theokit/plugins/`) are active.
+     *   Plugin sources must also be active via `local.settingSources`.
+     * - **Code `Plugin` objects** — an array of `Plugin` instances, e.g.
+     *   `plugins: [Handoff.asPlugin({ ... })]`. These are registered directly by
+     *   the runtime (`extractCodePlugins`); no `settingSources` entry is needed.
+     *
+     * The two forms are mutually exclusive — pass one or the other.
+     */
+    plugins?: PluginsSettings | readonly Plugin[];
     /** Skills configuration. See `agent.skills`. */
     skills?: SkillsSettings;
     /** Memory configuration. Persists durable facts; auto-recalled on send. */
@@ -1866,4 +1991,4 @@ declare class Cron {
     static status(_options?: CronStartOptions): Promise<CronSchedulerStatus>;
 }
 
-export { type MemoryAdapter as $, type AgentOptions as A, type BudgetTracker as B, type CloudOptions as C, type ContextManagerKind as D, type ContextSnapshot as E, type ContextSource as F, type GetAgentOptions as G, type ContextSourceStatus as H, Cron as I, type CronCreateOptions as J, type CronGetOptions as K, type LocalOptions as L, type MemorySettings as M, type CronJob as N, type CronJobStatus as O, type ProviderRoutingSettings as P, type CronListOptions as Q, type CronOperationOptions as R, type SystemPromptResolver as S, type CronRunOptions as T, type CronRuntime as U, type CronSchedulerStatus as V, type CronStartOptions as W, type GoalEvent as X, type GoalOptions as Y, type GoalResult as Z, type InvalidateCacheOptions as _, type AgentDefinition as a, type MemoryAdapterCapabilities as a0, type MemoryFact as a1, type MemoryProviderHandle as a2, type MemoryProviderInitOptions as a3, type MemoryRevision as a4, type MemoryToolSchema as a5, type MemoryTurnMessage as a6, type PersonalityPreset as a7, type ProviderCapability as a8, type ProviderRoute as a9, type RecordSessionSummaryArgs as aa, type ResolvedProviderRoute as ab, type RunUntilIterator as ac, type SDKAgentPlugins as ad, type SDKAgentSkills as ae, type SDKArtifact as af, type SDKContextManager as ag, type SDKPluginMetadata as ah, type SDKProvidersManager as ai, type SettingSource as aj, type SystemPromptContext as ak, type SystemPromptMemoryFact as al, type SystemPromptSkillRef as am, type TelemetrySettings as an, type ContextSettings as b, type PluginsSettings as c, type SkillsSettings as d, type SDKAgent as e, type ListAgentsOptions as f, type ListResult as g, type SDKAgentInfo as h, type ListRunsOptions as i, type GetRunOptions as j, type AgentOperationOptions as k, type MemoryContext as l, type ConversationStorageAdapter as m, type StoredMessage as n, type MemoryProvider as o, type MemoryId as p, type SDKProvider as q, type ActiveMemoryPassArgs as r, type ActiveMemoryPassResult as s, type AgentMemory as t, type BudgetCheck as u, type BudgetTotal as v, type BudgetUsageEvent as w, type CloudEnv as x, type CloudRepo as y, type ContextBudget as z };
+export { type GoalResult as $, type AgentOptions as A, type BudgetTracker as B, type CloudOptions as C, type CloudRepo as D, type ContextBudget as E, type ContextManagerKind as F, type GetAgentOptions as G, type ContextSnapshot as H, type ContextSource as I, type ContextSourceStatus as J, Cron as K, type LocalOptions as L, type MemorySettings as M, type CronCreateOptions as N, type CronGetOptions as O, type ProviderRoutingSettings as P, type CronJob as Q, type CronJobStatus as R, type SystemPromptResolver as S, type CronListOptions as T, type CronOperationOptions as U, type CronRunOptions as V, type CronRuntime as W, type CronSchedulerStatus as X, type CronStartOptions as Y, type GoalEvent as Z, type GoalOptions as _, type AgentDefinition as a, type HookName as a0, type InvalidateCacheOptions as a1, type MemoryAdapter as a2, type MemoryAdapterCapabilities as a3, type MemoryContext as a4, type MemoryFact as a5, type MemoryProviderHandle as a6, type MemoryProviderInitOptions as a7, type MemoryRevision as a8, type MemoryToolSchema as a9, type MemoryTurnMessage as aa, type PersonalityPreset as ab, type PluginContext as ac, type PostAssistantReplyContext as ad, type PreToolCallContext as ae, type PreUserSendContext as af, type PreUserSendResult as ag, type ProviderCapability as ah, type ProviderRoute as ai, type RecordSessionSummaryArgs as aj, type ResolvedProviderRoute as ak, type RunUntilIterator as al, type SDKAgentPlugins as am, type SDKAgentSkills as an, type SDKArtifact as ao, type SDKContextManager as ap, type SDKPluginMetadata as aq, type SDKProvidersManager as ar, type SettingSource as as, type SystemPromptContext as at, type SystemPromptMemoryFact as au, type SystemPromptSkillRef as av, type TelemetrySettings as aw, definePlugin as ax, type ContextSettings as b, type PluginsSettings as c, type SkillsSettings as d, type SDKAgent as e, type ListAgentsOptions as f, type ListResult as g, type SDKAgentInfo as h, type ListRunsOptions as i, type GetRunOptions as j, type AgentOperationOptions as k, type ProviderProfile as l, type Plugin as m, type ConversationStorageAdapter as n, type StoredMessage as o, type MemoryProvider as p, type MemoryId as q, type PreToolCallDecision as r, type SDKProvider as s, type ActiveMemoryPassArgs as t, type ActiveMemoryPassResult as u, type AgentMemory as v, type BudgetCheck as w, type BudgetTotal as x, type BudgetUsageEvent as y, type CloudEnv as z };

package/dist/cron.cjs

@@ -3296,6 +3296,18 @@ async function writeVersionedJson(path, data2, currentVersion) {
   await atomicWriteJson(path, file);
 }
 
+// src/internal/plugins/enabled-names.ts
+function isPluginArray(plugins) {
+  return Array.isArray(plugins);
+}
+function asPluginsSettings(plugins) {
+  if (plugins === void 0) return void 0;
+  return isPluginArray(plugins) ? void 0 : plugins;
+}
+function enabledPluginNames(plugins) {
+  return asPluginsSettings(plugins)?.enabled ?? [];
+}
+
 // src/internal/runtime/registry/agent-registry-store.ts
 var SCHEMA_VERSION = 1;
 var LEGACY_SCHEMA_VERSION_STRING = "1.0";
@@ -3309,7 +3321,9 @@ function stripSecretsFromOptions(options) {
     cloud: serializeCloud(options.cloud),
     memory: serializeMemory(options.memory),
     skills: serializeEnabledList(options.skills),
-    plugins: serializeEnabledList(options.plugins),
+    // Code-`Plugin` objects are closures and cannot be persisted (like custom
+    // tools); only the named-enable settings form is serialized.
+    plugins: serializeEnabledList(asPluginsSettings(options.plugins)),
     context: serializeContext(options.context),
     providers: serializeProviders(options.providers),
     agents: serializeAgents(options.agents)
@@ -3617,8 +3631,9 @@ function serializeSkills(skills) {
   return { enabled: [...skills.enabled] };
 }
 function serializePlugins(plugins) {
-  if (plugins?.enabled === void 0 || plugins.enabled.length === 0) return void 0;
-  return { enabled: [...plugins.enabled] };
+  const enabled = enabledPluginNames(plugins);
+  if (enabled.length === 0) return void 0;
+  return { enabled: [...enabled] };
 }
 function serializeMcp(mcpServers) {
   if (mcpServers === void 0) return void 0;
@@ -3801,11 +3816,8 @@ function defaultLocalTools(request) {
       tools.push(`mcp_${sanitizeMcpName(name)}_call`);
     }
   }
-  const plugins = request.agentOptions.plugins;
-  if (plugins?.enabled !== void 0) {
-    for (const _pluginName of plugins.enabled) {
-      tools.push("mcp_search_provider_web_search");
-    }
+  for (const _pluginName of enabledPluginNames(request.agentOptions.plugins)) {
+    tools.push("mcp_search_provider_web_search");
   }
   return tools;
 }
@@ -7048,7 +7060,7 @@ function resolveRoute(route, modelProvider, plugins) {
     if (modelName !== void 0) base.model = modelName;
     return base;
   }
-  if (plugins?.enabled !== void 0 && plugins.enabled.length > 0) {
+  if (enabledPluginNames(plugins).length > 0) {
     return {
       capability: route.capability,
       provider: route.provider,
@@ -8051,7 +8063,7 @@ function bootstrapSubmanagers(args) {
       args.settingSourcesIncludeProject
     );
   }
-  const providerCount = (args.options.providers?.routes?.length ?? 0) + (args.options.plugins?.enabled?.length ?? 0);
+  const providerCount = (args.options.providers?.routes?.length ?? 0) + enabledPluginNames(args.options.plugins).length;
   if (providerCount > 0 || args.options.providers !== void 0) {
     out.providers = new ProvidersManagerImpl(
       args.options.model,
@@ -8071,7 +8083,9 @@ function bootstrapSubmanagers(args) {
   if (args.options.plugins !== void 0 || args.settingSourcesIncludePlugins) {
     out.pluginsManager = new PluginsManager(
       args.workspaceCwd,
-      args.options.plugins?.enabled,
+      // The array (code-`Plugin`) form has no named-enable list; `undefined`
+      // here preserves "no filter / load all file-discovered plugins".
+      asPluginsSettings(args.options.plugins)?.enabled,
       args.settingSourcesIncludePlugins,
       false,
       void 0
@@ -15363,7 +15377,7 @@ var Agent = class _Agent {
     const runtime = options.cloud !== void 0 ? "cloud" : "local";
     const span = telemetry.startSpan(SPAN_NAMES.AGENT_CREATE, {
       runtime,
-      pluginCount: options.plugins?.enabled?.length ?? 0
+      pluginCount: enabledPluginNames(options.plugins).length
     });
     try {
       const agent = await runCreateUnderSpan(options, span);