Jordan-Hall / Jordan-Hall/browser

[P0][AGENT-02] Common AgentSession adapter interface

Open
#55 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
No language data
Stars
0
Forks
0
PR merge metrics
No merged PRs in 30d

Description

Programme: #1
Epic: #20

## Objective
Create one internal protocol for local and external coding/agent providers while preserving provider-specific capability differences.

## Scope
- Session capability negotiation and version pinning.
- Start/resume/input/event/progress/artifact/approval/interruption/completion/diagnostics primitives.
- Structured error and termination reasons.
- Provider/model/inference-location disclosure.
- Artifact publication into the shared workspace store.
- Approval requests translated into trusted runtime proposals—not provider-owned confirmations.
- Golden protocol recordings and compatibility fixtures per provider/version.

## Trust rules
- Adapter integration is not proof the provider's internal file/shell/network tools are mediated.
- Session IDs are not durable task state.
- Prefer machine-readable provider protocols; interactive terminal parsing is not an acceptable primary embedding contract.

## Acceptance criteria
- [ ] Every required provider can report its actual capabilities through the common interface.
- [ ] Missing optional capabilities remain missing instead of being simulated misleadingly.
- [ ] Start/progress/artifacts/cancel/complete normalize into stable runtime events.
- [ ] Provider version/schema mismatch fails early with actionable diagnostics.
- [ ] Golden fixtures detect protocol drift.
- [ ] Provider session termination does not erase shared task/artifact state.

## Dependencies
- CORE-01
- SEC-04

**First phase:** P0
**Maturity target:** P3
**Owner:** harness-pc-providers

## Task issues
- [ ] #449 `AGENT-02.T01` — Define the common lifecycle and optional capabilities
- [ ] #450 `AGENT-02.T02` — Implement supervised transport adapters
- [ ] #451 `AGENT-02.T03` — Normalize progress, artifacts and termination
- [ ] #452 `AGENT-02.T04` — Implement permission translation and trust classification
- [ ] #453 `AGENT-02.T05` — Build session context and destination policy
- [ ] #454 `AGENT-02.T06` — Implement interruption and resume semantics
- [ ] #455 `AGENT-02.T07` — Create golden protocol and shared workflow fixtures

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reading the stated dependencies CORE-01 and SEC-04, then inspect task issues #449–#455 to understand how the interface is decomposed. Use the acceptance criteria to define completion: normalized lifecycle events, honest capability reporting, early mismatch diagnostics, and provider-specific golden fixtures without losing shared task state.

Written by the indexing model from the issue text.

Assessment

Domain
backend-api-design, devtools
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.