providercli

Oct 31, 2026

Changes in this version

+ const FamilyCursor

type CredentialSourceFamily

+ const CredentialSourceAgy

+ const CredentialSourceCursor

type RuntimeDefinition

+ func (d RuntimeDefinition) AgyModel() string

+ func (d RuntimeDefinition) AgyReasoningEffort() string

+ func (d RuntimeDefinition) AgySettingsIdentity() string

Sep 28, 2026

Changes in this version

type RuntimeDefinition

+ func (d RuntimeDefinition) ZCodeModel() string

+ func (d RuntimeDefinition) ZCodeReasoningEffort() string

Sep 21, 2026

Changes in this version

type RuntimeDefinition

+ func (d RuntimeDefinition) GrokModel() string

+ func (d RuntimeDefinition) GrokReasoningEffort() string

+ func (d RuntimeDefinition) GrokSettingsIdentity() string

Sep 19, 2026

Changes in this version

+ const FamilyGrok

+ func NewCredentialProjectingNamespaceFactoryWithProjectRoot(base ports.ProviderNamespaceFactory, runtimeHome, projectRoot string, ...) (ports.ProviderNamespaceFactory, error) — darwin/amd64

+ func NewCredentialProjectingNamespaceFactoryWithProjectRoot(ports.ProviderNamespaceFactory, string, string, ...) (ports.ProviderNamespaceFactory, error) — js/wasm, linux/amd64, windows/amd64

type CredentialSourceFamily

+ const CredentialSourceGrok

type RuntimeDefinition

+ func (d RuntimeDefinition) ApplicationMetadata() string

+ func (d RuntimeDefinition) ApplicationMetadataSHA256() string

+ func (d RuntimeDefinition) ApplicationVersion() string

+ func (d RuntimeDefinition) ZCodeProviderConfig() string

+ func (d RuntimeDefinition) ZCodeProviderConfigSHA256() string

Aug 24, 2026

Changes in this version

type AGYExecutionPolicy

+ func (policy AGYExecutionPolicy) PacketIdentity() ports.ProviderPacketIdentity

Aug 15, 2026

Changes in this version

+ const FamilyCodex

type CredentialSourceFamily

+ const CredentialSourceCodex

type RuntimeDefinition

+ func NewProductionCodexRuntimeDefinitionWithTransportAndSafetyPolicy(family, instance, version, executable, executableSHA256, launcher, ... string, ...) (RuntimeDefinition, error)

+ func (d RuntimeDefinition) CodexModel() string

+ func (d RuntimeDefinition) CodexReasoningEffort() string

Aug 8, 2026

Changes in this version

+ func DeriveEquivalentRouteDirectExecutionAuthority(source ports.ProviderDirectExecutionAuthority, ...) (ports.ProviderDirectExecutionAuthority, error)

type QualificationProbeAdapter

+ func (adapter *QualificationProbeAdapter) DeriveEquivalentRouteDirectExecutionAuthority(source ports.ProviderDirectExecutionAuthority, ...) (ports.ProviderDirectExecutionAuthority, error)

type Registry

+ func (r *Registry) ProviderOutputStagingDestination(providerInstance string, attemptID domain.AttemptID, ...) (ports.StagedOutputDestination, ports.ProviderOutputTransport, bool)

Jul 29, 2026

Changes in this version

+ const FamilyAgy

+ const FamilyKimi

+ const FamilyZcode

+ func NamespaceFromConstructionError(err error) (*namespaceLease, bool)

+ func NewCredentialProjectingNamespaceFactory(base ports.ProviderNamespaceFactory, runtimeHome string, ...) (ports.ProviderNamespaceFactory, error) — darwin/amd64

+ func NewCredentialProjectingNamespaceFactory(ports.ProviderNamespaceFactory, string, map[string]CredentialSourceFamily) (ports.ProviderNamespaceFactory, error) — js/wasm, linux/amd64, windows/amd64

+ func NewCredentialProjectingNamespaceFactoryWithConfiguredSourceRoots(base ports.ProviderNamespaceFactory, runtimeHome string, ...) (ports.ProviderNamespaceFactory, error) — darwin/amd64

+ func NewCredentialProjectingNamespaceFactoryWithConfiguredSourceRoots(ports.ProviderNamespaceFactory, string, map[string]CredentialSourceFamily, ...) (ports.ProviderNamespaceFactory, error) — js/wasm, linux/amd64, windows/amd64

