@theokit/sdk 4.63.2 → 4.63.4-next.0

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # Changelog
 
+## 4.63.4-next.0
+
+### Patch Changes
+
+- 01630ec: The README explains that three unrelated things in this ecosystem are called "plugin", and that
+  two of them share one option.
+
+  A **framework plugin** (`@theokit/plugin-canvas`, `@theokit/auth-github`, …) extends a `theokit`
+  application — routes, UI, devtools, CLI verbs. An **SDK code plugin** (`PermissionPlugin.create(…)`,
+  `Handoff.asPlugin(…)`) extends an agent and is passed as `Agent.create({ plugins: [ … ] })`. The
+  same option also accepts `{ enabled: ["name"] }`, which selects **file-discovered** plugins under
+  `.theokit/plugins/` and is mutually exclusive with the array form.
+
+  Reaching for the wrong one raises no error; it simply has no effect. Installing `plugin-payments`
+  does nothing for an agent, and passing `PermissionPlugin` does nothing for a route.
+
+  It also records the observation that sends people looking for a bug that is not there:
+  `agent.pluginsManager` only ever holds the file-discovered form, so it reports `plugins: []` while
+  a code plugin is registered and working. An empty manager beside a populated `options.plugins` is
+  the normal shape.
+
+## 4.63.3
+
+### Patch Changes
+
+- 076e1b3: The Claude Code interop memory read is keyed by the git repository root, matching the CLI.
+
+  `claudeProjectMemoryDir` keyed the auto-memory store by `cwd`. The CLI keys it by the repository:
+  _"the `<project>` path is derived from the git repository, so all worktrees and subdirectories within
+  the same repo share one auto memory directory. Outside a git repo, the project root is used
+  instead."_
+
+  So an agent running from any directory below the root — a monorepo package, a script in `tools/`, a
+  test in a subfolder, which is the ordinary case — read a directory the CLI never writes to. It found
+  nothing and reported nothing, and that observation is identical to an empty store, which is why it
+  survived the interop change that introduced it.
+
+  Confirmed from disk before the fix: of the CLI project directories that resolve to a SUBDIRECTORY of
+  a git repository, none had a `memory/` at all, while their repository root held three fact files.
+  The subdirectory directories contained only session transcripts.
+
+  **Transcripts are the trap and stay as they were.** The CLI keys those by `cwd`, correctly, and
+  `encodeProjectDir` is right for them. One encoder serving two axes is what made the two
+  indistinguishable in the code; the encoder is still shared, the path it is given is not.
+
+  `.git` as a FILE — a worktree or a submodule — counts as a repository, so the read does not miss
+  again in the layout that most needs it.
+
 ## 4.63.2
 
 ### Patch Changes

package/dist/{agent-2COLCVOJ.js → agent-3JK7VXNN.js}

@@ -1,14 +1,14 @@
-export { Agent } from './chunk-WHFUZMIC.js';
+export { Agent } from './chunk-25BD2R5G.js';
 import './chunk-A46SWMIF.js';
 import './chunk-4FFBAUFS.js';
 import './chunk-K2BQQ445.js';
-import './chunk-UEXIJTLC.js';
+import './chunk-L3MTL4NA.js';
 import './chunk-K5OJUYSZ.js';
 import './chunk-2SFBB54R.js';
 import './chunk-UBDMVMBZ.js';
 import './chunk-H73MEMQB.js';
 import './chunk-XO4SOZN6.js';
-import './chunk-GEEXBYFL.js';
+import './chunk-L4BDVXIM.js';
 import './chunk-BP46RJ5X.js';
 import './chunk-DN2PACRI.js';
 import './chunk-TAZVKYWJ.js';
@@ -53,5 +53,5 @@ import './chunk-3OR54XG4.js';
 import './chunk-ZZMZWBR6.js';
 import './chunk-D4CUGAKZ.js';
 import './chunk-XEQ3TM66.js';
-//# sourceMappingURL=agent-2COLCVOJ.js.map
-//# sourceMappingURL=agent-2COLCVOJ.js.map
+//# sourceMappingURL=agent-3JK7VXNN.js.map
+//# sourceMappingURL=agent-3JK7VXNN.js.map

package/dist/{agent-2COLCVOJ.js.map → agent-3JK7VXNN.js.map}

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

package/dist/{agent-EXAN5EYJ.cjs → agent-PVINJTUR.cjs}

@@ -1,16 +1,16 @@
 'use strict';
 
