@theokit/sdk 4.63.3 → 5.0.0-next.1

package/dist/index.js

@@ -1,74 +1,76 @@
-export { StreamObjectError } from './chunk-U6IFHFWK.js';
+export { StreamObjectError } from './chunk-5WKQDIGO.js';
 export { GOAL_CONTINUATION_MARKER } from './chunk-PY2RQOA7.js';
-export { JudgeCredentialError } from './chunk-IPYYKCRC.js';
-import { migrateSqliteToLance, appendDiaryEntry } from './chunk-ACDLHN3W.js';
-export { GenerateObjectError } from './chunk-BU4KFWXF.js';
-import './chunk-UNYXQ4M5.js';
-import { Workflow, agentStep } from './chunk-OSEG74VJ.js';
-export { Workflow, agentStep, fn } from './chunk-OSEG74VJ.js';
-import './chunk-BZRFXJHA.js';
+export { JudgeCredentialError } from './chunk-UFPUHJWS.js';
+import { migrateSqliteToLance, appendDiaryEntry } from './chunk-WJXOICRC.js';
+export { GenerateObjectError } from './chunk-44I6UYVH.js';
+import './chunk-47TF32NQ.js';
+import { Workflow, agentStep } from './chunk-HFEJE7AC.js';
+export { Workflow, agentStep, fn } from './chunk-HFEJE7AC.js';
+import './chunk-GBCVPKHE.js';
 import './chunk-HY66GLM6.js';
-export { Cron } from './chunk-GPKAF7SG.js';
-import { MEMORY_EMBEDDING_ADAPTERS, DEFAULT_AGENTIC_MODEL_ID, Agent } from './chunk-25BD2R5G.js';
-export { Agent, AgentBuilder, Tool, ToolError, UsageAccumulator, computeCost, getPricingEntry } from './chunk-25BD2R5G.js';
-import { configure, submit, list, get, cancel, subscribe } from './chunk-A46SWMIF.js';
-export { emitRunEvent } from './chunk-A46SWMIF.js';
-import './chunk-4FFBAUFS.js';
+export { Cron } from './chunk-6HIACV34.js';
+import { MEMORY_EMBEDDING_ADAPTERS, DEFAULT_AGENTIC_MODEL_ID, Agent } from './chunk-NCGWJ3HS.js';
+export { Agent, AgentBuilder, Tool, ToolError, UsageAccumulator, computeCost, getPricingEntry } from './chunk-NCGWJ3HS.js';
+import { configure, submit, list, get, cancel, subscribe } from './chunk-K2VMFZQ5.js';
+export { emitRunEvent } from './chunk-K2VMFZQ5.js';
+import './chunk-AWINL3ZC.js';
 import './chunk-K2BQQ445.js';
-import './chunk-L3MTL4NA.js';
-import './chunk-K5OJUYSZ.js';
+import './chunk-2ZLVT7H3.js';
+import './chunk-IJM7UGS5.js';
 import './chunk-2SFBB54R.js';
-import './chunk-UBDMVMBZ.js';
+import './chunk-55GB6JYQ.js';
 import './chunk-H73MEMQB.js';
-import './chunk-XO4SOZN6.js';
-import { resolveMemoryRoot, readFactsFromMarkdown } from './chunk-L4BDVXIM.js';
-import './chunk-BP46RJ5X.js';
-import { discoverProviderPlugins, shouldUseFixtureMode, isFixtureApiKey, httpRequest, mapOllamaTransportError, readErrorResponseBody, mapOllamaHttpError } from './chunk-DN2PACRI.js';
-import './chunk-TAZVKYWJ.js';
-import './chunk-WTMU7J4U.js';
-import './chunk-7YGCPMGB.js';
-import './chunk-N2U4AZGB.js';
+import './chunk-OR6XIWLB.js';
+import { resolveMemoryRoot, readFactsFromMarkdown } from './chunk-UNK4HNJH.js';
+import './chunk-AAEZSPTC.js';
+import { discoverProviderPlugins, shouldUseFixtureMode, isFixtureApiKey, httpRequest, mapOllamaTransportError, readErrorResponseBody, mapOllamaHttpError } from './chunk-K3NH62DG.js';
+import './chunk-UBR5PWD7.js';
+import './chunk-2XC6KDJM.js';
+import './chunk-XB4GI5RZ.js';
+import './chunk-24MGQDK3.js';
+import './chunk-2WXHA33T.js';
 import './chunk-HKCKOAIO.js';
-import './chunk-SAVIWMZB.js';
+import './chunk-ILGZ2ZZV.js';
 import './chunk-KVNWIAO4.js';
