specialist

type BackgroundManagerFunc func() (*background.Manager, error)

type BuildArgsInput struct {
	Manifest              Manifest
	Prompt                string
	ParentSessionID       string
	ParentToolUseID       string
	ParentModel           string
	ParentReasoningEffort string
	CurrentDepth          int
	Description           string
	Cwd                   string
	// PermissionMode is the parent's resolved permission mode. Only an explicit
	// unsafe mode runs the child at "--auto high"; empty or any other value is
	// fail-safe "low", so a caller that forgets to wire it never escalates the
	// child to unsafe. Authority is therefore never widened beyond the parent.
	PermissionMode string
	// MemberAutonomy marks a headless swarm member: when set and the parent is
	// non-unsafe, the child runs at "--auto member" (PermissionModeMemberAuto) so
	// it can write/edit + run sandboxed shell IN the workspace, instead of the
	// read-only "--auto low". Off by default, so the Task tool's specialists are
	// unchanged. The sandbox still confines writes to the workspace root.
	MemberAutonomy bool
}

type BuildArgsResult struct {
	Args      []string
	SessionID string
	// PromptFile is created for large prompts; callers own cleanup after exec finishes.
	PromptFile string
}

type BuildResumeArgsInput struct {
	SessionID      string
	Prompt         string
	CurrentDepth   int
	Manifest       Manifest
	Cwd            string
	PermissionMode string
}

type ChildRunResult struct {
	Events   []streamjson.Event
	Stderr   string
	ExitCode int
	// Signal is a human-readable description (e.g. "signal: killed") when the child
	// was terminated by a signal rather than exiting normally; empty otherwise. It
	// turns an opaque exit -1 into an actionable reason (SIGKILL ~ out of memory).
	Signal  string
	Started bool
}

type CreateInput struct {
	Name            string
	Description     string
	SystemPrompt    string
	Extends         string
	Model           string
	ReasoningEffort string
	Tools           []string
	Location        Location
	Overwrite       bool
}

type DeleteInput struct {
	Name     string
	Location Location
}

type ExecResult struct {
	Result    tools.Result
	SessionID string
}

type Executor struct {
	NewSessionID          NewSessionIDFunc
	WritePromptFile       WritePromptFileFunc
	PromptFileMaxSize     int
	Load                  LoadFunc
	RunChild              RunChildFunc
	LaunchBackground      LaunchBackgroundFunc
	BinaryPath            string
	Paths                 Paths
	SessionStore          *sessions.Store
	BackgroundManager     *background.Manager
	BackgroundManagerFunc BackgroundManagerFunc
	BackgroundRuntime     *Runtime
}

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

type LaunchBackgroundFunc func(binaryPath string, args []string, outputFile string, onExit func(exitCode int)) (int, error)

type LoadFunc func(LoadOptions) (LoadResult, error)

type LoadOptions struct {
	Paths Paths
}

type LoadResult struct {
	Paths       Paths      `json:"paths"`
	Specialists []Manifest `json:"specialists"`
	Warnings    []string   `json:"warnings,omitempty"`
}

type Location string

type Manifest struct {
	Metadata      Metadata  `json:"metadata"`
	SystemPrompt  string    `json:"systemPrompt"`
	ResolvedTools []string  `json:"resolvedTools,omitempty"`
	Location      Location  `json:"location"`
	FilePath      string    `json:"filePath"`
	LastModified  time.Time `json:"lastModified,omitempty"`
	Warnings      []string  `json:"warnings,omitempty"`
}

type Metadata struct {
	Name            string   `json:"name"`
	Description     string   `json:"description"`
	Extends         string   `json:"extends,omitempty"`
	Model           string   `json:"model,omitempty"`
	ReasoningEffort string   `json:"reasoningEffort,omitempty"`
	Tools           []string `json:"tools,omitempty"`
}

type NewSessionIDFunc func() (string, error)

type OutputTool struct {
	SessionStore   *sessions.Store
	PollInterval   time.Duration
	DefaultTimeout time.Duration
	MaxTimeout     time.Duration
	// contains filtered or unexported fields
}

type Paths struct {
	UserDir    string `json:"userDir"`
	ProjectDir string `json:"projectDir,omitempty"`
}

type RunChildFunc func(ctx context.Context, binaryPath string, args []string, progress func(streamjson.Event)) (ChildRunResult, error)

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

type RuntimeOptions struct {
	Manager     *background.Manager
	ManagerFunc BackgroundManagerFunc
}

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

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

type StreamResult struct {
	Events    []streamjson.Event
	RunID     string
	SessionID string
	Text      string
	Tools     []string
	Errors    []string
	Status    string
	ExitCode  int
	Usage     StreamUsage
}

type StreamUsage struct {
	PromptTokens     int
	CompletionTokens int
	TotalTokens      int
	Events           int
}

type Summary struct {
	Name            string   `json:"name"`
	Description     string   `json:"description"`
	Extends         string   `json:"extends,omitempty"`
	Model           string   `json:"model,omitempty"`
	ReasoningEffort string   `json:"reasoningEffort,omitempty"`
	Tools           []string `json:"tools,omitempty"`
	ResolvedTools   []string `json:"resolvedTools,omitempty"`
	Location        Location `json:"location"`
	FilePath        string   `json:"filePath"`
	Warnings        []string `json:"warnings,omitempty"`
}

type TaskParameters struct {
	Name            string
	Prompt          string
	Description     string
	RunInBackground bool
	Resume          string
	// Manifest, when non-nil, supplies the specialist definition inline instead
	// of resolving Name against the specialist registry. It is validated before
	// use. The swarm launcher sets this so a swarm member can run from its own
	// agent definition (e.g. "subagent"/"teammate"), which is not a registered
	// specialist and would otherwise fail the name lookup.
	Manifest *Manifest
}

type TaskRunOptions struct {
	ToolCallID            string
	ParentSessionID       string
	ParentModel           string
	ParentReasoningEffort string
	CurrentDepth          int
	Cwd                   string
	// PermissionMode propagates the parent's resolved permission mode to the
	// child. Only an explicit unsafe mode runs the child unsafe; empty or any
	// other value is fail-safe "low", so the child never gains more authority
	// than the parent.
	PermissionMode string
	// MemberAutonomy marks a headless swarm member so it can write/edit + run
	// sandboxed shell in the workspace (see BuildArgsInput.MemberAutonomy). Off
	// for Task-tool specialists.
	MemberAutonomy bool
	// Progress, when set, is called with each stream-json event emitted by the
	// child process while it runs. nil is a no-op.
	Progress func(streamjson.Event)
}

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

type WritePromptFileFunc func(prompt string) (string, error)