gunshi 0.30.8 → 0.31.0

package/README.md

@@ -28,10 +28,6 @@ Gunshi is designed to simplify the creation of modern command-line interfaces:
 - 🌍 **Internationalization**: Built with global users in mind, featuring locale-aware design, resource management, and multi-language support.
 - 🔌 **Pluggable**: Extensible plugin system with dependency management and lifecycle hooks for modular CLI development.
 
-## 📡 Status
-
-- v0.27: stable
-
 ## 💿 Installation
 
 ```sh

package/lib/agent.d.ts

@@ -0,0 +1,61 @@
+//#region ../../node_modules/.pnpm/std-env@4.1.0/node_modules/std-env/dist/index.d.mts
+//#region src/agents.d.ts
+/**
+* Represents the name of an AI coding agent.
+*/
+type AgentName = (string & {}) | "cursor" | "claude" | "devin" | "replit" | "gemini" | "codex" | "auggie" | "opencode" | "kiro" | "goose" | "pi";
+/**
+* Provides information about an AI coding agent.
+*/
+
+//#endregion
+//#region src/agent.d.ts
+
+/**
+ * A profile that summarizes whether the current process is running on an
+ * AI coding agent.
+ *
+ * The shape is intentionally minimal so that callers can use it as a UX hint
+ * (for example, to switch output format) without coupling to specific agent
+ * names. To get the type, use `ReturnType<typeof getAgentProfile>`.
+ */
+interface AgentProfile {
+  /**
+   * `true` if the current process is detected as running on an AI coding
+   * agent.
+   *
+   * Detection is delegated to `std-env`. Prefer checking this flag over the
+   * {@link AgentProfile.name | name} field.
+   */
+  isAgent: boolean;
+  /**
+   * The name of the detected AI coding agent, if any.
+   *
+   * This is the value reported by `std-env`. Use it only when a specific
+   * agent has a known constraint that requires special handling.
+   */
+  name?: AgentName;
+}
+/**
+ * Get the AI coding agent profile of the current process.
+ *
+ * The detection itself is delegated to `std-env`. This function only converts
+ * the upstream `agentInfo` into Gunshi's minimal {@link AgentProfile} shape.
+ *
+ * @returns An {@link AgentProfile} describing whether the process is running
+ *   on an AI coding agent and, if so, which agent was detected.
+ *
+ * @example
+ * ```js
+ * import { getAgentProfile } from 'gunshi/agent'
+ *
+ * const profile = getAgentProfile()
+ *
+ * if (profile.isAgent) {
+ *   // adjust output for AI agent execution
+ * }
+ * ```
+ */
+declare function getAgentProfile(): AgentProfile;
+//#endregion
+export { getAgentProfile };

package/lib/agent.js

@@ -0,0 +1,222 @@
+//#region ../../node_modules/.pnpm/std-env@4.1.0/node_modules/std-env/dist/index.mjs
+const e = globalThis.process?.env || Object.create(null), t = globalThis.process || { env: e }, n = t !== void 0 && t.env && t.env.NODE_ENV || void 0, r = [
+	[`claude`, [`CLAUDECODE`, `CLAUDE_CODE`]],
+	[`replit`, [`REPL_ID`]],
+	[`gemini`, [`GEMINI_CLI`]],
+	[`codex`, [`CODEX_SANDBOX`, `CODEX_THREAD_ID`]],
+	[`opencode`, [`OPENCODE`]],
+	[`pi`, [i(`PATH`, /\.pi[\\/]agent/)]],
+	[`auggie`, [`AUGMENT_AGENT`]],
+	[`goose`, [`GOOSE_PROVIDER`]],
+	[`devin`, [i(`EDITOR`, /devin/)]],
+	[`cursor`, [`CURSOR_AGENT`]],
+	[`kiro`, [i(`TERM_PROGRAM`, /kiro/)]]
+];
+function i(t, n) {
+	return () => {
+		let r = e[t];
+		return r ? n.test(r) : !1;
+	};
+}
+function a() {
+	let t = e.AI_AGENT;
+	if (t) return { name: t.toLowerCase() };
+	for (let [t, n] of r) for (let r of n) if (typeof r == `string` ? e[r] : r()) return { name: t };
+	return {};
+}
+const o = a();
+o.name;
+o.name;
+const l = [
+	[`APPVEYOR`],
+	[
+		`AWS_AMPLIFY`,
+		`AWS_APP_ID`,
+		{ ci: !0 }
+	],
+	[`AZURE_PIPELINES`, `SYSTEM_TEAMFOUNDATIONCOLLECTIONURI`],
+	[`AZURE_STATIC`, `INPUT_AZURE_STATIC_WEB_APPS_API_TOKEN`],
+	[`APPCIRCLE`, `AC_APPCIRCLE`],
+	[`BAMBOO`, `bamboo_planKey`],
+	[`BITBUCKET`, `BITBUCKET_COMMIT`],
+	[`BITRISE`, `BITRISE_IO`],
+	[`BUDDY`, `BUDDY_WORKSPACE_ID`],
+	[`BUILDKITE`],
+	[`CIRCLE`, `CIRCLECI`],
+	[`CIRRUS`, `CIRRUS_CI`],
+	[
+		`CLOUDFLARE_PAGES`,
+		`CF_PAGES`,
+		{ ci: !0 }
+	],
+	[
+		`CLOUDFLARE_WORKERS`,
+		`WORKERS_CI`,
+		{ ci: !0 }
+	],
+	[`GOOGLE_CLOUDRUN`, `K_SERVICE`],
+	[`GOOGLE_CLOUDRUN_JOB`, `CLOUD_RUN_JOB`],
+	[`CODEBUILD`, `CODEBUILD_BUILD_ARN`],
+	[`CODEFRESH`, `CF_BUILD_ID`],
+	[`DRONE`],
+	[`DRONE`, `DRONE_BUILD_EVENT`],
+	[`DSARI`],
+	[`GITHUB_ACTIONS`],
+	[`GITLAB`, `GITLAB_CI`],
+	[`GITLAB`, `CI_MERGE_REQUEST_ID`],
+	[`GOCD`, `GO_PIPELINE_LABEL`],
+	[`LAYERCI`],
+	[`JENKINS`, `JENKINS_URL`],
+	[`HUDSON`, `HUDSON_URL`],
+	[`MAGNUM`],
+	[`NETLIFY`],
+	[
+		`NETLIFY`,
+		`NETLIFY_LOCAL`,
+		{ ci: !1 }
+	],
+	[`NEVERCODE`],
+	[`RENDER`],
+	[`SAIL`, `SAILCI`],
+	[`SEMAPHORE`],
+	[`SCREWDRIVER`],
+	[`SHIPPABLE`],
+	[`SOLANO`, `TDDIUM`],
+	[`STRIDER`],
+	[`TEAMCITY`, `TEAMCITY_VERSION`],
+	[`TRAVIS`],
+	[`VERCEL`, `NOW_BUILDER`],
+	[
+		`VERCEL`,
+		`VERCEL`,
+		{ ci: !1 }
+	],
+	[
+		`VERCEL`,
+		`VERCEL_ENV`,
+		{ ci: !1 }
+	],
+	[`APPCENTER`, `APPCENTER_BUILD_ID`],
+	[
+		`CODESANDBOX`,
+		`CODESANDBOX_SSE`,
+		{ ci: !1 }
+	],
+	[
+		`CODESANDBOX`,
+		`CODESANDBOX_HOST`,
+		{ ci: !1 }
+	],
+	[`STACKBLITZ`],
+	[`STORMKIT`],
+	[`CLEAVR`],
+	[`ZEABUR`],
+	[
+		`CODESPHERE`,
+		`CODESPHERE_APP_ID`,
+		{ ci: !0 }
+	],
+	[`RAILWAY`, `RAILWAY_PROJECT_ID`],
+	[`RAILWAY`, `RAILWAY_SERVICE_ID`],
+	[`DENO-DEPLOY`, `DENO_DEPLOY`],
+	[`DENO-DEPLOY`, `DENO_DEPLOYMENT_ID`],
+	[
+		`FIREBASE_APP_HOSTING`,
+		`FIREBASE_APP_HOSTING`,
+		{ ci: !0 }
+	],
+	[
+		`EDGEONE_PAGES`,
+		`EO_PAGES_CI`,
+		{ ci: !0 }
+	]
+];
+function u() {
+	for (let t of l) if (e[t[1] || t[0]]) return {
+		name: t[0].toLowerCase(),
+		...t[2]
+	};
+	return e.SHELL === `/bin/jsh` && t.versions?.webcontainer ? {
+		name: `stackblitz`,
+		ci: !1
+	} : {
+		name: ``,
+		ci: !1
+	};
+}
+const d = u();
+d.name;
+const p = t.platform || ``;
+e.CI || d.ci;
+const h = !!t.stdout?.isTTY;
+e.DEBUG;
+n === `test` || e.TEST;
+n === `production` || e.MODE;
+n === `dev` || n === `development` || e.MODE;
+e.MINIMAL;
+const S = /^win/i.test(p);
+/^linux/i.test(p);
+/^darwin/i.test(p);
+!e.NO_COLOR && (e.FORCE_COLOR || (h || S) && e.TERM);
+const E = (t.versions?.node || ``).replace(/^v/, ``) || null;
+Number(E?.split(`.`)[0]);
+const O = !!t?.versions?.node, k = `Bun` in globalThis, A = `Deno` in globalThis, j = `fastly` in globalThis, M = `Netlify` in globalThis, N = `EdgeRuntime` in globalThis, P = globalThis.navigator?.userAgent === `Cloudflare-Workers`, F = [
+	[M, `netlify`],
+	[N, `edge-light`],
+	[P, `workerd`],
+	[j, `fastly`],
+	[A, `deno`],
+	[k, `bun`],
+	[O, `node`]
+];
+function I() {
+	let e = F.find((e) => e[0]);
+	if (e) return { name: e[1] };
+}
+I()?.name;
+//#endregion
+//#region src/agent.ts
+/**
+* The entry point for AI agent detection utility.
+*
+* @example
+* ```js
+* import { getAgentProfile } from 'gunshi/agent'
+* ```
+*
+* @experimental
+* The `gunshi/agent` entry point is experimental. The agent detection rules
+* are delegated to {@link https://github.com/unjs/std-env | std-env} and may
+* change as the upstream detector list evolves.
+*
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
+* Get the AI coding agent profile of the current process.
+*
+* The detection itself is delegated to `std-env`. This function only converts
+* the upstream `agentInfo` into Gunshi's minimal {@link AgentProfile} shape.
+*
+* @returns An {@link AgentProfile} describing whether the process is running
+*   on an AI coding agent and, if so, which agent was detected.
+*
+* @example
+* ```js
+* import { getAgentProfile } from 'gunshi/agent'
+*
+* const profile = getAgentProfile()
+*
+* if (profile.isAgent) {
+*   // adjust output for AI agent execution
+* }
+* ```
+*/
+function getAgentProfile() {
+	return {
+		isAgent: !!o.name,
+		name: o.name
+	};
+}
+//#endregion
+export { getAgentProfile };

package/lib/bone.d.ts

@@ -1,5 +1,5 @@
-import { i as Args, n as ArgSchema, o as ArgToken, r as ArgValues } from "./resolver-DGtVt298.js";
-import { C as Prettify, D as ValidationErrorsDecorator, E as SubCommandable, S as NormalizeToGunshiParams, T as RenderingOptions, _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, c as CommandDecorator, d as CommandLoader, f as CommandRunner, g as ExtractArgExplicitlyProvided, h as ExtendContext, i as CommandCallMode, l as CommandEnvironment, m as DefaultGunshiParams, n as CliOptions, o as CommandContextCore, p as Commandable, r as Command, s as CommandContextExtension, t as Awaitable, u as CommandExamplesFetcher, v as ExtractExtensions, w as RendererDecorator, x as LazyCommand, y as GunshiParams } from "./types-FFgtdrno.js";
+import { i as Args, n as ArgSchema, o as ArgToken, r as ArgValues } from "./resolver-CIPNDx1a.js";
+import { C as Prettify, D as ValidationErrorsDecorator, E as SubCommandable, S as NormalizeToGunshiParams, T as RenderingOptions, _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, c as CommandDecorator, d as CommandLoader, f as CommandRunner, g as ExtractArgExplicitlyProvided, h as ExtendContext, i as CommandCallMode, l as CommandEnvironment, m as DefaultGunshiParams, n as CliOptions, o as CommandContextCore, p as Commandable, r as Command, s as CommandContextExtension, t as Awaitable, u as CommandExamplesFetcher, v as ExtractExtensions, w as RendererDecorator, x as LazyCommand, y as GunshiParams } from "./types-CyyzAaDx.js";
 
 //#region src/cli/bone.d.ts
 /**

package/lib/bone.js

@@ -1,4 +1,4 @@
-import { t as cliCore } from "./core-BQot-D_g.js";
+import { t as cliCore } from "./core-BKtZQ6dG.js";
 //#region src/cli/bone.ts
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)

package/lib/{cli-BIViXHPa.js → cli-DfaFk6tk.js}

@@ -1,6 +1,6 @@
 import { t as plugin } from "./core-D1daCTTE.js";
-import { a as namespacedId, o as COMMON_ARGS, t as renderer } from "./src-Dwp0BoQ5.js";
-import { t as cliCore } from "./core-BQot-D_g.js";
+import { a as namespacedId, o as COMMON_ARGS, t as renderer } from "./src-dTYUlEw_.js";
+import { t as cliCore } from "./core-BKtZQ6dG.js";
 //#region ../plugin-global/src/types.ts
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)

package/lib/combinators.d.ts

@@ -1,6 +1,6 @@
-import { i as Args, n as ArgSchema } from "./resolver-DGtVt298.js";
+import { i as Args, n as ArgSchema } from "./resolver-CIPNDx1a.js";
 
-//#region ../../node_modules/.pnpm/args-tokens@0.24.3/node_modules/args-tokens/lib/combinators.d.ts
+//#region ../../node_modules/.pnpm/args-tokens@0.25.0/node_modules/args-tokens/lib/combinators.d.ts
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)
 * @license MIT

package/lib/combinators.js

@@ -1,4 +1,8 @@
-//#region ../../node_modules/.pnpm/args-tokens@0.24.3/node_modules/args-tokens/lib/combinators.js
+//#region ../../node_modules/.pnpm/args-tokens@0.25.0/node_modules/args-tokens/lib/combinators.js
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 /**
 * Create a string argument schema with optional validation.
 *

package/lib/{constants-BKVrvh3H.d.ts → constants-CPTXtFxe.d.ts}

@@ -1,4 +1,4 @@
-import { m as DefaultGunshiParams, n as CliOptions } from "./types-FFgtdrno.js";
+import { m as DefaultGunshiParams, n as CliOptions } from "./types-CyyzAaDx.js";
 
 //#region src/constants.d.ts
 /**

package/lib/context.d.ts

@@ -1,5 +1,5 @@
-import { i as Args, o as ArgToken, r as ArgValues } from "./resolver-DGtVt298.js";
-import { _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, g as ExtractArgExplicitlyProvided, h as ExtendContext, i as CommandCallMode, m as DefaultGunshiParams, n as CliOptions, r as Command, s as CommandContextExtension, x as LazyCommand, y as GunshiParams } from "./types-FFgtdrno.js";
+import { i as Args, o as ArgToken, r as ArgValues } from "./resolver-CIPNDx1a.js";
+import { _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, g as ExtractArgExplicitlyProvided, h as ExtendContext, i as CommandCallMode, m as DefaultGunshiParams, n as CliOptions, r as Command, s as CommandContextExtension, x as LazyCommand, y as GunshiParams } from "./types-CyyzAaDx.js";
 
 //#region src/context.d.ts
 

package/lib/context.js

@@ -1,5 +1,5 @@
 import { n as CLI_OPTIONS_DEFAULT, r as NOOP, t as ANONYMOUS_COMMAND_NAME } from "./constants-D_ixLD32.js";
-import { a as log, i as isLazyCommand, n as deepFreeze, t as create } from "./utils-CMJNteYK.js";
+import { a as log, i as isLazyCommand, n as deepFreeze, t as create } from "./utils-jNy8sqR5.js";
 //#region src/context.ts
 /**
 * The entry for gunshi context.

package/lib/{core-BQot-D_g.js → core-BKtZQ6dG.js}

@@ -1,7 +1,15 @@
 import { n as CLI_OPTIONS_DEFAULT, r as NOOP } from "./constants-D_ixLD32.js";
-import { i as isLazyCommand, o as resolveLazyCommand, r as getCommandSubCommands, s as kebabnize, t as create } from "./utils-CMJNteYK.js";
+import { i as isLazyCommand, o as resolveLazyCommand, r as getCommandSubCommands, s as kebabnize, t as create } from "./utils-jNy8sqR5.js";
 import { createCommandContext } from "./context.js";
-//#region ../../node_modules/.pnpm/args-tokens@0.24.3/node_modules/args-tokens/lib/parser.js
+//#region ../../node_modules/.pnpm/args-tokens@0.25.0/node_modules/args-tokens/lib/parser.js
+/**
+* forked from `nodejs/node` (`pkgjs/parseargs`)
+* repository url: https://github.com/nodejs/node (https://github.com/pkgjs/parseargs)
+* code url: https://github.com/nodejs/node/blob/main/lib/internal/util/parse_args/parse_args.js
+*
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 const HYPHEN_CHAR = "-";
 const HYPHEN_CODE = HYPHEN_CHAR.codePointAt(0);
 const EQUAL_CHAR = "=";
@@ -198,7 +206,7 @@ function hasOptionValue(value) {
 	return !(value == null) && value.codePointAt(0) !== HYPHEN_CODE;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/args-tokens@0.24.3/node_modules/args-tokens/lib/resolver.js
+//#region ../../node_modules/.pnpm/args-tokens@0.25.0/node_modules/args-tokens/lib/resolver.js
 /**
 * Entry point of argument options resolver.
 *
@@ -257,14 +265,14 @@ function resolveArgs(args, tokens, { shortGrouping = false, skipPositional = SKI
 			return value;
 		}
 	}
-	function applyLongOptionValue(value = void 0) {
+	function applyLongOptionValue(value) {
 		if (currentLongOption) {
 			currentLongOption.value = value;
 			optionTokens.push({ ...currentLongOption });
 			currentLongOption = void 0;
 		}
 	}
-	function applyShortOptionValue(value = void 0) {
+	function applyShortOptionValue(value) {
 		if (currentShortOption) {
 			currentShortOption.value = value || toShortValue();
 			optionTokens.push({ ...currentShortOption });
@@ -498,7 +506,11 @@ function checkConflicts(args, explicit, toKebab, actualInputNames) {
 	return [];
 }
 //#endregion
-//#region ../../node_modules/.pnpm/args-tokens@0.24.3/node_modules/args-tokens/lib/index.js
+//#region ../../node_modules/.pnpm/args-tokens@0.25.0/node_modules/args-tokens/lib/index.js
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)
 * @license MIT
@@ -696,16 +708,16 @@ async function cliCore(argv, entry, options, plugins) {
 	const resolved = resolveCommandTree(tokens, entry, cliOptions);
 	const { commandName: name, command, callMode, commandPath, depth, levelSubCommands } = resolved;
 	if (!command) throw new Error(`Command not found: ${name || ""}`);
-	const args = resolveArguments(pluginContext, getCommandArgs(command));
+	if (levelSubCommands) cliOptions.subCommands = levelSubCommands;
+	const resolvedCommand = isLazyCommand(command) ? await resolveLazyCommand(command, name, true) : command;
+	const args = resolveArguments(pluginContext, getCommandArgs(resolvedCommand));
 	const skipPositional = depth > 0 ? depth - 1 : -1;
 	const { explicit, values, positionals, rest, error } = resolveArgs(args, tokens, {
 		shortGrouping: true,
-		toKebab: command.toKebab,
+		toKebab: resolvedCommand.toKebab,
 		skipPositional
 	});
 	const omitted = resolved.omitted;
-	if (levelSubCommands) cliOptions.subCommands = levelSubCommands;
-	const resolvedCommand = isLazyCommand(command) ? await resolveLazyCommand(command, name, true) : command;
 	return await executeCommand(resolvedCommand, await createCommandContext({
 		args,
 		explicit,

package/lib/definition.d.ts

@@ -1,5 +1,5 @@
-import { i as Args, n as ArgSchema, r as ArgValues } from "./resolver-DGtVt298.js";
-import { C as Prettify, _ as ExtractArgs, b as GunshiParamsConstraint, d as CommandLoader, f as CommandRunner, h as ExtendContext, m as DefaultGunshiParams, r as Command, v as ExtractExtensions, x as LazyCommand, y as GunshiParams } from "./types-FFgtdrno.js";
+import { i as Args, n as ArgSchema, r as ArgValues } from "./resolver-CIPNDx1a.js";
+import { C as Prettify, _ as ExtractArgs, b as GunshiParamsConstraint, d as CommandLoader, f as CommandRunner, h as ExtendContext, m as DefaultGunshiParams, r as Command, v as ExtractExtensions, x as LazyCommand, y as GunshiParams } from "./types-CyyzAaDx.js";
 import { CommandContextParams, createCommandContext } from "./context.js";
 
 //#region src/definition.d.ts

package/lib/generator.d.ts

@@ -1,4 +1,4 @@
-import { b as GunshiParamsConstraint, m as DefaultGunshiParams, n as CliOptions, r as Command, x as LazyCommand } from "./types-FFgtdrno.js";
+import { b as GunshiParamsConstraint, m as DefaultGunshiParams, n as CliOptions, r as Command, x as LazyCommand } from "./types-CyyzAaDx.js";
 
 //#region src/generator.d.ts
 

package/lib/generator.js

@@ -1,5 +1,5 @@
-import { t as create } from "./utils-CMJNteYK.js";
-import { t as cli } from "./cli-BIViXHPa.js";
+import { t as create } from "./utils-jNy8sqR5.js";
+import { t as cli } from "./cli-DfaFk6tk.js";
 //#region src/generator.ts
 /**
 * The entry for usage generator.

package/lib/index.d.ts

@@ -1,8 +1,8 @@
-import { a as resolveArgs, i as Args, n as ArgSchema, o as ArgToken, r as ArgValues, s as parseArgs } from "./resolver-DGtVt298.js";
-import { A as PluginDependency, C as Prettify, D as ValidationErrorsDecorator, E as SubCommandable, F as PluginWithoutExtension, I as plugin, L as PluginContext, M as PluginFunction, N as PluginOptions, O as OnPluginExtension, P as PluginWithExtension, S as NormalizeToGunshiParams, T as RenderingOptions, _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, c as CommandDecorator, d as CommandLoader, f as CommandRunner, g as ExtractArgExplicitlyProvided, h as ExtendContext, i as CommandCallMode, j as PluginExtension, k as Plugin, l as CommandEnvironment, m as DefaultGunshiParams, n as CliOptions, o as CommandContextCore, p as Commandable, r as Command, s as CommandContextExtension, t as Awaitable, u as CommandExamplesFetcher, v as ExtractExtensions, w as RendererDecorator, x as LazyCommand, y as GunshiParams } from "./types-FFgtdrno.js";
+import { a as resolveArgs, i as Args, n as ArgSchema, o as ArgToken, r as ArgValues, s as parseArgs } from "./resolver-CIPNDx1a.js";
+import { A as PluginDependency, C as Prettify, D as ValidationErrorsDecorator, E as SubCommandable, F as PluginWithoutExtension, I as plugin, L as PluginContext, M as PluginFunction, N as PluginOptions, O as OnPluginExtension, P as PluginWithExtension, S as NormalizeToGunshiParams, T as RenderingOptions, _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, c as CommandDecorator, d as CommandLoader, f as CommandRunner, g as ExtractArgExplicitlyProvided, h as ExtendContext, i as CommandCallMode, j as PluginExtension, k as Plugin, l as CommandEnvironment, m as DefaultGunshiParams, n as CliOptions, o as CommandContextCore, p as Commandable, r as Command, s as CommandContextExtension, t as Awaitable, u as CommandExamplesFetcher, v as ExtractExtensions, w as RendererDecorator, x as LazyCommand, y as GunshiParams } from "./types-CyyzAaDx.js";
 import { CommandContextParams, createCommandContext } from "./context.js";
 import { define, defineWithTypes, lazy, lazyWithTypes } from "./definition.js";
-import { t as ANONYMOUS_COMMAND_NAME } from "./constants-BKVrvh3H.js";
+import { t as ANONYMOUS_COMMAND_NAME } from "./constants-CPTXtFxe.js";
 
 //#region ../plugin-i18n/src/types.d.ts
 /**

package/lib/index.js

@@ -1,9 +1,9 @@
 import { t as ANONYMOUS_COMMAND_NAME } from "./constants-D_ixLD32.js";
 import { createCommandContext } from "./context.js";
 import { t as plugin } from "./core-D1daCTTE.js";
-import { a as namespacedId } from "./src-Dwp0BoQ5.js";
-import { n as resolveArgs, r as parseArgs } from "./core-BQot-D_g.js";
-import { t as cli } from "./cli-BIViXHPa.js";
+import { a as namespacedId } from "./src-dTYUlEw_.js";
+import { n as resolveArgs, r as parseArgs } from "./core-BKtZQ6dG.js";
+import { t as cli } from "./cli-DfaFk6tk.js";
 import { define, defineWithTypes, lazy, lazyWithTypes } from "./definition.js";
 //#region ../plugin-i18n/src/translation.ts
 /**

package/lib/plugin.d.ts

@@ -1,7 +1,7 @@
-import { i as Args, n as ArgSchema, o as ArgToken, r as ArgValues } from "./resolver-DGtVt298.js";
-import { A as PluginDependency, C as Prettify, D as ValidationErrorsDecorator, F as PluginWithoutExtension, I as plugin, L as PluginContext, M as PluginFunction, N as PluginOptions, O as OnPluginExtension, P as PluginWithExtension, S as NormalizeToGunshiParams, _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, c as CommandDecorator, f as CommandRunner, h as ExtendContext, j as PluginExtension, k as Plugin, m as DefaultGunshiParams, o as CommandContextCore, r as Command, s as CommandContextExtension, t as Awaitable, u as CommandExamplesFetcher, v as ExtractExtensions, w as RendererDecorator, x as LazyCommand, y as GunshiParams } from "./types-FFgtdrno.js";
+import { i as Args, n as ArgSchema, o as ArgToken, r as ArgValues } from "./resolver-CIPNDx1a.js";
+import { A as PluginDependency, C as Prettify, D as ValidationErrorsDecorator, F as PluginWithoutExtension, I as plugin, L as PluginContext, M as PluginFunction, N as PluginOptions, O as OnPluginExtension, P as PluginWithExtension, S as NormalizeToGunshiParams, _ as ExtractArgs, a as CommandContext, b as GunshiParamsConstraint, c as CommandDecorator, f as CommandRunner, h as ExtendContext, j as PluginExtension, k as Plugin, m as DefaultGunshiParams, o as CommandContextCore, r as Command, s as CommandContextExtension, t as Awaitable, u as CommandExamplesFetcher, v as ExtractExtensions, w as RendererDecorator, x as LazyCommand, y as GunshiParams } from "./types-CyyzAaDx.js";
 import { CommandContextParams, createCommandContext } from "./context.js";
-import { n as CLI_OPTIONS_DEFAULT, t as ANONYMOUS_COMMAND_NAME } from "./constants-BKVrvh3H.js";
+import { n as CLI_OPTIONS_DEFAULT, t as ANONYMOUS_COMMAND_NAME } from "./constants-CPTXtFxe.js";
 
 //#region src/plugin.d.ts
 /**

package/lib/renderer.d.ts

@@ -1,4 +1,4 @@
-import { a as CommandContext, m as DefaultGunshiParams, y as GunshiParams } from "./types-FFgtdrno.js";
+import { a as CommandContext, m as DefaultGunshiParams, y as GunshiParams } from "./types-CyyzAaDx.js";
 
 //#region ../plugin-renderer/src/header.d.ts
 /**

package/lib/renderer.js

@@ -1,4 +1,4 @@
-import { i as renderHeader, n as renderValidationErrors, r as renderUsage } from "./src-Dwp0BoQ5.js";
+import { i as renderHeader, n as renderValidationErrors, r as renderUsage } from "./src-dTYUlEw_.js";
 //#region src/renderer.ts
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)

package/lib/{resolver-DGtVt298.d.ts → resolver-CIPNDx1a.d.ts}

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/args-tokens@0.24.3/node_modules/args-tokens/lib/parser-D95CJBHr.d.ts
+//#region ../../node_modules/.pnpm/args-tokens@0.25.0/node_modules/args-tokens/lib/parser-D95CJBHr.d.ts
 //#region src/parser.d.ts
 /**
  * Entry point of argument parser.
@@ -88,7 +88,7 @@ declare function parseArgs(args: string[], options?: ParserOptions): ArgToken[];
  * @returns Whether `arg` is a short option.
  */
 //#endregion
-//#region ../../node_modules/.pnpm/args-tokens@0.24.3/node_modules/args-tokens/lib/resolver.d.ts
+//#region ../../node_modules/.pnpm/args-tokens@0.25.0/node_modules/args-tokens/lib/resolver.d.ts
 //#region src/resolver.d.ts
 /**
  * An argument schema definition for command-line argument parsing.

package/lib/{src-Dwp0BoQ5.js → src-dTYUlEw_.js}

@@ -1,5 +1,5 @@
 import "./constants-D_ixLD32.js";
-import { o as resolveLazyCommand, s as kebabnize } from "./utils-CMJNteYK.js";
+import { o as resolveLazyCommand, s as kebabnize } from "./utils-jNy8sqR5.js";
 import { t as plugin } from "./core-D1daCTTE.js";
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)

package/lib/{types-FFgtdrno.d.ts → types-CyyzAaDx.d.ts}

@@ -1,4 +1,4 @@
-import { i as Args, n as ArgSchema, o as ArgToken, r as ArgValues, t as ArgExplicitlyProvided } from "./resolver-DGtVt298.js";
+import { i as Args, n as ArgSchema, o as ArgToken, r as ArgValues, t as ArgExplicitlyProvided } from "./resolver-CIPNDx1a.js";
 
 //#region src/plugin/context.d.ts
 /**

package/lib/{utils-CMJNteYK.js → utils-jNy8sqR5.js}

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/args-tokens@0.24.3/node_modules/args-tokens/lib/utils.js
+//#region ../../node_modules/.pnpm/args-tokens@0.25.0/node_modules/args-tokens/lib/utils.js
 /**
 * Entry point of utils.
 *

package/lib/utils.d.ts

@@ -1,6 +1,6 @@
-import { b as GunshiParamsConstraint, m as DefaultGunshiParams, p as Commandable, r as Command, x as LazyCommand } from "./types-FFgtdrno.js";
+import { b as GunshiParamsConstraint, m as DefaultGunshiParams, p as Commandable, r as Command, x as LazyCommand } from "./types-CyyzAaDx.js";
 
-//#region ../../node_modules/.pnpm/args-tokens@0.24.3/node_modules/args-tokens/lib/utils.d.ts
+//#region ../../node_modules/.pnpm/args-tokens@0.25.0/node_modules/args-tokens/lib/utils.d.ts
 
 //#region src/utils.d.ts
 /**

package/lib/utils.js

@@ -1,2 +1,2 @@
-import { a as log, i as isLazyCommand, n as deepFreeze, o as resolveLazyCommand, r as getCommandSubCommands, s as kebabnize, t as create } from "./utils-CMJNteYK.js";
+import { a as log, i as isLazyCommand, n as deepFreeze, o as resolveLazyCommand, r as getCommandSubCommands, s as kebabnize, t as create } from "./utils-jNy8sqR5.js";
 export { create, deepFreeze, getCommandSubCommands, isLazyCommand, kebabnize, log, resolveLazyCommand };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gunshi",
   "description": "Modern javascript command-line library",
-  "version": "0.30.8",
+  "version": "0.31.0",
   "author": {
     "name": "kazuya kawaguchi",
     "email": "kawakazu80@gmail.com"
@@ -90,6 +90,12 @@
       "require": "./lib/combinators.js",
       "default": "./lib/combinators.js"
     },
+    "./agent": {
+      "types": "./lib/agent.d.ts",
+      "import": "./lib/agent.js",
+      "require": "./lib/agent.js",
+      "default": "./lib/agent.js"
+    },
     "./package.json": "./package.json"
   },
   "types": "lib/index.d.ts",
@@ -102,18 +108,19 @@
     }
   },
   "devDependencies": {
-    "args-tokens": "^0.24.3",
+    "args-tokens": "^0.25.0",
     "deno": "^2.7.14",
     "jsr": "^0.14.3",
     "jsr-exports-lint": "^0.4.2",
     "publint": "^0.3.20",
+    "std-env": "^4.1.0",
     "tsdown": "0.21.0",
     "zod": "^4.4.3",
-    "@gunshi/plugin-global": "0.30.8",
-    "@gunshi/plugin-renderer": "0.30.8",
-    "@gunshi/resources": "0.30.8",
-    "@gunshi/plugin-i18n": "0.30.8",
-    "@gunshi/shared": "0.30.8"
+    "@gunshi/plugin-global": "0.31.0",
+    "@gunshi/plugin-i18n": "0.31.0",
+    "@gunshi/plugin-renderer": "0.31.0",
+    "@gunshi/resources": "0.31.0",
+    "@gunshi/shared": "0.31.0"
   },
   "scripts": {
     "build": "tsdown",