-import './chunk-PUAEFLYK.js';
+import './chunk-SVQIW5RJ.js';
 import './chunk-FD2UT76F.js';
-import { toJsonSchema } from './chunk-4VPXM6UU.js';
-import './chunk-U54XCYG3.js';
+import { toJsonSchema } from './chunk-7I5Z3UBJ.js';
+import './chunk-FJWQP6EE.js';
 import './chunk-NAF4L3T6.js';
-import './chunk-RNB4APBZ.js';
+import './chunk-6WAKKTBO.js';
 import './chunk-6X6ID4MO.js';
-import './chunk-O73J46PV.js';
+import './chunk-XDANGA2C.js';
 import './chunk-WFC26L6Y.js';
-import './chunk-7AD3ZTZL.js';
-import './chunk-HS7AVXTF.js';
-import './chunk-RIAM53CP.js';
-import './chunk-C72AZW7J.js';
-import './chunk-4QZSA2HJ.js';
-import './chunk-B3IMEBOA.js';
-import './chunk-UMP6OJIM.js';
+import './chunk-SAGRF4IB.js';
+import './chunk-EH6XD3FY.js';
+import './chunk-UKMBRMGT.js';
+import './chunk-4MMWFSCD.js';
+import './chunk-G7BLGBRN.js';
+import './chunk-VE6DFSKU.js';
+import './chunk-JOFVLOFY.js';
 import './chunk-WE22OXQA.js';
-import './chunk-LWGSI6M3.js';
-import './chunk-3O42QOMJ.js';
+import './chunk-6PWOWXMC.js';
+import './chunk-TA3K7SBK.js';
 import { withCwdMutex } from './chunk-Q5EWJPRY.js';
 export { withCwdMutex } from './chunk-Q5EWJPRY.js';
-export { TASK_RESERVED_PREFIXES, isValidTaskId } from './chunk-KQRW2GPZ.js';
-import { replaceFileAtomic } from './chunk-2GUYQR5P.js';
-import './chunk-LXI4XZEC.js';
-import './chunk-UFLD2HEV.js';
-import './chunk-LXQ6HKPS.js';
-import './chunk-A4JVILQU.js';
+export { TASK_RESERVED_PREFIXES, isValidTaskId } from './chunk-EIQFAOFD.js';
+import { replaceFileAtomic } from './chunk-3JHIFQ4I.js';
+import './chunk-XCCGNU3D.js';
+import './chunk-JTZ74HFD.js';
+import './chunk-JNAA4G4H.js';
+import { estimateTokens, CHARS_PER_TOKEN } from './chunk-6M2OIS4Y.js';
+export { estimateTokens } from './chunk-6M2OIS4Y.js';
 import { parseModelId } from './chunk-R7WIIPUR.js';
-import './chunk-UTSRIDKZ.js';
-import { registerBuiltins, listProviders, getCatalogCapabilities, getProviderProfile } from './chunk-WLQNMXQE.js';
-import './chunk-2QDYBS2A.js';
-import './chunk-C3NT3PVE.js';
-import './chunk-3OR54XG4.js';
-import { BudgetExceededError, TheokitAgentError, MemoryAdapterError, AuthenticationError, ConfigurationError } from './chunk-ZZMZWBR6.js';
-export { AgentDisposedError, AgentRunError, AuthenticationError, BudgetExceededError, ConfigurationError, IntegrationNotConnectedError, InvalidTaskIdError, MemoryAdapterError, NetworkError, RateLimitError, TaskNotFoundError, TheokitAgentError, UnknownAgentError, UnsupportedBudgetOperationError, UnsupportedRunOperationError, UnsupportedTaskOperationError, isTransientError } from './chunk-ZZMZWBR6.js';
-import { redactSecrets, addPattern, resolveApiKey } from './chunk-D4CUGAKZ.js';
-import { diag } from './chunk-XEQ3TM66.js';
-export { setDiagnosticsSink } from './chunk-XEQ3TM66.js';
+import './chunk-XYFGKVZ7.js';
+import { registerBuiltins, listProviders, getCatalogCapabilities, getProviderProfile } from './chunk-VWUXIVEI.js';
+import './chunk-AGACYRJ2.js';
+import './chunk-JMDDYA22.js';
+import './chunk-V22DZIXO.js';
+import './chunk-NJWYQWDL.js';
+import { BudgetExceededError, TheokitAgentError, MemoryAdapterError, ConfigurationError, AuthenticationError } from './chunk-ALUN2B4W.js';
+export { AgentDisposedError, AgentRunError, AuthenticationError, BudgetExceededError, ConfigurationError, IntegrationNotConnectedError, InvalidTaskIdError, MemoryAdapterError, NetworkError, RateLimitError, TaskNotFoundError, TheokitAgentError, UnknownAgentError, UnsupportedBudgetOperationError, UnsupportedRunOperationError, UnsupportedTaskOperationError, isTransientError } from './chunk-ALUN2B4W.js';
+import { diag, redactSecrets, addPattern, resolveApiKey } from './chunk-CZJ6Q7CW.js';
+export { setDiagnosticsSink } from './chunk-CZJ6Q7CW.js';
 import { createHash, randomUUID } from 'crypto';
 import { z } from 'zod';
 import { mkdir } from 'fs/promises';