+ func NewCredentialProjectingNamespaceFactoryWithPolicies(base ports.ProviderNamespaceFactory, runtimeHome string, ...) (ports.ProviderNamespaceFactory, error) — darwin/amd64

+ func NewCredentialProjectingNamespaceFactoryWithPolicies(ports.ProviderNamespaceFactory, string, map[string]CredentialSourceFamily, ...) (ports.ProviderNamespaceFactory, error) — js/wasm, linux/amd64, windows/amd64

+ func NewCredentialProjectingNamespaceFactoryWithPoliciesAndNativeHomes(base ports.ProviderNamespaceFactory, runtimeHome string, ...) (ports.ProviderNamespaceFactory, error) — darwin/amd64

+ func NewCredentialProjectingNamespaceFactoryWithPoliciesAndNativeHomes(ports.ProviderNamespaceFactory, string, map[string]CredentialSourceFamily, ...) (ports.ProviderNamespaceFactory, error) — js/wasm, linux/amd64, windows/amd64

+ func VersionAtLeast(value string, wantMajor, wantMinor, wantPatch int) bool

+ type AGYExecutionPolicy struct

+ func NewAGYExecutionPolicy(definition RuntimeDefinition, snapshot ports.WorkspaceSnapshotIdentity, ...) (AGYExecutionPolicy, error)

+ func (policy AGYExecutionPolicy) Argv() []string

+ func (policy AGYExecutionPolicy) ArgvSHA256() string

+ func (policy AGYExecutionPolicy) Identity() string

+ func (policy AGYExecutionPolicy) NativeReference() string

+ func (policy AGYExecutionPolicy) SnapshotIdentity() ports.WorkspaceSnapshotIdentity

+ func (policy AGYExecutionPolicy) Validate() error

+ type CredentialSourceFamily string

+ const CredentialSourceAGY

+ const CredentialSourceKimi

+ const CredentialSourceZCode

+ type CurrentProbe struct

+ func NewCurrentProbe(runner ports.ProcessRunner, verifier SpawnVerifier) (*CurrentProbe, error)

+ func (probe *CurrentProbe) QualifyCurrent(ctx context.Context, request CurrentProbeRequest) (CurrentProbeResult, error)

+ type CurrentProbeDirectExecutionAuthorityReceipt struct

+ func (receipt CurrentProbeDirectExecutionAuthorityReceipt) AGYControlAuthorityID() (string, bool)

+ func (receipt CurrentProbeDirectExecutionAuthorityReceipt) AuthorityID() string

+ func (receipt CurrentProbeDirectExecutionAuthorityReceipt) ExpiresAt() time.Time

+ func (receipt CurrentProbeDirectExecutionAuthorityReceipt) Matches(candidate ports.ProviderRuntimeDefinition, ...) bool

+ func (receipt CurrentProbeDirectExecutionAuthorityReceipt) Valid() bool

+ type CurrentProbeReceipt struct

+ DirectExecutionAuthority *CurrentProbeDirectExecutionAuthorityReceipt

+ EvidenceID string

+ ExpiresAt time.Time

+ Kind string

+ type CurrentProbeRequest struct

+ Definition RuntimeDefinition

+ Fixture ProbeFixtureLease

+ Invocation SafeProbeInvocation

+ Namespace QualificationNamespace

+ Now time.Time

+ RoleFixtures []ProbeFixtureLease

+ TTL time.Duration

+ type CurrentProbeResult struct

+ Receipts []CurrentProbeReceipt

+ Version string

+ VersionArgv []string

+ type KimiLoginAuthenticator struct

+ func NewKimiLoginAuthenticator(runner ports.ProcessRunner, verifier SpawnVerifier, ...) (*KimiLoginAuthenticator, error)

+ func (authenticator *KimiLoginAuthenticator) LoginProvider(ctx context.Context, definition ports.ProviderRuntimeDefinition) error

+ type NamespaceConstructionError struct

+ func (err *NamespaceConstructionError) Error() string

+ func (err *NamespaceConstructionError) Unwrap() error

+ type NamespaceFactory struct

+ func NewNamespaceFactory(root string) (*NamespaceFactory, error)

+ func (factory *NamespaceFactory) AcquireProviderNamespace(ctx context.Context, instance string) (ports.ProviderNamespaceLease, error)

+ type NativeProbeInvocation struct

+ func (NativeProbeInvocation) CapabilityArgv(definition RuntimeDefinition, fixture ProbeFixture) ([]string, error)

