// Package taskrun defines the wire format for handing an entire task off // from archied to archie-agent in one NATS round trip. // archie-agent runs workflow.Route and workflow.Run itself; archied's role // shrinks to worktree prepare, container acquire/release, and answering // the forgerpc/worktreerpc calls archie-agent proxies back. Agent store // calls go over gRPC to the State Store, not through this NATS handoff. package taskrun import ( "errors" "fmt" "github.com/samcharles93/archie-core/internal/agentexec" "github.com/samcharles93/archie-core/internal/config" "github.com/samcharles93/archie-core/internal/domain/workflow" ) // Request carries everything archie-agent needs to run a task's entire // workflow itself: the task row (already claimed by archied), the repo's // gate/ecosystem config, a non-secret config snapshot, and LLM provider // config (API keys are injected into the container's environment // separately -- Providers only carries class/env-var-name/base-URL). type Request struct { Task *workflow.Task `json:"task"` Repo config.Repo `json:"repo"` Cfg config.TaskConfig `json:"cfg"` Providers map[string]agentexec.Provider `json:"providers"` // MCPServers carries MCP server definitions so the agent can construct // transports, discover tools, and register them locally. Absent/empty // means no MCP servers (backward compatible). MCPServers []config.MCPServer `json:"mcp_servers,omitempty"` // KindWorkflows and LabelWorkflows carry the resolved kind/label -> // workflow-name bindings the daemon loaded from WorkflowRoutingFile, // WorkflowLabelsFile and PlaybookDirs. workflow.Route runs in the // archie-agent process, not the daemon, so these resolved values must // cross the process boundary here; nil means use the built-in defaults // (backward compatible). KindWorkflows workflow.KindWorkflows `json:"kind_workflows,omitempty"` LabelWorkflows workflow.LabelWorkflows `json:"label_workflows,omitempty"` // WorktreeGrant is an opaque, per-dispatch capability authorizing the // daemon to publish this task's already-prepared branch. Repository // coordinates never cross back from the sandbox as authority. WorktreeGrant string `json:"worktree_grant,omitempty"` // WorkflowDefinition is the exact YAML pinned on Task before dispatch. WorkflowDefinition string `json:"workflow_definition"` } // Validate rejects a full-task request that cannot be correlated to a real // task. Transport-specific subject correlation is enforced by the adapter. func (r Request) Validate() error { if r.Task == nil { return errors.New("task is required") } if r.Task.ID <= 0 { return fmt.Errorf("task ID must be positive, got %d", r.Task.ID) } if r.WorktreeGrant == "" { return errors.New("worktree grant is required") } if r.WorkflowDefinition == "" { return errors.New("workflow definition is required") } return nil } // Response reports the task's final state after archie-agent runs its // workflow. Task carries the last-known field values for logging; the // authoritative state already landed in the State Store via the agent's // gRPC store calls made during the run. type Response struct { Task *workflow.Task `json:"task"` Status string `json:"status"` Error string `json:"error,omitempty"` // AgentVersion and AgentInstallType report the build of archie-agent // that actually ran this task -- self-reported by the worker, not the // version archied's release pipeline expected to be running. Every // archie-agent process is task-scoped and ephemeral, so this response // is the only channel the daemon has to observe what is really in // service; see daemon.AgentStatus. Empty AgentVersion means an // unstamped build ("dev") or a worker older than this field. AgentVersion string `json:"agent_version,omitempty"` AgentInstallType string `json:"agent_install_type,omitempty"` }