@@ -243,8 +245,16 @@ function validateBudgetName(name) {
     );
   }
 }
+function assertImplementedScope(scope) {
+  if (scope === "process") return;
+  throw new ConfigurationError(
+    `Budget scope "${scope}" is declared but not implemented \u2014 only "process" is honoured. A budget created with it would have been accounted process-wide with no warning.`,
+    { code: "unimplemented_budget_scope" }
+  );
+}
 function createBudget(opts) {
   validateBudgetName(opts.name);
+  assertImplementedScope(opts.scope);
   if (registry.has(opts.name)) {
     throw new ConfigurationError(`Budget "${opts.name}" already exists`, {
       code: "invalid_budget_name"
@@ -539,10 +549,6 @@ var Budget = class {
 };
 
 // src/built-in-processors.ts
-var CHARS_PER_TOKEN = 4;
-function estimateTokens(text) {
-  return Math.ceil(text.length / CHARS_PER_TOKEN);
-}
 var CONTROL_CHARS = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F]/g;
 function createUnicodeNormalizer(opts = {}) {
   const stripControlChars = opts.stripControlChars ?? false;
@@ -561,7 +567,9 @@ function createUnicodeNormalizer(opts = {}) {
 }
 function createTokenLimiter(opts) {
   if (!Number.isInteger(opts.limit) || opts.limit <= 0) {
-    throw new Error("createTokenLimiter: `limit` must be a positive integer.");
+    throw new ConfigurationError("createTokenLimiter: `limit` must be a positive integer.", {
+      code: "invalid_processor_options"
+    });
   }
   const limit = opts.limit;
   const strategy = opts.strategy ?? "truncate";
@@ -596,8 +604,16 @@ var UnicodeNormalizer = class {
 
 // src/create-skill.ts
 function createSkill(spec) {
-  if (!spec.name) throw new Error("createSkill: `name` is required.");
-  if (!spec.description) throw new Error("createSkill: `description` is required.");
+  if (!spec.name) {
+    throw new ConfigurationError("createSkill: `name` is required.", {
+      code: "invalid_skill_spec"
+    });
+  }
+  if (!spec.description) {
+    throw new ConfigurationError("createSkill: `description` is required.", {
+      code: "invalid_skill_spec"
+    });
+  }
   return {
     name: spec.name,
     description: spec.description,
@@ -693,7 +709,9 @@ function defineSkillReadTool(skills) {
   const seen = /* @__PURE__ */ new Set();
   for (const skill of skills) {
     if (seen.has(skill.name)) {
-      throw new Error(`defineSkillReadTool: duplicate skill name "${skill.name}".`);
+      throw new ConfigurationError(`defineSkillReadTool: duplicate skill name "${skill.name}".`, {
+        code: "duplicate_skill_name"
+      });
     }
     seen.add(skill.name);
   }
@@ -788,9 +806,9 @@ var EventBus = class {
 // src/goal-loop.ts
 function runGoalLoop(agent, goal, options, depsOverride) {
   async function* wrap() {
-    const { runUntilImpl } = await import('./run-until-HEQOUVU6.js');
+    const { runUntilImpl } = await import('./run-until-6D6TQ4JN.js');
     const deps = depsOverride ?? await (async () => {
-      const { judgeCallImpl } = await import('./judge-call-LVXABPS3.js');
+      const { judgeCallImpl } = await import('./judge-call-6MVARKU2.js');
       const { getAgentFacade } = await import('./agent-factory-registry-ZVTABLEY.js');
       const create = getAgentFacade().create;
       return {
@@ -845,7 +863,7 @@ function definePlugin(p) {
 }
 var Plugin = { create: definePlugin };
 
-// src/internal/runtime/memory/memory-provider-noop.ts
+// src/internal/runtime/memory-glue/memory-provider-noop.ts
 var NOOP_ADAPTER_ID = "noop";
 var NOOP_CAPABILITIES = {
   history: false,
@@ -1029,7 +1047,7 @@ function foldLayers(entries, accumulatingKeys = []) {
 // src/internal/memory/dreaming/phases.ts
 var DEFAULT_DEDUP_THRESHOLD = 0.95;
 var DEFAULT_CLUSTER_THRESHOLD = 0.75;
-var CONSOLIDATABLE_KINDS = /* @__PURE__ */ new Set(["project", "session"]);
+var CONSOLIDATABLE_KINDS = /* @__PURE__ */ new Set(["project"]);
 var ATOMIC_KINDS = /* @__PURE__ */ new Set(["user", "feedback", "reference"]);
 function dedupPolicy(fact) {
   if (fact.kind === void 0) return "exact";
@@ -1225,20 +1243,30 @@ function emptyResult(status) {
 
 // src/internal/memory/sdk-memory-peer-loader.ts
 var cachedAttempt;
+async function loadPeer() {
+  try {
+    const spec = "@theokit/sdk-memory";
+    const mod = await import(spec);
+    if (hasExpectedSurface(mod)) return mod;
+    diag(
+      "sdk-memory peer loaded but does not expose the expected surface (runDreamingSweep / MEMORY_EMBEDDING_ADAPTERS / IndexManager / migrateSqliteToLance) \u2014 falling back to the legacy memory path"
+    );
+    return null;
+  } catch (err) {
+    if (err?.code !== "ERR_MODULE_NOT_FOUND") {
+      diag(
+        `sdk-memory peer is installed but failed to load \u2014 falling back to the legacy memory path: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+    return null;
+  }
+}
+function hasExpectedSurface(mod) {
+  return typeof mod.runDreamingSweep === "function" && mod.MEMORY_EMBEDDING_ADAPTERS !== void 0 && mod.IndexManager !== void 0 && typeof mod.migrateSqliteToLance === "function";
+}
 function tryLoadSdkMemoryPeer() {
   if (cachedAttempt !== void 0) return cachedAttempt;
-  cachedAttempt = (async () => {
-    try {
-      const spec = "@theokit/sdk-memory";
-      const mod = await import(spec);
-      if (typeof mod.runDreamingSweep === "function" && mod.MEMORY_EMBEDDING_ADAPTERS !== void 0 && mod.IndexManager !== void 0 && typeof mod.migrateSqliteToLance === "function") {
-        return mod;
-      }
-      return null;
-    } catch {
-      return null;
-    }
-  })();
+  cachedAttempt = loadPeer();
   return cachedAttempt;
 }
 
@@ -1269,7 +1297,7 @@ var Memory = {
       openArgs.embedding = await resolveEmbedding(opts.embedding, peer.MEMORY_EMBEDDING_ADAPTERS);
       return await peer.IndexManager.open(openArgs);
     }
-    const { IndexManager } = await import('./index-manager-SP4ISSDX.js');
+    const { IndexManager } = await import('./index-manager-QH6OXEV5.js');
     openArgs.embedding = await resolveEmbedding(opts.embedding, MEMORY_EMBEDDING_ADAPTERS);
     return await IndexManager.open(openArgs);
   },
@@ -1560,29 +1588,33 @@ function isValibotSchema(s) {
   const o = s;
   return o.kind === "schema" && "type" in o && typeof o.toJsonSchema !== "function";
 }
+function isMissingModuleError(err) {
+  if (err?.code === "ERR_MODULE_NOT_FOUND") return true;
+  return err instanceof Error && /Cannot find|Cannot resolve|ERR_MODULE_NOT_FOUND/.test(err.message);
+}
+async function normalizeValibotSchema(schema) {
+  const specifier = "@valibot/to-json-schema";
+  try {
+    const mod = await import(specifier);
+    return mod.toJsonSchema(schema);
+  } catch (err) {
+    if (!isMissingModuleError(err)) throw err;
+    throw new ConfigurationError(
+      "normalizeSchema: a Valibot schema requires the optional '@valibot/to-json-schema' package. Install it, or use a Zod schema (the default recommendation).",
+      { code: "valibot_converter_missing" }
+    );
+  }
+}
 async function normalizeSchema(schema) {
   if (isJsonSchemaObject(schema)) return schema;
-  if (isValibotSchema(schema)) {
-    const specifier = "@valibot/to-json-schema";
-    try {
-      const mod = await import(specifier);
-      return mod.toJsonSchema(schema);
-    } catch (err) {
-      const missing = err instanceof Error && /Cannot find|Cannot resolve|ERR_MODULE_NOT_FOUND/.test(err.message);
-      if (missing) {
-        throw new Error(
-          "normalizeSchema: a Valibot schema requires the optional '@valibot/to-json-schema' package. Install it, or use a Zod schema (the default recommendation)."
-        );
-      }
-      throw err;
-    }
-  }
+  if (isValibotSchema(schema)) return await normalizeValibotSchema(schema);
   if (isZodSchema(schema)) {
     return toJsonSchema(schema, { unrepresentable: "any" });
   }
   if (hasToJsonSchemaMethod(schema)) return schema.toJsonSchema();
-  throw new Error(
-    "normalizeSchema: unsupported schema. Supported: Zod (default), JSON Schema, ArkType (.toJsonSchema()), Valibot (with @valibot/to-json-schema)."
+  throw new ConfigurationError(
+    "normalizeSchema: unsupported schema. Supported: Zod (default), JSON Schema, ArkType (.toJsonSchema()), Valibot (with @valibot/to-json-schema).",
+    { code: "unsupported_schema" }
   );
 }
 
@@ -1633,6 +1665,12 @@ var Security = class {
    * // → text containing "MYORG-AAAA...AAAA" now masks like a builtin.
    */
   static addPattern(re) {
+    if (!re.global) {
+      throw new ConfigurationError(
+        "Security.addPattern: regex must have /g flag for replace-all semantics",
+        { code: "invalid_redaction_pattern" }
+      );
+    }
     addPattern(re);
   }
 };
@@ -1705,7 +1743,7 @@ function isBuiltAgent(m) {
   return typeof m.send === "function";
 }
 async function materialize(def, index) {
-  const { Agent: Agent2 } = await import('./agent-3JK7VXNN.js');
+  const { Agent: Agent2 } = await import('./agent-XMKRP27S.js');
   return Agent2.create({
     // `AgentDefinition.model` admits the sentinel `'inherit'`, which is not a model id. Inheriting
     // here means "declare nothing and let the default apply" — forwarding the literal would create
@@ -1736,8 +1774,8 @@ function createSquad(options) {
     }
   };
 }
-async function buildPipeline(agents, nome) {
-  let builder = Workflow.create({ name: nome ?? "squad" });
+async function buildPipeline(agents, name) {
+  let builder = Workflow.create({ name: name ?? "squad" });
   for (let i = 0; i < agents.length; i++) {
     const member = agents[i];
     if (member === void 0) continue;
@@ -2239,6 +2277,6 @@ function recordWiring(input) {
   return record;
 }
 
-export { AgentFactory, Budget, EventBus, JobQueue, LayerOrderError, LiveSessionError, Memory, NoopMemoryProvider, PermissionEngine, PermissionPlugin, Plugin, Provider, RetentionPolicyError, SOVEREIGN_ENV_KEYS, Security, Skill, SkillReadTool, Squad, Task, Theokit, TokenLimiter, UngatedCapabilityError, UnicodeNormalizer, applyMode, applySecurityFloor, auditEnvReachability, chargeAndCheckThresholds, createCounterBudgetTracker, decideApproval, describeAction, describeCredential, estimateTokens, evaluateBlastRadius, extractRawId, foldLayers, guardSessionDestruction, inferApiMode, loadProjectEnv, migrateSqliteToLance2 as migrateSqliteToLance, mkMemoryId, normalizeSchema, normalizeUsage, planReaping, preflightCheck, recordWiring, resolveTrustPosture, runGoalLoop, scopedConversationId, sessionScopePrefix, toShareGptTrajectory, verifyLayerOrdering, withBlastRadius };
+export { AgentFactory, Budget, EventBus, JobQueue, LayerOrderError, LiveSessionError, Memory, NoopMemoryProvider, PermissionEngine, PermissionPlugin, Plugin, Provider, RetentionPolicyError, SOVEREIGN_ENV_KEYS, Security, Skill, SkillReadTool, Squad, Task, Theokit, TokenLimiter, UngatedCapabilityError, UnicodeNormalizer, applyMode, applySecurityFloor, auditEnvReachability, chargeAndCheckThresholds, createCounterBudgetTracker, decideApproval, describeAction, describeCredential, evaluateBlastRadius, extractRawId, foldLayers, guardSessionDestruction, inferApiMode, loadProjectEnv, migrateSqliteToLance2 as migrateSqliteToLance, mkMemoryId, normalizeSchema, normalizeUsage, planReaping, preflightCheck, recordWiring, resolveTrustPosture, runGoalLoop, scopedConversationId, sessionScopePrefix, toShareGptTrajectory, verifyLayerOrdering, withBlastRadius };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map