@theokit/sdk 5.4.0 → 5.6.0

package/dist/{agent-AUVD4TI4.cjs → agent-47NS6ZVL.cjs}

@@ -1,16 +1,16 @@
 'use strict';
 
-var chunkUALC6Q3J_cjs = require('./chunk-UALC6Q3J.cjs');
+var chunkGCHZMH42_cjs = require('./chunk-GCHZMH42.cjs');
 require('./chunk-KVSAY6NZ.cjs');
 require('./chunk-DZG77WU7.cjs');
 require('./chunk-BUUUWQMB.cjs');
-require('./chunk-Z2JFX372.cjs');
-require('./chunk-3FDU5JFE.cjs');
+require('./chunk-VUHXC74Q.cjs');
+require('./chunk-7IZKTQ5G.cjs');
 require('./chunk-BV2MWEMV.cjs');
 require('./chunk-D6POWE7E.cjs');
 require('./chunk-GHX4P3V2.cjs');
 require('./chunk-TMKTSYDS.cjs');
-require('./chunk-NQTNSHSB.cjs');
+require('./chunk-GFFBXSQT.cjs');
 require('./chunk-7FDKWDA2.cjs');
 require('./chunk-C4ZQPWXJ.cjs');
 require('./chunk-FUSDYC2B.cjs');
@@ -19,7 +19,7 @@ require('./chunk-24SYBZPL.cjs');
 require('./chunk-QOGNZMHD.cjs');
 require('./chunk-YIFFF23U.cjs');
 require('./chunk-2ZPEDVLM.cjs');
-require('./chunk-IU5N5224.cjs');
+require('./chunk-EIOMN5VA.cjs');
 require('./chunk-KRD3GQAA.cjs');
 require('./chunk-RQMCOFAI.cjs');
 require('./chunk-MUUQ2WFJ.cjs');
@@ -28,8 +28,8 @@ require('./chunk-YSTXFWQE.cjs');
 require('./chunk-FRITRLZQ.cjs');
 require('./chunk-NQTD6QOW.cjs');
 require('./chunk-NINIJCHU.cjs');
-require('./chunk-QATRS7JD.cjs');
-require('./chunk-LOHMT36V.cjs');
+require('./chunk-MYJGWS2J.cjs');
+require('./chunk-LD6HASA5.cjs');
 require('./chunk-IJ7M6GOG.cjs');
 require('./chunk-7A6535RA.cjs');
 require('./chunk-SA6K24NB.cjs');
@@ -43,9 +43,9 @@ require('./chunk-BJUJT5ED.cjs');
 require('./chunk-ZF2LDKQQ.cjs');
 require('./chunk-HCT4HPCL.cjs');
 require('./chunk-JLRLCBJ4.cjs');
-require('./chunk-AYA65JA5.cjs');
-require('./chunk-43YXGD3P.cjs');
-require('./chunk-HW7SEELD.cjs');
+require('./chunk-RWPLWMCZ.cjs');
+require('./chunk-TY56BKSK.cjs');
+require('./chunk-QRVS2PRE.cjs');
 require('./chunk-ATT276RD.cjs');
 require('./chunk-3EE6LVWT.cjs');
 require('./chunk-ANMJJD6D.cjs');
@@ -61,7 +61,7 @@ require('./chunk-6LHQPOMI.cjs');
 
 Object.defineProperty(exports, "Agent", {
   enumerable: true,
-  get: function () { return chunkUALC6Q3J_cjs.Agent; }
+  get: function () { return chunkGCHZMH42_cjs.Agent; }
 });
-//# sourceMappingURL=agent-AUVD4TI4.cjs.map
-//# sourceMappingURL=agent-AUVD4TI4.cjs.map
+//# sourceMappingURL=agent-47NS6ZVL.cjs.map
+//# sourceMappingURL=agent-47NS6ZVL.cjs.map

