Skip to content

feat(agent-interface): add minimal AgentInstance contracts - #202

Merged
drewstone merged 1 commit into
mainfrom
agent/multi-agent-instance-contract
Aug 18, 2026
Merged

feat(agent-interface): add minimal AgentInstance contracts#202
drewstone merged 1 commit into
mainfrom
agent/multi-agent-instance-contract

Conversation

@drewstone

@drewstone drewstone commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

Why

An execution environment is a computer, not an AgentProfile appliance. It may host zero, one, or many managed agents without making a profile part of machine identity.

What

  • add a deliberately small provider-neutral AgentInstanceSpec
  • add shared/isolated workspace intent
  • add public lifecycle, sanitized failure, and idempotent stop contracts
  • add strict Zod validators
  • export from the package root and @tangle-network/agent-interface/agent-instance
  • document the provider ownership boundary

Deliberately not included

Provider credentials, named-profile registries, placement, billing, process ids, workspace roots, local resource scheduling, grants, metadata bags, and fencing remain provider-private. The public lifecycle record does not echo the full profile or provider request.

Compatibility

Additive only. Existing AgentProfile, runtime, cancellation, and activation contracts are unchanged.

Validation

  • pnpm --filter @tangle-network/agent-interface check-types
  • pnpm --filter @tangle-network/agent-interface test
  • pnpm --filter @tangle-network/agent-interface build
  • pnpm check:package-artifacts
  • git diff --check

Merge criteria

  • profile-less agents remain valid
  • a profile never implies a VM
  • unknown/provider-specific fields fail strict validation
  • failed records require sanitized failure evidence
  • no credential/process/placement state enters the portable record
  • package root and subpath artifacts remain valid

@drewstone drewstone changed the title feat(agent-interface): add portable multi-agent instance contracts feat(agent-interface): add minimal AgentInstance contracts Aug 17, 2026
@drewstone
drewstone force-pushed the agent/multi-agent-instance-contract branch from 7fb1d7f to ce41e1c Compare August 17, 2026 18:54
@drewstone
drewstone marked this pull request as ready for review August 18, 2026 00:50
@drewstone
drewstone merged commit ba5e02f into main Aug 18, 2026
1 check passed
@drewstone
drewstone deleted the agent/multi-agent-instance-contract branch August 18, 2026 00:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant