Function parseKnowledgeInvocation

cli/plugins/builtin_knowledge.go:210–251

parseKnowledgeInvocation accepts the JSON envelope {"cmd":..,"args":{..}}, flat JSON, and the flattened argv form. Returns the canonical (cmd, innerJSON).

(args []string)

// parseKnowledgeInvocation accepts the JSON envelope {"cmd":..,"args":{..}},
// flat JSON, and the flattened argv form. Returns the canonical (cmd, innerJSON).
func parseKnowledgeInvocation(args []string) (string, string, error) {
	payload := strings.TrimSpace(strings.Join(args, " "))

	if strings.HasPrefix(payload, "{") {
		var raw map[string]json.RawMessage
		if err := json.Unmarshal([]byte(payload), &raw); err != nil {
			return "", "", fmt.Errorf(
				`parse envelope: %w. Expected {"cmd":"search","args":{"query":"..."}}`, err,
			)
		}
		var cmdStr string
		if rc, ok := raw["cmd"]; ok {
			_ = json.Unmarshal(rc, &cmdStr)
		}
		canon := canonicalKnowledgeCmd(cmdStr)
		if canon == "" {
			return "", "", fmt.Errorf("missing or unknown cmd %q (valid: search|get|toc|list)", cmdStr)
		}
		var inner string
		if rargs, ok := raw["args"]; ok && len(rargs) > 0 {
			inner = string(rargs)
		} else {
			delete(raw, "cmd")
			b, _ := json.Marshal(raw)
			inner = string(b)
		}
		return canon, inner, nil
	}

	canon := canonicalKnowledgeCmd(args[0])
	if canon == "" {
		return "", "", fmt.Errorf(
			`expected JSON envelope or subcommand; got %q. Example: {"cmd":"search","args":{"query":"..."}}`,
			args[0],
		)
	}
	// The agent flattener delivers the {cmd,args} envelope as "--flag value"
	// pairs; numeric fields (top_k, offset) must come back as numbers, and a
	// bare positional maps onto the subcommand's primary field.
	primary := map[string]string{"search": "query", "get": "source", "toc": "prefix"}[canon]
	return canon, argvInner(args[1:], primary, nil, map[string]bool{"top_k": true, "offset": true}), nil
}

// canonicalKnowledgeCmd folds aliases into the four canonical names.
func canonicalKnowledgeCmd(s string) string {