Files

T

jason.woltje be55549700 feat(sessions): named persistent sessions with resume (L1) (#22 , #23 )

- task schema: optional session (named id) -> persistent session dir at
  dataRoot/sessions/<name>, isolated per name
- pi adapter: --session-dir when declared (ephemeral --no-session stays
  the default otherwise); -c resumes the most recent session when present
- compose passthrough; result.json records session
- fixtures: tasks/session-demo-1.json (teach) + session-demo-2.json (recall)
- E2E: teach -> REMEMBERED + host-side session JSONL; resume -> recalled
  'mosaico' exactly; single continued session file

Closes #22, closes #23

2026-09-02 22:08:34 -05:00

mock

feat(capabilities): task workspaces + tools allowlist plumbing (#20 )

2026-09-02 22:03:46 -05:00

feat(sessions): named persistent sessions with resume (L1) (#22 , #23 )

2026-09-02 22:08:34 -05:00

README.md

feat(adapters): adapter contract, dispatch, pi + mock adapters (#16 )

2026-09-02 21:18:07 -05:00

README.md

Mosaic runtime adapters

An adapter is the entire harness-specific surface of the system. Everything upstream of an adapter — configuration, contracts, missions, tasks, run records — is harness-agnostic; everything inside an adapter may assume one specific agent runtime.

Contract

An adapter lives at:

/opt/mosaic/adapters/<name>/adapter.sh

and must be executable. The dispatcher (/opt/mosaic/src/run-agent.sh) selects it via MOSAIC_ADAPTER (default: pi) and execs it after the system prompt has been generated.

Inputs (environment):

Variable	Meaning
`MOSAIC_SYSTEM_PROMPT_FILE`	Absolute path to the generated system prompt (contracts + optional mission section). Read it; do not modify it.
`MOSAIC_REQUEST`	The exact user request text (may contain newlines).
`MOSAIC_PROVIDER`	Configured provider name.
`MOSAIC_MODEL`	Configured model id.

Optional, adapter-specific (documented per adapter):

Variable	Meaning
`MOSAIC_MOCK_RESPONSE`	mock only: the verbatim response to emit

Outputs:

stdout: the model response text — the only channel the orchestrator captures
stderr: diagnostics (never credentials)
exit 0: success; nonzero: failure

Rules

Adapters print ONLY the response on stdout. Status lines go to stderr.
Adapters never read configuration files; the resolved settings arrive via environment.
Adapters never write outside /var/lib/mosaic.
Adding an adapter requires: a new directory, the contract implementation, and adding the name to the allowlist in scripts/mosaic-config.mjs.

Included adapters

pi — the pinned @earendil-works/pi-coding-agent CLI in noninteractive print mode (-p), ambient discovery disabled, stdin detached.
mock — deterministic echo of MOSAIC_MOCK_RESPONSE. Test-only: never use it where a real model response is required.