@theokit/sdk 2.18.1 → 2.19.0

package/dist/{run-pE-34AAo.d.cts → run-BgfBWX-z.d.cts}

@@ -77,10 +77,13 @@ interface CustomTool {
      * model). Throws → SDK converts to `tool_result` with `isError: true` and
      * the error `message` as content. #65 — an optional 2nd `ToolContext`
      * argument carries the run's `AbortSignal`; single-argument handlers are
-     * unaffected.
+     * unaffected. M7 — the same `ctx` also carries an optional user `context`
+     * (provided once via `SendOptions.context`), so shared config like a
+     * `projectRoot` is read by every tool instead of baked into each factory.
      */
     handler: (input: Record<string, unknown>, ctx?: {
         signal?: AbortSignal;
+        context?: unknown;
     }) => string | Promise<string>;
 }
 
@@ -918,6 +921,15 @@ interface SendOptions {
      * @public
      */
     signal?: AbortSignal;
+    /**
+     * M7 — an opaque user `context` forwarded to every tool handler's `ctx.context`
+     * for this run. Set shared config (e.g. `projectRoot`) once here instead of
+     * baking it into each tool factory (mirrors ai-sdk `experimental_context`,
+     * mastra `RuntimeContext`, openai-agents-js `RunContext`).
+     *
+     * @public
+     */
+    context?: unknown;
     /**
      * #58 — per-tool execution timeout in ms. Each tool call is bounded by this
      * deadline (merged with `signal`); a hung tool yields a typed timeout result

package/dist/{run-pE-34AAo.d.ts → run-BgfBWX-z.d.ts}

@@ -77,10 +77,13 @@ interface CustomTool {
      * model). Throws → SDK converts to `tool_result` with `isError: true` and
      * the error `message` as content. #65 — an optional 2nd `ToolContext`
      * argument carries the run's `AbortSignal`; single-argument handlers are
-     * unaffected.
+     * unaffected. M7 — the same `ctx` also carries an optional user `context`
+     * (provided once via `SendOptions.context`), so shared config like a
+     * `projectRoot` is read by every tool instead of baked into each factory.
      */
     handler: (input: Record<string, unknown>, ctx?: {
         signal?: AbortSignal;
+        context?: unknown;
     }) => string | Promise<string>;
 }
 
@@ -918,6 +921,15 @@ interface SendOptions {
      * @public
      */
     signal?: AbortSignal;
+    /**
+     * M7 — an opaque user `context` forwarded to every tool handler's `ctx.context`
+     * for this run. Set shared config (e.g. `projectRoot`) once here instead of
+     * baking it into each tool factory (mirrors ai-sdk `experimental_context`,
+     * mastra `RuntimeContext`, openai-agents-js `RunContext`).
+     *
+     * @public
+     */
+    context?: unknown;
     /**
      * #58 — per-tool execution timeout in ms. Each tool call is bounded by this
      * deadline (merged with `signal`); a hung tool yields a typed timeout result

package/dist/types/agent-prims.d.ts

@@ -57,9 +57,12 @@ export interface CustomTool {
      * model). Throws → SDK converts to `tool_result` with `isError: true` and
      * the error `message` as content. #65 — an optional 2nd `ToolContext`
      * argument carries the run's `AbortSignal`; single-argument handlers are
-     * unaffected.
+     * unaffected. M7 — the same `ctx` also carries an optional user `context`
+     * (provided once via `SendOptions.context`), so shared config like a
+     * `projectRoot` is read by every tool instead of baked into each factory.
      */
     handler: (input: Record<string, unknown>, ctx?: {
         signal?: AbortSignal;
+        context?: unknown;
     }) => string | Promise<string>;
 }

package/dist/types/run.d.ts

@@ -268,6 +268,15 @@ export interface SendOptions {
      * @public
      */
     signal?: AbortSignal;
+    /**
+     * M7 — an opaque user `context` forwarded to every tool handler's `ctx.context`
+     * for this run. Set shared config (e.g. `projectRoot`) once here instead of
+     * baking it into each tool factory (mirrors ai-sdk `experimental_context`,
+     * mastra `RuntimeContext`, openai-agents-js `RunContext`).
+     *
+     * @public
+     */
+    context?: unknown;
     /**
      * #58 — per-tool execution timeout in ms. Each tool call is bounded by this
      * deadline (merged with `signal`); a hung tool yields a typed timeout result

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "2.18.1",
+  "version": "2.19.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",