@theokit/sdk-tools 0.15.0 → 0.16.0

package/dist/index.d.cts

@@ -75,6 +75,27 @@ interface SessionArtifactStore {
  */
 declare function createSessionArtifactStore(options: SessionArtifactStoreOptions): SessionArtifactStore;
 
+/**
+ * `current_time` — built-in tool for coding agents.
+ *
+ * Returns the current date-time. Codex-faithful at the core (its `clock`/`curr_time` tool returns UTC
+ * as `YYYY-MM-DD HH:MM:SS UTC`); this built-in keeps that default and adds an optional IANA `timezone`
+ * (additive superset — omitted ⇒ UTC, exactly Codex's behavior) plus an unambiguous `iso` instant.
+ *
+ * The clock is injectable so the tool is deterministic under test (testing.md §6: never read the real
+ * wall clock in a unit test).
+ *
+ * Result shape (always a JSON string):
+ *   - `{ ok: true, current_time: "YYYY-MM-DD HH:MM:SS <tz>", iso: string, timezone: string }`
+ *   - `{ ok: false, error: "invalid_timezone", timezone }`
+ */
+
+interface CreateCurrentTimeToolOptions {
+    /** Injectable clock — defaults to `() => new Date()`. Pass a fixed clock for deterministic tests. */
+    clock?: () => Date;
+}
+declare function createCurrentTimeTool(opts?: CreateCurrentTimeToolOptions): CustomTool;
+
 /**
  * `edit_file` — built-in tool for coding agents.
  *
@@ -1052,4 +1073,4 @@ interface CreateWriteFileToolOptions {
 }
 declare function createWriteFileTool(opts: CreateWriteFileToolOptions): CustomTool;
 
-export { CatastrophicCommandError, type CommandPolicy, ContextMatchError, type ContextMatchReason, type CreateApplyPatchToolOptions, type CreateBraveWebSearchAdapterOptions, type CreateEditFileToolOptions, type CreateGenericHttpSearchAdapterOptions, type CreateGitDiffToolOptions, type CreateGlobToolOptions, type CreateInteractiveShellToolOptions, type CreateListDirToolOptions, type CreateReadFileToolOptions, type CreateRunVitestToolOptions, type CreateSearchTextToolOptions, type CreateShellToolOptions, type CreateWebFetchToolOptions, type CreateWebSearchToolOptions, type CreateWriteFileToolOptions, DEFAULT_TOOL_GUIDANCE, type EnvContextOptions, type PlanModeTool, type PlanModeToolOptions, type PlanModeToolWithStore, type PlanNode, type QuestionTool, type QuestionToolOptions, ReadTracker, ReasoningTools, RedirectBlockedError, type RepoMapOptions, type ResolveAndScreenOptions, type ScreenedFetchOptions, type SessionArtifactStore, type SessionArtifactStoreOptions, SsrfBlockedError, type TodoItem, type TodolistTool, type ToolGuidanceMap, type TruncationOptions, type TruncationResult, type VitestSummary, type WebSearchCallback, type WebSearchResult, buildEnvContext, buildRepoMap, catastrophicShellReason, commandDenialReason, createApplyPatchTool, createBraveWebSearchAdapter, createEditFileTool, createGenericHttpSearchAdapter, createGitDiffTool, createGlobTool, createInteractiveShellTool, createListDirTool, createPlanModeTool, createQuestionTool, createReadFileTool, createRunVitestTool, createSearchTextTool, createSessionArtifactStore, createShellTool, createTodolistTool, createWebFetchTool, createWebSearchTool, createWriteFileTool, createWriteStdinTool, denyCatastrophicCommands, formatCode, formatDiff, formatError, formatFileList, injectGuidance, isBlockedIp, isCommandAllowed, renderToolList, replaceUnique, resolveAndScreen, screenedFetch, todoItemsToPlanNodes, truncateOutput, withDefaultGuidance, withDescription, withName, withShellExitGuidance, withToolResultGuidance };
+export { CatastrophicCommandError, type CommandPolicy, ContextMatchError, type ContextMatchReason, type CreateApplyPatchToolOptions, type CreateBraveWebSearchAdapterOptions, type CreateCurrentTimeToolOptions, type CreateEditFileToolOptions, type CreateGenericHttpSearchAdapterOptions, type CreateGitDiffToolOptions, type CreateGlobToolOptions, type CreateInteractiveShellToolOptions, type CreateListDirToolOptions, type CreateReadFileToolOptions, type CreateRunVitestToolOptions, type CreateSearchTextToolOptions, type CreateShellToolOptions, type CreateWebFetchToolOptions, type CreateWebSearchToolOptions, type CreateWriteFileToolOptions, DEFAULT_TOOL_GUIDANCE, type EnvContextOptions, type PlanModeTool, type PlanModeToolOptions, type PlanModeToolWithStore, type PlanNode, type QuestionTool, type QuestionToolOptions, ReadTracker, ReasoningTools, RedirectBlockedError, type RepoMapOptions, type ResolveAndScreenOptions, type ScreenedFetchOptions, type SessionArtifactStore, type SessionArtifactStoreOptions, SsrfBlockedError, type TodoItem, type TodolistTool, type ToolGuidanceMap, type TruncationOptions, type TruncationResult, type VitestSummary, type WebSearchCallback, type WebSearchResult, buildEnvContext, buildRepoMap, catastrophicShellReason, commandDenialReason, createApplyPatchTool, createBraveWebSearchAdapter, createCurrentTimeTool, createEditFileTool, createGenericHttpSearchAdapter, createGitDiffTool, createGlobTool, createInteractiveShellTool, createListDirTool, createPlanModeTool, createQuestionTool, createReadFileTool, createRunVitestTool, createSearchTextTool, createSessionArtifactStore, createShellTool, createTodolistTool, createWebFetchTool, createWebSearchTool, createWriteFileTool, createWriteStdinTool, denyCatastrophicCommands, formatCode, formatDiff, formatError, formatFileList, injectGuidance, isBlockedIp, isCommandAllowed, renderToolList, replaceUnique, resolveAndScreen, screenedFetch, todoItemsToPlanNodes, truncateOutput, withDefaultGuidance, withDescription, withName, withShellExitGuidance, withToolResultGuidance };

package/dist/index.d.ts

@@ -75,6 +75,27 @@ interface SessionArtifactStore {
  */
 declare function createSessionArtifactStore(options: SessionArtifactStoreOptions): SessionArtifactStore;
 
+/**
+ * `current_time` — built-in tool for coding agents.
+ *
+ * Returns the current date-time. Codex-faithful at the core (its `clock`/`curr_time` tool returns UTC
+ * as `YYYY-MM-DD HH:MM:SS UTC`); this built-in keeps that default and adds an optional IANA `timezone`
+ * (additive superset — omitted ⇒ UTC, exactly Codex's behavior) plus an unambiguous `iso` instant.
+ *
+ * The clock is injectable so the tool is deterministic under test (testing.md §6: never read the real
+ * wall clock in a unit test).
+ *
+ * Result shape (always a JSON string):
+ *   - `{ ok: true, current_time: "YYYY-MM-DD HH:MM:SS <tz>", iso: string, timezone: string }`
+ *   - `{ ok: false, error: "invalid_timezone", timezone }`
+ */
+
+interface CreateCurrentTimeToolOptions {
+    /** Injectable clock — defaults to `() => new Date()`. Pass a fixed clock for deterministic tests. */
+    clock?: () => Date;
+}
+declare function createCurrentTimeTool(opts?: CreateCurrentTimeToolOptions): CustomTool;
+
 /**
  * `edit_file` — built-in tool for coding agents.
  *
@@ -1052,4 +1073,4 @@ interface CreateWriteFileToolOptions {
 }
 declare function createWriteFileTool(opts: CreateWriteFileToolOptions): CustomTool;
 
-export { CatastrophicCommandError, type CommandPolicy, ContextMatchError, type ContextMatchReason, type CreateApplyPatchToolOptions, type CreateBraveWebSearchAdapterOptions, type CreateEditFileToolOptions, type CreateGenericHttpSearchAdapterOptions, type CreateGitDiffToolOptions, type CreateGlobToolOptions, type CreateInteractiveShellToolOptions, type CreateListDirToolOptions, type CreateReadFileToolOptions, type CreateRunVitestToolOptions, type CreateSearchTextToolOptions, type CreateShellToolOptions, type CreateWebFetchToolOptions, type CreateWebSearchToolOptions, type CreateWriteFileToolOptions, DEFAULT_TOOL_GUIDANCE, type EnvContextOptions, type PlanModeTool, type PlanModeToolOptions, type PlanModeToolWithStore, type PlanNode, type QuestionTool, type QuestionToolOptions, ReadTracker, ReasoningTools, RedirectBlockedError, type RepoMapOptions, type ResolveAndScreenOptions, type ScreenedFetchOptions, type SessionArtifactStore, type SessionArtifactStoreOptions, SsrfBlockedError, type TodoItem, type TodolistTool, type ToolGuidanceMap, type TruncationOptions, type TruncationResult, type VitestSummary, type WebSearchCallback, type WebSearchResult, buildEnvContext, buildRepoMap, catastrophicShellReason, commandDenialReason, createApplyPatchTool, createBraveWebSearchAdapter, createEditFileTool, createGenericHttpSearchAdapter, createGitDiffTool, createGlobTool, createInteractiveShellTool, createListDirTool, createPlanModeTool, createQuestionTool, createReadFileTool, createRunVitestTool, createSearchTextTool, createSessionArtifactStore, createShellTool, createTodolistTool, createWebFetchTool, createWebSearchTool, createWriteFileTool, createWriteStdinTool, denyCatastrophicCommands, formatCode, formatDiff, formatError, formatFileList, injectGuidance, isBlockedIp, isCommandAllowed, renderToolList, replaceUnique, resolveAndScreen, screenedFetch, todoItemsToPlanNodes, truncateOutput, withDefaultGuidance, withDescription, withName, withShellExitGuidance, withToolResultGuidance };
+export { CatastrophicCommandError, type CommandPolicy, ContextMatchError, type ContextMatchReason, type CreateApplyPatchToolOptions, type CreateBraveWebSearchAdapterOptions, type CreateCurrentTimeToolOptions, type CreateEditFileToolOptions, type CreateGenericHttpSearchAdapterOptions, type CreateGitDiffToolOptions, type CreateGlobToolOptions, type CreateInteractiveShellToolOptions, type CreateListDirToolOptions, type CreateReadFileToolOptions, type CreateRunVitestToolOptions, type CreateSearchTextToolOptions, type CreateShellToolOptions, type CreateWebFetchToolOptions, type CreateWebSearchToolOptions, type CreateWriteFileToolOptions, DEFAULT_TOOL_GUIDANCE, type EnvContextOptions, type PlanModeTool, type PlanModeToolOptions, type PlanModeToolWithStore, type PlanNode, type QuestionTool, type QuestionToolOptions, ReadTracker, ReasoningTools, RedirectBlockedError, type RepoMapOptions, type ResolveAndScreenOptions, type ScreenedFetchOptions, type SessionArtifactStore, type SessionArtifactStoreOptions, SsrfBlockedError, type TodoItem, type TodolistTool, type ToolGuidanceMap, type TruncationOptions, type TruncationResult, type VitestSummary, type WebSearchCallback, type WebSearchResult, buildEnvContext, buildRepoMap, catastrophicShellReason, commandDenialReason, createApplyPatchTool, createBraveWebSearchAdapter, createCurrentTimeTool, createEditFileTool, createGenericHttpSearchAdapter, createGitDiffTool, createGlobTool, createInteractiveShellTool, createListDirTool, createPlanModeTool, createQuestionTool, createReadFileTool, createRunVitestTool, createSearchTextTool, createSessionArtifactStore, createShellTool, createTodolistTool, createWebFetchTool, createWebSearchTool, createWriteFileTool, createWriteStdinTool, denyCatastrophicCommands, formatCode, formatDiff, formatError, formatFileList, injectGuidance, isBlockedIp, isCommandAllowed, renderToolList, replaceUnique, resolveAndScreen, screenedFetch, todoItemsToPlanNodes, truncateOutput, withDefaultGuidance, withDescription, withName, withShellExitGuidance, withToolResultGuidance };

package/dist/index.js

@@ -265,6 +265,46 @@ function createSessionArtifactStore(options) {
   }
   return { write, read, has, list, path };
 }
+function formatInTimezone(now, tz) {
+  const parts = new Intl.DateTimeFormat("en-US", {
+    timeZone: tz,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hour12: false
+  }).formatToParts(now);
+  const p = {};
+  for (const { type, value } of parts) p[type] = value;
+  const hour = p.hour === "24" ? "00" : p.hour;
+  return `${p.year}-${p.month}-${p.day} ${hour}:${p.minute}:${p.second} ${tz}`;
+}
+function createCurrentTimeTool(opts = {}) {
+  const clock = opts.clock ?? (() => /* @__PURE__ */ new Date());
+  return Tool.create({
+    name: "current_time",
+    description: "Get the current date and time. Returns { current_time, iso, timezone } as a JSON string, where current_time is 'YYYY-MM-DD HH:MM:SS <timezone>' and iso is the ISO-8601 instant. Pass an optional IANA timezone (e.g. 'America/Sao_Paulo', 'Europe/Lisbon'); defaults to UTC. Never state the date or time from memory \u2014 always call this. Returns { ok: false, error: 'invalid_timezone' } for an unknown timezone.",
+    inputSchema: z.object({
+      timezone: z.string().optional().describe("IANA timezone, e.g. 'America/Sao_Paulo' or 'Europe/Lisbon'. Defaults to UTC.")
+    }),
+    handler: ({ timezone }) => {
+      const tz = timezone ?? "UTC";
+      const now = clock();
+      try {
+        return JSON.stringify({
+          ok: true,
+          current_time: formatInTimezone(now, tz),
+          iso: now.toISOString(),
+          timezone: tz
+        });
+      } catch {
+        return JSON.stringify({ ok: false, error: "invalid_timezone", timezone: tz });
+      }
+    }
+  });
+}
 
 // src/internal/context-match.ts
 var ContextMatchError = class extends Error {
@@ -379,8 +419,11 @@ async function editViaBackend(filesystem, ctx, path, old_string, new_string) {
   let content;
   try {
     content = await backend.readFile(path);
-  } catch {
-    return JSON.stringify({ ok: false, error: "not_found", path });
+  } catch (err) {
+    if (err instanceof FileNotFoundError) {
+      return JSON.stringify({ ok: false, error: "not_found", path });
+    }
+    throw err;
   }
   const outcome = computeEdit(content, old_string, new_string);
   if (!outcome.ok) return JSON.stringify({ ok: false, error: "no_match", path });
@@ -654,6 +697,7 @@ function runGitProcess(cwd, args, timeoutMs, maxStdoutBytes) {
   });
 }
 var DEFAULT_EXCLUDES = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", ".theo"]);
