@actionway/cli 0.18.5 → 0.18.7

package/dist/index.js

@@ -9353,9 +9353,11 @@ var Transport = class {
   authHeader;
   fetchImpl;
   onResponse;
+  requestHeaders;
   constructor(init) {
     this.baseUrl = init.baseUrl.replace(/\/+$/, "");
     this.authHeader = init.authHeader;
+    this.requestHeaders = init.requestHeaders;
     this.fetchImpl = init.fetchImpl ?? fetch;
     this.onResponse = init.onResponse;
   }
@@ -9392,7 +9394,9 @@ var Transport = class {
   }
   async headers(hasBody, opts) {
     const auth = typeof this.authHeader === "function" ? await this.authHeader() : this.authHeader;
+    const requestHeaders = typeof this.requestHeaders === "function" ? await this.requestHeaders() : this.requestHeaders;
     return {
+      ...requestHeaders,
       authorization: auth,
       accept: "application/json",
       "x-actionway-cli-version": getCliVersion(),
@@ -10324,7 +10328,7 @@ function emitUseWaitHint() {
     message: "The job is still pending. Run actionway wait with this job_ref now; never resubmit the job or create a shell polling loop."
   });
 }
-function registerPollCommand(program2, getTransport3) {
+function registerPollCommand(program2, getTransport2) {
   program2.command("poll").description(
     "Run one authenticated status snapshot for recovery or diagnostics. Use actionway wait for normal async completion."
   ).addHelpText(
@@ -10337,7 +10341,7 @@ function registerPollCommand(program2, getTransport3) {
   ).requiredOption("--job-ref <ref>", "the job_ref returned by a previous async submit").action(async (opts) => {
     try {
       const jobRef = validateJobRef(opts.jobRef);
-      const body = await pollJob(jobRef, getTransport3());
+      const body = await pollJob(jobRef, getTransport2());
       if (body.status === "pending") emitUseWaitHint();
       ok({ job_ref: jobRef, ...body });
     } catch (err) {
@@ -10409,7 +10413,7 @@ async function waitForJob(options) {
     await sleep(Math.min(intervalMs, timeoutMs - elapsedMs));
   }
 }
-function registerWaitCommand(program2, getTransport3) {
+function registerWaitCommand(program2, getTransport2) {
   program2.command("wait").description("Wait for an async job and print only its terminal result.").requiredOption("--job-ref <ref>", "the full job_ref returned by the submit command").option("--timeout-seconds <n>", "maximum wait time in seconds (default: 1800)", Number, 1800).addHelpText(
     "after",
     [
@@ -10427,7 +10431,7 @@ function registerWaitCommand(program2, getTransport3) {
           job_ref: jobRef
         });
       }
-      const transport = getTransport3();
+      const transport = getTransport2();
       const terminal = await waitForJob({
         jobRef,
         timeoutMs: opts.timeoutSeconds * 1e3,
@@ -11068,7 +11072,7 @@ function emitCall(response) {
   }
   ok(response);
 }
-function registerToolsCommands(program2, getTransport3) {
+function registerToolsCommands(program2, getTransport2) {
   const tools = program2.command("tools").description("Discover, inspect, and call Actionway capabilities through the canonical Tool protocol.");
   tools.command("search <query>").description("Search the current capability catalog by natural-language intent.").option("--limit <n>", "maximum candidates (1-5)", (value) => Number(value)).option("--domain <id>", "required capability domain; repeatable", values, []).option("--input-modality <name>", "required input modality; repeatable", values, []).option("--output-modality <name>", "required output modality; repeatable", values, []).option("--effect <name>", "required capability effect; repeatable", values, []).option("--max-price-usd <amount>", "maximum fixed Actionway USD price").action(async (query, options) => {
     const filters = {};
@@ -11078,14 +11082,14 @@ function registerToolsCommands(program2, getTransport3) {
     if (Array.isArray(options.effect) && options.effect.length) filters.effects = options.effect;
     if (typeof options.maxPriceUsd === "string") filters.maxPriceUsd = options.maxPriceUsd;
     try {
-      ok(await getTransport3().searchTools({ query, ...options.limit !== void 0 ? { limit: Number(options.limit) } : {}, ...filters }, { retries: 1 }));
+      ok(await getTransport2().searchTools({ query, ...options.limit !== void 0 ? { limit: Number(options.limit) } : {}, ...filters }, { retries: 1 }));
     } catch (error) {
       failTool(error);
     }
   });
   tools.command("inspect <tool_ref>").description("Read the current canonical Schema, variants, effects, guidance, and Actionway USD price.").action(async (toolRef) => {
     try {
-      ok(await getTransport3().inspectTool(toolRef, { retries: 1 }));
+      ok(await getTransport2().inspectTool(toolRef, { retries: 1 }));
     } catch (error) {
       failTool(error);
     }
@@ -11096,7 +11100,7 @@ function registerToolsCommands(program2, getTransport3) {
         if (toolRef || options.variant || options.inputJson || options.inputFile) {
           throw new CliError("E_SCHEMA", "--resume cannot be combined with tool_ref, --variant, or input arguments.");
         }
-        emitCall(await getTransport3().resumeToolCall(options.resume, { retries: 1 }));
+        emitCall(await getTransport2().resumeToolCall(options.resume, { retries: 1 }));
       }
       if (!toolRef) throw new CliError("E_SCHEMA", "tool_ref is required unless --resume is used.");
       const args = await resolveJsonObjectInlineOrFile(options.inputJson, options.inputFile, {
@@ -11104,7 +11108,7 @@ function registerToolsCommands(program2, getTransport3) {
         file: "--input-file"
       });
       if (!options.inputJson && !options.inputFile) throw new CliError("E_SCHEMA", "Use --input-json or --input-file for canonical arguments.");
-      const response = await getTransport3().callTool({
+      const response = await getTransport2().callTool({
         toolRef,
         ...typeof options.variant === "string" ? { variantId: options.variant } : {},
         arguments: args,
@@ -11216,7 +11220,7 @@ function failFromError(err) {
   }
   fail({ code: "E_BACKEND", message: err instanceof Error ? err.message : String(err) });
 }
-function registerAssetCommands(program2, getTransport3) {
+function registerAssetCommands(program2, getTransport2) {
   const asset = program2.command("asset").description("Register / fetch media assets (groups + assets) for downstream generate-* verbs.");
   asset.command("register").description(
     "Create an asset group and register one Image / Video / Audio asset under it; the server assigns the real group_id."
@@ -11258,7 +11262,7 @@ Examples:
           assetType,
           projectName: String(opts.projectName ?? "default")
         },
-        getTransport3()
+        getTransport2()
       );
       ok(res);
     } catch (err) {
@@ -11267,7 +11271,7 @@ Examples:
   });
   asset.command("get").description("Fetch a single asset by id.").requiredOption("--id <id>").action(async (opts) => {
     try {
-      const res = await getTransport3().post(
+      const res = await getTransport2().post(
         ASSET_GET_ENDPOINT,
         { id: String(opts.id) },
         { timeoutMs: ASSET_TIMEOUT_MS, retries: 1 }
@@ -11333,7 +11337,7 @@ async function resolveKnowledgeFilters(params) {
     file: "--filters-file"
   });
 }
-async function executeKnowledgeSearch(input, opts, getTransport3) {
+async function executeKnowledgeSearch(input, opts, getTransport2) {
   if (input.provider && input.domain !== "voice") {
     return {
       kind: "fail",
@@ -11351,7 +11355,7 @@ async function executeKnowledgeSearch(input, opts, getTransport3) {
     };
   }
   try {
-    const res = await getTransport3().post(KNOWLEDGE_SEARCH_ENDPOINT, body, {
+    const res = await getTransport2().post(KNOWLEDGE_SEARCH_ENDPOINT, body, {
       timeoutMs: KNOWLEDGE_TIMEOUT_MS,
       retries: 1
     });
@@ -11376,7 +11380,7 @@ async function executeKnowledgeSearch(input, opts, getTransport3) {
     return { kind: "fail", code: "E_BACKEND", exitCode: 1, message: err instanceof Error ? err.message : String(err) };
   }
 }
-function registerKnowledgeCommands(program2, getTransport3) {
+function registerKnowledgeCommands(program2, getTransport2) {
   const kb = program2.command("knowledge").description("Knowledge-base search across domain libraries (sfx, bgm, visual_style, voice, writing, meme).");
   const filtersFileFlag = {
     flag: "filters-file",
@@ -11449,7 +11453,7 @@ function registerKnowledgeCommands(program2, getTransport3) {
       ...typeof params.k === "number" ? { k: params.k } : {},
       ...Object.keys(filters).length > 0 ? { filters } : {}
     };
-    const outcome = await executeKnowledgeSearch(input, { dryRun: rawOpts.dryRun === true }, getTransport3);
+    const outcome = await executeKnowledgeSearch(input, { dryRun: rawOpts.dryRun === true }, getTransport2);
     emitOutcome(outcome);
   });
 }
@@ -12007,7 +12011,7 @@ async function searchFanout(enabled, opts, limit, searchFn) {
   }
   return { results: mergeResults(perProviderResults, limit), queried: [...enabled], failed };
 }
-function registerStockSearch(parent, getTransport3) {
+function registerStockSearch(parent, getTransport2) {
   parent.command("search").description(
     "Sequential-fallback search across providers (Pexels -> Pixabay -> Openverse). Use --mode=fanout for parallel."
   ).addHelpText(
@@ -12079,7 +12083,7 @@ function registerStockSearch(parent, getTransport3) {
     };
     const jobRef = randomUUID4();
     try {
-      const transport = getTransport3();
+      const transport = getTransport2();
       const searchFn = (name, o) => {
         const provider = ALL_PROVIDERS[name];
         if (!provider) throw new Error(`unknown stock provider: ${name}`);
@@ -12117,9 +12121,9 @@ function registerStockSearch(parent, getTransport3) {
 }
 
 // ../cli-core/src/commands/stock.ts
-function registerStockCommands(program2, getTransport3) {
+function registerStockCommands(program2, getTransport2) {
   const stock = program2.command("stock").description("Search and download public stock media (Pexels / Pixabay / Openverse) for b-roll.");
-  registerStockSearch(stock, getTransport3);
+  registerStockSearch(stock, getTransport2);
   registerStockDownload(stock);
 }
 
@@ -12152,13 +12156,36 @@ import { chmodSync, existsSync, mkdirSync, readFileSync as readFileSync2, writeF
 import { homedir } from "node:os";
 import { join } from "node:path";
 
+// src/distribution.ts
+var PRODUCTION_DISTRIBUTION = {
+  channel: "production",
+  packageName: "@actionway/cli",
+  distTag: "latest",
+  commandName: "actionway",
+  configDirectoryName: ".actionway",
+  skillName: "actionway",
+  gatewayUrl: "https://actionway.ai"
+};
+var DEVELOPMENT_DISTRIBUTION = {
+  channel: "development",
+  packageName: "@actionway/cli-dev",
+  distTag: "latest",
+  commandName: "actionway-dev",
+  configDirectoryName: ".actionway-dev",
+  skillName: "actionway-dev",
+  gatewayUrl: "https://dev.actionway.ai"
+};
+function cliDistribution(env = process.env) {
+  return env.ACTIONWAY_CLI_CHANNEL === "development" ? DEVELOPMENT_DISTRIBUTION : PRODUCTION_DISTRIBUTION;
+}
+
 // src/version.ts
 import { readFileSync } from "node:fs";
 import { dirname as dirname2, resolve } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
-var PACKAGE_NAME = "@actionway/cli";
-function readOwnVersion(moduleUrl = import.meta.url) {
+function readOwnPackage(moduleUrl = import.meta.url, env = process.env) {
   const here = dirname2(fileURLToPath2(moduleUrl));
+  const expectedPackage = cliDistribution(env).packageName;
   for (const path of [
     resolve(here, "package.json"),
     resolve(here, "../package.json"),
@@ -12168,13 +12195,27 @@ function readOwnVersion(moduleUrl = import.meta.url) {
       const parsed = JSON.parse(readFileSync(path, "utf8"));
       if (typeof parsed !== "object" || parsed === null) continue;
       const manifest = parsed;
-      if (manifest.name === PACKAGE_NAME && typeof manifest.version === "string" && manifest.version.trim()) {
-        return manifest.version.trim();
+      if (manifest.name === expectedPackage && typeof manifest.version === "string" && manifest.version.trim()) {
+        const result = {
+          name: expectedPackage,
+          version: manifest.version.trim(),
+          ...typeof manifest.actionway === "object" && manifest.actionway !== null ? { actionway: manifest.actionway } : {}
+        };
+        if (expectedPackage === "@actionway/cli-dev") {
+          const metadata = result.actionway;
+          if (metadata?.channel !== "development" || !/^[0-9a-f]{40}$/.test(metadata.source_sha ?? "") || !Number.isSafeInteger(metadata.run_id) || (metadata.run_id ?? 0) <= 0 || metadata.run_url !== `https://github.com/PawLogic/actionway/actions/runs/${metadata.run_id}` || metadata.gateway_url !== "https://dev.actionway.ai") {
+            throw new Error("the installed @actionway/cli-dev package metadata is invalid");
+          }
+        }
+        return result;
       }
     } catch {
     }
   }
-  throw new Error(`cannot determine the installed ${PACKAGE_NAME} version`);
+  throw new Error(`cannot determine the installed ${expectedPackage} version`);
+}
+function readOwnVersion(moduleUrl = import.meta.url, env = process.env) {
+  return readOwnPackage(moduleUrl, env).version;
 }
 
 // src/lib/npm-runner.ts
@@ -12275,14 +12316,14 @@ function runNpmText(args, operation, options = {}) {
 }
 
 // src/lib/update-state.ts
-var PACKAGE_NAME2 = "@actionway/cli";
 var UPDATE_STATE_BASENAME = "update.json";
 var UPDATE_CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
+var DEVELOPMENT_VERSION_PATTERN = /^0\.0\.0-dev\.[1-9]\d*\.[0-9a-f]{12}$/;
 function actionwayConfigDir(env = process.env) {
   const override = (env.ACTIONWAY_CONFIG_DIR ?? "").trim();
   if (override) return override;
   const home = (env.HOME ?? "").trim() || homedir();
-  return join(home, ".actionway");
+  return join(home, cliDistribution(env).configDirectoryName);
 }
 function updateStatePath(env = process.env) {
   return join(actionwayConfigDir(env), UPDATE_STATE_BASENAME);
@@ -12331,7 +12372,15 @@ function loadState(env) {
   if (existsSync(path)) {
     try {
       const parsed = parseState(readFileSync2(path, "utf8"));
-      if (parsed) return parsed;
+      if (parsed) {
+        if (cliDistribution(env).channel === "development") {
+          if (parsed.latest_version && !DEVELOPMENT_VERSION_PATTERN.test(parsed.latest_version)) {
+            return emptyState();
+          }
+          return { ...parsed, min_version: null };
+        }
+        return parsed;
+      }
     } catch {
     }
   }
@@ -12353,6 +12402,7 @@ function readVersionState(env = process.env) {
   return { latest_version: state.latest_version, min_version: state.min_version, checked_at: state.checked_at };
 }
 function recordVersionSignal(signal, env = process.env, now = /* @__PURE__ */ new Date()) {
+  if (cliDistribution(env).channel === "development") return;
   const latest = (signal.latest ?? "").trim();
   const min = (signal.min ?? "").trim();
   const validLatest = latest && isValidVersion(latest) ? latest : null;
@@ -12375,19 +12425,28 @@ function recordVersionSignal(signal, env = process.env, now = /* @__PURE__ */ ne
   );
 }
 function fetchLatestVersionFromNpm(env) {
+  const distribution = cliDistribution(env);
   const output = runNpmText(
-    ["view", `${PACKAGE_NAME2}@latest`, "version"],
-    `npm registry check for ${PACKAGE_NAME2}@latest`,
+    ["view", `${distribution.packageName}@${distribution.distTag}`, "version"],
+    `npm registry check for ${distribution.packageName}@${distribution.distTag}`,
     { env, timeoutMs: 15e3 }
   );
   const version = output.split(/\r?\n/).at(-1)?.trim() ?? "";
-  if (!version) throw new Error(`npm returned no version for ${PACKAGE_NAME2}@latest`);
+  if (!version) throw new Error(`npm returned no version for ${distribution.packageName}@${distribution.distTag}`);
   return version;
 }
 function installFromNpm(env) {
+  const distribution = cliDistribution(env);
   runNpmText(
-    ["install", "--global", "--no-audit", "--no-fund", "--no-update-notifier", `${PACKAGE_NAME2}@latest`],
-    `npm global update for ${PACKAGE_NAME2}`,
+    [
+      "install",
+      "--global",
+      "--no-audit",
+      "--no-fund",
+      "--no-update-notifier",
+      `${distribution.packageName}@${distribution.distTag}`
+    ],
+    `npm global update for ${distribution.packageName}`,
     { env, timeoutMs: 12e4 }
   );
 }
@@ -12396,12 +12455,13 @@ function isFresh(state, now) {
   const checkedAt = Date.parse(state.checked_at);
   return Number.isFinite(checkedAt) && now.getTime() - checkedAt >= 0 && now.getTime() - checkedAt < UPDATE_CACHE_TTL_MS;
 }
-function statusFrom(currentVersion, latestVersion, checkedAt, fromCache) {
+function statusFrom(currentVersion, latestVersion, checkedAt, fromCache, env) {
+  const distribution = cliDistribution(env);
   return {
-    package: PACKAGE_NAME2,
+    package: distribution.packageName,
     current_version: currentVersion,
     latest_version: latestVersion,
-    update_available: isValidVersion(latestVersion) && compareVersions(latestVersion, currentVersion) > 0,
+    update_available: isValidVersion(latestVersion) && (distribution.channel === "development" ? latestVersion !== currentVersion : compareVersions(latestVersion, currentVersion) > 0),
     checked_at: checkedAt,
     from_cache: fromCache
   };
@@ -12412,12 +12472,12 @@ function getUpdateStatus(options = {}) {
   const currentVersion = options.currentVersion ?? readOwnVersion();
   const state = loadState(env);
   if (!options.refresh && isFresh(state, now) && state.latest_version) {
-    return statusFrom(currentVersion, state.latest_version, state.checked_at ?? now.toISOString(), true);
+    return statusFrom(currentVersion, state.latest_version, state.checked_at ?? now.toISOString(), true, env);
   }
   const latestVersion = (options.fetchLatestVersion ?? fetchLatestVersionFromNpm)(env);
   const checkedAt = now.toISOString();
   saveState({ version: 2, checked_at: checkedAt, latest_version: latestVersion, min_version: state.min_version }, env);
-  return statusFrom(currentVersion, latestVersion, checkedAt, false);
+  return statusFrom(currentVersion, latestVersion, checkedAt, false, env);
 }
 function runUpdate(options = {}) {
   const env = options.env ?? process.env;
@@ -13036,19 +13096,19 @@ function accountEndpoint(path, options) {
   const query = parameters.toString();
   return `v1/account/${path}${query ? `?${query}` : ""}`;
 }
-async function read(endpoint, getTransport3) {
+async function read(endpoint, getTransport2) {
   try {
-    ok(await getTransport3().getBusiness(endpoint, { retries: 1 }));
+    ok(await getTransport2().getBusiness(endpoint, { retries: 1 }));
   } catch (error) {
     failAccount(error);
   }
 }
-function registerAccountCommands(program2, getTransport3) {
+function registerAccountCommands(program2, getTransport2) {
   const account = program2.command("account").description("Access your Actionway invitation, USD wallet, service usage, and wallet transactions.");
-  account.command("invitation").description("Get or create your permanent invitation code, link, and localized share message.").option("--locale <locale>", "Share-message locale: zh-cn, zh-tw, en, or ja.", "en").action((options) => read(invitationEndpoint(options.locale), getTransport3));
-  account.command("usage").description("Query held, charged, released, and free capability calls.").option("--limit <count>", "Maximum records in this page (1-100).").option("--cursor <cursor>", "Opaque nextCursor returned by the previous page.").option("--from <date>", "Inclusive ISO date or timestamp (UTC for date-only values).").option("--to <date>", "Exclusive ISO date or timestamp (UTC for date-only values).").option("--status <status>", "held, settled, or expired.").option("--service <service-id>", "Exact public serviceId.").option("--pricing-kind <kind>", "priced or free.").action((options) => read(accountEndpoint("usage", options), getTransport3));
-  account.command("wallet").description("Show the current available and held Actionway USD wallet balance.").action(() => read("v1/account/wallet", getTransport3));
-  account.command("transactions").description("Query wallet top-ups, charges, promotions, refunds, and other fund movements.").option("--limit <count>", "Maximum records in this page (1-50).").option("--cursor <cursor>", "Opaque nextCursor returned by the previous page.").option("--from <date>", "Inclusive ISO date or timestamp (UTC for date-only values).").option("--to <date>", "Exclusive ISO date or timestamp (UTC for date-only values).").option("--status <status>", "pending, succeeded, or failed.").option("--kind <kind>", "top_up, charge, refund, dispute, or promotion kind.").action((options) => read(accountEndpoint("transactions", options), getTransport3));
+  account.command("invitation").description("Get or create your permanent invitation code, link, and localized share message.").option("--locale <locale>", "Share-message locale: zh-cn, zh-tw, en, or ja.", "en").action((options) => read(invitationEndpoint(options.locale), getTransport2));
+  account.command("usage").description("Query held, charged, released, and free capability calls.").option("--limit <count>", "Maximum records in this page (1-100).").option("--cursor <cursor>", "Opaque nextCursor returned by the previous page.").option("--from <date>", "Inclusive ISO date or timestamp (UTC for date-only values).").option("--to <date>", "Exclusive ISO date or timestamp (UTC for date-only values).").option("--status <status>", "held, settled, or expired.").option("--service <service-id>", "Exact public serviceId.").option("--pricing-kind <kind>", "priced or free.").action((options) => read(accountEndpoint("usage", options), getTransport2));
+  account.command("wallet").description("Show the current available and held Actionway USD wallet balance.").action(() => read("v1/account/wallet", getTransport2));
+  account.command("transactions").description("Query wallet top-ups, charges, promotions, refunds, and other fund movements.").option("--limit <count>", "Maximum records in this page (1-50).").option("--cursor <cursor>", "Opaque nextCursor returned by the previous page.").option("--from <date>", "Inclusive ISO date or timestamp (UTC for date-only values).").option("--to <date>", "Exclusive ISO date or timestamp (UTC for date-only values).").option("--status <status>", "pending, succeeded, or failed.").option("--kind <kind>", "top_up, charge, refund, dispute, or promotion kind.").action((options) => read(accountEndpoint("transactions", options), getTransport2));
 }
 
 // src/commands/doctor.ts
@@ -13057,7 +13117,6 @@ import { existsSync as existsSync2, rmSync as rmSync2, statSync, writeFileSync a
 import { createServer as createServer2 } from "node:http";
 import { randomBytes as randomBytes2 } from "node:crypto";
 import { dirname as dirname3, join as join3, posix, win32 } from "node:path";
-var PACKAGE_NAME3 = "@actionway/cli";
 function pass(id, message) {
   return { id, status: "pass", message };
 }
@@ -13146,6 +13205,7 @@ async function diagnoseActionway(options = {}, dependencies = {}) {
   const readPolicy = dependencies.readPowerShellPolicy ?? powerShellPolicy;
   const resolveCommand = dependencies.resolveCommand ?? defaultResolveCommand;
   const checks = [];
+  const distribution = cliDistribution(env);
   const configDir = actionwayConfigDir(env);
   const nodeMajor = Number.parseInt(nodeVersion.split(".")[0] ?? "", 10);
   checks.push(
@@ -13177,7 +13237,7 @@ async function diagnoseActionway(options = {}, dependencies = {}) {
       safe.startsWith("https://registry.npmjs.org/") ? pass("scope_registry", `@actionway packages use ${safe}.`) : warn(
         "scope_registry",
         `@actionway packages are mapped to ${safe}.`,
-        "make sure that registry mirrors public @actionway/cli, or install from the public npm registry when policy permits"
+        `make sure that registry mirrors public ${distribution.packageName}, or install from the public npm registry when policy permits`
       )
     );
   } else if (scopeResult.error || scopeResult.status !== 0) {
@@ -13193,14 +13253,21 @@ async function diagnoseActionway(options = {}, dependencies = {}) {
   } else {
     const api = pathApi(platform);
     const binDir = platform === "win32" ? prefix : api.join(prefix, "bin");
-    const binName = platform === "win32" ? "actionway.cmd" : "actionway";
+    const binName = platform === "win32" ? `${distribution.commandName}.cmd` : distribution.commandName;
     let resolvedCache;
-    const resolved = () => resolvedCache !== void 0 ? resolvedCache : resolvedCache = resolveCommand("actionway");
+    const resolved = () => resolvedCache !== void 0 ? resolvedCache : resolvedCache = resolveCommand(distribution.commandName);
     checks.push(
-      pathContains(binDir, env, platform) ? pass("global_path", `npm global executable directory is in PATH: ${binDir}`) : resolved() ? pass("global_path", `actionway resolves from PATH at ${resolved()} (outside the npm global prefix ${binDir}).`) : fail2("global_path", `npm global executable directory is not in PATH: ${binDir}`, "add it to the user PATH and open a new terminal")
+      pathContains(binDir, env, platform) ? pass("global_path", `npm global executable directory is in PATH: ${binDir}`) : resolved() ? pass(
+        "global_path",
+        `${distribution.commandName} resolves from PATH at ${resolved()} (outside the npm global prefix ${binDir}).`
+      ) : fail2("global_path", `npm global executable directory is not in PATH: ${binDir}`, "add it to the user PATH and open a new terminal")
     );
     checks.push(
-      pathExists(api.join(binDir, binName)) ? pass("command", `${binName} is installed in the npm global prefix.`) : resolved() ? pass("command", `actionway command resolves at ${resolved()}.`) : fail2("command", `${binName} was not found in the npm global prefix.`, "reinstall @actionway/cli@latest in the same Node/npm environment")
+      pathExists(api.join(binDir, binName)) ? pass("command", `${binName} is installed in the npm global prefix.`) : resolved() ? pass("command", `${distribution.commandName} command resolves at ${resolved()}.`) : fail2(
+        "command",
+        `${binName} was not found in the npm global prefix.`,
+        `reinstall ${distribution.packageName}@${distribution.distTag} in the same Node/npm environment`
+      )
     );
   }
   if (platform === "win32") {
@@ -13208,9 +13275,12 @@ async function diagnoseActionway(options = {}, dependencies = {}) {
     checks.push(
       policy && ["Restricted", "AllSigned"].includes(policy) ? warn(
         "powershell_policy",
-        `PowerShell execution policy is ${policy}; npm's actionway.ps1 shim may be blocked.`,
-        "use actionway.cmd; do not weaken organization policy without approval"
-      ) : pass("powershell_policy", `PowerShell execution policy is ${policy || "not available"}; actionway.cmd remains the stable entrypoint.`)
+        `PowerShell execution policy is ${policy}; npm's ${distribution.commandName}.ps1 shim may be blocked.`,
+        `use ${distribution.commandName}.cmd; do not weaken organization policy without approval`
+      ) : pass(
+        "powershell_policy",
+        `PowerShell execution policy is ${policy || "not available"}; ${distribution.commandName}.cmd remains the entrypoint.`
+      )
     );
   }
   try {
@@ -13229,13 +13299,19 @@ async function diagnoseActionway(options = {}, dependencies = {}) {
     checks.push({ id: "npm_registry", status: "skip", message: "npm registry check was skipped." });
     checks.push({ id: "actionway_oauth", status: "skip", message: "Actionway OAuth discovery check was skipped." });
   } else {
-    const packageResult = npm(["view", `${PACKAGE_NAME3}@latest`, "version"], { env, platform, timeoutMs: 15e3 });
+    const packageResult = npm(
+      ["view", `${distribution.packageName}@${distribution.distTag}`, "version"],
+      { env, platform, timeoutMs: 15e3 }
+    );
     checks.push(
       npmCheck(
         "npm_registry",
         packageResult,
         "Actionway package lookup",
-        (version) => pass("npm_registry", `${PACKAGE_NAME3}@latest is reachable (${version.split(/\r?\n/).at(-1)}).`)
+        (version) => pass(
+          "npm_registry",
+          `${distribution.packageName}@${distribution.distTag} is reachable (${version.split(/\r?\n/).at(-1)}).`
+        )
       )
     );
     try {
@@ -13261,9 +13337,10 @@ async function diagnoseActionway(options = {}, dependencies = {}) {
   };
 }
 function registerDoctorCommand(program2) {
+  const distribution = cliDistribution();
   program2.command("doctor").description("Diagnose Node, npm, PATH, registry, configuration, and local OAuth callback readiness.").option("--no-network", "skip npm registry and Actionway OAuth discovery checks").action(async (options) => {
     const report = await diagnoseActionway({ network: options.network !== false });
-    const command = process.platform === "win32" ? "actionway.cmd" : "actionway";
+    const command = process.platform === "win32" ? `${distribution.commandName}.cmd` : distribution.commandName;
     ok({
       ...report,
       hint: report.ready ? `Actionway CLI prerequisites are ready. Run \`${command} init\`.` : `Resolve the failed checks, then run \`${command} doctor\` again.`
@@ -13287,15 +13364,21 @@ var InitError = class extends Error {
   }
 };
 var ACTIONWAY_SKILL_INSTRUCTION = "Install this skill from `source` into your agent's skill directory and make sure it loads in future sessions. If a skill named `actionway` already exists there, replace it only when it is an earlier Actionway skill (check its frontmatter metadata.version); otherwise ask the user first.";
-function resolveBundledSkill(moduleUrl = import.meta.url) {
+var ACTIONWAY_DEV_SKILL_INSTRUCTION = "Install this skill from `source` into your agent's skill directory and make sure it loads in future sessions. If a skill named `actionway-dev` already exists there, replace it only when it is an earlier Actionway development skill (check its frontmatter metadata.version); otherwise ask the user first. Never replace the stable `actionway` Skill.";
+function resolveBundledSkill(moduleUrl = import.meta.url, env = process.env) {
   const here = dirname4(fileURLToPath3(moduleUrl));
-  for (const candidate of [resolve2(here, "../assets/skill/actionway"), resolve2(here, "../../assets/skill/actionway")]) {
+  const skillName = cliDistribution(env).skillName;
+  for (const candidate of [resolve2(here, `../assets/skill/${skillName}`), resolve2(here, `../../assets/skill/${skillName}`)]) {
     if (existsSync3(join4(candidate, "SKILL.md"))) return realpathSync2(candidate);
   }
-  throw new InitError("the bundled Actionway Skill is missing", "reinstall @actionway/cli, then run `actionway init` again");
+  const distribution = cliDistribution(env);
+  throw new InitError(
+    "the bundled Actionway Skill is missing",
+    `reinstall ${distribution.packageName}@${distribution.distTag}, then run \`${distribution.commandName} init\` again`
+  );
 }
 function skillSourcePath(env = process.env) {
-  return join4(actionwayConfigDir(env), "skill", "actionway");
+  return join4(actionwayConfigDir(env), "skill", cliDistribution(env).skillName);
 }
 function stampSkillVersion(skillMarkdown, version) {
   const newline = skillMarkdown.includes("\r\n") ? "\r\n" : "\n";
@@ -13334,18 +13417,55 @@ function stampSkillVersion(skillMarkdown, version) {
 }
 function materializeSkill(options = {}) {
   const env = options.env ?? process.env;
-  const source = options.source ? realpathSync2(options.source) : resolveBundledSkill();
+  const distribution = cliDistribution(env);
+  const source = options.source ? realpathSync2(options.source) : resolveBundledSkill(import.meta.url, env);
   if (!existsSync3(join4(source, "SKILL.md"))) {
-    throw new InitError("the Actionway Skill source is invalid", "reinstall @actionway/cli and retry init");
+    throw new InitError(
+      "the Actionway Skill source is invalid",
+      `reinstall ${distribution.packageName}@${distribution.distTag} and retry init`
+    );
   }
-  const version = options.version ?? readOwnVersion();
+  const version = options.version ?? readOwnVersion(import.meta.url, env);
   const target = skillSourcePath(env);
   mkdirSync3(dirname4(target), { recursive: true, mode: 448 });
   rmSync3(target, { recursive: true, force: true });
   cpSync(source, target, { recursive: true });
   const skillPath = join4(target, "SKILL.md");
   writeFileSync4(skillPath, stampSkillVersion(readFileSync4(skillPath, "utf8"), version));
-  return { source: target, version, instruction: ACTIONWAY_SKILL_INSTRUCTION };
+  return {
+    source: target,
+    version,
+    instruction: distribution.channel === "development" ? ACTIONWAY_DEV_SKILL_INSTRUCTION : ACTIONWAY_SKILL_INSTRUCTION
+  };
+}
+
+// src/lib/client-context.ts
+var ACTIONWAY_AGENT_HOST_HEADER = "x-actionway-agent-host";
+var ACTIONWAY_RUNTIME_OS_HEADER = "x-actionway-runtime-os";
+var ACTIONWAY_AGENT_HOSTS = ["codex", "claude_code", "workbuddy"];
+function isActionwayAgentHost(value) {
+  return typeof value === "string" && ACTIONWAY_AGENT_HOSTS.includes(value);
+}
+function detectRuntimeOs(platform = process.platform, env = process.env) {
+  if (platform === "win32") return "windows";
+  if (platform === "darwin") return "macos";
+  if (platform === "linux") {
+    if ((env.WSL_DISTRO_NAME ?? "").trim() || (env.WSL_INTEROP ?? "").trim()) return "wsl";
+    return "linux";
+  }
+  return "other";
+}
+function localClientContext(agentHost, platform = process.platform, env = process.env) {
+  return {
+    ...isActionwayAgentHost(agentHost) ? { agentHost } : {},
+    runtimeOs: detectRuntimeOs(platform, env)
+  };
+}
+function localClientContextHeaders(context) {
+  return {
+    ...context.agentHost ? { [ACTIONWAY_AGENT_HOST_HEADER]: context.agentHost } : {},
+    [ACTIONWAY_RUNTIME_OS_HEADER]: context.runtimeOs
+  };
 }
 
 // src/lib/install-session.ts
@@ -13387,7 +13507,12 @@ async function captureInstallStarted(input) {
       `${stripSlash2(input.gateway)}/api/analytics/install-started`,
       {
         method: "POST",
-        headers: { Accept: "application/json", "Content-Type": "application/json" },
+        headers: {
+          Accept: "application/json",
+          "Content-Type": "application/json",
+          "x-actionway-cli-version": getCliVersion(),
+          ...input.clientContext ? localClientContextHeaders(input.clientContext) : {}
+        },
         body: JSON.stringify({
           installSessionId: input.installSessionId,
           installSource: input.installSource
@@ -13411,7 +13536,12 @@ async function requestCliInstallSession(input) {
       url.toString(),
       {
         method: "GET",
-        headers: { Accept: "application/json", Authorization: `Bearer ${input.accessToken}` }
+        headers: {
+          Accept: "application/json",
+          Authorization: `Bearer ${input.accessToken}`,
+          "x-actionway-cli-version": getCliVersion(),
+          ...input.clientContext ? localClientContextHeaders(input.clientContext) : {}
+        }
       },
       SESSION_TIMEOUT_MS2,
       input.fetchImpl ?? fetch
@@ -13451,6 +13581,7 @@ async function connectInstallSession(input) {
     accessToken: credentials.access_token,
     installSessionId: input.installSessionId,
     installSource: input.installSource,
+    ...input.clientContext ? { clientContext: input.clientContext } : {},
     fetchImpl
   });
 }
@@ -13465,11 +13596,14 @@ function failFromError3(err) {
   }
   fail({ code: "E_BACKEND", message: err instanceof Error ? err.message : String(err) });
 }
-function registerInitCommand(program2) {
+function registerInitCommand(program2, getClientContext = () => ({ runtimeOs: "other" })) {
+  const distribution = cliDistribution();
   program2.command("init").description(
     "Complete browser authentication and stage the Actionway Skill for your agent to install. The CLI never writes into an agent's own configuration directory."
   ).option("--gateway <url>", "Actionway public origin").option("--client-id <id>", "Actionway OAuth client id (must be paired with --issuer)").option("--issuer <url>", "Actionway OAuth issuer (must be paired with --client-id)").option("--timeout-seconds <n>", "how long to wait for browser authentication").option("--install-session-id <uuid>", "onboarding install session id").option("--no-browser", "print the authorize URL instead of opening a browser").addOption(new Option("--skill-only").hideHelp()).action(async (opts) => {
     try {
+      const clientContext = getClientContext();
+      const invocation = clientContext.agentHost ? `${distribution.commandName} --agent-host=${clientContext.agentHost}` : distribution.commandName;
       const skill = materializeSkill();
       if (opts.skillOnly) {
         ok({ skill });
@@ -13480,7 +13614,8 @@ function registerInitCommand(program2) {
       await captureInstallStarted({
         gateway: initGateway,
         installSessionId,
-        installSource
+        installSource,
+        clientContext
       });
       let loginStarted = false;
       if (!whoamiSnapshot()) {
@@ -13497,7 +13632,8 @@ function registerInitCommand(program2) {
       const account = await connectInstallSession({
         ...opts.gateway ? { explicitGateway: opts.gateway } : {},
         installSessionId,
-        installSource
+        installSource,
+        clientContext
       });
       const snapshot = whoamiSnapshot();
       ok({
@@ -13507,7 +13643,7 @@ function registerInitCommand(program2) {
         skill,
         workspace_id: account.workspaceId,
         ...snapshot?.user ? { user: snapshot.user } : {},
-        hint: "Actionway is ready. Install the skill from `skill.source` into your agent's skill directory, then run `actionway --help` to discover supported capabilities."
+        hint: `Actionway is ready. Install the skill from \`skill.source\` into your agent's skill directory, then run \`${invocation} --help\` to discover supported capabilities.`
       });
     } catch (error) {
       failFromError3(error);
@@ -13515,6 +13651,26 @@ function registerInitCommand(program2) {
   });
 }
 
+// src/commands/status.ts
+function registerDevelopmentStatusCommand(program2) {
+  const distribution = cliDistribution();
+  if (distribution.channel !== "development") return;
+  program2.command("status").description("Show the installed Actionway development channel and immutable source revision.").action(() => {
+    const manifest = readOwnPackage();
+    const metadata = manifest.actionway;
+    ok({
+      channel: "development",
+      package: manifest.name,
+      version: manifest.version,
+      source_sha: metadata?.source_sha ?? null,
+      run_id: metadata?.run_id ?? null,
+      run_url: metadata?.run_url ?? null,
+      gateway_url: metadata?.gateway_url ?? distribution.gatewayUrl,
+      config_dir: process.env.ACTIONWAY_CONFIG_DIR ?? null
+    });
+  });
+}
+
 // src/commands/update.ts
 import { spawnSync as spawnSync3 } from "node:child_process";
 function refreshSkillWithNewBinary() {
@@ -13535,7 +13691,8 @@ function refreshSkillWithNewBinary() {
   }
 }
 function registerUpdateCommand(program2) {
-  program2.command("update").description("Check for or install the latest @actionway/cli version from npm.").option("--check", "check for a newer version without installing").option("--refresh", "ignore the 24-hour update-check cache").action((opts) => {
+  const distribution = cliDistribution();
+  program2.command("update").description(`Check for or install the latest ${distribution.packageName} version from npm.`).option("--check", "check for a newer version without installing").option("--refresh", "ignore the 24-hour update-check cache").action((opts) => {
     try {
       if (opts.check) {
         ok({ ...getUpdateStatus({ ...opts.refresh ? { refresh: true } : {} }) });
@@ -13558,7 +13715,7 @@ function registerUpdateCommand(program2) {
       fail({
         code: "E_UPDATE_FAILED",
         message: error instanceof Error ? error.message : String(error),
-        hint: "retry later or reinstall @actionway/cli@latest"
+        hint: `retry later or reinstall ${distribution.packageName}@${distribution.distTag}`
       });
     }
   });
@@ -13568,6 +13725,7 @@ function registerUpdateCommand(program2) {
 function withVersionMetadata(payload, deps = {}) {
   const env = deps.env ?? process.env;
   const cliVersion2 = deps.currentVersion ?? getCliVersion();
+  const distribution = cliDistribution(env);
   const skillSource = skillSourcePath(env);
   const isUpdateCommandOutput = "update_available" in payload;
   const notes = [];
@@ -13575,12 +13733,12 @@ function withVersionMetadata(payload, deps = {}) {
     const state = readVersionState(env);
     if (!isUpdateCommandOutput && state.latest_version && isValidVersion(state.latest_version) && compareVersions(state.latest_version, cliVersion2) > 0) {
       notes.push(
-        `Update available: ${cliVersion2} -> ${state.latest_version}. Run \`actionway update\` at the next session boundary, then refresh the installed skill from ${skillSource}.`
+        `Update available: ${cliVersion2} -> ${state.latest_version}. Run \`${distribution.commandName} update\` at the next session boundary, then refresh the installed skill from ${skillSource}.`
       );
     }
     if (state.min_version && isValidVersion(state.min_version) && compareVersions(cliVersion2, state.min_version) < 0) {
       notes.push(
-        `This CLI version (${cliVersion2}) is below the minimum supported version (${state.min_version}). Run \`actionway update\` now, then refresh the installed skill from ${skillSource}.`
+        `This CLI version (${cliVersion2}) is below the minimum supported version (${state.min_version}). Run \`${distribution.commandName} update\` now, then refresh the installed skill from ${skillSource}.`
       );
     }
   } catch {
@@ -13634,7 +13792,7 @@ function authFailure(err) {
     extra: { ...err.extra ?? {}, ...err.hint ? { hint: err.hint } : {} }
   });
 }
-function getTransport(env = process.env, fetchImpl) {
+function getTransport(env = process.env, fetchImpl, clientContext) {
   return new Transport({
     baseUrl: resolveTransportBaseUrl(env),
     authHeader: async () => {
@@ -13656,6 +13814,7 @@ function getTransport(env = process.env, fetchImpl) {
       }
       return `Bearer ${creds.access_token}`;
     },
+    ...clientContext ? { requestHeaders: localClientContextHeaders(clientContext) } : {},
     ...fetchImpl ? { fetchImpl } : {},
     onResponse: (res) => {
       const latest = res.headers.get("x-actionway-cli-latest");
@@ -13794,19 +13953,23 @@ function projectTypedToolCall(spec, commandParams, prepared) {
 }
 
 // src/index.ts
-function getTransport2() {
-  return getTransport();
-}
-var actionDeps = { getTransport: getTransport2, projectToolCall: projectTypedToolCall };
 function buildProgram() {
+  const distribution = cliDistribution();
   const version = readOwnVersion();
   setCliVersion(version);
-  const program2 = new Command("actionway");
+  const program2 = new Command(distribution.commandName);
   program2.version(version);
   program2.description("Actionway CLI: run Actionway media and research capabilities from your local agent.");
-  registerInitCommand(program2);
+  program2.addOption(
+    new Option("--agent-host <host>", "declare the local Agent invoking this command").choices([...ACTIONWAY_AGENT_HOSTS])
+  );
+  const getClientContext = () => localClientContext(program2.opts().agentHost);
+  const getTransport2 = () => getTransport(process.env, void 0, getClientContext());
+  const actionDeps = { getTransport: getTransport2, projectToolCall: projectTypedToolCall };
+  registerInitCommand(program2, getClientContext);
   registerDoctorCommand(program2);
   registerUpdateCommand(program2);
+  registerDevelopmentStatusCommand(program2);
   registerAuthCommands(program2);
   registerAccountCommands(program2, getTransport2);
   registerToolsCommands(program2, getTransport2);