@theokit/sdk 2.18.1 → 2.20.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/agent.d.ts

@@ -178,6 +178,16 @@ export interface SkillsSettings {
      * skills itself.
      */
     autoInject?: boolean;
+    /**
+     * M22 — discover skills from a CUSTOM directory (containing `<name>/SKILL.md`) instead of the
+     * default `<cwd>/.theokit/skills`. Absent ⇒ the default root.
+     */
+    skillsDir?: string;
+    /**
+     * M22 — code-defined skills (from `createSkill`) merged with the discovered ones. An inline skill
+     * overrides a discovered file skill of the same name.
+     */
+    inline?: import("../create-skill.js").InlineSkill[];
 }
 /**
  * Memory configuration accepted by `Agent.create()` via {@link AgentOptions.memory}.

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.20.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",
@@ -308,6 +308,15 @@
     "**/agent.js",
     "**/agent.cjs"
   ],
+  "scripts": {
+    "build": "tsup && cp src/internal/providers/provider-catalog.json dist/provider-catalog.json",
+    "test": "vitest run --no-file-parallelism",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "docs:json": "typedoc --options typedoc.json",
+    "docs:drift": "tsx scripts/check-docs-drift.ts"
+  },
   "peerDependencies": {
     "@lancedb/lancedb": "^0.30.0",
     "@types/ws": ">=8.0.0",
@@ -365,6 +374,8 @@
   "devDependencies": {
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/sdk-trace-base": "^1.30.1",
+    "@theokit/sdk-handoff": "workspace:*",
+    "@theokit/sdk-memory": "workspace:*",
     "@types/better-sqlite3": "^7.6.13",
     "@types/proper-lockfile": "^4.1.4",
     "@types/ws": "^8.18.0",
@@ -374,17 +385,6 @@
     "sqlite-vec": "^0.1.9",
     "typedoc": "^0.28.19",
     "ws": "^8.18.0",
-    "zod": "^4.0.0",
-    "@theokit/sdk-memory": "0.2.0",
-    "@theokit/sdk-handoff": "0.1.0"
-  },
-  "scripts": {
-    "build": "tsup && cp src/internal/providers/provider-catalog.json dist/provider-catalog.json",
-    "test": "vitest run --no-file-parallelism",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "docs:json": "typedoc --options typedoc.json",
-    "docs:drift": "tsx scripts/check-docs-drift.ts"
+    "zod": "^4.0.0"
   }
-}
+}