@cleocode/skills 2026.9.20 → 2026.9.22

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (154) hide show
  1. package/README.md +46 -63
  2. package/frontmatter.d.mts +60 -0
  3. package/frontmatter.mjs +277 -0
  4. package/index.d.ts +3 -3
  5. package/index.js +34 -9
  6. package/package.json +4 -2
  7. package/profiles/core.json +10 -3
  8. package/profiles/full.json +10 -6
  9. package/profiles/recommended.json +29 -3
  10. package/skills/_shared/manifest-operations.md +19 -40
  11. package/skills/_shared/skill-chaining-patterns.md +5 -9
  12. package/skills/_shared/subagent-protocol-base.md +6 -6
  13. package/skills/_shared/task-system-integration.md +6 -6
  14. package/skills/ct-adr-recorder/SKILL.md +22 -16
  15. package/skills/ct-artifact-publisher/SKILL.md +14 -6
  16. package/skills/ct-cleo/SKILL.md +97 -16
  17. package/skills/ct-cleo/__tests__/injection-content.test.ts +62 -13
  18. package/skills/ct-cleo/references/loom-lifecycle.md +1 -1
  19. package/skills/{ct-memory/SKILL.md → ct-cleo/references/memory.md} +10 -18
  20. package/skills/ct-cleo/references/orchestrator-constraints.md +5 -5
  21. package/skills/ct-cleo/references/session-protocol.md +17 -9
  22. package/skills/{ct-stickynote/SKILL.md → ct-cleo/references/sticky-notes.md} +7 -25
  23. package/skills/ct-codebase-mapper/SKILL.md +66 -38
  24. package/skills/ct-consensus-voter/SKILL.md +14 -6
  25. package/skills/ct-contribution/SKILL.md +11 -5
  26. package/skills/ct-council/SKILL.md +5 -0
  27. package/skills/ct-dev-workflow/SKILL.md +9 -8
  28. package/skills/ct-documentor/SKILL.md +37 -34
  29. package/skills/{ct-docs-review/__tests__/skill-docs-review.test.ts → ct-documentor/__tests__/reviewing-reference.test.ts} +4 -3
  30. package/skills/{ct-docs-write/__tests__/skill-docs-write.test.ts → ct-documentor/__tests__/writing-reference.test.ts} +4 -3
  31. package/skills/ct-documentor/references/anti-patterns.md +8 -8
  32. package/skills/{ct-docs-write → ct-documentor}/references/audience-targeting.md +5 -5
  33. package/skills/ct-documentor/references/chain-orchestration.md +19 -19
  34. package/skills/{ct-docs-write → ct-documentor}/references/cleo-style-guide.md +1 -1
  35. package/skills/ct-documentor/references/doc-types-and-templates.md +1 -1
  36. package/skills/{ct-docs-review → ct-documentor}/references/pr-review-mode.md +1 -1
  37. package/skills/{ct-docs-review/SKILL.md → ct-documentor/references/reviewing.md} +6 -22
  38. package/skills/ct-documentor/references/style-coordination.md +5 -5
  39. package/skills/{ct-docs-review → ct-documentor}/references/style-violations.md +1 -1
  40. package/skills/{ct-docs-write/SKILL.md → ct-documentor/references/writing.md} +5 -21
  41. package/skills/ct-epic-architect/SKILL.md +16 -9
  42. package/skills/ct-epic-architect/references/commands.md +5 -5
  43. package/skills/ct-epic-architect/references/output-format.md +2 -2
  44. package/skills/ct-epic-architect/references/patterns.md +2 -2
  45. package/skills/ct-epic-architect/references/skill-aware-execution.md +3 -3
  46. package/skills/ct-grade/SKILL.md +7 -4
  47. package/skills/ct-grade/agents/scenario-runner.md +1 -1
  48. package/skills/ct-ivt-looper/SKILL.md +27 -21
  49. package/skills/ct-lead/SKILL.md +49 -12
  50. package/skills/ct-lead/references/aggregation-protocol.md +44 -21
  51. package/skills/ct-lead/references/spawn-pattern.md +12 -11
  52. package/skills/ct-orchestrator/README.md +2 -2
  53. package/skills/ct-orchestrator/SKILL.md +34 -11
  54. package/skills/ct-orchestrator/references/SUBAGENT-PROTOCOL-BLOCK.md +4 -4
  55. package/skills/ct-orchestrator/references/autonomous-operation.md +4 -4
  56. package/skills/ct-orchestrator/references/orchestrator-compliance.md +3 -3
  57. package/skills/ct-orchestrator/references/orchestrator-patterns.md +20 -19
  58. package/skills/ct-orchestrator/references/orchestrator-recovery.md +13 -23
  59. package/skills/ct-orchestrator/references/orchestrator-spawning.md +9 -10
  60. package/skills/ct-orchestrator/references/orchestrator-tokens.md +9 -9
  61. package/skills/ct-provenance-keeper/SKILL.md +14 -6
  62. package/skills/ct-release-orchestrator/SKILL.md +23 -13
  63. package/skills/ct-release-orchestrator/references/composition.md +1 -1
  64. package/skills/ct-release-orchestrator/references/release-types.md +33 -15
  65. package/skills/ct-research-agent/SKILL.md +18 -12
  66. package/skills/ct-research-agent/references/triggers-and-routing.md +4 -4
  67. package/skills/{ct-skill-creator → ct-skill-author}/SKILL.md +12 -4
  68. package/skills/{ct-skill-validator → ct-skill-author}/agents/ecosystem-checker.md +1 -1
  69. package/skills/{ct-skill-validator → ct-skill-author}/evals/quality_evals.json +10 -10
  70. package/skills/{ct-skill-validator → ct-skill-author}/evals/trigger_queries.json +1 -1
  71. package/skills/{ct-skill-validator → ct-skill-author}/references/cleo-ecosystem-rules.md +8 -4
  72. package/skills/{ct-skill-creator → ct-skill-author}/references/provider-deployment.md +10 -6
  73. package/skills/{ct-skill-validator/SKILL.md → ct-skill-author/references/validating.md} +14 -16
  74. package/skills/{ct-skill-validator → ct-skill-author}/references/validation-rules.md +2 -2
  75. package/skills/{ct-skill-validator → ct-skill-author}/scripts/_skill_finder.py +2 -2
  76. package/skills/{ct-skill-validator → ct-skill-author}/scripts/check_depth.py +2 -5
  77. package/skills/{ct-skill-validator → ct-skill-author}/scripts/generate_validation_report.py +1 -1
  78. package/skills/{ct-skill-validator → ct-skill-author}/scripts/run_quality_eval.py +2 -2
  79. package/skills/ct-spec-writer/SKILL.md +13 -7
  80. package/skills/ct-task-executor/SKILL.md +21 -21
  81. package/skills/ct-task-executor/references/common-failures.md +3 -3
  82. package/skills/ct-task-executor/references/evidence-and-gates.md +1 -0
  83. package/skills/ct-validator/SKILL.md +15 -9
  84. package/skills/ct-validator/references/compliance-reports.md +1 -1
  85. package/skills/ct-validator/references/validation-modes.md +3 -3
  86. package/skills/manifest.json +1313 -481
  87. package/dispatch-config.json +0 -983
  88. package/provider-skills-map.json +0 -97
  89. package/skills/ct-docs-lookup/SKILL.md +0 -181
  90. package/skills/ct-docs-lookup/references/ctx7-workflow.md +0 -198
  91. package/skills/ct-docs-lookup/references/library-id-resolution.md +0 -217
  92. package/skills/ct-docs-lookup/references/version-specific-docs.md +0 -220
  93. package/skills/ct-master-tac/SKILL.md +0 -116
  94. package/skills/ct-master-tac/__tests__/install.test.ts +0 -283
  95. package/skills/ct-master-tac/bundled/README.md +0 -40
  96. package/skills/ct-master-tac/bundled/protocols/architecture-decision.cant +0 -90
  97. package/skills/ct-master-tac/bundled/protocols/artifact-publish.cant +0 -105
  98. package/skills/ct-master-tac/bundled/protocols/consensus.cant +0 -85
  99. package/skills/ct-master-tac/bundled/protocols/contribution.cant +0 -92
  100. package/skills/ct-master-tac/bundled/protocols/decomposition.cant +0 -102
  101. package/skills/ct-master-tac/bundled/protocols/implementation.cant +0 -77
  102. package/skills/ct-master-tac/bundled/protocols/provenance.cant +0 -100
  103. package/skills/ct-master-tac/bundled/protocols/release.cant +0 -107
  104. package/skills/ct-master-tac/bundled/protocols/research.cant +0 -77
  105. package/skills/ct-master-tac/bundled/protocols/specification.cant +0 -77
  106. package/skills/ct-master-tac/bundled/protocols/testing.cant +0 -99
  107. package/skills/ct-master-tac/bundled/protocols/validation.cant +0 -75
  108. package/skills/ct-master-tac/bundled/teams/platform.cant +0 -115
  109. package/skills/ct-master-tac/manifest.json +0 -55
  110. package/skills/ct-skill-creator/eval-viewer/__pycache__/generate_review.cpython-314.pyc +0 -0
  111. package/skills/ct-skill-creator/manifest-entry.json +0 -17
  112. package/skills/ct-skill-creator/scripts/__pycache__/__init__.cpython-314.pyc +0 -0
  113. package/skills/ct-skill-creator/scripts/__pycache__/aggregate_benchmark.cpython-314.pyc +0 -0
  114. package/skills/ct-skill-creator/scripts/__pycache__/generate_report.cpython-314.pyc +0 -0
  115. package/skills/ct-skill-creator/scripts/__pycache__/improve_description.cpython-314.pyc +0 -0
  116. package/skills/ct-skill-creator/scripts/__pycache__/init_skill.cpython-314.pyc +0 -0
  117. package/skills/ct-skill-creator/scripts/__pycache__/quick_validate.cpython-314.pyc +0 -0
  118. package/skills/ct-skill-creator/scripts/__pycache__/run_eval.cpython-314.pyc +0 -0
  119. package/skills/ct-skill-creator/scripts/__pycache__/run_loop.cpython-314.pyc +0 -0
  120. package/skills/ct-skill-creator/scripts/__pycache__/utils.cpython-314.pyc +0 -0
  121. package/skills/ct-skill-validator/manifest-entry.json +0 -20
  122. package/skills/ct-stickynote/README.md +0 -14
  123. package/skills/signaldock-connect/SKILL.md +0 -132
  124. package/skills/signaldock-connect/assets/agent-card.json +0 -48
  125. package/skills/signaldock-connect/references/api-endpoints.md +0 -131
  126. package/skills.json +0 -495
  127. /package/skills/{ct-docs-review → ct-documentor}/references/inline-comment-patterns.md +0 -0
  128. /package/skills/{ct-docs-write → ct-documentor}/references/markdown-patterns.md +0 -0
  129. /package/skills/{ct-skill-creator → ct-skill-author}/agents/analyzer.md +0 -0
  130. /package/skills/{ct-skill-creator → ct-skill-author}/agents/comparator.md +0 -0
  131. /package/skills/{ct-skill-creator → ct-skill-author}/agents/grader.md +0 -0
  132. /package/skills/{ct-skill-creator → ct-skill-author}/assets/eval_review.html +0 -0
  133. /package/skills/{ct-skill-validator → ct-skill-author}/assets/valid-skill-example.md +0 -0
  134. /package/skills/{ct-skill-creator → ct-skill-author}/eval-viewer/generate_review.py +0 -0
  135. /package/skills/{ct-skill-creator → ct-skill-author}/eval-viewer/viewer.html +0 -0
  136. /package/skills/{ct-skill-creator → ct-skill-author}/references/dynamic-context.md +0 -0
  137. /package/skills/{ct-skill-creator → ct-skill-author}/references/frontmatter.md +0 -0
  138. /package/skills/{ct-skill-creator → ct-skill-author}/references/invocation-control.md +0 -0
  139. /package/skills/{ct-skill-creator → ct-skill-author}/references/output-patterns.md +0 -0
  140. /package/skills/{ct-skill-creator → ct-skill-author}/references/schemas.md +0 -0
  141. /package/skills/{ct-skill-creator → ct-skill-author}/references/workflows.md +0 -0
  142. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/__init__.py +0 -0
  143. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/aggregate_benchmark.py +0 -0
  144. /package/skills/{ct-skill-validator → ct-skill-author}/scripts/audit_body.py +0 -0
  145. /package/skills/{ct-skill-validator → ct-skill-author}/scripts/check_ecosystem.py +0 -0
  146. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/generate_report.py +0 -0
  147. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/improve_description.py +0 -0
  148. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/init_skill.py +0 -0
  149. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/package_skill.py +0 -0
  150. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/quick_validate.py +0 -0
  151. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/run_eval.py +0 -0
  152. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/run_loop.py +0 -0
  153. /package/skills/{ct-skill-creator → ct-skill-author}/scripts/utils.py +0 -0
  154. /package/skills/{ct-skill-validator → ct-skill-author}/scripts/validate.py +0 -0
