Versions in this module Expand all Collapse all v1 v1.0.90 Aug 25, 2026 Changes in this version + const AliasCanonicalWins + const AliasErrorIfBoth + const AliasIndependent + const AliasNormalize + const AliasTrimmedEqualOrError + const IdentityBot + const IdentityUser + const PresenceExplicit + const PresenceNonZero + const RelationAtLeastOne + const RelationCoOccur + const RelationConflicts + const RelationExactlyOne + const RelationRequires + const RiskHighRiskWrite + const RiskRead + const RiskWrite + const StageAfterPrepare + const StageSourcePreRun + func CallJSON[T any](ctx context.Context, command CommandContext, request Request) (T, error) + func CollectAllPages[T any](ctx context.Context, command CommandContext, request Request) ([]T, error) + func InternalErrorf(format string, args ...any) *errs.InternalError + func InvalidResponseErrorf(format string, args ...any) *errs.InternalError + func PaginationInterruptedError(cause error) *errs.NetworkError + func PaginationLimitError(pages int, nextToken string) *errs.InternalError + func PathSegment(s string) string + func PreflightScopes(command CommandContext, scopes ...string) error + func ValidateHostResult(definition HostDefinition, result HostResult) error + func ValidateRequestView(request RequestView) error + func ValidationErrorf(format string, args ...any) *errs.ValidationError + type AliasConflictPolicy string + type ArrayShape struct + Items ValueShape + MaxItems *int + MinItems *int + type Artifact struct + ContentType string + Location string + Name string + Size int64 + func Download(ctx context.Context, command CommandContext, request Request, ...) (Artifact, error) + func DownloadURL(ctx context.Context, command CommandContext, rawURL string, target FileTarget, ...) (Artifact, error) + type AuthorizationDefinition struct + Identities map[Identity]IdentityAuthorization + IdentityOrder []Identity + type BooleanShape struct + Enum []bool + type CLIEncoding string + const EncodingCommaOrRepeated + const EncodingJSON + const EncodingRepeated + type CLIInput struct + Aliases []FlagAlias + Deprecated string + Encoding CLIEncoding + Hidden bool + ValueSources []ValueSource + type Command struct + func Define[Args any, Data any](definition Definition[Args, Data]) Command + type CommandContext struct + func NewCommandContext(options ContextOptions) CommandContext + func (c CommandContext) Identity() Identity + type CommandMetadata struct + Authorization AuthorizationDefinition + Command string + Description string + Hidden bool + Risk Risk + Service DomainName + type ConditionalScope struct + Params []string + Requirement ScopeRequirement + Scopes []string + When string + type ConstShape struct + Value JSONValue + type ContextOptions struct + CallJSON func(context.Context, Request) (map[string]any, error) + CollectPages func(context.Context, Request, bool) ([]map[string]any, HostPagination, error) + Download func(context.Context, Request, FileTarget, DownloadOptions) (Artifact, error) + DownloadURL func(context.Context, string, FileTarget, DownloadOptions) (Artifact, error) + DryRun bool + Identity Identity + InputStage bool + PreflightScopes func(...string) error + type DataDefinition struct + Overrides []DataField + Shape ValueShape + type DataField struct + Description string + Path string + Shape ValueShape + type Definition struct + Hooks Hooks[Args, Data] + Input InputDefinition + Metadata CommandMetadata + Output OutputDefinition + type Domain struct + func ExtendDomain(name DomainName) Domain + type DomainName string + const DomainApplication + const DomainApproval + const DomainApps + const DomainAttendance + const DomainBase + const DomainCalendar + const DomainContact + const DomainDocs + const DomainDrive + const DomainEvent + const DomainIm + const DomainMail + const DomainMarkdown + const DomainMindnotes + const DomainMinutes + const DomainNote + const DomainOkr + const DomainSheets + const DomainSlides + const DomainTask + const DomainVc + const DomainWhiteboard + const DomainWiki + type DownloadOptions struct + Representation download.Representation + Transfer download.Options + type DryRun struct + func NewDryRun(requests ...Request) *DryRun + func (d *DryRun) Add(request Request) *DryRun + func (d *DryRun) Body(body any) *DryRun + func (d *DryRun) DELETE(apiPath string) *DryRun + func (d *DryRun) Desc(description string) *DryRun + func (d *DryRun) File(intent FileIntent) *DryRun + func (d *DryRun) GET(apiPath string) *DryRun + func (d *DryRun) PATCH(apiPath string) *DryRun + func (d *DryRun) POST(apiPath string) *DryRun + func (d *DryRun) PUT(apiPath string) *DryRun + func (d *DryRun) Params(params map[string]any) *DryRun + func (d *DryRun) Set(name string, value any) *DryRun + type DryRunView struct + Description string + Files []FileIntent + Requests []RequestView + func InspectDryRun(dryRun *DryRun) DryRunView + type Failure struct + Code int + Hint string + LogID string + Message string + Retryable bool + Subtype string + Type string + func SnapshotFailure(err error) Failure + type FileIntent struct + Content string + IfExists IfExistsPolicy + Name string + type FileTarget struct + IfExists IfExistsPolicy + Name string + func (t FileTarget) Intent(content string) FileIntent + type FlagAlias struct + Conflict AliasConflictPolicy + Deprecated bool + Hidden bool + Mode FlagAliasMode + Name string + type FlagAliasMode string + type Hooks struct + DryRun func(context.Context, CommandContext, *Args) *DryRun + Execute func(context.Context, CommandContext, *Args) (Result[Data], error) + Normalize func(context.Context, CommandContext, *Args) error + PrettyRenderer Renderer[Data] + Validate func(context.Context, CommandContext, *Args) error + type HostDefinition struct + ArgsType reflect.Type + DataType reflect.Type + Hooks HostHooks + Input InputDefinition + Metadata CommandMetadata + NewArgs func() any + Output OutputDefinition + PageOutput bool + func InspectCommand(command Command) HostDefinition + type HostDomain struct + Name string + func InspectDomain(domain Domain) HostDomain + type HostHooks struct + DryRun func(context.Context, CommandContext, any) *DryRun + Execute func(context.Context, CommandContext, any) (HostResult, error) + Normalize func(context.Context, CommandContext, any) error + Renderers map[string]func(io.Writer, any) error + Validate func(context.Context, CommandContext, any) error + type HostPagination struct + Complete bool + Items int + NextToken string + Pages int + type HostResult struct + Data any + Outcome string + Pagination *HostPagination + type Identity string + type IdentityAuthorization struct + ConditionalScopes []ConditionalScope + RequiredScopes []string + type IfExistsPolicy string + const IfExistsFail + const IfExistsOverwrite + type InputDefault struct + Set bool + Value JSONValue + type InputDefinition struct + Fields []InputField + Relations []Relation + type InputField struct + CLI CLIInput + Default InputDefault + Description string + Name string + Shape ValueShape + type IntegerShape struct + Enum []int64 + Maximum *int64 + Minimum *int64 + type JSONValue = any + type NullShape struct + type NumberShape struct + Enum []float64 + Maximum *float64 + Minimum *float64 + type ObjectShape struct + AdditionalProperties bool + AdditionalPropertiesShape ValueShape + Fields []ValueField + type OneOfShape struct + Variants []ValueShape + type OutputDefinition struct + Data DataDefinition + DisableHTMLEscaping bool + Meta ResultMetaDefinition + Mode OutputMode + type OutputMode string + const OutputFixedJSON + const OutputGeneric + type Page struct + Items []T + func CollectPages[T any](ctx context.Context, command CommandContext, request Request) (Page[T], error) + func (p Page[T]) Complete() bool + func (p Page[T]) NextToken() string + func (p Page[T]) Pages() int + type PaginationOptions struct + All bool + Delay time.Duration + MaxPages int + type PresenceMode string + type Provided struct + Set bool + Value T + type Relation struct + Kind RelationKind + Params []string + Presence PresenceMode + Stage RelationStage + type RelationKind string + type RelationStage string + type Renderer func(io.Writer, Data) error + type Request struct + func DELETE(apiPath string) Request + func GET(apiPath string) Request + func PATCH(apiPath string) Request + func POST(apiPath string) Request + func PUT(apiPath string) Request + func (r Request) Body(body any) Request + func (r Request) Desc(description string) Request + func (r Request) Params(params map[string]any) Request + func (r Request) Set(name string, value any) Request + type RequestView struct + Body any + Description string + Method string + Path string + Query map[string]any + func InspectRequest(request Request) RequestView + type Result struct + func Success[Data any](data Data) Result[Data] + type ResultMetaDefinition struct + Pagination bool + type Risk string + type ScopeRequirement string + const ScopeBestEffort + const ScopeRequired + type Set struct + Commands []Command + Domain Domain + func CloneSets(sets []Set) []Set + type StringShape struct + Enum []string + Format string + MaxLength *int + MinLength *int + type ValueField struct + Description string + Name string + Required bool + Shape ValueShape + type ValueShape interface + type ValueSource string + const SourceFile + const SourceFlag + const SourceStdin