{"record":{"id":"2a7fda6902d8f49f","repo":"larksuite/cli","slug":"args-field-s-arg-inline-must-be-a-struct-got","errorCode":null,"errorMessage":"Args field %s: arg:\"inline\" must be a struct, got %s","messagePattern":"Args field (.+?): arg:\"inline\" must be a struct, got (.+?)","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"shortcuts/common/typed_compile_args.go","lineNumber":117,"sourceCode":"\t\tif hasArg {\n\t\t\tswitch argMode {\n\t\t\tcase \"local\":\n\t\t\t\tif insideInline {\n\t\t\t\t\treturn fmt.Errorf(\"Args field %s: arg:\\\"local\\\" is not allowed inside inline\", field.Name)\n\t\t\t\t}\n\t\t\t\tif hasAnyTag(field, \"flag\", \"schema\", \"cli\", \"doc\", \"json\") {\n\t\t\t\t\treturn fmt.Errorf(\"Args field %s: arg:\\\"local\\\" cannot declare public input tags\", field.Name)\n\t\t\t\t}\n\t\t\tcase \"inline\":\n\t\t\t\tif insideInline {\n\t\t\t\t\treturn fmt.Errorf(\"Args field %s: nested arg:\\\"inline\\\" is not allowed\", field.Name)\n\t\t\t\t}\n\t\t\t\tinlineType := field.Type\n\t\t\t\tif inlineType.Kind() == reflect.Pointer {\n\t\t\t\t\treturn fmt.Errorf(\"Args field %s: arg:\\\"inline\\\" must be a struct value, not pointer\", field.Name)\n\t\t\t\t}\n\t\t\t\tif inlineType.Kind() != reflect.Struct {\n\t\t\t\t\treturn fmt.Errorf(\"Args field %s: arg:\\\"inline\\\" must be a struct, got %s\", field.Name, field.Type)\n\t\t\t\t}\n\t\t\t\tif hasAnyTag(field, \"flag\", \"schema\", \"cli\", \"doc\", \"json\") {\n\t\t\t\t\treturn fmt.Errorf(\"Args field %s: arg:\\\"inline\\\" cannot declare public input tags\", field.Name)\n\t\t\t\t}\n\t\t\t\tif err := collectArgFields(inlineType, index, true, out, seenGo, supplements); err != nil {\n\t\t\t\t\treturn err\n\t\t\t\t}\n\t\t\tdefault:\n\t\t\t\treturn fmt.Errorf(\"Args field %s: unknown arg mode %q\", field.Name, argMode)\n\t\t\t}\n\t\t\tcontinue\n\t\t}\n\t\tif !flagNamePattern.MatchString(flagName) {\n\t\t\treturn fmt.Errorf(\"Args field %s: flag %q is not a canonical flag name\", field.Name, flagName)\n\t\t}\n\t\tif hasAnyTag(field, \"json\") {\n\t\t\treturn fmt.Errorf(\"Args field %s (--%s): json tag is not allowed on a CLI field\", field.Name, flagName)\n\t\t}","sourceCodeStart":99,"sourceCodeEnd":135,"githubUrl":"https://github.com/larksuite/cli/blob/7fd6ef3c07182257ce776cdc5a614e122d5bd4b3/shortcuts/common/typed_compile_args.go#L99-L135","documentation":"Compile-time guard: an arg:\"inline\" field's type is not a struct, so there are no fields to flatten into the parent Args.","triggerScenarios":"Thrown at shortcuts/common/typed_compile_args.go:117 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use a struct type for the inline field, or make it a regular flag/arg"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"7fd6ef3c07182257ce776cdc5a614e122d5bd4b3","analyzedAt":"2026-09-04T21:17:44.649Z","contentChangedAt":"2026-09-04T21:17:44.649Z","schemaVersion":2},"datasetVersion":"2026-09-12T02:17:10.037Z"}