Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 16 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# AgentTerm

AgentTerm is a terminal-native ChatOps console for coordinating human operators, Matrix rooms, registered agents, GitHub bots, CI systems, MCP tools, Agent Registry identities, Sociosphere workspace materialization, Prophet Workspace workrooms, Slash Topics scopes, Memory Mesh context, New Hope semantic threads, Holmes investigations, Sherlock search packets, MeshRush graph operations, cloudshell-fog sessions, AgentPlane runs, Policy Fabric decisions, and local SourceOS services from one channel/thread workspace.
AgentTerm is a terminal-native ChatOps console for coordinating human operators, Matrix rooms, registered agents, GitHub bots, CI systems, MCP tools, Agent Registry identities, Sociosphere workspace materialization, Prophet Workspace workrooms, Office artifacts, Slash Topics scopes, Memory Mesh context, New Hope semantic threads, Holmes investigations, Sherlock search packets, MeshRush graph operations, cloudshell-fog sessions, AgentPlane runs, Policy Fabric decisions, and local SourceOS services from one channel/thread workspace.

The design target is not another single-agent CLI. AgentTerm is the Slack-term class interface for agent operations: rooms, channels, threads, slash commands, approvals, event logs, adapters, and terminal-first operator flow. For SourceOS, Matrix is the canonical network ChatOps substrate. Slack and Discord should be treated as bridge targets, not the source of truth.

Expand All @@ -11,7 +11,7 @@ The design target is not another single-agent CLI. AgentTerm is the Slack-term c
- A minimal interactive shell for immediate use.
- A first-class SourceOS plane registry for Matrix, Agent Registry, Sociosphere, Prophet Workspace, Slash Topics, Memory Mesh, New Hope, Holmes, Sherlock Search, legacy Sherlock, MeshRush, cloudshell-fog, AgentPlane, Policy Fabric, GitHub, CI, MCP, Hermes, Codex, Claude Code, and OpenCLAW.
- Adapter contracts for Matrix, SourceOS planes, and process-backed participants.
- Governance-preserving command shapes for workroom, topic, memory, semantic-thread, investigation, search-packet, graph-view, and shell-session requests.
- Governance-preserving command shapes for workroom, Office artifact, topic, memory, semantic-thread, investigation, search-packet, graph-view, and shell-session requests.
- Agent identity posture: local config may reference agents, but Agent Registry is the authority for specs, identities, sessions, memories, tool grants, revocation, and runtime authority.
- Configuration examples, tests, CI, and operating-model docs for building AgentTerm into the SourceOS operator console.

