@politty/loculus 0.2.2 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -2
- package/dist/agent.d.ts +1 -1
- package/dist/{cli-main-BfVeBgWH.js → cli-main-CYw9CO6g.js} +2 -2
- package/dist/cli-main-D-cfXp31.js +1 -0
- package/dist/cli-run-BxsmKHV0.js +1 -0
- package/dist/cli.js +1 -1
- package/dist/compile-cache.d.ts +1 -3
- package/dist/{completion-HFTQqCkl.js → completion-DjxPFcWB.js} +1 -1
- package/dist/completion-W_nxO_kv.js +1 -0
- package/dist/completion.d.ts +2 -22
- package/dist/completion.js +1 -1
- package/dist/{detect-agent-EHaSY1KW.d.ts → detect-agent-hU93hctO.d.ts} +0 -4
- package/dist/docs.d.ts +1 -21
- package/dist/docs.js +2 -2
- package/dist/dynamic-CDaJH0_w.js +1 -0
- package/dist/{dynamic-6tiYA5H2.js → dynamic-D_i-A8Qb.js} +2 -2
- package/dist/index.d.ts +24 -49
- package/dist/index.js +1 -1
- package/dist/prompt-Bmm7QM-I.js +1 -0
- package/dist/prompt-clack.d.ts +2 -4
- package/dist/prompt-clack.js +1 -1
- package/dist/prompt-inquirer.d.ts +2 -4
- package/dist/prompt-inquirer.js +1 -1
- package/dist/prompt.d.ts +2 -10
- package/dist/prompt.js +1 -1
- package/dist/runner-B7QLJFxY.js +33 -0
- package/dist/runner-BdAfqN-z.js +1 -0
- package/dist/{schema-CuJVxa-M.js → schema-Dqan9VXJ.js} +1 -1
- package/dist/schema-extractor-D6Se8W6B.js +1 -0
- package/dist/skill.d.ts +7 -22
- package/dist/skill.js +2 -2
- package/dist/{types-DtQ-Zt3n.d.ts → types-CaP5nn8i.d.ts} +56 -28
- package/dist/{with-completion-command-QHQsd0Zt.d.ts → with-completion-command-BhjWVp1l.d.ts} +1 -9
- package/dist/{with-completion-command-D4dL2Wpw.js → with-completion-command-DQ1vWryG.js} +2 -2
- package/package.json +4 -4
- package/dist/cli-main-eAweK3gm.js +0 -1
- package/dist/cli-run-wkTnhYYA.js +0 -1
- package/dist/completion-spw7tGzT.js +0 -1
- package/dist/dynamic-ChNWK13o.js +0 -1
- package/dist/prompt-Bsj8hqe0.js +0 -1
- package/dist/runner-C5OHC75C.js +0 -33
- package/dist/runner-CjoCRiEO.js +0 -1
- package/dist/schema-extractor-BK1sJx7i.js +0 -1
package/dist/index.d.ts
CHANGED
|
@@ -1,8 +1,7 @@
|
|
|
1
|
-
import { r as KnownAgentId, t as AgentInfo } from "./detect-agent-
|
|
2
|
-
import { $ as
|
|
3
|
-
import { _ as CompletionResult, g as CompletionOptions, i as GenerateBundledCompletionWorkerResult, n as withCompletionCommand, r as GenerateBundledCompletionWorkerOptions, t as WithCompletionOptions, x as InternalArgsSchema } from "./with-completion-command-
|
|
4
|
-
import { Field, Schema } from "loculus";
|
|
5
|
-
//#region ../core/src/core/schema-extractor.d.ts
|
|
1
|
+
import { r as KnownAgentId, t as AgentInfo } from "./detect-agent-hU93hctO.js";
|
|
2
|
+
import { $ as ExpandCandidate, A as SubCommandValue, B as toKebabCase, C as RunCommandOptions, D as RunResultSuccess, E as RunResultFailure, F as lazy, G as CustomCompletion, H as ArgMeta, I as ExtractedFields, J as PromptChoicesContext, K as EffectContext, L as ResolvedFieldMeta, M as UnknownSubcommandHandler, N as LazyCommand, O as RunnableCommand, P as isLazyCommand, Q as ValidateArgMeta, R as UnknownKeysMode, S as PromptResolverContext, T as RunResult, U as CompletionMeta, V as ArgFn, W as CompletionType, X as PromptMeta, Y as PromptChoicesResolver, Z as PromptType, _ as LogStream, a as ArgsSchema$1, at as DynamicCompletionResolver, b as NonRunnableCommand, c as Command, ct as loadPackage, d as GlobalArgs, et as ExpandCompletion, f as GlobalCleanupContext, g as LogLevel, h as LogEntry, i as ArgSource, it as DynamicCompletionContext, j as SubCommandsRecord, k as SetupContext, l as CommandBase, lt as InferSchemaOutput, m as IsEmpty, n as AgentHelpContext, nt as CompletionDirectiveMask, o as CleanupContext, ot as DynamicCompletionResult, p as GlobalSetupContext, q as PromptChoices, r as AnyCommand, rt as DynamicCompletionCandidate, s as CollectedLogs, st as PackageRequirement, t as AgentHelp, tt as ResolvedExpandCandidate, u as Example, ut as SchemaLike, v as Logger, w as RunInvocation, x as PromptResolver, y as MainOptions, z as toCamelCase } from "./types-CaP5nn8i.js";
|
|
3
|
+
import { _ as CompletionResult, g as CompletionOptions, i as GenerateBundledCompletionWorkerResult, n as withCompletionCommand, r as GenerateBundledCompletionWorkerOptions, t as WithCompletionOptions, x as InternalArgsSchema } from "./with-completion-command-BhjWVp1l.js";
|
|
4
|
+
import { Field, Schema, unflatten as unflatten$1 } from "loculus";
|
|
6
5
|
/**
|
|
7
6
|
* Detect the unknown-keys handling mode of an args schema. Works for any
|
|
8
7
|
* schema politty itself attaches to a command (including internal
|
|
@@ -16,8 +15,6 @@ export declare function getUnknownKeysMode(schema: ArgsSchema$1): UnknownKeysMod
|
|
|
16
15
|
* @returns Extracted field information
|
|
17
16
|
*/
|
|
18
17
|
export declare function extractFields(schema: ArgsSchema$1): ExtractedFields;
|
|
19
|
-
//#endregion
|
|
20
|
-
//#region ../core/src/adapter/types.d.ts
|
|
21
18
|
/**
|
|
22
19
|
* Validation error details
|
|
23
20
|
*/
|
|
@@ -43,8 +40,6 @@ type ValidationResult<T> = {
|
|
|
43
40
|
success: false;
|
|
44
41
|
errors: ValidationError[];
|
|
45
42
|
};
|
|
46
|
-
//#endregion
|
|
47
|
-
//#region ../core/src/cli-main.d.ts
|
|
48
43
|
/**
|
|
49
44
|
* Run politty's own development CLI (`generate-shim`, `generate-worker`).
|
|
50
45
|
*
|
|
@@ -57,8 +52,6 @@ type ValidationResult<T> = {
|
|
|
57
52
|
* Never returns: it exits the process, like `runMain`.
|
|
58
53
|
*/
|
|
59
54
|
export declare function runPolittyCli(ownerPackage: string): Promise<never>;
|
|
60
|
-
//#endregion
|
|
61
|
-
//#region ../core/src/compile-cache-shim.d.ts
|
|
62
55
|
/**
|
|
63
56
|
* Generator for compile-cache bin shims.
|
|
64
57
|
*
|
|
@@ -157,8 +150,6 @@ interface GenerateCompileCacheShimResult {
|
|
|
157
150
|
* clobbering the build output.
|
|
158
151
|
*/
|
|
159
152
|
export declare function createCompileCacheShimGenerator(ownerPackage: string): (options?: GenerateCompileCacheShimOptions) => GenerateCompileCacheShimResult[];
|
|
160
|
-
//#endregion
|
|
161
|
-
//#region ../core/src/core/case-types.d.ts
|
|
162
153
|
/**
|
|
163
154
|
* TypeScript utility types for case conversion between camelCase and kebab-case.
|
|
164
155
|
*
|
|
@@ -213,8 +204,6 @@ type KebabCase<S extends string> = StripLeadingHyphen<KebabCaseInner<S>>;
|
|
|
213
204
|
* Uses a distributive conditional type so it works correctly with discriminated unions.
|
|
214
205
|
*/
|
|
215
206
|
type WithCaseVariants<T> = T extends unknown ? T & { [K in keyof T as CamelCase<K & string>]: T[K]; } & { [K in keyof T as KebabCase<K & string>]: T[K]; } : never;
|
|
216
|
-
//#endregion
|
|
217
|
-
//#region ../core/src/core/case-proxy.d.ts
|
|
218
207
|
/**
|
|
219
208
|
* Wrap an args object with a Proxy that allows dual-case access.
|
|
220
209
|
*
|
|
@@ -225,8 +214,6 @@ type WithCaseVariants<T> = T extends unknown ? T & { [K in keyof T as CamelCase<
|
|
|
225
214
|
* - The `in` operator detects both case variants.
|
|
226
215
|
*/
|
|
227
216
|
export declare function createDualCaseProxy<T extends Record<string, unknown>>(obj: T): WithCaseVariants<T>;
|
|
228
|
-
//#endregion
|
|
229
|
-
//#region ../core/src/core/command.d.ts
|
|
230
217
|
/**
|
|
231
218
|
* Infer args type from schema, defaults to empty object if undefined.
|
|
232
219
|
* Wraps with WithCaseVariants so both camelCase and kebab-case access is typed.
|
|
@@ -247,8 +234,8 @@ type MergedArgs<TLocalArgs, TGlobalArgs> = IsEmpty<TGlobalArgs> extends true ? T
|
|
|
247
234
|
* Add the `$source`, `$invocation` and `$agent` run-time metadata helpers.
|
|
248
235
|
*
|
|
249
236
|
* `$source` reports whether a given field's final value came from an
|
|
250
|
-
* explicit CLI token, a `field.env` fallback,
|
|
251
|
-
*
|
|
237
|
+
* explicit CLI token, a `field.env` fallback, a `prompt` resolver answer, or
|
|
238
|
+
* none of these (e.g. a schema default). Its `name` parameter is typed as a plain `string`
|
|
252
239
|
* (not `keyof T`) since the runtime helper deliberately accepts either
|
|
253
240
|
* camelCase or kebab-case field names (matching `createDualCaseProxy`'s
|
|
254
241
|
* dual-case access) and returns `"default"` for anything it doesn't
|
|
@@ -352,8 +339,6 @@ interface NonRunnableConfig<TArgsSchema extends ArgsSchema$1 | undefined, TGloba
|
|
|
352
339
|
*/
|
|
353
340
|
defaultSubCommand?: DefaultSubCommandKey<TSubCommands> | undefined;
|
|
354
341
|
}
|
|
355
|
-
//#endregion
|
|
356
|
-
//#region ../core/src/core/runner.d.ts
|
|
357
342
|
/**
|
|
358
343
|
* Run a command with the given arguments (programmatic/test usage)
|
|
359
344
|
*
|
|
@@ -410,8 +395,6 @@ export declare function runCommand<TResult = unknown>(command: AnyCommand, argv:
|
|
|
410
395
|
* ```
|
|
411
396
|
*/
|
|
412
397
|
export declare function runMain(command: AnyCommand, options?: MainOptions): Promise<never>;
|
|
413
|
-
//#endregion
|
|
414
|
-
//#region ../core/src/output/help-generator.d.ts
|
|
415
398
|
/**
|
|
416
399
|
* Descriptions for built-in options
|
|
417
400
|
*/
|
|
@@ -661,8 +644,6 @@ interface HelpDataOptions {
|
|
|
661
644
|
* @returns Structured help data
|
|
662
645
|
*/
|
|
663
646
|
export declare function generateHelpData(command: AnyCommand, options?: HelpDataOptions): HelpData;
|
|
664
|
-
//#endregion
|
|
665
|
-
//#region ../core/src/output/logger.d.ts
|
|
666
647
|
/**
|
|
667
648
|
* Enable or disable color output programmatically
|
|
668
649
|
*/
|
|
@@ -746,8 +727,6 @@ export declare const logger: {
|
|
|
746
727
|
*/
|
|
747
728
|
debug(message: string): void;
|
|
748
729
|
};
|
|
749
|
-
//#endregion
|
|
750
|
-
//#region ../core/src/output/markdown-renderer.d.ts
|
|
751
730
|
/**
|
|
752
731
|
* Lightweight Markdown-to-terminal renderer.
|
|
753
732
|
*
|
|
@@ -775,8 +754,6 @@ export declare function renderInline(text: string): string;
|
|
|
775
754
|
* - Applies inline formatting within each block
|
|
776
755
|
*/
|
|
777
756
|
export declare function renderMarkdown(markdown: string): string;
|
|
778
|
-
//#endregion
|
|
779
|
-
//#region ../core/src/parser/argv-parser.d.ts
|
|
780
757
|
/**
|
|
781
758
|
* Parsed arguments result
|
|
782
759
|
*/
|
|
@@ -852,14 +829,10 @@ interface ParserOptions {
|
|
|
852
829
|
* @returns Parsed arguments
|
|
853
830
|
*/
|
|
854
831
|
export declare function parseArgv(argv: string[], options?: ParserOptions): ParsedArgv;
|
|
855
|
-
//#endregion
|
|
856
|
-
//#region ../core/src/validator/args-validator.d.ts
|
|
857
832
|
/**
|
|
858
833
|
* Format validation errors for display
|
|
859
834
|
*/
|
|
860
835
|
export declare function formatValidationErrors(errors: ValidationError[]): string;
|
|
861
|
-
//#endregion
|
|
862
|
-
//#region ../core/src/validator/validation-errors.d.ts
|
|
863
836
|
/**
|
|
864
837
|
* Error thrown when positional argument configuration is invalid
|
|
865
838
|
*/
|
|
@@ -914,18 +887,16 @@ export declare class DefaultSubCommandError extends Error {
|
|
|
914
887
|
constructor(message: string);
|
|
915
888
|
}
|
|
916
889
|
/**
|
|
917
|
-
* Error thrown when a global field and a
|
|
918
|
-
*
|
|
919
|
-
* field
|
|
920
|
-
* are
|
|
921
|
-
*
|
|
922
|
-
* schema silently
|
|
890
|
+
* Error thrown when a global field and a local field collide: they share a
|
|
891
|
+
* name, or nest into conflicting output positions (`db` against `db.host`).
|
|
892
|
+
* A field name can only be declared in one of the two schemas, even when the
|
|
893
|
+
* definitions are identical: with the name in both, a value (or prompt
|
|
894
|
+
* answer) for it has no single owner. Rejected at validation time rather
|
|
895
|
+
* than letting a value from one schema silently flow into the other.
|
|
923
896
|
*/
|
|
924
897
|
export declare class FieldTypeConflictError extends Error {
|
|
925
898
|
constructor(message: string);
|
|
926
899
|
}
|
|
927
|
-
//#endregion
|
|
928
|
-
//#region ../core/src/validator/command-validator.d.ts
|
|
929
900
|
/**
|
|
930
901
|
* Error detail for command validation
|
|
931
902
|
*/
|
|
@@ -1043,14 +1014,14 @@ export declare function validateCaseVariantCollisions(extracted: ExtractedFields
|
|
|
1043
1014
|
/**
|
|
1044
1015
|
* Validate that no cross-schema collisions exist between two schemas
|
|
1045
1016
|
* (e.g., global args and command args): neither a case-variant collision
|
|
1046
|
-
* (same canonical name, different spelling) nor a same-named field
|
|
1047
|
-
*
|
|
1048
|
-
*
|
|
1017
|
+
* (same canonical name, different spelling) nor a same-named field (same
|
|
1018
|
+
* spelling, even when the two definitions are identical), nor fields that nest
|
|
1019
|
+
* into conflicting output positions.
|
|
1049
1020
|
*
|
|
1050
1021
|
* @param extractedA - Extracted fields from first schema (e.g., global args)
|
|
1051
1022
|
* @param extractedB - Extracted fields from second schema (e.g., command args)
|
|
1052
1023
|
* @throws {CaseVariantCollisionError} If cross-schema case-variant collisions are found
|
|
1053
|
-
* @throws {FieldTypeConflictError} If a
|
|
1024
|
+
* @throws {FieldTypeConflictError} If a field with the same name is declared on both schemas, or fields nest into conflicting output positions
|
|
1054
1025
|
*/
|
|
1055
1026
|
export declare function validateCrossSchemaCollisions(extractedA: ExtractedFields, extractedB: ExtractedFields): void;
|
|
1056
1027
|
/**
|
|
@@ -1087,8 +1058,6 @@ export declare function validateCommand(command: AnyCommand, options?: ValidateC
|
|
|
1087
1058
|
* @returns Formatted error message
|
|
1088
1059
|
*/
|
|
1089
1060
|
export declare function formatCommandValidationErrors(errors: CommandValidationError[]): string;
|
|
1090
|
-
//#endregion
|
|
1091
|
-
//#region src/index.d.ts
|
|
1092
1061
|
export declare const generateCompileCacheShim: (options?: GenerateCompileCacheShimOptions) => GenerateCompileCacheShimResult[];
|
|
1093
1062
|
export type ArgsSchema = Schema<Record<string, unknown>, Record<string, any>>;
|
|
1094
1063
|
export declare const defineCommand: DefineCommandFn<ArgsSchema>;
|
|
@@ -1096,5 +1065,11 @@ export declare const createDefineCommand: CreateDefineCommandFn<ArgsSchema>;
|
|
|
1096
1065
|
export declare const arg: ArgFn<Field<any, any, boolean> & {
|
|
1097
1066
|
readonly shape?: never;
|
|
1098
1067
|
}>;
|
|
1099
|
-
|
|
1100
|
-
|
|
1068
|
+
/**
|
|
1069
|
+
* loculus's `unflatten`, additionally recorded so that `effect` and
|
|
1070
|
+
* `requiredPackages` find a flat field's value in the nested output. The
|
|
1071
|
+
* style and prefixes cannot be read back from the wrapped schema, which is
|
|
1072
|
+
* why an `unflatten` imported from `loculus` itself is not enough.
|
|
1073
|
+
*/
|
|
1074
|
+
export declare const unflatten: typeof unflatten$1;
|
|
1075
|
+
export { type AgentHelp, type AgentHelpContext, type AgentInfo, type AnyCommand, type ArgFn, type ArgMeta, type ArgSource, type BoundDefineCommandFn, type BuiltinOptionDescriptions, type CamelCase, type CleanupContext, type CollectedLogs, type Command, type CommandBase, type CommandContext, type CommandValidationError, type CommandValidationResult, type CompletionDirectiveMask, type CompletionMeta, type CompletionOptions, type CompletionResult, type CompletionType, type CreateDefineCommandFn, type CustomCompletion, type DefineCommandFn, type DynamicCompletionCandidate, type DynamicCompletionContext, type DynamicCompletionResolver, type DynamicCompletionResult, type EffectContext, type Example, type ExpandCandidate, type ExpandCompletion, type ExtractedFields, type GenerateBundledCompletionWorkerOptions, type GenerateBundledCompletionWorkerResult, type GenerateCompileCacheShimOptions, type GenerateCompileCacheShimResult, type GlobalArgs, type GlobalCleanupContext, type GlobalSetupContext, type HelpData, type HelpDataOptions, type HelpFieldData, type HelpOptions, type HelpSubcommandData, type HelpUsageData, type HelpVariantData, type InferSchemaOutput, type KebabCase, type KnownAgentId, type LazyCommand, type LogEntry, type LogLevel, type LogStream, type Logger, type MainOptions, type MergedArgs, type NonRunnableCommand, type PackageRequirement, type ParsedArgv, type ParserOptions, type PromptChoices, type PromptChoicesContext, type PromptChoicesResolver, type PromptMeta, type PromptResolver, type PromptResolverContext, type PromptType, type ResolvedExpandCandidate, type ResolvedFieldMeta, type RunCommandOptions, type RunInvocation, type RunResult, type RunResultFailure, type RunResultSuccess, type RunnableCommand, type SchemaLike, type SetupContext, type SubCommandValue, type SubCommandsRecord, type UnknownKeysMode, type UnknownSubcommandHandler, type ValidateArgMeta, type ValidationError, type ValidationResult, type WithCaseVariants, type WithCompletionOptions, isLazyCommand, lazy, loadPackage, toCamelCase, toKebabCase, withCompletionCommand };
|
package/dist/index.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{o as e,s as t}from"./registry-BEz5iex_.js";import{
|
|
1
|
+
import{o as e,s as t}from"./registry-BEz5iex_.js";import{d as n,i as r,m as i,n as a}from"./schema-extractor-D6Se8W6B.js";import{n as o,t as s}from"./cli-main-CYw9CO6g.js";import{n as c,t as l}from"./command-BXsTrIgI.js";import{d as u,o as d,s as f}from"./subcommand-router-40vA6Mka.js";import{C as p,D as m,E as h,O as g,S as _,T as v,_ as y,a as b,b as x,c as S,d as C,f as w,g as T,h as E,i as D,l as ee,m as O,n as k,o as A,p as j,r as M,s as N,t as P,u as F,v as I,w as L,x as R,y as z}from"./runner-B7QLJFxY.js";import{a as B,i as V,n as H,r as U,t as W}from"./logger-CoeDrmRr.js";import{a as G}from"./argv-parser-CVlS6mSo.js";import{t as K}from"./with-completion-command-DQ1vWryG.js";import{t as q}from"./register-Ceh-HlVN.js";import{unflatten as J}from"loculus";const Y=o(`@politty/loculus`),X=c,Z=l,Q=q,$=((e,t)=>(e.meta.shape&&n(Object.keys(e.meta.shape),t),i(J(e,t),t??{})));export{T as CaseVariantCollisionError,y as DefaultSubCommandError,I as DuplicateAliasError,z as DuplicateFieldError,x as DuplicateNegationError,R as FieldTypeConflictError,_ as PositionalConfigError,p as ReservedAliasError,L as ReservedFieldNameError,Q as arg,o as createCompileCacheShimGenerator,Z as createDefineCommand,M as createDualCaseProxy,X as defineCommand,a as extractFields,b as formatCommandValidationErrors,D as formatValidationErrors,Y as generateCompileCacheShim,v as generateHelp,h as generateHelpData,r as getUnknownKeysMode,W as isColorEnabled,d as isLazyCommand,f as lazy,u as loadPackage,H as logger,G as parseArgv,m as renderInline,g as renderMarkdown,P as runCommand,k as runMain,s as runPolittyCli,U as setColorEnabled,V as styles,B as symbols,e as toCamelCase,t as toKebabCase,$ as unflatten,A as validateCaseVariantCollisions,N as validateCommand,S as validateCrossSchemaCollisions,ee as validateDefaultSubCommand,F as validateDuplicateAliases,C as validateDuplicateFields,w as validateDuplicateNegations,j as validatePositionalConfig,O as validateReservedAliases,E as validateReservedFieldNames,K as withCompletionCommand};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{u as e}from"./schema-extractor-D6Se8W6B.js";function t(e){let t=e.prompt;if(!t||t.enabled===!1)return null;let n=t.message??e.description??e.name,a=r(e,t),o=i(e,t,a);return{field:e,type:a===`select`&&!o&&typeof t.choices!=`function`?`text`:a,message:n,...o&&{choices:o}}}function n(e){return e!==void 0&&e.length>0}function r(e,t){return t.type?t.type===`file`||t.type===`directory`?`text`:t.type:typeof t.choices==`function`||n(t.choices)?`select`:e.completion?.type===`file`||e.completion?.type===`directory`?`text`:n(e.enumValues)?`select`:e.type===`boolean`?`confirm`:`text`}function i(e,t,r){if(typeof t.choices!=`function`){if(n(t.choices))return t.choices.map(e=>typeof e==`string`?{label:e,value:e}:e);if(r===`select`&&n(e.enumValues))return e.enumValues.map(e=>({label:e,value:e}))}}function a(e,n){let r=[];for(let i of e){if(n[i.name]!==void 0||i.type===`array`)continue;let e=t(i);e&&r.push(e)}return r}function o(){return!(!process.stdin.isTTY||!process.stdout.isTTY||process.env.CI||process.env.POLITTY_NO_PROMPT)}async function s(e,t,n){if(!(n.interactive??o()))return e;let r=n.adapter,i={...e},a=n.globalArgs===e?i:n.globalArgs??{};return t.schemaType===`discriminatedUnion`&&t.discriminator&&t.variants?await c(r,i,t,a):t.schemaType===`union`||t.schemaType===`xor`||await u(r,i,t.fields,a),i}async function c(n,r,i,a){let{discriminator:o,variants:s}=i;if(!o||!s)return;if(r[o]===void 0){let e=l(i.fields,s,o),c=e?t(e):null;if(c){let e=s.map(e=>e.discriminatorValue).filter(Boolean);e.length>0&&(c.type=`select`,c.choices=e.map(e=>({label:e,value:e}))),await d(n,r,c,a)}}let c=e(i,()=>r);c!==i&&await u(n,r,c.fields.filter(e=>e.name!==o),a)}function l(e,t,n){let r=e.find(e=>e.name===n);if(r?.prompt)return r;for(let e of t){let t=e.fields.find(e=>e.name===n);if(t?.prompt)return t}}async function u(e,t,n,r){let i=a(n,t);for(let n of i)await d(e,t,n,r)}async function d(e,t,n,r){let i=n.field.prompt?.choices;if(n.type===`select`&&!n.choices&&typeof i==`function`){let e;try{e=await i({rawArgs:{...t},globalArgs:{...r}})}catch(e){throw Error(`Failed to resolve prompt choices for "${n.field.name}": ${e instanceof Error?e.message:String(e)}`,{cause:e})}if(!Array.isArray(e)||e.length===0)throw Error(`No prompt choices available for "${n.field.name}"`);n={...n,choices:e.map(e=>{if(typeof e==`string`)return{label:e,value:e};if(typeof e==`object`&&e&&typeof e.label==`string`&&typeof e.value==`string`)return e;throw Error(`Invalid prompt choice for "${n.field.name}"`)})}}let{message:a}=n,o;switch(n.type){case`text`:o=await e.text({message:a,placeholder:n.field.placeholder});break;case`password`:o=await e.password({message:a});break;case`confirm`:o=await e.confirm({message:a});break;case`select`:o=await e.select({message:a,options:n.choices??[]})}if(e.isCancelled(o))throw Error(`Prompt cancelled by user`);t[n.field.name]=o}export{t as i,o as n,a as r,s as t};
|
package/dist/prompt-clack.d.ts
CHANGED
|
@@ -1,5 +1,4 @@
|
|
|
1
|
-
import { x as PromptResolver } from "./types-
|
|
2
|
-
//#region ../core/src/prompt/clack/index.d.ts
|
|
1
|
+
import { x as PromptResolver } from "./types-CaP5nn8i.js";
|
|
3
2
|
/**
|
|
4
3
|
* Prompt resolver backed by @clack/prompts.
|
|
5
4
|
*
|
|
@@ -11,5 +10,4 @@ import { x as PromptResolver } from "./types-DtQ-Zt3n.js";
|
|
|
11
10
|
* runMain(cmd, { version: "1.0.0", prompt });
|
|
12
11
|
* ```
|
|
13
12
|
*/
|
|
14
|
-
export declare const prompt: PromptResolver;
|
|
15
|
-
//#endregion
|
|
13
|
+
export declare const prompt: PromptResolver;
|
package/dist/prompt-clack.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import"./register-Ceh-HlVN.js";import{t as e}from"./prompt-
|
|
1
|
+
import"./register-Ceh-HlVN.js";import{t as e}from"./prompt-Bmm7QM-I.js";import{confirm as t,isCancel as n,password as r,select as i,text as a}from"@clack/prompts";function o(){return{text:e=>a({message:e.message,...e.placeholder!==void 0&&{placeholder:e.placeholder}}),password:e=>r(e),confirm:e=>t(e),select:e=>i(e),isCancelled:n}}const s=(t,n,r)=>e(t,n,{adapter:o(),...r});export{s as prompt};
|
|
@@ -1,5 +1,4 @@
|
|
|
1
|
-
import { x as PromptResolver } from "./types-
|
|
2
|
-
//#region ../core/src/prompt/inquirer/index.d.ts
|
|
1
|
+
import { x as PromptResolver } from "./types-CaP5nn8i.js";
|
|
3
2
|
/**
|
|
4
3
|
* Prompt resolver backed by @inquirer/prompts.
|
|
5
4
|
*
|
|
@@ -11,5 +10,4 @@ import { x as PromptResolver } from "./types-DtQ-Zt3n.js";
|
|
|
11
10
|
* runMain(cmd, { version: "1.0.0", prompt });
|
|
12
11
|
* ```
|
|
13
12
|
*/
|
|
14
|
-
export declare const prompt: PromptResolver;
|
|
15
|
-
//#endregion
|
|
13
|
+
export declare const prompt: PromptResolver;
|
package/dist/prompt-inquirer.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import"./register-Ceh-HlVN.js";import{t as e}from"./prompt-
|
|
1
|
+
import"./register-Ceh-HlVN.js";import{t as e}from"./prompt-Bmm7QM-I.js";import{confirm as t,input as n,password as r,select as i}from"@inquirer/prompts";const a=Symbol(`inquirer-cancel`);async function o(e){try{return await e()}catch(e){if(e instanceof Error&&e.name===`ExitPromptError`)return a;throw e}}function s(){return{text:e=>o(()=>n({message:e.message})),password:e=>o(()=>r({message:e.message})),confirm:e=>o(()=>t({message:e.message})),select:e=>o(()=>i({message:e.message,choices:e.options.map(e=>({name:e.label,value:e.value}))})),isCancelled:e=>e===a}}const c=(t,n,r)=>e(t,n,{adapter:s(),...r});export{c as prompt};
|
package/dist/prompt.d.ts
CHANGED
|
@@ -1,5 +1,4 @@
|
|
|
1
|
-
import {
|
|
2
|
-
//#region ../core/src/prompt/types.d.ts
|
|
1
|
+
import { I as ExtractedFields, L as ResolvedFieldMeta, S as PromptResolverContext } from "./types-CaP5nn8i.js";
|
|
3
2
|
/**
|
|
4
3
|
* Resolved prompt configuration for a single field
|
|
5
4
|
*/
|
|
@@ -49,8 +48,6 @@ interface PromptAdapter {
|
|
|
49
48
|
/** Check if a prompt result indicates user cancellation */
|
|
50
49
|
isCancelled(value: unknown): boolean;
|
|
51
50
|
}
|
|
52
|
-
//#endregion
|
|
53
|
-
//#region ../core/src/prompt/prompt-resolver.d.ts
|
|
54
51
|
/**
|
|
55
52
|
* Resolve prompt configuration for a field.
|
|
56
53
|
*
|
|
@@ -80,19 +77,15 @@ export declare function resolvePromptConfig(field: ResolvedFieldMeta): ResolvedP
|
|
|
80
77
|
* default apply silently.
|
|
81
78
|
*/
|
|
82
79
|
export declare function getFieldsToPrompt(fields: ResolvedFieldMeta[], rawArgs: Record<string, unknown>): ResolvedPromptConfig[];
|
|
83
|
-
//#endregion
|
|
84
|
-
//#region ../core/src/prompt/tty-detector.d.ts
|
|
85
80
|
/**
|
|
86
81
|
* Detect whether the current environment supports interactive prompts.
|
|
87
82
|
* Returns false in CI, piped input, or non-TTY environments.
|
|
88
83
|
*/
|
|
89
84
|
export declare function isInteractive(): boolean;
|
|
90
|
-
//#endregion
|
|
91
|
-
//#region ../core/src/prompt/index.d.ts
|
|
92
85
|
/**
|
|
93
86
|
* Options for promptMissingArgs behavior
|
|
94
87
|
*/
|
|
95
|
-
export interface PromptOptions {
|
|
88
|
+
export interface PromptOptions extends Partial<PromptResolverContext> {
|
|
96
89
|
/** Prompt adapter to use for rendering prompts */
|
|
97
90
|
adapter: PromptAdapter;
|
|
98
91
|
/** Override interactive detection (force enable/disable prompts) */
|
|
@@ -106,5 +99,4 @@ export interface PromptOptions {
|
|
|
106
99
|
* Returns rawArgs unchanged in non-interactive environments.
|
|
107
100
|
*/
|
|
108
101
|
export declare function promptMissingArgs(rawArgs: Record<string, unknown>, extracted: ExtractedFields, options: PromptOptions): Promise<Record<string, unknown>>;
|
|
109
|
-
//#endregion
|
|
110
102
|
export type { PromptAdapter, ResolvedPromptConfig };
|
package/dist/prompt.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import"./register-Ceh-HlVN.js";export{r as getFieldsToPrompt,n as isInteractive,t as promptMissingArgs,i as resolvePromptConfig}from"./prompt-
|
|
1
|
+
import"./register-Ceh-HlVN.js";export{r as getFieldsToPrompt,n as isInteractive,t as promptMissingArgs,i as resolvePromptConfig}from"./prompt-Bmm7QM-I.js";
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import{i as e,o as t,r as n,s as r,t as i}from"./registry-BEz5iex_.js";import{_ as a,a as o,c as s,f as c,l,n as u,o as d,p as f,r as p,s as m,t as h,u as g,v as _}from"./schema-extractor-D6Se8W6B.js";import{t as v}from"./detect-agent-D7KSeWMh.js";import{n as y}from"./compile-cache-6u9hgeWu.js";import{a as ee,c as b,f as x,i as te,l as S,n as C,o as w,r as T,t as E,u as D}from"./subcommand-router-40vA6Mka.js";import{n as O,r as k,t as A}from"./log-collector-uhRWYT-z.js";import{a as j,i as M}from"./logger-CoeDrmRr.js";import{a as N,c as ne,d as re,i as P,l as ie,n as ae,o as F,r as I,s as L,t as R}from"./argv-parser-CVlS6mSo.js";import{isDeepStrictEqual as oe,stripVTControlCharacters as se}from"node:util";async function ce(e,t,n={}){let r,i,a=n.captureLogs??!1?A():null;a?.start();let o={args:t},s={args:t,error:r},l;n.handleSignals&&(l=async t=>{l&&(process.off(`SIGINT`,l),process.off(`SIGTERM`,l));let r=/* @__PURE__ */ Error(`Process interrupted`);if(s.error=r,e.cleanup)try{await e.cleanup(s)}catch(e){console.error(`Error during signal cleanup:`,e)}if(n.globalCleanup)try{await n.globalCleanup({error:r})}catch(e){console.error(`Error during global signal cleanup:`,e)}a?.stop(),process.stdout.writableNeedDrain&&await new Promise(e=>{let t=setTimeout(()=>{process.stdout.off(`drain`,n),e()},200),n=()=>{clearTimeout(t),e()};process.stdout.once(`drain`,n)}),process.exit(1)},process.on(`SIGINT`,l),process.on(`SIGTERM`,l));try{e.requiredPackages?.length&&await x(e.requiredPackages,t);let r=typeof t==`object`&&t?t:{};for(let e of n.packageFields??[])e.requiredPackages?.length&&(e.nested?c(r,e)!==void 0:e.name in r)&&(n.packageDiscriminators?.includes(e.name)||c(r,e)===!0)&&await x(e.requiredPackages,t);e.setup&&await e.setup(o),e.run&&(i=await e.run(t))}catch(e){r=e instanceof Error?e:Error(String(e))}finally{l&&(process.off(`SIGINT`,l),process.off(`SIGTERM`,l))}if(e.cleanup){s.error=r;try{await e.cleanup(s)}catch(e){r||=e instanceof Error?e:Error(String(e))}}a?.stop();let u=n.existingLogs??O(),d=a?.getLogs()??O(),f=k(u,d);return r?{success:!1,error:r,exitCode:1,logs:f}:{success:!0,result:i,exitCode:0,logs:f}}function le(e){return e<=31||e>=127&&e<=159||e>=768&&e<=879||e>=6832&&e<=6911||e>=7616&&e<=7679||e>=8400&&e<=8447||e>=65056&&e<=65071||e===8203||e>=8204&&e<=8207||e===65279||e>=65024&&e<=65039||e>=917760&&e<=917999}function ue(e){return e>=4352&&e<=4447||e>=11904&&e<=12350||e>=12353&&e<=13311||e>=13312&&e<=19903||e>=19968&&e<=40959||e>=40960&&e<=42191||e>=43360&&e<=43391||e>=44032&&e<=55203||e>=63744&&e<=64255||e>=65040&&e<=65049||e>=65072&&e<=65135||e>=65280&&e<=65376||e>=65504&&e<=65510||e>=110592&&e<=110959||e>=127488&&e<=127569||e>=131072&&e<=262141||e>=9728&&e<=10175||e>=126976&&e<=129791}function de(e){let t=!1,n=!1,r=!1;for(let i of e){let e=i.codePointAt(0);e===65039?r=!0:le(e)||(t=!0,ue(e)&&(n=!0))}return t?n||r?2:1:0}const fe=(()=>{try{return new Intl.Segmenter(`en`,{granularity:`grapheme`})}catch{return}})();function pe(e){if(e.length===0)return 0;let t=e.includes(`\x1B`)||e.includes(``)?se(e):e,n=0;if(fe)for(let{segment:e}of fe.segment(t))n+=de(e);else for(let e of t)n+=de(e);return n}function z(e){let t=[],n=e.replace(/`([^`]+)`/g,(e,n)=>{let r=t.length;return t.push(M.cyan(n)),`\x00CODE${r}\x00`});return n=n.replace(/\*\*(.+?)\*\*/g,(e,t)=>M.bold(t)),n=n.replace(/__(.+?)__/g,(e,t)=>M.bold(t)),n=n.replace(/\*(.+?)\*/g,(e,t)=>M.italic(t)),n=n.replace(/(?<!\w)_(.+?)_(?!\w)/g,(e,t)=>M.italic(t)),n=n.replace(/\[([^\]]+)\]\(([^)]+)\)/g,(e,t,n)=>`${M.underline(t)} ${M.dim(`(${n})`)}`),n=n.replace(/\x00CODE(\d+)\x00/g,(e,n)=>t[Number(n)]),n}function me(e){return we(e.split(`
|
|
2
|
+
`)).map(ke).join(`
|
|
3
|
+
|
|
4
|
+
`)}const he=/^(#{1,6})\s+(.+)$/,ge=/^(?:---+|\*\*\*+|___+)\s*$/,_e=/^>\s?(.*)$/,ve=/^-\s+(.+)$/,ye=/^(\d+)[.)]\s+(.+)$/,be=/^(`{3,}|~{3,})(\S*)\s*$/,xe=/^\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\]\s*$/,Se=/^\|(.+)\|$/,Ce=/^\|(\s*:?-+:?\s*\|)+$/;function we(e){let t=[],n=0;for(;n<e.length;){let r=e[n];if(r.trim()===``){n++;continue}let i=r.match(be);if(i){let r=i[1],a=i[2]??``,o=[];for(n++;n<e.length;){if(e[n].startsWith(r.charAt(0).repeat(r.length))&&e[n].trim()===r.charAt(0).repeat(Math.max(r.length,e[n].trim().length))){n++;break}o.push(e[n]),n++}t.push({type:`code`,lang:a,lines:o});continue}let a=r.match(he);if(a){t.push({type:`heading`,level:a[1].length,content:a[2]}),n++;continue}if(ge.test(r)){t.push({type:`hr`}),n++;continue}if(_e.test(r)){let r=[];for(;n<e.length;){let t=e[n].match(_e);if(t)r.push(t[1]),n++;else break}if(r.length>0){let e=r[0].match(xe);if(e){let n=r.slice(1).filter(e=>e!==``);t.push({type:`alert`,alertType:e[1],lines:n});continue}}t.push({type:`blockquote`,lines:r});continue}if(ve.test(r)){let r=[];for(;n<e.length;){let t=e[n].match(ve);if(t)r.push(t[1]),n++;else break}t.push({type:`ul`,items:r});continue}let o=r.match(ye);if(o){let r=Number(o[1]),i=[];for(;n<e.length;){let t=e[n].match(ye);if(t)i.push(t[2]),n++;else break}t.push({type:`ol`,items:i,start:r});continue}if(Se.test(r)&&n+1<e.length&&Ce.test(e[n+1])){let i=Te(r),a=Ee(e[n+1]);n+=2;let o=[];for(;n<e.length&&Se.test(e[n]);)o.push(Te(e[n])),n++;t.push({type:`table`,headers:i,alignments:a,rows:o});continue}let s=[];for(;n<e.length;){let t=e[n];if(t.trim()===``||he.test(t)||ge.test(t)||_e.test(t)||ve.test(t)||ye.test(t)||be.test(t)||Se.test(t)&&n+1<e.length&&Ce.test(e[n+1]))break;s.push(t),n++}s.length>0&&t.push({type:`paragraph`,lines:s})}return t}function Te(e){return e.slice(1,-1).split(`|`).map(e=>e.trim())}function Ee(e){return e.slice(1,-1).split(`|`).map(e=>{let t=e.trim();return t.startsWith(`:`)&&t.endsWith(`:`)?`center`:t.endsWith(`:`)?`right`:`left`})}function De(e,t,n){let r=pe(e),i=Math.max(0,t-r);if(n===`right`)return` `.repeat(i)+e;if(n===`center`){let t=Math.floor(i/2);return` `.repeat(t)+e+` `.repeat(i-t)}return e+` `.repeat(i)}const Oe={NOTE:{icon:`ℹ`,label:`Note`,styleFn:M.cyan},TIP:{icon:`💡`,label:`Tip`,styleFn:M.green},IMPORTANT:{icon:`❗`,label:`Important`,styleFn:M.magenta},WARNING:{icon:`⚠`,label:`Warning`,styleFn:M.yellow},CAUTION:{icon:`🔴`,label:`Caution`,styleFn:M.red}};function ke(e){switch(e.type){case`heading`:return M.green(M.bold(z(e.content)));case`hr`:return M.dim(`─`.repeat(40));case`blockquote`:{let t=M.dim(`│ `);return e.lines.map(e=>`${t}${z(e)}`).join(`
|
|
5
|
+
`)}case`alert`:{let{icon:t,label:n,styleFn:r}=Oe[e.alertType],i=r(M.bold(`│`))+` `,a=`${i}${r(t)} ${r(n)}`;return e.lines.length===0?a:`${a}\n${e.lines.map(e=>`${i}${z(e)}`).join(`
|
|
6
|
+
`)}`}case`ul`:return e.items.map(e=>`${M.dim(`•`)} ${z(e)}`).join(`
|
|
7
|
+
`);case`ol`:{let t=e.start+e.items.length-1,n=String(t).length;return e.items.map((t,r)=>{let i=String(e.start+r).padStart(n,` `);return`${M.dim(`${i}.`)} ${z(t)}`}).join(`
|
|
8
|
+
`)}case`table`:{let t=e.headers.length,n=e.headers.map(e=>z(e)),r=e.rows.map(e=>Array.from({length:t},(t,n)=>z(e[n]??``))),i=n.map((e,t)=>{let n=pe(e),i=r.map(e=>pe(e[t]));return Math.max(n,...i)}),a=M.dim(`│`),o=M.dim(`┌─${i.map(e=>`─`.repeat(e)).join(`─┬─`)}─┐`),s=M.dim(`├─${i.map(e=>`─`.repeat(e)).join(`─┼─`)}─┤`),c=M.dim(`└─${i.map(e=>`─`.repeat(e)).join(`─┴─`)}─┘`);return[o,`${a} ${n.map((t,n)=>M.bold(De(t,i[n],e.alignments[n]??`left`))).join(` ${a} `)} ${a}`,s,...r.map(t=>{let n=t.map((t,n)=>De(t,i[n],e.alignments[n]??`left`));return`${a} ${n.join(` ${a} `)} ${a}`}),c].join(`
|
|
9
|
+
`)}case`code`:return e.lines.map(e=>` ${M.yellow(e)}`).join(`
|
|
10
|
+
`);case`paragraph`:return z(e.lines.join(` `))}}const B={help:`Show help`,helpAll:`Show help with all subcommand options`,helpJson:`Show help as JSON`,version:`Show version`};function Ae(e){return!e.startsWith(`__`)}function V(e){return Object.entries(e).filter(([e])=>Ae(e))}function je(e,t){return t?.rootName&&t.commandPath&&t.commandPath.length>0?t.commandPath.join(` `):e.name??`command`}function Me(e,t){return t?.rootName&&t.commandPath&&t.commandPath.length>0?`${t.rootName} ${t.commandPath.join(` `)}`:e.name??`command`}function Ne(e,t){let n=[],r=Me(e,t);n.push(M.commandName(r)),t?.globalExtracted?.fields.length&&n.push(M.placeholder(`[global options]`));let i=p(e);if(i){let t=s(i);m(i).length>0&&n.push(M.placeholder(`[options]`)),e.subCommands&&V(e.subCommands).length>0&&(e.run||e.defaultSubCommand?n.push(M.placeholder(`[command]`)):n.push(M.option(`<command>`)));for(let e of t)e.required?n.push(M.option(`<${e.name}>`)):n.push(M.placeholder(`[${e.name}]`))}else e.subCommands&&V(e.subCommands).length>0&&(e.run||e.defaultSubCommand?n.push(M.placeholder(`[command]`)):n.push(M.option(`<command>`)));return n.join(` `)}function Pe(e,t){let n=`${M.dim(`When`)} ${M.option(e)}=${M.bold(t.discriminatorValue)}:`;return t.description?`${n} ${t.description}`:n}function Fe(e,t){return` ${M.bold(`${e.description??`Variant ${t+1}`}:`)}`}function Ie(e,t=0){let n=e.required?M.option(`<${e.name}>`):M.placeholder(`[${e.name}]`),r=e.named?`${n}, ${U(e)}`:n,i=[K(e),e.defaultValue===void 0?void 0:M.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)].filter(Boolean).join(` `);return i?G(r,i,t):`${` `.repeat(t)} ${r}`}function Le(e){let t=p(e);if(!t)return``;let n=[];if(t.schemaType===`discriminatedUnion`&&t.discriminator){let e=t.discriminator;n=(t.variants??[]).map(t=>({label:Pe(e,t),fields:t.fields}))}else(t.schemaType===`union`||t.schemaType===`xor`)&&t.unionOptions&&(n=t.unionOptions.map((e,t)=>({label:Fe(e,t),fields:e.fields})));let r=n.length>0?h(n):void 0,i=t.fields.filter(e=>e.positional&&(r===void 0||r.has(e.name))).map(e=>Ie(e));for(let e of n){let t=e.fields.filter(e=>e.positional&&!r?.has(e.name));t.length!==0&&i.push(``,e.label,...t.map(e=>Ie(e,1)))}return i.join(`
|
|
11
|
+
`)}function Re(t,n={},r){let i=[],a={help:n.help??B.help,helpAll:n.helpAll??B.helpAll,helpJson:n.helpJson??B.helpJson,version:n.version??B.version},o=p(t),s=o?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`h`))??!1,c=o?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`H`))??!1;if(s?i.push(G(M.option(`--help`),a.help)):i.push(G(`${M.option(`-h`)}, ${M.option(`--help`)}`,a.help)),c?i.push(G(M.option(`--help-all`),a.helpAll)):i.push(G(`${M.option(`-H`)}, ${M.option(`--help-all`)}`,a.helpAll)),i.push(G(M.option(`--help-json`),a.helpJson)),r?.rootVersion&&i.push(G(M.option(`--version`),a.version)),!o)return i.join(`
|
|
12
|
+
`);if(o.schemaType===`discriminatedUnion`&&o.discriminator)return ze(o,t,i);if(o.schemaType===`union`&&o.unionOptions||o.schemaType===`xor`&&o.unionOptions)return Be(o,t,i);let l=[],u=o.fields.filter(e=>!e.positional);for(let e of u){let t=U(e),n=K(e);e.defaultValue!==void 0&&(n+=` ${M.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${M.required(`(required)`)}`);let r=W(e.env);r&&(n+=` ${r}`),l.push(G(t,n));let i=H(e);i&&l.push(i)}return l.push(...i),l.join(`
|
|
13
|
+
`)}function H(e,t=0,n=0){return!e.negationDisplay||!e.negationDescription?null:G(M.option(`--${e.negationDisplay}`),`${e.negationDescription} ${M.dim(`(↔ --${e.cliName})`)}`,t,n)}function ze(e,t,n){let r=[],i=e.discriminator,a=e.variants??[],o=d(e,i);if(o){let t=a.map(e=>e.discriminatorValue).join(`|`),n=`${M.option(`--${i}`)} ${M.placeholder(`<${t}>`)}`,s=e.description??o.description??`Action to perform`;r.push(G(n,s))}let s=h(a,i);for(let t of s){let n=e.fields.find(e=>e.name===t);if(n&&!n.positional){let e=U(n),t=K(n);n.defaultValue!==void 0&&(t+=` ${M.defaultValue(`(default: ${JSON.stringify(n.defaultValue)})`)}`);let i=W(n.env);i&&(t+=` ${i}`),r.push(G(e,t));let a=H(n);a&&r.push(a)}}r.push(...n);for(let e of a){let t=e.fields.filter(e=>e.name!==i&&!s.has(e.name)&&!e.positional),n=S(e.fields.find(e=>e.name===i)?.requiredPackages);if(t.length>0||n){r.push(``),r.push(Pe(i,e)),n&&r.push(Ue(n,2));for(let e of t){let t=U(e),n=K(e);e.defaultValue!==void 0&&(n+=` ${M.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${M.required(`(required)`)}`);let i=W(e.env);i&&(n+=` ${i}`),r.push(G(t,n,1));let a=H(e,1);a&&r.push(a)}}}return r.join(`
|
|
14
|
+
`)}function Be(e,t,n){let r=[],i=e.unionOptions??[],a=h(i);for(let t of a){let n=e.fields.find(e=>e.name===t);if(n&&!n.positional){let e=U(n),t=K(n);n.defaultValue!==void 0&&(t+=` ${M.defaultValue(`(default: ${JSON.stringify(n.defaultValue)})`)}`);let i=W(n.env);i&&(t+=` ${i}`),r.push(G(e,t));let a=H(n);a&&r.push(a)}}r.push(...n);for(let e=0;e<i.length;e++){let t=i[e];if(!t)continue;let n=t.fields.filter(e=>!a.has(e.name)&&!e.positional),o=Fe(t,e);if(n.length>0){r.push(``),r.push(o);for(let e of n){let t=U(e),n=K(e);e.defaultValue!==void 0&&(n+=` ${M.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${M.required(`(required)`)}`);let i=W(e.env);i&&(n+=` ${i}`),r.push(G(t,n,1));let a=H(e,1);a&&r.push(a)}}else r.push(``),r.push(o),r.push(` ${M.dim(M.italic(`no options`))}`)}return r.join(`
|
|
15
|
+
`)}function U(e){let t=[];if(e.alias)for(let n of e.alias)n.length===1&&t.push(M.option(`-${n}`));let n=M.option(`--${e.cliName}`);if(e.type!==`boolean`){let t=e.placeholder??e.cliName.toUpperCase();n+=` ${M.placeholder(`<${t}>`)}`}if(t.push(n),e.alias){for(let n of e.alias)if(n.length>1){let r=M.option(`--${n}`);if(e.type!==`boolean`){let t=e.placeholder??e.cliName.toUpperCase();r+=` ${M.placeholder(`<${t}>`)}`}t.push(r)}}let r=t.join(`, `);return e.type===`boolean`&&e.negationDisplay&&!e.negationDescription?`${r} / ${M.option(`--${e.negationDisplay}`)}`:r}function W(e){if(!e)return``;let t=Array.isArray(e)?e:[e];return M.dim(`[env: ${t.join(`, `)}]`)}function Ve(e){return e.replace(/\x1B\[[0-9;]*m/g,``)}function He(e,t){let n=Ve(e).length,r=Math.max(0,t-n);return e+` `.repeat(r)}function Ue(e,t){if(!e.includes(`
|
|
16
|
+
`))return e;let n=` `.repeat(t);return e.split(`
|
|
17
|
+
`).join(`\n${n}`)}function G(e,t,n=0,r=0){let i=` `.repeat(n),a=Ve(e).length,o=32-n*2+r,s=o+2+n*2,c=Ue(t,s);return a>=o?`${i} ${e}\n${` `.repeat(s)}${c}`:`${i} ${He(e,o)}${c}`}function We(e,t=0,n=0){let r=U(e),i=K(e);e.defaultValue!==void 0&&(i+=` ${M.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(i+=` ${M.required(`(required)`)}`);let a=W(e.env);return a&&(i+=` ${a}`),G(r,i,t,n)}function Ge(e){let t=[];for(let n of e.fields){if(n.positional)continue;t.push(We(n));let e=H(n);e&&t.push(e)}return t.join(`
|
|
18
|
+
`)}function Ke(e,t){let n=[],r=p(e);if(r){let e=r.fields.filter(e=>!e.positional);for(let r of e){let e=U(r),i=K(r);r.defaultValue!==void 0&&(i+=` ${M.defaultValue(`(default: ${JSON.stringify(r.defaultValue)})`)}`);let a=W(r.env);a&&(i+=` ${a}`),n.push(G(e,i,t,2));let o=H(r,t,2);o&&n.push(o)}}return n}function qe(e,t,n){let r=[];for(let[i,a]of V(e)){let e=b(a),o=t?`${t} ${i}`:i,s=[e?.description,S(e?.requiredPackages)].filter(Boolean).join(`
|
|
19
|
+
`),c=e?.aliases,l=c&&c.length>0?`${o}, ${c.join(`, `)}`:o;if(r.push(G(M.command(l),s,n)),e){let t=Ke(e,n+1);r.push(...t);let i=e.subCommands?Object.fromEntries(V(e.subCommands)):void 0;if(i&&Object.keys(i).length>0){let e=qe(i,o,n);r.push(...e)}}}return r}function Je(e,t){let n=[],r=t.context;t.agentHelp&&n.push(me(t.agentHelp));let i=je(e,r);if(i){let e=M.commandName(i);r?.rootName&&r.commandPath&&r.commandPath.length>0?r.rootVersion?e+=` ${M.version(`(${r.rootName} v${r.rootVersion})`)}`:e+=` ${M.version(`(${r.rootName})`)}`:r?.rootVersion&&(e+=` ${M.version(`v${r.rootVersion}`)}`),n.push(e)}r?.aliasFor&&n.push(M.dim(`Alias for ${M.commandName(r.aliasFor)}`)),e.description&&n.push(e.description),!r?.aliasFor&&e.aliases&&e.aliases.length>0&&n.push(`${M.sectionHeader(`Aliases:`)} ${e.aliases.map(e=>M.command(e)).join(`, `)}`),n.push(`${M.sectionHeader(`Usage:`)} ${Ne(e,r)}`);let a=Le(e);a&&n.push(`${M.sectionHeader(`Arguments:`)}\n${a}`);let o=Re(e,t.descriptions,r);if(o&&n.push(`${M.sectionHeader(`Options:`)}\n${o}`),r?.globalExtracted?.fields.length&&n.push(`${M.sectionHeader(`Global Options:`)}\n${Ge(r.globalExtracted)}`),t.showSubcommands!==!1&&e.subCommands&&V(e.subCommands).length>0){let i=r?.commandPath?.join(` `)??``,a=Object.fromEntries(V(e.subCommands));if(t.showSubcommandOptions){let e=qe(a,i,0);n.push(`${M.sectionHeader(`Commands:`)}\n${e.join(`
|
|
20
|
+
`)}`)}else{let e=[];for(let[t,n]of Object.entries(a)){let r=b(n),a=[r?.description,S(r?.requiredPackages)].filter(Boolean).join(`
|
|
21
|
+
`),o=i?`${i} ${t}`:t,s=r?.aliases,c=s&&s.length>0?`${o}, ${s.join(`, `)}`:o;e.push(G(M.command(c),a))}n.push(`${M.sectionHeader(`Commands:`)}\n${e.join(`
|
|
22
|
+
`)}`)}}if(e.examples&&e.examples.length>0){let t=Ze(e.examples,r);n.push(`${M.sectionHeader(`Examples:`)}\n${t}`)}let s=S(e.requiredPackages);if(s&&n.push(`${M.sectionHeader(`Required packages:`)}\n${s}`),e.notes){let t=me(e.notes).split(`
|
|
23
|
+
`).map(e=>e===``?``:` ${e}`).join(`
|
|
24
|
+
`);n.push(`${M.sectionHeader(`Notes:`)}\n${t}`)}return`\n${n.join(`
|
|
25
|
+
|
|
26
|
+
`)}\n`}function K(e){return[e.description,S(e.requiredPackages)].filter(Boolean).join(`
|
|
27
|
+
`)}function q(e){let t={name:e.name,cliName:e.cliName,positional:e.positional,named:e.named,required:e.required,type:e.type};return e.requiredPackages?.length&&(t.requiredPackages=e.requiredPackages.map(e=>({name:e.name,install:D(e)}))),e.alias&&(t.alias=e.alias),e.description!==void 0&&(t.description=e.description),e.placeholder!==void 0&&(t.placeholder=e.placeholder),e.env!==void 0&&(t.env=e.env),e.defaultValue!==void 0&&(t.defaultValue=e.defaultValue),e.enumValues!==void 0&&(t.enumValues=e.enumValues),e.negation!==void 0&&(t.negation=e.negation),e.negationDisplay!==void 0&&(t.negationDisplay=e.negationDisplay),e.negationDescription!==void 0&&(t.negationDescription=e.negationDescription),t}function Ye(e,t){let n=Me(e,t),r=!!t?.globalExtracted?.fields.length,i=e.subCommands&&V(e.subCommands).length>0?e.run?`optional`:`required`:void 0,a=p(e);return{commandName:n,hasGlobalOptions:r,hasOptions:a?m(a).length>0:!1,subcommand:i,positionals:a?s(a).map(e=>({name:e.name,required:e.required})):[]}}function Xe(e,t={}){let n=t.context,r=n?.commandPath??[],i={help:t.descriptions?.help??B.help,helpAll:t.descriptions?.helpAll??B.helpAll,helpJson:t.descriptions?.helpJson??B.helpJson,...n?.rootVersion?{version:t.descriptions?.version??B.version}:{}},a=p(e),o,c=[],l=[],u,f,m;if(a){if(o=a.schemaType,c=s(a).map(q),a.schemaType===`discriminatedUnion`&&a.discriminator&&a.variants){let e=a.discriminator;u=e;let t=a.variants,n=h(t,e),r=d(a,e),i=a.fields.filter(e=>!e.positional&&n.has(e.name));l=[...r?[{...q({...r,requiredPackages:void 0}),description:a.description??r.description??`Action to perform`}]:[],...i.map(q)],f=t.map(t=>{let r=t.fields.find(t=>t.name===e);return{discriminatorValue:t.discriminatorValue,...r?.requiredPackages?.length?{requiredPackages:q(r).requiredPackages}:{},description:t.description,fields:t.fields.filter(t=>t.name!==e&&!n.has(t.name)).map(q)}})}else if((a.schemaType===`union`||a.schemaType===`xor`)&&a.unionOptions){let e=a.unionOptions,t=h(e);l=a.fields.filter(e=>!e.positional&&t.has(e.name)).map(q),m=e.map(e=>({description:e.description,fields:e.fields.filter(e=>!t.has(e.name)).map(q)}))}else l=a.fields.filter(e=>!e.positional).map(q)}let g=n?.globalExtracted?.fields.length?n.globalExtracted.fields.filter(e=>!e.positional).map(q):void 0,_;if(e.subCommands){let i=V(e.subCommands);i.length>0&&(_=i.map(([i,a])=>{let o=b(a);if(!o)return{name:i,unresolved:!0};let s={commandPath:[...r,i],rootName:n?.rootName??e.name,rootVersion:n?.rootVersion,globalExtracted:n?.globalExtracted};return{name:i,aliases:o.aliases,data:Xe(o,{descriptions:t.descriptions,context:s})}}))}return{name:e.name??`command`,commandPath:r,rootName:n?.rootName,version:n?.rootVersion,aliasFor:n?.aliasFor,description:e.description,aliases:e.aliases,usage:Ye(e,n),builtinOptions:i,schemaType:o,positionals:c,options:l,discriminator:u,variants:f,unionOptions:m,globalOptions:g,subcommands:_,examples:e.examples,notes:e.notes,...e.requiredPackages?.length?{requiredPackages:e.requiredPackages.map(e=>({name:e.name,install:D(e),description:e.description}))}:{},agentHelp:t.agentHelp}}function Ze(e,t){let n=[],r=t?.rootName?`${t.rootName} `:``,i=t?.commandPath?.join(` `)??``,a=i?`${r}${i} `:r;for(let t of e){if(n.push(` ${M.dim(t.desc).split(`
|
|
28
|
+
`).join(`
|
|
29
|
+
`)}`),n.push(` ${M.dim(`$`)} ${a}${t.cmd}`),t.output)for(let e of t.output.split(`
|
|
30
|
+
`))n.push(` ${e}`);n.push(``)}return n.length>0&&n[n.length-1]===``&&n.pop(),n.join(`
|
|
31
|
+
`)}var Qe=class extends Error{constructor(e){super(e),this.name=`PositionalConfigError`}},$e=class extends Error{constructor(e){super(e),this.name=`ReservedAliasError`}},et=class extends Error{constructor(e){super(e),this.name=`DuplicateFieldError`}},tt=class extends Error{constructor(e){super(e),this.name=`DuplicateAliasError`}},nt=class extends Error{constructor(e){super(e),this.name=`CaseVariantCollisionError`}},rt=class extends Error{constructor(e){super(e),this.name=`DuplicateNegationError`}},it=class extends Error{constructor(e){super(e),this.name=`ReservedFieldNameError`}},at=class extends Error{constructor(e){super(e),this.name=`DefaultSubCommandError`}},ot=class extends Error{constructor(e){super(e),this.name=`FieldTypeConflictError`}};function st(e,t){let n=[],r=/* @__PURE__ */ new Map;for(let i of e.fields)r.has(i.name)&&n.push({commandPath:t,type:`duplicate_field`,message:`Duplicate field name "${i.name}" detected.`,field:i.name}),r.set(i.name,i.name);return n}function ct(e,n){let r=[],i=/* @__PURE__ */ new Map;for(let a of e.fields){let e=t(a.name),o=i.get(e);o&&o!==a.name&&r.push({commandPath:n,type:`case_variant_collision`,message:`Fields "${o}" and "${a.name}" are case variants of each other and would collide.`,field:a.name}),i.set(e,a.name)}return r}function lt(n,r){let i=[],a=/* @__PURE__ */ new Map,o=new Set(n.fields.map(e=>e.name)),s=new Set(n.fields.map(e=>e.cliName)),c=(e,t,n)=>{(o.has(e)||s.has(e))&&i.push({commandPath:r,type:`duplicate_alias`,message:`Alias "${e}" for field "${t}" conflicts with existing field name or CLI name "${e}".`,field:t});let c=a.get(e);if(c&&c!==t){let a=n?` (derived camelCase variant)`:``;i.push({commandPath:r,type:`duplicate_alias`,message:`Duplicate alias "${e}"${a} detected. Both "${c}" and "${t}" use the same alias.`,field:t})}a.set(e,t)};for(let r of n.fields){let n=e(r);if(n.length!==0){for(let e of n)if(c(e,r.name,!1),e.length>1&&e.includes(`-`)){let n=t(e);n!==e&&!o.has(n)&&c(n,r.name,!0)}}}return i}function ut(n,r){let i=[],a=/* @__PURE__ */ new Map,o=(e,t,n)=>{a.has(e)||a.set(e,{field:t,kind:n})};for(let r of n.fields){if(o(r.name,r.name,`field name`),r.name.includes(`-`)){let e=t(r.name);e!==r.name&&o(e,r.name,`field name`)}if(r.cliName!==r.name&&o(r.cliName,r.name,`CLI name`),r.cliName.includes(`-`)){let e=t(r.cliName);e!==r.cliName&&o(e,r.name,`CLI name`)}for(let n of e(r))if(o(n,r.name,`alias`),n.length>1&&n.includes(`-`)){let e=t(n);e!==n&&o(e,r.name,`alias`)}if(r.type===`boolean`&&r.negation===!0){let e=`no-${r.cliName}`;o(e,r.name,`default negation`);let n=t(r.cliName),i=`no${n[0]?.toUpperCase()??``}${n.slice(1)}`;i!==e&&o(i,r.name,`default negation`)}}let s=/* @__PURE__ */ new Map,c=(e,t,n)=>{let o=a.get(e);if(o){let a=n?` (derived camelCase variant)`:``,s=o.field===t?`the same field's own ${o.kind} "${e}"`:`${o.kind} "${e}" of field "${o.field}"`;i.push({commandPath:r,type:`duplicate_negation`,message:`Negation "${e}"${a} for field "${t}" conflicts with ${s}.`,field:t})}let c=s.get(e);if(c&&c!==t){let a=n?` (derived camelCase variant)`:``;i.push({commandPath:r,type:`duplicate_negation`,message:`Duplicate negation "${e}"${a} detected. Both "${c}" and "${t}" use the same negation name.`,field:t})}s.set(e,t)};for(let e of n.fields)if(typeof e.negation==`string`&&(c(e.negation,e.name,!1),e.negation.includes(`-`))){let n=t(e.negation);n!==e.negation&&c(n,e.name,!0)}return i}function dt(e,t){let n=[e,...e.variants??[],...e.unionOptions??[]],r=/* @__PURE__ */ new Set;return n.flatMap(e=>ft(e.fields,t)).filter(e=>!r.has(e.message)&&r.add(e.message))}function ft(e,t){let n=[],r=e.filter(e=>e.positional),i=null,a=null;for(let e of r)i!==null&&n.push({commandPath:t,type:`positional_config`,message:`Positional argument "${e.name}" cannot follow array positional argument "${i}".`,field:e.name}),e.type===`array`&&a!==null&&n.push({commandPath:t,type:`positional_config`,message:`Array positional "${e.name}" cannot be used with optional positional "${a}" (ambiguous parsing).`,field:e.name}),a!==null&&e.required&&n.push({commandPath:t,type:`positional_config`,message:`Required positional "${e.name}" cannot follow optional positional "${a}".`,field:e.name}),e.type===`array`&&(i=e.name),e.required||(a=e.name);return n}function pt(t,r){let i=[];for(let a of t.fields){if(a.overrideBuiltinAlias!==!0)for(let t of e(a))(t===`h`||t===`H`)&&i.push({commandPath:r,type:`reserved_alias`,message:`Alias "${t}" is reserved for --${t===`h`?`help`:`help-all`}. To override this, set { overrideBuiltinAlias: true } for "${a.name}" and keep the alias where it is currently defined (in alias or hiddenAlias).`,field:a.name});let t=/* @__PURE__ */ new Set([a.cliName,...e(a)]);for(let e of t){if(!n.has(e))continue;let t=e===a.cliName;i.push({commandPath:r,type:`reserved_alias`,message:`${t?`Field "${a.name}"`:`Alias "${e}" for field "${a.name}"`} collides with the built-in --${e} option, which always takes precedence. Rename the field or its alias; this collision cannot be overridden.`,field:a.name})}}return i}function mt(e,t){let n=[];for(let r of e.fields)r.name.startsWith(`$`)&&n.push({commandPath:t,type:`reserved_field_name`,message:`Field "${r.name}" starts with "$", which is reserved for framework-injected helpers (e.g. $source).`,field:r.name});return n}function ht(e){let t=st(e,[]);if(t.length>0)throw new et(`Duplicate field name "${t[0]?.field??`unknown`}" detected. Each field must have a unique name.`)}function gt(e){let t=lt(e,[]);if(t.length>0){let e=t[0];throw new tt(e.message)}}function _t(e){let t=dt(e,[]);if(t.length>0){let e=t[0];throw new Qe(e.message)}}function vt(e,t){let n=pt(e,[]);if(n.length>0)throw new $e(n[0].message)}function yt(e){let t=mt(e,[]);if(t.length>0){let e=t[0];throw new it(e.message)}}function bt(e){let t=ut(e,[]);if(t.length>0){let e=t[0];throw new rt(e.message)}}function xt(e){let t=ct(e,[]);if(t.length>0){let e=t[0];throw new nt(e.message)}}function St(e,n,r){let i=[],a=/* @__PURE__ */ new Map;for(let n of e.fields)a.set(t(n.name),n);for(let e of n.fields){let n=t(e.name),o=a.get(n);o&&(o.name===e.name?i.push({commandPath:r,type:`field_type_conflict`,message:`Global field "${o.name}" and command field "${e.name}" share the same name. A field name can only be declared in one schema, even when the definitions are identical.`,field:e.name}):i.push({commandPath:r,type:`case_variant_collision`,message:`Global field "${o.name}" and command field "${e.name}" are case variants of each other and would collide.`,field:e.name}))}return i.push(...Ct(e,n,r)),i}function Ct(e,t,n){let i=e=>e.fields.map(e=>({field:e,path:e.nested?.path??[e.name]})),a=i(e),o=i(t);if(![...a,...o].some(({field:e})=>e.nested))return[];let s=[];for(let e of a)for(let t of o){if(!e.field.nested&&!t.field.nested)continue;let i=Math.min(e.path.length,t.path.length),a=e.path.length!==t.path.length&&e.path.slice(0,i).every((e,n)=>e===t.path[n])?`one is a value where the other nests a group`:e.path[0]!==t.path[0]&&r(e.path[0])===r(t.path[0])?`their group names are spellings of the same name`:void 0;a&&s.push({commandPath:n,type:`field_type_conflict`,message:`Global field "${e.field.name}" and command field "${t.field.name}" nest into conflicting output positions: ${a}.`,field:t.field.name})}return s}function wt(e,t){let n=St(e,t,[])[0];if(n)throw n.type===`case_variant_collision`?new nt(n.message):new ot(n.message)}function Tt(e,t,n){return[...st(e,n),...ct(e,n),...lt(e,n),...ut(e,n),...dt(e,n),...pt(e,n),...mt(e,n)]}function Et(e,t){let n=e,r=[];if(n.defaultSubCommand===void 0)return r;n.run&&r.push({commandPath:t,type:`default_subcommand_conflict`,message:`Command "${n.name}" defines both "run" and "defaultSubCommand". Define only one.`});let i=e.subCommands?Object.keys(e.subCommands):[];return i.includes(n.defaultSubCommand)||r.push({commandPath:t,type:`default_subcommand_not_found`,message:`defaultSubCommand "${n.defaultSubCommand}" does not match any subCommands key of "${n.name}". Registered: ${i.length>0?i.join(`, `):`(none)`}.`,field:n.defaultSubCommand}),r}function Dt(e){let t=Et(e,[]);if(t.length>0)throw new at(t[0].message)}function Ot(e,t){let n=[];if(!e.subCommands)return n;let r=/* @__PURE__ */ new Map;for(let[t]of Object.entries(e.subCommands))r.set(t,t);for(let[i,a]of Object.entries(e.subCommands)){let e=w(a)?a.meta:typeof a==`function`?null:a;if(!e?.aliases)continue;let o=[...t,i];for(let t of e.aliases){if(!/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/.test(t)){n.push({commandPath:o,type:`invalid_alias`,message:`Alias "${t}" is invalid. Aliases must start with an alphanumeric character and contain only alphanumeric characters, hyphens, or underscores.`,field:i});continue}if(t===i){n.push({commandPath:o,type:`duplicate_alias`,message:`Alias "${t}" conflicts with its own name.`,field:i});continue}let e=r.get(t);e?e===i?n.push({commandPath:o,type:`duplicate_alias`,message:`Alias "${t}" is duplicated within the alias list.`,field:i}):n.push({commandPath:o,type:`duplicate_alias`,message:`Alias "${t}" conflicts with existing subcommand or alias "${e}".`,field:i}):r.set(t,i)}}return n}function kt(e,t,n){return e===t?[]:[{commandPath:[...n,e],type:`subcommand_key_name_mismatch`,message:`Subcommand registered as "${e}" but its own name is "${t}".`,field:e}]}async function At(e,t={}){return jt(e,t,!1)}async function jt(e,t,n){n||=!!e.requiredPackages?.length;let r=t.commandPath??[e.name],i=[],a=e.subCommands?Object.keys(e.subCommands).length>0:!1,o=t.globalArgs?u(t.globalArgs):void 0;if(e.args){let t=u(e.args);i.push(...Tt(t,a,r)),o&&i.push(...St(o,t,r))}if(i.push(...Ot(e,r)),i.push(...Et(e,r)),e.subCommands)for(let[a,o]of Object.entries(e.subCommands)){let e=await T(o,e=>n||!!e.requiredPackages?.length);i.push(...kt(a,e.name,r));let s=await jt(e,{commandPath:[...r,a],...t.globalArgs?{globalArgs:t.globalArgs}:{}},n);s.valid||i.push(...s.errors)}return i.length===0?{valid:!0}:{valid:!1,errors:i}}function Mt(e){if(e.length===0)return``;let t=[`Command definition errors:`];for(let n of e){let e=n.commandPath.join(` > `);t.push(` - [${e}] ${n.message}`)}return t.join(`
|
|
32
|
+
`)}function Nt(t){let{aliasMap:n=/* @__PURE__ */ new Map,booleanFlags:r=/* @__PURE__ */ new Set,definedNames:i=/* @__PURE__ */ new Set,negationMap:a=/* @__PURE__ */ new Map,defaultNegationDisabledFields:o=/* @__PURE__ */ new Set}=R(t),s=/* @__PURE__ */ new Set;for(let n of t.fields)for(let t of e(n))t.length===1&&s.add(t);return{aliasMap:n,booleanFlags:r,definedNames:i,flagNames:new Set(t.fields.map(e=>e.name)),cliNames:new Set(t.fields.map(e=>e.cliName)),aliases:s,negationMap:a,defaultNegationDisabledFields:o}}function Pt(e,t){let{resolvedName:n,withoutDashes:r,isNegated:i,isCustomNegation:a,isSuppressedNegation:o}=ie(e,t);if(o)return{resolvedName:n,withoutDashes:r,isNegated:!1,isGlobal:!1,isSuppressedNegation:o};let s=i&&!a?r.startsWith(`no-`)?r.slice(3):r[2].toLowerCase()+r.slice(3):r;return{resolvedName:n,withoutDashes:r,isNegated:i,isGlobal:t.flagNames.has(n)||t.cliNames.has(r)||t.cliNames.has(s),isSuppressedNegation:!1}}function J(e,t,n,r,i){return!e.includes(`=`)&&!i.has(t)&&!n&&r!==void 0&&ae(r)}function Y(e,t,n,r,i,a){let o=e[t];return a.push(o),J(o,n,r,e[t+1],i)?(a.push(e[t+1]),2):1}function Ft(e,t,n,r=()=>!1){let i=e[t];if(!I(i))return 0;let a=e=>n.aliasMap.get(e)??e,o=e=>!r(e)&&(n.aliases.has(e)||n.flagNames.has(a(e))),{flags:s,valueOption:c}=L(i.slice(1),e=>o(e)&&!n.booleanFlags.has(a(e)));return s.every(o)?c&&c.value===void 0&&J(i,a(c.name),!1,e[t+1],n.booleanFlags)?2:1:0}function It(e,t,n){let r=Nt(n),i=new Set(t),a=[],o=[],s=0;for(;s<e.length;){let t=e[s];if(t===`--`||Lt.has(t))break;if(!t.startsWith(`-`)&&i.has(t))return{subCommandIndex:s,globalTokensBefore:a,tokensAfterSubcommand:e.slice(s+1),suppressedTokens:o};if(t.startsWith(`--`)){let{resolvedName:n,withoutDashes:i,isNegated:c,isGlobal:l,isSuppressedNegation:u}=Pt(t,r);if(l){s+=Y(e,s,n,c,r.booleanFlags,a);continue}if(u){o.push(i),s++;continue}break}if(t.startsWith(`-`)&&t.length>1){let n=t.includes(`=`)?t.slice(1,t.indexOf(`=`)):t.slice(1);if(n.length===1){let t=r.aliasMap.get(n)??n;if(r.aliases.has(n)||r.flagNames.has(t)){s+=Y(e,s,t,!1,r.booleanFlags,a);continue}}let i=Ft(e,s,r);if(i>0){a.push(...e.slice(s,s+i)),s+=i;continue}break}break}return{subCommandIndex:-1,globalTokensBefore:a,tokensAfterSubcommand:[],suppressedTokens:o}}const Lt=/* @__PURE__ */ new Set([`--help`,`-h`,`--help-all`,`-H`,`--help-json`,`--version`]);function Rt(e,t,n={}){let r=n.stopOnSuppressedNegation===!0||t?.unknownKeysMode===`strict`,i=t?Nt(t):{aliasMap:/* @__PURE__ */ new Map,booleanFlags:/* @__PURE__ */ new Set,definedNames:/* @__PURE__ */ new Set,flagNames:/* @__PURE__ */ new Set,cliNames:/* @__PURE__ */ new Set,aliases:/* @__PURE__ */ new Set,negationMap:/* @__PURE__ */ new Map,defaultNegationDisabledFields:/* @__PURE__ */ new Set};for(let t=0;t<e.length;t++){let n=e[t];if(!n.startsWith(`-`))return t;if(n===`--`||Lt.has(n))return-1;if(n.startsWith(`--`)){let{resolvedName:a,isNegated:o,isGlobal:s,isSuppressedNegation:c}=Pt(n,i);if(s){J(n,a,o,e[t+1],i.booleanFlags)&&t++;continue}if(c){if(r)return-1;continue}return-1}let a=n.includes(`=`)?n.slice(1,n.indexOf(`=`)):n.slice(1);if(a.length===1){let r=i.aliasMap.get(a)??a;if(i.aliases.has(a)||i.flagNames.has(r)){J(n,r,!1,e[t+1],i.booleanFlags)&&t++;continue}}let o=Ft(e,t,i);if(o>0)t+=o-1;else return-1}return-1}function zt(e,t){let n=Rt(e,t);return n>=0?e[n]:void 0}function Bt(t,n,r={}){let i=E(n),a=[...i],s=a.length>0,c=s&&!n.run;if(s&&t.length>0){if(r.globalExtracted){let e=It(t,a,r.globalExtracted);if(e.subCommandIndex>=0){let n=Ut(e.globalTokensBefore,r.globalExtracted);return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:t[e.subCommandIndex],remainingArgs:e.tokensAfterSubcommand,rawArgs:{},positionals:[],rest:[],unknownFlags:e.suppressedTokens,unknownGlobalFlags:e.suppressedTokens,rawGlobalArgs:n}}}else{let e=t[0];if(e&&!e.startsWith(`-`)&&i.has(e))return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:e,remainingArgs:t.slice(1),rawArgs:{},positionals:[],rest:[],unknownFlags:[]}}}let l;n.args&&(l=u(n.args),r.skipValidation||(ht(l),xt(l),gt(l),bt(l),_t(l),vt(l,s),yt(l),r.globalExtracted&&wt(r.globalExtracted,l)));let d=t,f,p=[];if(r.globalExtracted){let e=l?o(l):[],n=new Set(e.map(e=>e.name)),{separated:i,globalParsed:a,suppressedTokens:s}=Wt(t,r.globalExtracted,l&&{...l,fields:[...e,...l.fields.filter(e=>!n.has(e.name))]});d=i,f=a,p=s}let m=t.indexOf(`--`),h=m>=0?t.slice(0,m):t,g=l?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`H`))??!1,_=l?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`h`))??!1,v=h.includes(`--help-all`)||!g&&h.includes(`-H`),y=h.includes(`--help-json`),ee=!v&&!y&&(h.includes(`--help`)||!_&&h.includes(`-h`)),b=h.includes(`--version`);if(ee||v||y||b)return{helpRequested:ee,helpAllRequested:v,helpJsonRequested:y,versionRequested:b,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:[],rest:[],unknownFlags:[],unknownGlobalFlags:p,rawGlobalArgs:f};if(!l){let t=d.indexOf(`--`),n=t>=0?d.slice(0,t):d,i=t>=0?d.slice(t+1):[],a=e=>c&&e.startsWith(`-`)&&e!==`-`,o=new Set(r.globalExtracted?.fields.flatMap(t=>[t.name,t.cliName,...e(t)])),s=r.globalExtracted?R(r.globalExtracted):{},l=n.filter(a).flatMap(e=>Object.keys(N([e],s).options)).filter(e=>!o.has(e));return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:n.filter(e=>!a(e)),rest:i,unknownFlags:l,unknownGlobalFlags:p,rawGlobalArgs:f}}let x=Vt(l,d,{promptAvailable:r.promptAvailable===!0,inheritedNames:r.inheritedNames??/* @__PURE__ */ new Set});if(!x)return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:[],rest:[],unknownFlags:[],unknownGlobalFlags:p,extractedFields:l,matchesNoUnionOption:!0,rawGlobalArgs:f};let te=R(x),S=N(d,{...te,unknownFlagsTakeNoValue:c}),C=P(S,x),w=X(C,x),T=x.fields.filter(e=>e.named),D=new Set(T.map(e=>e.name)),O=new Set(T.map(e=>e.cliName)),k=/* @__PURE__ */ new Set;for(let t of T)for(let n of e(t))k.add(n);if(r.globalExtracted)for(let t of r.globalExtracted.fields){D.add(t.name),O.add(t.cliName);for(let n of e(t))k.add(n)}let A=[];for(let e of Object.keys(S.options))D.has(e)||O.has(e)||k.has(e)||A.push(e);return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:C,positionals:S.positionals,rest:S.rest,unknownFlags:A,unknownGlobalFlags:p,extractedFields:l,optionFields:T,positionalSlotFields:F(x,S.options),rawGlobalArgs:f,envFallbackFields:w}}function Vt(e,t,n){let{discriminator:r,variants:i,unionOptions:a}=e;if(r&&i){let n=e=>{let n=P(N(t,R(e)),e);return X(n,e),n},r=g(e,n);return r===e?i.some(t=>{let r=n({...e,fields:t.fields});return g(e,()=>r)!==e})?void 0:e:r}if(a){let r=a.flatMap(e=>{let r=Vt(e,t,n);return r?[r]:[]}),i=n.promptAvailable?r.filter(e=>Ht(e,t,void 0)):[],o=r.find(e=>Ht(e,t,n.inheritedNames))??(i.length===1?i[0]:void 0);return o&&{...e,fields:o.fields}}return e}function X(e,t){let n=/* @__PURE__ */ new Set;for(let r of t.fields)if(r.env&&e[r.name]===void 0)for(let t of[r.env].flat()){let i=process.env[t];if(i!==void 0){e[r.name]=re(i,r.type),n.add(r.name);break}}return n}function Ht(t,n,r){let i=N(n,R(t)),a=t.fields.filter(e=>e.named),o=new Set(a.flatMap(t=>[t.name,t.cliName,...e(t)]));if(Object.keys(i.options).some(e=>!o.has(e)))return!1;let s=F(t,i.options),c=i.positionals.length+i.rest.length;if(!s.some(e=>e.type===`array`)&&c>s.length)return!1;let l=P(i,t);return t.fields.some(e=>e.type!==`boolean`&&[l[e.name]].flat().includes(!0))?!1:r===void 0||(X(l,t),t.fields.every(e=>!e.required||l[e.name]!==void 0||r.has(e.name)))}function Ut(e,t){if(e.length===0)return{};let n=R(t),r=N(e,n);return P(r,t)}function Wt(n,r,i){let a=Nt(r),o=new Set(i?.fields.map(e=>e.name)??[]),s=new Set(i?.fields.map(e=>e.cliName)??[]),c=i?R(i):void 0,l=new Set(c?.aliasMap?.keys()??[]),u=new Set(c?.negationMap?.keys()??[]),d=/* @__PURE__ */ new Set;for(let n of i?.fields??[])if(n.type===`boolean`&&n.negation===!0)for(let r of[n.cliName,...e(n)]){let e=`no-${r}`;d.add(e),d.add(t(e))}let f=[],p=[],m=[];for(let e=0;e<n.length;e++){let t=n[e];if(t===`--`){p.push(...n.slice(e));break}if(t.startsWith(`--`)){let{resolvedName:r,withoutDashes:i,isNegated:c,isGlobal:p,isSuppressedNegation:h}=Pt(t,a),g=r,_=o.has(i)||o.has(g)||s.has(i)||s.has(g)||l.has(i)||l.has(g)||u.has(i)||u.has(g)||d.has(i);if(p&&!_){e+=Y(n,e,r,c,a.booleanFlags,f)-1;continue}if(h&&!_){m.push(i);continue}}else if(t.startsWith(`-`)&&t.length>1){let r=t.includes(`=`)?t.slice(1,t.indexOf(`=`)):t.slice(1);if(r.length===1){let t=a.aliasMap.get(r)??r;if((a.aliases.has(r)||a.flagNames.has(t))&&!l.has(r)){e+=Y(n,e,t,!1,a.booleanFlags,f)-1;continue}}let i=Ft(n,e,a,e=>l.has(e));if(i>0){f.push(...n.slice(e,e+i)),e+=i-1;continue}}p.push(t)}return{separated:p,globalParsed:Ut(f,r),suppressedTokens:m}}function Z(e,t){return a(t)?_(e,t):i().validate(e,t)}function Q(e){return e.map(e=>`${e.path.length>0?`${e.path.join(`.`)}: `:``}${e.message}`).join(`
|
|
33
|
+
`)}function Gt(e,t){let n=[];for(let e=0;e<=t.length;e++)n[e]=[e];for(let t=0;t<=e.length;t++)n[0][t]=t;for(let r=1;r<=t.length;r++)for(let i=1;i<=e.length;i++)t.charAt(r-1)===e.charAt(i-1)?n[r][i]=n[r-1][i-1]:n[r][i]=Math.min(n[r-1][i-1]+1,n[r][i-1]+1,n[r-1][i]+1);return n[t.length][e.length]}function Kt(e,t){let n=Math.max(2,Math.floor(e.length/2));return t.map(t=>({candidate:t,distance:Gt(e.toLowerCase(),t.toLowerCase())})).filter(({distance:e})=>e<=n).sort((e,t)=>e.distance-t.distance).map(({candidate:e})=>e).slice(0,3)}function qt(e,t){let n=Kt(e.replace(/^-{1,2}/,``),t),r=`${M.warning(`Warning: Unknown option:`)} ${M.bold(e)}`;if(n.length>0){r+=`\n\n${M.info(`Did you mean?`)}`;for(let e of n)r+=`\n ${j.arrow} ${M.option(`--${e}`)}`}return r}function Jt(e,t){return t&&e.stack?`${M.error(`Error:`)} ${e.message}\n\n${M.dim(e.stack)}`:`${M.error(`Error:`)} ${e.message}`}function $(e){return new Proxy(e,{get(e,n,i){if(typeof n==`string`){if(n in e)return Reflect.get(e,n,i);let a=t(n);if(a!==n&&a in e)return Reflect.get(e,a,i);let o=r(n);if(o!==n&&o in e)return Reflect.get(e,o,i)}return Reflect.get(e,n,i)},has(e,n){if(typeof n==`string`){if(n in e)return!0;let i=t(n);if(i!==n&&i in e)return!0;let a=r(n);if(a!==n&&a in e)return!0}return Reflect.has(e,n)}})}async function Yt(e,t,n){for(let r of t.fields)r.effect&&await r.effect(c(e,r),{name:r.name,args:e,...n!=null&&{globalArgs:n}})}const Xt={log:e=>console.log(e),error:e=>console.error(e),warn:e=>console.warn(e)};function Zt(e){let t={};for(let[n,r]of Object.entries(e))try{t[n]=structuredClone(r)}catch{t[n]=r}return t}function Qt(e,n){Object.defineProperty(e,"$source",{value:e=>n.get(e)??n.get(t(e))??n.get(r(e))??`default`,enumerable:!1})}function $t(e,t,n){let r=/* @__PURE__ */ new Map;for(let t of e)r.set(t,`cli`);for(let e of t)r.set(e,`env`);for(let e of n)r.set(e,`prompt`);return r}function en(e,t){Object.defineProperty(e,"$invocation",{value:t,enumerable:!1})}function tn(e,t){Object.defineProperty(e,"$agent",{value:t,enumerable:!1})}function nn(e,t){return e&&(n=>e({...n,agent:t}))}function rn(e,t,n){if(!e.rawGlobalArgs)return;let r=new Set(n.fields.map(e=>e.name)),i={};for(let[t,n]of Object.entries(e.rawGlobalArgs))r.has(t)&&(i[t]=n);let a=new Set(Object.keys(i)),o=X(i,n);for(let[t,n]of Object.entries(e.promptedGlobalArgs??{}))r.has(t)&&(o.delete(t),n===void 0?(delete i[t],a.delete(t)):i[t]=n);for(let n=0;n<=r.size;n++){let n=Z(i,t);if(n.success){let t=n.data,r=/* @__PURE__ */ new Map;for(let e of a)e in i&&r.set(e,`cli`);for(let e of o)e in i&&r.set(e,`env`);for(let[t,n]of Object.entries(e.promptedGlobalArgs??{}))n!==void 0&&t in i&&r.set(t,`prompt`);return Qt(t,r),$(t)}let r=n.errors.map(e=>e.path[0]).filter(e=>e!==void 0&&Object.hasOwn(i,e));if(r.length===0){let e=Object.keys(i).filter(e=>{let{[e]:n,...r}=i;return Z(r,t).success});if(e.length!==1)return;r=e}for(let e of r)delete i[e]}}function an(e,t,n,r){let i=e.success?void 0:e.error;if(e.success||t.effectsRan||!n||!r)return{error:i};try{return{error:i,globalArgs:rn(t,n,r)}}catch{return{error:i}}}function on(e,t){let{agentHelp:n,_agent:r}=e;if(n&&r)return typeof n==`string`?n:n({agent:r,commandPath:t.commandPath??[]})}function sn(e,t){let n=t.commandPath?.at(-1)??e.name;return t.aliasFor?{name:n,aliasFor:t.aliasFor}:{name:n}}async function cn(e,t,n={}){let r=pn(n),i=v(),a=nn(n.cleanup,i),o=n.captureLogs??!1,s=o?A():null;if(n.setup){s?.start();try{await n.setup({agent:i})}catch(e){let t=e instanceof Error?e:Error(String(e));if(a)try{await a({error:t})}catch{}return s?.stop(),{success:!1,error:t,exitCode:1,logs:s?.getLogs()??O()}}s?.stop()}let c={},l=await fn(e,t,{...n,handleSignals:!1,_globalExtracted:r,_globalCleanup:a,_existingLogs:s?.getLogs(),_agent:i,_globalTrace:c});if(a){let e=o?A():null;e?.start();let t=an(l,c,n.globalArgs,r);try{await a(t)}catch(t){if(l.success){let n=t instanceof Error?t:Error(String(t));return e?.stop(),{success:!1,error:n,exitCode:1,logs:k(l.logs,e?.getLogs()??O())}}}e?.stop();let i=e?.getLogs()??O();if(i.entries.length>0)return{...l,logs:k(l.logs,i)}}return l}function ln(e,t,n){let r=zt(t,n);return!r||!r.startsWith(`__`)?!1:Object.hasOwn(e.subCommands??{},r)}async function un(e,t={}){if(t.compileCache!==!1&&y(typeof t.compileCache==`string`?{cacheDir:t.compileCache}:{programName:e.name}),e.runMainHook)try{e.runMainHook(process.argv.slice(2))}catch{}let n=process.argv.slice(2),r;if(t.globalArgs)try{r=u(t.globalArgs)}catch{}let i=t;if(ln(e,n,r)){let{setup:e,cleanup:n,prompt:r,globalArgs:a,...o}=t;i=o}let a=pn(i),o=v(),s=nn(i.cleanup,o);if(i.skipValidation||Dt(e),i.onUnknownSubcommand&&!e.run&&!ln(e,n,r)){let t=E(e);if(t.size>0){let e=Rt(n,a,{stopOnSuppressedNegation:a?.unknownKeysMode!==`passthrough`}),r=e>=0?n[e]:void 0;if(r&&!t.has(r)){let t=n.slice(e+1),a=await i.onUnknownSubcommand({commandPath:[],name:r,args:t,precedingArgs:n.slice(0,e)});if(typeof a==`number`)return await dn(),process.exit(a)}}}if(i.setup)try{await i.setup({agent:o})}catch(e){let t=e instanceof Error?e:Error(String(e));if(s)try{await s({error:t})}catch{}process.exit(1)}let c={},l=await fn(e,n,{debug:i.debug,captureLogs:i.captureLogs,skipValidation:i.skipValidation,handleSignals:!0,logger:i.logger,globalArgs:i.globalArgs,prompt:i.prompt,onUnknownSubcommand:i.onUnknownSubcommand,agentHelp:i.agentHelp,_globalExtracted:a,_globalCleanup:s,_agent:o,_globalTrace:c,_context:{commandPath:[],rootName:e.name,rootVersion:i.version,globalExtracted:a}});if((i.displayErrors??!0)&&!l.success&&l.error&&(i.logger??Xt).error(Jt(l.error,i.debug??!1)),s){let e=an(l,c,i.globalArgs,a);try{await s(e)}catch{}}await dn(),process.exit(l.exitCode)}async function dn(){await Promise.all([process.stdout,process.stderr].map(e=>e.writableLength>0?new Promise(t=>e.write(``,()=>t())):Promise.resolve()))}async function fn(e,t,n={}){let r=n.logger??Xt,i=n._context??{commandPath:[],rootName:e.name,globalExtracted:n._globalExtracted},a=n.captureLogs??!1?A():null;a?.start();let o=()=>{let e=n._existingLogs??O(),t=a?.getLogs()??O();return k(e,t)};try{n.skipValidation||Dt(e);let s=Bt(t,e,{skipValidation:n.skipValidation,globalExtracted:n._globalExtracted,promptAvailable:n.prompt!==void 0,inheritedNames:new Set(Object.keys(n._parsedGlobalArgs??{}))}),c={...n._parsedGlobalArgs,...s.rawGlobalArgs};n._globalTrace&&(n._globalTrace.rawGlobalArgs={...c});let u=i.commandPath??[];if(n.onUnknownSubcommand&&!e.run&&u.length>0){let r=E(e);if(r.size>0){let e=Rt(t,n._globalExtracted,{stopOnSuppressedNegation:n._globalExtracted?.unknownKeysMode!==`passthrough`}),i=e>=0?t[e]:void 0;if(i&&!r.has(i)){let r=t.slice(e+1),s=await n.onUnknownSubcommand({commandPath:u,name:i,args:r,precedingArgs:[...n._precedingArgs??[],...t.slice(0,e)]});if(typeof s==`number`){if(a?.stop(),n.handleSignals){if(n._globalCleanup)try{await n._globalCleanup({error:void 0})}catch{}await dn(),process.exit(s)}return s===0?{success:!0,result:void 0,exitCode:0,logs:o()}:{success:!1,error:/* @__PURE__ */ Error(`Plugin "${[...u,i].join(` `)}" exited with code ${s}`),exitCode:s,logs:o()}}}}}if(s.helpRequested||s.helpAllRequested||s.helpJsonRequested){let c=!1,l=C(e),u=E(e);if(l.length>0){let e=zt(t,i.globalExtracted);e&&!u.has(e)&&(c=!0)}let d=on(n,i);if(s.helpJsonRequested){let t=Xe(e,{context:i,agentHelp:d});r.log(JSON.stringify(t))}else{let t=Je(e,{showSubcommands:n.showSubcommands??!0,showSubcommandOptions:s.helpAllRequested||n.showSubcommandOptions,context:i,agentHelp:d});r.log(t)}if(a?.stop(),c){let e=zt(t,i.globalExtracted)??``,n=Kt(e,[...u]),r=n.length>0?` Did you mean: ${n.join(`, `)}?`:``;return{success:!1,error:/* @__PURE__ */ Error(`Unknown subcommand: ${e}${r?`.${r}`:``}`),exitCode:2,logs:o()}}return{success:!0,result:void 0,exitCode:0,logs:o()}}if(s.unknownGlobalFlags&&s.unknownGlobalFlags.length>0){let e=i.globalExtracted?.unknownKeysMode??`strip`;if(e===`strict`)return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown flags: ${s.unknownGlobalFlags.join(`, `)}`),exitCode:2,logs:o()};if(e===`strip`){let e=i.globalExtracted?.fields.map(e=>e.name)??[];for(let t of s.unknownGlobalFlags)r.error(qt(t,e))}}if(s.versionRequested){let e=i.rootVersion;return e&&r.log(e),a?.stop(),{success:!0,result:void 0,exitCode:0,logs:o()}}if(s.subCommand){let r=n._metadataOnly??!1,l=await ee(e,s.subCommand,e=>{if(r)return!0;if(!e.requiredPackages?.length)return!1;let t=e,a=s.remainingArgs;for(;;){let e=Bt(a,t,{skipValidation:n.skipValidation,globalExtracted:i.globalExtracted,promptAvailable:!!n.prompt});if(e.helpRequested||e.helpAllRequested||e.helpJsonRequested||e.versionRequested)return r=!0,!0;if(!e.subCommand||!t.subCommands)return!1;let o=Object.hasOwn(t.subCommands,e.subCommand)?e.subCommand:te(t,e.subCommand)??e.subCommand,s=t.subCommands[o],c=s?b(s):null;if(!c)return!1;t=c,a=e.remainingArgs}});if(l){let e={commandPath:[...i.commandPath??[],s.subCommand],rootName:i.rootName,rootVersion:i.rootVersion,globalExtracted:i.globalExtracted,aliasFor:l.aliasFor};a?.stop();let u=new Set(n._globalExtracted?.unknownKeysMode===`passthrough`?[]:s.unknownGlobalFlags??[]),d=e=>e.startsWith(`--`)&&u.has(ne(e)),f=t.slice(0,t.length-s.remainingArgs.length-1).filter(e=>!d(e));return fn(l.command,s.remainingArgs,{...n,_metadataOnly:r,_context:e,_existingLogs:o(),_parsedGlobalArgs:c,_precedingArgs:[...n._precedingArgs??[],...f]})}}let d=s.positionalSlotFields??[],p=d.some(e=>e.type===`array`),m=[...s.positionals,...s.rest],h=p?[]:m.slice(d.length),_=p?[]:s.positionals.slice(d.length);if(s.matchesNoUnionOption)return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Arguments match none of the accepted forms. See --help for the accepted forms.`),exitCode:2,logs:o()};let v=E(e),y=v.size>0?_.find(e=>!e.startsWith(`-`)&&!v.has(e)):void 0;if(y){let e=Kt(y,[...v]),t=e.length>0?` Did you mean: ${e.join(`, `)}?`:``;return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown subcommand: ${y}${t?`.${t}`:``}`),exitCode:2,logs:o()}}if(s.unknownFlags.length>0){let e=s.extractedFields?.unknownKeysMode??i.globalExtracted?.unknownKeysMode??`strip`,t=s.optionFields?.map(e=>e.name)??i.globalExtracted?.fields.map(e=>e.name)??[];if(e===`strict`)return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown flags: ${s.unknownFlags.join(`, `)}`),exitCode:2,logs:o()};if(e===`strip`)for(let e of s.unknownFlags)r.error(qt(e,t))}if(C(e).length>0&&!s.subCommand&&!e.run&&h.length===0){if(e.defaultSubCommand){let r=e.subCommands?.[e.defaultSubCommand];if(r){let l=await T(r),u={commandPath:[...i.commandPath??[],e.defaultSubCommand],rootName:i.rootName,rootVersion:i.rootVersion,globalExtracted:i.globalExtracted};a?.stop();let d=new Set(n._globalExtracted?.unknownKeysMode===`passthrough`?[]:s.unknownGlobalFlags??[]),f=e=>e.startsWith(`--`)&&d.has(ne(e)),p=t.filter(e=>!f(e));return fn(l,[],{...n,_context:u,_existingLogs:o(),_parsedGlobalArgs:c,_precedingArgs:[...n._precedingArgs??[],...p]})}}if(n.globalArgs&&n._globalExtracted){let e={...c};X(e,n._globalExtracted);let t=Z(e,n.globalArgs),r=t.success?[]:t.errors.filter(t=>t.path[0]&&e[t.path[0]]!==void 0);if(r.length>0)return a?.stop(),{success:!1,error:Error(Q(r)),exitCode:2,logs:o()}}let l=Je(e,{showSubcommands:n.showSubcommands??!0,context:i,agentHelp:on(n,i)});return r.log(l),a?.stop(),{success:!0,result:void 0,exitCode:0,logs:o()}}if(h.length>0){let e=s.extractedFields?.unknownKeysMode??`strip`;if(e===`strict`)return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unexpected positional argument${h.length>1?`s`:``}: ${h.join(`, `)}`),exitCode:2,logs:o()};if(e===`strip`)for(let e of h)(r.warn??r.error)(`Warning: Unexpected positional argument: ${e}`)}let x={},S=e.name===`__complete`,w=new Set(Object.keys(c)),D=/* @__PURE__ */ new Set,O=/* @__PURE__ */ new Set;if(n.globalArgs&&n._globalExtracted&&!S){if(D=X(c,n._globalExtracted),n.prompt){let e=Zt(c);try{let e=await n.prompt(c,n._globalExtracted,{globalArgs:c});for(let[t,n]of Object.entries(e))n!==void 0&&(c[t]=n)}finally{let t={};for(let n of/* @__PURE__ */ new Set([...Object.keys(e),...Object.keys(c)])){let r=c[n];oe(e[n],r)||(t[n]=r,r===void 0&&(w.delete(n),D.delete(n)))}O=new Set(Object.keys(t).filter(e=>t[e]!==void 0)),n._globalTrace&&(n._globalTrace.promptedGlobalArgs=t)}}let e=Z(c,n.globalArgs);if(!e.success)return a?.stop(),{success:!1,error:Error(Q(e.errors)),exitCode:2,logs:o()};x=e.data}let k=n.globalArgs&&n._globalExtracted&&!S?l(n._globalExtracted,e=>Z(c,e).success,()=>c):n._globalExtracted,A=S||!n._globalExtracted?void 0:k===n._globalExtracted?g(n._globalExtracted,()=>x).fields:k?.fields;if(!e.args){let t=$t(w,D,O);Qt(x,t),en(x,sn(e,i)),tn(x,n._agent);let r=$(x);return n._globalExtracted&&!S&&(n._globalTrace&&(n._globalTrace.effectsRan=!0),await Yt(r,k,r)),a?.stop(),await ce(e,r,{handleSignals:n.handleSignals,captureLogs:n.captureLogs,existingLogs:o(),globalCleanup:n._globalCleanup,packageDiscriminators:n._globalExtracted?.discriminator?[n._globalExtracted.discriminator]:[],packageFields:A})}let j=s.rawArgs,M=n.prompt?Zt(s.rawArgs):s.rawArgs,N=e=>Object.hasOwn(M,e),re=/* @__PURE__ */ new Set;if(n.prompt&&s.extractedFields){let e=await n.prompt(j,s.extractedFields,{globalArgs:x}),t={...j};for(let[n,r]of Object.entries(e))r!==void 0&&(t[n]=r);j=t;for(let[e,t]of Object.entries(j))t===void 0||N(e)&&oe(M[e],t)||re.add(e)}let P=Z(j,e.args);if(!P.success)return a?.stop(),{success:!1,error:Error(Q(P.errors)),exitCode:2,logs:o()};let ie=$(P.data),ae=$t(w,D,O);Qt(x,ae),en(x,sn(e,i)),tn(x,n._agent);let F=$(x);n._globalExtracted&&!S&&(n._globalTrace&&(n._globalTrace.effectsRan=!0),await Yt(F,k,F));let I=s.extractedFields?S?s.extractedFields:l(s.extractedFields,e=>Z(j,e).success,()=>j):void 0;I&&!S&&await Yt(ie,I,F);let L=f({...F},{...ie},k?.fields??[],I?.fields??[]),R=new Map(ae),se=s.envFallbackFields??/* @__PURE__ */ new Set;for(let e of s.extractedFields?.fields??[]){let t=j[e.name]!==void 0;R.set(e.name,re.has(e.name)?`prompt`:t&&se.has(e.name)?`env`:t&&N(e.name)?`cli`:`default`)}Qt(L,R),en(L,sn(e,i)),tn(L,n._agent);let le=$(L);return a?.stop(),await ce(e,le,{handleSignals:n.handleSignals,captureLogs:n.captureLogs,existingLogs:o(),globalCleanup:n._globalCleanup,packageDiscriminators:[s.extractedFields?.discriminator,n._globalExtracted?.discriminator].filter(e=>e!==void 0),packageFields:S?void 0:[...A??[],...I!==s.extractedFields&&I?I.fields:[...s.optionFields??[],...s.positionalSlotFields??[]]]})}catch(e){let t=e instanceof Error?e:Error(String(e));return a?.stop(),{success:!1,error:t,exitCode:1,logs:o()}}}function pn(e){if(!e.globalArgs)return;let t=u(e.globalArgs);if(!e.skipValidation){ht(t),xt(t),gt(t),bt(t),vt(t,!0),yt(t);let e=t.fields.filter(e=>e.positional).map(e=>e.name);if(e.length>0)throw Error(`Global options schema must not contain positional arguments. Found: ${e.join(`, `)}`)}return t}export{$e as C,z as D,Xe as E,me as O,Qe as S,Je as T,at as _,Mt as a,rt as b,wt as c,ht as d,bt as f,nt as g,yt as h,Q as i,Dt as l,vt as m,un as n,xt as o,_t as p,$ as r,At as s,cn as t,gt as u,tt as v,it as w,ot as x,et as y};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export{t as runCommand}from"./runner-B7QLJFxY.js";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{g as e,h as t}from"./schema-extractor-D6Se8W6B.js";const n=t({shell:e.enum([`bash`,`zsh`,`fish`],{description:`Target shell for output formatting`}),args:e.stringArray({positional:!0,description:`Arguments to complete`})});export{n as t};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{a as e,s as t,t as n}from"./registry-BEz5iex_.js";const r=`__polittyInternalArgs`,i={string(e){return{kind:`string`,optional:!1,meta:e}},optionalString(e){return{kind:`string`,optional:!0,meta:e}},boolean(e){return{kind:`boolean`,optional:!1,defaultValue:!1,meta:e}},enum(e,t){return{kind:`enum`,enumValues:e,optional:!1,meta:t}},optionalEnum(e,t){return{kind:`enum`,enumValues:e,optional:!0,meta:t}},stringArray(e){return{kind:`string-array`,optional:!1,defaultValue:[],meta:e}},optionalStringArray(e){return{kind:`string-array`,optional:!0,meta:e}}};function a(e,t={}){return{[r]:!0,fields:e,unknownKeys:t.unknownKeys??`strip`}}function o(e){return typeof e==`object`&&!!e&&e[r]===!0}const s={string:`string`,boolean:`boolean`,enum:`string`,"string-array":`array`},c=/* @__PURE__ */ new WeakMap;function l(t){let n=c.get(t);if(n)return n;let r={fields:Object.entries(t.fields).map(([t,n])=>e(t,{argMeta:n.meta,description:void 0,required:!n.optional&&n.defaultValue===void 0,defaultValue:n.defaultValue,type:s[n.kind],enumValues:n.enumValues?[...n.enumValues]:void 0,schema:n})),schema:t,schemaType:`object`,unknownKeysMode:t.unknownKeys};return c.set(t,r),r}function u(e){switch(e.kind){case`enum`:return`one of ${(e.enumValues??[]).map(e=>JSON.stringify(e)).join(` | `)}`;case`string-array`:return`array`;default:return e.kind}}function d(e){return e===null?`null`:Array.isArray(e)?`array`:typeof e}function f(e,t,n){return{path:[e],message:`Invalid input: expected ${u(t)}, received ${d(n)}`,code:`invalid_type`,received:n,expected:u(t)}}function p(e,t,n){switch(t.kind){case`string`:return typeof n==`string`?null:f(e,t,n);case`boolean`:return typeof n==`boolean`?null:f(e,t,n);case`enum`:return typeof n!=`string`||!(t.enumValues??[]).includes(n)?{path:[e],message:`Invalid option: expected ${u(t)}`,code:`invalid_value`,received:n,expected:u(t)}:null;case`string-array`:return!Array.isArray(n)||n.some(e=>typeof e!=`string`)?f(e,t,n):null}}function m(e,t){let n=[],r={};for(let[i,a]of Object.entries(t.fields)){let t=e[i];if(t===void 0){a.defaultValue===void 0?a.optional||n.push(f(i,a,void 0)):r[i]=Array.isArray(a.defaultValue)?[...a.defaultValue]:a.defaultValue;continue}let o=p(i,a,t);o?n.push(o):r[i]=t}let i=new Set(Object.keys(t.fields)),a=Object.keys(e).filter(e=>!i.has(e));if(a.length>0){if(t.unknownKeys===`strict`)n.push({path:[],message:`Unrecognized key${a.length>1?`s`:``}: ${a.map(e=>JSON.stringify(e)).join(`, `)}`,code:`unrecognized_keys`});else if(t.unknownKeys===`passthrough`)for(let t of a)Object.defineProperty(r,t,{value:e[t],enumerable:!0,writable:!0,configurable:!0})}return n.length>0?{success:!1,errors:n}:{success:!0,data:r}}function h(e,t,n){if(e.length<=n.length||!e.startsWith(n))return;if(t===`kebab`)return e[n.length]===`-`?e.slice(n.length+1):void 0;let r=e[n.length];return r===r.toLowerCase()?void 0:r.toLowerCase()+e.slice(n.length+1)}function g(e,t,n){if(t===`dot`){let t=e.indexOf(`.`);return t<0?void 0:[e.slice(0,t),e.slice(t+1)]}let r;for(let i of n)h(e,t,i)!==void 0&&(r===void 0||i.length<r.length)&&(r=i);return r===void 0?void 0:[r,h(e,t,r)]}function _(e,t,n){if(t===`dot`)return e.split(`.`);let r=[],i=e;for(let e=g(i,t,n);e;e=g(i,t,n)){let a=e[0];r.push(a),i=e[1],n=n.flatMap(e=>h(e,t,a)??[])}return r.push(i),r}function v(e={}){let t=e.style??`dot`,n=`prefixes`in e?e.prefixes:[];return e=>_(e,t,n)}function y(e,t,n){t===`__proto__`?Object.defineProperty(e,t,{value:n,enumerable:!0,writable:!0,configurable:!0}):e[t]=n}function b(e,t){let n={},r=/* @__PURE__ */ new Set,i=(e,t)=>({issues:[{message:`Cannot unflatten "${e}": "${t}" is both a value and a group`,path:[e]}]});for(let a of Object.keys(e)){let o=t(a),s=o.length-1,c=n;for(let e=0;e<s;e++){let t=o[e];if(Object.hasOwn(c,t)){let e=c[t];if(!r.has(e))return i(a,t);c=e}else{let e={};r.add(e),y(c,t,e),c=e}}let l=o[s];if(Object.hasOwn(c,l))return i(a,l);y(c,l,e[a])}return{value:n}}function x(e,n={}){let r=v(n),i=b(Object.fromEntries(e.map(e=>[e,void 0])),r);if(i.issues)throw TypeError(i.issues[0].message);let a=/* @__PURE__ */ new Map;for(let n of e){let e=r(n)[0],i=t(e),o=a.get(i);if(o!==void 0&&o!==e)throw TypeError(`Cannot unflatten "${n}": "${o}" and "${e}" are spellings of the same name. Spell the name the same way in every key.`);a.set(i,e)}}const S=/* @__PURE__ */ new WeakMap;function C(e,t={}){return S.set(e,t),e}function w(e){return S.get(e)}function T(e){if(S.has(e))throw Error(`An unflatten schema cannot be an option of a union: unflatten wraps one object schema, so the union cannot tell which option's groups its output nests. Unflatten the object that holds the union instead, or use a plain object for the option.`)}function E(e,t){if(!t.nested)return e[t.name];let n=e;for(let e of t.nested.path)n=typeof n==`object`&&n&&Object.hasOwn(n,e)?n[e]:void 0;return n}function D(e,t,n,r){let i=O(r),a=new Set([...O(n)].filter(e=>i.has(e))),o=(e,t,n)=>{let r={...e,...t};for(let i of Object.keys(t)){let s=[...n,i],c=Object.hasOwn(e,i)?e[i]:void 0,l=t[i];a.has(s.join(`\0`))&&k(c)&&k(l)&&y(r,i,o(c,l,s))}return r};return o(e,t,[])}function O(e){let t=/* @__PURE__ */ new Set;for(let{nested:n}of e){let e=n?.path??[];for(let n=1;n<e.length;n++)t.add(e.slice(0,n).join(`\0`))}return t}function k(e){if(typeof e!=`object`||!e)return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function A(e){return o(e)?e.unknownKeys:n().getUnknownKeysMode(e)}const j=/* @__PURE__ */ new WeakSet,M=/* @__PURE__ */ new WeakMap;function N(e){let t=o(e)?l(e):F(e,n().extractFields(e));return j.has(t)||(L(t),j.add(t)),t}function P(e){for(let t of e.unionOptions??[])T(t.schema),P(t)}function F(e,t){P(t);let n=w(e);if(!n)return t;let r=M.get(t);return r||(r=I(t,v(n)),M.set(t,r)),r}function I(e,t){let n=e=>e.map(e=>{let n=t(e.name);return n.length>1?{...e,nested:{path:n}}:e});return{...e,fields:n(e.fields),...e.variants&&{variants:e.variants.map(e=>({...e,fields:n(e.fields)}))},...e.unionOptions&&{unionOptions:e.unionOptions.map(e=>I(e,t))}}}function L(e){let t=e.variants??[e];for(let n of t)for(let t of n.fields)if(t.requiredPackages?.length&&t.type!==`boolean`&&t.name!==e.discriminator)throw Error(`Invalid requiredPackages for field "${t.name}": requiredPackages can only be used on boolean fields or discriminators.`);for(let t of e.unionOptions??[])L(t)}function R(e){return e.args?N(e.args):null}function z(e,t){let[n,...r]=e,i=/* @__PURE__ */ new Set;for(let e of n?.fields??[])e.name!==t&&r.every(t=>t.fields.some(t=>t.name===e.name&&t.positional===e.positional&&t.named===e.named&&B(t.requiredPackages,e.requiredPackages)))&&i.add(e.name);return i}function B(e,t){return(e?.length??0)===(t?.length??0)&&(e??[]).every((e,n)=>{let r=t?.[n];return e.name===r?.name&&e.install===r.install&&e.from?.toString()===r.from?.toString()})}function V(e){let t=W(e).filter(e=>e.named);return G(e,e=>e.named).map(e=>{let n=t.filter(t=>t.name===e.name),r=[...new Set(n.flatMap(e=>e.alias??[]))],i=[...new Set(n.flatMap(e=>e.hiddenAlias??[]))];return{...e,alias:r.length>0?r:e.alias,hiddenAlias:i.length>0?i:e.hiddenAlias}})}function H(e){return G(e,e=>e.positional)}function U(e){return G(e,e=>!e.positional)}function W(e){let t=e.variants??e.unionOptions??[];return[e.fields,...t.map(e=>e.fields)].flat()}function G(e,t){let n=/* @__PURE__ */ new Map;for(let r of W(e))t(r)&&!n.has(r.name)&&n.set(r.name,r);return[...n.values()]}function K(e,t){return e.effect===t.effect&&B(e.requiredPackages,t.requiredPackages)&&(e.nested?.path??[]).join(`\0`)===(t.nested?.path??[]).join(`\0`)}function q(e){let t=/* @__PURE__ */ new Map,n=/* @__PURE__ */ new Map;for(let r of e){if(r.unionOptions&&q(r.unionOptions)||r.variants&&q(r.variants))return!0;for(let e of r.fields){let r=t.get(e.name);if(!r)t.set(e.name,e);else if(!K(r,e))return!0;n.set(e.name,(n.get(e.name)??0)+1)}}return[...t].some(([t,r])=>n.get(t)<e.length&&(r.effect!==void 0||!!r.requiredPackages?.length))}function J(e,t,n){let r=e.unionOptions;if(e.discriminator||!r||!q(r))return e;for(let i of r){if(!t(i.schema))continue;let r=i.discriminator&&i.variants?Y(i,n):J(i,t,n);return{...e,fields:r.fields}}return e}function Y(e,t){let{discriminator:n,variants:r}=e;if(!n||!r){let n=e.unionOptions??[],r=n.map(e=>Y(e,t));if(r.every((e,t)=>e===n[t]))return e;let i=r.filter((r,i)=>{let a=t(r),o=n[i];if(o.discriminator&&a[o.discriminator]!==void 0&&r===o)return!1;let s=new Set(r.fields.map(e=>e.name));return!e.fields.some(e=>a[e.name]!==void 0&&!s.has(e.name))});if(!i.length)return e;let a=/* @__PURE__ */ new Map;for(let e of i)for(let t of e.fields){let e=a.get(t.name);e?a.set(t.name,{...e,type:e.type===t.type?e.type:`unknown`,named:e.named||t.named,positional:e.positional||t.positional,alias:[.../* @__PURE__ */ new Set([...e.alias??[],...t.alias??[]])],hiddenAlias:[.../* @__PURE__ */ new Set([...e.hiddenAlias??[],...t.hiddenAlias??[]])]}):a.set(t.name,t)}return{...e,fields:[...a.values()]}}let i=r.map(r=>{let i={...e,fields:r.fields};return{variant:r,fields:i,value:t(i)[n]}});for(let{variant:e,fields:t,value:n}of i)if(n!==void 0&&String(n)===e.discriminatorValue)return t;for(let{variant:e,fields:t,value:n}of i)if(n!==void 0&&e.normalizeDiscriminator&&String(e.normalizeDiscriminator(n))===e.discriminatorValue)return t;return e}function X(e,t){return U(e).find(e=>e.name===t)}export{o as _,V as a,H as c,x as d,E as f,i as g,a as h,A as i,J as l,C as m,N as n,X as o,D as p,R as r,U as s,z as t,Y as u,m as v};
|
package/dist/skill.d.ts
CHANGED
|
@@ -1,5 +1,4 @@
|
|
|
1
|
-
import {
|
|
2
|
-
//#region ../core/src/skill/types.d.ts
|
|
1
|
+
import { R as UnknownKeysMode, a as ArgsSchema, r as AnyCommand } from "./types-CaP5nn8i.js";
|
|
3
2
|
/**
|
|
4
3
|
* SKILL.md frontmatter metadata, validated against the Agent Skills
|
|
5
4
|
* specification (https://agentskills.io/specification). Unknown fields are
|
|
@@ -200,8 +199,8 @@ interface SkillCommandOptions {
|
|
|
200
199
|
* A same-named field of another type (e.g. a string verbosity level)
|
|
201
200
|
* doesn't trigger this — the local boolean flag stays declared. However,
|
|
202
201
|
* politty itself independently rejects that combination: when
|
|
203
|
-
* `globalArgs` and a command's own schema declare a same-named field
|
|
204
|
-
*
|
|
202
|
+
* `globalArgs` and a command's own schema declare a same-named field,
|
|
203
|
+
* `runMain`/`runCommand` throws
|
|
205
204
|
* `FieldTypeConflictError` at parse time. {@link SkillFlagOverrides} can't
|
|
206
205
|
* help here — it only renames the short alias (`-v`/`-x`), not the long
|
|
207
206
|
* `--verbose`/`--json` field name itself, so the conflicting name stays
|
|
@@ -209,15 +208,10 @@ interface SkillCommandOptions {
|
|
|
209
208
|
* `json` field must rename or remove that global field (or make it a
|
|
210
209
|
* plain boolean) instead.
|
|
211
210
|
*
|
|
212
|
-
* (
|
|
213
|
-
*
|
|
214
|
-
*
|
|
215
|
-
*
|
|
216
|
-
* fixed in politty core independently of this option — a same-named
|
|
217
|
-
* local and global field with *identical* definitions now resolves
|
|
218
|
-
* correctly regardless of position. This option still omits the local
|
|
219
|
-
* flag by default for simplicity: hosts don't need to duplicate the
|
|
220
|
-
* flag's definition on both schemas to get the expected behavior.)
|
|
211
|
+
* (This omission is required: politty rejects a field declared in both
|
|
212
|
+
* `globalArgs` and a command's own schema, even when the definitions are
|
|
213
|
+
* identical. Omitting the local flag leaves the host's global field as the
|
|
214
|
+
* only declaration.)
|
|
221
215
|
*
|
|
222
216
|
* @example
|
|
223
217
|
* ```ts
|
|
@@ -357,8 +351,6 @@ type WithSkillCommand<T extends AnyCommand> = T & {
|
|
|
357
351
|
skills: AnyCommand;
|
|
358
352
|
};
|
|
359
353
|
};
|
|
360
|
-
//#endregion
|
|
361
|
-
//#region ../core/src/skill/frontmatter.d.ts
|
|
362
354
|
/**
|
|
363
355
|
* Result of parsing a SKILL.md file.
|
|
364
356
|
*/
|
|
@@ -403,8 +395,6 @@ export declare function parseFrontmatter(content: string): {
|
|
|
403
395
|
* missing or fails schema validation.
|
|
404
396
|
*/
|
|
405
397
|
export declare function parseSkillMd(content: string): ParsedSkillMd | null;
|
|
406
|
-
//#endregion
|
|
407
|
-
//#region ../core/src/skill/installer.d.ts
|
|
408
398
|
/**
|
|
409
399
|
* Key used to read provenance off an installed skill. The SKILL.md's
|
|
410
400
|
* `metadata["politty-cli"]` must equal `"{packageName}:{cliName}"` for the
|
|
@@ -521,8 +511,6 @@ export declare function hasInstalledSkill(name: string, cwd?: string): boolean;
|
|
|
521
511
|
* Use {@link hasInstalledSkill} to distinguish the two cases.
|
|
522
512
|
*/
|
|
523
513
|
export declare function readInstalledOwnership(name: string, cwd?: string): string | null;
|
|
524
|
-
//#endregion
|
|
525
|
-
//#region ../core/src/skill/scanner.d.ts
|
|
526
514
|
/**
|
|
527
515
|
* Scan a source directory for SKILL.md files.
|
|
528
516
|
*
|
|
@@ -551,8 +539,6 @@ export declare function readInstalledOwnership(name: string, cwd?: string): stri
|
|
|
551
539
|
* ```
|
|
552
540
|
*/
|
|
553
541
|
export declare function scanSourceDir(sourceDir: string): ScanResult;
|
|
554
|
-
//#endregion
|
|
555
|
-
//#region ../core/src/skill/index.d.ts
|
|
556
542
|
/**
|
|
557
543
|
* Wrap a command with a `skills` subcommand for managing SKILL.md-based skills.
|
|
558
544
|
*
|
|
@@ -577,5 +563,4 @@ export declare function scanSourceDir(sourceDir: string): ScanResult;
|
|
|
577
563
|
* overwriting it would hide a configuration bug.
|
|
578
564
|
*/
|
|
579
565
|
export declare function withSkillCommand<T extends AnyCommand>(command: T, options: SkillCommandOptions): WithSkillCommand<T>;
|
|
580
|
-
//#endregion
|
|
581
566
|
export type { DiscoveredSkill, InstallMode, InstallSkillOptions, ParsedSkillMd, ScanError, ScanErrorReason, ScanResult, SkillCommandOptions, SkillFlagOverrides, SkillFrontmatter, UninstallSkillOptions, WithSkillCommand };
|