The Web UI and messaging channels now read and write Archie's runtime settings through one versioned, audited control-plane API hosted on the State Store's existing gRPC server: catalog, query, command, watch. Each feature owns its resource, validation and commands; storage only writes versions and audit records. Workflows move with it. Definitions become portable YAML compiled through a closed, typed step registry and stored as a control-plane resource, so the yaegi interpretation paths (internal/gate, wfeval, wfextract, gateeval, gateextract, skillbuild) are deleted rather than carried. The UI process reads definitions as data: the JSON projection lives in internal/domain/workflow/task so a dashboard decodes the stored collection without linking the workflow engine, which cmd/archie-ui's deletion gate forbids. Shipped definitions ride the catalog descriptor rather than a bespoke REST route, keeping the API to its four operations. archie-messaging gains -state-store-target/-state-store-token and reads channel settings from the database, failing closed when the State Store is unreachable: the database is authoritative for those settings.
84 lines
3.9 KiB
Go
84 lines
3.9 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"`
|
|
}
|
|
|
|
// 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"`
|
|
}
|