conformance

package

v0.2.57 Latest Latest Go to latest Published: Jul 29, 2026 License: MIT Imports: 7 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/codefly-dev/core

Links

Open Source Insights

Documentation ¶

Overview ¶

Package conformance provides the canonical Toolbox protocol fixture and the reusable host harness that certifies a toolbox implementation. It intentionally depends only on core contracts, never on CLI composition.

Index ¶

Constants
type Server
- func New(version string) *Server
- func (s *Server) DescribeTool(ctx context.Context, req *toolboxv0.DescribeToolRequest) (*toolboxv0.DescribeToolResponse, error)
- func (s *Server) Tools() []*registry.ToolDefinition

Constants ¶

View Source

const (
	FixtureName            = "conformance-fixture"
	FixtureVersion         = "0.0.1"
	ContractVersion        = "codefly.toolbox.conformance/v1"
	IdentityTool           = "fixture.identity.describe"
	DeterministicErrorTool = "fixture.error.deterministic"
	EffectIncrementTool    = "fixture.effect.increment"
	EffectCountTool        = "fixture.effect.count"
	WaitTool               = "fixture.wait"
	CrashTool              = "fixture.process.crash"
	DeterministicError     = "fixture: deterministic error v1"

	// FaultEnvironment selects one deterministic V4 lifecycle fault for the
	// disposable process. It is intentionally fixture-only and never read by
	// production toolboxes.
	FaultEnvironment           = "CODEFLY_CONFORMANCE_FAULT"
	FaultBeforeAuthorization   = "before_authorization"
	FaultAfterAuthorization    = "after_authorization"
	FaultDuringExecution       = "during_execution"
	FaultAfterSideEffect       = "after_side_effect"
	FaultResponseSerialization = "response_serialization"
)

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type Server ¶

type Server struct {
	*registry.Base
	// contains filtered or unexported fields
}

Server is deterministic except for its deliberately observable in-memory effect counter. The counter lets a host prove a denied destructive call never reached the handler without touching the filesystem or an external service.

func New ¶

func New(version string) *Server

func (*Server) DescribeTool ¶

func (s *Server) DescribeTool(ctx context.Context, req *toolboxv0.DescribeToolRequest) (*toolboxv0.DescribeToolResponse, error)

DescribeTool injects the only pre-authorization process failure in the fixture. The host has selected a summary but has not yet approved a descriptor or minted authority when this process exits.

func (*Server) Tools ¶

func (s *Server) Tools() []*registry.ToolDefinition

Tools returns the stable v1 fixture catalog. Renaming or reordering these tools is a protocol change and is protected by the JSON/protobuf golden test.

Source Files ¶

View all Source files

server.go

Directories ¶

Path	Synopsis
cmd
conformance-toolbox command Command conformance-toolbox runs the deterministic Toolbox conformance fixture as a real agent process through the standard secure startup helper.	Command conformance-toolbox runs the deterministic Toolbox conformance fixture as a real agent process through the standard secure startup helper.
host Package host is the CLI-independent external-host conformance harness for Codefly Toolboxes.	Package host is the CLI-independent external-host conformance harness for Codefly Toolboxes.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL