Self-hosted workflows for coding-agent delivery. Orchestrate CodeBuddy, Codex and Claude Code with scripts and human approval gates. Includes Local workflows for coding assistants.
JavaScript agent-orchestrationagentic-workflowai-agentsai-codingclaude-codecode-reviewcodebuddycodexcoding-agentscursordeveloper-toolshuman-on-the-loopllmmcpmulti-agentsdlcself-hostedsopworkflow-automationworkflow-engine
package runtime
import (
"context"
"io"
"os"
"path/filepath"
"strconv"
"strings"
"time"
"agentflow/internal/domain"
)
type EventSink func(event domain.TelemetryEvent)
type CredentialBinding string
const (
BindCodeBuddy CredentialBinding = "codebuddy"
BindCodex CredentialBinding = "codex"
BindClaudeCode CredentialBinding = "claude-code"
BindGit CredentialBinding = "git"
BindMCP CredentialBinding = "mcp"
// BindAgentCLI injects the responsible user's key for the command's agent
// CLI and writes that CLI's model configuration into its private HOME.
BindAgentCLI CredentialBinding = "agent-cli"
// BindGitWorkspace gives a conversation workspace CLI the requester's Git
// credentials for any repository it clones itself: Git's credential helper
// and the gh/glab wrappers fetch the token of the exact HTTPS host from the
// session gateway while the turn runs, and SSH uses the requester's keys
// per configured host without exposing them.
BindGitWorkspace CredentialBinding = "git-workspace"
// BindExtra exports credentials from RunCredentials.Extra into the
// environment names listed in CommandSpec.ExtraCredentialEnv. Empty values
// are exported as empty strings so a child never inherits the host
// process's own variables.
BindExtra CredentialBinding = "extra"
)
type CodeBuddyCredential struct {
APIKey string
InternetEnvironment string
// Sponsored is set when the responsible user has no key of their own and
// the platform's shared key is used; such runs are limited to
// SponsoredModels (the default first).
Sponsored bool
SponsoredModels []string
}
// RunCredentials lives only on the in-memory run sandbox handle. It is never
// serialized into domain objects, run-context.json, or workspace files.
type RunCredentials struct {
CodeBuddy CodeBuddyCredential
Codex ProviderCredential
ClaudeCode ProviderCredential
AgentCLI map[string]ProviderCredential
GitSSHKeys map[string]string `json:"-"`
// GitSSHHostKeys maps "host:port" to the requester's private key for a
// conversation workspace. It travels to the execution machine on the
// authenticated control connection only, in the start request of the CLI.
GitSSHHostKeys map[string]string `json:",omitempty"`
// GitHTTPHosts maps each HTTPS host the requester exposes to a workspace
// to its platform. It holds no tokens; the helper asks for them per host.
GitHTTPHosts map[string]string `json:",omitempty"`
// GitHTTPCredentials travels only on authenticated execution dispatches.
// SOP commands fetch a matching, exposed credential from an ephemeral relay.
GitHTTPCredentials map[string]domain.GitHTTPExecutionCredential `json:",omitempty"`
GitUserName string
GitUserEmail string
MCPServers []domain.MCPServerDefinition
// Extra carries deployment-registered credentials (see
// RegisterExtraCredentialSource). Like GitSSHKeys it lives only on the
// in-memory sandbox handle and is never serialized into domain objects,
// run-context.json, or workspace files.
Extra map[string]string `json:"-"`
}
type ProviderCredential struct {
APIKey string
BaseURL string
Protocol string
// Models is the user's saved model catalog for an agent CLI; Cursor
// resolves folded families from it (CursorModelID).
Models []domain.CLIModel
}
type InvocationOptions struct {
RunID string
NodeID string
ResumeSessionID string
GateResultPath string
Repositories []domain.RepositoryContext
RunnerLogin bool
// BrowserMCP is resolved on the executing host, never sent to a runner.
BrowserMCP *domain.MCPServerDefinition `json:"-"`
}
// CommandSpec is the closed process-launch contract between providers/engine
// and a sandbox. Callers can request known credential bindings and runtime
// features, but cannot supply arbitrary environment variables.
type CommandSpec struct {
// WorkingDir and OwnProcessGroup are used by durable conversation processes.
// The cwd is mounted at the same absolute path in host and Docker modes.
WorkingDir string
OwnProcessGroup bool
Argv []string
Provider string
CredentialBindings []CredentialBinding
PrivateHome bool
// PrivateHomeKey names the private HOME directory; empty uses Provider.
// Agent CLIs keep one HOME per Agent because their MCP configuration
// lives there.
PrivateHomeKey string
// AgentCLI is what BindAgentCLI needs besides the credential.
AgentCLI AgentCLIOptions
HookOutput string
Telemetry *InvocationOptions
// ExtraCredentialEnv maps environment variable names to keys in
// RunCredentials.Extra and takes effect only together with the BindExtra
// credential binding. Empty or missing credentials export as empty
// strings, clearing any value inherited from the host process.
ExtraCredentialEnv map[string]string
// credentialEnvKeys records the environment variable names populated from
// Extra credentials (set by bindCommand) so process telemetry can redact
// them by origin instead of relying on naming conventions.
credentialEnvKeys []string
// Stdin is forwarded by local, Docker and remote conversation execution.
Stdin io.Reader
environment map[string]string
// privateBinds are host directories bwrap binds into this one process
// only (for example a terminal's own SSH agent).
privateBinds []string
// Conversation preparation binds credentials before acknowledging start.
bindingsPrepared bool
// Runner-owned authentication state never enters serialized invocations.
runnerLogin *runnerLoginLease
runnerLoginPrompt string
runnerLoginInitialize bool
}
// WithPrivateHomeDir keeps CodeBuddy/Claude isolated from the operator HOME
// while reusing a durable directory so --resume can see prior transcripts.
func (c CommandSpec) WithPrivateHomeDir(dir string) CommandSpec {
dir = strings.TrimSpace(dir)
if dir == "" {
return c
}
env := make(map[string]string, len(c.environment)+2)
for key, value := range c.environment {
env[key] = value
}
env["HOME"] = dir
env["TMPDIR"] = filepath.Join(dir, "tmp")
_ = os.MkdirAll(env["TMPDIR"], 0o700)
if c.Provider == "codex" {
env["CODEX_HOME"] = filepath.Join(dir, ".codex")
_ = os.MkdirAll(env["CODEX_HOME"], 0o700)
}
if c.Provider == "claude-code" {
env["CLAUDE_CONFIG_DIR"] = filepath.Join(dir, ".claude")
_ = os.MkdirAll(env["CLAUDE_CONFIG_DIR"], 0o700)
}
if c.Provider == "codebuddy" {
env["CODEBUDDY_CONFIG_DIR"] = filepath.Join(dir, ".codebuddy")
_ = os.MkdirAll(env["CODEBUDDY_CONFIG_DIR"], 0o700)
}
c.environment = env
c.PrivateHome = false
return c
}
// WithClaudeBypassAccepted lets a Claude Code command that passes
// --permission-mode bypassPermissions start when the host runs it as root.
// The caller's tool policy is what limits the process.
func (c CommandSpec) WithClaudeBypassAccepted() CommandSpec {
if c.Provider != "claude-code" {
return c
}
env := make(map[string]string, len(c.environment)+1)
for key, value := range c.environment {
env[key] = value
}
env["IS_SANDBOX"] = "1"
c.environment = env
return c
}
// WithMCPStartupWait lets a CodeBuddy -p process wait up to timeout for MCP
// servers that expose always-loaded tools before its first model request.
// The headless default is about 2s; a server that connects later is missing
// from that request's tool list, and its non-deferred tools are not in the
// ToolSearch index either. The wait returns as soon as those servers settle.
func (c CommandSpec) WithMCPStartupWait(timeout time.Duration) CommandSpec {
if c.Provider != "codebuddy" || timeout <= 0 {
return c
}
env := make(map[string]string, len(c.environment)+1)
for key, value := range c.environment {
env[key] = value
}
env[codeBuddyMCPStartupWaitEnv] = strconv.FormatInt(timeout.Milliseconds(), 10)
c.environment = env
return c
}
const codeBuddyMCPStartupWaitEnv = "CODEBUDDY_FIRST_RUN_MCP_PREWAIT_TIMEOUT_MS"
type Sandbox interface {
ID() string
Workspace() string
Exec(ctx context.Context, command CommandSpec, sink EventSink) (string, error)
Close(ctx context.Context) error
}