@theokit/sdk 2.9.0 → 2.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -3,6 +3,7 @@ import type { McpServerConfig } from "./mcp.js";
3
3
  import type { PluginsSettings, ProviderRoutingSettings, SDKProvidersManager } from "./providers.js";
4
4
  import type { Run, SDKUserMessage, SendOptions } from "./run.js";
5
5
  export type { CustomTool, ModelParameterValue, ModelSelection } from "./agent-prims.js";
6
+ import type { Plugin } from "../internal/plugins/types.js";
6
7
  import type { CustomTool, ModelSelection } from "./agent-prims.js";
7
8
  /**
8
9
  * Which on-disk settings layers a local agent loads.
@@ -306,8 +307,19 @@ export interface AgentOptions {
306
307
  context?: ContextSettings;
307
308
  /** Provider routing configuration. See `agent.providers`. */
308
309
  providers?: ProviderRoutingSettings;
309
- /** Plugins to enable. Plugin sources must also be active via `local.settingSources`. */
310
- plugins?: PluginsSettings;
310
+ /**
311
+ * Plugins for this agent, in one of two forms:
312
+ *
313
+ * - **Named-enable settings** — `{ enabled: ["name", ...] }`. Selects which
314
+ * file-discovered plugin providers (under `.theokit/plugins/`) are active.
315
+ * Plugin sources must also be active via `local.settingSources`.
316
+ * - **Code `Plugin` objects** — an array of `Plugin` instances, e.g.
317
+ * `plugins: [Handoff.asPlugin({ ... })]`. These are registered directly by
318
+ * the runtime (`extractCodePlugins`); no `settingSources` entry is needed.
319
+ *
320
+ * The two forms are mutually exclusive — pass one or the other.
321
+ */
322
+ plugins?: PluginsSettings | readonly Plugin[];
311
323
  /** Skills configuration. See `agent.skills`. */
312
324
  skills?: SkillsSettings;
313
325
  /** Memory configuration. Persists durable facts; auto-recalled on send. */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@theokit/sdk",
3
- "version": "2.9.0",
3
+ "version": "2.10.0",
4
4
  "description": "TypeScript SDK for the Theo agent harness — same surface, local or cloud.",
5
5
  "license": "Apache-2.0",
6
6
  "homepage": "https://github.com/usetheo/theokit-sdk#readme",