effect 4.0.0-beta.2 → 4.0.0-beta.21

package/dist/unstable/ai/Tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tool.js","names":["constFalse","constTrue","identity","pipeArguments","Predicate","Schema","AST","ServiceMap","TypeId","ProviderDefinedTypeId","DynamicTypeId","isUserDefined","u","hasProperty","isProviderDefined","isDynamic","Proto","_Requirements","pipe","arguments","addDependency","userDefinedProto","setParameters","parametersSchema","setSuccess","successSchema","setFailure","failureSchema","annotate","tag","value","annotations","add","annotateMerge","context","merge","ProviderDefinedProto","DynamicProto","options","self","Object","assign","create","id","name","providerDefinedProto","dynamicProto","make","success","Void","failure","Never","description","parameters","failureMode","empty","needsApproval","dynamic","Unknown","rawParameters","isEffectSchema","isSchema","jsonSchema","undefined","providerDefined","args","isNotUndefined","customName","providerName","argsSchema","requiresHandler","NameMapper","customToProvider","Map","providerToCustom","constructor","tools","tool","set","customNames","Array","from","keys","providerNames","getCustomName","get","getProviderName","getDescription","resolveDescription","ast","getJsonSchema","getJsonSchemaFromSchema","schema","props","isObjects","propertySignatures","length","type","properties","required","additionalProperties","transformer","document","toJsonSchemaDocument","definitions","$defs","Title","Service","Readonly","Reference","defaultValue","Destructive","Idempotent","OpenWorld","Strict","getStrictMode","suspectProtoRx","suspectConstructorRx","_parse","text","obj","JSON","parse","test","filter","next","nodes","node","prototype","hasOwnProperty","call","SyntaxError","key","push","unsafeSecureJsonParse","stackTraceLimit","Error"],"sources":["../../../src/unstable/ai/Tool.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Tool.js","names":["constFalse","constTrue","identity","pipeArguments","Predicate","Schema","AST","ServiceMap","TypeId","ProviderDefinedTypeId","DynamicTypeId","isUserDefined","u","hasProperty","isProviderDefined","isDynamic","Proto","_Requirements","pipe","arguments","addDependency","userDefinedProto","setParameters","parametersSchema","setSuccess","successSchema","setFailure","failureSchema","annotate","tag","value","annotations","add","annotateMerge","context","merge","ProviderDefinedProto","DynamicProto","options","self","Object","assign","create","id","name","providerDefinedProto","dynamicProto","make","success","Void","failure","Never","description","parameters","failureMode","empty","needsApproval","dynamic","Unknown","rawParameters","isEffectSchema","isSchema","jsonSchema","undefined","providerDefined","args","isNotUndefined","customName","providerName","argsSchema","requiresHandler","NameMapper","customToProvider","Map","providerToCustom","constructor","tools","tool","set","customNames","Array","from","keys","providerNames","getCustomName","get","getProviderName","getDescription","resolveDescription","ast","getJsonSchema","getJsonSchemaFromSchema","schema","transformer","document","toJsonSchemaDocument","definitions","length","$defs","Title","Service","Meta","Readonly","Reference","defaultValue","Destructive","Idempotent","OpenWorld","Strict","getStrictMode","suspectProtoRx","suspectConstructorRx","_parse","text","obj","JSON","parse","test","filter","next","nodes","node","prototype","hasOwnProperty","call","SyntaxError","key","push","unsafeSecureJsonParse","stackTraceLimit","Error"],"sources":["../../../src/unstable/ai/Tool.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/ai/index.d.ts

@@ -270,7 +270,7 @@ export * as McpServer from "./McpServer.ts";
  *
  * declare const myAnthropicLayer: Layer.Layer<LanguageModel.LanguageModel>
  *