Expand All @@ -22,6 +22,7 @@ The design target is not another single-agent CLI. AgentTerm is the Slack-term c
│ Matrix Rooms / Channels │ Thread / Conversation │
│ !agent-registry │ @agent-term: resolve @codex before dispatch │
│ !prophet-workspace │ @operator: /workroom pi-demo │
│ !prophet-workspace │ @operator: /office create-deck "Demo Deck" │
│ !slash-topics │ @operator: /topic professional-intelligence │
│ !memory-mesh │ @operator: /memory recall workroom context │
│ !new-hope │ @agent-term: semantic thread normalized │
Expand All @@ -32,7 +33,7 @@ The design target is not another single-agent CLI. AgentTerm is the Slack-term c
│ !policyfabric │ @github: PR #42 checks failing │
│ !cloudshell-fog │ @operator: /request-shell default │
├──────────────────────────┴─────────────────────────────────────────────┤
│ /workroom /topic /memory /newhope /holmes /sherlock /meshrush
│ /workroom /office /topic /memory /newhope /holmes /sherlock │
└────────────────────────────────────────────────────────────────────────┘
```

Expand All @@ -44,7 +45,7 @@ AgentTerm treats every meaningful action as an event:
- agent replies
- Matrix room events, redactions, membership changes, and bridge events
- Sociosphere workspace manifest, lock, topology, and validation events
- Prophet Workspace workroom, audit, policy-aware UX, and receipt events
- Prophet Workspace workroom, Office artifact, audit, policy-aware UX, and receipt events
- Slash Topics topic-scope, policy-membrane, and receipt events
- Memory Mesh recall, writeback, and context-pack events
- New Hope message, thread, claim, citation, receptor, membrane, and moderation events
Expand Down Expand Up @@ -83,7 +84,7 @@ AgentTerm should not collapse the SourceOS stack into one generic search agent.
| --- | --- |
| Agent Registry | Agent specs, identities, sessions, memories, tool grants, revocation, and runtime authority for every non-human participant |
| Sociosphere | Meta-workspace controller, canonical workspace manifest, lock, topology, governance registry, validation lanes |
| Prophet Workspace | Workspace product semantics, Professional Workrooms, mail/calendar/drive/docs/chat/meeting surfaces, policy-aware UX |
| Prophet Workspace | Workspace product semantics, Professional Workrooms, Office artifacts, mail/calendar/drive/docs/chat/meeting surfaces, policy-aware UX |
| Slash Topics | Governed signed topic scopes, policy membranes, search/knowledge scoping, replayable receipts |
| Memory Mesh | Governed recall, writeback, context packs, memoryd runtime, LiteLLM/OpenCLAW memory integrations |
| New Hope | Semantic runtime for messages, threads, claims, citations, entities, lenses, receptors, membranes, and moderation events |
Expand Down Expand Up @@ -114,6 +115,11 @@ agent-term planes show new-hope
agent-term post '!sourceos-build' '@operator' 'AgentTerm is online.'
agent-term record agent-registry agent_identity '!agent-registry' 'Resolve agent.codex before dispatch'
agent-term record prophet-workspace workroom '!prophet-workspace' 'Bind PI demo workroom' --metadata-json '{"workroom":"pi-demo"}'
agent-term office create-deck '!prophet-workspace' --workroom workroom-demo-0001 --title 'Professional Intelligence Demo Briefing Deck'
agent-term office create-doc '!prophet-workspace' --workroom workroom-demo-0001 --title 'Professional Intelligence Demo Report'
agent-term office create-sheet '!prophet-workspace' --workroom workroom-demo-0001 --title 'Professional Intelligence Demo Workbook'
agent-term office convert '!prophet-workspace' /workspace/output/demo.docx --to pdf --workroom workroom-demo-0001
agent-term office inspect '!prophet-workspace' /workspace/output/demo.pptx --workroom workroom-demo-0001
agent-term record slash-topics topic_scope '!slash-topics' 'Select /professional-intelligence topic scope'
agent-term record memory-mesh memory_recall '!memory-mesh' 'Recall workroom context' --requires-approval
agent-term record new-hope semantic_thread '!new-hope' 'Normalize Matrix thread into New Hope objects'
Expand All @@ -125,16 +131,19 @@ agent-term tail
agent-term shell
```

The first implementation stores events in SQLite and records governance-preserving events locally. Matrix network I/O, Agent Registry resolution/grants/revocation, Sociosphere materialization, Prophet Workspace workroom APIs, Slash Topics membranes, Memory Mesh recall/writeback, New Hope semantic normalization, Holmes request/status/artifact correlation, Sherlock Search hydration, MeshRush graph execution, cloudshell-fog session attach, AgentPlane bundle execution, and Policy Fabric admission are intentionally isolated behind adapter boundaries so the terminal, policy, event log, and registry can be hardened independently.
Office commands record governance-preserving intent events. They do not generate documents, convert files, invoke LibreOffice, operate Collabora/ONLYOFFICE, or send mail directly. Execution delegates to `sourceosctl office ...`; evidence is recorded through AgentPlane.

The first implementation stores events in SQLite and records governance-preserving events locally. Matrix network I/O, Agent Registry resolution/grants/revocation, Sociosphere materialization, Prophet Workspace workroom APIs, Slash Topics membranes, Memory Mesh recall/writeback, New Hope semantic normalization, Holmes request/status/artifact correlation, Sherlock Search hydration, MeshRush graph execution, cloudshell-fog session attach, AgentPlane bundle execution, Office artifact generation/evidence, and Policy Fabric admission are intentionally isolated behind adapter boundaries so the terminal, policy, event log, and registry can be hardened independently.

## Docs

