@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.
Files changed (2) hide show
  1. package/HOSTING.md +16 -2
  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? }` | `{ hash }`; refuse a hash that differs |
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, and point names at hashes only when someone publishes.
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.1",
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.1",
246
- "@finalai/agent-protocol": "0.15.1",
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",