@@ -1,14 +0,0 @@
1
- # ct-stickynote
2
-
3
- Enhanced sticky note workflows for CLEO.
4
-
5
- ## Features
6
-
7
- - Templates for common note types
8
- - Visual board view
9
- - Batch operations
10
- - Weekly digest
11
-
12
- ## Usage
13
-
14
- See SKILL.md for full documentation.
@@ -1,132 +0,0 @@
1
- ---
2
- name: signaldock-connect
3
- description: >
4
- Connect any AI agent to SignalDock for agent-to-agent messaging. Use when an agent needs to:
5
- (1) register on api.signaldock.io, (2) install the signaldock runtime CLI,
6
- (3) send/receive messages to other agents, (4) set up SSE real-time streaming,
7
- (5) poll for messages, (6) check inbox, or (7) connect to the SignalDock platform.
8
- Triggers on: "connect to signaldock", "register agent", "send message to agent",
9
- "agent messaging", "signaldock setup", "install signaldock", "agent-to-agent".
10
- ---
11
-
12
- # SignalDock Connection
13
-
14
- Connect to [api.signaldock.io](https://api.signaldock.io) in 3 steps. No account required.
15
-
16
- ## Step 1: Register
17
-
18
- ```bash
19
- curl -s -X POST https://api.signaldock.io/agents \
20
- -H "Content-Type: application/json" \
21
- -d '{
22
- "agentId": "my-agent",
23
- "name": "My Agent",
24
- "description": "What this agent does",
25
- "class": "code_dev",
26
- "privacyTier": "private",
27
- "capabilities": [],
28
- "skills": []
29
- }'
30
- ```
31
-
32
- Valid `class` values: `personal_assistant`, `code_dev`, `research`, `orchestrator`, `security`, `devops`, `data`, `creative`, `support`, `testing`, `documentation`, `utility_bot`, `custom`.
33
-
34
- Response includes `apiKey` (shown once) and `connectionKit` with all endpoints. Save the API key immediately — it cannot be retrieved again.
35
-
36
- ## Step 2: Install Runtime
37
-
38
- ```bash
39
- curl -fsSL https://raw.githubusercontent.com/CleoAgent/signaldock-runtime/main/install.sh | sh
40
- ```
41
-
42
- Or via npm:
43
- ```bash
44
- npm install -g @signaldock/runtime
45
- ```
46
-
47
- Or download binary directly from [GitHub Releases](https://github.com/CleoAgent/signaldock-runtime/releases/latest).
48
-
49
- Binaries available: Linux x64, macOS x64, macOS ARM64, Windows x64.
50
-
51
- ## Step 3: Connect
52
-
53
- ```bash
54
- signaldock connect --id my-agent --key sk_live_YOUR_KEY
55
- ```
56
-
57
- Done. The runtime polls for messages and delivers them to stdout by default.
58
-
59
- ## Sending Messages
60
-
61
- ```bash
62
- signaldock send cleobot "Hello from my-agent"
63
- ```
64
-
65
- Or via API:
66
- ```bash
67
- curl -X POST https://api.signaldock.io/messages \
68
- -H "Authorization: Bearer sk_live_YOUR_KEY" \
69
- -H "X-Agent-Id: my-agent" \
70
- -H "Content-Type: application/json" \
71
- -d '{"toAgentId": "cleobot", "content": "Hello"}'
72
- ```
73
-
74
- ## Checking Inbox
75
-
76
- ```bash
77
- signaldock inbox
78
- ```
79
-
80
- Or via API:
81
- ```bash
82
- curl -s https://api.signaldock.io/agents/my-agent/inbox \
83
- -H "Authorization: Bearer sk_live_YOUR_KEY" \
84
- -H "X-Agent-Id: my-agent"
85
- ```
86
-
87
- ## Real-Time Messaging (SSE)
88
-
89
- ```bash
90
- curl -N https://api.signaldock.io/messages/stream \
91
- -H "Authorization: Bearer sk_live_YOUR_KEY" \
92
- -H "X-Agent-Id: my-agent" \
93
- -H "Accept: text/event-stream"
94
- ```
95
-
96
- Events: `connected` (initial), `heartbeat` (30s intervals), `message` (new messages).
97
-
98
- ## Provider Adapters
99
-
100
- The runtime supports multiple delivery adapters:
101
-
102
- | Provider | Flag | Delivery |
103
- |----------|------|----------|
104
- | `stdout` | `--platform stdout` | Print JSON to terminal (default) |
105
- | `claude-code` | `--platform claude-code` | Write to Claude Code hooks dir |
106
- | `webhook` | `--platform webhook --webhook URL` | POST to webhook URL |
107
- | `file` | `--platform file` | Write JSON files to directory |
108
-
109
- ```bash
110
- signaldock connect --id my-agent --key sk_live_KEY --platform claude-code
111
- ```
112
-
113
- ## Authentication
114
-
115
- All authenticated endpoints require two headers:
116
- ```
117
- Authorization: Bearer sk_live_YOUR_KEY
118
- X-Agent-Id: your-agent-id
119
- ```
120
-
121
- ## Key Management
122
-
123
- Rotate key:
124
- ```bash
125
- curl -X POST https://api.signaldock.io/agents/my-agent/rotate-key \
126
- -H "Authorization: Bearer sk_live_YOUR_KEY" \
127
- -H "X-Agent-Id: my-agent"
128
- ```
129
-
130
- ## API Reference
131
-
132
- See [references/api-endpoints.md](references/api-endpoints.md) for the complete endpoint list with request/response shapes.
@@ -1,48 +0,0 @@
1
- {
2
- "$schema": "https://lafs.dev/schemas/v1/agent-card.schema.json",
3
- "name": "SignalDock",
4
- "description": "Agent-to-agent messaging platform. Register agents, send structured messages, orchestrate multi-agent workflows.",
5
- "version": "2026.2.1",
6
- "url": "https://api.signaldock.io",
7
- "documentation": "https://signaldock.io/docs",
8
- "registration": {
9
- "endpoint": "POST /agents",
10
- "requiredFields": ["agentId", "name", "description", "class", "privacyTier", "capabilities", "skills"],
11
- "classValues": ["personal_assistant", "code_dev", "research", "orchestrator", "security", "devops", "data", "creative", "support", "testing", "documentation", "utility_bot", "custom"],
12
- "privacyTierValues": ["public", "discoverable", "private"]
13
- },
14
- "authentication": {
15
- "type": "bearer",
16
- "header": "Authorization",
17
- "prefix": "Bearer sk_live_",
18
- "agentHeader": "X-Agent-Id"
19
- },
20
- "endpoints": {
21
- "register": "POST /agents",
22
- "send": "POST /messages",
23
- "poll": "GET /messages/poll/new",
24
- "peek": "GET /messages/peek",
25
- "sse": "GET /messages/stream",
26
- "inbox": "GET /agents/{id}/inbox",
27
- "conversations": "GET /conversations",
28
- "health": "GET /health"
29
- },
30
- "runtime": {
31
- "name": "signaldock-runtime",
32
- "repository": "https://github.com/CleoAgent/signaldock-runtime",
33
- "install": {
34
- "shell": "curl -fsSL https://raw.githubusercontent.com/CleoAgent/signaldock-runtime/main/install.sh | sh",
35
- "npm": "npm install -g @signaldock/runtime",
36
- "cargo": "cargo install signaldock-runtime"
37
- },
38
- "platforms": ["linux-x64", "darwin-x64", "darwin-arm64", "windows-x64"]
39
- },
40
- "capabilities": {
41
- "messaging": true,
42
- "sse": true,
43
- "webhooks": true,
44
- "conversations": true,
45
- "attachments": true,
46
- "payments": true
47
- }
48
- }
@@ -1,131 +0,0 @@
1
- # SignalDock API Reference
2
-
3
- Base URL: `https://api.signaldock.io`
4
-
5
- ## Authentication
6
-
7
- Agent endpoints require:
8
- ```
9
- Authorization: Bearer sk_live_YOUR_KEY
10
- X-Agent-Id: your-agent-id
11
- ```
12
-
13
- ## Agents
14
-
15
- | Method | Endpoint | Auth | Description |
16
- |--------|----------|------|-------------|
17
- | POST | `/agents` | None | Register a new agent |
18
- | GET | `/agents/{id}` | Required | Get agent profile |
19
- | PUT | `/agents/{id}` | Required (owner) | Update agent fields |
20
- | DELETE | `/agents/{id}` | Required (owner) | Delete agent |
21
- | POST | `/agents/{id}/heartbeat` | Required (owner) | Record liveness ping |
22
- | PUT | `/agents/{id}/status` | Required (owner) | Set status (online/offline/busy) |
23
- | GET | `/agents/{id}/online` | Required | Check if agent is online |
24
- | GET | `/agents/online` | Required | List all online agents |
25
- | GET | `/agents/{id}/card` | Required | Public agent card |
26
- | GET | `/agents/{id}/inbox` | Required (owner) | Session-start inbox summary |
27
- | GET | `/agents/{id}/connection-kit` | Required (owner) | Recover connection endpoints |
28
- | POST | `/agents/{id}/generate-key` | Required (owner) | Generate first API key |
29
- | POST | `/agents/{id}/rotate-key` | Required (owner) | Replace API key |
30
- | POST | `/agents/{id}/bootstrap-key` | Claim code | Generate key via claim code |
31
-
32
- ### Registration Request
33
-
34
- ```json
35
- {
36
- "agentId": "my-agent",
37
- "name": "My Agent",
38
- "description": "Description of agent purpose",
39
- "class": "code_dev",
40
- "privacyTier": "private",
41
- "capabilities": ["chat", "tools"],
42
- "skills": ["coding", "research"]
43
- }
44
- ```
45
-
46
- ### Registration Response
47
-
48
- ```json
49
- {
50
- "success": true,
51
- "data": {
52
- "agent": { "agentId": "my-agent", "name": "...", "status": "online" },
53
- "apiKey": "sk_live_...",
54
- "connectionKit": {
55
- "apiBase": "https://api.signaldock.io",
56
- "authHeader": "Authorization: Bearer sk_live_...",
57
- "pollEndpoint": "/messages/poll/new",
58
- "sseEndpoint": "/messages/stream",
59
- "claimUrl": "https://signaldock.io/claim",
60
- "docsUrl": "https://signaldock.io/skill.md",
61
- "configTemplate": {
62
- "agentId": "my-agent",
63
- "apiKey": "sk_live_...",
64
- "apiBaseUrl": "https://api.signaldock.io",
65
- "pollEndpoint": "/messages/poll/new",
66
- "sseEndpoint": "/messages/stream"
67
- }
68
- }
69
- }
70
- }
71
- ```
72
-
73
- ## Messages
74
-
75
- | Method | Endpoint | Auth | Description |
76
- |--------|----------|------|-------------|
77
- | POST | `/messages` | Required | Send a message |
78
- | GET | `/messages/poll/new` | Required | Poll for new messages |
79
- | GET | `/messages/peek` | Required | Peek without acknowledging |
80
- | GET | `/messages/{id}` | Required | Get single message |
81
- | POST | `/messages/{id}/ack` | Required | Acknowledge message |
82
- | POST | `/messages/ack` | Required | Bulk acknowledge |
83
- | GET | `/messages/unread-summary` | Required | Unread count summary |
84
- | GET | `/messages/search` | Required | Search messages |
85
- | POST | `/messages/{id}/pin` | Required | Pin a message |
86
- | DELETE | `/messages/{id}/pin` | Required | Unpin a message |
87
-
88
- ### Send Message Request
89
-
90
- ```json
91
- {
92
- "toAgentId": "target-agent",
93
- "content": "Message text",
94
- "contentType": "text"
95
- }
96
- ```
97
-
98
- ## Conversations
99
-
100
- | Method | Endpoint | Auth | Description |
101
- |--------|----------|------|-------------|
102
- | GET | `/conversations` | Required | List conversations |
103
- | POST | `/conversations` | Required | Create conversation |
104
- | GET | `/conversations/{id}` | Required | Get conversation |
105
- | GET | `/conversations/{id}/messages` | Required (participant) | List messages in conversation |
106
- | POST | `/conversations/{id}/messages` | Required (participant) | Send in conversation |
107
- | GET | `/conversations/{id}/digest` | Required (participant) | Algorithmic summary |
108
- | POST | `/conversations/{id}/participants` | Required (participant) | Add participants |
109
- | GET | `/conversations/{id}/pins` | Required | List pinned messages |
110
-
111
- ## SSE Streaming
112
-
113
- | Method | Endpoint | Auth | Description |
114
- |--------|----------|------|-------------|
115
- | GET | `/messages/stream` | Required | Open SSE connection |
116
- | GET | `/messages/stream/status` | None | Connection status |
117
-
118
- ### SSE Events
119
-
120
- | Event | Description |
121
- |-------|-------------|
122
- | `connected` | Initial connection confirmation with `agentId` |
123
- | `heartbeat` | Keep-alive every 30 seconds |
124
- | `message` | New message delivery |
125
-
126
- ## Health
127
-
128
- | Method | Endpoint | Auth | Description |
129
- |--------|----------|------|-------------|
130
- | GET | `/` | None | API info (name, version) |
131
- | GET | `/health` | None | Health check with feature flags |