clitool

type CliTool ¶

type CliTool struct {
	// Def describes the base command configuration.
	Def Definition
}

Tool exposes a configured CLI command as an invocable tool to the model. Name and description are derived from Definition. Users can provide additional argv, env, workdir, and timeout at call-time.

func (t *CliTool) Info(ctx context.Context) (*schema.ToolInfo, error)

func (t *CliTool) InvokableRun(ctx context.Context, argumentsInJSON string, _ ...tool.Option) (string, error)

type CliToolRequest ¶

type CliToolRequest struct {
	// Args are extra argv to append to the configured command.
	Args    []string `json:"args,omitempty"`
	Workdir string   `json:"workdir,omitempty"`
}

type Definition ¶

type Definition struct {
	Name    string
	Command string
	Desc    string
	Args    []string          // parsed from command
	Env     map[string]string // merged with envs from command, env map has higher precedence than envs from command.
}

Definition describes a CLI tool that can be exposed to the agent. Name must be unique across all tools. Command is executed without a shell by default via SubprocessExecutor.

func MustNewDefinition(name, command, desc string, env map[string]string) Definition

func NewDefinition(name, command, desc string, env map[string]string) (Definition, error)

type Outcome ¶

type Outcome struct {
	Ran         bool
	Command     string
	ExitCode    int
	Duration    time.Duration
	Stdout      string
	Stderr      string
	StartedAt   time.Time
	CompletedAt time.Time
}

Outcome describes the result of a subprocess execution.

func (o Outcome) String() string

type SubprocessExecutor ¶

type SubprocessExecutor struct{}

SubprocessExecutor runs commands using exec.CommandContext without a shell.

func (e *SubprocessExecutor) Execute(ctx context.Context, argv []string, env map[string]string, workdir string) Outcome