Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func EmitCompose ¶
func EmitCompose(p *Pod, results map[string]*driver.MaterializeResult, proxies ...CllamaProxyConfig) (string, error)
EmitCompose generates a compose.generated.yml string from pod definition and driver materialization results. Output is deterministic (sorted service names).
func ParseSurface ¶
func ParseSurface(raw string) (driver.ResolvedSurface, error)
ParseSurface parses a raw surface string like "volume://research-cache read-only" into a ResolvedSurface.
Types ¶
type ClawBlock ¶
type ClawBlock struct {
Agent string
Persona string
Cllama []string
CllamaEnv map[string]string
CllamaTokens map[string]string // runtime-only: expanded service name -> token
Count int
Handles map[string]*driver.HandleInfo // platform → contact card
Include []IncludeEntry
Surfaces []driver.ResolvedSurface
Skills []string
Invoke []InvokeEntry
}
ClawBlock represents the x-claw extension on a service.
type ClawdashConfig ¶ added in v0.2.0
type ClawdashConfig struct {
Image string // e.g. ghcr.io/mostlydev/clawdash:latest
Addr string // e.g. :8082
ManifestHostPath string // host path to pod-manifest.json
DockerSockHostPath string // host path to docker socket
CllamaCostsURL string // external costs URL for operator browser
PodName string
}
type CllamaProxyConfig ¶
type CllamaProxyConfig struct {
ProxyType string // e.g. "passthrough", "policy"
Image string // e.g. ghcr.io/mostlydev/cllama:latest
ContextHostDir string // host path for shared context dir
AuthHostDir string // host path for provider auth state
DashboardPort string // host port published to proxy UI :8081 (default "8181")
Environment map[string]string // proxy-only env (e.g. CLAW_POD, provider keys)
PodName string
}
type IncludeEntry ¶ added in v0.2.0
type InvokeEntry ¶
type InvokeEntry struct {
Schedule string // 5-field cron expression
Message string // agent task payload
Name string // optional human-readable job name
To string // delivery target (name or ID; optional platform prefix "platform:target")
}
InvokeEntry is a scheduled agent task declared in the pod x-claw.invoke block.
type Pod ¶
type Pod struct {
Name string
Services map[string]*Service
Compose map[string]interface{} // preserved top-level compose keys except x-claw and services
Clawdash *ClawdashConfig // runtime-only dashboard sidecar config, injected by claw up
}
Pod represents a parsed claw-pod.yml.
type Service ¶
type Service struct {
Image string
Compose map[string]interface{} // preserved compose service keys except x-claw
Claw *ClawBlock
Environment map[string]string
Expose []string // ports exposed to other containers (from compose expose:)
Ports []string // container-side ports from compose ports: (host:container or plain container)
}
Service represents a service in a claw-pod.yml.
Click to show internal directories.
Click to hide internal directories.