- [SourceOS control surface architecture](docs/architecture/sourceos-control-surface.md)
- [Agent Registry integration boundary](docs/integration/agent-registry-boundary.md)
- [Holmes integration boundary](docs/integration/holmes-boundary.md)
- [Prophet Workspace Office Plane boundary](docs/integration/office-plane-boundary.md)
- [Agent instructions](AGENTS.md)
- [Example configuration](configs/agent-term.example.json)

## Repository status

This is the seed implementation. It is intentionally small but runnable. The next step is to land the Matrix-room MVP, then bind Agent Registry resolution/grants/revocation, Policy Fabric admission, Sociosphere workspace state, Prophet Workspace workrooms, Slash Topics scopes, Memory Mesh recall/writeback, New Hope semantic events, Holmes request/status/artifact correlation, Sherlock Search packets, MeshRush graph events, cloudshell-fog session lifecycle, AgentPlane evidence flow, and Hermes/Codex/Claude Code/OpenCLAW participants under explicit operator permissions.
This is the seed implementation. It is intentionally small but runnable. The next step is to land the Matrix-room MVP, then bind Agent Registry resolution/grants/revocation, Policy Fabric admission, Sociosphere workspace state, Prophet Workspace workrooms and Office artifacts, Slash Topics scopes, Memory Mesh recall/writeback, New Hope semantic events, Holmes request/status/artifact correlation, Sherlock Search packets, MeshRush graph events, cloudshell-fog session lifecycle, AgentPlane evidence flow, and Hermes/Codex/Claude Code/OpenCLAW participants under explicit operator permissions.
68 changes: 68 additions & 0 deletions docs/integration/office-plane-boundary.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
# Prophet Workspace Office Plane boundary

AgentTerm exposes operator-facing Office Plane commands for workroom-bound office artifacts.

AgentTerm does **not** generate documents, convert files, invoke LibreOffice, operate Collabora/ONLYOFFICE, or send mail directly. It records governance-preserving intent events and delegates execution/evidence to the owning planes.

## Command surface

Top-level CLI events:

```bash
agent-term office create-doc '!prophet-workspace' --workroom workroom-demo-0001 --title 'Demo Report'
agent-term office create-sheet '!prophet-workspace' --workroom workroom-demo-0001 --title 'Demo Workbook'
agent-term office create-deck '!prophet-workspace' --workroom workroom-demo-0001 --title 'Demo Briefing Deck'
agent-term office convert '!prophet-workspace' /workspace/output/demo.docx --to pdf --workroom workroom-demo-0001
agent-term office inspect '!prophet-workspace' /workspace/output/demo.pptx --workroom workroom-demo-0001
agent-term office evidence '!prophet-workspace' /workspace/evidence/office.json --workroom workroom-demo-0001
```

Interactive shell commands:

```text
/office create-doc <title>
/office create-sheet <title>
/office create-deck <title>
/office convert <path> <format>
/office inspect <path>
```

## Event model

All Office commands record `prophet-workspace` events with kind:

```text
office_artifact_request
```

Event metadata includes:

- workroom id;
- operation;
- OfficeArtifact schema ref;
- expected AgentPlane evidence kind;
- delegated `sourceosctl office ...` command shape;
- policy posture.

## Responsibility split

| Plane | Responsibility |
|---|---|
| AgentTerm | Operator command/event surface and Matrix-first ChatOps history. |
| Prophet Workspace | Professional Workroom and OfficeArtifact product semantics. |
| sourceosctl | Local Office dry-run and future execution adapter. |
| AgentPlane | OfficeArtifactEvidence and run/evidence/replay lineage. |
| Policy Fabric | Side-effect approval for send/publish/calendar modifications. |
| Agent Registry | Non-human agent identity and tool grants. |

## Approval posture

Office generation and conversion are approval-required in AgentTerm because they can lead to persisted artifacts or external sharing.

Office inspection and evidence inspection are read-only and do not require approval by default.

Sending email, publishing externally, or modifying calendars is not implemented here and must remain policy-gated side-effect flow in future slices.

## Backend posture

AgentTerm does not care whether an Office artifact is eventually produced by LibreOffice, Collabora, ONLYOFFICE, Microsoft Graph, Google Workspace, or SourceOS-native tooling. Backend selection belongs to Prophet Workspace and the delegated execution surface.
Loading
Loading