claudecode

type Activity struct {
	// Tool is the tool used, or "" for text claude wrote.
	Tool string
	// Detail is the tool's target (a file, a command) or the text.
	Detail string
}

type Credential struct {
	EnvVar string
	Value  string
}

type Options struct {
	Credential Credential
	// BaseURL is forwarded to claude when it is not Anthropic's own, so a
	// credential issued by a gateway is sent to that gateway.
	BaseURL string
	Model   string        // optional; claude's default when empty
	Timeout time.Duration // optional; no limit beyond ctx when zero
	// Tools is claude's --allowedTools list.
	Tools []string
	// Schema, when set, is passed as --json-schema and the output is claude's
	// JSON result, which ParseResult reads. Empty, the output is the answer as
	// plain text.
	Schema string
	// OnSubmitted is called with the remote command ID as soon as the exec is
	// accepted and before its output is streamed.
	OnSubmitted func(commandID string)
	// OnActivity, when set, runs claude with --output-format stream-json and
	// is called with each tool call and piece of text as claude makes it, so a
	// long run can show what it is doing. Turn.Output is the same either way.
	OnActivity func(Activity)
}

type Result struct {
	IsError          bool            `json:"is_error"`
	Subtype          string          `json:"subtype"`
	Result           string          `json:"result"`
	StructuredOutput json.RawMessage `json:"structured_output"`
}

type Stream struct {
	// contains filtered or unexported fields
}

type StreamResult struct {
	IsError bool
	// Result is claude's final text.
	Result  string
	CostUSD float64
	// Raw is the whole event, the same shape as --output-format json's
	// result, so ParseResult reads it.
	Raw string
}

type Turn struct {
	// Output is claude's stdout, trimmed: the answer, or the JSON result when
	// Options.Schema is set.
	Output   string
	Duration time.Duration
	// CostUSD is what the run cost, as claude reported it. It is known only
	// when Options.OnActivity is set, since only the streamed result is read
	// for it.
	CostUSD float64
}