@sema-agent/sdk 0.1.8 → 1.0.0
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 +17 -0
- package/dist/client.d.ts +1 -1
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +1 -1
- package/dist/client.js.map +1 -1
- package/dist/errors.d.ts +22 -22
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +105 -109
- package/dist/errors.js.map +1 -1
- package/dist/events.d.ts +21 -9
- package/dist/events.d.ts.map +1 -1
- package/dist/events.js.map +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -0
- package/dist/index.js.map +1 -1
- package/dist/normalize.d.ts +17 -4
- package/dist/normalize.d.ts.map +1 -1
- package/dist/normalize.js +16 -9
- package/dist/normalize.js.map +1 -1
- package/dist/resources/approvals.d.ts +2 -7
- package/dist/resources/approvals.d.ts.map +1 -1
- package/dist/resources/approvals.js +1 -1
- package/dist/resources/approvals.js.map +1 -1
- package/dist/resources/assistant.d.ts +1 -1
- package/dist/resources/assistant.js +1 -1
- package/dist/resources/fleet.d.ts +4 -4
- package/dist/resources/fleet.d.ts.map +1 -1
- package/dist/resources/fleet.js +1 -1
- package/dist/resources/fleet.js.map +1 -1
- package/dist/resources/images.d.ts +4 -4
- package/dist/resources/images.d.ts.map +1 -1
- package/dist/resources/images.js +4 -4
- package/dist/resources/images.js.map +1 -1
- package/dist/resources/leader.d.ts +2 -3
- package/dist/resources/leader.d.ts.map +1 -1
- package/dist/resources/leader.js +2 -3
- package/dist/resources/leader.js.map +1 -1
- package/dist/resources/memory.d.ts +11 -53
- package/dist/resources/memory.d.ts.map +1 -1
- package/dist/resources/memory.js +2 -51
- package/dist/resources/memory.js.map +1 -1
- package/dist/resources/models.d.ts +4 -4
- package/dist/resources/models.js +1 -1
- package/dist/resources/ops.d.ts +3 -3
- package/dist/resources/session-sync.d.ts +1 -2
- package/dist/resources/session-sync.d.ts.map +1 -1
- package/dist/resources/session-sync.js.map +1 -1
- package/dist/resources/sessions.d.ts +4 -4
- package/dist/resources/sessions.js +4 -4
- package/dist/resources/workspace.d.ts.map +1 -1
- package/dist/resources/workspace.js +5 -2
- package/dist/resources/workspace.js.map +1 -1
- package/dist/sse.js +1 -1
- package/dist/sse.js.map +1 -1
- package/dist/types.d.ts +89 -54
- package/dist/types.d.ts.map +1 -1
- package/openapi.yaml +150 -195
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -40,6 +40,23 @@ for await (const ev of client.runs.events(task.taskId)) {
|
|
|
40
40
|
|
|
41
41
|
Typed errors (`APIError` hierarchy: `AuthError`, `RateLimitedError`, `ConflictError`, `ApprovalStaleError`, …) let callers branch on semantics instead of strings.
|
|
42
42
|
|
|
43
|
+
## 1.0.0 — BREAKING changes
|
|
44
|
+
|
|
45
|
+
**Supported floor: `@sema-agent/server` >= 3.0.0** — one floor, no second number. That is the release whose HTTP error bodies and SSE `error` frames carry exactly one machine key (`errorCode`), and everything below assumes it. (Some individual removals became *possible* earlier — the `brain_status` arm, for instance, stopped being emitted at server 1.317 — but an earlier server is still unsupported, because the `errorCode` single-key contract is not met until 3.0.0.) Nothing below ships a compatibility shim: a shim would keep downstream tests green while the real call site is broken.
|
|
46
|
+
|
|
47
|
+
| Removed / renamed | Replacement |
|
|
48
|
+
| --- | --- |
|
|
49
|
+
| `APIError.code` (and every subclass constructor's `code` parameter) | `APIError.errorCode` — same value, same position |
|
|
50
|
+
| Response bodies keyed on a legacy top-level `code` | The top-level `code` key is no longer read: a body that still sends it yields `errorCode: undefined` and no typed subclass — upgrade the server. (One narrow defensive arm survives: a body whose `error` field is an *object* with a string `code` still surfaces that as `errorCode`. It is a don't-crash-in-the-error-path guard against any object-shaped `error` body, not a supported wire form — no current route sends one.) |
|
|
51
|
+
| `AgentEvent` arm `{ type: "brain_status" }` | `{ type: "status" }` (the only arm a >= 3.0.0 server emits, on both legs) |
|
|
52
|
+
| `TraceStreamEvent` `error` frame `data.code` | `data.errorCode` |
|
|
53
|
+
| `client.memory.get` / `.clear` / `.append` / `.edit` / `.remove` | `client.memory.exportScope(scope)` / `client.memory.sync(scope, body)` — the legacy MemoryStore face is gone server-side (`capabilities.memory === false`) and returned 404/501 on every current deployment |
|
|
54
|
+
| Types `MemoryRecord`, `MemoryWriteAck` | Removed with the verbs above |
|
|
55
|
+
| `ApprovalDecision.checkpointToken` | Send `boundCallId` + `boundInputHash` only (echoed verbatim off the `PendingCheckpoint`); the token is server-internal and was never surfaced |
|
|
56
|
+
| `TaskStats.costUsd` (legacy float) | `TaskStats.costMicroUsd` (integer micro-USD). `taskCostMicroUsd(stats)` no longer converts a float — a float-only body now reads as `undefined` |
|
|
57
|
+
|
|
58
|
+
Also fixed in the same release: `workspace.file()`'s 413 over-cap envelope is read off `errorCode` (the server has always sent that key), so `WorkspaceFileTooLargeError` — with `sizeBytes`/`limit` — now actually fires instead of collapsing into a generic `APIError`.
|
|
59
|
+
|
|
43
60
|
## Contract
|
|
44
61
|
|
|
45
62
|
The bundled spec is importable:
|
package/dist/client.d.ts
CHANGED
|
@@ -134,7 +134,7 @@ export declare class AgentClient {
|
|
|
134
134
|
* Unknown name → 404 `{ error: "scenario not found", errorCode: "scenario_not_found" }`, surfaced as a typed
|
|
135
135
|
* APIError with `code === "scenario_not_found"`.
|
|
136
136
|
* ⚠️ 纠正(2026-07-25):原注说这条 404 是 OBJECT 形 body(`{error:{code:…}}`)——server [939] 已把它统一成
|
|
137
|
-
* 上面这个「字符串 error + 顶层 errorCode」邻位形(亲读 `http/
|
|
137
|
+
* 上面这个「字符串 error + 顶层 errorCode」邻位形(亲读 `src/http/routes/capabilities.ts`)。`code` 判据不变。 */
|
|
138
138
|
scenarioCapabilities(name: string, opts?: {
|
|
139
139
|
signal?: AbortSignal;
|
|
140
140
|
}): Promise<ScenarioDetail>;
|
package/dist/client.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
package/dist/client.js
CHANGED
|
@@ -108,7 +108,7 @@ export class AgentClient {
|
|
|
108
108
|
* Unknown name → 404 `{ error: "scenario not found", errorCode: "scenario_not_found" }`, surfaced as a typed
|
|
109
109
|
* APIError with `code === "scenario_not_found"`.
|
|
110
110
|
* ⚠️ 纠正(2026-07-25):原注说这条 404 是 OBJECT 形 body(`{error:{code:…}}`)——server [939] 已把它统一成
|
|
111
|
-
* 上面这个「字符串 error + 顶层 errorCode」邻位形(亲读 `http/
|
|
111
|
+
* 上面这个「字符串 error + 顶层 errorCode」邻位形(亲读 `src/http/routes/capabilities.ts`)。`code` 判据不变。 */
|
|
112
112
|
scenarioCapabilities(name, opts) {
|
|
113
113
|
return this.transport.request({
|
|
114
114
|
method: "GET",
|
package/dist/client.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
package/dist/errors.d.ts
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
*/
|
|
6
6
|
export declare class APIError extends Error {
|
|
7
7
|
readonly status: number;
|
|
8
|
-
readonly
|
|
8
|
+
readonly errorCode: string | undefined;
|
|
9
9
|
/** `true` = the server said this failure is RETRIABLE: the durable park is still pending, so re-fetching and
|
|
10
10
|
* deciding/resuming again is meaningful (server sets `retriable: true` on the /decide + resume legs).
|
|
11
11
|
*
|
|
@@ -16,7 +16,7 @@ export declare class APIError extends Error {
|
|
|
16
16
|
* 子类、其中好几个有自己的位置化构造签名(retryAfterMs / allowlist / relation …)。做成第 4 个构造参数就得逐个
|
|
17
17
|
* 子类穿线,漏一个就是静默丢信号;做成 mapper 末尾的**单点盖章**则天然覆盖全部返回路径。这是刻意取舍。 */
|
|
18
18
|
retriable?: boolean;
|
|
19
|
-
constructor(status: number,
|
|
19
|
+
constructor(status: number, errorCode: string | undefined, message: string);
|
|
20
20
|
}
|
|
21
21
|
/** 401 / 503 — fail-closed auth (missing/bad SERVICE_AUTH_TOKEN). */
|
|
22
22
|
export declare class AuthError extends APIError {
|
|
@@ -24,11 +24,11 @@ export declare class AuthError extends APIError {
|
|
|
24
24
|
/** 413 `workspace_file_too_large`(#3 workspace file 面,[1894]①)——结构化超限信封的 typed 形:
|
|
25
25
|
* `sizeBytes`=文件真实大小、`limit`=部署帽(capabilities.workspace.maxFileBytes)。web 用它渲
|
|
26
26
|
* 「文件过大({sizeBytes}),下载查看」卡;archive 端点是退路。由 WorkspaceResource.file 铸
|
|
27
|
-
* (面局部判别,不进全局 classify——
|
|
27
|
+
* (面局部判别,不进全局 classify——errorCode 是这个面独有的)。 */
|
|
28
28
|
export declare class WorkspaceFileTooLargeError extends APIError {
|
|
29
29
|
readonly sizeBytes: number;
|
|
30
30
|
readonly limit: number;
|
|
31
|
-
constructor(status: number,
|
|
31
|
+
constructor(status: number, errorCode: string | undefined, message: string, sizeBytes: number, limit: number);
|
|
32
32
|
}
|
|
33
33
|
/** 429 — per-principal rate limit. `retryAfterMs` from `Retry-After` (the SDK honors it on retry). */
|
|
34
34
|
/** 503 `errorCode:"draining"` — the instance is draining for shutdown/upgrade(server ≥1.309 carries the
|
|
@@ -37,14 +37,14 @@ export declare class WorkspaceFileTooLargeError extends APIError {
|
|
|
37
37
|
* dead).**Retryable against the replacement instance**; honor `retryAfterMs` (from `retry-after`). */
|
|
38
38
|
export declare class DrainingError extends APIError {
|
|
39
39
|
readonly retryAfterMs?: number | undefined;
|
|
40
|
-
constructor(status: number,
|
|
40
|
+
constructor(status: number, errorCode: string | undefined, message: string, retryAfterMs?: number | undefined);
|
|
41
41
|
}
|
|
42
42
|
export declare class RateLimitedError extends APIError {
|
|
43
43
|
readonly retryAfterMs?: number | undefined;
|
|
44
|
-
constructor(status: number,
|
|
44
|
+
constructor(status: number, errorCode: string | undefined, message: string, retryAfterMs?: number | undefined);
|
|
45
45
|
}
|
|
46
46
|
/** E4 quota deny detail (定稿形状) — the center's structured 409 fields, passed VERBATIM through the
|
|
47
|
-
* service's 429 body (`{
|
|
47
|
+
* service's 429 body (`{errorCode:"quota_exhausted", windowType, remaining, resetAt, isEstimate, pool?}`). Every
|
|
48
48
|
* field is optional at the wire boundary (a cached in-window rejection or an older service may carry a bare
|
|
49
49
|
* code) — consumers MUST render a generic fallback when fields are absent. Units: `remaining` is WEIGHTED
|
|
50
50
|
* TOKENS for the fiveHour/weekly windows and MICRO-USD for the budget window; `resetAt` is an ISO instant
|
|
@@ -59,15 +59,15 @@ export interface QuotaExhaustedDetail {
|
|
|
59
59
|
/** The service's own suggested retry window (seconds; EXHAUSTED_RETRY_MS cache). */
|
|
60
60
|
retryAfterSec?: number;
|
|
61
61
|
}
|
|
62
|
-
/** 429 `
|
|
62
|
+
/** 429 `errorCode:"quota_exhausted"` — the principal's usage quota (token windows / budget) is exhausted
|
|
63
63
|
* (E4 double-rail, service ≥1.150.0). Extends RateLimitedError so existing 429 handling still matches;
|
|
64
64
|
* carries the structured deny detail so the RENDER layer can produce a human message (人话归壳 — the wire
|
|
65
65
|
* stays structured, no display strings here). NOT usefully retryable inside the deny window. */
|
|
66
66
|
export declare class QuotaExhaustedError extends RateLimitedError {
|
|
67
67
|
readonly detail: QuotaExhaustedDetail;
|
|
68
|
-
constructor(status: number,
|
|
68
|
+
constructor(status: number, errorCode: string | undefined, message: string, retryAfterMs: number | undefined, detail: QuotaExhaustedDetail);
|
|
69
69
|
}
|
|
70
|
-
/** 400 `
|
|
70
|
+
/** 400 `errorCode:"scenario_not_allowed"` — the request's explicit `body.scenario` is outside the principal's
|
|
71
71
|
* assigned allowlist (scenario governance, service ≥1.152.0). Carries the service's
|
|
72
72
|
* `allowlist` VERBATIM (pure scenario names) so the RENDER layer can offer the valid choices (人话归壳 —
|
|
73
73
|
* the wire stays structured, no display strings here). NOT retryable verbatim: pick a scenario from
|
|
@@ -75,7 +75,7 @@ export declare class QuotaExhaustedError extends RateLimitedError {
|
|
|
75
75
|
export declare class ScenarioNotAllowedError extends APIError {
|
|
76
76
|
/** The principal's allowed scenario names (may be empty on an older service / defensive drop). */
|
|
77
77
|
readonly allowlist: string[];
|
|
78
|
-
constructor(status: number,
|
|
78
|
+
constructor(status: number, errorCode: string | undefined, message: string,
|
|
79
79
|
/** The principal's allowed scenario names (may be empty on an older service / defensive drop). */
|
|
80
80
|
allowlist: string[]);
|
|
81
81
|
}
|
|
@@ -85,13 +85,13 @@ export declare class BudgetExceededError extends APIError {
|
|
|
85
85
|
/** 409 — session already has an active run, or an idempotency conflict / session CAS conflict. */
|
|
86
86
|
export declare class ConflictError extends APIError {
|
|
87
87
|
readonly activeTaskId?: string | undefined;
|
|
88
|
-
constructor(status: number,
|
|
88
|
+
constructor(status: number, errorCode: string | undefined, message: string, activeTaskId?: string | undefined);
|
|
89
89
|
}
|
|
90
90
|
/** 2c session-sync (P1d) — a PUSH (`POST …/sync/import` or its Phase-B commit) or a `POST …/sync/plan` that WOULD
|
|
91
91
|
* lose destination history: the relation classified to `fork` or `stale` and the caller did NOT pass
|
|
92
92
|
* `{ resolution: "overwrite-dst" }`. 409, errorCode `conflict`, with the classified `relation` carrying the
|
|
93
93
|
* exclusive entry sets (mirrors the service SyncConflictError). DISTINCT from the session-CAS ConflictError
|
|
94
|
-
* (same status+
|
|
94
|
+
* (same status+errorCode, but THIS one carries a `relation` — that's how the mapper tells them apart). Client action:
|
|
95
95
|
* surface the keep-local / keep-cloud divergence to the user; to override, re-push with `resolution:"overwrite-dst"`.
|
|
96
96
|
* NEVER auto-overwrite (a silent clobber is exactly the data loss the classifier exists to prevent). */
|
|
97
97
|
export declare class SyncConflictError extends ConflictError {
|
|
@@ -100,7 +100,7 @@ export declare class SyncConflictError extends ConflictError {
|
|
|
100
100
|
relation: "fork" | "stale";
|
|
101
101
|
[k: string]: unknown;
|
|
102
102
|
};
|
|
103
|
-
constructor(status: number,
|
|
103
|
+
constructor(status: number, errorCode: string | undefined, message: string,
|
|
104
104
|
/** The §7 `fork`/`stale` relation with the exclusive entry sets (untyped at the JSON boundary). */
|
|
105
105
|
relation: {
|
|
106
106
|
relation: "fork" | "stale";
|
|
@@ -112,14 +112,14 @@ export declare class SyncConflictError extends ConflictError {
|
|
|
112
112
|
* and from session-CAS 409. Client action: this pending is gone → REFETCH the inbox; do not retry the decide. */
|
|
113
113
|
export declare class ApprovalStaleError extends APIError {
|
|
114
114
|
readonly terminal?: "resolved" | "expired_abort" | "expired_sla" | undefined;
|
|
115
|
-
constructor(status: number,
|
|
115
|
+
constructor(status: number, errorCode: string | undefined, message: string, terminal?: "resolved" | "expired_abort" | "expired_sla" | undefined);
|
|
116
116
|
}
|
|
117
117
|
/** design/80 D-1 — your decide's binding (`boundCallId` / `boundInputHash`) does NOT match the current pending
|
|
118
118
|
* action: it was swapped under you (TOCTOU) or you replayed a stale yes. A SAFETY signal, not an expiry.
|
|
119
119
|
* Client action: REFETCH the PendingCheckpoint, RE-PRESENT it to the human, NEVER auto-retry. */
|
|
120
120
|
export declare class ApprovalBindingMismatchError extends APIError {
|
|
121
121
|
readonly field?: "boundCallId" | "boundInputHash" | undefined;
|
|
122
|
-
constructor(status: number,
|
|
122
|
+
constructor(status: number, errorCode: string | undefined, message: string, field?: "boundCallId" | "boundInputHash" | undefined);
|
|
123
123
|
}
|
|
124
124
|
/** design/80 D-1 (core 1.101.0) — a concurrent resolve/reopen advanced the checkpoint's revision inside the
|
|
125
125
|
* engine's get→resolve window, so this resume failed-closed; the row is STILL pending. TRANSIENT (≠ terminal):
|
|
@@ -138,7 +138,7 @@ export declare class SteeringNotRunningError extends APIError {
|
|
|
138
138
|
export declare class SteeringInvalidContentError extends APIError {
|
|
139
139
|
}
|
|
140
140
|
/** `413` + `steer.content_too_large` / `reason_too_large` —— 请求里某个**自由文本**字段超过 server 的字符上限。
|
|
141
|
-
* 两个成员码同族同处置,所以共用一个类型(`err.
|
|
141
|
+
* 两个成员码同族同处置,所以共用一个类型(`err.errorCode` 保留具体是哪一个):
|
|
142
142
|
* · `steer.content_too_large`(server 1.279.2):steer 入参上限 256 KiB。脱敏门是同步的,一次超大 steer 卡住的
|
|
143
143
|
* 是整个副本,所以服务端**拒**而不是先截 —— 先截会让引擎的 `[+N chars]` 披露低报。
|
|
144
144
|
* · `reason_too_large`(server 1.284.0):审批决定的 `reason` 上限 4096 字符,`/decide` 与 plan_review 两道门同值。
|
|
@@ -151,7 +151,7 @@ export declare class PayloadTooLargeError extends APIError {
|
|
|
151
151
|
* `stop.not_local`(run 在别的副本,无本地进程可 kill)/ `stop.not_landed`(kill 尝试了未落地)/
|
|
152
152
|
* `stop.parked`(行在 parked,无活跃进程)/ `stop.park_resume_won`(stop 与「审批落地→恢复」竞态,
|
|
153
153
|
* 恢复赢了)/ `stop.park_arbiter_unreachable`(仲裁店不可达,真相未知——core 1.397 三分)。
|
|
154
|
-
* 开集:未来新 `stop.*` 码同样落到本类(`
|
|
154
|
+
* 开集:未来新 `stop.*` 码同样落到本类(`errorCode` 原样携带),消费方 switch 要留 default。 */
|
|
155
155
|
export declare class TaskStopConflictError extends ConflictError {
|
|
156
156
|
}
|
|
157
157
|
/** design/80 D-G (direct-connect door, service [84]) — the signed principal JWT (`X-Approval-Principal-Token`)
|
|
@@ -196,11 +196,11 @@ export declare class ResumeOutcomeInvalidError extends APIError {
|
|
|
196
196
|
* longer admissible. Not a race: retrying as-is stays blocked until the policy or the request changes. */
|
|
197
197
|
export declare class ResumeBlockedByPolicyError extends APIError {
|
|
198
198
|
readonly blockedBy?: string | undefined;
|
|
199
|
-
constructor(status: number,
|
|
199
|
+
constructor(status: number, errorCode: string | undefined, message: string, blockedBy?: string | undefined);
|
|
200
200
|
}
|
|
201
201
|
/** 409 `resume.*`(dot 前缀;design/122 D2)—— subagent revive 的合同拒绝族:still_running(等 settle)/
|
|
202
202
|
* retain_off(父 run 没开 retainSubagentSessions)/evicted(留存被逐)/cap(留存上限)/
|
|
203
|
-
* session_not_found。前缀开集:core 未来新码至少落到本类(`.
|
|
203
|
+
* session_not_found。前缀开集:core 未来新码至少落到本类(`.errorCode` 判别),不塌匿名 409。
|
|
204
204
|
* ⚠️ 与下划线形的 resume_outcome_invalid / resume_blocked_by_policy 是**两族**(那两个在上面,先判)。 */
|
|
205
205
|
export declare class SubagentResumeConflictError extends ConflictError {
|
|
206
206
|
}
|
|
@@ -209,7 +209,7 @@ export declare class SubagentResumeConflictError extends ConflictError {
|
|
|
209
209
|
export declare class WakeGatePendingError extends ConflictError {
|
|
210
210
|
}
|
|
211
211
|
/** 409 `compact.not_running` / `detach.not_running` —— replica-local live-verb 族:run 已终态,或活在
|
|
212
|
-
* 另一副本(手动 compact/detach 只对本副本的活流有效)。`.
|
|
212
|
+
* 另一副本(手动 compact/detach 只对本副本的活流有效)。`.errorCode` 判别是哪个 verb。 */
|
|
213
213
|
export declare class RunNotLiveError extends ConflictError {
|
|
214
214
|
}
|
|
215
215
|
/** Base of the `decide.*` family — catch this to handle the whole decide door in one place.
|
|
@@ -220,7 +220,7 @@ export declare class DecideError extends APIError {
|
|
|
220
220
|
readonly taskId?: string | undefined;
|
|
221
221
|
/** revive legs only — the claim-rollback disposition the server reported. */
|
|
222
222
|
readonly rollback?: string | undefined;
|
|
223
|
-
constructor(status: number,
|
|
223
|
+
constructor(status: number, errorCode: string | undefined, message: string, taskId?: string | undefined,
|
|
224
224
|
/** revive legs only — the claim-rollback disposition the server reported. */
|
|
225
225
|
rollback?: string | undefined);
|
|
226
226
|
}
|
package/dist/errors.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qBAAa,QAAS,SAAQ,KAAK;IAa/B,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,
|
|
1
|
+
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
|