Workflow definitions declare inputs, repository (none, optional or required; default required) and profile. A binding assigns each input from a mapped parameter or a constant and may take its repository from a parameter, which must name a configured repo; both are checked when the binding is saved and again at dispatch. Inputs travel as structured task data (tasks.inputs, the task brief, and a JSON block in the agent's mission), never as body text. A task with no repository runs in a per-task scratch workspace with no clone and no publication grant. The agent.run step runs one mission without a repository and finishes the task in the new completed status. Agent profiles live under [containers.profiles.<name>]: an image and an allowlist over the tools archie adds (MCP, scripts, plugins). [containers].image is the default profile; an unconfigured profile parks the task. The workflow is now pinned before the container starts so the profile can choose its image. Also stop two archied tests writing embedded NATS state into the package directory, refuse an empty state_dir for embedded NATS, and drop the NATS store files an earlier lane commit tracked.
86 lines
4.0 KiB
Go
86 lines
4.0 KiB
Go
// 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"`
|
|
// Tools is the agent profile's tool allowlist; empty allows every tool.
|
|
Tools []string `json:"tools,omitempty"`
|
|
}
|
|
|
|
// 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 == "" && r.Task.HasRepository() {
|
|
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"`
|
|
}
|