@sema-agent/sdk 25.0.0 → 26.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/sdk",
-  "version": "25.0.0",
+  "version": "26.0.0",
   "description": "Typed, zero-runtime-dependency SDK for the Sema agent fleet usage plane. The shared substrate for all doors (CC/Codex MCP façade + web). Server-side only — tokens never enter the browser.",
   "type": "module",
   "license": "BUSL-1.1",

package/dist/resources/workspace.d.ts

@@ -1,95 +0,0 @@
-/** workspace 浏览面(#3;server 1.299–7.51 `/v1/sessions/:id/workspace*`,[1882] 设计稿 → [1894] 表态)——
- *  E19 快照店的只读投影:任务产出的浏览/预览/打包下载。**不是**活工作区(运行中的实时浏览=v2 另立);
- *  看的是每轮结束时的定格,`latest` 别名=最新快照(web 首屏「看最终产出」一跳)。
- *
- *  🔴 **RETIRED(server ≥7.52,S-15/design/381)**:整树快照纪元退役 ⇒ 四条路由形保留但恒答
- *  501 `capability.workspace_retired`(拒因点名纪元退役,不让消费端拿 404 猜拼写),能力位
- *  `capabilities.workspace` 恒 `false`(同谓词)。per-edited-file rewind 历史只备份代理亲手编辑过的
- *  文件,结构上不存在「整个工作区」的 manifest 可投影。四动词保留不删(支持区间地板 3.0.0 起的老
- *  server 仍活着这个面;删导出符号=major)——消费姿势恒为先探 `capabilities().workspace`,false 即不渲。
- *
- *  探测走 `capabilities().workspace`(对象={browse, archive, maxFileBytes};false/缺席=面不在)——
- *  DON'T trial-by-501。owner 门=session 面同款(非 owner → 404 无 oracle)。 */
-import type { Transport } from "../transport.js";
-export interface WorkspaceSnapshotRow {
-    key: string;
-    files: number;
-    /** 快照总字节。SQL 后端在场时给;local 店缺 sizes 面=诚实省略([1894]② additive)。 */
-    bytes?: number;
-}
-export interface WorkspaceTreeEntry {
-    path: string;
-    /** content-address(sha256)——端可做跨快照变更高亮([1894]②)。 */
-    hash: string;
-    size?: number;
-}
-export interface WorkspaceFile {
-    bytes: Uint8Array;
-    /** 保守表 content-type(html/svg 等可执行类型故意不在表内=octet-stream;nosniff 恒带)。 */
-    contentType: string;
-    /** [1894]③ 二进制判别(server 首 8KiB NUL 嗅探,git 同判据)——web 预览器分流用。 */
-    binary: boolean;
-}
-/** `GET …/workspace` 的 200 信封(server `routes/sessions.ts:624-629`)。
- *
- *  🔴 4.3.0 提成 **exported type**(此前是 `list()` 返回位上的**内联闭合字面量**):两道 spec 门谁都扫不到
- *  方法返回位置的内联形 —— `spec-field-drift-gate` 只扫 `src/types.ts` 的 exported interface,
- *  `spec-resource-schema-gate` 只扫 `src/resources/*.ts` 的 exported type。于是这个信封漏了 `sessionId`
- *  (server 与 spec 都把它列为 required)整整一个 major 版本而 CI 全绿。提出来 = 让第二道门罩住它。 */
-export interface WorkspaceSnapshotPage {
-    /** 恒发 —— 回声校验(拿它与请求的 id 对一遍防串会话)在 TS 下此前根本写不出来,只能强制断言绕过。 */
-    sessionId: string;
-    snapshots: WorkspaceSnapshotRow[];
-    /** 最新快照键;无快照时缺席。与展示行**同源**(server 防 ghost key:latest 绝不指向已被 reap 的快照)。 */
-    latest?: string;
-    /** ⚠️ **本页行数,不是快照总数** —— `total = snapshots.length`(server `:628`)。而且这条腿**没有任何
-     *  分页游标**:超过 `limit`(上限 100)的老快照取不到。渲「共 N 个快照」会在快照多于 limit 时永远显示
-     *  limit,用户以为老快照被清了。
-     *  🔴 同族的 {@link WorkspaceTreePage} 用**同一个键名**表示 `all.length` 的**全量** —— 同名键在同一族的
-     *  两条腿上语义相反,这是 server 侧的既成事实,别把两处的 `total` 当同一个量读。 */
-    total: number;
-    [k: string]: unknown;
-}
-/** `GET …/workspace/:key/tree` 的 200 信封(server `routes/sessions.ts:651-657`)。提成 exported type 的
- *  理由同 {@link WorkspaceSnapshotPage}。 */
-export interface WorkspaceTreePage {
-    /** 恒发(server 与 spec 均列为 required)。 */
-    sessionId: string;
-    /** 解析后的**真实**快照键 —— 请求里传 `"latest"` 别名时,这里回的是它解析到的那个 uuidv7 键。 */
-    key: string;
-    entries: WorkspaceTreeEntry[];
-    /** ⚠️ 这条腿的 `total` 是**真·全量**(`all.length`),与 {@link WorkspaceSnapshotPage.total} 语义相反。 */
-    total: number;
-    /** 在场 = 还有下一页;把它当 `offset` 送回来。 */
-    nextOffset?: number;
-    [k: string]: unknown;
-}
-export declare class WorkspaceResource {
-    private readonly t;
-    constructor(t: Transport);
-    /** `GET …/workspace` — 列快照(新→旧;limit 1..100 默认 20)。`latest`=最新快照键(无快照=缺席)。 */
-    list(sessionId: string, opts?: {
-        limit?: number;
-        signal?: AbortSignal;
-    }): Promise<WorkspaceSnapshotPage>;
-    /** `GET …/workspace/:key/tree` — 文件树(path 序稳定;limit 1..2000 默认 500 + offset 分页;
-     *  `key="latest"` 别名可用)。`nextOffset` 在场=还有下一页。 */
-    tree(sessionId: string, key: string, opts?: {
-        limit?: number;
-        offset?: number;
-        signal?: AbortSignal;
-    }): Promise<WorkspaceTreePage>;
-    /** `GET …/workspace/:key/file?path=` — 单文件字节(≤ capabilities.workspace.maxFileBytes,默认 8MiB)。
-     *  超限=413 结构化信封([1894]①)⇒ typed {@link WorkspaceFileTooLargeError}(带 sizeBytes/limit)——
-     *  web 渲「文件过大,下载查看」卡,archive 口是退路。 */
-    file(sessionId: string, key: string, path: string, opts?: {
-        signal?: AbortSignal;
-    }): Promise<WorkspaceFile>;
-    /** `GET …/workspace/:key/archive` — 整快照 tar 流(ustar;`content-disposition: attachment`)。
-     *  返回 Response(调用方自决流式落盘/管道——整 tar 可到快照 bounds 上限,不在 SDK 内吸成整块)。
-     *  502=快照缺 blob(可重试/换快照);422=病态路径(>255B 不可入 ustar,点名前 5 条)。 */
-    archive(sessionId: string, key: string, opts?: {
-        signal?: AbortSignal;
-    }): Promise<Response>;
-}
-//# sourceMappingURL=workspace.d.ts.map

