@2kw/ai 7.3.0-dev.9 → 7.3.1

package/dist/agent-config/schema.d.ts

@@ -5,7 +5,10 @@
  * Kept as a TS constant: package.json `files` publishes only dist JS/d.ts.
  */
 export declare const AGENT_SCHEMA_ID = "https://docs.2kw.ai/schemas/agent.v1.json";
-/** Types the backend injects or cannot execute; authoring them has no effect or breaks the run. */
+/**
+ * Types the backend injects or cannot execute; authoring them has no effect or breaks the run.
+ * The backend refuses the same map on save (NonAuthorableTools, #1263); its test fails if they differ.
+ */
 export declare const NON_AUTHORABLE_TOOL_TYPES: Record<string, string>;
 export declare const agentSchema: {
     readonly $schema: "https://json-schema.org/draft/2020-12/schema";
@@ -209,6 +212,35 @@ export declare const agentSchema: {
                 };
             };
         };
+        readonly webFetchTool: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["type"];
+            readonly properties: {
+                readonly type: {
+                    readonly const: "web_fetch";
+                };
+                readonly config: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly source: {
+                            readonly enum: readonly ["proxy", "native"];
+                        };
+                        readonly allowedDomains: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                                readonly pattern: "^(?=.{1,253}$)([\\p{L}\\p{N}](?:[\\p{L}\\p{N}-]{0,61}[\\p{L}\\p{N}])?\\.)+\\p{L}(?:[\\p{L}\\p{N}-]{0,61}[\\p{L}\\p{N}])?$";
+                            };
+                            readonly maxItems: 10;
+                        };
+                    };
+                };
+                readonly requiresConfirmation: {
+                    readonly type: "boolean";
+                };
+            };
+        };
         readonly extractionTool: {
             readonly type: "object";
             readonly additionalProperties: false;
@@ -389,6 +421,18 @@ export declare const agentSchema: {
                 readonly then: {
                     readonly $ref: "#/$defs/webSearchTool";
                 };
+            }, {
+                readonly if: {
+                    required: string[];
+                    properties: {
+                        type: {
+                            const: string;
+                        };
+                    };
+                };
+                readonly then: {
+                    readonly $ref: "#/$defs/webFetchTool";
+                };
             }, {
                 readonly if: {
                     required: string[];

package/dist/agent-config/schema.js

@@ -20,9 +20,13 @@ const MODEL_REF = {
 // inner hyphens, Unicode or ASCII. Mirrors WebToolEntryValidator.HOST; needs a Unicode-aware regex engine.
 const HOSTNAME = "^(?=.{1,253}$)([\\p{L}\\p{N}](?:[\\p{L}\\p{N}-]{0,61}[\\p{L}\\p{N}])?\\.)+\\p{L}(?:[\\p{L}\\p{N}-]{0,61}[\\p{L}\\p{N}])?$";
 const oneOfLowercase = (...values) => ({ type: "string", enum: values });
-/** Types the backend injects or cannot execute; authoring them has no effect or breaks the run. */
+/**
+ * Types the backend injects or cannot execute; authoring them has no effect or breaks the run.
+ * The backend refuses the same map on save (NonAuthorableTools, #1263); its test fails if they differ.
+ */
 export const NON_AUTHORABLE_TOOL_TYPES = {
-    "backbone.tool_search": "the planner adds it automatically",
+    "backbone.tool_search": "it is added automatically when tool discovery is on",
+    "backbone.tool_call": "it is added automatically when tool discovery is on",
     "backbone.skill_read": "it is added at run time when skills are pinned",
     // #944: SkillsetPinner injects it for eligible callers and strips any stored copy (#779).
     "backbone.skills_apply": "it is added at run time for callers allowed to author skills",
@@ -34,6 +38,7 @@ export const NON_AUTHORABLE_TOOL_TYPES = {
 const BUILTIN_TYPES = [
     "file_search",
     "web_search",
+    "web_fetch",
     "backbone.extraction",
     "backbone.document_convert",
     "backbone.todo",
@@ -150,6 +155,24 @@ export const agentSchema = {
                 requiresConfirmation: { type: "boolean" },
             },
         },
+        // Backbone's own fetcher reads a page the user or an earlier search named. A missing config, `config: {}`
+        // or a missing source is the proxy; `native` is accepted and answers provider_unavailable until it ships.
+        webFetchTool: {
+            type: "object",
+            additionalProperties: false,
+            required: ["type"],
+            properties: {
+                type: { const: "web_fetch" },
+                config: {
+                    type: "object",
+                    properties: {
+                        source: { enum: ["proxy", "native"] },
+                        allowedDomains: { type: "array", items: { type: "string", pattern: HOSTNAME }, maxItems: 10 },
+                    },
+                },
+                requiresConfirmation: { type: "boolean" },
+            },
+        },
         extractionTool: {
             type: "object",
             additionalProperties: false,
@@ -237,6 +260,7 @@ export const agentSchema = {
             allOf: [
                 { if: typeIs("file_search"), then: { $ref: "#/$defs/fileSearchTool" } },
                 { if: typeIs("web_search"), then: { $ref: "#/$defs/webSearchTool" } },
+                { if: typeIs("web_fetch"), then: { $ref: "#/$defs/webFetchTool" } },
                 { if: typeIs("backbone.extraction"), then: { $ref: "#/$defs/extractionTool" } },
                 { if: typeIs("backbone.document_convert"), then: { $ref: "#/$defs/documentConvertTool" } },
                 { if: typeIs("backbone.todo"), then: { $ref: "#/$defs/todoTool" } },

package/dist/agent-config/template.js

@@ -29,6 +29,9 @@ tools: []
 #   - type: web_search
 #     config:
 #       allowedDomains: [example.com]
+#   - type: web_fetch
+#     config:
+#       allowedDomains: [example.com]
 #   - type: backbone.extraction
 #     config:
 #       schemaIds: [schema_id]

package/dist/agent-config/validate.js

@@ -8,6 +8,8 @@ const NULLABLE_KEYS = ["description", "models", "instructions", "tools", "hitlPo
 const TOOL_RULE_CLASSES = new Set(["read", "write", "destructive"]);
 /** web_search config keys whose explicit `null` the backend reads as absent. */
 const WEB_SEARCH_NULLABLE_KEYS = ["source", "fallback", "searchProviderId", "allowedDomains"];
+/** web_fetch config keys whose explicit `null` the backend reads as absent. */
+const WEB_FETCH_NULLABLE_KEYS = ["source", "allowedDomains"];
 const isPlainObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 /**
  * A deep copy of `doc` in the form the backend actually checks: explicit nulls it treats as absent
@@ -34,7 +36,9 @@ export function normalizeForValidation(doc) {
             if (isPlainObject(tool) && tool.annotations === null)
                 delete tool.annotations;
             if (isPlainObject(tool) && tool.type === "web_search")
-                normalizeWebSearch(tool);
+                normalizeWebTool(tool, WEB_SEARCH_NULLABLE_KEYS);
+            if (isPlainObject(tool) && tool.type === "web_fetch")
+                normalizeWebTool(tool, WEB_FETCH_NULLABLE_KEYS);
         }
     }
     const policy = copy.hitlPolicy;
@@ -55,13 +59,13 @@ export function normalizeForValidation(doc) {
     return copy;
 }
 /** WebToolEntryValidator reads a null config and null config fields as absent, and trims each domain. */
-function normalizeWebSearch(tool) {
+function normalizeWebTool(tool, nullableKeys) {
     if (tool.config === null)
         delete tool.config;
     const config = tool.config;
     if (!isPlainObject(config))
         return;
-    for (const key of WEB_SEARCH_NULLABLE_KEYS) {
+    for (const key of nullableKeys) {
         if (config[key] === null)
             delete config[key];
     }
@@ -125,6 +129,7 @@ export function validateAgentConfig(raw) {
     }
     if (Array.isArray(record.tools)) {
         let webSearchSeen = false;
+        let webFetchSeen = false;
         record.tools.forEach((tool, i) => {
             const type = tool?.type;
             if (typeof type === "string" && Object.hasOwn(NON_AUTHORABLE_TOOL_TYPES, type)) {
@@ -136,6 +141,11 @@ export function validateAgentConfig(raw) {
                     issues.push({ pointer: `/tools/${i}/type`, message: "an agent may carry only one web_search tool" });
                 webSearchSeen = true;
             }
+            if (type === "web_fetch") {
+                if (webFetchSeen)
+                    issues.push({ pointer: `/tools/${i}/type`, message: "an agent may carry only one web_fetch tool" });
+                webFetchSeen = true;
+            }
         });
     }
     if (Array.isArray(record.skills)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2kw/ai",
-  "version": "7.3.0-dev.9",
+  "version": "7.3.1",
   "description": "CLI for 2kw.ai — schema-driven document extraction, an OpenAI-compatible EU LLM gateway, transcription, prompts, datasets, and experiments from your terminal or agentic workflows. Ships as 2kw, backbone, and bb.",
   "keywords": [
     "cli",