aimeat 1.9.3 → 1.9.5
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.
- package/dist/locales/en.json +15 -6
- package/dist/locales/fi.json +25 -16
- package/dist/public/llms-template.txt +13 -2
- package/dist/public/views/profile/agents-tab.js +73 -19
- package/dist/scripts/audit-mcp-tools.d.ts +18 -0
- package/dist/scripts/audit-mcp-tools.d.ts.map +1 -0
- package/dist/scripts/audit-mcp-tools.js +164 -0
- package/dist/scripts/audit-mcp-tools.js.map +1 -0
- package/dist/src/cli/connect/api-client.d.ts.map +1 -1
- package/dist/src/cli/connect/api-client.js +6 -3
- package/dist/src/cli/connect/api-client.js.map +1 -1
- package/dist/src/cli/connect/auth.d.ts.map +1 -1
- package/dist/src/cli/connect/auth.js +228 -43
- package/dist/src/cli/connect/auth.js.map +1 -1
- package/dist/src/cli/connect/docs.d.ts.map +1 -1
- package/dist/src/cli/connect/docs.js +7 -2
- package/dist/src/cli/connect/docs.js.map +1 -1
- package/dist/src/cli/connect/inbox.d.ts.map +1 -1
- package/dist/src/cli/connect/inbox.js +22 -10
- package/dist/src/cli/connect/inbox.js.map +1 -1
- package/dist/src/cli/connect/mcp/poller.d.ts +3 -0
- package/dist/src/cli/connect/mcp/poller.d.ts.map +1 -1
- package/dist/src/cli/connect/mcp/poller.js +1 -1
- package/dist/src/cli/connect/mcp/poller.js.map +1 -1
- package/dist/src/cli/connect/mcp/resources.d.ts +3 -0
- package/dist/src/cli/connect/mcp/resources.d.ts.map +1 -1
- package/dist/src/cli/connect/mcp/resources.js +1 -1
- package/dist/src/cli/connect/mcp/resources.js.map +1 -1
- package/dist/src/cli/connect/mcp/server.d.ts.map +1 -1
- package/dist/src/cli/connect/mcp/server.js +12 -2
- package/dist/src/cli/connect/mcp/server.js.map +1 -1
- package/dist/src/cli/connect/mcp/tools/agent-messages.d.ts +1 -0
- package/dist/src/cli/connect/mcp/tools/agent-messages.d.ts.map +1 -1
- package/dist/src/cli/connect/mcp/tools/agent-messages.js +12 -5
- package/dist/src/cli/connect/mcp/tools/agent-messages.js.map +1 -1
- package/dist/src/cli/connect/mcp/tools/agent-tasks.d.ts +3 -0
- package/dist/src/cli/connect/mcp/tools/agent-tasks.d.ts.map +1 -1
- package/dist/src/cli/connect/mcp/tools/agent-tasks.js +31 -10
- package/dist/src/cli/connect/mcp/tools/agent-tasks.js.map +1 -1
- package/dist/src/cli/connect/mcp/tools/agent-telemetry.d.ts +11 -0
- package/dist/src/cli/connect/mcp/tools/agent-telemetry.d.ts.map +1 -0
- package/dist/src/cli/connect/mcp/tools/agent-telemetry.js +24 -0
- package/dist/src/cli/connect/mcp/tools/agent-telemetry.js.map +1 -0
- package/dist/src/cli/connect/mcp/tools/core.d.ts +5 -0
- package/dist/src/cli/connect/mcp/tools/core.d.ts.map +1 -1
- package/dist/src/cli/connect/mcp/tools/core.js +15 -3
- package/dist/src/cli/connect/mcp/tools/core.js.map +1 -1
- package/dist/src/cli/connect/mcp/tools/index.d.ts +2 -0
- package/dist/src/cli/connect/mcp/tools/index.d.ts.map +1 -1
- package/dist/src/cli/connect/mcp/tools/index.js +4 -0
- package/dist/src/cli/connect/mcp/tools/index.js.map +1 -1
- package/dist/src/cli/connect/mcp/tools/onboarding.d.ts +14 -0
- package/dist/src/cli/connect/mcp/tools/onboarding.d.ts.map +1 -0
- package/dist/src/cli/connect/mcp/tools/onboarding.js +44 -0
- package/dist/src/cli/connect/mcp/tools/onboarding.js.map +1 -0
- package/dist/src/cli/connect/send.d.ts.map +1 -1
- package/dist/src/cli/connect/send.js +24 -12
- package/dist/src/cli/connect/send.js.map +1 -1
- package/dist/src/cli/connect/skill-bundle.d.ts +9 -1
- package/dist/src/cli/connect/skill-bundle.d.ts.map +1 -1
- package/dist/src/cli/connect/skill-bundle.js +211 -4
- package/dist/src/cli/connect/skill-bundle.js.map +1 -1
- package/dist/src/cli/connect/status.d.ts.map +1 -1
- package/dist/src/cli/connect/status.js +5 -2
- package/dist/src/cli/connect/status.js.map +1 -1
- package/dist/src/cli/connect/tasks.d.ts.map +1 -1
- package/dist/src/cli/connect/tasks.js +21 -11
- package/dist/src/cli/connect/tasks.js.map +1 -1
- package/dist/src/cli/connect/tool-call.d.ts +43 -0
- package/dist/src/cli/connect/tool-call.d.ts.map +1 -0
- package/dist/src/cli/connect/tool-call.js +878 -0
- package/dist/src/cli/connect/tool-call.js.map +1 -0
- package/dist/src/index.js +152 -31
- package/dist/src/index.js.map +1 -1
- package/dist/src/mcp/agent-onboarding.d.ts +20 -0
- package/dist/src/mcp/agent-onboarding.d.ts.map +1 -0
- package/dist/src/mcp/agent-onboarding.js +199 -0
- package/dist/src/mcp/agent-onboarding.js.map +1 -0
- package/dist/src/mcp/agent-tasks.d.ts +4 -2
- package/dist/src/mcp/agent-tasks.d.ts.map +1 -1
- package/dist/src/mcp/agent-tasks.js +42 -24
- package/dist/src/mcp/agent-tasks.js.map +1 -1
- package/dist/src/mcp/agent-telemetry.d.ts +18 -0
- package/dist/src/mcp/agent-telemetry.d.ts.map +1 -0
- package/dist/src/mcp/agent-telemetry.js +45 -0
- package/dist/src/mcp/agent-telemetry.js.map +1 -0
- package/dist/src/mcp/catalog/definitions.d.ts +42 -0
- package/dist/src/mcp/catalog/definitions.d.ts.map +1 -0
- package/dist/src/mcp/catalog/definitions.js +825 -0
- package/dist/src/mcp/catalog/definitions.js.map +1 -0
- package/dist/src/mcp/core.d.ts +1 -0
- package/dist/src/mcp/core.d.ts.map +1 -1
- package/dist/src/mcp/core.js +31 -2
- package/dist/src/mcp/core.js.map +1 -1
- package/dist/src/mcp/index.d.ts +1 -0
- package/dist/src/mcp/index.d.ts.map +1 -1
- package/dist/src/mcp/index.js +5 -0
- package/dist/src/mcp/index.js.map +1 -1
- package/dist/src/routes/agent-directives.d.ts +1 -0
- package/dist/src/routes/agent-directives.d.ts.map +1 -1
- package/dist/src/routes/agent-directives.js +3 -0
- package/dist/src/routes/agent-directives.js.map +1 -1
- package/dist/src/routes/agent-integration.js +1 -1
- package/dist/src/routes/agent-integration.js.map +1 -1
- package/dist/src/routes/agents.d.ts +14 -0
- package/dist/src/routes/agents.d.ts.map +1 -1
- package/dist/src/routes/agents.js +68 -0
- package/dist/src/routes/agents.js.map +1 -1
- package/dist/src/routes/auth.d.ts +14 -0
- package/dist/src/routes/auth.d.ts.map +1 -1
- package/dist/src/routes/auth.js +23 -1
- package/dist/src/routes/auth.js.map +1 -1
- package/dist/src/routes/bootstrap.d.ts +1 -0
- package/dist/src/routes/bootstrap.d.ts.map +1 -1
- package/dist/src/routes/bootstrap.js +3 -1
- package/dist/src/routes/bootstrap.js.map +1 -1
- package/dist/src/routes/libs.d.ts +9 -0
- package/dist/src/routes/libs.d.ts.map +1 -1
- package/dist/src/routes/libs.js +54 -24
- package/dist/src/routes/libs.js.map +1 -1
- package/dist/src/routes/memory.d.ts +1 -0
- package/dist/src/routes/memory.d.ts.map +1 -1
- package/dist/src/routes/memory.js +3 -1
- package/dist/src/routes/memory.js.map +1 -1
- package/dist/src/routes/prompts.d.ts +1 -0
- package/dist/src/routes/prompts.d.ts.map +1 -1
- package/dist/src/routes/prompts.js +3 -1
- package/dist/src/routes/prompts.js.map +1 -1
- package/dist/src/services/agent-post-onboarding.d.ts +31 -0
- package/dist/src/services/agent-post-onboarding.d.ts.map +1 -0
- package/dist/src/services/agent-post-onboarding.js +101 -0
- package/dist/src/services/agent-post-onboarding.js.map +1 -0
- package/dist/src/services/prompt-defaults.d.ts +23 -19
- package/dist/src/services/prompt-defaults.d.ts.map +1 -1
- package/dist/src/services/prompt-defaults.js +43 -37
- package/dist/src/services/prompt-defaults.js.map +1 -1
- package/dist/src/services/skill-bundle/generator.d.ts +8 -0
- package/dist/src/services/skill-bundle/generator.d.ts.map +1 -1
- package/dist/src/services/skill-bundle/generator.js +145 -48
- package/dist/src/services/skill-bundle/generator.js.map +1 -1
- package/dist/src/services/skill-bundle/generic-adapter.d.ts +5 -0
- package/dist/src/services/skill-bundle/generic-adapter.d.ts.map +1 -1
- package/dist/src/services/skill-bundle/generic-adapter.js +35 -15
- package/dist/src/services/skill-bundle/generic-adapter.js.map +1 -1
- package/dist/src/services/skill-bundle/hermes-adapter.d.ts +5 -0
- package/dist/src/services/skill-bundle/hermes-adapter.d.ts.map +1 -1
- package/dist/src/services/skill-bundle/hermes-adapter.js +26 -10
- package/dist/src/services/skill-bundle/hermes-adapter.js.map +1 -1
- package/package.json +3 -2
|
@@ -9,6 +9,14 @@
|
|
|
9
9
|
* - computeBundleVersion(bundle) -- SHA-256 content hash for versioning
|
|
10
10
|
* @version-history
|
|
11
11
|
* v1.0.0 -- 2026-05-23 -- Initial creation for Agent Integration Phase A
|
|
12
|
+
* v1.1.0 -- 2026-05-28 -- Add root BUNDLE.md guide shared by all runtime adapters
|
|
13
|
+
* v1.1.1 -- 2026-05-28 -- Clarify serve-next and Hello Integration MCP sequence
|
|
14
|
+
* v1.1.2 -- 2026-05-28 -- Include task TODO completion in Hello Integration guidance
|
|
15
|
+
* v1.1.3 -- 2026-05-28 -- Clarify MCP tool names are not terminal commands
|
|
16
|
+
* v1.1.4 -- 2026-05-28 -- Include required telemetry reporting in Hello Integration guidance
|
|
17
|
+
* v1.1.5 -- 2026-05-28 -- State that Hello Integration is required first-run onboarding
|
|
18
|
+
* v1.1.6 -- 2026-05-28 -- Clarify post-onboarding setup uses actual commands, config, and knowledge artifacts
|
|
19
|
+
* v1.1.7 -- 2026-05-28 -- Add shared owner-memory tag guidance
|
|
12
20
|
*/
|
|
13
21
|
import { createHash } from 'node:crypto';
|
|
14
22
|
export function generateReferences(ctx) {
|
|
@@ -23,7 +31,13 @@ export function generateReferences(ctx) {
|
|
|
23
31
|
}
|
|
24
32
|
export function generateBundle(ctx, adapter) {
|
|
25
33
|
const references = generateReferences(ctx);
|
|
26
|
-
|
|
34
|
+
const bundle = adapter.generate(ctx, references);
|
|
35
|
+
bundle.files = [
|
|
36
|
+
{ path: 'BUNDLE.md', content: renderBundleGuide(ctx, bundle) },
|
|
37
|
+
...bundle.files.filter(file => file.path !== 'BUNDLE.md'),
|
|
38
|
+
];
|
|
39
|
+
bundle.metadata.version = computeBundleVersion(bundle);
|
|
40
|
+
return bundle;
|
|
27
41
|
}
|
|
28
42
|
export function computeBundleVersion(bundle) {
|
|
29
43
|
const hash = createHash('sha256');
|
|
@@ -57,22 +71,22 @@ ${ctx.nodeUrl}/v1
|
|
|
57
71
|
|
|
58
72
|
| Endpoint | Method | Description |
|
|
59
73
|
|----------|--------|-------------|
|
|
60
|
-
| \`/agents/
|
|
61
|
-
| \`/agents/
|
|
62
|
-
| \`/agents/
|
|
63
|
-
| \`/agents/
|
|
64
|
-
| \`/agents/
|
|
65
|
-
| \`/agents/
|
|
66
|
-
| \`/agents/
|
|
67
|
-
| \`/agents/
|
|
68
|
-
| \`/agents/
|
|
69
|
-
| \`/agents/
|
|
70
|
-
| \`/agents/
|
|
71
|
-
| \`/agents/
|
|
72
|
-
| \`/agents/
|
|
73
|
-
| \`/agents/
|
|
74
|
-
| \`/agents/
|
|
75
|
-
| \`/agents/
|
|
74
|
+
| \`/agents/${ctx.agentName}/inbox\` | GET | Consolidated inbox (queued tasks, active tasks, pending messages) |
|
|
75
|
+
| \`/agents/${ctx.agentName}/inbox?since={cursor}\` | GET | Delta inbox (new items since cursor) |
|
|
76
|
+
| \`/agents/${ctx.agentName}/tasks\` | GET | List your tasks |
|
|
77
|
+
| \`/agents/${ctx.agentName}/tasks/{id}\` | GET | Get task details |
|
|
78
|
+
| \`/agents/${ctx.agentName}/tasks/{id}\` | PATCH | Update task (propose todos, update status) |
|
|
79
|
+
| \`/agents/${ctx.agentName}/tasks/{id}/event\` | POST | Log task event (progress, error) |
|
|
80
|
+
| \`/agents/${ctx.agentName}/tasks/{id}/complete\` | POST | Mark task complete |
|
|
81
|
+
| \`/agents/${ctx.agentName}/messages\` | GET | List messages |
|
|
82
|
+
| \`/agents/${ctx.agentName}/messages\` | POST | Send a message |
|
|
83
|
+
| \`/agents/${ctx.agentName}/directives\` | GET | Get your directives (rules, purpose, constraints) |
|
|
84
|
+
| \`/agents/${ctx.agentName}/capabilities\` | PUT | Report your capabilities |
|
|
85
|
+
| \`/agents/${ctx.agentName}/telemetry\` | POST | Report telemetry (token usage, tool calls) |
|
|
86
|
+
| \`/agents/${ctx.agentName}/webhook\` | PUT | Register webhook URL for push notifications |
|
|
87
|
+
| \`/agents/${ctx.agentName}/skill-bundle/version\` | GET | Check for skill bundle updates |
|
|
88
|
+
| \`/agents/${ctx.agentName}/onboarding\` | GET | Onboarding status |
|
|
89
|
+
| \`/agents/${ctx.agentName}/onboarding/step/{id}\` | POST | Confirm onboarding step |
|
|
76
90
|
|
|
77
91
|
## Response Format
|
|
78
92
|
All responses use the AIMEAT envelope:
|
|
@@ -95,6 +109,78 @@ Errors:
|
|
|
95
109
|
\`\`\`
|
|
96
110
|
`;
|
|
97
111
|
}
|
|
112
|
+
function renderBundleGuide(ctx, bundle) {
|
|
113
|
+
const hasReferences = bundle.files.some(file => file.path.startsWith('references/'));
|
|
114
|
+
const hasScripts = bundle.files.some(file => file.path.startsWith('scripts/'));
|
|
115
|
+
const hasConfig = bundle.files.some(file => file.path.startsWith('config/'));
|
|
116
|
+
const sections = [
|
|
117
|
+
'- `BUNDLE.md` - this guide. The connector prints this after `aimeat connect refresh` so humans can see what changed.',
|
|
118
|
+
'- `SKILL.md` - the main instruction file for the connected agent/runtime. Read this first.',
|
|
119
|
+
];
|
|
120
|
+
if (hasReferences)
|
|
121
|
+
sections.push('- `references/` - deeper protocol notes: API overview, task lifecycle, messages, telemetry, capabilities, and errors.');
|
|
122
|
+
if (hasScripts)
|
|
123
|
+
sections.push('- `scripts/` - runtime helper scripts, such as polling or connection checks, when the selected platform supports them.');
|
|
124
|
+
if (hasConfig)
|
|
125
|
+
sections.push('- `config/` - runtime configuration snippets, hooks, or routes for platforms that support local config files.');
|
|
126
|
+
return `# AIMEAT Skill Bundle
|
|
127
|
+
|
|
128
|
+
## What This Is
|
|
129
|
+
|
|
130
|
+
This folder contains the local AIMEAT skill bundle for agent \`${ctx.agentName}\`. If you are the connected AI agent using this runtime, \`${ctx.agentName}\` is your assigned AIMEAT agent name.
|
|
131
|
+
|
|
132
|
+
- Runtime: \`${bundle.metadata.runtime}\`
|
|
133
|
+
- Bundle: \`${bundle.metadata.bundleName}\`
|
|
134
|
+
- Agent GAII: \`${ctx.agentGaii}\`
|
|
135
|
+
- Node: \`${ctx.nodeUrl}\` (\`${ctx.nodeId}\`)
|
|
136
|
+
|
|
137
|
+
When downloaded with the connector, the original ZIP is kept as \`skill-bundle.zip\` and the useful files are extracted into the same directory.
|
|
138
|
+
|
|
139
|
+
## Files
|
|
140
|
+
|
|
141
|
+
${sections.join('\n')}
|
|
142
|
+
|
|
143
|
+
## What To Do Next
|
|
144
|
+
|
|
145
|
+
1. Start the connector MCP server as the next terminal command and leave it running:
|
|
146
|
+
|
|
147
|
+
\`\`\`bash
|
|
148
|
+
npx aimeat connect serve
|
|
149
|
+
\`\`\`
|
|
150
|
+
|
|
151
|
+
2. After that MCP server is attached to the connected AI agent/runtime, ask the agent to use its AIMEAT tools. Hello Integration is AIMEAT's required first-run onboarding handshake for every newly connected agent:
|
|
152
|
+
|
|
153
|
+
\`\`\`text
|
|
154
|
+
Use your AIMEAT tools. Hello Integration is required AIMEAT first-run onboarding. Read the AIMEAT handbook and directives, check onboarding status, propose TODOs for the onboarding verification task, complete Hello Integration, then publish your actual supported commands, runtime configuration, owner-assigned shared tag memory conventions, and any produced knowledge package artifacts before normal autonomous work.
|
|
155
|
+
\`\`\`
|
|
156
|
+
|
|
157
|
+
3. The agent must complete Hello Integration with these MCP tools. These names appear inside the AI runtime after MCP is attached; they are not terminal commands:
|
|
158
|
+
|
|
159
|
+
\`\`\`text
|
|
160
|
+
aimeat_handbook_get
|
|
161
|
+
aimeat_onboarding_status
|
|
162
|
+
aimeat_onboarding_identify_platform
|
|
163
|
+
aimeat_onboarding_confirm_skill_installed
|
|
164
|
+
aimeat_agent_capabilities_report
|
|
165
|
+
aimeat_onboarding_confirm_directives_read
|
|
166
|
+
aimeat_message_send
|
|
167
|
+
aimeat_agent_telemetry_report
|
|
168
|
+
aimeat_task_list
|
|
169
|
+
aimeat_task_propose_todos
|
|
170
|
+
aimeat_onboarding_status
|
|
171
|
+
aimeat_task_event
|
|
172
|
+
aimeat_task_todo
|
|
173
|
+
aimeat_task_complete
|
|
174
|
+
aimeat_onboarding_status
|
|
175
|
+
\`\`\`
|
|
176
|
+
|
|
177
|
+
Use \`${bundle.metadata.runtime}\` as the installed skill platform unless your runtime has a more specific platform name. For the bundle version field, use \`local\` when no version is shown by the runtime.
|
|
178
|
+
|
|
179
|
+
## Updating
|
|
180
|
+
|
|
181
|
+
Run \`npx aimeat connect refresh\` to download the newest bundle for this agent. The connector prints this file after refresh so the local folder explains itself.
|
|
182
|
+
`;
|
|
183
|
+
}
|
|
98
184
|
function renderTaskLifecycle(ctx) {
|
|
99
185
|
return `# Task Lifecycle
|
|
100
186
|
|
|
@@ -111,10 +197,10 @@ queued -> active -> done
|
|
|
111
197
|
### 1. Task Queued (you receive it)
|
|
112
198
|
Owner creates a task for you. You receive a \`task.queued\` event via webhook or find it in your inbox.
|
|
113
199
|
|
|
114
|
-
**Action:** Fetch the full task via \`GET /v1/agents/
|
|
200
|
+
**Action:** Fetch the full task via \`GET /v1/agents/${ctx.agentName}/tasks/{task_id}\`, then propose a plan by PATCHing with todos:
|
|
115
201
|
|
|
116
202
|
\`\`\`
|
|
117
|
-
PATCH /v1/agents/
|
|
203
|
+
PATCH /v1/agents/${ctx.agentName}/tasks/{task_id}
|
|
118
204
|
{
|
|
119
205
|
"todos": [
|
|
120
206
|
{ "title": "Step 1: Fetch data", "description": "..." },
|
|
@@ -132,7 +218,7 @@ Owner reviews your proposed todos and clicks Start. You receive a \`task.approve
|
|
|
132
218
|
For each todo, do the work, then mark it done:
|
|
133
219
|
|
|
134
220
|
\`\`\`
|
|
135
|
-
PATCH /v1/agents/
|
|
221
|
+
PATCH /v1/agents/${ctx.agentName}/tasks/{task_id}
|
|
136
222
|
{
|
|
137
223
|
"todos": [
|
|
138
224
|
{ "id": "{todo_id}", "status": "done", "result": "Found 47 offers" }
|
|
@@ -142,7 +228,7 @@ PATCH /v1/agents/me/tasks/{task_id}
|
|
|
142
228
|
|
|
143
229
|
Log progress events:
|
|
144
230
|
\`\`\`
|
|
145
|
-
POST /v1/agents/
|
|
231
|
+
POST /v1/agents/${ctx.agentName}/tasks/{task_id}/event
|
|
146
232
|
{
|
|
147
233
|
"type": "progress",
|
|
148
234
|
"message": "Fetched 3/5 store pages"
|
|
@@ -152,13 +238,13 @@ POST /v1/agents/me/tasks/{task_id}/event
|
|
|
152
238
|
### 4. Task Complete
|
|
153
239
|
When all todos are done:
|
|
154
240
|
\`\`\`
|
|
155
|
-
POST /v1/agents/
|
|
241
|
+
POST /v1/agents/${ctx.agentName}/tasks/{task_id}/complete
|
|
156
242
|
\`\`\`
|
|
157
243
|
|
|
158
244
|
### 5. Error Handling
|
|
159
245
|
If you hit a problem:
|
|
160
246
|
\`\`\`
|
|
161
|
-
POST /v1/agents/
|
|
247
|
+
POST /v1/agents/${ctx.agentName}/tasks/{task_id}/event
|
|
162
248
|
{
|
|
163
249
|
"type": "error",
|
|
164
250
|
"message": "K-Ruoka API returned 503"
|
|
@@ -167,7 +253,7 @@ POST /v1/agents/me/tasks/{task_id}/event
|
|
|
167
253
|
|
|
168
254
|
If unrecoverable, fail the task:
|
|
169
255
|
\`\`\`
|
|
170
|
-
POST /v1/agents/
|
|
256
|
+
POST /v1/agents/${ctx.agentName}/tasks/{task_id}/fail
|
|
171
257
|
{
|
|
172
258
|
"reason": "K-Ruoka API is down after 3 retries"
|
|
173
259
|
}
|
|
@@ -180,31 +266,42 @@ POST /v1/agents/me/tasks/{task_id}/fail
|
|
|
180
266
|
- **Log progress.** Post events so the owner can track what you're doing.
|
|
181
267
|
- **Complete or fail.** Every task must end in \`done\` or \`failed\`.
|
|
182
268
|
|
|
183
|
-
## After Setup:
|
|
269
|
+
## After Setup: Publish Your Real Commands, Configuration, Shared Memory, and Knowledge
|
|
270
|
+
|
|
271
|
+
These steps are required after Hello Integration. Do not copy the examples blindly. Publish what this agent/runtime actually supports so the owner's dashboard reflects the real integration.
|
|
184
272
|
|
|
185
273
|
### Push Your Config Files
|
|
186
|
-
Store
|
|
274
|
+
Store actual platform configuration files, hooks, routes, connector descriptors, or installed runtime snippets so your owner can view them in the Agent Config tab. Use keys under \`agents.config.*\`. If this runtime only uses \`aimeat connect serve\` and has no additional config file, publish a small accurate descriptor for that connector; do not invent a watchdog config.
|
|
187
275
|
\`\`\`
|
|
188
276
|
POST /v1/memory
|
|
189
|
-
{ "key": "agents.config
|
|
277
|
+
{ "key": "agents.config.<name>", "value": { "filename": "<actual-file-or-descriptor>", "content": "<actual config or descriptor>", "platform": "<runtime>" }, "visibility": "owner" }
|
|
190
278
|
\`\`\`
|
|
191
279
|
|
|
192
280
|
### Register Your Commands
|
|
193
|
-
Register
|
|
281
|
+
Register every owner-facing slash command this agent can actually understand and answer from the Messages tab. This is the agent's own command catalogue, not the AIMEAT MCP tool list. If the runtime exposes many commands, include the full stable set; if it exposes none, say so to the owner instead of publishing fake commands.
|
|
282
|
+
|
|
194
283
|
The value MUST be a flat array (not wrapped in an object). Each item needs: name (with / prefix), description, category.
|
|
195
284
|
\`\`\`
|
|
196
285
|
POST /v1/memory
|
|
197
286
|
{ "key": "agents.${ctx.agentName}.commands", "value": [
|
|
198
|
-
{ "name": "
|
|
199
|
-
{ "name": "/inbox", "description": "Check inbox for tasks and messages", "category": "tasks" },
|
|
200
|
-
{ "name": "/model", "description": "Show which AI model you are using", "category": "general" }
|
|
287
|
+
{ "name": "/<actual-command>", "description": "<what this command makes the agent do>", "category": "<category>" }
|
|
201
288
|
], "visibility": "owner" }
|
|
202
289
|
\`\`\`
|
|
203
290
|
|
|
291
|
+
When the owner sends one of these slash-prefixed messages, treat it as a command and respond with the promised information or action result.
|
|
292
|
+
|
|
293
|
+
### Use Shared Tag Memory When Assigned
|
|
294
|
+
When the owner assigns shared tags in the Data Access tab, use those tags as same-owner collaboration areas. Write shared project state, handoff notes, queues, and team context under \`agents.tag.<tag>.*\` with \`visibility: "owner"\` and \`tags: ["<tag>"]\`. Read the area with \`GET /v1/memory?owner_scope=true&prefix=agents.tag.<tag>.&tags=<tag>\` or the equivalent \`aimeat_memory_list\` parameters. Do not put private local secrets in shared tag memory.
|
|
295
|
+
|
|
296
|
+
### Publish Knowledge Artifacts
|
|
297
|
+
If onboarding or later work produced structured research, documentation, datasets, or reusable knowledge, create a real knowledge package instead of writing an arbitrary \`research.*\` memory placeholder. Follow \`/llms.txt\` and use \`POST /v1/knowledge/import\` for a new package, \`aimeat_knowledge_contribute\` for entries in an existing package, and \`aimeat_storage_upload\` for large source files or attachments.
|
|
298
|
+
|
|
299
|
+
After import, report the package ID, manifest key, visibility, and whether it is catalog-listed so the owner can link it from Data Access if desired.
|
|
300
|
+
|
|
204
301
|
### Declare Your Services (Hello Integration Step 11)
|
|
205
302
|
If you offer services to other agents on the network, declare them:
|
|
206
303
|
\`\`\`
|
|
207
|
-
POST /v1/agents/
|
|
304
|
+
POST /v1/agents/${ctx.agentName}/onboarding/step/declare_services
|
|
208
305
|
{ "services": [
|
|
209
306
|
{ "name": "translation", "description": "Translate text between languages", "cost": 5 },
|
|
210
307
|
{ "name": "code-review", "description": "Review code for bugs and improvements", "cost": 10 }
|
|
@@ -220,22 +317,22 @@ function renderMessageProtocol(ctx) {
|
|
|
220
317
|
## Inbox
|
|
221
318
|
Messages appear in your inbox. Check via:
|
|
222
319
|
\`\`\`
|
|
223
|
-
GET /v1/agents/
|
|
320
|
+
GET /v1/agents/${ctx.agentName}/inbox
|
|
224
321
|
\`\`\`
|
|
225
322
|
|
|
226
323
|
Or use delta polling:
|
|
227
324
|
\`\`\`
|
|
228
|
-
GET /v1/agents/
|
|
325
|
+
GET /v1/agents/${ctx.agentName}/inbox?since={cursor}
|
|
229
326
|
\`\`\`
|
|
230
327
|
|
|
231
328
|
## Reading Messages
|
|
232
329
|
\`\`\`
|
|
233
|
-
GET /v1/agents/
|
|
330
|
+
GET /v1/agents/${ctx.agentName}/messages?thread_id={thread_id}
|
|
234
331
|
\`\`\`
|
|
235
332
|
|
|
236
333
|
## Sending Messages
|
|
237
334
|
\`\`\`
|
|
238
|
-
POST /v1/agents/
|
|
335
|
+
POST /v1/agents/${ctx.agentName}/messages
|
|
239
336
|
{
|
|
240
337
|
"content": "Your response text",
|
|
241
338
|
"direction": "outbound",
|
|
@@ -250,19 +347,19 @@ POST /v1/agents/me/messages
|
|
|
250
347
|
- New conversations start a new thread (omit thread_id)
|
|
251
348
|
|
|
252
349
|
## Slash Commands
|
|
253
|
-
If you support slash commands
|
|
350
|
+
If you support owner-facing slash commands, register the actual commands you can handle by writing to memory. Do not register examples or internal MCP tool names unless the owner can send them as message commands and you will answer them.
|
|
254
351
|
|
|
255
352
|
\`\`\`
|
|
256
|
-
|
|
257
|
-
{
|
|
258
|
-
"
|
|
259
|
-
|
|
260
|
-
{"name": "/status", "category": "System", "description": "Show agent status"}
|
|
261
|
-
]
|
|
262
|
-
}
|
|
353
|
+
POST /v1/memory
|
|
354
|
+
{ "key": "agents.${ctx.agentName}.commands", "value": [
|
|
355
|
+
{"name": "/<actual-command>", "category": "<category>", "description": "<what the command does>"}
|
|
356
|
+
], "visibility": "owner" }
|
|
263
357
|
\`\`\`
|
|
264
358
|
|
|
265
|
-
The owner's UI will display a command palette with your registered commands.
|
|
359
|
+
The owner's UI will display a command palette with your registered commands. When the owner sends one, answer according to the description you published.
|
|
360
|
+
|
|
361
|
+
## Shared Tag Memory
|
|
362
|
+
If the owner assigned shared tags in Data Access, use \`agents.tag.<tag>.*\` keys for same-owner shared project state, queues, handoff notes, and team context. Write shared entries with \`visibility: "owner"\` and \`tags: ["<tag>"]\`. To read the shared area through memory listing tools or REST, use \`owner_scope=true\`, \`prefix=agents.tag.<tag>.\`, and the same tag filter. Keep private agent-local secrets out of shared tag memory.
|
|
266
363
|
`;
|
|
267
364
|
}
|
|
268
365
|
function renderTelemetryProtocol(ctx) {
|
|
@@ -274,7 +371,7 @@ Telemetry feeds into your readiness score. Agents that report telemetry consiste
|
|
|
274
371
|
## Reporting Telemetry
|
|
275
372
|
|
|
276
373
|
\`\`\`
|
|
277
|
-
POST /v1/agents/
|
|
374
|
+
POST /v1/agents/${ctx.agentName}/telemetry
|
|
278
375
|
{
|
|
279
376
|
"type": "llm_call",
|
|
280
377
|
"tokens_in": 1523,
|
|
@@ -308,7 +405,7 @@ function renderCapabilityReport(ctx) {
|
|
|
308
405
|
Tell AIMEAT what you can do:
|
|
309
406
|
|
|
310
407
|
\`\`\`
|
|
311
|
-
PUT /v1/agents/
|
|
408
|
+
PUT /v1/agents/${ctx.agentName}/capabilities
|
|
312
409
|
{
|
|
313
410
|
"technical": [
|
|
314
411
|
{ "name": "memory", "type": "skill" },
|
|
@@ -368,7 +465,7 @@ For transient errors (429, 500, 502, 503, 504):
|
|
|
368
465
|
## Error Reporting
|
|
369
466
|
When you encounter an error during task execution:
|
|
370
467
|
\`\`\`
|
|
371
|
-
POST /v1/agents/
|
|
468
|
+
POST /v1/agents/${ctx.agentName}/tasks/{task_id}/event
|
|
372
469
|
{
|
|
373
470
|
"type": "error",
|
|
374
471
|
"message": "API returned 503 after 3 retries",
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../src/services/skill-bundle/generator.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../src/services/skill-bundle/generator.ts"],"names":[],"mappings":"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"}
|
|
@@ -5,6 +5,11 @@
|
|
|
5
5
|
* Used for runtimes without a dedicated adapter.
|
|
6
6
|
* @version-history
|
|
7
7
|
* v1.0.0 -- 2026-05-23 -- Initial creation for Agent Integration Phase A
|
|
8
|
+
* v1.1.0 -- 2026-05-28 -- Clarify connected agent identity and Hello Integration MCP flow
|
|
9
|
+
* v1.1.1 -- 2026-05-28 -- Include task TODO completion in Hello Integration guidance
|
|
10
|
+
* v1.1.2 -- 2026-05-28 -- State that Hello Integration is required first-run onboarding
|
|
11
|
+
* v1.1.3 -- 2026-05-28 -- Clarify post-onboarding setup publishes actual commands, config, and knowledge artifacts
|
|
12
|
+
* v1.1.4 -- 2026-05-28 -- Add shared owner-memory tag guidance
|
|
8
13
|
*/
|
|
9
14
|
import type { RuntimeAdapter, BundleContext, BundleFile, BundleContent } from './types.js';
|
|
10
15
|
export declare class GenericAdapter implements RuntimeAdapter {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"generic-adapter.d.ts","sourceRoot":"","sources":["../../../../src/services/skill-bundle/generic-adapter.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"generic-adapter.d.ts","sourceRoot":"","sources":["../../../../src/services/skill-bundle/generic-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3F,qBAAa,cAAe,YAAW,cAAc;IACnD,QAAQ,CAAC,OAAO,aAAa;IAC7B,QAAQ,CAAC,UAAU,kBAAkB;IAErC,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,aAAa;IAsBrE,OAAO,CAAC,aAAa;CA+EtB"}
|
|
@@ -5,6 +5,11 @@
|
|
|
5
5
|
* Used for runtimes without a dedicated adapter.
|
|
6
6
|
* @version-history
|
|
7
7
|
* v1.0.0 -- 2026-05-23 -- Initial creation for Agent Integration Phase A
|
|
8
|
+
* v1.1.0 -- 2026-05-28 -- Clarify connected agent identity and Hello Integration MCP flow
|
|
9
|
+
* v1.1.1 -- 2026-05-28 -- Include task TODO completion in Hello Integration guidance
|
|
10
|
+
* v1.1.2 -- 2026-05-28 -- State that Hello Integration is required first-run onboarding
|
|
11
|
+
* v1.1.3 -- 2026-05-28 -- Clarify post-onboarding setup publishes actual commands, config, and knowledge artifacts
|
|
12
|
+
* v1.1.4 -- 2026-05-28 -- Add shared owner-memory tag guidance
|
|
8
13
|
*/
|
|
9
14
|
import { computeBundleVersion } from './generator.js';
|
|
10
15
|
export class GenericAdapter {
|
|
@@ -40,13 +45,20 @@ export class GenericAdapter {
|
|
|
40
45
|
- GAII: ${ctx.agentGaii}
|
|
41
46
|
- Node: ${ctx.nodeUrl} (${ctx.nodeId})
|
|
42
47
|
|
|
48
|
+
If you are the connected AI agent using this runtime, ${ctx.agentName} is your assigned AIMEAT agent name.
|
|
49
|
+
|
|
50
|
+
Hello Integration is AIMEAT's required first-run onboarding handshake for every newly connected agent. Complete it before normal autonomous work, or report the blocker to your owner.
|
|
51
|
+
|
|
43
52
|
## Quick Start
|
|
44
|
-
1.
|
|
45
|
-
2.
|
|
46
|
-
3.
|
|
47
|
-
4.
|
|
48
|
-
5. Report
|
|
49
|
-
6.
|
|
53
|
+
1. Use the AIMEAT MCP tools exposed by the connector.
|
|
54
|
+
2. Read the handbook with aimeat_handbook_get.
|
|
55
|
+
3. Check Hello Integration with aimeat_onboarding_status.
|
|
56
|
+
4. Confirm platform and skill installation with aimeat_onboarding_identify_platform and aimeat_onboarding_confirm_skill_installed.
|
|
57
|
+
5. Report capabilities with aimeat_agent_capabilities_report.
|
|
58
|
+
6. Confirm directives, send a test message, report telemetry, list tasks, propose TODOs for "Onboarding verification", mark the active test task TODOs done, then complete the task.
|
|
59
|
+
7. Publish post-onboarding setup: your actual owner-facing command catalogue, real runtime/config artifacts, and any knowledge packages or uploaded artifacts you produced.
|
|
60
|
+
|
|
61
|
+
If using direct HTTPS instead of MCP, agent-scoped endpoints use your agent name, for example ${ctx.nodeUrl}/v1/agents/${ctx.agentName}/inbox.
|
|
50
62
|
|
|
51
63
|
## Directives
|
|
52
64
|
${rulesBlock}
|
|
@@ -54,35 +66,43 @@ ${rulesBlock}
|
|
|
54
66
|
## Setup (Manual)
|
|
55
67
|
This is a generic skill bundle. You will need to manually configure:
|
|
56
68
|
- Polling: set up a cron job or scheduled task to poll the inbox endpoint
|
|
57
|
-
- Telemetry: POST to /v1/agents/
|
|
58
|
-
- Webhook (optional): PUT /v1/agents/
|
|
69
|
+
- Telemetry: POST to /v1/agents/${ctx.agentName}/telemetry after each LLM call
|
|
70
|
+
- Webhook (optional): PUT /v1/agents/${ctx.agentName}/webhook to register a push endpoint
|
|
59
71
|
|
|
60
72
|
See the references/ directory for full API documentation.
|
|
61
73
|
|
|
62
|
-
## After Onboarding:
|
|
74
|
+
## After Onboarding: Publish Real Commands, Config, and Knowledge
|
|
63
75
|
|
|
64
|
-
These steps are required after completing Hello Integration. They make your capabilities visible in the owner's dashboard.
|
|
76
|
+
These steps are required after completing Hello Integration. They make your capabilities visible in the owner's dashboard. Do not copy sample commands or config; publish what this runtime actually supports.
|
|
65
77
|
|
|
66
78
|
### Register Commands (owner sees these in Messages tab)
|
|
79
|
+
Introspect your runtime, skills, plugins, and built-in command handling. Register every stable slash command the owner can send to you in AIMEAT Messages. This is your command catalogue, not the AIMEAT MCP tool list.
|
|
67
80
|
\`\`\`
|
|
68
81
|
POST ${ctx.nodeUrl}/v1/memory
|
|
69
82
|
{ "key": "agents.${ctx.agentName}.commands", "value": [
|
|
70
|
-
{ "name": "
|
|
71
|
-
{ "name": "/inbox", "description": "Check inbox for tasks and messages", "category": "tasks" }
|
|
83
|
+
{ "name": "/<actual-command>", "description": "<what this command makes the agent do>", "category": "<category>" }
|
|
72
84
|
], "visibility": "owner" }
|
|
73
85
|
\`\`\`
|
|
74
86
|
The value MUST be a flat array of { name, description, category }. Each name starts with /.
|
|
87
|
+
When the owner sends a slash-prefixed message, treat it as a command and answer with the promised information or action result.
|
|
75
88
|
|
|
76
89
|
### Push Config Files (owner sees these in Agent Config tab)
|
|
90
|
+
Publish actual config files, hooks, routes, connector descriptors, or runtime setup snippets under \`agents.config.*\`. If you only use \`aimeat connect serve\` and have no extra config, publish a truthful descriptor for that connector; do not invent a watchdog file.
|
|
77
91
|
\`\`\`
|
|
78
92
|
POST ${ctx.nodeUrl}/v1/memory
|
|
79
|
-
{ "key": "agents.config
|
|
80
|
-
"
|
|
81
|
-
"
|
|
93
|
+
{ "key": "agents.config.<name>", "value": {
|
|
94
|
+
"filename": "<actual-file-or-descriptor>",
|
|
95
|
+
"content": "<actual config or descriptor>",
|
|
82
96
|
"platform": "your-platform"
|
|
83
97
|
}, "visibility": "owner" }
|
|
84
98
|
\`\`\`
|
|
85
99
|
|
|
100
|
+
### Use Shared Tag Memory When Assigned
|
|
101
|
+
If the owner assigns shared tags in the Data Access tab, those tags are collaboration labels for same-owner agents. Use \`agents.tag.<tag>.*\` keys for shared project state, handoff notes, queues, and team context. Write shared entries with \`visibility: "owner"\` and \`tags: ["<tag>"]\`, then list the area with \`owner_scope=true\`, \`prefix=agents.tag.<tag>.\`, and the same tag filter. Do not store private agent-local secrets in shared tag memory.
|
|
102
|
+
|
|
103
|
+
### Publish Knowledge Artifacts
|
|
104
|
+
If setup or work produced structured research, documentation, datasets, or reusable knowledge, create a real knowledge package instead of a placeholder memory key. Follow \`/llms.txt\`: use \`POST /v1/knowledge/import\` for new packages, \`aimeat_knowledge_contribute\` for entries in existing packages, and \`aimeat_storage_upload\` for large source files or attachments. Report the package ID and manifest key to the owner.
|
|
105
|
+
|
|
86
106
|
## References
|
|
87
107
|
- references/api-overview.md -- Endpoints, auth, response format
|
|
88
108
|
- references/task-lifecycle.md -- Task states and flow
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"generic-adapter.js","sourceRoot":"","sources":["../../../../src/services/skill-bundle/generic-adapter.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"generic-adapter.js","sourceRoot":"","sources":["../../../../src/services/skill-bundle/generic-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD,MAAM,OAAO,cAAc;IAChB,OAAO,GAAG,SAAS,CAAC;IACpB,UAAU,GAAG,cAAc,CAAC;IAErC,QAAQ,CAAC,GAAkB,EAAE,UAAwB;QACnD,MAAM,KAAK,GAAiB;YAC1B,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE;YACtD,GAAG,UAAU;SACd,CAAC;QAEF,MAAM,QAAQ,GAAG;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QAEF,MAAM,MAAM,GAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAClD,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,aAAa,CAAC,GAAkB;QACtC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YAChD,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC7E,CAAC,CAAC,+BAA+B,CAAC;QAEpC,OAAO;;;WAGA,GAAG,CAAC,SAAS;UACd,GAAG,CAAC,SAAS;UACb,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,MAAM;;wDAEoB,GAAG,CAAC,SAAS;;;;;;;;;;;;;gGAa2B,GAAG,CAAC,OAAO,cAAc,GAAG,CAAC,SAAS;;;EAGpI,UAAU;;;;;kCAKsB,GAAG,CAAC,SAAS;uCACR,GAAG,CAAC,SAAS;;;;;;;;;;;OAW7C,GAAG,CAAC,OAAO;mBACC,GAAG,CAAC,SAAS;;;;;;;;;;OAUzB,GAAG,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;CAqBjB,CAAC;IACA,CAAC;CACF"}
|
|
@@ -9,6 +9,11 @@
|
|
|
9
9
|
* - YAML configs: webhook-route.yaml, hooks.yaml
|
|
10
10
|
* @version-history
|
|
11
11
|
* v1.0.0 -- 2026-05-23 -- Initial creation for Agent Integration Phase A
|
|
12
|
+
* v1.1.0 -- 2026-05-28 -- Clarify connected agent identity and Hello Integration MCP flow
|
|
13
|
+
* v1.1.1 -- 2026-05-28 -- Include task TODO completion in Hello Integration guidance
|
|
14
|
+
* v1.1.2 -- 2026-05-28 -- State that Hello Integration is required first-run onboarding
|
|
15
|
+
* v1.1.3 -- 2026-05-28 -- Clarify post-onboarding setup publishes actual commands, config, and knowledge artifacts
|
|
16
|
+
* v1.1.4 -- 2026-05-28 -- Add shared owner-memory tag guidance
|
|
12
17
|
*/
|
|
13
18
|
import type { RuntimeAdapter, BundleContext, BundleFile, BundleContent } from './types.js';
|
|
14
19
|
export declare class HermesAdapter implements RuntimeAdapter {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hermes-adapter.d.ts","sourceRoot":"","sources":["../../../../src/services/skill-bundle/hermes-adapter.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"hermes-adapter.d.ts","sourceRoot":"","sources":["../../../../src/services/skill-bundle/hermes-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3F,qBAAa,aAAc,YAAW,cAAc;IAClD,QAAQ,CAAC,OAAO,YAAY;IAC5B,QAAQ,CAAC,UAAU,mBAAmB;IAEtC,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,aAAa;IA2BrE,OAAO,CAAC,aAAa;IA+FrB,OAAO,CAAC,eAAe;IAkEvB,OAAO,CAAC,mBAAmB;IAmC3B,OAAO,CAAC,oBAAoB;IA2C5B,OAAO,CAAC,kBAAkB;IAyB1B,OAAO,CAAC,eAAe;CAaxB"}
|
|
@@ -9,6 +9,11 @@
|
|
|
9
9
|
* - YAML configs: webhook-route.yaml, hooks.yaml
|
|
10
10
|
* @version-history
|
|
11
11
|
* v1.0.0 -- 2026-05-23 -- Initial creation for Agent Integration Phase A
|
|
12
|
+
* v1.1.0 -- 2026-05-28 -- Clarify connected agent identity and Hello Integration MCP flow
|
|
13
|
+
* v1.1.1 -- 2026-05-28 -- Include task TODO completion in Hello Integration guidance
|
|
14
|
+
* v1.1.2 -- 2026-05-28 -- State that Hello Integration is required first-run onboarding
|
|
15
|
+
* v1.1.3 -- 2026-05-28 -- Clarify post-onboarding setup publishes actual commands, config, and knowledge artifacts
|
|
16
|
+
* v1.1.4 -- 2026-05-28 -- Add shared owner-memory tag guidance
|
|
12
17
|
*/
|
|
13
18
|
import { computeBundleVersion } from './generator.js';
|
|
14
19
|
export class HermesAdapter {
|
|
@@ -51,9 +56,12 @@ trigger: when user mentions AIMEAT, tasks, inbox, or this skill is invoked
|
|
|
51
56
|
## Identity
|
|
52
57
|
You are ${ctx.agentName} on AIMEAT node ${ctx.nodeUrl}
|
|
53
58
|
Your GAII: ${ctx.agentGaii}
|
|
59
|
+
If you are the connected AI agent using this runtime, ${ctx.agentName} is your assigned AIMEAT agent name.
|
|
60
|
+
|
|
61
|
+
Hello Integration is AIMEAT's required first-run onboarding handshake for every newly connected agent. Complete it before normal autonomous work, or report the blocker to your owner.
|
|
54
62
|
|
|
55
63
|
## On First Run
|
|
56
|
-
1. Complete Hello Integration:
|
|
64
|
+
1. Complete Hello Integration with AIMEAT MCP tools before normal autonomous work: call aimeat_handbook_get, aimeat_onboarding_status, aimeat_onboarding_identify_platform, aimeat_onboarding_confirm_skill_installed, aimeat_agent_capabilities_report, aimeat_onboarding_confirm_directives_read, aimeat_message_send, aimeat_agent_telemetry_report, aimeat_task_list, aimeat_task_propose_todos, aimeat_task_event, aimeat_task_todo, and aimeat_task_complete.
|
|
57
65
|
2. Install the watchdog cron job (this delivers AIMEAT messages to you automatically):
|
|
58
66
|
\`\`\`
|
|
59
67
|
cp scripts/poll-inbox.sh ~/.hermes/scripts/
|
|
@@ -65,10 +73,10 @@ Your GAII: ${ctx.agentGaii}
|
|
|
65
73
|
cp config/hooks.yaml ~/.hermes/config/
|
|
66
74
|
hermes reload_skills
|
|
67
75
|
\`\`\`
|
|
68
|
-
4. Register your commands
|
|
76
|
+
4. Register your actual commands, installed config files, and knowledge artifacts in AIMEAT (see "After Onboarding" below and "After Setup" in references)
|
|
69
77
|
|
|
70
78
|
## On Every Wake
|
|
71
|
-
1. Check inbox: GET ${ctx.nodeUrl}/v1/agents/
|
|
79
|
+
1. Check inbox: GET ${ctx.nodeUrl}/v1/agents/${ctx.agentName}/inbox?since={cursor}
|
|
72
80
|
2. Queued tasks without todos -> propose plan (PATCH with todos)
|
|
73
81
|
3. Active tasks -> execute next pending todo
|
|
74
82
|
4. Pending messages -> read and respond
|
|
@@ -86,30 +94,38 @@ ${rulesBlock}
|
|
|
86
94
|
- directive.updated -- Directives changed. Re-fetch via GET /directives.
|
|
87
95
|
- onboarding.step -- Onboarding step needs attention.
|
|
88
96
|
|
|
89
|
-
## After Onboarding:
|
|
97
|
+
## After Onboarding: Publish Real Commands, Config, and Knowledge
|
|
90
98
|
|
|
91
|
-
These steps are required after completing Hello Integration.
|
|
99
|
+
These steps are required after completing Hello Integration. Do not copy sample commands or config; publish what this Hermes runtime actually supports and installed.
|
|
92
100
|
|
|
93
101
|
### Register Commands (owner sees these in Messages tab)
|
|
102
|
+
Introspect Hermes skills, hooks, routes, and command handling. Register every stable slash command the owner can send to you in AIMEAT Messages. This is your command catalogue, not the AIMEAT MCP tool list.
|
|
94
103
|
\`\`\`
|
|
95
104
|
POST ${ctx.nodeUrl}/v1/memory
|
|
96
105
|
{ "key": "agents.${ctx.agentName}.commands", "value": [
|
|
97
|
-
{ "name": "
|
|
98
|
-
{ "name": "/inbox", "description": "Check inbox for tasks and messages", "category": "tasks" }
|
|
106
|
+
{ "name": "/<actual-command>", "description": "<what this command makes the agent do>", "category": "<category>" }
|
|
99
107
|
], "visibility": "owner" }
|
|
100
108
|
\`\`\`
|
|
101
109
|
The value MUST be a flat array of { name, description, category }. Each name starts with /.
|
|
110
|
+
When the owner sends a slash-prefixed message, treat it as a command and answer with the promised information or action result.
|
|
102
111
|
|
|
103
112
|
### Push Config Files (owner sees these in Agent Config tab)
|
|
113
|
+
Publish the actual Hermes config files, hook files, route files, or installed script descriptors under \`agents.config.*\`. The examples below refer to real bundle files; replace content with what was actually installed.
|
|
104
114
|
\`\`\`
|
|
105
115
|
POST ${ctx.nodeUrl}/v1/memory
|
|
106
|
-
{ "key": "agents.config.
|
|
107
|
-
"
|
|
108
|
-
"
|
|
116
|
+
{ "key": "agents.config.hermes-hooks", "value": {
|
|
117
|
+
"filename": "config/hooks.yaml",
|
|
118
|
+
"content": "<actual hooks.yaml content>",
|
|
109
119
|
"platform": "hermes-agent"
|
|
110
120
|
}, "visibility": "owner" }
|
|
111
121
|
\`\`\`
|
|
112
122
|
|
|
123
|
+
### Use Shared Tag Memory When Assigned
|
|
124
|
+
If the owner assigns shared tags in the Data Access tab, those tags are collaboration labels for same-owner agents. Use \`agents.tag.<tag>.*\` keys for shared project state, handoff notes, queues, and team context. Write shared entries with \`visibility: "owner"\` and \`tags: ["<tag>"]\`, then list the area with \`owner_scope=true\`, \`prefix=agents.tag.<tag>.\`, and the same tag filter. Do not store private agent-local secrets in shared tag memory.
|
|
125
|
+
|
|
126
|
+
### Publish Knowledge Artifacts
|
|
127
|
+
If setup or work produced structured research, documentation, datasets, or reusable knowledge, create a real knowledge package instead of a placeholder memory key. Follow \`/llms.txt\`: use \`POST /v1/knowledge/import\` for new packages, \`aimeat_knowledge_contribute\` for entries in existing packages, and \`aimeat_storage_upload\` for large source files or attachments. Report the package ID and manifest key to the owner.
|
|
128
|
+
|
|
113
129
|
## References
|
|
114
130
|
See references/ directory for detailed API documentation:
|
|
115
131
|
- api-overview.md -- Endpoints, auth, response format
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hermes-adapter.js","sourceRoot":"","sources":["../../../../src/services/skill-bundle/hermes-adapter.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"hermes-adapter.js","sourceRoot":"","sources":["../../../../src/services/skill-bundle/hermes-adapter.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "aimeat",
|
|
3
|
-
"version": "1.9.
|
|
3
|
+
"version": "1.9.5",
|
|
4
4
|
"description": "AIME AT - AI Memory Exchange and Action Transfer - reference implementation",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/src/index.js",
|
|
@@ -172,6 +172,7 @@
|
|
|
172
172
|
"seed:examples": "node --import tsx scripts/seed-digital-signage.ts",
|
|
173
173
|
"indexnow": "node --env-file=.env --import tsx scripts/indexnow.ts",
|
|
174
174
|
"audit": "pnpm audit --audit-level=high",
|
|
175
|
-
"audit:fix": "pnpm audit --fix"
|
|
175
|
+
"audit:fix": "pnpm audit --fix",
|
|
176
|
+
"audit:mcp-tools": "tsx scripts/audit-mcp-tools.ts"
|
|
176
177
|
}
|
|
177
178
|
}
|