@theokit/sdk-tools 0.6.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.8.0
+
+### Minor Changes
+
+- ac3f77d: @theokit/sdk: resolveModelCapabilities catalog gains cheap OpenRouter slugs (qwen3-coder, deepseek v4-flash/v3.2, glm-4.7-flash, gemini-2.5-flash-lite/pro) so they resolve real context windows instead of the 4096 default. @theokit/sdk-tools: new createGenericHttpSearchAdapter (env-keyed generic HTTP WebSearchCallback alongside Brave); buildEnvContext gains git-branch detection + an injectable clock. @theokit/sdk-cache: ships createLexicalEmbedder (zero-dependency token-hash lexical embedder built-in).
+
+## 0.7.0
+
+### Minor Changes
+
+- 5bd2f9c: @theokit/sdk: `shouldCompact`/`ShouldCompactInput` gains an optional `maxOutput` output-reserve term (`estimated >= contextWindow - buffer - (maxOutput ?? 0)`), defaulting to today's behavior. `AgentOptions.plugins` now also accepts an array of code `Plugin` objects (matching the runtime + docs), not only `{ enabled }`. @theokit/sdk-tools: `renderToolList` gains an optional `{ mode: "full" | "summary" | "names" }` — `"full"` (default) is the existing `<tools>` XML; `"summary"` renders `- name: <first sentence>`; `"names"` renders `- name`.
+
 ## 0.6.0
 
 ### Minor Changes

package/dist/index.cjs

@@ -887,15 +887,26 @@ function safeReadHead(p, n) {
     return "";
   }
 }
-function buildEnvContext(cwd) {
+function gitBranch(headPath) {
+  try {
+    const head = fs.readFileSync(headPath, "utf-8").trim();
+    const match = head.match(/^ref:\s*refs\/heads\/(.+)$/);
+    return match ? match[1] : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function buildEnvContext(cwd, opts = {}) {
   const lines = [
     "<env>",
     `  Working directory: ${cwd}`,
     `  Platform: ${process.platform} (${process.arch})`,
     `  Node: ${process.version}`,
-    `  Is git repo: ${safeExists(path.join(cwd, ".git")) ? "yes" : "no"}`,
-    `  Today's date: ${(/* @__PURE__ */ new Date()).toDateString()}`
+    `  Is git repo: ${safeExists(path.join(cwd, ".git")) ? "yes" : "no"}`
   ];
+  const branch = gitBranch(opts.gitHeadPath ?? path.join(cwd, ".git", "HEAD"));
+  if (branch) lines.push(`  Branch: ${branch}`);
+  lines.push(`  Today's date: ${(opts.now ?? /* @__PURE__ */ new Date()).toDateString()}`);
   const docs = PROJECT_DOCS.filter((d) => safeExists(path.join(cwd, d)));
   if (docs.length > 0) {
     lines.push(`  Project docs: ${docs.join(", ")}`);
@@ -981,7 +992,18 @@ function withDescription(tool, description) {
 function esc(s) {
   return String(s).replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 }
-function renderToolList(tools) {
+function firstSentence(d) {
+  const m = d.trim().match(/\.\s+(?=[A-Z(]|$)/);
+  return m?.index == null ? d.trim() : d.trim().slice(0, m.index + 1);
+}
+function renderToolList(tools, options) {
+  const mode = options?.mode ?? "full";
+  if (mode === "summary") {
+    return tools.map((t) => `- ${t.name}: ${firstSentence(t.description)}`).join("\n");
+  }
+  if (mode === "names") {
+    return tools.map((t) => `- ${t.name}`).join("\n");
+  }
   if (tools.length === 0) return "<tools></tools>";
   const lines = ["<tools>"];
   for (const t of tools) {
@@ -1923,6 +1945,29 @@ function createBraveWebSearchAdapter(opts = {}) {
     }));
   };
 }
+
+// src/web-search-http.ts
+function createGenericHttpSearchAdapter(opts = {}) {
+  const apiKey = opts.apiKey ?? process.env.THEOKIT_SEARCH_API_KEY;
+  const endpoint = opts.endpoint ?? process.env.THEOKIT_SEARCH_API_URL;
+  const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+  return async (query, maxResults) => {
+    if (!apiKey || !endpoint) return [];
+    try {
+      const url = `${endpoint}?q=${encodeURIComponent(query)}&n=${maxResults}`;
+      const res = await fetchImpl(url, { headers: { Authorization: `Bearer ${apiKey}` } });
+      if (!res.ok) return [];
+      const data = await res.json();
+      return (data?.results ?? []).slice(0, maxResults).map((r) => ({
+        title: String(r?.title ?? ""),
+        url: String(r?.url ?? ""),
+        snippet: String(r?.snippet ?? "")
+      }));
+    } catch {
+      return [];
+    }
+  };
+}
 var BINARY_PROBE_BYTES3 = 8 * 1024;
 function createWriteFileTool(opts) {
   const { projectRoot } = opts;
@@ -1990,6 +2035,7 @@ exports.commandDenialReason = commandDenialReason;
 exports.createApplyPatchTool = createApplyPatchTool;
 exports.createBraveWebSearchAdapter = createBraveWebSearchAdapter;
 exports.createEditFileTool = createEditFileTool;
+exports.createGenericHttpSearchAdapter = createGenericHttpSearchAdapter;
 exports.createGitDiffTool = createGitDiffTool;
 exports.createGlobTool = createGlobTool;
 exports.createListDirTool = createListDirTool;