vigiles API reference
    Preparing search index...

    Interface ServiceSpecExperimental

    A disposable service the agent's task may act against — declared per arm/spec on the (future) services eval option.

    interface ServiceSpec {
        env?: Readonly<Record<string, string>>;
        image: string;
        port?: number;
        ready?: ServiceReady;
        reset?: ServiceReset;
        seed?: string;
    }
    Index

    Properties

    env?: Readonly<Record<string, string>>

    Environment for the container (e.g. POSTGRES_PASSWORD).

    image: string

    Container image, e.g. "postgres:16" or "redis:7".

    port?: number

    The port to publish + reach — the one ServiceHandle.port reports and endpoints lists. v0 supports a SINGLE port (the common disposable-service case: a DB, a cache); multi-port publishing is deferred rather than half-done (a declared-but-unexposed secondary port would be a misleading state).

    ready?: ServiceReady

    Readiness gate — start() resolves only once this passes.

    reset?: ServiceReset

    Provisioning cadence — ServiceReset. Defaults to "per-trial".

    seed?: string

    A one-shot command run INSIDE the fresh container after it is ready and before the agent runs — e.g. "psql -U postgres -d app -f schema.sql". Its output is recorded once; it is NOT model-synthesized.