@theokit/sdk 4.53.0 → 4.53.1

package/dist/{chunk-NZOR3N4E.js → chunk-G3JWXOGY.js}

@@ -1,34 +1,34 @@
-import { enqueueSessionWrite, hydrateSession, persistTurnToTranscript, flushSessionWrites, appendSessionMessage, getSessionMessages, discardSession, clearSession } from './chunk-I5OTK2RP.js';
-import { loadHookConfig, warnOnce, currentPersonalityContext, warnPersonalitySwitchInsideFork } from './chunk-OIBHY6JQ.js';
+import { enqueueSessionWrite, hydrateSession, persistTurnToTranscript, flushSessionWrites, appendSessionMessage, getSessionMessages, discardSession, clearSession } from './chunk-GOVJO4YE.js';
+import { loadHookConfig, warnOnce, currentPersonalityContext, warnPersonalitySwitchInsideFork } from './chunk-PGP7IOJ2.js';
 import { extractCodePlugins } from './chunk-2SFBB54R.js';
-import { submit, emitRunEvent } from './chunk-7TB5U7RK.js';
-import { FsSessionStore } from './chunk-634YVZLU.js';
-import { discoverProviderPlugins, getConfiguredBaseUrl, httpRequest, isFixtureApiKey, shouldUseRealLocalRuntime, CircuitBreaker, buildDefaultSummarizer, parseSseStream, resolveProviderChain, inferProviderFromApiKey, detectPrimaryProvider, tryFirstEvent, relayStream, renderToolResultContentText } from './chunk-2Y5NO2SY.js';
-import { IndexManager, writeSessionSummary, memoryDir, appendFact, readFacts, legacyMemoryJsonPath, memoryMdPath, appendFactToMarkdown } from './chunk-NOS7PTKP.js';
-import { resolveChildEnv } from './chunk-AM2CNBKE.js';
+import { submit, emitRunEvent } from './chunk-XROIW6BH.js';
+import { FsSessionStore } from './chunk-B6HOIWQ6.js';
+import { discoverProviderPlugins, getConfiguredBaseUrl, httpRequest, isFixtureApiKey, shouldUseRealLocalRuntime, CircuitBreaker, buildDefaultSummarizer, parseSseStream, resolveProviderChain, inferProviderFromApiKey, detectPrimaryProvider, tryFirstEvent, relayStream, renderToolResultContentText } from './chunk-LS3LMQ23.js';
+import { IndexManager, writeSessionSummary, memoryDir, appendFact, readFacts, legacyMemoryJsonPath, memoryMdPath, appendFactToMarkdown } from './chunk-SEL2ZQMT.js';
+import { resolveChildEnv } from './chunk-HKCKOAIO.js';
 import { DEFAULT_MAX_BYTES_PER_FILE, runDiscovery, truncateWithMarker } from './chunk-34XOCZJO.js';
-import { readVersionedJson, getTheokitHome, writeVersionedJson } from './chunk-L7EGRCKJ.js';
-import { createOpenAiCompatibleRuntime } from './chunk-EFXJ5C7X.js';
+import { readVersionedJson, getTheokitHome, writeVersionedJson } from './chunk-PBZ7HMBP.js';
+import { createOpenAiCompatibleRuntime } from './chunk-KSWHTR54.js';
 import { sanitizeToolInput } from './chunk-U54XCYG3.js';
 import { withInheritedSubAgentCredentials, subAgentToolsFromDefinitions } from './chunk-RP5HQVLD.js';
 import { setAgentFacade } from './chunk-6X6ID4MO.js';
 import { withToolWhitelist, checkToolWhitelist } from './chunk-7AD3ZTZL.js';
