@2kw/ai 6.2.0-dev.42 → 6.2.0-dev.44

package/dist/commands/agent-policy.d.ts

@@ -0,0 +1,11 @@
+import { Command } from "commander";
+/**
+ * `agents policy <agent>` — what the policy gate would do to a call of each tool
+ * a version configures, without running the agent (&56 S6, #662).
+ *
+ * Answers the question an operator otherwise has to answer by running the agent
+ * and reading the transcript. The version defaults to the agent's latest, which
+ * is the one an unlabelled reference resolves to.
+ */
+export declare function makeAgentPolicyCommand(): Command;
+//# sourceMappingURL=agent-policy.d.ts.map

package/dist/commands/agent-policy.js

@@ -0,0 +1,64 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import { getClient, runAction } from "../lib/client.js";
+import { isJsonOutput } from "../lib/config.js";
+import { formatDetail, formatList } from "../lib/output.js";
+import { resolveAgent } from "../lib/agent-lookup.js";
+import { CliUsageError } from "../lib/errors.js";
+import { getLatestVersion } from "./agent-apply.js";
+/**
+ * `agents policy <agent>` — what the policy gate would do to a call of each tool
+ * a version configures, without running the agent (&56 S6, #662).
+ *
+ * Answers the question an operator otherwise has to answer by running the agent
+ * and reading the transcript. The version defaults to the agent's latest, which
+ * is the one an unlabelled reference resolves to.
+ */
+export function makeAgentPolicyCommand() {
+    return new Command("policy")
+        .description("Show the effective tool policy of an agent version")
+        .argument("<agent>", "Agent ID or name")
+        .option("--version <id>", "Agent version ID (default: the agent's latest version)")
+        .option("--tool <name>", "Answer for one tool instead of every configured tool")
+        .option("--installation <id>", "Resolve the module tool catalog of this installation")
+        .action(async (agentRef, opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const agent = await resolveAgent(client, agentRef);
+            const agentId = agent.id;
+            const versionId = opts.version ?? (await getLatestVersion(client, agentId))?.id;
+            if (!versionId) {
+                throw new CliUsageError(`Agent '${agent.name}' has no versions yet, so it has no policy to read. Create a version first.`);
+            }
+            const { data } = await client.GET("/v1/agents/{agentId}/versions/{versionId}/policy", {
+                params: {
+                    path: { agentId, versionId },
+                    query: { tool: opts.tool, installation: opts.installation },
+                },
+            });
+            if (isJsonOutput(command)) {
+                formatDetail(data, command);
+                return;
+            }
+            // Both deployment switches decide whether a JUDGE row ever reaches a
+            // model, so they belong above the table rather than in a footnote.
+            const auto = data?.autoApproval;
+            const parts = [
+                `auto-approval ${auto?.enabled ? "on" : "off (every auto pauses for a human)"}`,
+                `judge ${auto?.judgeConfigured ? "configured" : "not configured (every candidate escalates)"}`,
+            ];
+            if (data?.catalogResolvedAt)
+                parts.push(`catalog resolved ${data.catalogResolvedAt}`);
+            console.log(chalk.dim(parts.join(", ")));
+            formatList(data?.tools, command, [
+                "tool",
+                "verdict",
+                "action",
+                "policyClass",
+                "source",
+                "matchedRules",
+            ]);
+        });
+    });
+}
+//# sourceMappingURL=agent-policy.js.map

package/dist/commands/agents.js

@@ -7,6 +7,7 @@ import { makeAgentLabelsCommand } from "./agent-labels.js";
 import { makeAgentDecideCommand, makeAgentRunCommand } from "./agent-run.js";
 import { makeAgentApplyCommand } from "./agent-apply.js";
 import { makeAgentExportCommand } from "./agent-export.js";
+import { makeAgentPolicyCommand } from "./agent-policy.js";
 import { makeAgentInitCommand, makeAgentSchemaCommand } from "./agent-init.js";
 import { maskSecrets } from "../agent-config/file.js";
 import { collectModel, MODEL_HELP, MODELS_HELP, modelFieldsFromOptions } from "../lib/agent-models.js";
@@ -162,6 +163,7 @@ export function makeAgentsCommand() {
     cmd.addCommand(makeAgentExportCommand());
     cmd.addCommand(makeAgentInitCommand());
     cmd.addCommand(makeAgentSchemaCommand());
+    cmd.addCommand(makeAgentPolicyCommand());
     cmd.addCommand(makeAgentVersionsCommand());
     cmd.addCommand(makeAgentLabelsCommand());
     return cmd;

package/package.json

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