Function parseMemoryInvocation

cli/plugins/builtin_memory.go:294–337

parseMemoryInvocation accepts the JSON envelope {"cmd":..,"args":{..}}, flat JSON {"cmd":..,"content":..}, and the flattened argv form the agent tool sanitizer may produce. Returns the canonical (cmd, innerJSON).

(args []string)

// flat JSON {"cmd":..,"content":..}, and the flattened argv form the agent
// tool sanitizer may produce. Returns the canonical (cmd, innerJSON).
func parseMemoryInvocation(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":"remember","args":{"content":"..."}}`, err,
			)
		}
		var cmdStr string
		if rc, ok := raw["cmd"]; ok {
			_ = json.Unmarshal(rc, &cmdStr)
		}
		canon := canonicalMemoryCmd(cmdStr)
		if canon == "" {
			return "", "", fmt.Errorf(
				"missing or unknown cmd %q (valid: remember|profile|forget|recall|neighbors|map)", 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 := canonicalMemoryCmd(args[0])
	if canon == "" {
		return "", "", fmt.Errorf(
			`expected JSON envelope or subcommand; got %q. Example: {"cmd":"remember","args":{"content":"..."}}`,
			args[0],
		)
	}
	inner, err := memoryFlagsToJSON(args[1:])
	if err != nil {
		return "", "", err
	}
	return canon, inner, nil
}

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