@2kw/ai 6.3.0-dev.36 → 6.3.0-dev.39

package/dist/commands/conversations.js

@@ -98,6 +98,22 @@ export function makeConversationsCommand() {
             formatSuccess(`Conversation ${conversationId} deleted.`, command);
         });
     });
+    cmd
+        .command("cancel")
+        .description("Ask a running turn of a conversation to stop")
+        .argument("<conversationId>", "Conversation ID")
+        .requiredOption("--turn <turnId>", "The turn id the client sent as the Backbone-Turn-Id header")
+        .action(async (conversationId, opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            await client.POST("/v1/conversations/{conversationId}/cancel", {
+                params: { path: { conversationId } },
+                body: { turn_id: opts.turn },
+            });
+            // Accepted, not performed: the turn's own response says whether it stopped.
+            formatSuccess(`Stop requested for turn ${opts.turn} of conversation ${conversationId}.`, command);
+        });
+    });
     const items = new Command("items").description("List a conversation's items");
     items
         .command("list")

package/dist/lib/agent-run.d.ts

@@ -1,5 +1,8 @@
+import type { components } from "../generated/openapi.js";
 type AnyRecord = Record<string, any>;
 export type RunStatus = "completed" | "requires_approval" | "requires_tool_output" | "incomplete";
+/** A built-in SkillsApply approval's preview (#781, spec §6); the generated type, fields all optional. */
+export type SkillsApplyPreview = components["schemas"]["SkillsApplyPreview"];
 export interface PendingApproval {
     approvalId: string;
     callId: string;
@@ -8,6 +11,8 @@ export interface PendingApproval {
     policyClass: string;
     /** Why the automatic approver escalated this request to a human (#634); null when it did not. */
     reason: string | null;
+    /** What a built-in SkillsApply change does (#781); null for every other approval. Keyed on presence, not on the tool name (#948). */
+    preview: SkillsApplyPreview | null;
 }
 export interface ToolCallSummary {
     tool: string;

package/dist/lib/agent-run.js

@@ -80,6 +80,7 @@ export function buildRunEnvelope(result, agentRef) {
         arguments: parseArguments(i.arguments),
         policyClass: String(i.policy_class),
         reason: typeof i.reason === "string" && i.reason ? i.reason : null,
+        preview: i.preview && typeof i.preview === "object" && !Array.isArray(i.preview) ? i.preview : null,
     }));
     const withheldCallIds = new Set(pendingApprovals.map((a) => a.callId));
     const toolCalls = [];

package/dist/lib/approval-prompt.js

@@ -1,6 +1,7 @@
 import { createInterface } from "node:readline/promises";
 import chalk from "chalk";
 import { stripControl } from "./agent-run.js";
