antpath 0.10.8 → 0.10.9
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/README.md +1 -1
- package/dist/_shared/blueprint.d.ts +4 -2
- package/dist/_shared/proxy-protocol.d.ts +2 -1
- package/dist/_shared/proxy-protocol.js +4 -2
- package/dist/_shared/submission.d.ts +3 -2
- package/dist/file.d.ts +10 -2
- package/dist/file.js +10 -2
- package/dist/file.js.map +1 -1
- package/docs/credentials.md +4 -4
- package/docs/outputs.md +7 -5
- package/docs/skills.md +12 -7
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -27,7 +27,7 @@ antpath delete <run-id> --api-token …
|
|
|
27
27
|
antpath whoami --api-token …
|
|
28
28
|
```
|
|
29
29
|
|
|
30
|
-
The SDK class and the CLI are backed by the same `@antpath/shared` operations module — any read or write you can do through one, you can do through the other, against the same durable run records. The same npm package also ships the in-container `antpath` CLI as its `bin` entry; the worker mounts that CLI at `/antpath/antpath`
|
|
30
|
+
The SDK class and the CLI are backed by the same `@antpath/shared` operations module — any read or write you can do through one, you can do through the other, against the same durable run records. The same npm package also ships the in-container `antpath` CLI as its `bin` entry; the worker mounts that CLI inside every run at `/mnt/session/uploads/antpath/antpath` (Anthropic Managed Agents rebases every session-resource mount under `/mnt/session/uploads/`, and mounted files have no execute permission so they are invoked through `node`), so skills can call `node /mnt/session/uploads/antpath/antpath proxy …` against the per-run manifest. See [Agent-first surface design](../../references/development-principles.md#agent-first-surface-design).
|
|
31
31
|
|
|
32
32
|
The dashboard URL defaults to `https://www.antpath.ai`. Self-hosted deployments override with `--dashboard-url` on the CLI or `baseUrl` on `AntpathClient`. The workspace is derived server-side from your API token (1:1 binding), so there is no `--workspace` flag and no `workspaceId` option.
|
|
33
33
|
|
|
@@ -172,8 +172,10 @@ export interface WorkspaceFileRef {
|
|
|
172
172
|
*
|
|
173
173
|
* `name` is the workspace-visible name prefix. `contentHash` is the
|
|
174
174
|
* SDK's advisory `sha256:<hex>`. `mountPath` is optional — when
|
|
175
|
-
* present it overrides the default `/antpath/files/<id>/<rel>`
|
|
176
|
-
*
|
|
175
|
+
* present it overrides the default `/antpath/files/<id>/<rel>`
|
|
176
|
+
* `mount_path` we send to Anthropic (the agent sees the file at
|
|
177
|
+
* `/mnt/session/uploads/antpath/files/<id>/<rel>` once Anthropic
|
|
178
|
+
* rebases the mount).
|
|
177
179
|
*/
|
|
178
180
|
export interface TransientFileRef {
|
|
179
181
|
readonly kind: "transient_file";
|
|
@@ -32,7 +32,8 @@ export declare function narrowResponseMode(policy: ProxyResponseMode, requested:
|
|
|
32
32
|
export declare const PROXY_ERROR_CODES: readonly ["unsupported_protocol", "unauthorized", "endpoint_not_found", "policy_denied", "rate_limited", "budget_exceeded", "ssrf_denied", "upstream_timeout", "upstream_error", "exceeded_cap", "bad_request", "internal_error"];
|
|
33
33
|
export type ProxyErrorCode = (typeof PROXY_ERROR_CODES)[number];
|
|
34
34
|
/**
|
|
35
|
-
* Shape of the JSON written to
|
|
35
|
+
* Shape of the JSON written to the per-run manifest mounted inside
|
|
36
|
+
* the container (`/mnt/session/uploads/antpath/index.json`).
|
|
36
37
|
*
|
|
37
38
|
* Always present (every run), regardless of whether any proxy endpoints
|
|
38
39
|
* were declared. With zero endpoints, `endpoints` is `[]` and
|
|
@@ -1,5 +1,7 @@
|
|
|
1
|
-
// Wire format between the in-container CLI (
|
|
2
|
-
//
|
|
1
|
+
// Wire format between the in-container CLI (mounted at
|
|
2
|
+
// `/mnt/session/uploads/antpath/antpath`, invoked through `node`) and
|
|
3
|
+
// the dashboard BFF proxy route
|
|
4
|
+
// (`POST /api/runs/:runId/proxy/:endpointName`).
|
|
3
5
|
//
|
|
4
6
|
// This module is the single source of truth for the request shape, the
|
|
5
7
|
// response shape, the error-code enum, and the protocol version header.
|
|
@@ -121,8 +121,9 @@ export interface PlatformRunSubmissionRequest {
|
|
|
121
121
|
/**
|
|
122
122
|
* Declared HTTP endpoints reachable via the antpath managed proxy
|
|
123
123
|
* during this run. Empty array (or omitted) → no proxy surface is
|
|
124
|
-
* provisioned; the
|
|
125
|
-
*
|
|
124
|
+
* provisioned; the per-run manifest the CLI reads
|
|
125
|
+
* (`/mnt/session/uploads/antpath/index.json` in-container) shows
|
|
126
|
+
* `endpoints: []` and the `run-token` mount is omitted.
|
|
126
127
|
*/
|
|
127
128
|
readonly proxyEndpoints?: readonly PlatformProxyEndpoint[];
|
|
128
129
|
}
|
package/dist/file.d.ts
CHANGED
|
@@ -6,7 +6,12 @@ import type { FileRef } from "./_shared/index.js";
|
|
|
6
6
|
* will:
|
|
7
7
|
*
|
|
8
8
|
* 1. Upload to the Anthropic Files API at session create, mounting
|
|
9
|
-
* each entry
|
|
9
|
+
* each entry with `mount_path: "/antpath/files/<f_id>/<rel-path>"`.
|
|
10
|
+
* Anthropic Managed Agents rebases all session mounts under
|
|
11
|
+
* `/mnt/session/uploads/`, so the agent sees the file at
|
|
12
|
+
* `/mnt/session/uploads/antpath/files/<f_id>/<rel-path>` — see
|
|
13
|
+
* `references/architecture-decisions.md` (Anthropic Managed Agents
|
|
14
|
+
* session-mount mechanics).
|
|
10
15
|
* 2. List all mount paths in the synthetic first user message so the
|
|
11
16
|
* agent knows what's available without a directory-listing tool.
|
|
12
17
|
*
|
|
@@ -47,7 +52,10 @@ export declare class File {
|
|
|
47
52
|
/**
|
|
48
53
|
* Build an inline File from raw bytes. `name` becomes the workspace
|
|
49
54
|
* name (per-run-artifact auto-suffixes it at ingest). `mountPath` is
|
|
50
|
-
* optional and overrides the default `/antpath/files/<id>/<rel>`
|
|
55
|
+
* optional and overrides the default `/antpath/files/<id>/<rel>`
|
|
56
|
+
* `mount_path` (the value sent to Anthropic; the agent reads from
|
|
57
|
+
* `/mnt/session/uploads/antpath/files/<id>/<rel>` due to Anthropic's
|
|
58
|
+
* session-mount rebase).
|
|
51
59
|
*
|
|
52
60
|
* When `bytes` is a single file (not a directory tree), the zip has one
|
|
53
61
|
* entry using `name` as the filename inside the archive. Pass a zip
|
package/dist/file.js
CHANGED
|
@@ -10,7 +10,12 @@ import { chooseUploadStrategy, uploadChunked } from "./asset-upload.js";
|
|
|
10
10
|
* will:
|
|
11
11
|
*
|
|
12
12
|
* 1. Upload to the Anthropic Files API at session create, mounting
|
|
13
|
-
* each entry
|
|
13
|
+
* each entry with `mount_path: "/antpath/files/<f_id>/<rel-path>"`.
|
|
14
|
+
* Anthropic Managed Agents rebases all session mounts under
|
|
15
|
+
* `/mnt/session/uploads/`, so the agent sees the file at
|
|
16
|
+
* `/mnt/session/uploads/antpath/files/<f_id>/<rel-path>` — see
|
|
17
|
+
* `references/architecture-decisions.md` (Anthropic Managed Agents
|
|
18
|
+
* session-mount mechanics).
|
|
14
19
|
* 2. List all mount paths in the synthetic first user message so the
|
|
15
20
|
* agent knows what's available without a directory-listing tool.
|
|
16
21
|
*
|
|
@@ -74,7 +79,10 @@ export class File {
|
|
|
74
79
|
/**
|
|
75
80
|
* Build an inline File from raw bytes. `name` becomes the workspace
|
|
76
81
|
* name (per-run-artifact auto-suffixes it at ingest). `mountPath` is
|
|
77
|
-
* optional and overrides the default `/antpath/files/<id>/<rel>`
|
|
82
|
+
* optional and overrides the default `/antpath/files/<id>/<rel>`
|
|
83
|
+
* `mount_path` (the value sent to Anthropic; the agent reads from
|
|
84
|
+
* `/mnt/session/uploads/antpath/files/<id>/<rel>` due to Anthropic's
|
|
85
|
+
* session-mount rebase).
|
|
78
86
|
*
|
|
79
87
|
* When `bytes` is a single file (not a directory tree), the zip has one
|
|
80
88
|
* entry using `name` as the filename inside the archive. Pass a zip
|
package/dist/file.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"file.js","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAExE
|
|
1
|
+
{"version":3,"file":"file.js","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"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"}
|
package/docs/credentials.md
CHANGED
|
@@ -73,16 +73,16 @@ const ref = await client.submitRun(template, {
|
|
|
73
73
|
});
|
|
74
74
|
```
|
|
75
75
|
|
|
76
|
-
Inside the run container, every session has the platform CLI mounted at `/antpath/antpath` (a Node ESM bundle) and a manifest at `/antpath/index.json` describing the declared endpoints. The skill
|
|
76
|
+
Inside the run container, every session has the platform CLI mounted at `/mnt/session/uploads/antpath/antpath` (a Node ESM bundle) and a manifest at `/mnt/session/uploads/antpath/index.json` describing the declared endpoints. The skill invokes the CLI through `node` (the mount has no execute permission so direct invocation fails with `bad interpreter: Permission denied`):
|
|
77
77
|
|
|
78
78
|
```bash
|
|
79
|
-
/antpath/antpath proxy stripe \
|
|
79
|
+
node /mnt/session/uploads/antpath/antpath proxy stripe \
|
|
80
80
|
--method GET \
|
|
81
81
|
--path /v1/charges/ch_123 \
|
|
82
82
|
--response-mode headers_only
|
|
83
83
|
```
|
|
84
84
|
|
|
85
|
-
The CLI reads the per-run bearer from `/antpath/run-token`, attaches the `X-Antpath-Proxy-Protocol` header, and the BFF injects the bearer/header/query/basic credential before dispatching the outbound call. Only the response (subject to `responseMode` and `maxResponseBytes`) reaches the container. `--response-mode` can only narrow below the policy ceiling.
|
|
85
|
+
The CLI reads the per-run bearer from `/mnt/session/uploads/antpath/run-token`, attaches the `X-Antpath-Proxy-Protocol` header, and the BFF injects the bearer/header/query/basic credential before dispatching the outbound call. Only the response (subject to `responseMode` and `maxResponseBytes`) reaches the container. `--response-mode` can only narrow below the policy ceiling.
|
|
86
86
|
|
|
87
87
|
#### Keyless upstreams (`authShape: { type: "none" }`)
|
|
88
88
|
|
|
@@ -118,7 +118,7 @@ ProxyEndpoint.none({
|
|
|
118
118
|
});
|
|
119
119
|
```
|
|
120
120
|
|
|
121
|
-
|
|
121
|
+
`node /mnt/session/uploads/antpath/antpath --help` reads endpoint details from `/mnt/session/uploads/antpath/index.json`. Runs that do not declare any `proxyEndpoints` still have the CLI and an empty manifest mounted, so agents never need to introspect whether the surface exists.
|
|
122
122
|
|
|
123
123
|
### Networking
|
|
124
124
|
|
package/docs/outputs.md
CHANGED
|
@@ -11,8 +11,8 @@ Every run produces durable metadata (status, events, snapshots, cleanup state).
|
|
|
11
11
|
```ts
|
|
12
12
|
const ref = await client.submitRun({
|
|
13
13
|
model: "claude-opus-4-7",
|
|
14
|
-
prompt: "Produce a report and stash working files",
|
|
15
|
-
outputDirs: ["/
|
|
14
|
+
prompt: "Produce a report and stash working files under /mnt/session/outputs",
|
|
15
|
+
outputDirs: ["/mnt/session/outputs"],
|
|
16
16
|
secrets: { anthropic: { apiKey } }
|
|
17
17
|
});
|
|
18
18
|
|
|
@@ -59,7 +59,7 @@ manifest.json # { source, partial, outputs, missing }
|
|
|
59
59
|
```ts
|
|
60
60
|
client.submitRun({
|
|
61
61
|
/* ... */,
|
|
62
|
-
outputDirs: ["/
|
|
62
|
+
outputDirs: ["/mnt/session/outputs", "/mnt/session/state"]
|
|
63
63
|
});
|
|
64
64
|
```
|
|
65
65
|
|
|
@@ -70,11 +70,13 @@ Validation:
|
|
|
70
70
|
- maximum 32 entries,
|
|
71
71
|
- maximum 512 bytes per entry.
|
|
72
72
|
|
|
73
|
+
In practice, paths must live under `/mnt/session/outputs` (or another subdirectory of `/mnt/session/`). That is the only filesystem area Anthropic Managed Agents auto-registers with the Files API; files written under `/workspace/...` or `/tmp/...` are NOT picked up even when listed in `outputDirs`, because the registration is what the Files API list shows us, not a directory scan.
|
|
74
|
+
|
|
73
75
|
Mechanism (no platform-magical paths — this is honest):
|
|
74
76
|
|
|
75
77
|
1. Worker submits the run, sends the user prompt, streams events.
|
|
76
78
|
2. At session-idle (the agent's primary task is done), the worker sends one synthetic `user.message` to the agent:
|
|
77
|
-
*"Run
|
|
79
|
+
*"Run `node /mnt/session/uploads/antpath/antpath outputs sync <dirs>` once."*
|
|
78
80
|
3. The agent runs that command via its bash tool. The in-container CLI walks the listed dirs, prints a JSON line per file, and the agent's tool output triggers Anthropic Managed Agents' file registration.
|
|
79
81
|
4. Worker walks the Files API, copies bytes into Supabase Storage, and tears down the session.
|
|
80
82
|
|
|
@@ -85,7 +87,7 @@ Failure modes — anything that did not make it into the zip lands in `manifest.
|
|
|
85
87
|
| `reason` | What happened |
|
|
86
88
|
| --- | --- |
|
|
87
89
|
| `agent_did_not_sync` | The agent refused or skipped the synthetic instruction. Run still succeeded, just no file bytes. |
|
|
88
|
-
| `agent_reported_error` | The
|
|
90
|
+
| `agent_reported_error` | The `node /mnt/session/uploads/antpath/antpath outputs sync` invocation returned non-zero (e.g. dir did not exist). |
|
|
89
91
|
| `session_terminated_pre_sync` | Session was terminated (cancel / timeout) before the sync turn ran. |
|
|
90
92
|
| `storage_cap_exceeded` | Workspace storage quota would have been breached. |
|
|
91
93
|
| `download_failed` | Files API entry could not be fetched. |
|
package/docs/skills.md
CHANGED
|
@@ -19,13 +19,18 @@ Skill inputs accepted by the platform:
|
|
|
19
19
|
bundle root are registered with Anthropic's Skills API
|
|
20
20
|
(`POST /v1/skills`) and surface to the agent as auto-discoverable
|
|
21
21
|
skills. Bundles without `SKILL.md` mount under
|
|
22
|
-
`/antpath/assets/<skl_id>/<rel-path>` in the agent
|
|
23
|
-
agent reads them by explicit path reference in the
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
22
|
+
`/mnt/session/uploads/antpath/assets/<skl_id>/<rel-path>` in the agent
|
|
23
|
+
container — the agent reads them by explicit path reference in the
|
|
24
|
+
prompt.
|
|
25
|
+
|
|
26
|
+
The platform also mounts the `antpath` CLI at
|
|
27
|
+
`/mnt/session/uploads/antpath/antpath` and a per-run manifest at
|
|
28
|
+
`/mnt/session/uploads/antpath/index.json` on **every** run. Skills
|
|
29
|
+
invoke the managed HTTP proxy via
|
|
30
|
+
`node /mnt/session/uploads/antpath/antpath proxy …` — see
|
|
31
|
+
`credentials.md` for the policy/auth model, and
|
|
32
|
+
`references/architecture-decisions.md` for why mounted resources sit
|
|
33
|
+
under `/mnt/session/uploads/` and have to be invoked through `node`.
|
|
29
34
|
|
|
30
35
|
## Workspace skills: upload, find, reuse
|
|
31
36
|
|