@sema-agent/sdk 0.0.46

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 (160) hide show
  1. package/LICENSE +103 -0
  2. package/README.md +53 -0
  3. package/dist/client.d.ts +55 -0
  4. package/dist/client.d.ts.map +1 -0
  5. package/dist/client.js +113 -0
  6. package/dist/client.js.map +1 -0
  7. package/dist/control-client.d.ts +36 -0
  8. package/dist/control-client.d.ts.map +1 -0
  9. package/dist/control-client.js +72 -0
  10. package/dist/control-client.js.map +1 -0
  11. package/dist/control-types.d.ts +282 -0
  12. package/dist/control-types.d.ts.map +1 -0
  13. package/dist/control-types.js +2 -0
  14. package/dist/control-types.js.map +1 -0
  15. package/dist/errors.d.ts +99 -0
  16. package/dist/errors.d.ts.map +1 -0
  17. package/dist/errors.js +190 -0
  18. package/dist/errors.js.map +1 -0
  19. package/dist/events.d.ts +87 -0
  20. package/dist/events.d.ts.map +1 -0
  21. package/dist/events.js +4 -0
  22. package/dist/events.js.map +1 -0
  23. package/dist/idempotency.d.ts +3 -0
  24. package/dist/idempotency.d.ts.map +1 -0
  25. package/dist/idempotency.js +9 -0
  26. package/dist/idempotency.js.map +1 -0
  27. package/dist/index.d.ts +23 -0
  28. package/dist/index.d.ts.map +1 -0
  29. package/dist/index.js +11 -0
  30. package/dist/index.js.map +1 -0
  31. package/dist/resources/approvals.d.ts +40 -0
  32. package/dist/resources/approvals.d.ts.map +1 -0
  33. package/dist/resources/approvals.js +83 -0
  34. package/dist/resources/approvals.js.map +1 -0
  35. package/dist/resources/assistant.d.ts +23 -0
  36. package/dist/resources/assistant.d.ts.map +1 -0
  37. package/dist/resources/assistant.js +59 -0
  38. package/dist/resources/assistant.js.map +1 -0
  39. package/dist/resources/control/auth-providers.d.ts +18 -0
  40. package/dist/resources/control/auth-providers.d.ts.map +1 -0
  41. package/dist/resources/control/auth-providers.js +16 -0
  42. package/dist/resources/control/auth-providers.js.map +1 -0
  43. package/dist/resources/control/config.d.ts +31 -0
  44. package/dist/resources/control/config.d.ts.map +1 -0
  45. package/dist/resources/control/config.js +28 -0
  46. package/dist/resources/control/config.js.map +1 -0
  47. package/dist/resources/control/fleet.d.ts +31 -0
  48. package/dist/resources/control/fleet.d.ts.map +1 -0
  49. package/dist/resources/control/fleet.js +31 -0
  50. package/dist/resources/control/fleet.js.map +1 -0
  51. package/dist/resources/control/images.d.ts +19 -0
  52. package/dist/resources/control/images.d.ts.map +1 -0
  53. package/dist/resources/control/images.js +28 -0
  54. package/dist/resources/control/images.js.map +1 -0
  55. package/dist/resources/control/lifecycle.d.ts +15 -0
  56. package/dist/resources/control/lifecycle.d.ts.map +1 -0
  57. package/dist/resources/control/lifecycle.js +15 -0
  58. package/dist/resources/control/lifecycle.js.map +1 -0
  59. package/dist/resources/control/publish.d.ts +20 -0
  60. package/dist/resources/control/publish.d.ts.map +1 -0
  61. package/dist/resources/control/publish.js +20 -0
  62. package/dist/resources/control/publish.js.map +1 -0
  63. package/dist/resources/control/secrets.d.ts +27 -0
  64. package/dist/resources/control/secrets.d.ts.map +1 -0
  65. package/dist/resources/control/secrets.js +26 -0
  66. package/dist/resources/control/secrets.js.map +1 -0
  67. package/dist/resources/control/users.d.ts +27 -0
  68. package/dist/resources/control/users.d.ts.map +1 -0
  69. package/dist/resources/control/users.js +23 -0
  70. package/dist/resources/control/users.js.map +1 -0
  71. package/dist/resources/control/versioning.d.ts +21 -0
  72. package/dist/resources/control/versioning.d.ts.map +1 -0
  73. package/dist/resources/control/versioning.js +23 -0
  74. package/dist/resources/control/versioning.js.map +1 -0
  75. package/dist/resources/control/workers.d.ts +18 -0
  76. package/dist/resources/control/workers.d.ts.map +1 -0
  77. package/dist/resources/control/workers.js +17 -0
  78. package/dist/resources/control/workers.js.map +1 -0
  79. package/dist/resources/elicitations.d.ts +28 -0
  80. package/dist/resources/elicitations.d.ts.map +1 -0
  81. package/dist/resources/elicitations.js +15 -0
  82. package/dist/resources/elicitations.js.map +1 -0
  83. package/dist/resources/fleet.d.ts +65 -0
  84. package/dist/resources/fleet.d.ts.map +1 -0
  85. package/dist/resources/fleet.js +55 -0
  86. package/dist/resources/fleet.js.map +1 -0
  87. package/dist/resources/images.d.ts +24 -0
  88. package/dist/resources/images.d.ts.map +1 -0
  89. package/dist/resources/images.js +28 -0
  90. package/dist/resources/images.js.map +1 -0
  91. package/dist/resources/leader.d.ts +19 -0
  92. package/dist/resources/leader.d.ts.map +1 -0
  93. package/dist/resources/leader.js +18 -0
  94. package/dist/resources/leader.js.map +1 -0
  95. package/dist/resources/memory.d.ts +29 -0
  96. package/dist/resources/memory.d.ts.map +1 -0
  97. package/dist/resources/memory.js +36 -0
  98. package/dist/resources/memory.js.map +1 -0
  99. package/dist/resources/models.d.ts +13 -0
  100. package/dist/resources/models.d.ts.map +1 -0
  101. package/dist/resources/models.js +10 -0
  102. package/dist/resources/models.js.map +1 -0
  103. package/dist/resources/policy.d.ts +10 -0
  104. package/dist/resources/policy.d.ts.map +1 -0
  105. package/dist/resources/policy.js +10 -0
  106. package/dist/resources/policy.js.map +1 -0
  107. package/dist/resources/questions.d.ts +38 -0
  108. package/dist/resources/questions.d.ts.map +1 -0
  109. package/dist/resources/questions.js +15 -0
  110. package/dist/resources/questions.js.map +1 -0
  111. package/dist/resources/runs.d.ts +43 -0
  112. package/dist/resources/runs.d.ts.map +1 -0
  113. package/dist/resources/runs.js +72 -0
  114. package/dist/resources/runs.js.map +1 -0
  115. package/dist/resources/session-sync.d.ts +38 -0
  116. package/dist/resources/session-sync.d.ts.map +1 -0
  117. package/dist/resources/session-sync.js +97 -0
  118. package/dist/resources/session-sync.js.map +1 -0
  119. package/dist/resources/sessions.d.ts +46 -0
  120. package/dist/resources/sessions.d.ts.map +1 -0
  121. package/dist/resources/sessions.js +70 -0
  122. package/dist/resources/sessions.js.map +1 -0
  123. package/dist/resources/tasks.d.ts +19 -0
  124. package/dist/resources/tasks.d.ts.map +1 -0
  125. package/dist/resources/tasks.js +53 -0
  126. package/dist/resources/tasks.js.map +1 -0
  127. package/dist/resources/trace.d.ts +43 -0
  128. package/dist/resources/trace.d.ts.map +1 -0
  129. package/dist/resources/trace.js +65 -0
  130. package/dist/resources/trace.js.map +1 -0
  131. package/dist/resources/usage.d.ts +10 -0
  132. package/dist/resources/usage.d.ts.map +1 -0
  133. package/dist/resources/usage.js +10 -0
  134. package/dist/resources/usage.js.map +1 -0
  135. package/dist/resources/workflows.d.ts +20 -0
  136. package/dist/resources/workflows.d.ts.map +1 -0
  137. package/dist/resources/workflows.js +43 -0
  138. package/dist/resources/workflows.js.map +1 -0
  139. package/dist/settings.d.ts +44 -0
  140. package/dist/settings.d.ts.map +1 -0
  141. package/dist/settings.js +2 -0
  142. package/dist/settings.js.map +1 -0
  143. package/dist/sse.d.ts +26 -0
  144. package/dist/sse.d.ts.map +1 -0
  145. package/dist/sse.js +244 -0
  146. package/dist/sse.js.map +1 -0
  147. package/dist/sync.d.ts +34 -0
  148. package/dist/sync.d.ts.map +1 -0
  149. package/dist/sync.js +143 -0
  150. package/dist/sync.js.map +1 -0
  151. package/dist/transport.d.ts +37 -0
  152. package/dist/transport.d.ts.map +1 -0
  153. package/dist/transport.js +134 -0
  154. package/dist/transport.js.map +1 -0
  155. package/dist/types.d.ts +574 -0
  156. package/dist/types.d.ts.map +1 -0
  157. package/dist/types.js +2 -0
  158. package/dist/types.js.map +1 -0
  159. package/openapi.yaml +3434 -0
  160. package/package.json +42 -0
