@theokit/sdk 3.5.0 → 3.6.0

package/dist/internal/runtime/local-agent/real-local-run-tools.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Custom-tool assembly for the real local run (extracted from `real-local-run.ts`
+ * for the G8 LoC budget — SRP: everything that builds the effective tool catalog
+ * for a run lives here).
+ *
+ * Merges, in order: caller/agent `tools`, declarative subagent delegation tools
+ * (file-based + inline), plugin tools, and — SE37 — the internal `think` tool when
+ * `reasoning: true` (guarded against a native reasoning model). Binds parent
+ * credentials onto delegation tools and applies the personality whitelist.
+ *
+ * @internal
+ */
+import type { AgentDefinition, AgentOptions, CustomTool, ModelSelection } from "../../../types/agent.js";
+import type { CustomToolSpec } from "../../agent-loop/loop-types.js";
+export declare function buildCustomToolsInput(agentOptions: AgentOptions, sendOptions: {
+    tools?: CustomTool[];
+} | undefined, pluginManager: import("../../plugins/manager.js").PluginManager | undefined, personalityToolWhitelist: ReadonlyArray<string> | undefined, agentId: string, personalityName: string | undefined, subagents: Record<string, AgentDefinition> | undefined, effectiveModel: ModelSelection | undefined): {
+    customTools: ReadonlyArray<CustomToolSpec>;
+} | Record<string, never>;

package/dist/internal/runtime/reasoning/native-reasoning.d.ts

@@ -0,0 +1,25 @@
+/**
+ * SE37 — `reasoning: true` support internals: the CoT preamble + the
+ * double-reasoning guard.
+ *
+ * A native reasoning model (configured with `model.params: [{ id: "thinking" }]`)
+ * already reasons internally, so layering the prompt-based `reasoning: true`
+ * preamble + think tool on top wastes tokens and can degrade output. When a
+ * native reasoning param is detected, `reasoning: true` is INERT (with a
+ * one-time warn) — native reasoning wins.
+ *
+ * @internal
+ */
+import type { ModelSelection } from "../../../types/agent-prims.js";
+/**
+ * The CoT preamble prepended to the system prompt when `reasoning: true` is
+ * active. Steers a non-reasoning model into a reason -> act -> observe loop and
+ * self-validation via the `think` tool. Kept terse (bundle budget).
+ */
+export declare const REASONING_PREAMBLE: string;
+/**
+ * True when the selected model is a native reasoning model — i.e. its `params`
+ * carry a thinking/reasoning id. A bare-string model or one without such a param
+ * is NOT native (returns false), so `reasoning: true` applies to it.
+ */
+export declare function isNativeReasoning(model: ModelSelection | string | undefined): boolean;

package/dist/internal/runtime/system-prompt/sources/reasoning-provider.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/agent.d.ts

@@ -425,6 +425,16 @@ export interface AgentOptions {
      * See {@link CustomTool}.
      */
     tools?: CustomTool[];
+    /**
+     * SE37 — opt-in reasoning. When `true`, the agent gets a chain-of-thought
+     * preamble prepended to its system prompt AND the `think` reasoning tool
+     * auto-attached, turning a non-reasoning model into a reason -> act ->
+     * observe loop (same model; reuses the existing tool loop). Default `false` —
+     * byte-identical behaviour when unset. Inert (with a one-time warn) when a
+     * native reasoning model is configured (`model.params: [{ id: "thinking" }]`),
+     * so native and prompt-based reasoning never stack. See `ReasoningTools` in `@theokit/sdk-tools`.
+     */
+    reasoning?: boolean;
     /**
      * Telemetry (OpenTelemetry) configuration. Default disabled. See
      * {@link TelemetrySettings} and ADR D34.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "3.5.0",
+  "version": "3.6.0",
   "description": "TypeScript SDK for the Theo agent harness — same surface, local or cloud.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/usetheo/theokit-sdk#readme",