-import { mapWithConcurrency } from './chunk-ITQ4NO4P.js';
-import { defaultBaseDir, expandTilde } from './chunk-C4EU627W.js';
-import { withFileLock } from './chunk-HTK54K2J.js';
+import { mapWithConcurrency } from './chunk-3WVMJY7F.js';
+import { expandTilde, defaultBaseDir } from './chunk-N5CR3TJZ.js';
+import { withFileLock } from './chunk-NZL4BNFQ.js';
 import { withCwdMutex } from './chunk-2XLKLVVR.js';
 import { toJsonSchema } from './chunk-4VPXM6UU.js';
-import { atomicWriteJson } from './chunk-CHVSMEKM.js';
-import { loadSubagents } from './chunk-XGYI2KQH.js';
-import { resolveEffectiveContextWindow, CONTEXT_WINDOW_FLOOR, CONTEXT_WINDOW_MARGIN } from './chunk-KIX45IKP.js';
+import { atomicWriteJson } from './chunk-6AZDM6LK.js';
+import { loadSubagents } from './chunk-UFIXH26P.js';
+import { resolveEffectiveContextWindow, CONTEXT_WINDOW_FLOOR, CONTEXT_WINDOW_MARGIN } from './chunk-HE4BIAOS.js';
 import { parseModelId } from './chunk-X2FR4OIT.js';
-import { getCatalogModelInfo, registerBuiltins, getProviderProfile, registerProvider, isPatchedModelKey } from './chunk-2YWWPCGX.js';
-import { escapeBlockBody, buildSkillsBlock, discoverSkills, stripSkillFrontmatter } from './chunk-BXVSBYGW.js';
-import { validateArtifactPath, PathTraversalError, safePathJoin } from './chunk-XWCTBGYK.js';
+import { getCatalogModelInfo, registerBuiltins, getProviderProfile, registerProvider, isPatchedModelKey } from './chunk-HSQ5Q3I5.js';
+import { escapeBlockBody, buildSkillsBlock, discoverSkills, stripSkillFrontmatter } from './chunk-OY7O3Q6R.js';
+import { validateArtifactPath, PathTraversalError, safePathJoin } from './chunk-SK4QLUBK.js';
 import { insideRoot, atOrInsideRoot } from './chunk-RIAM53CP.js';
-import { readWorkspaceDir, parseSimpleYaml } from './chunk-5XXUYU3M.js';
-import { AgentRunError, coerceToKnownAgentRunErrorCode, UnknownAgentError, ConfigurationError, AuthenticationError, UnsupportedRunOperationError, AgentDisposedError, NetworkError, TheokitAgentError } from './chunk-HI4ZW62S.js';
-import { diag, redactSecrets } from './chunk-4X3SBHPK.js';
+import { readWorkspaceDir, parseSimpleYaml } from './chunk-DGOG5NXR.js';
+import { AgentRunError, coerceToKnownAgentRunErrorCode, UnknownAgentError, ConfigurationError, AuthenticationError, UnsupportedRunOperationError, AgentDisposedError, NetworkError, TheokitAgentError } from './chunk-U4UJHOSH.js';
+import { diag, resolveApiKey, redactSecrets } from './chunk-5F5NWKPN.js';
 import { stat, mkdir, readFile, readdir, access, unlink } from 'fs/promises';
 import { randomUUID, createHash } from 'crypto';
 import { join, dirname, resolve, isAbsolute } from 'path';
@@ -223,7 +223,7 @@ async function agentGenerate(agent, agentModel, agentApiKey, agentLocal, input,
   const { output, maxRetries, errorStrategy, ...sendOptions } = options;
   const run = await agent.send(input, sendOptions);
   const result = await run.wait();
-  const { generateObjectImpl, GenerateObjectError } = await import('./generate-object-TVQCW2IZ.js');
+  const { generateObjectImpl, GenerateObjectError } = await import('./generate-object-WQRCXFD2.js');
   const answer = structurableAnswerOrThrow(result, GenerateObjectError);
   const { getAgentFacade } = await import('./agent-factory-registry-ZVTABLEY.js');
   const facade = getAgentFacade();
@@ -277,19 +277,6 @@ function structurableAnswerOrThrow(result, GenerateObjectError) {
   }
   return answer;
 }