@@ -0,0 +1,19 @@
1
+ import type { Transport } from "../transport.js";
2
+ import type { TaskRequest, TaskResult } from "../types.js";
3
+ import type { AgentEvent } from "../events.js";
4
+ export declare class TasksResource {
5
+ private readonly t;
6
+ constructor(t: Transport);
7
+ submit(req: TaskRequest, opts?: {
8
+ idempotencyKey?: string | null;
9
+ signal?: AbortSignal;
10
+ }): Promise<TaskResult>;
11
+ streamRaw(req: TaskRequest, opts?: {
12
+ signal?: AbortSignal;
13
+ }): Promise<Response>;
14
+ stream(req: TaskRequest, opts?: {
15
+ signal?: AbortSignal;
16
+ onResponse?: (res: Response) => void;
17
+ }): AsyncGenerator<AgentEvent>;
18
+ }
19
+ //# sourceMappingURL=tasks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/resources/tasks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI/C,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAKnC,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAc9G,SAAS,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgB9E,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAA;KAAE,GAAG,cAAc,CAAC,UAAU,CAAC;CAgBnI"}
@@ -0,0 +1,53 @@
1
+ import { readSseFrames } from "../sse.js";
2
+ import { toApiError } from "../errors.js";
3
+ export class TasksResource {
4
+ t;
5
+ constructor(t) {
6
+ this.t = t;
7
+ }
8
+ async submit(req, opts) {
9
+ return this.t.request({
10
+ method: "POST",
11
+ path: "/v1/tasks",
12
+ body: req,
13
+ submit: true,
14
+ idempotencyKey: opts?.idempotencyKey,
15
+ signal: opts?.signal,
16
+ });
17
+ }
18
+ async streamRaw(req, opts) {
19
+ const o = {
20
+ method: "POST",
21
+ path: "/v1/tasks/stream",
22
+ body: req,
23
+ submit: true,
24
+ };
25
+ if (opts?.signal)
26
+ o.signal = opts.signal;
27
+ const res = await this.t.openStream(o);
28
+ if (!res.ok)
29
+ throw toApiError(res.status, await res.json().catch(() => ({})));
30
+ return res;
31
+ }
32
+ async *stream(req, opts) {
33
+ const res = await this.streamRaw(req, opts);
34
+ try {
35
+ opts?.onResponse?.(res);
36
+ }
37
+ catch { }
38
+ try {
39
+ for await (const frame of readSseFrames(res, undefined, opts?.signal)) {
40
+ if (!frame.data)
41
+ continue;
42
+ const ev = JSON.parse(frame.data);
43
+ yield ev;
44
+ if (ev.type === "done" || ev.type === "failed")
45
+ return;
46
+ }
47
+ }
48
+ finally {
49
+ res.body?.cancel().catch(() => { });
50
+ }
51
+ }
52
+ }
53
+ //# sourceMappingURL=tasks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/resources/tasks.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAK7C,KAAK,CAAC,MAAM,CAAC,GAAgB,EAAE,IAA+D;QAC5F,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAa;YAChC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,IAAI;YACZ,cAAc,EAAE,IAAI,EAAE,cAAc;YACpC,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAKD,KAAK,CAAC,SAAS,CAAC,GAAgB,EAAE,IAA+B;QAC/D,MAAM,CAAC,GAA2C;YAChD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,IAAI;SACb,CAAC;QACF,IAAI,IAAI,EAAE,MAAM;YAAE,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9E,OAAO,GAAG,CAAC;IACb,CAAC;IAKD,KAAK,CAAC,CAAC,MAAM,CAAC,GAAgB,EAAE,IAAqE;QACnG,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAG5C,IAAI,CAAC;YAAC,IAAI,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAmD,CAAC;QAC5F,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;gBACtE,IAAI,CAAC,KAAK,CAAC,IAAI;oBAAE,SAAS;gBAC1B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAe,CAAC;gBAChD,MAAM,EAAE,CAAC;gBACT,IAAI,EAAE,CAAC,IAAI,KAAK,MAAM,IAAI,EAAE,CAAC,IAAI,KAAK,QAAQ;oBAAE,OAAO;YACzD,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;CACF"}
@@ -0,0 +1,43 @@
1
+ import type { Transport } from "../transport.js";
2
+ import type { Artifact, TaskSummary, TraceStreamEvent, TraceTurn } from "../types.js";
3
+ export declare class TraceResource {
4
+ private readonly t;
5
+ constructor(t: Transport);
6
+ list(opts?: {
7
+ jobId?: string;
8
+ status?: string;
9
+ source?: string;
10
+ owner?: string;
11
+ limit?: number;
12
+ cursor?: string;
13
+ signal?: AbortSignal;
14
+ }): Promise<{
15
+ tasks: TaskSummary[];
16
+ nextCursor?: string;
17
+ }>;
18
+ sourceSummary(opts?: {
19
+ sinceSec?: number;
20
+ signal?: AbortSignal;
21
+ }): Promise<{
22
+ rows: {
23
+ source: string;
24
+ status: string;
25
+ count: number;
26
+ }[];
27
+ }>;
28
+ turns(taskId: string, opts?: {
29
+ signal?: AbortSignal;
30
+ }): Promise<{
31
+ turns: TraceTurn[];
32
+ nextCursor?: string;
33
+ retainedFrom?: number;
34
+ }>;
35
+ artifacts(taskId: string, opts?: {
36
+ signal?: AbortSignal;
37
+ }): Promise<Artifact[]>;
38
+ stream(taskId: string, opts?: {
39
+ signal?: AbortSignal;
40
+ lastEventId?: string;
41
+ }): AsyncGenerator<TraceStreamEvent>;
42
+ }
43
+ //# sourceMappingURL=trace.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/resources/trace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGtF,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAKnC,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAchM,aAAa,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC;IAOzI,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAMnI,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAoB9E,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC,gBAAgB,CAAC;CA6BvH"}
@@ -0,0 +1,65 @@
1
+ import { parseFrameStream } from "../sse.js";
2
+ export class TraceResource {
3
+ t;
4
+ constructor(t) {
5
+ this.t = t;
6
+ }
7
+ async list(opts) {
8
+ const q = new URLSearchParams();
9
+ if (opts?.jobId)
10
+ q.set("jobId", opts.jobId);
11
+ if (opts?.status)
12
+ q.set("status", opts.status);
13
+ if (opts?.source)
14
+ q.set("source", opts.source);
15
+ if (opts?.owner)
16
+ q.set("owner", opts.owner);
17
+ if (opts?.limit !== undefined)
18
+ q.set("limit", String(opts.limit));
19
+ if (opts?.cursor)
20
+ q.set("cursor", opts.cursor);
21
+ const qs = q.toString();
22
+ return this.t.request({ method: "GET", path: `/v1/tasks${qs ? `?${qs}` : ""}`, signal: opts?.signal });
23
+ }
24
+ async sourceSummary(opts) {
25
+ const qs = opts?.sinceSec ? `?sinceSec=${opts.sinceSec}` : "";
26
+ return this.t.request({ method: "GET", path: `/v1/tasks/source-summary${qs}`, signal: opts?.signal });
27
+ }
28
+ async turns(taskId, opts) {
29
+ return this.t.request({ method: "GET", path: `/v1/tasks/${encodeURIComponent(taskId)}/turns`, signal: opts?.signal });
30
+ }
31
+ async artifacts(taskId, opts) {
32
+ const r = await this.t.request({
33
+ method: "GET",
34
+ path: `/v1/tasks/${encodeURIComponent(taskId)}/artifacts`,
35
+ signal: opts?.signal,
36
+ });
37
+ return r.artifacts;
38
+ }
39
+ async *stream(taskId, opts) {
40
+ let first = opts?.lastEventId;
41
+ const frames = parseFrameStream((lastEventId) => {
42
+ const id = lastEventId ?? first;
43
+ first = undefined;
44
+ const o = {
45
+ method: "GET",
46
+ path: `/v1/tasks/${encodeURIComponent(taskId)}/stream`,
47
+ };
48
+ if (id)
49
+ o.lastEventId = id;
50
+ if (opts?.signal)
51
+ o.signal = opts.signal;
52
+ return this.t.openStream(o);
53
+ }, (f) => f.event === "done" || f.event === "error", opts?.signal ? { signal: opts.signal } : undefined);
54
+ for await (const f of frames) {
55
+ if (f.event === "heartbeat" || !f.data)
56
+ continue;
57
+ const data = JSON.parse(f.data);
58
+ const ev = { event: (f.event ?? "message"), data };
59
+ if (f.id)
60
+ ev.id = f.id;
61
+ yield ev;
62
+ }
63
+ }
64
+ }
65
+ //# sourceMappingURL=trace.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/resources/trace.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import type { Transport } from "../transport.js";
2
+ import type { UsageInfo } from "../types.js";
3
+ export declare class UsageResource {
4
+ private readonly t;
5
+ constructor(t: Transport);
6
+ get(opts?: {
7
+ signal?: AbortSignal;
8
+ }): Promise<UsageInfo>;
9
+ }
10
+ //# sourceMappingURL=usage.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/resources/usage.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAGnC,GAAG,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC;CAG/D"}
@@ -0,0 +1,10 @@
1
+ export class UsageResource {
2
+ t;
3
+ constructor(t) {
4
+ this.t = t;
5
+ }
6
+ async get(opts) {
7
+ return this.t.request({ method: "GET", path: "/v1/usage", signal: opts?.signal });
8
+ }
9
+ }
10
+ //# sourceMappingURL=usage.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/resources/usage.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAG7C,KAAK,CAAC,GAAG,CAAC,IAA+B;QACvC,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACpF,CAAC;CACF"}
@@ -0,0 +1,20 @@
1
+ import type { Transport } from "../transport.js";
2
+ import type { WorkflowRunSummary, WorkflowRun, WorkflowStreamEvent } from "../types.js";
3
+ export declare class WorkflowsResource {
4
+ private readonly t;
5
+ constructor(t: Transport);
6
+ list(opts?: {
7
+ status?: string;
8
+ limit?: number;
9
+ signal?: AbortSignal;
10
+ }): Promise<{
11
+ workflows: WorkflowRunSummary[];
12
+ }>;
13
+ get(id: string, opts?: {
14
+ signal?: AbortSignal;
15
+ }): Promise<WorkflowRun>;
16
+ stream(id: string, opts?: {
17
+ signal?: AbortSignal;
18
+ }): AsyncGenerator<WorkflowStreamEvent>;
19
+ }
20
+ //# sourceMappingURL=workflows.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/resources/workflows.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIxF,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAGnC,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,kBAAkB,EAAE,CAAA;KAAE,CAAC;IASpH,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAgBrE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,cAAc,CAAC,mBAAmB,CAAC;CAkBhG"}
@@ -0,0 +1,43 @@
1
+ import { readSseFrames } from "../sse.js";
2
+ import { toApiError } from "../errors.js";
3
+ export class WorkflowsResource {
4
+ t;
5
+ constructor(t) {
6
+ this.t = t;
7
+ }
8
+ async list(opts) {
9
+ const q = new URLSearchParams();
10
+ if (opts?.status)
11
+ q.set("status", opts.status);
12
+ if (opts?.limit !== undefined)
13
+ q.set("limit", String(opts.limit));
14
+ const qs = q.toString();
15
+ return this.t.request({ method: "GET", path: `/v1/workflows${qs ? `?${qs}` : ""}`, signal: opts?.signal });
16
+ }
17
+ async get(id, opts) {
18
+ return this.t.request({ method: "GET", path: `/v1/workflows/${encodeURIComponent(id)}`, signal: opts?.signal });
19
+ }
20
+ async *stream(id, opts) {
21
+ const o = {
22
+ method: "GET",
23
+ path: `/v1/workflows/${encodeURIComponent(id)}/stream`,
24
+ };
25
+ if (opts?.signal)
26
+ o.signal = opts.signal;
27
+ const res = await this.t.openStream(o);
28
+ if (!res.ok)
29
+ throw toApiError(res.status, await res.json().catch(() => ({})));
30
+ try {
31
+ for await (const frame of readSseFrames(res, undefined, opts?.signal)) {
32
+ if (!frame.data)
33
+ continue;
34
+ const data = JSON.parse(frame.data);
35
+ yield { event: (frame.event ?? "message"), data };
36
+ }
37
+ }
38
+ finally {
39
+ res.body?.cancel().catch(() => { });
40
+ }
41
+ }
42
+ }
43
+ //# sourceMappingURL=workflows.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workflows.js","sourceRoot":"","sources":["../../src/resources/workflows.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;IAAG,CAAC;IAG7C,KAAK,CAAC,IAAI,CAAC,IAAgE;QACzE,MAAM,CAAC,GAAG,IAAI,eAAe,EAAE,CAAC;QAChC,IAAI,IAAI,EAAE,MAAM;YAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,IAAI,EAAE,KAAK,KAAK,SAAS;YAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAClE,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7G,CAAC;IAGD,KAAK,CAAC,GAAG,CAAC,EAAU,EAAE,IAA+B;QACnD,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAClH,CAAC;IAcD,KAAK,CAAC,CAAC,MAAM,CAAC,EAAU,EAAE,IAA+B;QACvD,MAAM,CAAC,GAA2C;YAChD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,SAAS;SACvD,CAAC;QACF,IAAI,IAAI,EAAE,MAAM;YAAE,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9E,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;gBACtE,IAAI,CAAC,KAAK,CAAC,IAAI;oBAAE,SAAS;gBAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;gBAC/D,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,SAAS,CAAiC,EAAE,IAAI,EAAE,CAAC;YACpF,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;CACF"}
@@ -0,0 +1,44 @@
1
+ export interface SettingsHookCommand {
2
+ type: "command";
3
+ command: string;
4
+ timeout?: number;
5
+ [k: string]: unknown;
6
+ }
7
+ export interface SettingsHookMatcher {
8
+ matcher?: string;
9
+ hooks: SettingsHookCommand[];
10
+ }
11
+ export interface SettingsHooks {
12
+ PreToolUse?: SettingsHookMatcher[];
13
+ PostToolUse?: SettingsHookMatcher[];
14
+ UserPromptSubmit?: SettingsHookMatcher[];
15
+ [event: string]: SettingsHookMatcher[] | undefined;
16
+ }
17
+ export interface SettingsPermissions {
18
+ allow?: string[];
19
+ deny?: string[];
20
+ ask?: string[];
21
+ additionalDirectories?: string[];
22
+ defaultMode?: "default" | "acceptEdits" | "plan";
23
+ disableBypassPermissionsMode?: boolean;
24
+ disableAutoMode?: boolean;
25
+ [k: string]: unknown;
26
+ }
27
+ export type SettingsEnv = Record<string, string>;
28
+ export interface SettingsWebSearch {
29
+ provider?: "brave" | "tavily" | "searxng";
30
+ apiKey?: string;
31
+ endpoint?: string;
32
+ maxResults?: number;
33
+ }
34
+ export interface SemaSettings {
35
+ permissions?: SettingsPermissions;
36
+ hooks?: SettingsHooks;
37
+ env?: SettingsEnv;
38
+ model?: string;
39
+ outputStyle?: string;
40
+ webSearch?: SettingsWebSearch;
41
+ ultracode?: boolean;
42
+ [k: string]: unknown;
43
+ }
44
+ //# sourceMappingURL=settings.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,mBAAmB;IAElC,IAAI,EAAE,SAAS,CAAC;IAGhB,OAAO,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAGD,MAAM,WAAW,mBAAmB;IAGlC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAC9B;AAKD,MAAM,WAAW,aAAa;IAG5B,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAEnC,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAEpC,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAEzC,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,EAAE,GAAG,SAAS,CAAC;CACpD;AAKD,MAAM,WAAW,mBAAmB;IAElC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IAEf,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IAMjC,WAAW,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC;IAEjD,4BAA4B,CAAC,EAAE,OAAO,CAAC;IAEvC,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAGD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AASjD,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAE1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,MAAM,WAAW,YAAY;IAE3B,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAElC,KAAK,CAAC,EAAE,aAAa,CAAC;IAEtB,GAAG,CAAC,EAAE,WAAW,CAAC;IAElB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAW9B,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=settings.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":""}
package/dist/sse.d.ts ADDED
@@ -0,0 +1,26 @@
1
+ import type { AgentEvent } from "./events.js";
2
+ export declare const HEARTBEAT_GRACE_MS = 45000;
3
+ export declare function parseSse(open: (lastEventId?: string) => Promise<Response>, opts?: {
4
+ heartbeatGraceMs?: number;
5
+ signal?: AbortSignal;
6
+ }): AsyncGenerator<AgentEvent>;
7
+ export type StampedAgentEvent = AgentEvent & {
8
+ id?: string;
9
+ };
10
+ export declare function parseFrameStream(open: (lastEventId?: string) => Promise<Response>, isTerminal: (frame: SseFrame) => boolean, opts?: {
11
+ heartbeatGraceMs?: number;
12
+ signal?: AbortSignal;
13
+ }): AsyncGenerator<SseFrame>;
14
+ export interface SseFrame {
15
+ id?: string;
16
+ event?: string;
17
+ data?: string;
18
+ }
19
+ export declare function readSseFrames(res: Response, heartbeatGraceMs?: number, signal?: AbortSignal): AsyncGenerator<SseFrame>;
20
+ export declare class SyncTruncatedError extends Error {
21
+ readonly received: number;
22
+ readonly expected?: number | undefined;
23
+ constructor(message: string, received: number, expected?: number | undefined);
24
+ }
25
+ export declare function parseNdjsonEntries<T = unknown>(res: Response, signal?: AbortSignal): AsyncGenerator<T>;
26
+ //# sourceMappingURL=sse.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAKzC,wBAAuB,QAAQ,CAC7B,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,EACjD,IAAI,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GACzD,cAAc,CAAC,UAAU,CAAC,CAsD5B;AAID,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAS7D,wBAAuB,gBAAgB,CACrC,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,EACjD,UAAU,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,EACxC,IAAI,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GACzD,cAAc,CAAC,QAAQ,CAAC,CA4C1B;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,wBAAuB,aAAa,CAClC,GAAG,EAAE,QAAQ,EACb,gBAAgB,SAAqB,EACrC,MAAM,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC,QAAQ,CAAC,CA4C1B;AAiBD,qBAAa,kBAAmB,SAAQ,KAAK;IACd,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM;gBAAtE,OAAO,EAAE,MAAM,EAAW,QAAQ,EAAE,MAAM,EAAW,QAAQ,CAAC,EAAE,MAAM,YAAA;CAInF;AAOD,wBAAuB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EACnD,GAAG,EAAE,QAAQ,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC,CAAC,CAAC,CAuDnB"}
package/dist/sse.js ADDED
@@ -0,0 +1,244 @@
1
+ import { toApiError } from "./errors.js";
2
+ export const HEARTBEAT_GRACE_MS = 45_000;
3
+ const MAX_CONSECUTIVE_FAILURES = 5;
4
+ export async function* parseSse(open, opts) {
5
+ const grace = opts?.heartbeatGraceMs ?? HEARTBEAT_GRACE_MS;
6
+ let lastId;
7
+ let failures = 0;
8
+ for (;;) {
9
+ if (opts?.signal?.aborted)
10
+ return;
11
+ let res;
12
+ try {
13
+ res = await open(lastId);
14
+ }
15
+ catch (e) {
16
+ if (++failures >= MAX_CONSECUTIVE_FAILURES)
17
+ throw e;
18
+ await new Promise((r) => setTimeout(r, 500 * failures));
19
+ continue;
20
+ }
21
+ if (res.status === 416) {
22
+ const body = (await res.json().catch(() => ({})));
23
+ lastId = body.retainedFrom !== undefined ? String(body.retainedFrom - 1) : lastId;
24
+ if (++failures >= MAX_CONSECUTIVE_FAILURES)
25
+ throw toApiError(416, body);
26
+ continue;
27
+ }
28
+ if (!res.ok) {
29
+ throw toApiError(res.status, await res.json().catch(() => ({})));
30
+ }
31
+ let sawTerminal = false;
32
+ try {
33
+ for await (const frame of readSseFrames(res, grace, opts?.signal)) {
34
+ failures = 0;
35
+ if (frame.id)
36
+ lastId = frame.id;
37
+ if (!frame.data)
38
+ continue;
39
+ const ev = JSON.parse(frame.data);
40
+ if (frame.id)
41
+ ev.id = frame.id;
42
+ yield ev;
43
+ if (ev.type === "done" || ev.type === "failed") {
44
+ sawTerminal = true;
45
+ return;
46
+ }
47
+ }
48
+ }
49
+ catch (e) {
50
+ if (e instanceof SyntaxError)
51
+ throw new Error(`SSE: malformed event data (contract breach): ${e.message}`);
52
+ }
53
+ finally {
54
+ if (!sawTerminal)
55
+ res.body?.cancel().catch(() => { });
56
+ }
57
+ if (++failures >= MAX_CONSECUTIVE_FAILURES)
58
+ throw new Error("SSE: stream keeps ending without progress or a terminal event");
59
+ if (opts?.signal?.aborted)
60
+ return;
61
+ }
62
+ }
63
+ export async function* parseFrameStream(open, isTerminal, opts) {
64
+ const grace = opts?.heartbeatGraceMs ?? HEARTBEAT_GRACE_MS;
65
+ let lastId;
66
+ let failures = 0;
67
+ for (;;) {
68
+ if (opts?.signal?.aborted)
69
+ return;
70
+ let res;
71
+ try {
72
+ res = await open(lastId);
73
+ }
74
+ catch (e) {
75
+ if (++failures >= MAX_CONSECUTIVE_FAILURES)
76
+ throw e;
77
+ await new Promise((r) => setTimeout(r, 500 * failures));
78
+ continue;
79
+ }
80
+ if (res.status === 416) {
81
+ const body = (await res.json().catch(() => ({})));
82
+ lastId = body.retainedFrom !== undefined ? String(body.retainedFrom - 1) : lastId;
83
+ if (++failures >= MAX_CONSECUTIVE_FAILURES)
84
+ throw toApiError(416, body);
85
+ continue;
86
+ }
87
+ if (!res.ok)
88
+ throw toApiError(res.status, await res.json().catch(() => ({})));
89
+ let sawTerminal = false;
90
+ try {
91
+ for await (const frame of readSseFrames(res, grace, opts?.signal)) {
92
+ failures = 0;
93
+ if (frame.id)
94
+ lastId = frame.id;
95
+ yield frame;
96
+ if (isTerminal(frame)) {
97
+ sawTerminal = true;
98
+ return;
99
+ }
100
+ }
101
+ }
102
+ catch (e) {
103
+ if (e instanceof SyntaxError)
104
+ throw e;
105
+ }
106
+ finally {
107
+ if (!sawTerminal)
108
+ res.body?.cancel().catch(() => { });
109
+ }
110
+ if (++failures >= MAX_CONSECUTIVE_FAILURES)
111
+ throw new Error("SSE: stream keeps ending without progress or a terminal frame");
112
+ if (opts?.signal?.aborted)
113
+ return;
114
+ }
115
+ }
116
+ export async function* readSseFrames(res, heartbeatGraceMs = HEARTBEAT_GRACE_MS, signal) {
117
+ if (!res.body)
118
+ throw new Error("SSE: response has no body");
119
+ const reader = res.body.getReader();
120
+ const decoder = new TextDecoder();
121
+ let buf = "";
122
+ let frame = {};
123
+ let dataLines = [];
124
+ try {
125
+ for (;;) {
126
+ if (signal?.aborted)
127
+ return;
128
+ const chunk = await withTimeout(reader.read(), heartbeatGraceMs);
129
+ if (chunk.done)
130
+ return;
131
+ buf += decoder.decode(chunk.value, { stream: true });
132
+ let nl;
133
+ while ((nl = buf.indexOf("\n")) !== -1) {
134
+ let line = buf.slice(0, nl);
135
+ buf = buf.slice(nl + 1);
136
+ if (line.endsWith("\r"))
137
+ line = line.slice(0, -1);
138
+ if (line === "") {
139
+ if (dataLines.length > 0 || frame.id || frame.event) {
140
+ if (dataLines.length > 0)
141
+ frame.data = dataLines.join("\n");
142
+ yield frame;
143
+ }
144
+ frame = {};
145
+ dataLines = [];
146
+ continue;
147
+ }
148
+ if (line.startsWith(":"))
149
+ continue;
150
+ const colon = line.indexOf(":");
151
+ const field = colon === -1 ? line : line.slice(0, colon);
152
+ let value = colon === -1 ? "" : line.slice(colon + 1);
153
+ if (value.startsWith(" "))
154
+ value = value.slice(1);
155
+ if (field === "data")
156
+ dataLines.push(value);
157
+ else if (field === "id")
158
+ frame.id = value;
159
+ else if (field === "event")
160
+ frame.event = value;
161
+ }
162
+ }
163
+ }
164
+ finally {
165
+ reader.releaseLock();
166
+ }
167
+ }
168
+ export class SyncTruncatedError extends Error {
169
+ received;
170
+ expected;
171
+ constructor(message, received, expected) {
172
+ super(message);
173
+ this.received = received;
174
+ this.expected = expected;
175
+ this.name = "SyncTruncatedError";
176
+ }
177
+ }
178
+ export async function* parseNdjsonEntries(res, signal) {
179
+ if (!res.body)
180
+ throw new Error("sync: response has no body");
181
+ const reader = res.body.getReader();
182
+ const decoder = new TextDecoder();
183
+ let buf = "";
184
+ let sawBegin = false;
185
+ let trailer = null;
186
+ let count = 0;
187
+ const handleLine = function* (line) {
188
+ const trimmed = line.trim();
189
+ if (trimmed.length === 0)
190
+ return;
191
+ let v;
192
+ try {
193
+ v = JSON.parse(trimmed);
194
+ }
195
+ catch (e) {
196
+ throw new Error(`sync: malformed NDJSON line (contract breach): ${e.message}`);
197
+ }
198
+ if (v.__sync === "begin") {
199
+ sawBegin = true;
200
+ return;
201
+ }
202
+ if (v.__sync === "end") {
203
+ trailer = typeof v.count === "number" ? { count: v.count } : {};
204
+ return;
205
+ }
206
+ count++;
207
+ yield v;
208
+ };
209
+ try {
210
+ for (;;) {
211
+ if (signal?.aborted)
212
+ throw new Error("sync: aborted");
213
+ const chunk = await reader.read();
214
+ if (chunk.done)
215
+ break;
216
+ buf += decoder.decode(chunk.value, { stream: true });
217
+ let nl;
218
+ while ((nl = buf.indexOf("\n")) !== -1) {
219
+ const line = buf.slice(0, nl);
220
+ buf = buf.slice(nl + 1);
221
+ yield* handleLine(line);
222
+ }
223
+ }
224
+ if (buf.length > 0)
225
+ yield* handleLine(buf);
226
+ }
227
+ finally {
228
+ reader.releaseLock();
229
+ }
230
+ if (trailer === null) {
231
+ throw new SyncTruncatedError(sawBegin ? "sync: entry stream truncated (missing trailer)" : "sync: entry stream truncated (no begin/end frame)", count);
232
+ }
233
+ const expected = trailer.count;
234
+ if (expected !== undefined && expected !== count) {
235
+ throw new SyncTruncatedError(`sync: entry count mismatch (trailer ${expected} ≠ ${count} received)`, count, expected);
236
+ }
237
+ }
238
+ function withTimeout(p, ms) {
239
+ return new Promise((resolve, reject) => {
240
+ const t = setTimeout(() => reject(new Error(`SSE: no data for ${ms}ms (heartbeat silence)`)), ms);
241
+ p.then((v) => { clearTimeout(t); resolve(v); }, (e) => { clearTimeout(t); reject(e); });
242
+ });
243
+ }
244
+ //# sourceMappingURL=sse.js.map