@nylorun/admin 0.16.0-beta → 0.17.1-beta
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/CHANGELOG.md +58 -0
- package/README.md +5 -5
- package/dist/management.d.ts +7 -1
- package/dist/management.js +1 -0
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,63 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.17.1-beta
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- 000ff75: **READMEs and help text match protocol 14.**
|
|
8
|
+
|
|
9
|
+
- `nylorun --help` lists `environments fork`, `manifests` and `delete-version`. The package description no longer offers `nylo` as the Runtime client, and the README says nylorun depends on `@nylorun/agents` too.
|
|
10
|
+
- The READMEs name the current commands: `nylorun tenant keys`, `nylorun tenant mcp inspect`, `nylorun local logs` and `nylorun local reset`. `@nylorun/admin` says it speaks protocol 14.
|
|
11
|
+
- `@nylorun/agents`: a lost MCP or HTTP tool call is sent again with its key, then fails to the model as `tool.interrupted` (it is not left `uncertain`). Every manifest is v7. A2A takes `raw` files. A delegated agent cannot pause.
|
|
12
|
+
- `@nylorun/runtime`: the README describes protocol 14, `PUT /v1/sessions/{id}` says it answers an identical session (vaults are no longer attached), and the database-layout error names `nylorun local reset`.
|
|
13
|
+
- `@nylorun/create-agent`: `nylorun start` writes the project's keys (no key is derived any more).
|
|
14
|
+
|
|
15
|
+
- Pin core to the tested release.
|
|
16
|
+
- Updated dependencies [620072d]
|
|
17
|
+
- Updated dependencies [a0cf8b2]
|
|
18
|
+
- @nylorun/core@0.22.0-beta
|
|
19
|
+
|
|
20
|
+
## 0.17.0-beta
|
|
21
|
+
|
|
22
|
+
### Minor Changes
|
|
23
|
+
|
|
24
|
+
- c96b9a8: **An agent manifest is flat: manifest v7, a `runtime` block the Runtime writes, and tools known by name (protocol 13, Harness API 3).** A manifest listed capabilities, each with its own instructions, tools, skills and servers, and the Runtime added its own as more capabilities. Now the agent's parts sit at the top level, a plugin's skills and servers say which plugin brought them, and what the Runtime adds to a session's agent is one `runtime` block. A fresh start: the Runtime speaks protocol 13 only, so save your agents again; sessions from protocol 12 do not carry over. See MIGRATION.md.
|
|
25
|
+
|
|
26
|
+
- **Manifest v7.** `{ manifestSchemaVersion: 7, id, name?, description?, metadata?, outputSchema?, instructions?, tools?, skills?, mcpServers?, runtime? }`. Versions 3 to 6 and a `capabilities` field are refused with a message to rebuild. `SkillManifest.plugin` and `McpServerManifest.plugin` are `{ name, version? }`, set by `.plugin(dir)` from `plugin.json`.
|
|
27
|
+
- **The `runtime` block.** `{ sandbox?, tools?, instructions? }`, written only by the Runtime when a session pins the agent: the sandbox spec and tools, `save_artifact`, `read_artifact`, `load_skill` and `read_skill_resource`, the skill catalog and the notes that go with them. A definition or a turn variant that sets it is refused. `runtimeManifestFor` in `@nylorun/core/define` replaces `sandboxCapabilityManifest`, `artifactsCapabilityManifest` and `toolsCapabilityManifest`. `.skills()` and `.plugin()` no longer add the skill tools or the catalog.
|
|
28
|
+
- **Names.** An agent's tool may not take a Runtime tool's name (`RUNTIME_TOOL_NAMES`) or contain `__`, and names are unique across tools, skills and servers.
|
|
29
|
+
- **Turn variants** may remove tools, tighten MCP servers and change instructions, name, description and metadata. Skills are fixed, and a variant never sets `runtime` or changes `outputSchema`.
|
|
30
|
+
- **Tools by name.** `capabilityId` is gone from `tool.completed`, `mcp.discovered`, tool call rows, `EffectIntent`, gate requests, checkpoints and `SessionToolRef`. An HTTP tool's `server` is its URL's host. `Implementations` is `{ tools }`, keyed by tool name (`Agent.from(json, { tools })`), `AgentBinding.declarations` is `parts`, and observe events say `partId`.
|
|
31
|
+
- **Harness API 3.** `hello.capabilities` is `features`, and the `harness` pseudo-capability is gone: a native tool is known by its name, and one whose name is taken fails the turn at its start. `createHarness({ features })` in `@nylorun/harness`. `examples/harness-minimal` speaks it.
|
|
32
|
+
- **Studio.** The Agent tab shows instructions, tools (HTTP and agent badges), skills and MCP servers, each skill and server with its plugin's badge and a filter by plugin, and a session's Runtime section: its sandbox, tools and instructions.
|
|
33
|
+
- `@nylorun/core`: `PROTOCOL_VERSION` 13, `HOST_PROTOCOL` `{ min: 13, max: 13 }`, required feature `flat-manifest`, `HARNESS_API_VERSION` 3; `PluginLabel`, `RuntimeManifest`, `RUNTIME_TOOL_NAMES`, `isRuntimeToolName`, `runtimeToolOf`, `isSkillTool`, `SKILLS_USAGE` and `formatSkillCatalog` in `/define`.
|
|
34
|
+
- `@nylorun/agents`, `@nylorun/admin`, `@nylorun/studio` and `nylorun` send protocol 13.
|
|
35
|
+
|
|
36
|
+
- 94bf329: **Each model says what it reads, a file it does not read is refused before a turn starts, and a file is an artifact the model reads again after its turn (protocol 12).** A message could name any file, and a model that could not read it failed the turn at its model call; every later turn sent the file's bytes again. Now the Runtime knows what the Tenant's model reads, checks a message's files when it is accepted, and sends a file's bytes only in the turn that brought it. Protocol 12 only adds to 11: the Runtime serves both.
|
|
37
|
+
|
|
38
|
+
- **Model inputs.** A model reads `text`, and `image`, `pdf`, `office`, `audio` or `video` when its catalog says so or the operator adds it where its API carries it natively (images everywhere; PDFs on the Anthropic, OpenAI, Azure and Google APIs; Office documents on the OpenAI Responses APIs; audio and video on Google's APIs and OpenAI-compatible completions). `GET /v1/tenant/models` gives each model `inputs` and `addableInputs`, `GET /v1/tenant/providers` each provider's `inputs`, and **`PUT /v1/tenant/models/inputs`** (the Management API; `admin.models.setInputs({ provider, model, inputs })`) sets the added ones, kept in the Tenant setting `model.inputs`. The Model Gate gives the provider adapter a model with an added image, so it is sent.
|
|
39
|
+
- **A custom endpoint reads text only by default.** It used to be sent images. Set `settings.inputs` on `PUT /v1/tenant/model` (`image`, `pdf`, `audio`, `video`) for what yours reads; `office` is refused there. See MIGRATION.md.
|
|
40
|
+
- **The accept check.** A message naming a file of a type the Tenant's model does not read is `422 attachment_unsupported`, with `details.parts` (`artifactId`, `name`, `mediaType`, `reason`), and no turn starts. Only the type is checked, never the size. Without a model in the vault nothing is refused.
|
|
41
|
+
- **Files as artifacts.** After its turn a file is a reference line, `[Uploaded artifact "name" · <artifactId> v<n> · read_artifact to view]` (a tool's: `[Tool <name> returned artifact …]`). Our harness sends the turn's own files once more, as media, in one user message after the conversation, so a message reads the same in every later call. At the gate, an image the model reads is an image, a text file a `<file>` block, and any other file, or one that cannot be read, a note: no file fails a call. PDFs, Office documents, audio and video are notes until the gate sends them natively.
|
|
42
|
+
- **`read_artifact` for every agent.** Every agent's session has it (an agent that declares its own keeps it), so every agent session pins its definition with it added. It takes a `version`, reads the Tenant-wide artifacts the session's messages named, and shows any file the Tenant's model reads; one it does not read fails `artifact.unsupported`.
|
|
43
|
+
- **Compaction** keeps the summarized part's reference lines (`files` on the compaction entry), and counts the turn's files by type and size in its token estimate.
|
|
44
|
+
- `@nylorun/core`: `PROTOCOL_VERSION` 12, required feature `model-inputs`, `HOST_PROTOCOL` `{ min: 11, max: 12 }`, error code `attachment_unsupported`; `MODEL_INPUTS`, `ModelInputSchema`, `PutModelInputsRequestSchema`, `ModelInputsViewSchema`, `CustomModelSettings.inputs`; `mediaReferenceLine` and `mediaReferenceOf` in `/define`; `TranscriptCompactionEntry.files`.
|
|
45
|
+
- `@nylorun/agents`, `@nylorun/studio` and `nylorun` send protocol 12.
|
|
46
|
+
|
|
47
|
+
### Patch Changes
|
|
48
|
+
|
|
49
|
+
- Pin core to the tested release.
|
|
50
|
+
- Updated dependencies [3a32a57]
|
|
51
|
+
- Updated dependencies [af90d1e]
|
|
52
|
+
- Updated dependencies [104f24f]
|
|
53
|
+
- Updated dependencies [c96b9a8]
|
|
54
|
+
- Updated dependencies [94bf329]
|
|
55
|
+
- Updated dependencies [b5ea2b5]
|
|
56
|
+
- Updated dependencies [aff9bb8]
|
|
57
|
+
- Updated dependencies [f44c018]
|
|
58
|
+
- Updated dependencies [c8e640b]
|
|
59
|
+
- @nylorun/core@0.21.0-beta
|
|
60
|
+
|
|
3
61
|
## 0.16.0-beta
|
|
4
62
|
|
|
5
63
|
### Minor Changes
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @nylorun/admin
|
|
2
2
|
|
|
3
|
-
The Management API client (protocol
|
|
3
|
+
The Management API client (protocol 14): the Tenant's status, seed and reset, its
|
|
4
4
|
models, credential coverage, MCP server previews, signing keys, settings and application keys, through
|
|
5
5
|
`/v1/tenant/*` with a **management key**. It also holds the two helpers over the
|
|
6
6
|
admin key that Studio needs. Depends only on `@nylorun/core`.
|
|
@@ -48,11 +48,11 @@ validate (and nothing else names the Host root), or the linked Project's
|
|
|
48
48
|
what it tried. Only this local-Host step reads the Host root: `@nylorun/agents`
|
|
49
49
|
takes the Runtime API's key from the Project or the environment only. The
|
|
50
50
|
Project files' reader is `@nylorun/core/project`. The first request checks the
|
|
51
|
-
Host's `/health` and throws `incompatible_host` unless the Host serves protocol
|
|
52
|
-
|
|
51
|
+
Host's `/health` and throws `incompatible_host` unless the Host serves this client's protocol
|
|
52
|
+
(14) with its features, `management-api` among them.
|
|
53
53
|
|
|
54
54
|
Management keys are issued on the Tenant's machine only:
|
|
55
|
-
`npx nylorun
|
|
55
|
+
`npx nylorun tenant keys put <id> --management` on a local Tenant, or
|
|
56
56
|
`nylorun-operate keys put <id> --role management` inside the runtime container
|
|
57
57
|
([SELF_HOSTING.md](../../guides/SELF_HOSTING.md#keys)). No API call creates one.
|
|
58
58
|
|
|
@@ -62,7 +62,7 @@ Management keys are issued on the Tenant's machine only:
|
|
|
62
62
|
| --- | --- | --- |
|
|
63
63
|
| `admin.tenant` | `status()`, `seed(request)`, `reset(request)` | `GET /v1/tenant`, `PUT /v1/tenant/config/seed`, `POST /v1/tenant/reset` |
|
|
64
64
|
| `admin.keys` | `list()`, `put(id)`, `delete(id)` | `/v1/tenant/keys…` |
|
|
65
|
-
| `admin.models` | `catalog()`, `providers()`, `get()`, `put(request)`, `select(request)`, `usage(query)`, `budgets.get()`, `budgets.put(request)` | `/v1/tenant/models`, `/providers`, `/model`, `/model/selection`, `/usage`, `/budgets` |
|
|
65
|
+
| `admin.models` | `catalog()`, `providers()`, `get()`, `put(request)`, `select(request)`, `setInputs(request)`, `usage(query)`, `budgets.get()`, `budgets.put(request)` | `/v1/tenant/models`, `/providers`, `/model`, `/model/selection`, `/models/inputs`, `/usage`, `/budgets` |
|
|
66
66
|
| `admin.coverage` | called directly: `admin.coverage({ agentId, environmentId? })` | `POST /v1/tenant/credential-coverage` |
|
|
67
67
|
| `admin.mcp` | `preview({ url, type?, name?, environmentId? })` | `POST /v1/tenant/mcp/preview` |
|
|
68
68
|
| `admin.toolPolicy` | `get()`, `put({ rules })`: which MCP and HTTP tool calls run, wait for a person (`ask`) or are refused (`deny`) | `/v1/tenant/tool-policy` |
|
package/dist/management.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { type CredentialCoverage, type CredentialCoverageRequest, type HostModelCatalog, type HostModelView, type ListProvidersResponse, type McpPreview, type McpPreviewRequest, type ModelCallExportPage, type ModelBudgets, type ModelUsageQuery, type ModelUsageTotals, type OperatorKey, type PutHostModelRequest, type PutModelBudgetsRequest, type PutToolPolicyRequest, type PutOperatorKeyResponse, type PutTenantArtifactsRequest, type PutTenantEnvironmentsRequest, type ResetTenantRequest, type ResetTenantResponse, type SeedTenantConfigRequest, type SeedTenantConfigResponse, type SelectHostModelRequest, type SigningKeyView, type TenantArtifactsView, type TenantSandboxView, type TenantStatus, type ToolPolicy } from "@nylorun/core/contracts";
|
|
1
|
+
import { type CredentialCoverage, type CredentialCoverageRequest, type HostModelCatalog, type HostModelView, type ListProvidersResponse, type McpPreview, type McpPreviewRequest, type ModelCallExportPage, type ModelBudgets, type ModelInputsView, type ModelUsageQuery, type ModelUsageTotals, type OperatorKey, type PutHostModelRequest, type PutModelBudgetsRequest, type PutModelInputsRequest, type PutToolPolicyRequest, type PutOperatorKeyResponse, type PutTenantArtifactsRequest, type PutTenantEnvironmentsRequest, type ResetTenantRequest, type ResetTenantResponse, type SeedTenantConfigRequest, type SeedTenantConfigResponse, type SelectHostModelRequest, type SigningKeyView, type TenantArtifactsView, type TenantSandboxView, type TenantStatus, type ToolPolicy } from "@nylorun/core/contracts";
|
|
2
2
|
export interface ManagementClientOptions {
|
|
3
3
|
/** The Tenant's URL, or a proxy in front of it. */
|
|
4
4
|
url: string;
|
|
@@ -41,6 +41,12 @@ export interface ManagementModels {
|
|
|
41
41
|
put(request: Body<PutHostModelRequest>): Promise<HostModelView>;
|
|
42
42
|
/** Chooses the provider and model among those with credentials. */
|
|
43
43
|
select(request: Body<SelectHostModelRequest>): Promise<HostModelView>;
|
|
44
|
+
/**
|
|
45
|
+
* Sets what a catalog model reads beyond its catalog's inputs (protocol 12): only inputs in its
|
|
46
|
+
* `addableInputs`; an empty list removes the additions. A custom endpoint sets
|
|
47
|
+
* `settings.inputs` with `put` instead.
|
|
48
|
+
*/
|
|
49
|
+
setInputs(request: Body<PutModelInputsRequest>): Promise<ModelInputsView>;
|
|
44
50
|
/** What the Tenant's model calls used, for one scope and period. */
|
|
45
51
|
usage(query: ModelUsageQuery): Promise<ModelUsageTotals>;
|
|
46
52
|
/**
|
package/dist/management.js
CHANGED
|
@@ -69,6 +69,7 @@ export class ManagementClient {
|
|
|
69
69
|
get: () => call("GET", "/v1/tenant/model"),
|
|
70
70
|
put: (request) => call("PUT", "/v1/tenant/model", withId(request)),
|
|
71
71
|
select: (request) => call("PUT", "/v1/tenant/model/selection", withId(request)),
|
|
72
|
+
setInputs: (request) => call("PUT", "/v1/tenant/models/inputs", withId(request)),
|
|
72
73
|
usage: (query) => {
|
|
73
74
|
const search = new URLSearchParams(Object.entries(query).flatMap(([name, value]) => value === undefined ? [] : [[name, String(value)]]));
|
|
74
75
|
return call("GET", `/v1/tenant/usage?${search}`);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@nylorun/admin",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.17.1-beta",
|
|
4
4
|
"description": "Nylorun Management API client: the Tenant's models, vaults, signing keys, settings and application keys",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "Apache-2.0",
|
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
"clean": "node -e \"import('node:fs').then(({rmSync})=>rmSync('dist',{recursive:true,force:true}))\""
|
|
29
29
|
},
|
|
30
30
|
"dependencies": {
|
|
31
|
-
"@nylorun/core": "0.
|
|
31
|
+
"@nylorun/core": "0.22.0-beta"
|
|
32
32
|
},
|
|
33
33
|
"peerDependencies": {
|
|
34
34
|
"zod": "^4.6.5"
|