@introspection-sdk/introspection-browser 0.5.7 → 0.5.9

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @introspection-sdk/introspection-browser@0.5.7 build /home/runner/work/introspection-js-sdk/introspection-js-sdk/packages/introspection-browser
+> @introspection-sdk/introspection-browser@0.5.9 build /home/runner/work/introspection-js-sdk/introspection-js-sdk/packages/introspection-browser
 > tsc
 

package/README.md

@@ -78,13 +78,13 @@ const run = await client.tasks.start({
 });
 
 for await (const ev of run.stream()) {
-  console.log(ev.event, ev.data);
+  console.log(ev.type);
 }
 ```
 
 `client.tasks` exposes the full CRUD surface (`create` / `start` / `get` /
 `list` / `update` / `delete` / `archive` / `unarchive`) plus per-run streaming
-(`run.stream()`, `run.text()`, `run.cancel()`).
+(`run.stream()` yields AG-UI events, `run.text()`, `run.cancel()`).
 
 `create` and `start` accept **`idle_timeout_seconds`** (`number`) to override
 the interactive idle window before the sandbox is torn down. `0` tears it down

package/dist/api/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,YAAY,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AASzC,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,2DAA2D;IAC3D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED,qBAAa,sBAAsB;IAIrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAEjB,IAAI,EAAE,6BAA6B;IAwBhE,6DAA6D;IAC7D,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED,6DAA6D;IAC7D,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED,4EAA4E;IAC5E,IAAI,aAAa,IAAI,mBAAmB,CAEvC;IAED,oEAAoE;IACpE,IAAI,MAAM,IAAI,YAAY,CAEzB;IAED;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAIhB,QAAQ;IAiBtB,0EAA0E;YAC5D,UAAU;CAQzB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,YAAY,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AASzC,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,2DAA2D;IAC3D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED,qBAAa,sBAAsB;IAIrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAEjB,IAAI,EAAE,6BAA6B;IAuBhE,6DAA6D;IAC7D,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED,6DAA6D;IAC7D,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED,4EAA4E;IAC5E,IAAI,aAAa,IAAI,mBAAmB,CAEvC;IAED,oEAAoE;IACpE,IAAI,MAAM,IAAI,YAAY,CAEzB;IAED;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAIhB,QAAQ;IAiBtB,0EAA0E;YAC5D,UAAU;CAQzB"}

package/dist/api/client.js

@@ -24,6 +24,7 @@
  * before retrying.
  */
 import { BrowserHttpClient, stripTrailingSlash, toApiError } from "./http.js";
+import { resolveBrowserFetch } from "./fetch.js";
 import { ConversationsClient, FilesClient, SharesClient, } from "@introspection-sdk/http";
 import { TasksClient } from "./tasks.js";
 export class IntrospectionApiClient {
@@ -32,17 +33,18 @@ export class IntrospectionApiClient {
     cookieClients;
     constructor(opts) {
         this.opts = opts;
-        this.fetchImpl = opts.fetch ?? globalThis.fetch;
-        if (!this.fetchImpl) {
-            throw new Error("global fetch is unavailable; pass `fetch` or run in a modern browser");
-        }
+        // Native browser `fetch` throws "Illegal invocation" when called as a
+        // method of this client (`this.fetchImpl(...)`); resolveBrowserFetch
+        // returns a global-safe wrapper. The same impl backs the connect()
+        // exchange here and the cookie-session resource calls via BrowserHttpClient.
+        this.fetchImpl = resolveBrowserFetch(opts.fetch);
         if (!opts.dpUrl) {
             throw new Error("IntrospectionApiClient requires a dpUrl");
         }
         const http = new BrowserHttpClient({
             apiUrl: opts.dpUrl,
             additionalHeaders: opts.additionalHeaders,
-            fetch: opts.fetch,
+            fetch: this.fetchImpl,
             onUnauthorized: () => this.reexchange(),
         });
         this.cookieClients = {

package/dist/api/client.js.map

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

package/dist/api/fetch.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Resolve the `fetch` implementation for browser Data Plane calls.
+ *
+ * The native browser `fetch` brand-checks its `this`: it must be the global
+ * (`window` / `WorkerGlobalScope`). Storing `globalThis.fetch` on an instance
+ * field and later calling it as a method — `this.fetchImpl(url, init)` — rebinds
+ * `this` to the client instance, so the browser throws
+ * `Failed to execute 'fetch' on 'Window': Illegal invocation`.
+ *
+ * When no custom `fetch` is supplied we therefore return a thin wrapper that
+ * invokes `globalThis.fetch(...)` **as a method of the global** (correct `this`)
+ * and resolves it **per call**. The per-call lookup is deliberate: the only
+ * reason to go through `globalThis.fetch` rather than the lexical `fetch` is so
+ * a swapped-in implementation is honored — that is the server-side proxy
+ * (`@introspection-sdk/introspection-proxy` monkeypatches `globalThis.fetch`),
+ * never a browser concern. A caller-supplied `fetch` is returned untouched.
+ *
+ * This lives in the browser package on purpose: Node's `fetch` (undici) has no
+ * such brand check, so the shared {@link BaseHttpClient} / Node client keep
+ * resolving `globalThis.fetch` directly (so the proxy override still applies).
+ */
+export declare function resolveBrowserFetch(custom?: typeof fetch): typeof fetch;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/api/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/api/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,GAAG,OAAO,KAAK,CASvE"}

package/dist/api/fetch.js

@@ -0,0 +1,30 @@
+/**
+ * Resolve the `fetch` implementation for browser Data Plane calls.
+ *
+ * The native browser `fetch` brand-checks its `this`: it must be the global
+ * (`window` / `WorkerGlobalScope`). Storing `globalThis.fetch` on an instance
+ * field and later calling it as a method — `this.fetchImpl(url, init)` — rebinds
+ * `this` to the client instance, so the browser throws
+ * `Failed to execute 'fetch' on 'Window': Illegal invocation`.
+ *
+ * When no custom `fetch` is supplied we therefore return a thin wrapper that
+ * invokes `globalThis.fetch(...)` **as a method of the global** (correct `this`)
+ * and resolves it **per call**. The per-call lookup is deliberate: the only
+ * reason to go through `globalThis.fetch` rather than the lexical `fetch` is so
+ * a swapped-in implementation is honored — that is the server-side proxy
+ * (`@introspection-sdk/introspection-proxy` monkeypatches `globalThis.fetch`),
+ * never a browser concern. A caller-supplied `fetch` is returned untouched.
+ *
+ * This lives in the browser package on purpose: Node's `fetch` (undici) has no
+ * such brand check, so the shared {@link BaseHttpClient} / Node client keep
+ * resolving `globalThis.fetch` directly (so the proxy override still applies).
+ */
+export function resolveBrowserFetch(custom) {
+    if (custom)
+        return custom;
+    if (!globalThis.fetch) {
+        throw new Error("global fetch is unavailable; pass `fetch` or run in a modern browser");
+    }
+    return (input, init) => globalThis.fetch(input, init);
+}
+//# sourceMappingURL=fetch.js.map

package/dist/api/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/api/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,KAAwB,EAAE,IAAkB,EAAE,EAAE,CACtD,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/dist/api/http.d.ts

@@ -2,7 +2,7 @@
  * Browser HTTP transport for the Introspection Data Plane `/v1` surface.
  *
  * The request/response machinery — URL joining, query building, body
- * serialization, error mapping, SSE — lives in the shared
+ * serialization, error mapping, AG-UI stream parsing — lives in the shared
  * `@introspection-sdk/http` {@link BaseHttpClient}. This module pins the
  * browser auth strategy on top of it: the DP is reached with the HttpOnly
  * `intro_dp_session` cookie minted by `POST /v1/oauth/exchange`, so every

package/dist/api/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/api/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,UAAU,EACX,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,2DAA2D;IAC3D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;gBACvC,GAAG,EAAE,iBAAiB;CAYnC"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/api/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,UAAU,EACX,MAAM,yBAAyB,CAAC;AAKjC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,2DAA2D;IAC3D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;gBACvC,GAAG,EAAE,iBAAiB;CAanC"}

package/dist/api/http.js

@@ -2,7 +2,7 @@
  * Browser HTTP transport for the Introspection Data Plane `/v1` surface.
  *
  * The request/response machinery — URL joining, query building, body
- * serialization, error mapping, SSE — lives in the shared
+ * serialization, error mapping, AG-UI stream parsing — lives in the shared
  * `@introspection-sdk/http` {@link BaseHttpClient}. This module pins the
  * browser auth strategy on top of it: the DP is reached with the HttpOnly
  * `intro_dp_session` cookie minted by `POST /v1/oauth/exchange`, so every
@@ -11,6 +11,7 @@
  * session cookie) triggers a single `onUnauthorized` refresh + retry.
  */
 import { BaseHttpClient, stripTrailingSlash, toApiError, } from "@introspection-sdk/http";
+import { resolveBrowserFetch } from "./fetch.js";
 // Re-exported for `client.ts`, which redeems the DP session on `connect()`.
 export { stripTrailingSlash, toApiError };
 /**
@@ -21,8 +22,9 @@ export class BrowserHttpClient extends BaseHttpClient {
     constructor(cfg) {
         super({
             apiUrl: cfg.apiUrl,
+            // Resolve a browser-safe `fetch` (native `fetch` brand-checks `this`).
+            fetch: resolveBrowserFetch(cfg.fetch),
             additionalHeaders: cfg.additionalHeaders,
-            fetch: cfg.fetch,
             transport: {
                 authHeaders: () => ({}),
                 credentials: "include",

package/dist/api/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/api/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,UAAU,GACX,MAAM,yBAAyB,CAAC;AAEjC,4EAA4E;AAC5E,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,CAAC;AAiB1C;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,cAAc;IACnD,YAAY,GAAsB;QAChC,KAAK,CAAC;YACJ,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;YACxC,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,SAAS,EAAE;gBACT,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;gBACvB,WAAW,EAAE,SAAS;gBACtB,cAAc,EAAE,GAAG,CAAC,cAAc;aACnC;SACF,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/api/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,UAAU,GACX,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,4EAA4E;AAC5E,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,CAAC;AAiB1C;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,cAAc;IACnD,YAAY,GAAsB;QAChC,KAAK,CAAC;YACJ,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,uEAAuE;YACvE,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC;YACrC,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;YACxC,SAAS,EAAE;gBACT,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;gBACvB,WAAW,EAAE,SAAS;gBACtB,cAAc,EAAE,GAAG,CAAC,cAAc;aACnC;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/api/index.d.ts

@@ -31,15 +31,15 @@
  *   prompt: "Summarize my latest order",
  *   runtime_id: runtimeId,
  * });
- * for await (const ev of run.stream()) console.log(ev.event, ev.data);
+ * for await (const ev of run.stream()) console.log(ev.type);
  * ```
  */
 export { IntrospectionApiClient, type IntrospectionApiClientOptions, } from "./client.js";
 export { TasksClient, TaskRunsClient, RunHandle, type CreateTaskParams, type StartTaskParams, } from "./tasks.js";
 export { ConversationItemsClient, ConversationsClient, FileVersionsClient, FilesClient, SharesClient, type FileUploadBody, } from "@introspection-sdk/http";
 export { BrowserHttpClient, type BrowserHttpConfig } from "./http.js";
