@finalai/agent-provider 0.16.1 → 0.16.3
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/HOSTING.md +16 -2
- package/package.json +3 -3
package/HOSTING.md
CHANGED
|
@@ -54,7 +54,7 @@ Routes, under `/api/v1/projects/:projectId/agents`:
|
|
|
54
54
|
|
|
55
55
|
| Route | Body / query | Response |
|
|
56
56
|
| ---------------- | ----------------------------------- | -------------------------------------- |
|
|
57
|
-
| `PUT /documents` | `{ document, hash? }`
|
|
57
|
+
| `PUT /documents` | `{ document \| source, hash? }` | `{ hash }`; refuse a hash that differs |
|
|
58
58
|
| `POST /publish` | `{ name, hash }` | `{ id, name, hash, publishedAt }` |
|
|
59
59
|
| `GET /lookup` | exactly one of `name`, `id`, `hash` | `agentInfoSchema` |
|
|
60
60
|
| `GET /history` | `name`, `cursor?`, `limit?` | `agentHistorySchema` |
|
|
@@ -62,6 +62,19 @@ Routes, under `/api/v1/projects/:projectId/agents`:
|
|
|
62
62
|
An agent is always passed as an object, `{ hash, document? }`, never a name. A
|
|
63
63
|
request whose document is absent names a hash the host already stores.
|
|
64
64
|
|
|
65
|
+
A store sends either the document or its `source` (`agentSourceSchema`): the
|
|
66
|
+
files the document is made from, by path. A host given `source` makes the
|
|
67
|
+
document from those files itself and keeps them with it. It refuses a source
|
|
68
|
+
that does not make a document (`agent_source_invalid`, with
|
|
69
|
+
`details.diagnostics`) and, when `hash` is sent, one whose document hashes
|
|
70
|
+
differently (`hash_mismatch`). `GET /lookup` returns the kept files as `source`
|
|
71
|
+
(null when there are none).
|
|
72
|
+
|
|
73
|
+
Every publication keeps its source: `POST /publish` refuses a hash stored without one. A host
|
|
74
|
+
that keeps drafts makes a publication made elsewhere the next draft, and refuses one that lacks
|
|
75
|
+
what was published from drafts since its publisher last published (`draft_conflict`), keeping
|
|
76
|
+
the merge as the newest draft.
|
|
77
|
+
|
|
65
78
|
## Provide documents
|
|
66
79
|
|
|
67
80
|
```json
|
|
@@ -353,7 +366,8 @@ These packages define contracts and client behaviour, not a platform. A host
|
|
|
353
366
|
implementing them must:
|
|
354
367
|
|
|
355
368
|
1. Store documents by `agentDocumentHash`, re-check self-contained serverless
|
|
356
|
-
source,
|
|
369
|
+
source, make documents from agent `source` without giving that code network
|
|
370
|
+
or host access, and point names at hashes only when someone publishes.
|
|
357
371
|
2. Run `unmetRequirements` on every call that starts work and at every session
|
|
358
372
|
open, and create nothing when it fails.
|
|
359
373
|
3. Store each `provide` as given; never fill a requirement on a caller's behalf.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@finalai/agent-provider",
|
|
3
|
-
"version": "0.16.
|
|
3
|
+
"version": "0.16.3",
|
|
4
4
|
"private": false,
|
|
5
5
|
"description": "Provider contracts for the agent stack: the agent document, requirements and inference, harnesses, sandboxes (handle, wire, grants, setups, MCP projection), the code host, channels, and the conformance kit.",
|
|
6
6
|
"license": "Apache-2.0",
|
|
@@ -242,8 +242,8 @@
|
|
|
242
242
|
},
|
|
243
243
|
"dependencies": {
|
|
244
244
|
"@agentclientprotocol/sdk": "1.8.0",
|
|
245
|
-
"@finalai/acp-session": "0.8.
|
|
246
|
-
"@finalai/agent-protocol": "0.
|
|
245
|
+
"@finalai/acp-session": "0.8.3",
|
|
246
|
+
"@finalai/agent-protocol": "0.17.0",
|
|
247
247
|
"@modelcontextprotocol/client": "^2.1.0",
|
|
248
248
|
"@modelcontextprotocol/core": "^2.1.0",
|
|
249
249
|
"@modelcontextprotocol/server": "^2.1.0",
|