+import { REMEMBER_NOTE, previewIsIncomplete, previewLines } from "./skills-apply-preview.js";
 /** Raised when the prompt's input closes (EOF, Ctrl+C, Ctrl+D) before an answer arrives. */
 export class PromptAbortedError extends Error {
     constructor() {
@@ -54,7 +55,23 @@ export async function promptApprovals(pending, ask, write = (line) => console.er
         const destructive = a.policyClass.toLowerCase() === "destructive";
         write(chalk.yellow(`\nApproval ${index + 1}/${pending.length}: ${s(a.tool)} [${s(a.policyClass)}]`));
         // JSON.stringify escapes C0 controls but leaves DEL and C1 raw.
-        write(chalk.dim(s(JSON.stringify(a.arguments, null, 2))));
+        const request = () => write(chalk.dim(s(JSON.stringify(a.arguments, null, 2))));
+        if (a.preview) {
+            // A SkillsApply change reads as its diff (#782, spec §10). When the preview leaves changes
+            // out, the full arguments follow it: this prompt never runs with --json, so it is the only
+            // place the member can read what would persist (spec D7).
+            for (const line of previewLines(a.preview))
+                write(colourPreviewLine(s(line)));
+            if (previewIsIncomplete(a.preview)) {
+                write(chalk.dim("Full request (the preview leaves changes out):"));
+                request();
+            }
+            if (!destructive)
+                write(chalk.dim(REMEMBER_NOTE));
+        }
+        else {
+            request();
+        }
         if (a.reason)
             write(chalk.dim(`reason: ${s(a.reason)}`));
         const question = destructive ? "[a]pprove / [r]eject? " : "[a]pprove / [r]eject / approve and [R]emember? ";
@@ -81,4 +98,17 @@ export async function promptApprovals(pending, ask, write = (line) => console.er
     }
     return answers;
 }
+/** Diff lines sit indented six spaces under their file; only those are coloured. */
+function colourPreviewLine(line) {
+    if (!line.startsWith("      "))
+        return line;
+    const body = line.slice(6);
+    if (body.startsWith("+"))
+        return chalk.green(line);
+    if (body.startsWith("-"))
+        return chalk.red(line);
+    if (body.startsWith("@@"))
+        return chalk.cyan(line);
+    return chalk.dim(line);
+}
 //# sourceMappingURL=approval-prompt.js.map

package/dist/lib/skills-apply-preview.d.ts

@@ -0,0 +1,19 @@
+import type { SkillsApplyPreview } from "./agent-run.js";
+/** The grant's consequence for a SkillsApply change (spec §6, D13), shown next to "approve and Remember". */
+export declare const REMEMBER_NOTE = "approve and Remember: later skill changes you make in this chat apply without asking";
+/**
+ * A SkillsApply preview as plain text, one entry per line (#782, spec §10): per skill where it
+ * starts and the labels it moves, each file with its unified diff indented under it, then the
+ * followers snapshot and the binding. Lines are unstyled and unstripped; the prompt does both.
+ * The generated type marks every field optional and the wire sends nulls, so every read is guarded.
+ */
+export declare function previewLines(preview: SkillsApplyPreview): string[];
+/**
+ * Whether the preview leaves part of the change unseen (#782, spec D7): a skill with files left
+ * out, a diff that was cut, or an add or edit with no diff at all (abandoned as too large, or a
+ * base the server could not read). The prompt then prints the full arguments as well, because a
+ * change that persists must be readable at the prompt. A `put` or `delete` carries no diff by
+ * design and does not count. Guarded like {@link previewLines}: every field optional, nulls on the wire.
+ */
+export declare function previewIsIncomplete(preview: SkillsApplyPreview): boolean;
+//# sourceMappingURL=skills-apply-preview.d.ts.map

package/dist/lib/skills-apply-preview.js

@@ -0,0 +1,94 @@
+/** The grant's consequence for a SkillsApply change (spec §6, D13), shown next to "approve and Remember". */
+export const REMEMBER_NOTE = "approve and Remember: later skill changes you make in this chat apply without asking";
+const OP_WORDS = { add: "new file", edit: "edited", delete: "deleted", put: "uploaded file" };
+/**
+ * A SkillsApply preview as plain text, one entry per line (#782, spec §10): per skill where it
+ * starts and the labels it moves, each file with its unified diff indented under it, then the
+ * followers snapshot and the binding. Lines are unstyled and unstripped; the prompt does both.
+ * The generated type marks every field optional and the wire sends nulls, so every read is guarded.
+ */
+export function previewLines(preview) {
+    const lines = ["Skill changes:"];
+    for (const skill of list(preview.skills)) {
+        const name = String(skill.name ?? "");
+        const from = typeof skill.from === "number" ? skill.from : null;
+        const moves = list(skill.moves).map(String);
+        const start = from === null ? `${name}: new skill` : `${name} v${from} -> new version`;
+        lines.push(`  ${start}${moves.length > 0 ? `, moves ${moves.join(", ")}` : ""}`);
+        if (typeof skill.fork_of_plugin === "string" && skill.fork_of_plugin) {
+            lines.push(`    forks the plugin skill from ${skill.fork_of_plugin}: later plugin syncs no longer move latest`);
+        }
+        for (const file of list(skill.files))
+            lines.push(...fileLines(file));
+        const omitted = typeof skill.files_omitted === "number" ? skill.files_omitted : 0;
+        if (omitted > 0)
+            lines.push(`    ${omitted} more ${omitted === 1 ? "file" : "files"} not shown`);
+    }
+    const followers = preview.followers;
+    if (followers) {
+        const agents = list(followers.agents).map(String);
+        const more = typeof followers.more === "number" ? followers.more : 0;
+        const when = typeof followers.as_of === "string" ? ` (as of ${followers.as_of})` : "";
+        if (agents.length === 0 && more === 0)
+            lines.push(`No agent follows these labels${when}`);
+        else
+            lines.push(`Agents following these labels${when}: ${agents.length > 0 ? agents.join(", ") : `${more} agents`}${agents.length > 0 && more > 0 ? ` and ${more} more` : ""}`);
+    }
+    const agent = preview.agent;
+    const bind = agent ? list(agent.bind).map(String) : [];
+    if (agent && bind.length > 0) {
+        const base = typeof agent.from === "number" ? ` (new agent version from v${agent.from})` : "";
+        lines.push(`Binds ${bind.join(", ")} to this agent${base}`);
+    }
+    return lines;
+}
+/**
+ * Whether the preview leaves part of the change unseen (#782, spec D7): a skill with files left
+ * out, a diff that was cut, or an add or edit with no diff at all (abandoned as too large, or a
+ * base the server could not read). The prompt then prints the full arguments as well, because a
+ * change that persists must be readable at the prompt. A `put` or `delete` carries no diff by
+ * design and does not count. Guarded like {@link previewLines}: every field optional, nulls on the wire.
+ */
+export function previewIsIncomplete(preview) {
+    for (const skill of list(preview.skills)) {
+        if (typeof skill.files_omitted === "number" && skill.files_omitted > 0)
+            return true;
+        for (const file of list(skill.files)) {
+            if (file.truncated === true)
+                return true;
+            if ((file.op === "add" || file.op === "edit") && typeof file.diff !== "string")
+                return true;
+        }
+    }
+    return false;
+}
+function fileLines(file) {
+    const facts = [OP_WORDS[String(file.op)] ?? String(file.op)];
+    if (typeof file.added === "number" && typeof file.removed === "number")
+        facts.push(`+${file.added} -${file.removed}`);
+    if (typeof file.bytes === "number")
+        facts.push(size(file.bytes));
+    const lines = [`    ${String(file.path ?? "")}: ${facts.join(", ")}`];
+    const diff = typeof file.diff === "string" ? file.diff : null;
+    if (diff !== null) {
+        for (const line of diff.split("\n"))
+            lines.push(`      ${line}`);
+        if (file.truncated === true)
+            lines.push("      (diff cut; the counts cover every changed line)");
+    }
+    else if (file.truncated === true) {
+        lines.push(`      too many changes to show: at most +${Number(file.added ?? 0)} -${Number(file.removed ?? 0)} lines`);
+    }
+    return lines;
+}
+function list(value) {
+    return Array.isArray(value) ? value.filter((entry) => entry !== null && entry !== undefined) : [];
+}
+function size(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${Math.round(bytes / 1024)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=skills-apply-preview.js.map

package/package.json

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