- * const anthropicModel = Model.make("anthropic", myAnthropicLayer)
+ * const anthropicModel = Model.make("anthropic", "claude-3-5-haiku", myAnthropicLayer)
  *
  * const program = Effect.gen(function*() {
  *   const response = yield* LanguageModel.generateText({

package/dist/unstable/ai/index.js

@@ -271,7 +271,7 @@ export * as McpServer from "./McpServer.js";
  *
  * declare const myAnthropicLayer: Layer.Layer<LanguageModel.LanguageModel>
  *
- * const anthropicModel = Model.make("anthropic", myAnthropicLayer)
+ * const anthropicModel = Model.make("anthropic", "claude-3-5-haiku", myAnthropicLayer)
  *
  * const program = Effect.gen(function*() {
  *   const response = yield* LanguageModel.generateText({

package/dist/unstable/cli/CliError.d.ts

@@ -69,8 +69,8 @@ export type CliError = UnrecognizedOption | DuplicateOption | MissingOption | Mi
 declare const UnrecognizedOption_base: Schema.ErrorClass<unknown, Schema.Struct<{
     readonly _tag: Schema.tag<"UnrecognizedOption">;
     readonly option: Schema.String;
-    readonly command: Schema.optional<Schema.Array$<Schema.String>>;
-    readonly suggestions: Schema.Array$<Schema.String>;
+    readonly command: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly suggestions: Schema.$Array<Schema.String>;
 }>, import("../../Cause.ts").YieldableError>;
 /**
  * Error thrown when an unrecognized option is encountered.
@@ -289,8 +289,8 @@ export declare class InvalidValue extends InvalidValue_base {
 declare const UnknownSubcommand_base: Schema.ErrorClass<unknown, Schema.Struct<{
     readonly _tag: Schema.tag<"UnknownSubcommand">;
     readonly subcommand: Schema.String;
-    readonly parent: Schema.optional<Schema.Array$<Schema.String>>;
-    readonly suggestions: Schema.Array$<Schema.String>;
+    readonly parent: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly suggestions: Schema.$Array<Schema.String>;
 }>, import("../../Cause.ts").YieldableError>;
 /**
  * Error thrown when an unknown subcommand is encountered.
@@ -339,7 +339,7 @@ export declare class UnknownSubcommand extends UnknownSubcommand_base {
 }
 declare const ShowHelp_base: Schema.ErrorClass<unknown, Schema.Struct<{
     readonly _tag: Schema.tag<"ShowHelp">;
-    readonly commandPath: Schema.Array$<Schema.String>;
+    readonly commandPath: Schema.$Array<Schema.String>;
 }>, import("../../Cause.ts").YieldableError>;
 /**
  * Control flow indicator when help is requested via --help flag.

package/dist/unstable/cli/CliOutput.js

@@ -201,6 +201,7 @@ const renderTable = (rows, widthCap) => {
     right
   }) => `  ${pad(left, col)}${right}`).join("\n");
 };
+const formatSubcommandName = (name, alias) => alias ? `${name}, ${alias}` : name;
 /**
  * Internal implementation of help formatting that accepts configurable color functions.
  * @internal
@@ -259,14 +260,66 @@ const formatHelpDocImpl = (doc, colors) => {
     sections.push(renderTable(flagRows, 30));
     sections.push("");
   }
+  // Global Flags section
+  if (doc.globalFlags && doc.globalFlags.length > 0) {
+    sections.push(colors.bold("GLOBAL FLAGS"));
+    const globalFlagRows = doc.globalFlags.map(flag => {
+      const names = [];
+      // Add main name with -- prefix first
+      names.push(colors.green(`--${flag.name}`));
+      // Add aliases after (like -f) to match expected ordering
+      for (const alias of flag.aliases) {
+        names.push(colors.green(alias));
+      }
+      const namesPart = names.join(", ");
+      const typePart = flag.type !== "boolean" ? ` ${colors.dim(flag.type)}` : "";
+      return {
+        left: namesPart + typePart,
+        right: flag.description ?? ""
+      };
+    });
+    sections.push(renderTable(globalFlagRows, 30));
+    sections.push("");
+  }
   // Subcommands section
   if (doc.subcommands && doc.subcommands.length > 0) {
-    sections.push(colors.bold("SUBCOMMANDS"));
-    const subcommandRows = doc.subcommands.map(sub => ({
-      left: colors.cyan(sub.name),
-      right: sub.description
-    }));
-    sections.push(renderTable(subcommandRows, 20));
+    const ungrouped = doc.subcommands.find(group => group.group === undefined);
+    if (ungrouped) {
+      sections.push(colors.bold("SUBCOMMANDS"));
+      sections.push(renderTable(ungrouped.commands.map(sub => ({
+        left: colors.cyan(formatSubcommandName(sub.name, sub.alias)),
+        right: sub.shortDescription ?? sub.description
+      })), 20));
+      if (doc.subcommands.length > 1) {
+        sections.push("");
+      }
+    }
+    for (const group of doc.subcommands) {
+      if (group.group === undefined) continue;
+      sections.push(colors.bold(`${group.group}:`));
+      sections.push(renderTable(group.commands.map(sub => ({
+        left: colors.cyan(formatSubcommandName(sub.name, sub.alias)),
+        right: sub.shortDescription ?? sub.description
+      })), 20));
+      sections.push("");
+    }
+  }
+  // Examples section
+  if (doc.examples && doc.examples.length > 0) {
+    sections.push(colors.bold("EXAMPLES"));
+    let first = true;
+    let previousHadDescription = false;
+    for (const example of doc.examples) {
+      if (example.description) {
+        if (!first) sections.push("");
+        sections.push(`  ${colors.dim(`# ${example.description}`)}`);
+      } else if (previousHadDescription) {
+        sections.push("");
+      }
+      sections.push(`  ${colors.cyan(example.command)}`);
+      first = false;
+      previousHadDescription = !!example.description;
+    }
     sections.push("");
   }
   // Remove trailing empty line if present

package/dist/unstable/cli/CliOutput.js.map

@@ -1 +1 @@
-{"version":3,"file":"CliOutput.js","names":["Layer","ServiceMap","Formatter","Reference","defaultValue","defaultFormatter","layer","formatter","succeed","options","globalProcess","globalThis","process","hasProcess","useColor","colors","undefined","stdout","isTTY","env","NO_COLOR","bold","text","dim","cyan","green","blue","yellow","magenta","reset","red","formatHelpDoc","doc","formatHelpDocImpl","formatCliError","error","message","formatError","formatErrors","errors","length","grouped","Map","tag","_tag","group","get","push","set","sections","join","formatVersion","name","version","stripAnsi","replace","visualLength","pad","s","width","actualLength","padding","Math","max","repeat","renderTable","rows","widthCap","col","min","map","r","left","right","description","usage","args","argRows","arg","variadic","coloredName","coloredType","type","nameType","optionalSuffix","required","flags","flagRows","flag","names","alias","aliases","namesPart","typePart","subcommands","subcommandRows","sub","pop"],"sources":["../../../src/unstable/cli/CliOutput.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"CliOutput.js","names":["Layer","ServiceMap","Formatter","Reference","defaultValue","defaultFormatter","layer","formatter","succeed","options","globalProcess","globalThis","process","hasProcess","useColor","colors","undefined","stdout","isTTY","env","NO_COLOR","bold","text","dim","cyan","green","blue","yellow","magenta","reset","red","formatHelpDoc","doc","formatHelpDocImpl","formatCliError","error","message","formatError","formatErrors","errors","length","grouped","Map","tag","_tag","group","get","push","set","sections","join","formatVersion","name","version","stripAnsi","replace","visualLength","pad","s","width","actualLength","padding","Math","max","repeat","renderTable","rows","widthCap","col","min","map","r","left","right","formatSubcommandName","alias","description","usage","args","argRows","arg","variadic","coloredName","coloredType","type","nameType","optionalSuffix","required","flags","flagRows","flag","names","aliases","namesPart","typePart","globalFlags","globalFlagRows","subcommands","ungrouped","find","commands","sub","shortDescription","examples","first","previousHadDescription","example","command","pop"],"sources":["../../../src/unstable/cli/CliOutput.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/cli/Command.d.ts

@@ -1,15 +1,20 @@
+/**
+ * @since 4.0.0
+ */
+import type { NonEmptyReadonlyArray } from "../../Array.ts";
 import * as Effect from "../../Effect.ts";
 import type * as FileSystem from "../../FileSystem.ts";
 import type * as Layer from "../../Layer.ts";
 import type * as Path from "../../Path.ts";
 import type { Pipeable } from "../../Pipeable.ts";
-import type * as ServiceMap from "../../ServiceMap.ts";
+import * as ServiceMap from "../../ServiceMap.ts";
 import * as Terminal from "../../Terminal.ts";
-import type { Simplify } from "../../Types.ts";
+import type { NoInfer, Simplify } from "../../Types.ts";
 import type { ChildProcessSpawner } from "../process/ChildProcessSpawner.ts";
 import * as CliError from "./CliError.ts";
+import * as GlobalFlag from "./GlobalFlag.ts";
 import { TypeId } from "./internal/command.ts";
-import type * as Param from "./Param.ts";
+import * as Param from "./Param.ts";
 /**
  * Represents a CLI command with its configuration, handler, and metadata.
  *
@@ -64,15 +69,44 @@ export interface Command<Name extends string, Input, E = never, R = never> exten
      * An optional description of the command.
      */
     readonly description: string | undefined;
+    /**
+     * An optional short description used when listing subcommands.
+     */
+    readonly shortDescription: string | undefined;
+    /**
+     * An optional alias that can be used as a shorter command name.
+     */
+    readonly alias: string | undefined;
+    /**
+     * Optional usage examples for the command.
+     */
+    readonly examples: ReadonlyArray<Command.Example>;
     /**
      * The subcommands available under this command.
      */
-    readonly subcommands: ReadonlyArray<Command.Any>;
+    readonly subcommands: ReadonlyArray<{
+        readonly group: string | undefined;
+        readonly commands: NonEmptyReadonlyArray<Command.Any>;
+    }>;
+    /**
+     * Custom annotations associated with this command.
+     */
+    readonly annotations: ServiceMap.ServiceMap<never>;
 }
 /**
  * @since 4.0.0
  */
 export declare namespace Command {
+    /**
+     * Represents a concrete usage example for a command.
+     *
+     * @since 4.0.0
+     * @category models
+     */
+    interface Example {
+        readonly command: string;
+        readonly description?: string | undefined;
+    }
     /**
      * Configuration object for defining command flags, arguments, and nested structures.
      *
@@ -171,6 +205,23 @@ export declare namespace Command {
      * @category models
      */
     type Any = Command<string, unknown, unknown, unknown>;
+    /**
+     * A grouped set of subcommands used by `Command.withSubcommands`.
+     *
+     * @since 4.0.0
+     * @category models
+     */
+    interface SubcommandGroup<Commands extends ReadonlyArray<Any> = ReadonlyArray<Any>> {
+        readonly group: string;
+        readonly commands: Commands;
+    }
+    /**
+     * Entry type accepted by `Command.withSubcommands`.
+     *
+     * @since 4.0.0
+     * @category models
+     */
+    type SubcommandEntry = Any | SubcommandGroup<ReadonlyArray<Any>>;
 }
 /**
  * The environment required by CLI commands, including file system and path operations.
@@ -461,7 +512,7 @@ export declare const make: {
      * @since 4.0.0
      * @category constructors
      */
-    <Name extends string, const Config extends Command.Config, R, E>(name: Name, config: Config, handler: (config: Command.Config.Infer<Config>) => Effect.Effect<void, E, R>): Command<Name, Command.Config.Infer<Config>, E, R>;
+    <Name extends string, const Config extends Command.Config, R, E>(name: Name, config: Config, handler: (config: Command.Config.Infer<Config>) => Effect.Effect<void, E, R>): Command<Name, Command.Config.Infer<Config>, E, Exclude<R, GlobalFlag.BuiltInSettingContext>>;
 };
 /**
  * Adds or replaces the handler for a command.
@@ -512,7 +563,7 @@ export declare const withHandler: {
      * @since 4.0.0
      * @category combinators
      */
-    <A, R, E>(handler: (value: A) => Effect.Effect<void, E, R>): <Name extends string, XR, XE>(self: Command<Name, A, XE, XR>) => Command<Name, A, E, R>;
+    <A, R, E>(handler: (value: A) => Effect.Effect<void, E, R>): <Name extends string, XR, XE>(self: Command<Name, A, XE, XR>) => Command<Name, A, E, Exclude<R, GlobalFlag.BuiltInSettingContext>>;
     /**
      * Adds or replaces the handler for a command.
      *
@@ -537,7 +588,7 @@ export declare const withHandler: {
      * @since 4.0.0
      * @category combinators
      */
-    <Name extends string, A, XR, XE, R, E>(self: Command<Name, A, XE, XR>, handler: (value: A) => Effect.Effect<void, E, R>): Command<Name, A, E, R>;
+    <Name extends string, A, XR, XE, R, E>(self: Command<Name, A, XE, XR>, handler: (value: A) => Effect.Effect<void, E, R>): Command<Name, A, E, Exclude<R, GlobalFlag.BuiltInSettingContext>>;
 };
 /**
  * Adds subcommands to a command, creating a hierarchical command structure.
@@ -612,7 +663,7 @@ export declare const withSubcommands: {
      * @since 4.0.0
      * @category combinators
      */
-    <const Subcommands extends ReadonlyArray<Command<any, any, any, any>>>(subcommands: Subcommands): <Name extends string, Input, E, R>(self: Command<Name, Input, E, R>) => Command<Name, Input, E | ExtractSubcommandErrors<Subcommands>, R | Exclude<ExtractSubcommandContext<Subcommands>, CommandContext<Name>>>;
+    <const Subcommands extends ReadonlyArray<Command.SubcommandEntry>>(subcommands: Subcommands): <Name extends string, Input, E, R>(self: Command<Name, Input, E, R>) => Command<Name, Input, E | ExtractSubcommandErrors<Subcommands>, R | Exclude<ExtractSubcommandContext<Subcommands>, CommandContext<Name>>>;
     /**
      * Adds subcommands to a command, creating a hierarchical command structure.
      *
@@ -649,10 +700,40 @@ export declare const withSubcommands: {
      * @since 4.0.0
      * @category combinators
      */
-    <Name extends string, Input, E, R, const Subcommands extends ReadonlyArray<Command<any, any, any, any>>>(self: Command<Name, Input, E, R>, subcommands: Subcommands): Command<Name, Input, E | ExtractSubcommandErrors<Subcommands>, R | Exclude<ExtractSubcommandContext<Subcommands>, CommandContext<Name>>>;
+    <Name extends string, Input, E, R, const Subcommands extends ReadonlyArray<Command.SubcommandEntry>>(self: Command<Name, Input, E, R>, subcommands: Subcommands): Command<Name, Input, E | ExtractSubcommandErrors<Subcommands>, R | Exclude<ExtractSubcommandContext<Subcommands>, CommandContext<Name>>>;
 };
-type ExtractSubcommandErrors<T extends ReadonlyArray<Command<any, any, any, any>>> = Error<T[number]>;
-type ExtractSubcommandContext<T extends ReadonlyArray<Command<any, any, any, any>>> = T[number] extends Command<any, any, any, infer R> ? R : never;
+/**
+ * Declares global flags for a command scope.
+ *
+ * Declared global flags apply to the command and all of its descendants.
+ *
+ * @since 4.0.0
+ * @category combinators
+ */
+export declare const withGlobalFlags: {
+    /**
+     * Declares global flags for a command scope.
+     *
+     * Declared global flags apply to the command and all of its descendants.
+     *
+     * @since 4.0.0
+     * @category combinators
+     */
+    <const GlobalFlags extends ReadonlyArray<GlobalFlag.GlobalFlag<any>>>(globalFlags: GlobalFlags): <Name extends string, Input, E, R>(self: Command<Name, Input, E, R>) => Command<Name, Input, E, Exclude<R, ExtractGlobalFlagContext<GlobalFlags>>>;
+    /**
+     * Declares global flags for a command scope.
+     *
+     * Declared global flags apply to the command and all of its descendants.
+     *
+     * @since 4.0.0
+     * @category combinators
+     */
+    <Name extends string, Input, E, R, const GlobalFlags extends ReadonlyArray<GlobalFlag.GlobalFlag<any>>>(self: Command<Name, Input, E, R>, globalFlags: GlobalFlags): Command<Name, Input, E, Exclude<R, ExtractGlobalFlagContext<GlobalFlags>>>;
+};
+type ExtractGlobalFlagContext<T extends ReadonlyArray<GlobalFlag.GlobalFlag<any>>> = T[number] extends infer F ? F extends GlobalFlag.Setting<infer Id, any> ? GlobalFlag.Setting.Identifier<Id> : never : never;
+type ExtractSubcommand<T> = T extends Command<any, any, any, any> ? T : T extends Command.SubcommandGroup<infer Commands> ? Commands[number] : never;
+type ExtractSubcommandErrors<T extends ReadonlyArray<Command.SubcommandEntry>> = Error<ExtractSubcommand<T[number]>>;
+type ExtractSubcommandContext<T extends ReadonlyArray<Command.SubcommandEntry>> = ExtractSubcommand<T[number]> extends Command<any, any, any, infer R> ? R : never;
 /**
  * Sets the description for a command.
  *
@@ -729,6 +810,182 @@ export declare const withDescription: {
      */
     <const Name extends string, Input, E, R>(self: Command<Name, Input, E, R>, description: string): Command<Name, Input, E, R>;
 };
+/**
+ * Sets a short description for a command.
+ *
+ * Short descriptions are used when listing subcommands in help output and
+ * shell completions. If no short description is provided, the full
+ * `description` is used as a fallback.
+ *
+ * @since 4.0.0
+ * @category combinators
+ */
+export declare const withShortDescription: {
+    /**
+     * Sets a short description for a command.
+     *
+     * Short descriptions are used when listing subcommands in help output and
+     * shell completions. If no short description is provided, the full
+     * `description` is used as a fallback.
+     *
+     * @since 4.0.0
+     * @category combinators
+     */
+    (shortDescription: string): <const Name extends string, Input, E, R>(self: Command<Name, Input, E, R>) => Command<Name, Input, E, R>;
+    /**
+     * Sets a short description for a command.
+     *
+     * Short descriptions are used when listing subcommands in help output and
+     * shell completions. If no short description is provided, the full
+     * `description` is used as a fallback.
+     *
+     * @since 4.0.0
+     * @category combinators
+     */
+    <const Name extends string, Input, E, R>(self: Command<Name, Input, E, R>, shortDescription: string): Command<Name, Input, E, R>;
+};
+/**
+ * Sets an alias for a command.
+ *
+ * Aliases are accepted as alternate subcommand names during parsing and are
+ * shown in help output as `name, alias`.
+ *
+ * @since 4.0.0
+ * @category combinators
+ */
+export declare const withAlias: {
+    /**
+     * Sets an alias for a command.
+     *
+     * Aliases are accepted as alternate subcommand names during parsing and are
+     * shown in help output as `name, alias`.
+     *
+     * @since 4.0.0
+     * @category combinators
+     */
+    (alias: string): <const Name extends string, Input, E, R>(self: Command<Name, Input, E, R>) => Command<Name, Input, E, R>;
+    /**
+     * Sets an alias for a command.
+     *
+     * Aliases are accepted as alternate subcommand names during parsing and are
+     * shown in help output as `name, alias`.
+     *
+     * @since 4.0.0
+     * @category combinators
+     */
+    <const Name extends string, Input, E, R>(self: Command<Name, Input, E, R>, alias: string): Command<Name, Input, E, R>;
+};
+/**
+ * Adds a custom annotation to a command.
+ *
+ * @since 4.0.0
+ * @category combinators
+ */
+export declare const annotate: {
+    /**
+     * Adds a custom annotation to a command.
+     *
+     * @since 4.0.0
+     * @category combinators
+     */
+    <I, S>(service: ServiceMap.Key<I, S>, value: NoInfer<S>): <Name extends string, Input, E, R>(self: Command<Name, Input, E, R>) => Command<Name, Input, E, R>;
+    /**
+     * Adds a custom annotation to a command.
+     *
+     * @since 4.0.0
+     * @category combinators
+     */
+    <Name extends string, Input, E, R, I, S>(self: Command<Name, Input, E, R>, service: ServiceMap.Key<I, S>, value: NoInfer<S>): Command<Name, Input, E, R>;
+};
+/**
+ * Merges a ServiceMap of annotations into a command.
+ *
+ * @since 4.0.0
+ * @category combinators
+ */
+export declare const annotateMerge: {
+    /**
+     * Merges a ServiceMap of annotations into a command.
+     *
+     * @since 4.0.0
+     * @category combinators
+     */
+    <I>(annotations: ServiceMap.ServiceMap<I>): <Name extends string, Input, E, R>(self: Command<Name, Input, E, R>) => Command<Name, Input, E, R>;
+    /**
+     * Merges a ServiceMap of annotations into a command.
+     *
+     * @since 4.0.0
+     * @category combinators
+     */
+    <Name extends string, Input, E, R, I>(self: Command<Name, Input, E, R>, annotations: ServiceMap.ServiceMap<I>): Command<Name, Input, E, R>;
+};
+/**
+ * Sets usage examples for a command.
+ *
+ * Examples are exposed in structured `HelpDoc` data and rendered by the
+ * default formatter in an `EXAMPLES` section.
+ *
+ * @example
+ * ```ts
+ * import { Command } from "effect/unstable/cli"
+ *
+ * const login = Command.make("login").pipe(
+ *   Command.withExamples([
+ *     { command: "myapp login", description: "Log in with browser OAuth" },
+ *     { command: "myapp login --token sbp_abc123", description: "Log in with a token" }
+ *   ])
+ * )
+ * ```
+ *
+ * @since 4.0.0
+ * @category combinators
+ */
+export declare const withExamples: {
+    /**
+     * Sets usage examples for a command.
+     *
+     * Examples are exposed in structured `HelpDoc` data and rendered by the
+     * default formatter in an `EXAMPLES` section.
+     *
+     * @example
+     * ```ts
+     * import { Command } from "effect/unstable/cli"
+     *
+     * const login = Command.make("login").pipe(
+     *   Command.withExamples([
+     *     { command: "myapp login", description: "Log in with browser OAuth" },
+     *     { command: "myapp login --token sbp_abc123", description: "Log in with a token" }
+     *   ])
+     * )
+     * ```
+     *
+     * @since 4.0.0
+     * @category combinators
+     */
+    (examples: ReadonlyArray<Command.Example>): <const Name extends string, Input, E, R>(self: Command<Name, Input, E, R>) => Command<Name, Input, E, R>;
+    /**
+     * Sets usage examples for a command.
+     *
+     * Examples are exposed in structured `HelpDoc` data and rendered by the
+     * default formatter in an `EXAMPLES` section.
+     *
+     * @example
+     * ```ts
+     * import { Command } from "effect/unstable/cli"
+     *
+     * const login = Command.make("login").pipe(
+     *   Command.withExamples([
+     *     { command: "myapp login", description: "Log in with browser OAuth" },
+     *     { command: "myapp login --token sbp_abc123", description: "Log in with a token" }
+     *   ])
+     * )
+     * ```
+     *
+     * @since 4.0.0
+     * @category combinators
+     */
+    <const Name extends string, Input, E, R>(self: Command<Name, Input, E, R>, examples: ReadonlyArray<Command.Example>): Command<Name, Input, E, R>;
+};
 /**
  * Provides the handler of a command with the services produced by a layer
  * that optionally depends on the command-line input to be created.
@@ -860,7 +1117,7 @@ export declare const provideSync: {
      * @since 4.0.0
      * @category providing services
      */
-    <I, S, Input>(service: ServiceMap.Service<I, S>, implementation: S | ((input: Input) => S)): <const Name extends string, E, R>(self: Command<Name, Input, E, R>) => Command<Name, Input, E, Exclude<R, I>>;
+    <I, S, Input>(service: ServiceMap.Key<I, S>, implementation: S | ((input: Input) => S)): <const Name extends string, E, R>(self: Command<Name, Input, E, R>) => Command<Name, Input, E, Exclude<R, I>>;
     /**
      * Provides the handler of a command with the implementation of a service that
      * optionally depends on the command-line input to be constructed.
@@ -868,7 +1125,7 @@ export declare const provideSync: {
      * @since 4.0.0
      * @category providing services
      */
-    <const Name extends string, Input, E, R, I, S>(self: Command<Name, Input, E, R>, service: ServiceMap.Service<I, S>, implementation: S | ((input: Input) => S)): Command<Name, Input, E, Exclude<R, I>>;
+    <const Name extends string, Input, E, R, I, S>(self: Command<Name, Input, E, R>, service: ServiceMap.Key<I, S>, implementation: S | ((input: Input) => S)): Command<Name, Input, E, Exclude<R, I>>;
 };
 /**
  * Provides the handler of a command with the service produced by an effect
@@ -885,7 +1142,7 @@ export declare const provideEffect: {
      * @since 4.0.0
      * @category providing services
      */
-    <I, S, Input, R2, E2>(service: ServiceMap.Service<I, S>, effect: Effect.Effect<S, E2, R2> | ((input: Input) => Effect.Effect<S, E2, R2>)): <const Name extends string, E, R>(self: Command<Name, Input, E, R>) => Command<Name, Input, E | E2, Exclude<R, I> | R2>;
+    <I, S, Input, R2, E2>(service: ServiceMap.Key<I, S>, effect: Effect.Effect<S, E2, R2> | ((input: Input) => Effect.Effect<S, E2, R2>)): <const Name extends string, E, R>(self: Command<Name, Input, E, R>) => Command<Name, Input, E | E2, Exclude<R, I> | R2>;
     /**
      * Provides the handler of a command with the service produced by an effect
      * that optionally depends on the command-line input to be created.
@@ -893,7 +1150,7 @@ export declare const provideEffect: {
      * @since 4.0.0
      * @category providing services
      */
-    <const Name extends string, Input, E, R, I, S, R2, E2>(self: Command<Name, Input, E, R>, service: ServiceMap.Service<I, S>, effect: Effect.Effect<S, E2, R2> | ((input: Input) => Effect.Effect<S, E2, R2>)): Command<Name, Input, E | E2, Exclude<R, I> | R2>;
+    <const Name extends string, Input, E, R, I, S, R2, E2>(self: Command<Name, Input, E, R>, service: ServiceMap.Key<I, S>, effect: Effect.Effect<S, E2, R2> | ((input: Input) => Effect.Effect<S, E2, R2>)): Command<Name, Input, E | E2, Exclude<R, I> | R2>;
 };
 /**
  * Allows for execution of an effect, which optionally depends on command-line
@@ -969,9 +1226,9 @@ export declare const run: {
      * @since 4.0.0
      * @category command execution
      */
-    <Name extends string, Input, E, R>(command: Command<Name, Input, E, R>, config: {
+    (config: {
         readonly version: string;
-    }): Effect.Effect<void, E | CliError.CliError, R | Environment>;
+    }): <Name extends string, Input, E, R>(command: Command<Name, Input, E, R>) => Effect.Effect<void, E | CliError.CliError, R | Environment>;
     /**
      * Runs a command with the provided input arguments.
      *
@@ -996,9 +1253,9 @@ export declare const run: {
      * @since 4.0.0
      * @category command execution
      */
-    (config: {
+    <Name extends string, Input, E, R>(command: Command<Name, Input, E, R>, config: {
         readonly version: string;
-    }): <Name extends string, Input, E, R>(command: Command<Name, Input, E, R>) => Effect.Effect<void, E | CliError.CliError, R | Environment>;
+    }): Effect.Effect<void, E | CliError.CliError, R | Environment>;
 };
 /**
  * Runs a command with explicitly provided arguments instead of using process.argv.