package/dist/resources/workspace.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/resources/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;sEAWsE;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;yEAKyE;AACzE,MAAM,WAAW,qBAAqB;IACpC,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;0DAIsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED;yCACyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAEzC,8EAA8E;IACxE,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9C,OAAO,CAAC,qBAAqB,CAAC;IAKjC;sDACkD;IAC5C,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC/D,OAAO,CAAC,iBAAiB,CAAC;IAQ7B;;0CAEsC;IAChC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAoBjH;;mEAE+D;IACzD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;CAUlG"}

package/dist/resources/workspace.js

@@ -1,60 +0,0 @@
-export class WorkspaceResource {
-    t;
-    constructor(t) {
-        this.t = t;
-    }
-    /** `GET …/workspace` — 列快照(新→旧;limit 1..100 默认 20)。`latest`=最新快照键(无快照=缺席)。 */
-    async list(sessionId, opts) {
-        const qs = opts?.limit !== undefined ? `?limit=${opts.limit}` : "";
-        return this.t.request({ method: "GET", path: `/v1/sessions/${encodeURIComponent(sessionId)}/workspace${qs}`, signal: opts?.signal });
-    }
-    /** `GET …/workspace/:key/tree` — 文件树(path 序稳定;limit 1..2000 默认 500 + offset 分页;
-     *  `key="latest"` 别名可用)。`nextOffset` 在场=还有下一页。 */
-    async tree(sessionId, key, opts) {
-        const q = new URLSearchParams();
-        if (opts?.limit !== undefined)
-            q.set("limit", String(opts.limit));
-        if (opts?.offset !== undefined)
-            q.set("offset", String(opts.offset));
-        const qs = q.size > 0 ? `?${q}` : "";
-        return this.t.request({ method: "GET", path: `/v1/sessions/${encodeURIComponent(sessionId)}/workspace/${encodeURIComponent(key)}/tree${qs}`, signal: opts?.signal });
-    }
-    /** `GET …/workspace/:key/file?path=` — 单文件字节(≤ capabilities.workspace.maxFileBytes,默认 8MiB)。
-     *  超限=413 结构化信封([1894]①)⇒ typed {@link WorkspaceFileTooLargeError}(带 sizeBytes/limit)——
-     *  web 渲「文件过大,下载查看」卡,archive 口是退路。 */
-    async file(sessionId, key, path, opts) {
-        const res = await this.t.openRaw({
-            method: "GET",
-            path: `/v1/sessions/${encodeURIComponent(sessionId)}/workspace/${encodeURIComponent(key)}/file?path=${encodeURIComponent(path)}`,
-            accept: "application/octet-stream",
-            signal: opts?.signal,
-        });
-        // 🔴 S2 收编(SDK 1.1.0):413 的 {@link WorkspaceFileTooLargeError} 铸型**已挪进全局 mapper**
-        // (`classifyApiError`),这里不再手写分支 —— 手写分支正是 S2 的病灶本身:它此前读裸 `code`,
-        // 于是那个 typed 类在真机上**从未触发过一次**,而全局 mapper 的所有测试一条都保护不到它。
-        // 现在这条腿与其余 13 个 openRaw verb 走同一个装配口(body 容错读 + retry-after + 注入的 mapper),
-        // 「某一条腿悄悄读错键」这种缺陷再没有单独的藏身处。
-        if (!res.ok)
-            throw await this.t.errorFrom(res);
-        return {
-            bytes: new Uint8Array(await res.arrayBuffer()),
-            contentType: res.headers.get("content-type") ?? "application/octet-stream",
-            binary: res.headers.get("x-sema-content-binary") === "true",
-        };
-    }
-    /** `GET …/workspace/:key/archive` — 整快照 tar 流(ustar;`content-disposition: attachment`)。
-     *  返回 Response(调用方自决流式落盘/管道——整 tar 可到快照 bounds 上限,不在 SDK 内吸成整块)。
-     *  502=快照缺 blob(可重试/换快照);422=病态路径(>255B 不可入 ustar,点名前 5 条)。 */
-    async archive(sessionId, key, opts) {
-        const res = await this.t.openRaw({
-            method: "GET",
-            path: `/v1/sessions/${encodeURIComponent(sessionId)}/workspace/${encodeURIComponent(key)}/archive`,
-            accept: "application/x-tar",
-            signal: opts?.signal,
-        });
-        if (!res.ok)
-            throw await this.t.errorFrom(res);
-        return res;
-    }
-}
-//# sourceMappingURL=workspace.js.map

package/dist/resources/workspace.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/resources/workspace.ts"],"names":[],"mappings":"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"}