-
-// src/internal/env.ts
-var API_KEY_ENV_VAR = "THEOKIT_API_KEY";
-function resolveApiKey(explicit) {
-  if (explicit !== void 0 && explicit.length > 0) {
-    return explicit;
-  }
-  const fromEnv = process.env[API_KEY_ENV_VAR];
-  if (fromEnv !== void 0 && fromEnv.length > 0) {
-    return fromEnv;
-  }
-  return void 0;
-}
 var PREFIX = {
   localAgent: "agent-",
   cloudAgent: "bc-",
@@ -2073,6 +2060,25 @@ function isStdioCommandConfig(config) {
 function isLocalPath(command) {
   return command.startsWith("/") || command.startsWith("~/") || command.startsWith("./") || command.startsWith("../");
 }
+
+// src/internal/persistence/session-dir.ts
+function resolveSessionDir(local) {
+  if (local?.sessionDir !== void 0) {
+    if (local.baseDir !== void 0) {
+      diag(
+        "[theokit-sdk] local.sessionDir and local.baseDir are both set; using sessionDir. baseDir is the deprecated name for the same option (#301)."
+      );
+    }
+    return expandTilde(local.sessionDir);
+  }
+  if (local?.baseDir !== void 0) {
+    diag(
+      "[theokit-sdk] local.baseDir is deprecated; rename it to local.sessionDir (#301). It is the directory for session transcripts, not the working directory \u2014 that is local.cwd."
+    );
+    return expandTilde(local.baseDir);
+  }
+  return defaultBaseDir();
+}
 var SCHEMA_VERSION2 = 1;
 var FILE_NAME = "personality.json";
 function emptyState() {
@@ -8791,7 +8797,7 @@ function localAgentRunUntil(agent, goal, options) {
   async function* wrap() {
     const { runUntilImpl } = await import('./run-until-HEQOUVU6.js');
     const buildDeps = async () => {
-      const { judgeCallImpl } = await import('./judge-call-QMKGC2ZK.js');
+      const { judgeCallImpl } = await import('./judge-call-MDIPTBJI.js');
       const { getAgentFacade } = await import('./agent-factory-registry-ZVTABLEY.js');
       const create = getAgentFacade().create;
       return {
@@ -8824,7 +8830,7 @@ async function* localAgentStreamToCompletion(agent, message, options) {
 async function localAgentFork(parent, options) {
   const { forkAgentImpl } = await import('./fork-agent-RSV4E3EA.js');
   const { getAgentFacade } = await import('./agent-factory-registry-ZVTABLEY.js');
-  const { withPersonalityContext } = await import('./context-DCECDKWN.js');
+  const { withPersonalityContext } = await import('./context-ENXZNF6J.js');
   const create = getAgentFacade().create;
   return withPersonalityContext(
     { slug: parent.personalitySlugSnapshot, isFork: true },
@@ -9205,7 +9211,7 @@ async function executeSendLocked(inputs, message, options) {
 function buildCompletionCheckDeps() {
   return {
     judge: async (ctx, opts) => {
-      const { judgeCallImpl } = await import('./judge-call-QMKGC2ZK.js');
+      const { judgeCallImpl } = await import('./judge-call-MDIPTBJI.js');
       const { getAgentFacade } = await import('./agent-factory-registry-ZVTABLEY.js');
       return judgeCallImpl(ctx, opts, { create: getAgentFacade().create });
     }
@@ -9257,8 +9263,9 @@ var LocalAgent = class {
   options;
   workspaceCwd;
   /**
-   * SE40 — base dir for the native Claude-shaped session transcript. Default
-   * `~/.theokit`; set `local.baseDir: "~/.claude"` for Claude Code CLI interop.
+   * Directory for the native Claude-shaped session transcript. Default
+   * `~/.theokit`; set `local.sessionDir: "~/.claude"` for Claude Code CLI interop.
+   * (`local.baseDir` is the deprecated name for the same option — #301.)
    */
   transcriptBaseDir;
   /**
@@ -9308,7 +9315,7 @@ var LocalAgent = class {
     this.model = normalizeModel(options.model);
     this.options = options;
     this.workspaceCwd = resolveCwd(options.local?.cwd);
-    this.transcriptBaseDir = resolveBaseDir(options.local?.baseDir);
+    this.transcriptBaseDir = resolveSessionDir(options.local);
     this.sessionStore = options.local?.sessionStore ?? new FsSessionStore({ baseDir: this.transcriptBaseDir, cwd: this.workspaceCwd });
     this.settingSourcesIncludeProject = includesSetting(options, "project");
     this.settingSourcesIncludePlugins = includesSetting(options, "plugins");
@@ -9611,9 +9618,6 @@ var LocalAgent = class {
 function resolveCwd(cwd) {
   return (Array.isArray(cwd) ? cwd[0] : cwd) ?? process.cwd();
 }
-function resolveBaseDir(baseDir) {
-  return baseDir === void 0 ? defaultBaseDir() : expandTilde(baseDir);
-}
 function includesSetting(options, source) {
   const sources = options.local?.settingSources;
   return sources !== void 0 && (sources.includes(source) || sources.includes("all"));
@@ -9892,7 +9896,22 @@ var Agent = class _Agent {
     }
   }
   /**
-   * One-shot prompt: create an agent, send a single message, wait, dispose.
+   * One-shot prompt: create an agent, send a single message, wait, **dispose**.
+   *
+   * `Agent.prompt` is STATIC and owns the agent's whole lifecycle. To send to an
+   * agent you already hold, use the instance method — `agent.send(message)` —
+   * which keeps the conversation and does not dispose anything:
+   *
+   * ```ts
+   * const agent = await Agent.create({ ... });
+   * const run = await agent.send("first");     // NOT agent.prompt(...)
+   * const run2 = await agent.send("follow-up"); // full context retained
+   * ```
+   *
+   * There is no `agent.prompt()` (#302). The natural sentence for the second
+   * operation is "prompt the agent", so it is the method people reach for; the
+   * two differ in whether the agent survives the call, which is why they do not
+   * share a name.
    *
    * When `options.throwOnError === true`, rejects with `AgentRunError` if
    * the run terminates with `status: 'error'` (instead of resolving with the
@@ -9963,7 +9982,7 @@ var Agent = class _Agent {
    * @public
    */
   static async generateObject(options) {
-    const { generateObjectImpl } = await import('./generate-object-TVQCW2IZ.js');
+    const { generateObjectImpl } = await import('./generate-object-WQRCXFD2.js');
     return generateObjectImpl(options, {
       create: (opts) => _Agent.create(opts),
       delete: (agentId) => _Agent.delete(agentId)
@@ -9987,7 +10006,7 @@ var Agent = class _Agent {
       delete: (agentId) => _Agent.delete(agentId)
     };
     async function* wrapper() {
-      streamObjectImport ??= import('./stream-object-QMNR3YFF.js');
+      streamObjectImport ??= import('./stream-object-ZYXWS4B2.js');
       const { streamObjectImpl } = await streamObjectImport;
       yield* streamObjectImpl(options, deps);
     }
@@ -10011,7 +10030,7 @@ var Agent = class _Agent {
    * @public
    */
   static async batch(prompts, options) {
-    const { batchImpl } = await import('./batch-NLIS4QTW.js');
+    const { batchImpl } = await import('./batch-UPKN4SG6.js');
     return batchImpl(prompts, options, { create: (opts) => _Agent.create(opts) });
   }
   /**
@@ -10149,7 +10168,7 @@ var Agent = class _Agent {
         `No local agent "${agentId}" registered \u2014 compact targets local sessions.`
       );
     }
-    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-EJ36VH5I.js');
+    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-4MNKNMO2.js');
     const { cwd, model, store } = await openLocalStore(reg);
     return enqueueSessionWrite(
       cwd,
@@ -10185,7 +10204,7 @@ var Agent = class _Agent {
         `No local agent "${agentId}" registered \u2014 injectSessionTurn targets local sessions.`
       );
     }
-    const { injectSessionTurn } = await import('./inject-session-HO7FYVCX.js');
+    const { injectSessionTurn } = await import('./inject-session-GMBMJVNZ.js');
     const { cwd, model, store } = await openLocalStore(reg);
     await injectSessionTurn({
       store,
@@ -10224,7 +10243,7 @@ var Agent = class _Agent {
         `No local agent "${agentId}" registered \u2014 transcript targets local sessions.`
       );
     }
-    const { readSessionMessages } = await import('./agent-session-store-JMU7ASDB.js');
+    const { readSessionMessages } = await import('./agent-session-store-TNCGL5RN.js');
     const { store } = await openLocalStore(reg);
     return readSessionMessages(store, agentId);
   }
@@ -10245,7 +10264,7 @@ var Agent = class _Agent {
    */
   static async describe(agentId) {
     const agent = await getRegisteredAgentOrThrow(agentId);
-    const { loadSubagents: loadSubagents2 } = await import('./subagents-loader-WN2SB6PV.js');
+    const { loadSubagents: loadSubagents2 } = await import('./subagents-loader-I56GSKAQ.js');
     const settingSources = agent.options.local?.settingSources;
     const subagents = await loadSubagents2(
       agent.cwd ?? process.cwd(),
@@ -10312,12 +10331,13 @@ async function openLocalStore(reg) {
   const cwd = reg.cwd ?? process.cwd();
   const optModel = reg.options.model;
   const model = reg.model?.id ?? (typeof optModel === "string" ? optModel : optModel?.id) ?? "unknown";
-  const { FsSessionStore: FsSessionStore2 } = await import('./fs-session-store-LIKYT24K.js');
-  const { defaultBaseDir: defaultBaseDir2, expandTilde: expandTilde2 } = await import('./session-transcript-SKIRBEJE.js');
-  const baseDir = reg.options.local?.baseDir !== void 0 ? expandTilde2(reg.options.local.baseDir) : defaultBaseDir2();
+  const { FsSessionStore: FsSessionStore2 } = await import('./fs-session-store-R5FD3EN6.js');
+  const { defaultBaseDir: defaultBaseDir2, expandTilde: expandTilde2 } = await import('./session-transcript-RAKEK76V.js');
+  const configuredSessionDir = reg.options.local?.sessionDir ?? reg.options.local?.baseDir;
+  const baseDir = configuredSessionDir !== void 0 ? expandTilde2(configuredSessionDir) : defaultBaseDir2();
   return { cwd, model, store: new FsSessionStore2({ baseDir, cwd }) };
 }
 
-export { Agent, AgentBuilder, DEFAULT_AGENTIC_MODEL_ID, MEMORY_EMBEDDING_ADAPTERS, Tool, ToolError, UsageAccumulator, computeCost, generateCronId, getPricingEntry, openRouterMemoryEmbeddingProviderAdapter, resolveApiKey };
-//# sourceMappingURL=chunk-NZOR3N4E.js.map
-//# sourceMappingURL=chunk-NZOR3N4E.js.map
+export { Agent, AgentBuilder, DEFAULT_AGENTIC_MODEL_ID, MEMORY_EMBEDDING_ADAPTERS, Tool, ToolError, UsageAccumulator, computeCost, generateCronId, getPricingEntry, openRouterMemoryEmbeddingProviderAdapter };
+//# sourceMappingURL=chunk-G3JWXOGY.js.map
+//# sourceMappingURL=chunk-G3JWXOGY.js.map