-export { parseSse } from "./sse.js";
 export { Paginator, cursorPaginate, type PageSource, } from "@introspection-sdk/http";
-export type { Task, TaskRun, TaskStatus, TaskCreateResponse, TaskListParams, TaskUpdateParams, TaskRunCreateParams, TaskCancelResponse, RunIdentityInput, Paginated, SseEvent, File, FileType, FileListParams, FileUpdateParams, FileCreateTextParams, ListParams, ConversationSummary, ConversationItem, ConversationItemList, ConversationListParams, ConversationItemListParams, ConversationItemInclude, ConversationResponse, ResourceShare, ShareResourceType, ShareCreateParams, ShareListParams, } from "@introspection-sdk/types";
+export { EventType } from "@introspection-sdk/types";
+export type { AGUIEvent, BaseEvent, Interrupt, Message, ResumeEntry, RunAgentInput, Task, TaskRun, TaskStatus, TaskRunKind, TaskCreateResponse, TaskListParams, TaskUpdateParams, TaskRunCreateParams, TaskRunResumeParams, TaskCancelResponse, RunIdentityInput, Paginated, File, FileType, FileListParams, FileUpdateParams, FileCreateTextParams, ListParams, ConversationSummary, ConversationItem, ConversationItemList, ConversationListParams, ConversationItemListParams, ConversationItemInclude, ConversationResponse, ResourceShare, ShareResourceType, ShareCreateParams, ShareListParams, } from "@introspection-sdk/types";
 export { IntrospectionAPIError, AuthenticationError, InsufficientScopeError, NotFoundError, NetworkError, RunnerExpiredError, } from "@introspection-sdk/types";
 //# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,GACnC,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,cAAc,EACd,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EACL,SAAS,EACT,cAAc,EACd,KAAK,UAAU,GAChB,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,IAAI,EACJ,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,kBAAkB,GACnB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,GACnC,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,cAAc,EACd,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EACL,SAAS,EACT,cAAc,EACd,KAAK,UAAU,GAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGrD,YAAY,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,OAAO,EACP,WAAW,EACX,aAAa,EACb,IAAI,EACJ,OAAO,EACP,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,kBAAkB,GACnB,MAAM,0BAA0B,CAAC"}

