@theokit/sdk 5.9.0 → 5.9.1

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 5.9.1
+
+### Patch Changes
+
+- [#694](https://github.com/usetheokit/theokit-sdk/pull/694) [`aa2a04a`](https://github.com/usetheokit/theokit-sdk/commit/aa2a04a1c08514b0ea47d779640fc37f119cd21b) Thanks [@usetheodev](https://github.com/usetheodev)! - The README documents the shape of `.theokit/hooks.json`, which it previously told a consumer to
+  validate against and did not show. The sentence *"read and validated here, against the shape above"*
+  had no shape above it — the section stated where the file is read from and never what goes in it, so
+  the one thing a consumer needs in order to exercise the gate that guards it was missing
+  (usetheokit/theokit-sdk#638).
+  
+  What is documented is read from the loader rather than restated beside it: the JSON shape, the three
+  fields a hook entry may carry (`type`, `command`, `timeout`), the seven Claude Code fields refused
+  with a named error rather than dropped, the four events that actually fire, and the nested
+  `hookSpecificOutput.permissionDecision` deny shape with `ask` projecting to deny.
+  
+  `tests/the-readme-hooks-shape-matches-the-loader.test.ts` holds it there, reading
+  `CLAUDE_CODE_EVENT_MAP`, `ACCEPTED_HOOK_FIELDS` and `UNIMPLEMENTED_CLAUDE_CODE_HOOK_FIELDS` from the
+  loader — the last two newly exported for that purpose, from a module that is already `@internal`, on
+  the precedent `CLAUDE_CODE_EVENT_MAP` set when it was exported so the supported set would be derived
+  rather than asserted.
+  
+  Each list is read from its own sentence rather than from the section. The first version of the test
+  asserted the section contained `` `if` `` and passed after `if` was deleted from the refused list,
+  because the next sentence happens to mention it — a green assertion for a reason unrelated to its
+  claim, which is the same defect one level up.
+
 ## 5.9.0
 
 ### Minor Changes

package/dist/{agent-ZM4FDDL7.cjs → agent-5M7WLUWH.cjs}

@@ -1,11 +1,11 @@
 'use strict';
 
-var chunkBM6PDJW3_cjs = require('./chunk-BM6PDJW3.cjs');
+var chunk56BCEM26_cjs = require('./chunk-56BCEM26.cjs');
 require('./chunk-J6GXS5A2.cjs');
 require('./chunk-PSLCVSCS.cjs');
 require('./chunk-BUUUWQMB.cjs');
 require('./chunk-TTBIQTO5.cjs');
-require('./chunk-J4SA2ZEJ.cjs');
+require('./chunk-KIKKTW5O.cjs');
 require('./chunk-BV2MWEMV.cjs');
 require('./chunk-MEUBLCM4.cjs');
 require('./chunk-GHX4P3V2.cjs');
@@ -19,8 +19,8 @@ require('./chunk-WPO3VCY4.cjs');
 require('./chunk-QOGNZMHD.cjs');
 require('./chunk-YIFFF23U.cjs');
 require('./chunk-2ZPEDVLM.cjs');
-require('./chunk-KTA7YTZQ.cjs');
-require('./chunk-OCEQ6DW2.cjs');
+require('./chunk-XKZFIP7Z.cjs');
+require('./chunk-N6OEX5TN.cjs');
 require('./chunk-KRD3GQAA.cjs');
 require('./chunk-RQMCOFAI.cjs');
 require('./chunk-MUUQ2WFJ.cjs');
@@ -62,7 +62,7 @@ require('./chunk-6LHQPOMI.cjs');
 
 Object.defineProperty(exports, "Agent", {
   enumerable: true,
-  get: function () { return chunkBM6PDJW3_cjs.Agent; }
+  get: function () { return chunk56BCEM26_cjs.Agent; }
 });
-//# sourceMappingURL=agent-ZM4FDDL7.cjs.map
-//# sourceMappingURL=agent-ZM4FDDL7.cjs.map
+//# sourceMappingURL=agent-5M7WLUWH.cjs.map
+//# sourceMappingURL=agent-5M7WLUWH.cjs.map

package/dist/{agent-ZM4FDDL7.cjs.map → agent-5M7WLUWH.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-ZM4FDDL7.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-5M7WLUWH.cjs"}

package/dist/{agent-6STOEBGQ.js → agent-R5RERYFU.js}

@@ -1,9 +1,9 @@
-export { Agent } from './chunk-PYFBS6OQ.js';
+export { Agent } from './chunk-OOM236Z4.js';
 import './chunk-XKMVJ443.js';
 import './chunk-5522X223.js';
 import './chunk-K2BQQ445.js';
 import './chunk-R2C3HXR3.js';
-import './chunk-PQCTDMUI.js';
+import './chunk-ZHWKT2NI.js';
 import './chunk-2SFBB54R.js';
 import './chunk-HOHR75KF.js';
 import './chunk-H73MEMQB.js';
@@ -17,8 +17,8 @@ import './chunk-TE6XVTOA.js';
 import './chunk-24MGQDK3.js';
 import './chunk-2WXHA33T.js';
 import './chunk-HKCKOAIO.js';
-import './chunk-DDRX4LYS.js';
-import './chunk-7GDHFV2M.js';
+import './chunk-7QJYKVP6.js';
+import './chunk-OPAKPEPG.js';
 import './chunk-KVNWIAO4.js';
 import './chunk-SVQIW5RJ.js';
 import './chunk-FD2UT76F.js';
@@ -55,5 +55,5 @@ import './chunk-5Q4RTLMP.js';
 import './chunk-H3CVJSFC.js';
 import './chunk-B5MHRQJZ.js';
 import './chunk-CZJ6Q7CW.js';
-//# sourceMappingURL=agent-6STOEBGQ.js.map
-//# sourceMappingURL=agent-6STOEBGQ.js.map
+//# sourceMappingURL=agent-R5RERYFU.js.map
+//# sourceMappingURL=agent-R5RERYFU.js.map

package/dist/{agent-6STOEBGQ.js.map → agent-R5RERYFU.js.map}

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

package/dist/{chunk-BM6PDJW3.cjs → chunk-56BCEM26.cjs}

@@ -3,7 +3,7 @@
 var chunkJ6GXS5A2_cjs = require('./chunk-J6GXS5A2.cjs');
 var chunkPSLCVSCS_cjs = require('./chunk-PSLCVSCS.cjs');
 var chunkTTBIQTO5_cjs = require('./chunk-TTBIQTO5.cjs');
-var chunkJ4SA2ZEJ_cjs = require('./chunk-J4SA2ZEJ.cjs');
+var chunkKIKKTW5O_cjs = require('./chunk-KIKKTW5O.cjs');
 var chunkBV2MWEMV_cjs = require('./chunk-BV2MWEMV.cjs');
 var chunkMEUBLCM4_cjs = require('./chunk-MEUBLCM4.cjs');
 var chunkTMKTSYDS_cjs = require('./chunk-TMKTSYDS.cjs');
@@ -11,8 +11,8 @@ var chunk76PIKR4P_cjs = require('./chunk-76PIKR4P.cjs');
 var chunkB3XXQX6L_cjs = require('./chunk-B3XXQX6L.cjs');
 var chunkARMFXTY6_cjs = require('./chunk-ARMFXTY6.cjs');
 var chunk2ZPEDVLM_cjs = require('./chunk-2ZPEDVLM.cjs');
-var chunkKTA7YTZQ_cjs = require('./chunk-KTA7YTZQ.cjs');
-var chunkOCEQ6DW2_cjs = require('./chunk-OCEQ6DW2.cjs');
+var chunkXKZFIP7Z_cjs = require('./chunk-XKZFIP7Z.cjs');
+var chunkN6OEX5TN_cjs = require('./chunk-N6OEX5TN.cjs');
 var chunkRQMCOFAI_cjs = require('./chunk-RQMCOFAI.cjs');
 var chunkAA27GEYS_cjs = require('./chunk-AA27GEYS.cjs');
 var chunkYSTXFWQE_cjs = require('./chunk-YSTXFWQE.cjs');
@@ -2124,14 +2124,14 @@ async function readState(filePath) {
   try {
     parsed = JSON.parse(raw);
   } catch {
-    chunkOCEQ6DW2_cjs.warnOnce(
+    chunkN6OEX5TN_cjs.warnOnce(
       "personality-store-json-parse",
       "[theokit-sdk] personality.json is malformed; treating as empty"
     );
     return emptyState();
   }
   if (!isStateV1(parsed)) {
-    chunkOCEQ6DW2_cjs.warnOnce(
+    chunkN6OEX5TN_cjs.warnOnce(
       "personality-store-bad-version",
       `[theokit-sdk] personality.json has unknown version; treating as empty (file kept untouched)`
     );
@@ -2162,7 +2162,7 @@ var PersonalityStore = class {
       try {
         await this.#persist(agentId, slug);
       } catch (err) {
-        chunkOCEQ6DW2_cjs.warnOnce(
+        chunkN6OEX5TN_cjs.warnOnce(
           `personality-store-persist-failure-${agentId}`,
           `[theokit-sdk] personality persist failed for ${chunk6LHQPOMI_cjs.redactSecrets(agentId)}: ${chunk6LHQPOMI_cjs.redactSecrets(
             err.message
@@ -2179,7 +2179,7 @@ var PersonalityStore = class {
     try {
       state = await readState(filePath);
     } catch (err) {
-      chunkOCEQ6DW2_cjs.warnOnce(
+      chunkN6OEX5TN_cjs.warnOnce(
         `personality-store-hydrate-failure-${agentId}`,
         `[theokit-sdk] personality hydrate failed for ${chunk6LHQPOMI_cjs.redactSecrets(agentId)}: ${chunk6LHQPOMI_cjs.redactSecrets(
           err.message
@@ -2728,7 +2728,7 @@ var HooksExecutor = class {
   config = {};
   async initialize(settingSourcesIncludeProject) {
     if (readManagedSettings(this.policy.managedSettingsRoot).disableAllHooks === true) {
-      chunkOCEQ6DW2_cjs.warnFailureOnce(
+      chunkN6OEX5TN_cjs.warnFailureOnce(
         "hooks-disabled-by-policy",
         "[theokit-sdk] hooks: an operator policy (managed-settings.json) declares disableAllHooks \u2014 NO hook will run, including any this project declared."
       );
@@ -2739,7 +2739,7 @@ var HooksExecutor = class {
       this.config = {};
       return;
     }
-    this.config = await chunkOCEQ6DW2_cjs.loadHookConfig(this.cwd, this.compatSources);
+    this.config = await chunkN6OEX5TN_cjs.loadHookConfig(this.cwd, this.compatSources);
   }
   /** Fire every hook registered for `event` and aggregate the decisions. */
   async run(payload) {
@@ -3638,7 +3638,7 @@ var HISTOGRAM_NAMES = {
 };
 function safeRequire(moduleName) {
   try {
-    const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-BM6PDJW3.cjs', document.baseURI).href)));
+    const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-56BCEM26.cjs', document.baseURI).href)));
     return r(moduleName);
   } catch {
     return void 0;
@@ -3881,7 +3881,7 @@ var cachedOtel;
 function loadOtel() {
   if (cachedOtel === void 0) {
     try {
-      const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-BM6PDJW3.cjs', document.baseURI).href)));
+      const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-56BCEM26.cjs', document.baseURI).href)));
       const mod = r("@opentelemetry/api");
       cachedOtel = mod;
     } catch {
@@ -4200,7 +4200,7 @@ function applyAggregateCap(sources, maxTotal) {
     }
     const remaining = maxTotal - totalBytes;
     if (remaining > 0) {
-      const { finalContent } = chunkKTA7YTZQ_cjs.truncateWithMarker(s.content, remaining);
+      const { finalContent } = chunkXKZFIP7Z_cjs.truncateWithMarker(s.content, remaining);
       kept.push({ ...s, content: finalContent, truncated: true });
       totalBytes = maxTotal;
     } else {
@@ -4297,10 +4297,10 @@ var FileContextManager = class {
     this.lastScope = [...touchedFiles];
     const config = await loadContextConfig(this.cwd);
     const legacy = await loadSources(config, this.cwd);
-    const maxBytesPerFile = this.settings.maxBytesPerFile ?? chunkKTA7YTZQ_cjs.DEFAULT_MAX_BYTES_PER_FILE;
+    const maxBytesPerFile = this.settings.maxBytesPerFile ?? chunkXKZFIP7Z_cjs.DEFAULT_MAX_BYTES_PER_FILE;
     const maxBytesTotal = this.settings.maxBytesTotal ?? DEFAULT_MAX_BYTES_TOTAL;
     const granted = this.grantedContextDialects();
-    const discovered = await chunkKTA7YTZQ_cjs.runDiscovery({
+    const discovered = await chunkXKZFIP7Z_cjs.runDiscovery({
       cwd: this.cwd,
       maxBytesPerFile,
       skipLegacyTheokitContext: true,
@@ -4373,7 +4373,7 @@ async function loadContextConfig(cwd) {
   });
   if (mdEntities.length > 0) {
     if (fs.existsSync(jsonPath)) {
-      chunkOCEQ6DW2_cjs.warnOnce(
+      chunkN6OEX5TN_cjs.warnOnce(
         "context-both-present",
         "[theokit-sdk] both .theokit/context/ and .theokit/context.json detected \u2014 using markdown; remove context.json"
       );
@@ -4383,7 +4383,7 @@ async function loadContextConfig(cwd) {
     };
   }
   if (!fs.existsSync(jsonPath)) return { sources: [] };
-  chunkOCEQ6DW2_cjs.warnOnce(
+  chunkN6OEX5TN_cjs.warnOnce(
     "context-json-deprecated",
     // Names no command: `theokit-migrate-config` was unpublished with the `bin` entry, and a warning
     // that tells you to run something the package does not ship is worse than one that tells you
@@ -4546,13 +4546,13 @@ var PluginsManager = class {
       const jsonPath = path.join(pluginsRoot, folderName, "plugin.json");
       const metadata = fs.existsSync(mdPath) ? await loadPluginManifestFromMarkdown(this.cwd, pluginsRoot, folderName) : await loadPluginManifestFromJson(this.cwd, jsonPath, folderName);
       if (fs.existsSync(mdPath) && fs.existsSync(jsonPath)) {
-        chunkOCEQ6DW2_cjs.warnOnce(
+        chunkN6OEX5TN_cjs.warnOnce(
           `plugin-${folderName}-both`,
           `[theokit-sdk] both ${folderName}/PLUGIN.md and ${folderName}/plugin.json detected \u2014 using markdown; remove plugin.json`
         );
       }
       if (!fs.existsSync(mdPath) && fs.existsSync(jsonPath)) {
-        chunkOCEQ6DW2_cjs.warnOnce(
+        chunkN6OEX5TN_cjs.warnOnce(
           "plugin-json-deprecated",
           // Same reason as the context.json warning: the CLI it used to name is no longer published.
           "[theokit-sdk] plugin.json manifests are deprecated; replace each with a PLUGIN.md"
@@ -7447,7 +7447,7 @@ function applyPersonalityFilter(exposedTools, whitelist, opts) {
     if (exposedSet.has(name)) continue;
     const hint = suggestClosest(name, exposedSet);
     const message = hint !== void 0 ? `[theokit-sdk] personality "${opts?.personalityName ?? "?"}" references unknown tool "${name}"; did you mean "${hint}"?` : `[theokit-sdk] personality "${opts?.personalityName ?? "?"}" references unknown tool "${name}" (not exposed)`;
-    chunkOCEQ6DW2_cjs.warnOnce(
+    chunkN6OEX5TN_cjs.warnOnce(
       `personality-tool-missing|${opts?.agentId ?? "?"}|${opts?.personalityName ?? "?"}|${name}`,
       message
     );
@@ -9224,7 +9224,7 @@ function addEntity(byName, entity, origin, collisionMap) {
     );
   }
   if (origin === "project" && collisionMap?.has(fm.name)) {
-    chunkOCEQ6DW2_cjs.warnOnce(
+    chunkN6OEX5TN_cjs.warnOnce(
       `personality-collision-${fm.name}`,
       `[theokit-sdk] personality "${fm.name}" overridden by project preset`
     );
@@ -9274,14 +9274,14 @@ async function performPersonalitySwitch(args) {
 
 // src/internal/local-agent/local-agent-personality-extensions.ts
 function resolveActivePersonalityPreset(args) {
-  const forkCtx = chunkJ4SA2ZEJ_cjs.currentPersonalityContext();
+  const forkCtx = chunkKIKKTW5O_cjs.currentPersonalityContext();
   const slug = forkCtx !== void 0 ? forkCtx.slug : args.personalityStore.active(args.agentId);
   if (slug === void 0) return void 0;
   return args.personalityRegistry?.get(slug);
 }
 async function ensurePersonalityRegistryIfNeeded(args) {
   if (args.personalityRegistry !== void 0) return args.personalityRegistry;
-  const forkSlug = chunkJ4SA2ZEJ_cjs.currentPersonalityContext()?.slug;
+  const forkSlug = chunkKIKKTW5O_cjs.currentPersonalityContext()?.slug;
   const ownSlug = args.personalityStore.active(args.agentId);
   if (forkSlug === void 0 && ownSlug === void 0) return void 0;
   return await PersonalityRegistry.load(args.workspaceCwd);
@@ -9294,8 +9294,8 @@ function applyPersonalityOverlay(preset, base) {
 ${preset.systemPrompt}`;
 }
 async function localAgentUsePersonality(agent, name, opts) {
-  if (chunkJ4SA2ZEJ_cjs.currentPersonalityContext() !== void 0) {
-    chunkJ4SA2ZEJ_cjs.warnPersonalitySwitchInsideFork(agent.agentId);
+  if (chunkKIKKTW5O_cjs.currentPersonalityContext() !== void 0) {
+    chunkKIKKTW5O_cjs.warnPersonalitySwitchInsideFork(agent.agentId);
     return null;
   }
   if (agent.personalityRegistry === void 0) {
@@ -9356,7 +9356,7 @@ async function* localAgentStreamToCompletion(agent, message, options) {
 async function localAgentFork(parent, options) {
   const { forkAgentImpl } = await import('./fork-agent-WAEQI2DL.cjs');
   const { getAgentFacade } = await import('./agent-factory-registry-UU46BUMU.cjs');
-  const { withPersonalityContext } = await import('./context-ZOULM2RB.cjs');
+  const { withPersonalityContext } = await import('./context-B5J4GX2F.cjs');
   const create = getAgentFacade().create;
   return withPersonalityContext(
     { slug: parent.personalitySlugSnapshot, isFork: true },
@@ -11256,5 +11256,5 @@ exports.managedSettingsPathFor = managedSettingsPathFor;
 exports.openRouterMemoryEmbeddingProviderAdapter = openRouterMemoryEmbeddingProviderAdapter;
 exports.readManagedSettings = readManagedSettings;
 exports.resolveSessionDir = resolveSessionDir;
-//# sourceMappingURL=chunk-BM6PDJW3.cjs.map
-//# sourceMappingURL=chunk-BM6PDJW3.cjs.map
+//# sourceMappingURL=chunk-56BCEM26.cjs.map
+//# sourceMappingURL=chunk-56BCEM26.cjs.map