-var chunkDKK5QY4C_cjs = require('./chunk-DKK5QY4C.cjs');
+var chunkJJ3OVRUM_cjs = require('./chunk-JJ3OVRUM.cjs');
 require('./chunk-3FFAEAUJ.cjs');
 require('./chunk-RMWTPV3M.cjs');
 require('./chunk-BUUUWQMB.cjs');
-require('./chunk-ITYQ6VBP.cjs');
+require('./chunk-VLVVJLDH.cjs');
 require('./chunk-ZCIRZE37.cjs');
 require('./chunk-BV2MWEMV.cjs');
 require('./chunk-KQ7TS7WW.cjs');
 require('./chunk-GHX4P3V2.cjs');
 require('./chunk-GKEFRLU7.cjs');
-require('./chunk-6RKUO7AW.cjs');
+require('./chunk-IAHZCGBE.cjs');
 require('./chunk-ZLQSWSJ2.cjs');
 require('./chunk-KYAJINUI.cjs');
 require('./chunk-O7DK5PBJ.cjs');
@@ -60,7 +60,7 @@ require('./chunk-EG4QM7ZJ.cjs');
 
 Object.defineProperty(exports, "Agent", {
   enumerable: true,
-  get: function () { return chunkDKK5QY4C_cjs.Agent; }
+  get: function () { return chunkJJ3OVRUM_cjs.Agent; }
 });
-//# sourceMappingURL=agent-EXAN5EYJ.cjs.map
-//# sourceMappingURL=agent-EXAN5EYJ.cjs.map
+//# sourceMappingURL=agent-PVINJTUR.cjs.map
+//# sourceMappingURL=agent-PVINJTUR.cjs.map

package/dist/{agent-EXAN5EYJ.cjs.map → agent-PVINJTUR.cjs.map}

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

package/dist/{chunk-WHFUZMIC.js → chunk-25BD2R5G.js}

@@ -1,11 +1,11 @@
 import { submit, emitRunEvent } from './chunk-A46SWMIF.js';
 import { enqueueSessionWrite, hydrateSession, persistTurnToTranscript, flushSessionWrites, appendSessionMessage, getSessionMessages, discardSession, clearSession } from './chunk-4FFBAUFS.js';
-import { IndexManager } from './chunk-UEXIJTLC.js';
+import { IndexManager } from './chunk-L3MTL4NA.js';
 import { loadHookConfig, warnOnce, currentPersonalityContext, warnPersonalitySwitchInsideFork } from './chunk-K5OJUYSZ.js';
 import { extractCodePlugins } from './chunk-2SFBB54R.js';
 import { createOpenAiCompatibleRuntime } from './chunk-UBDMVMBZ.js';
 import { persistActiveMemoryTranscript } from './chunk-XO4SOZN6.js';
-import { resolveMemoryRoot, writeSessionSummary, MEMORY_KINDS, appendFact, readFacts, legacyMemoryJsonPath, memoryMdPath, appendFactToMarkdown } from './chunk-GEEXBYFL.js';
+import { resolveMemoryRoot, writeSessionSummary, MEMORY_KINDS, appendFact, readFacts, legacyMemoryJsonPath, memoryMdPath, appendFactToMarkdown } from './chunk-L4BDVXIM.js';
 import { FsSessionStore } from './chunk-BP46RJ5X.js';
 import { discoverProviderPlugins, getConfiguredBaseUrl, httpRequest, isFixtureApiKey, presentProviderCredentialEnvVars, CircuitBreaker, buildDefaultSummarizer, shouldUseRealLocalRuntime, parseSseStream, resolveProviderChain, inferProviderFromApiKey, detectPrimaryProvider, warnProviderPrecedenceOnce, tryFirstEvent, relayStream, renderToolResultContentText } from './chunk-DN2PACRI.js';
 import { resolveChildEnv } from './chunk-HKCKOAIO.js';
@@ -10794,5 +10794,5 @@ async function openLocalStore(reg) {
 }
 
 export { Agent, AgentBuilder, DEFAULT_AGENTIC_MODEL_ID, MEMORY_EMBEDDING_ADAPTERS, Tool, ToolError, UsageAccumulator, computeCost, generateCronId, getPricingEntry, openRouterMemoryEmbeddingProviderAdapter };
-//# sourceMappingURL=chunk-WHFUZMIC.js.map
-//# sourceMappingURL=chunk-WHFUZMIC.js.map
+//# sourceMappingURL=chunk-25BD2R5G.js.map
+//# sourceMappingURL=chunk-25BD2R5G.js.map