agentintegration

Documentation

Overview

Package agentintegration owns portable CLI bootstrap materialization and read-only freshness, and explicit managed file lifecycle. Host activation remains outside this package's authority.

Index

• Constants
• func ConsumedCommands() []string
• func Tools() []string
• type Capability
• type CheckResult
  • func Check(ctx context.Context, repositoryRoot string, document Document) (CheckResult, error)
  • func (result CheckResult) JSONValue() map[string]any
  • func (result CheckResult) State() string
  • func (result CheckResult) Text() string
• type Document
  • func Source(tool string, capabilities []Capability) (Document, error)
  • func (document Document) Content() string
  • func (document Document) JSONValue() map[string]any
• type LifecyclePlan
  • func PlanLifecycle(ctx context.Context, root string, document Document, operation string) (LifecyclePlan, error)
  • func (plan LifecyclePlan) ExitCode() int
  • func (plan LifecyclePlan) JSONValue() map[string]any
  • func (plan LifecyclePlan) Text() string
• type LifecycleReceipt
  • func ApplyLifecycle(ctx context.Context, root string, document Document, ...) (LifecycleReceipt, error)
  • func RecoverLifecycle(ctx context.Context, root, transactionID, action string) (LifecycleReceipt, error)
  • func (receipt LifecycleReceipt) ExitCode() int
  • func (receipt LifecycleReceipt) JSONValue() map[string]any
  • func (receipt LifecycleReceipt) Text() string

Constants

const (
	OperationInstall = "install"
	OperationUpdate  = "update"
	OperationRemove  = "remove"
	OperationRecover = "recover"
)

const (
	MaximumMetadataBytes = 512
	MaximumBodyBytes     = 4096
)

Functions

func ConsumedCommands

func ConsumedCommands() []string

func Tools

func Tools() []string

Types

type Capability

type Capability struct {
	Command        string
	Route          []string
	ContractDigest string
}

Capability binds an existing public invocation contract, not a new schema or a claim of complete transitive implementation equivalence.

type CheckResult

type CheckResult struct {
	// contains filtered or unexported fields
}

CheckResult reports only generated-byte freshness, not host activation.

func Check

func Check(ctx context.Context, repositoryRoot string, document Document) (CheckResult, error)

Check uses one read-only lease and two bounded observations of the selected descriptor-owned path. Neither operation authorizes filesystem mutation.

func (CheckResult) JSONValue

func (result CheckResult) JSONValue() map[string]any

func (CheckResult) State

func (result CheckResult) State() string

func (CheckResult) Text

func (result CheckResult) Text() string

type Document

type Document struct {
	// contains filtered or unexported fields
}

func Source

func Source(tool string, capabilities []Capability) (Document, error)

func (Document) Content

func (document Document) Content() string

func (Document) JSONValue

func (document Document) JSONValue() map[string]any

type LifecyclePlan

type LifecyclePlan struct {
	// contains filtered or unexported fields
}

func PlanLifecycle

func PlanLifecycle(ctx context.Context, root string, document Document, operation string) (LifecyclePlan, error)

PlanLifecycle recognizes only snapshots captured by the native transaction builder. The opaque result retains its executable plan privately.

func (LifecyclePlan) ExitCode

func (plan LifecyclePlan) ExitCode() int

func (LifecyclePlan) JSONValue

func (plan LifecyclePlan) JSONValue() map[string]any

func (LifecyclePlan) Text

func (plan LifecyclePlan) Text() string

type LifecycleReceipt

type LifecycleReceipt struct {
	// contains filtered or unexported fields
}

func ApplyLifecycle

func ApplyLifecycle(ctx context.Context, root string, document Document, operation, expectedTransaction, expectedDesired string) (LifecycleReceipt, error)

func RecoverLifecycle

func RecoverLifecycle(ctx context.Context, root, transactionID, action string) (LifecycleReceipt, error)

func (LifecycleReceipt) ExitCode

func (receipt LifecycleReceipt) ExitCode() int

func (LifecycleReceipt) JSONValue

func (receipt LifecycleReceipt) JSONValue() map[string]any

func (LifecycleReceipt) Text

func (receipt LifecycleReceipt) Text() string