Function ResolveCommand

pkg/runtime/commands.go:57–93

ResolveCommand transforms a /command into its expanded instruction text. It processes: 1. Command lookup from agent commands 2. Tool command execution (!tool_name(arg=value)) - tools executed and output inserted 3. JavaScript expressions (${...}) - evaluated with access to all agent tools and args a

(ctx context.Context, rt Runtime, userInput string)

// command has no instruction and no arguments, the result is the empty
// string, signalling "no message to send".
func ResolveCommand(ctx context.Context, rt Runtime, userInput string) string {
	command, rest, ok := LookupCommand(ctx, rt, userInput)
	if !ok {
		return userInput
	}

	instruction := command.Instruction

	// Agent-only commands (no instruction): forward the trailing args verbatim
	// so the target sub-agent receives the user's original prompt.
	if instruction == "" {
		return rest
	}

	args := tokenize(rest)

	// Execute JavaScript expressions (${...} syntax) with args array
	// We execute JS first to prevent tool output (from !tool commands) from being evaluated as JS,
	// which would be a security vulnerability (injection).
	agentTools, err := rt.CurrentAgentTools(ctx)
	if err != nil {
		slog.WarnContext(ctx, "Failed to get agent tools for JS expression execution", "error", err)
	} else {
		evaluator := js.NewEvaluator(agentTools)
		instruction = evaluator.Evaluate(ctx, instruction, args)
	}

	// Execute tool commands and substitute their output (legacy !tool() syntax)
	instruction = executeToolCommands(ctx, rt, instruction)

	// Append remaining text if no placeholders were used
	if rest != "" && !argsPlaceholderRegex.MatchString(command.Instruction) {
		instruction += " " + rest
	}

	return instruction
}

// tokenize splits input into tokens, respecting quoted strings.
// Quotes are stripped from the tokens.