+ func (NativeProbeInvocation) Validate(definition RuntimeDefinition, fixture ProbeFixture, argv []string) error

+ func (NativeProbeInvocation) VersionArgv(definition RuntimeDefinition) ([]string, error)

+ type ProbeFixture interface

+ Link func() string

+ Nonce func() string

+ Packet func() []byte

+ Reference func() string

+ Validate func() error

+ WorkspaceSnapshotIdentity func() ports.WorkspaceSnapshotIdentity

+ type ProbeFixtureLease interface

+ DrainTerminal func(context.Context) (ports.QualificationWorkspaceTerminalReceipt, error)

+ Packet func() []byte

+ PacketSHA256 func() string

+ RevalidateForExecution func() (ports.WorkspaceExecutionGuard, error)

+ Role func() domain.Role

+ Workspace func() ProbeWorkspace

+ type ProbeFixtureLeaseFactory struct

+ func NewProbeFixtureLeaseFactory(workspaces ports.QualificationWorkspaceLeaseFactory, ...) (*ProbeFixtureLeaseFactory, error)

+ func (factory *ProbeFixtureLeaseFactory) Acquire(ctx context.Context, role domain.Role) (ProbeFixtureLease, error)

+ type ProbeNonceGenerator interface

+ NewProbeNonce func() (string, error)

+ type ProbeWorkspace interface

+ DrainTerminal func(context.Context) (ports.QualificationWorkspaceTerminalReceipt, error)

+ type QualificationFixtureFactoryAdapter struct

+ func NewQualificationFixtureFactoryAdapter(factory *ProbeFixtureLeaseFactory) (*QualificationFixtureFactoryAdapter, error)

+ func (adapter *QualificationFixtureFactoryAdapter) Acquire(ctx context.Context, role domain.Role) (ports.ProviderQualificationFixtureLease, error)

+ type QualificationNamespace = ports.ProviderQualificationNamespace

+ type QualificationProbeAdapter struct

+ func NewQualificationProbeAdapter(probe *CurrentProbe, invocation SafeProbeInvocation) (*QualificationProbeAdapter, error)

+ func (adapter *QualificationProbeAdapter) QualifyProviderCurrent(ctx context.Context, request ports.ProviderCurrentProbeRequest) (ports.ProviderCurrentProbeResult, error)

+ type QualificationRegistryFactory struct

+ func NewQualificationRegistryFactory(runner ports.ProcessRunner, namespaces ports.ProviderNamespaceFactory, ...) (*QualificationRegistryFactory, error)

+ func (*QualificationRegistryFactory) RegistryFromConstructionError(err error) (ports.ProviderQualificationRegistry, bool)

+ func (factory *QualificationRegistryFactory) NewProviderQualificationRegistry(ctx context.Context, definitions []ports.ProviderRuntimeDefinition) (ports.ProviderQualificationRegistry, error)

+ type Registry struct

+ func NewProductionRegistry(runner ports.ProcessRunner, factory ports.ProviderNamespaceFactory, ...) (*Registry, error)

+ func NewProductionRegistryWithContext(ctx context.Context, runner ports.ProcessRunner, ...) (*Registry, error)

+ func NewRegistry(runner ports.ProcessRunner, profiles ...RuntimeDefinition) (*Registry, error)

+ func NewRegistryWithContext(ctx context.Context, runner ports.ProcessRunner, profiles ...RuntimeDefinition) (*Registry, error)

+ func NewRegistryWithNamespaceFactory(runner ports.ProcessRunner, factory ports.ProviderNamespaceFactory, ...) (*Registry, error)

+ func NewRegistryWithNamespaceFactoryContext(ctx context.Context, runner ports.ProcessRunner, ...) (*Registry, error)

+ func RegistryFromConstructionError(err error) (*Registry, bool)

+ func (r *Registry) Close(ctx context.Context) (ports.ProviderRunTerminalReceipt, error)

+ func (r *Registry) Observe(ctx context.Context, invocation ports.ProviderInvocation) (ports.ProviderExecutionObservation, error)

+ func (r *Registry) QualificationNamespace(instance string) (QualificationNamespace, bool)

+ type RegistryConstructionError struct

+ func (err *RegistryConstructionError) Error() string

+ func (err *RegistryConstructionError) Unwrap() error

+ type RuntimeBuilder struct

+ func (RuntimeBuilder) BuildProductionRuntime(spec ports.ProviderRuntimeSpec) (ports.ProviderRuntimeDefinition, error)