+var MAX_BACKEND_WALK_DEPTH = 64;
 function createGlobTool(opts) {
   const { projectRoot, filesystem } = opts;
   return Tool.create({
@@ -671,7 +715,7 @@ function createGlobTool(opts) {
         const backend = await resolveFilesystem(filesystem, ctx ?? {});
         const searchRel = cwd ?? "";
         const found = [];
-        await walkDirBackend(backend, searchRel, searchRel, regex, found);
+        await walkDirBackend(backend, searchRel, searchRel, regex, found, 0);
         return JSON.stringify({ ok: true, files: found.sort(), count: found.length });
       }
       const searchRoot = cwd ? safePathJoin(projectRoot, cwd) : projectRoot;
@@ -712,7 +756,8 @@ async function walkDir(base, dir, pattern, results) {
     }
   }
 }
-async function walkDirBackend(backend, base, dir, pattern, results) {
+async function walkDirBackend(backend, base, dir, pattern, results, depth) {
+  if (depth > MAX_BACKEND_WALK_DEPTH) return;
   let names;
   try {
     names = await backend.list(dir);
@@ -720,10 +765,10 @@ async function walkDirBackend(backend, base, dir, pattern, results) {
     return;
   }
   for (const name of names) {
-    await walkBackendEntry(backend, base, dir, name, pattern, results);
+    await walkBackendEntry(backend, base, dir, name, pattern, results, depth);
   }
 }
-async function walkBackendEntry(backend, base, dir, name, pattern, results) {
+async function walkBackendEntry(backend, base, dir, name, pattern, results, depth) {
   if (DEFAULT_EXCLUDES.has(name)) return;
   const fullRel = dir === "" ? name : `${dir}/${name}`;
   const relPath = base === "" ? fullRel : relative(base, fullRel);
@@ -734,7 +779,7 @@ async function walkBackendEntry(backend, base, dir, name, pattern, results) {
     return;
   }
   if (st.isDirectory) {
-    await walkDirBackend(backend, base, fullRel, pattern, results);
+    await walkDirBackend(backend, base, fullRel, pattern, results, depth + 1);
   } else if (st.isFile && pattern.test(relPath)) {
     results.push(fullRel);
   }
@@ -1806,6 +1851,7 @@ var DEFAULT_MAX_MATCHES = 100;
 var DEFAULT_MAX_FILE_SIZE = 1024 * 1024;
 var BINARY_PROBE_BYTES2 = 8 * 1024;
 var PREVIEW_MAX = 200;
+var MAX_BACKEND_WALK_DEPTH2 = 64;
 function createSearchTextTool(opts) {
   const {
     projectRoot,
@@ -1834,7 +1880,7 @@ function createSearchTextTool(opts) {
         const scopeRel = resolveScopeRel(path, projectRoot);
         if ("error" in scopeRel) return scopeRel.error;
         const backend = await resolveFilesystem(filesystem, ctx ?? {});
-        await walkBackend(backend, scopeRel.rel, state);
+        await walkBackend(backend, scopeRel.rel, state, 0);
         return JSON.stringify({
           ok: true,
           matches: state.matches,
@@ -1944,8 +1990,9 @@ function resolveScopeRel(path, projectRoot) {
     throw err;
   }
 }
-async function walkBackend(backend, dirRel, state) {
+async function walkBackend(backend, dirRel, state, depth) {
   if (state.truncated) return;
+  if (depth > MAX_BACKEND_WALK_DEPTH2) return;
   let names;
   try {
     names = await backend.list(dirRel);
@@ -1954,10 +2001,10 @@ async function walkBackend(backend, dirRel, state) {
   }
   for (const name of names) {
     if (state.truncated) return;
-    await handleBackendEntry(backend, dirRel, name, state);
+    await handleBackendEntry(backend, dirRel, name, state, depth);
   }
 }
-async function handleBackendEntry(backend, dirRel, name, state) {
+async function handleBackendEntry(backend, dirRel, name, state, depth) {
   const entryRel = dirRel === "" ? name : `${dirRel}/${name}`;
   if (isForbiddenPath(entryRel)) return;
   let st;
@@ -1967,7 +2014,7 @@ async function handleBackendEntry(backend, dirRel, name, state) {
     return;
   }
   if (st.isDirectory) {
-    await walkBackend(backend, entryRel, state);
+    await walkBackend(backend, entryRel, state, depth + 1);
   } else if (st.isFile) {
     await scanFileBackend(backend, entryRel, st.size, state);
   }
@@ -2550,6 +2597,6 @@ async function isBinaryFile(absolutePath) {
   }
 }
 
-export { CatastrophicCommandError, ContextMatchError, DEFAULT_TOOL_GUIDANCE, ReadTracker, ReasoningTools, RedirectBlockedError, SsrfBlockedError, buildEnvContext, buildRepoMap, catastrophicShellReason, commandDenialReason, createApplyPatchTool, createBraveWebSearchAdapter, createEditFileTool, createGenericHttpSearchAdapter, createGitDiffTool, createGlobTool, createInteractiveShellTool, createListDirTool, createPlanModeTool, createQuestionTool, createReadFileTool, createRunVitestTool, createSearchTextTool, createSessionArtifactStore, createShellTool, createTodolistTool, createWebFetchTool, createWebSearchTool, createWriteFileTool, createWriteStdinTool, denyCatastrophicCommands, formatCode, formatDiff, formatError, formatFileList, injectGuidance, isBlockedIp, isCommandAllowed, renderToolList, replaceUnique, resolveAndScreen, screenedFetch, todoItemsToPlanNodes, truncateOutput, withDefaultGuidance, withDescription, withName, withShellExitGuidance, withToolResultGuidance };
+export { CatastrophicCommandError, ContextMatchError, DEFAULT_TOOL_GUIDANCE, ReadTracker, ReasoningTools, RedirectBlockedError, SsrfBlockedError, buildEnvContext, buildRepoMap, catastrophicShellReason, commandDenialReason, createApplyPatchTool, createBraveWebSearchAdapter, createCurrentTimeTool, createEditFileTool, createGenericHttpSearchAdapter, createGitDiffTool, createGlobTool, createInteractiveShellTool, createListDirTool, createPlanModeTool, createQuestionTool, createReadFileTool, createRunVitestTool, createSearchTextTool, createSessionArtifactStore, createShellTool, createTodolistTool, createWebFetchTool, createWebSearchTool, createWriteFileTool, createWriteStdinTool, denyCatastrophicCommands, formatCode, formatDiff, formatError, formatFileList, injectGuidance, isBlockedIp, isCommandAllowed, renderToolList, replaceUnique, resolveAndScreen, screenedFetch, todoItemsToPlanNodes, truncateOutput, withDefaultGuidance, withDescription, withName, withShellExitGuidance, withToolResultGuidance };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map