package/dist/api/index.js

@@ -31,14 +31,14 @@
  *   prompt: "Summarize my latest order",
  *   runtime_id: runtimeId,
  * });
- * for await (const ev of run.stream()) console.log(ev.event, ev.data);
+ * for await (const ev of run.stream()) console.log(ev.type);
  * ```
  */
 export { IntrospectionApiClient, } from "./client.js";
 export { TasksClient, TaskRunsClient, RunHandle, } from "./tasks.js";
 export { ConversationItemsClient, ConversationsClient, FileVersionsClient, FilesClient, SharesClient, } from "@introspection-sdk/http";
 export { BrowserHttpClient } from "./http.js";
-export { parseSse } from "./sse.js";
 export { Paginator, cursorPaginate, } from "@introspection-sdk/http";
+export { EventType } from "@introspection-sdk/types";
 export { IntrospectionAPIError, AuthenticationError, InsufficientScopeError, NotFoundError, NetworkError, RunnerExpiredError, } from "@introspection-sdk/types";
 //# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EACL,sBAAsB,GAEvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,cAAc,EACd,SAAS,GAGV,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,YAAY,GAEb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAA0B,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EACL,SAAS,EACT,cAAc,GAEf,MAAM,yBAAyB,CAAC;AAiCjC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,kBAAkB,GACnB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EACL,sBAAsB,GAEvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,cAAc,EACd,SAAS,GAGV,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,YAAY,GAEb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAA0B,MAAM,WAAW,CAAC;AACtE,OAAO,EACL,SAAS,EACT,cAAc,GAEf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAwCrD,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,kBAAkB,GACnB,MAAM,0BAA0B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@introspection-sdk/introspection-browser",
-  "version": "0.5.7",
+  "version": "0.5.9",
   "license": "Apache-2.0",
   "description": "Introspection observability SDK for the browser",
   "engines": {
@@ -20,7 +20,7 @@
     }
   },
   "devDependencies": {
-    "@types/node": "^22.19.21",
+    "@types/node": "^22.20.0",
     "eslint": "^9.39.4",
     "typescript": "5.9.3",
     "@repo/eslint-config": "0.0.0",
@@ -31,8 +31,8 @@
     "@opentelemetry/api-logs": "^0.219.0",
     "@opentelemetry/sdk-logs": "^0.219.0",
     "@opentelemetry/exporter-logs-otlp-http": "^0.219.0",
-    "@introspection-sdk/types": "0.5.7",
-    "@introspection-sdk/http": "0.5.7"
+    "@introspection-sdk/http": "0.5.9",
+    "@introspection-sdk/types": "0.5.9"
   },
   "scripts": {
     "lint": "eslint . --max-warnings 0",

package/src/api/client.ts

@@ -25,6 +25,7 @@
  */
 
 import { BrowserHttpClient, stripTrailingSlash, toApiError } from "./http.js";
+import { resolveBrowserFetch } from "./fetch.js";
 import {
   ConversationsClient,
   FilesClient,
@@ -65,19 +66,18 @@ export class IntrospectionApiClient {
   private readonly cookieClients: CookieClients;
 
   constructor(private readonly opts: IntrospectionApiClientOptions) {
-    this.fetchImpl = opts.fetch ?? globalThis.fetch;
-    if (!this.fetchImpl) {
-      throw new Error(
-        "global fetch is unavailable; pass `fetch` or run in a modern browser",
-      );
-    }
+    // Native browser `fetch` throws "Illegal invocation" when called as a
+    // method of this client (`this.fetchImpl(...)`); resolveBrowserFetch
+    // returns a global-safe wrapper. The same impl backs the connect()
+    // exchange here and the cookie-session resource calls via BrowserHttpClient.
+    this.fetchImpl = resolveBrowserFetch(opts.fetch);
     if (!opts.dpUrl) {
       throw new Error("IntrospectionApiClient requires a dpUrl");
     }
     const http = new BrowserHttpClient({
       apiUrl: opts.dpUrl,
       additionalHeaders: opts.additionalHeaders,
-      fetch: opts.fetch,
+      fetch: this.fetchImpl,
       onUnauthorized: () => this.reexchange(),
     });
     this.cookieClients = {

package/src/api/fetch.ts

@@ -0,0 +1,31 @@
+/**
+ * Resolve the `fetch` implementation for browser Data Plane calls.
+ *
+ * The native browser `fetch` brand-checks its `this`: it must be the global
+ * (`window` / `WorkerGlobalScope`). Storing `globalThis.fetch` on an instance
+ * field and later calling it as a method — `this.fetchImpl(url, init)` — rebinds
+ * `this` to the client instance, so the browser throws
+ * `Failed to execute 'fetch' on 'Window': Illegal invocation`.
+ *
+ * When no custom `fetch` is supplied we therefore return a thin wrapper that
+ * invokes `globalThis.fetch(...)` **as a method of the global** (correct `this`)
+ * and resolves it **per call**. The per-call lookup is deliberate: the only
+ * reason to go through `globalThis.fetch` rather than the lexical `fetch` is so
+ * a swapped-in implementation is honored — that is the server-side proxy
+ * (`@introspection-sdk/introspection-proxy` monkeypatches `globalThis.fetch`),
+ * never a browser concern. A caller-supplied `fetch` is returned untouched.
+ *
+ * This lives in the browser package on purpose: Node's `fetch` (undici) has no
+ * such brand check, so the shared {@link BaseHttpClient} / Node client keep
+ * resolving `globalThis.fetch` directly (so the proxy override still applies).
+ */
+export function resolveBrowserFetch(custom?: typeof fetch): typeof fetch {
+  if (custom) return custom;
+  if (!globalThis.fetch) {
+    throw new Error(
+      "global fetch is unavailable; pass `fetch` or run in a modern browser",
+    );
+  }
+  return (input: RequestInfo | URL, init?: RequestInit) =>
+    globalThis.fetch(input, init);
+}

package/src/api/http.ts

@@ -2,7 +2,7 @@
  * Browser HTTP transport for the Introspection Data Plane `/v1` surface.
  *
  * The request/response machinery — URL joining, query building, body
- * serialization, error mapping, SSE — lives in the shared
+ * serialization, error mapping, AG-UI stream parsing — lives in the shared
  * `@introspection-sdk/http` {@link BaseHttpClient}. This module pins the
  * browser auth strategy on top of it: the DP is reached with the HttpOnly
  * `intro_dp_session` cookie minted by `POST /v1/oauth/exchange`, so every
@@ -17,6 +17,8 @@ import {
   toApiError,
 } from "@introspection-sdk/http";
 
+import { resolveBrowserFetch } from "./fetch.js";
+
 // Re-exported for `client.ts`, which redeems the DP session on `connect()`.
 export { stripTrailingSlash, toApiError };
 
@@ -43,8 +45,9 @@ export class BrowserHttpClient extends BaseHttpClient {
   constructor(cfg: BrowserHttpConfig) {
     super({
       apiUrl: cfg.apiUrl,
+      // Resolve a browser-safe `fetch` (native `fetch` brand-checks `this`).
+      fetch: resolveBrowserFetch(cfg.fetch),
       additionalHeaders: cfg.additionalHeaders,
-      fetch: cfg.fetch,
       transport: {
         authHeaders: () => ({}),
         credentials: "include",

package/src/api/index.ts

@@ -31,7 +31,7 @@
  *   prompt: "Summarize my latest order",
  *   runtime_id: runtimeId,
  * });
- * for await (const ev of run.stream()) console.log(ev.event, ev.data);
+ * for await (const ev of run.stream()) console.log(ev.type);
  * ```
  */
 