+ func (RuntimeBuilder) RuntimeSafetyPolicyIdentity(family string) (string, error)

+ type RuntimeDefinition struct

+ func NewProductionKimiRuntimeDefinitionWithTransportAndSafetyPolicy(family, instance, version, executable, executableSHA256, launcher, ... string, ...) (RuntimeDefinition, error)

+ func NewProductionRuntimeDefinition(family, instance, version, executable, executableSHA256 string, ...) (RuntimeDefinition, error)

+ func NewProductionRuntimeDefinitionWithTransport(family, instance, version, executable, executableSHA256, launcher, ... string, ...) (RuntimeDefinition, error)

+ func NewProductionRuntimeDefinitionWithTransportAndSafetyPolicy(family, instance, version, executable, executableSHA256, launcher, ... string, ...) (RuntimeDefinition, error)

+ func NewProductionRuntimeDefinitionWithTransportAndSafetyPolicyAndPostOutputLifecycle(family, instance, version, executable, executableSHA256, launcher, ... string, ...) (RuntimeDefinition, error)

+ func NewRuntimeDefinition(family, instance, version, executable, executableSHA256 string, ...) (RuntimeDefinition, error)

+ func NewRuntimeDefinitionWithTransport(family, instance, version, executable, executableSHA256 string, ...) (RuntimeDefinition, error)

+ func NewRuntimeDefinitionWithTransportAndPostOutputLifecycle(family, instance, version, executable, executableSHA256 string, ...) (RuntimeDefinition, error)

+ func (d RuntimeDefinition) BaseArgv() []string

+ func (d RuntimeDefinition) ConcurrencyKey() ports.ConcurrencyKey

+ func (d RuntimeDefinition) Environment() []ports.EnvironmentVariable

+ func (d RuntimeDefinition) Executable() string

+ func (d RuntimeDefinition) ExecutableSHA256() string

+ func (d RuntimeDefinition) Family() string

+ func (d RuntimeDefinition) Instance() string

+ func (d RuntimeDefinition) KimiModel() string

+ func (d RuntimeDefinition) Launcher() string

+ func (d RuntimeDefinition) LauncherSHA256() string

+ func (d RuntimeDefinition) MaxStderrBytes() int64

+ func (d RuntimeDefinition) MaxStdoutBytes() int64

+ func (d RuntimeDefinition) PostOutputLifecycle() (ports.BoundedPostOutputLifecycle, bool)

+ func (d RuntimeDefinition) ProfileGeneration() string

+ func (d RuntimeDefinition) ProfileID() string

+ func (d RuntimeDefinition) RuntimeSafetyPolicyIdentity() string

+ func (d RuntimeDefinition) Timeout() time.Duration

+ func (d RuntimeDefinition) Transport() RuntimeTransport

+ func (d RuntimeDefinition) TransportArgvIndex() int

+ func (d RuntimeDefinition) TransportChannel() ports.ProviderPacketChannel

+ func (d RuntimeDefinition) TransportReference() string

+ func (d RuntimeDefinition) Version() string

+ func (d RuntimeDefinition) WorkingDirectory() string

+ type RuntimeSafetyPolicy struct

+ func RuntimeSafetyPolicyForFamily(family CredentialSourceFamily) (RuntimeSafetyPolicy, error)

+ func RuntimeSafetyPolicyForFamilyAndWorkspaceRoot(family CredentialSourceFamily, workspaceRoot string) (RuntimeSafetyPolicy, error)

+ func (policy RuntimeSafetyPolicy) Identity() string

+ type RuntimeTransport struct

+ func NewRuntimeTransport(channel ports.ProviderPacketChannel, argvIndex int, reference string) (RuntimeTransport, error)

+ func (t RuntimeTransport) ArgvIndex() int

+ func (t RuntimeTransport) Channel() ports.ProviderPacketChannel

+ func (t RuntimeTransport) Reference() string

+ type SafeProbeInvocation interface

+ CapabilityArgv func(RuntimeDefinition, ProbeFixture) ([]string, error)

+ Validate func(RuntimeDefinition, ProbeFixture, []string) error

+ VersionArgv func(RuntimeDefinition) ([]string, error)

+ type SecureProbeNonceGenerator struct

+ func (SecureProbeNonceGenerator) NewProbeNonce() (string, error)

+ type SpawnVerifier interface

+ VerifyProviderSpawn func(context.Context, RuntimeDefinition) error