@w6w/cli 0.9.30 → 0.9.32

package/dist/src/commands/version.js

@@ -0,0 +1,116 @@
+/**
+ * `w6w version` and `w6w --version` / `-v` — one handler, versions only.
+ *
+ * Prints this CLI's own version plus the server's `version` and `composition`,
+ * and **no identity**: nothing here says who the caller is (that is `w6w me`).
+ * The server half comes from `GET <resolved base URL>/version`, which is
+ * unauthenticated — so **no `Authorization` header is ever sent**, whatever
+ * token a flag, the environment or the store holds, and a missing token is
+ * irrelevant. The request is bounded by {@linkcode VERSION_TIMEOUT_MS}.
+ *
+ * It **never fails**. An invalid base URL, an unreadable store, a refused
+ * connection, a timeout, a non-2xx, a body that is not JSON or lacks string
+ * `version`/`composition` — each makes the server *unavailable*, reported as
+ * `server: unavailable (<reason>)`, and the exit code is still 0. A banner that
+ * could break a script because the server is down would be worse than no banner.
+ *
+ * Text applies the D5 display rule (`0.0.0` / empty shows as `dev`, shared with
+ * `w6w me`); `--json` carries the raw values, through the normal emit path:
+ * `{wrapper, server | null, composition | null, serverError?}`.
+ *
+ * @module
+ */
+import { resolveSettings } from "../client.js";
+import { displayVersion } from "./shared.js";
+/** How long the `/version` request may take before the server counts as unavailable. */
+export const VERSION_TIMEOUT_MS = 3000;
+/** The first line of an error's message, short enough to sit in parentheses. */
+function reasonOf(error) {
+    const text = error instanceof Error ? error.message : String(error);
+    const line = text.split("\n")[0].trim();
+    return line.length > 0 ? line.slice(0, 120) : "request failed";
+}
+async function fetchServerVersions(context, fetchImpl) {
+    let baseUrl;
+    try {
+        // The resolver also resolves a token; a token it refuses (unsendable) is a
+        // reason unrelated to this command, so it is deliberately not our problem:
+        // retry the base URL alone with the token sources stripped.
+        baseUrl = resolveSettings({ ...context.invocation.globals, token: undefined }, (name) => name === "W6W_TOKEN" ? undefined : context.env(name), { ...context.stored, hosts: {} }).baseUrl;
+    }
+    catch (error) {
+        return { ok: false, reason: reasonOf(error) };
+    }
+    const controller = new AbortController();
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            reject(new Error(`timed out after ${VERSION_TIMEOUT_MS / 1000}s`));
+            controller.abort();
+        }, VERSION_TIMEOUT_MS);
+    });
+    try {
+        // Explicitly header-free: no Authorization, no credentials of any kind.
+        const response = await Promise.race([
+            fetchImpl(`${baseUrl}/version`, {
+                method: "GET",
+                headers: { accept: "application/json" },
+                signal: controller.signal,
+            }),
+            timeout,
+        ]);
+        if (!response.ok)
+            return { ok: false, reason: `HTTP ${response.status}` };
+        let body;
+        try {
+            body = await Promise.race([response.json(), timeout]);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.startsWith("timed out"))
+                throw error;
+            return { ok: false, reason: "response was not JSON" };
+        }
+        const record = typeof body === "object" && body !== null && !Array.isArray(body)
+            ? body
+            : {};
+        if (typeof record.version !== "string" || typeof record.composition !== "string") {
+            return { ok: false, reason: "unexpected response" };
+        }
+        return { ok: true, version: record.version, composition: record.composition };
+    }
+    catch (error) {
+        return { ok: false, reason: reasonOf(error) };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Report the wrapper and server versions. Always returns normally.
+ *
+ * @param context - The invocation, renderer, environment and stored config.
+ * @param wrapper - This CLI's own version.
+ * @param fetchImpl - The transport; defaults to `globalThis.fetch`.
+ */
+export async function reportVersions(context, wrapper, fetchImpl) {
+    const transport = fetchImpl ?? ((input, init) => globalThis.fetch(input, init));
+    const server = await fetchServerVersions(context, transport);
+    const payload = {
+        wrapper,
+        server: server.ok ? server.version : null,
+        composition: server.ok ? server.composition : null,
+    };
+    if (!server.ok)
+        payload.serverError = server.reason;
+    context.out.emit(payload, (_styles) => {
+        const lines = [`wrapper: ${displayVersion(wrapper)}`];
+        if (server.ok) {
+            lines.push(`server: ${displayVersion(server.version)}`, `composition: ${displayVersion(server.composition)}`);
+        }
+        else {
+            lines.push(`server: unavailable (${server.reason})`);
+        }
+        return lines.join("\n");
+    });
+}
+//# sourceMappingURL=version.js.map

package/dist/src/commands/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/commands/version.ts"],"names":[],"mappings":"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"}

package/dist/src/help.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.generated.d.ts","sourceRoot":"","sources":["../../src/help.generated.ts"],"names":[],"mappings":"AAiBA,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;IACpB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,gDAAgD;IAChD,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,8BAA8B;AAC9B,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4EAA4E;AAC5E,eAAO,MAAM,SAAS,EAAE,QAiwMvB,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,aAAa,EAAE,MAAM,EAAE,EAogBnC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,UAAU,EAAE,YAAY,EAqBpC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,MAAU,CAAC;AACtC,eAAO,MAAM,UAAU,EAAE,MAAU,CAAC;AACpC,eAAO,MAAM,cAAc,EAAE,MAAU,CAAC;AACxC,eAAO,MAAM,gBAAgB,EAAE,MAAU,CAAC;AAE1C,wEAAwE;AACxE,eAAO,MAAM,YAAY,EAAE,cAAc,EAA0B,CAAC"}
+{"version":3,"file":"help.generated.d.ts","sourceRoot":"","sources":["../../src/help.generated.ts"],"names":[],"mappings":"AAiBA,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;IACpB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,gDAAgD;IAChD,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,8BAA8B;AAC9B,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4EAA4E;AAC5E,eAAO,MAAM,SAAS,EAAE,QA8yMvB,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,aAAa,EAAE,MAAM,EAAE,EAugBnC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,UAAU,EAAE,YAAY,EAqBpC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,MAAU,CAAC;AACtC,eAAO,MAAM,UAAU,EAAE,MAAU,CAAC;AACpC,eAAO,MAAM,cAAc,EAAE,MAAU,CAAC;AACxC,eAAO,MAAM,gBAAgB,EAAE,MAAU,CAAC;AAE1C,wEAAwE;AACxE,eAAO,MAAM,YAAY,EAAE,cAAc,EAA0B,CAAC"}

package/dist/src/help.generated.js

@@ -17,7 +17,7 @@
 /** The command tree, generated from the shared wrapper surface contract. */
 export const HELP_TREE = {
     "binary": "w6w",
-    "contractVersion": "0.15.0",
+    "contractVersion": "0.16.0",
     "tagline": "command-line client for the w6w workflow platform",
     "usage": "w6w <command> [options]",
     "docsUrl": "https://w6w.dev/docs/cli",
@@ -191,6 +191,35 @@ export const HELP_TREE = {
             ],
             "notes": [],
         },
+        {
+            "operation": "version",
+            "path": [
+                "version",
+            ],
+            "name": "version",
+            "aliases": [],
+            "summary": "Show this CLI's version and the server's version and composition (no identity).",
+            "short": "Show this CLI's version and the server's version and composition (no identity)",
+            "headline": "show this CLI's version and the server's version and composition (no identity)",
+            "usage": "w6w version [options]",
+            "naming": "w6w version",
+            "status": "live",
+            "params": [
+                {
+                    "name": "json",
+                    "kind": "flag",
+                    "display": "--json",
+                    "description": "Output raw JSON instead of a table",
+                    "required": false,
+                },
+            ],
+            "examples": [
+                "w6w version",
+                "w6w version --json",
+                "w6w --version",
+            ],
+            "notes": [],
+        },
         {
             "operation": "ls",
             "path": [
@@ -4535,7 +4564,7 @@ export const HELP_TREE = {
                     "short": "Create an agent draft",
                     "headline": "create an agent draft",
                     "usage": "w6w agents create [options]",
-                    "naming": "w6w agents create [--name <n>] [--instructions <text>] [--model-route-id <id>] [--skills <json>] [--context <json>] [--visibility private|project|account] [--project <id>] [--temperature <n>] [--top-p <n>] [--max-output-tokens <n>] [--stop <text>]...",
+                    "naming": "w6w agents create [--name <n>] [--instructions <text>] [--model-route-id <id>] [--skills <json>] [--context <json>] [--visibility private|project|account] [--project <id>] [--temperature <n>] [--top-p <n>] [--max-output-tokens <n>] [--stop <text>]... [--tools <json>]",
                     "status": "required",
                     "params": [
                         {
@@ -4615,6 +4644,13 @@ export const HELP_TREE = {
                             "description": "Stop sequence; repeat the flag for more (at most 4)",
                             "required": false,
                         },
+                        {
+                            "name": "tools",
+                            "kind": "flag",
+                            "display": "--tools <json>",
+                            "description": 'Tools the agent may call (max 50), as a JSON array of {"kind":"action","uses":{"app":"…","action":"…"}} | {"kind":"function","function":"fn_…"} | {"kind":"workflow","workflow":"wf_…"}, each with an optional "description"',
+                            "required": false,
+                        },
                         {
                             "name": "json",
                             "kind": "flag",
@@ -4676,7 +4712,7 @@ export const HELP_TREE = {
                     "short": "Patch an agent draft",
                     "headline": "patch an agent draft",
                     "usage": "w6w agents update <id> --revision <n> [options]",
-                    "naming": "w6w agents update <id> --revision <n> [--name <n>] [--instructions <text>] [--model-route-id <id>] [--skills <json>] [--context <json>] [--visibility private|project|account] [--project <id>] [--if-unmodified-since <ts>] [--temperature <n>] [--top-p <n>] [--max-output-tokens <n>] [--stop <text>]...",
+                    "naming": "w6w agents update <id> --revision <n> [--name <n>] [--instructions <text>] [--model-route-id <id>] [--skills <json>] [--context <json>] [--visibility private|project|account] [--project <id>] [--if-unmodified-since <ts>] [--temperature <n>] [--top-p <n>] [--max-output-tokens <n>] [--stop <text>]... [--tools <json>]",
                     "status": "required",
                     "params": [
                         {
@@ -4777,6 +4813,13 @@ export const HELP_TREE = {
                             "description": "Stop sequence; repeat the flag for more (at most 4)",
                             "required": false,
                         },
+                        {
+                            "name": "tools",
+                            "kind": "flag",
+                            "display": "--tools <json>",
+                            "description": 'Tools the agent may call (max 50), as a JSON array of {"kind":"action","uses":{"app":"…","action":"…"}} | {"kind":"function","function":"fn_…"} | {"kind":"workflow","workflow":"wf_…"}, each with an optional "description"',
+                            "required": false,
+                        },
                         {
                             "name": "json",
                             "kind": "flag",
@@ -6324,6 +6367,9 @@ export const COMMAND_PATHS = [
     [
         "model-usage",
     ],
+    [
+        "version",
+    ],
     [
         "ls",
     ],