package/dist/{agent-AUVD4TI4.cjs.map → agent-47NS6ZVL.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-AUVD4TI4.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-47NS6ZVL.cjs"}

package/dist/{agent-C1Efo7PI.d.cts → agent-82d_DrCL.d.cts}

@@ -224,6 +224,10 @@ interface Skill$1 {
     source: string;
     category?: string;
     dependencies?: string[];
+    /** `disable-model-invocation: true` — the model is never told this skill exists. */
+    disableModelInvocation?: boolean;
+    /** `user-invocable: false` — carried for a host that has a picker; this SDK has no such surface. */
+    userInvocable?: boolean;
 }
 
 /**
@@ -384,6 +388,28 @@ interface HookApprovalRequest {
     readonly event: HookEvent;
     readonly sourcePath?: string;
     readonly matcher?: string;
+    /**
+     * #637 — the timeout the runtime WILL apply, in milliseconds, default already resolved.
+     *
+     * A config that omits `timeout` still runs under one (30s). Reporting `undefined` there would
+     * make a consumer reimplement this package's default in order to compute the same fingerprint,
+     * and a default duplicated across a boundary is a default that drifts.
+     */
+    readonly timeoutMs: number;
+    /**
+     * #637 — the event key exactly as the config file spelled it (`PreToolUse`), which is NOT
+     * `event` (`preToolUse`).
+     *
+     * A consumer's approval is taken against the file it showed the user, so its stored fingerprint
+     * is over the file's vocabulary. Without this the two sides hash different strings and no hook
+     * can ever be approved — only refused. The literal key rather than a published mapping table,
+     * because a mapping is a second thing to keep in step with the first.
+     *
+     * `string` and not a union of the keys this SDK currently recognises: the vocabulary belongs to
+     * whichever dialect declared the hook, so narrowing it would make adding a dialect a breaking
+     * change to this public type. A consumer hashes it; it does not need to switch on it.
+     */
+    readonly sourceEvent: string;
 }
 /**
  * #631 — a consumer's decision point before this package spawns a hook.
@@ -1029,9 +1055,14 @@ type CompatSource = "claude-code" | "theokit" | CompatSourceAdapter;
  * Reusing the skills you already wrote for another product is a reasonable thing to want, and it is
  * not a reason to hand that product's directory the right to run commands.
  *
+ * `context` is the foreign root's INSTRUCTIONS — `.claude/rules/*.md`. Same risk class as `skills`:
+ * text a cloned repository wrote, entering the system prompt as if the consumer had written it. It
+ * was missing until usetheokit/theokit-sdk#652, so the four surfaces above failed closed while this
+ * one was admitted by a path that consulted no grant at all.
+ *
  * @public
  */
