@2kw/ai 6.3.0-dev.45 → 6.3.0-dev.61

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

@@ -106,6 +106,9 @@ export declare const agentSchema: {
                 readonly destructiveHint: {
                     readonly type: "boolean";
                 };
+                readonly openWorldHint: {
+                    readonly type: "boolean";
+                };
             };
         };
         readonly fileSearchTool: {

package/dist/agent-config/schema.js

@@ -84,7 +84,13 @@ export const agentSchema = {
         annotations: {
             type: "object",
             required: ["readOnlyHint", "destructiveHint"],
-            properties: { readOnlyHint: { type: "boolean" }, destructiveHint: { type: "boolean" } },
+            properties: {
+                readOnlyHint: { type: "boolean" },
+                destructiveHint: { type: "boolean" },
+                // Optional. With destructiveHint: false it declares the tool harmless, so a write under
+                // `auto` may reach the approver (#938).
+                openWorldHint: { type: "boolean" },
+            },
         },
         fileSearchTool: {
             type: "object",

package/dist/agent-config/template.js

@@ -43,7 +43,7 @@ tools: []
 #       properties:
 #         order: { type: string }
 #       required: [order]
-#     annotations: { readOnlyHint: true, destructiveHint: false }
+#     annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false }
 # Approval policy. Defaults: read allow, write approve, destructive block. Rules can only tighten.
 # hitlPolicy:
 #   version: 1

package/dist/commands/experiments.js

@@ -131,7 +131,7 @@ export function makeExperimentsCommand() {
         .description("Add a variant to an experiment")
         .requiredOption("--experiment <id>", "Experiment ID")
         .requiredOption("-n, --name <name>", "Variant name")
-        .requiredOption("--task-type <type>", "Task type")
+        .requiredOption("--task-type <type>", "Task type: extraction or agent")
         .requiredOption("--config <json>", "Variant configuration (JSON)")
         .option("-d, --description <text>", "Variant description")
         .option("--sort-order <n>", "Sort order", parseInt)
@@ -179,7 +179,7 @@ export function makeExperimentsCommand() {
         .argument("<variantId>", "Variant ID")
         .requiredOption("--experiment <id>", "Experiment ID")
         .option("-n, --name <name>", "Variant name")
-        .option("--task-type <type>", "Task type")
+        .option("--task-type <type>", "Task type; must equal the variant's current one (it cannot change)")
         .option("--config <json>", "Variant configuration (JSON)")
         .option("-d, --description <text>", "Variant description")
         .option("--sort-order <n>", "Sort order", parseInt)

package/dist/commands/skill-versions.js

@@ -1,4 +1,4 @@
-import { Command } from "commander";
+import { Command, InvalidArgumentError } from "commander";
 import { readFileSync } from "node:fs";
 import { getClient, runAction } from "../lib/client.js";
 import { formatPage, formatDetail } from "../lib/output.js";
@@ -48,6 +48,32 @@ export function makeSkillVersionsCommand() {
             formatDetail(data, command);
         });
     });
+    cmd
+        .command("restore")
+        .description("Restore a version as a new version; latest moves to it (the newest version is reused when it already has the content)")
+        .argument("<id>", "Skill ID")
+        .argument("<versionNumber>", "Version number to restore", parseVersionNumber)
+        .action(async (id, versionNumber, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data, response } = await client.POST("/v1/skills/{id}/versions/{versionNumber}/restore", {
+                params: { path: { id, versionNumber } },
+            });
+            // 200, not 201: the newest version already had the content and latest moved to it.
+            if (response.status === 200 && data) {
+                console.error(`No new version: v${data.versionNumber} already has the content of v${versionNumber}; latest now points at v${data.versionNumber}.`);
+            }
+            formatDetail(data, command);
+        });
+    });
     return cmd;
 }
+/** A restore names an existing version by number; refuse anything else before calling the API (#783). */
+function parseVersionNumber(value) {
+    const n = Number(value);
+    if (!/^\d+$/.test(value) || n < 1) {
+        throw new InvalidArgumentError("Version number must be a positive integer.");
+    }
+    return n;
+}
 //# sourceMappingURL=skill-versions.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2kw/ai",
-  "version": "6.3.0-dev.45",
+  "version": "6.3.0-dev.61",
   "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",