@@ -55,26 +55,33 @@ export {
   type FileUploadBody,
 } from "@introspection-sdk/http";
 export { BrowserHttpClient, type BrowserHttpConfig } from "./http.js";
-export { parseSse } from "./sse.js";
 export {
   Paginator,
   cursorPaginate,
   type PageSource,
 } from "@introspection-sdk/http";
+export { EventType } from "@introspection-sdk/types";
 
 // Re-exported wire types for convenience.
 export type {
+  AGUIEvent,
+  BaseEvent,
+  Interrupt,
+  Message,
+  ResumeEntry,
+  RunAgentInput,
   Task,
   TaskRun,
   TaskStatus,
+  TaskRunKind,
   TaskCreateResponse,
   TaskListParams,
   TaskUpdateParams,
   TaskRunCreateParams,
+  TaskRunResumeParams,
   TaskCancelResponse,
   RunIdentityInput,
   Paginated,
-  SseEvent,
   File,
   FileType,
   FileListParams,

package/dist/api/sse.d.ts

@@ -1,7 +0,0 @@
-/**
- * SSE parsing now lives in the shared `@introspection-sdk/http` core so
- * the browser and Node SDKs stay byte-for-byte identical. Re-exported
- * here to keep the existing `./sse.js` import path stable.
- */
-export { parseSse } from "@introspection-sdk/http";
-//# sourceMappingURL=sse.d.ts.map

package/dist/api/sse.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/api/sse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/api/sse.js

@@ -1,7 +0,0 @@
-/**
- * SSE parsing now lives in the shared `@introspection-sdk/http` core so
- * the browser and Node SDKs stay byte-for-byte identical. Re-exported
- * here to keep the existing `./sse.js` import path stable.
- */
-export { parseSse } from "@introspection-sdk/http";
-//# sourceMappingURL=sse.js.map

package/dist/api/sse.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/api/sse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC"}

package/src/api/sse.ts

@@ -1,6 +0,0 @@
-/**
- * SSE parsing now lives in the shared `@introspection-sdk/http` core so
- * the browser and Node SDKs stay byte-for-byte identical. Re-exported
- * here to keep the existing `./sse.js` import path stable.
- */
-export { parseSse } from "@introspection-sdk/http";