-type CompatSurface = "hooks" | "plugins" | "skills" | "subagents";
+type CompatSurface = "context" | "hooks" | "plugins" | "skills" | "subagents";
 /**
  * A foreign source admitted to named surfaces only.
  *
@@ -1958,4 +1989,4 @@ interface ListResult<T> {
     nextCursor?: string;
 }
 
-export { type SettingSource as $, type AgentOptions as A, type BudgetTracker as B, type CloudOptions as C, type MemoryProviderAgentRef as D, type MemoryProviderFactory as E, type MemoryProviderHandle as F, type GetAgentOptions as G, type HookName as H, type InlineSkill as I, type MemoryProviderInitOptions as J, type PluginContext as K, type LocalOptions as L, type MemorySettings as M, type PluginHookDisposer as N, type PostAssistantReplyContext as O, type Plugin as P, type PostToolCallContext as Q, type PreToolCallContext as R, type SystemPromptResolver as S, type PreUserSendContext as T, type PreUserSendResult as U, type ProviderTransform as V, type ProviderTransformContext as W, type RecordSessionSummaryArgs as X, type SessionLifecycleContext as Y, type SessionRecord as Z, type SessionStore as _, type AgentDefinition as a, Skill as a0, type SkillsResolver as a1, type SkillsResolverContext as a2, type SystemPromptContext as a3, type SystemPromptMemoryFact as a4, type TelemetrySettings as a5, type ToolCallSummary as a6, type ToolResultTransformContext as a7, type TransformContext as a8, type SkillsSettings as b, type ListAgentsOptions as c, type ListResult as d, type SDKAgentInfo as e, type ListRunsOptions as f, type GetRunOptions as g, type AgentOperationOptions as h, type AgentDescription as i, type ProviderProfile as j, type MemoryProvider as k, type PreToolCallDecision as l, type ActiveMemoryPassArgs as m, type ActiveMemoryPassResult as n, type AgentSubagentDescription as o, type AgentToolDescription as p, type BudgetCheck as q, type BudgetTotal as r, type BudgetUsageEvent as s, type BuiltinToolName as t, type CloudEnv as u, type CloudRepo as v, type CompatSource as w, type CompatSourceAdapter as x, type CompatSurface as y, type CreateSkillSpec as z };
+export { type SessionStore as $, type AgentOptions as A, type BudgetTracker as B, type CloudOptions as C, type CreateSkillSpec as D, type MemoryProviderAgentRef as E, type MemoryProviderFactory as F, type GetAgentOptions as G, type HookName as H, type InlineSkill as I, type MemoryProviderHandle as J, type MemoryProviderInitOptions as K, type LocalOptions as L, type MemorySettings as M, type PluginContext as N, type PluginHookDisposer as O, type Plugin as P, type PostAssistantReplyContext as Q, type PostToolCallContext as R, type SystemPromptResolver as S, type PreToolCallContext as T, type PreUserSendContext as U, type PreUserSendResult as V, type ProviderTransform as W, type ProviderTransformContext as X, type RecordSessionSummaryArgs as Y, type SessionLifecycleContext as Z, type SessionRecord as _, type AgentDefinition as a, type SettingSource as a0, Skill as a1, type SkillsResolver as a2, type SkillsResolverContext as a3, type SystemPromptContext as a4, type SystemPromptMemoryFact as a5, type TelemetrySettings as a6, type ToolCallSummary as a7, type ToolResultTransformContext as a8, type TransformContext as a9, type SkillsSettings as b, type ListAgentsOptions as c, type ListResult as d, type SDKAgentInfo as e, type ListRunsOptions as f, type GetRunOptions as g, type AgentOperationOptions as h, type AgentDescription as i, type ProviderProfile as j, type Skill$1 as k, type MemoryProvider as l, type PreToolCallDecision as m, type ActiveMemoryPassArgs as n, type ActiveMemoryPassResult as o, type AgentSubagentDescription as p, type AgentToolDescription as q, type BudgetCheck as r, type BudgetTotal as s, type BudgetUsageEvent as t, type BuiltinToolName as u, type CloudEnv as v, type CloudRepo as w, type CompatSource as x, type CompatSourceAdapter as y, type CompatSurface as z };

package/dist/{agent-Bmy2G_ml.d.ts → agent-G6g-uwcB.d.ts}

@@ -224,6 +224,10 @@ interface Skill$1 {
     source: string;
     category?: string;
     dependencies?: string[];
+    /** `disable-model-invocation: true` — the model is never told this skill exists. */
+    disableModelInvocation?: boolean;
+    /** `user-invocable: false` — carried for a host that has a picker; this SDK has no such surface. */
+    userInvocable?: boolean;
 }
 
 /**
@@ -384,6 +388,28 @@ interface HookApprovalRequest {
     readonly event: HookEvent;
     readonly sourcePath?: string;
     readonly matcher?: string;
+    /**
+     * #637 — the timeout the runtime WILL apply, in milliseconds, default already resolved.
+     *
+     * A config that omits `timeout` still runs under one (30s). Reporting `undefined` there would
+     * make a consumer reimplement this package's default in order to compute the same fingerprint,
+     * and a default duplicated across a boundary is a default that drifts.
+     */
+    readonly timeoutMs: number;
+    /**
+     * #637 — the event key exactly as the config file spelled it (`PreToolUse`), which is NOT
+     * `event` (`preToolUse`).
+     *
+     * A consumer's approval is taken against the file it showed the user, so its stored fingerprint
+     * is over the file's vocabulary. Without this the two sides hash different strings and no hook
+     * can ever be approved — only refused. The literal key rather than a published mapping table,
+     * because a mapping is a second thing to keep in step with the first.
+     *
+     * `string` and not a union of the keys this SDK currently recognises: the vocabulary belongs to
+     * whichever dialect declared the hook, so narrowing it would make adding a dialect a breaking
+     * change to this public type. A consumer hashes it; it does not need to switch on it.
+     */
+    readonly sourceEvent: string;
 }
 /**
  * #631 — a consumer's decision point before this package spawns a hook.
@@ -1029,9 +1055,14 @@ type CompatSource = "claude-code" | "theokit" | CompatSourceAdapter;
  * Reusing the skills you already wrote for another product is a reasonable thing to want, and it is
  * not a reason to hand that product's directory the right to run commands.
  *
+ * `context` is the foreign root's INSTRUCTIONS — `.claude/rules/*.md`. Same risk class as `skills`:
+ * text a cloned repository wrote, entering the system prompt as if the consumer had written it. It
+ * was missing until usetheokit/theokit-sdk#652, so the four surfaces above failed closed while this
+ * one was admitted by a path that consulted no grant at all.
+ *
  * @public
  */
