Skip to content
ContractSpec
Start here

Package manual · integrations

·Workflows, jobs and automation

integration.eve

Contained EVE runtime adapter for ContractSpec agents

integrationsintegrationv2.0.5experimentalservernode
@lssm-tech/integration.eve
bun add @lssm-tech/integration.eve
Package source ↗Manifest ↗

Manifest declarations describe the current workspace; they do not verify registry publication or runtime execution.

Package guide

Contained adapter for the official public-beta eve package.

The adapter maps EVE session, channel, connection, schedule, subagent, eval, and suspend/resume operations into the canonical ContractSpec capability-port bundle. ContractSpec checkpoint storage, approval receipts, effect replay, and sandbox policy remain authoritative and are injected as generic ports. The release advertises sandbox support only when a production AgentSandboxPort is injected with passing containment evidence. The reference composition uses the independently conformance-tested DockerAgentSandbox. EveAgentSandbox also exposes EVE's public sandbox API through the same port, but its native Docker backend remains non-isolation-conformant because EVE cannot enforce the full resource and tuple-level egress policy; every such loss stays explicit.

Current lockfile and installed package: eve@0.51.1, Apache-2.0, integrity sha512-fAF/X4DLpCduSFl1mqrz/Jo4CaApyKjjhq0FWkmWAE4C4uXZUFxMl67hJSmuPlsIu7F38s35lTPhC27fEcopAA==. This identifies the tested dependency; it does not imply live-provider or production isolation qualification. Requalify consumer workflows after dependency changes. EVE is beta, not GA.

Run the release parity gate with:

sh
bun run conformance:eve
bun run conformance:official

The package additionally verifies a real official EVE Docker workspace round-trip and tests binary files, root and command allowlists, secret redaction/persistence rejection, immutable artifacts, network mapping diagnostics, and teardown. Full production containment evidence is owned by @lssm-tech/integration.agent-sandbox and injected into the EVE bundle.

The first command produces case-18 evidence by exercising both capability-port bundles, validates it against the stored comparison artifact, and validates the case-16 and case-17 N/A artifacts under src/conformance-artifacts/. The second boots the pinned official EVE runtime with its credential-free mockModel, executes two durable turns, and proves official session continuity and lifecycle events independently of the injected adapter fixture.

The published ./conformance-fixtures/targets and ./conformance-artifacts/case-18-cross-adapter-parity.compare entries are verification fixtures. @lssm-tech/lib.agent-runtime-conformance is a development dependency only, so these entries reference it for types alone and take its runtime helpers from the caller:

ts
import { runPortableAdapterProbe } from '@lssm-tech/lib.agent-runtime-conformance';
import { createSqliteWorkflowDevkitTarget } from '@lssm-tech/lib.agent-runtime-conformance/fixtures';
import { comparePortableAdapterEvidence } from '@lssm-tech/lib.agent-runtime-conformance/parity';
import { compareCase18RuntimeEvidence } from '@lssm-tech/integration.eve/conformance-artifacts/case-18-cross-adapter-parity.compare';
import { createPortableConformanceTargets } from '@lssm-tech/integration.eve/conformance-fixtures/targets';

const targets = createPortableConformanceTargets({
  workflowFile,
  eveFile,
  toolkit: { createSqliteWorkflowDevkitTarget, runPortableAdapterProbe },
});
const report = compareCase18RuntimeEvidence(await targets.runtimeParity(), {
  comparePortableAdapterEvidence,
});

Relationships

THIS PACKAGEintegration.eve16 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

3 declarations

Declared capabilities

Integration Eve

Contained EVE runtime adapter for ContractSpec agents

Scripts

  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • cleanrimraf dist .turbo
  • conformance:evebun test src/conformance.test.ts
  • conformance:officialcd official-fixture && bunx eve eval --strict --json --skip-report
  • lint:checknode ../../../scripts/biome.cjs check .
  • publish:pkgbun publish --tolerate-republish --ignore-scripts --verbose
  • publish:pkg:canarybun publish:pkg --tag canary
  • testbun test
  • typechecktsgo --noEmit