-type CompatSurface = "hooks" | "plugins" | "skills" | "subagents";
+type CompatSurface = "context" | "hooks" | "plugins" | "skills" | "subagents";
 /**
  * A foreign source admitted to named surfaces only.
  *
@@ -1958,4 +1989,4 @@ interface ListResult<T> {
     nextCursor?: string;
 }
 
-export { type SettingSource as $, type AgentOptions as A, type BudgetTracker as B, type CloudOptions as C, type MemoryProviderAgentRef as D, type MemoryProviderFactory as E, type MemoryProviderHandle as F, type GetAgentOptions as G, type HookName as H, type InlineSkill as I, type MemoryProviderInitOptions as J, type PluginContext as K, type LocalOptions as L, type MemorySettings as M, type PluginHookDisposer as N, type PostAssistantReplyContext as O, type Plugin as P, type PostToolCallContext as Q, type PreToolCallContext as R, type SystemPromptResolver as S, type PreUserSendContext as T, type PreUserSendResult as U, type ProviderTransform as V, type ProviderTransformContext as W, type RecordSessionSummaryArgs as X, type SessionLifecycleContext as Y, type SessionRecord as Z, type SessionStore as _, type AgentDefinition as a, Skill as a0, type SkillsResolver as a1, type SkillsResolverContext as a2, type SystemPromptContext as a3, type SystemPromptMemoryFact as a4, type TelemetrySettings as a5, type ToolCallSummary as a6, type ToolResultTransformContext as a7, type TransformContext as a8, type SkillsSettings as b, type ListAgentsOptions as c, type ListResult as d, type SDKAgentInfo as e, type ListRunsOptions as f, type GetRunOptions as g, type AgentOperationOptions as h, type AgentDescription as i, type ProviderProfile as j, type MemoryProvider as k, type PreToolCallDecision as l, type ActiveMemoryPassArgs as m, type ActiveMemoryPassResult as n, type AgentSubagentDescription as o, type AgentToolDescription as p, type BudgetCheck as q, type BudgetTotal as r, type BudgetUsageEvent as s, type BuiltinToolName as t, type CloudEnv as u, type CloudRepo as v, type CompatSource as w, type CompatSourceAdapter as x, type CompatSurface as y, type CreateSkillSpec as z };
+export { type SessionStore as $, type AgentOptions as A, type BudgetTracker as B, type CloudOptions as C, type CreateSkillSpec as D, type MemoryProviderAgentRef as E, type MemoryProviderFactory as F, type GetAgentOptions as G, type HookName as H, type InlineSkill as I, type MemoryProviderHandle as J, type MemoryProviderInitOptions as K, type LocalOptions as L, type MemorySettings as M, type PluginContext as N, type PluginHookDisposer as O, type Plugin as P, type PostAssistantReplyContext as Q, type PostToolCallContext as R, type SystemPromptResolver as S, type PreToolCallContext as T, type PreUserSendContext as U, type PreUserSendResult as V, type ProviderTransform as W, type ProviderTransformContext as X, type RecordSessionSummaryArgs as Y, type SessionLifecycleContext as Z, type SessionRecord as _, type AgentDefinition as a, type SettingSource as a0, Skill as a1, type SkillsResolver as a2, type SkillsResolverContext as a3, type SystemPromptContext as a4, type SystemPromptMemoryFact as a5, type TelemetrySettings as a6, type ToolCallSummary as a7, type ToolResultTransformContext as a8, type TransformContext as a9, type SkillsSettings as b, type ListAgentsOptions as c, type ListResult as d, type SDKAgentInfo as e, type ListRunsOptions as f, type GetRunOptions as g, type AgentOperationOptions as h, type AgentDescription as i, type ProviderProfile as j, type Skill$1 as k, type MemoryProvider as l, type PreToolCallDecision as m, type ActiveMemoryPassArgs as n, type ActiveMemoryPassResult as o, type AgentSubagentDescription as p, type AgentToolDescription as q, type BudgetCheck as r, type BudgetTotal as s, type BudgetUsageEvent as t, type BuiltinToolName as u, type CloudEnv as v, type CloudRepo as w, type CompatSource as x, type CompatSourceAdapter as y, type CompatSurface as z };

package/dist/{agent-MNINE73R.js → agent-JJZM2VIK.js}

@@ -1,14 +1,14 @@
-export { Agent } from './chunk-IKBLU7ZS.js';
+export { Agent } from './chunk-2UXQASTX.js';
 import './chunk-K2VMFZQ5.js';
 import './chunk-2QKV4CGK.js';
 import './chunk-K2BQQ445.js';
-import './chunk-7SZAV6QG.js';
-import './chunk-XD3FS5OI.js';
+import './chunk-7MMTZBTT.js';
+import './chunk-N2KAIZ5D.js';
 import './chunk-2SFBB54R.js';
 import './chunk-55GB6JYQ.js';
 import './chunk-H73MEMQB.js';
 import './chunk-OR6XIWLB.js';
-import './chunk-SADXXGWU.js';
+import './chunk-BZ3YMAMP.js';
 import './chunk-AAEZSPTC.js';
 import './chunk-KZSKIUXZ.js';
 import './chunk-UBR5PWD7.js';
@@ -17,7 +17,7 @@ import './chunk-XB4GI5RZ.js';
 import './chunk-24MGQDK3.js';
 import './chunk-2WXHA33T.js';
 import './chunk-HKCKOAIO.js';
-import './chunk-N6OOOYFZ.js';
+import './chunk-HUDNLFY4.js';
 import './chunk-KVNWIAO4.js';
 import './chunk-SVQIW5RJ.js';
 import './chunk-FD2UT76F.js';
@@ -26,8 +26,8 @@ import './chunk-FJWQP6EE.js';
 import './chunk-NAF4L3T6.js';
 import './chunk-CFE6QF2Q.js';
 import './chunk-6X6ID4MO.js';
-import './chunk-LX7SEXOQ.js';
-import './chunk-2XRAWOZZ.js';
+import './chunk-CA5VUAP3.js';
+import './chunk-5NELQ6LB.js';
 import './chunk-SAGRF4IB.js';
 import './chunk-EH6XD3FY.js';
 import './chunk-UKMBRMGT.js';
@@ -41,9 +41,9 @@ import './chunk-TA3K7SBK.js';
 import './chunk-Q5EWJPRY.js';
 import './chunk-EIQFAOFD.js';
 import './chunk-3JHIFQ4I.js';
-import './chunk-O7L7M42F.js';
-import './chunk-NSLHPAC7.js';
-import './chunk-JNAA4G4H.js';
+import './chunk-T3ZDEYTJ.js';
+import './chunk-X7EUUHXU.js';
+import './chunk-UOLBAPDM.js';
 import './chunk-6M2OIS4Y.js';
 import './chunk-R7WIIPUR.js';
 import './chunk-XYFGKVZ7.js';
@@ -54,5 +54,5 @@ import './chunk-V22DZIXO.js';
 import './chunk-NJWYQWDL.js';
 import './chunk-ALUN2B4W.js';
 import './chunk-CZJ6Q7CW.js';
-//# sourceMappingURL=agent-MNINE73R.js.map
-//# sourceMappingURL=agent-MNINE73R.js.map
+//# sourceMappingURL=agent-JJZM2VIK.js.map
+//# sourceMappingURL=agent-JJZM2VIK.js.map

package/dist/{agent-MNINE73R.js.map → agent-JJZM2VIK.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-MNINE73R.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-JJZM2VIK.js"}