@mutagent/sdk 0.6.22 → 0.7.2

package/dist/commonjs/sdk/views.d.ts

@@ -0,0 +1,90 @@
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+export declare class Views extends ClientSDK {
+    /**
+     * Resolve the workspace the views read
+     *
+     * @remarks
+     * Returns the organization and workspace the caller resolves to. Every views route is read-only and scoped to this workspace.
+     */
+    getViewsContext(options?: RequestOptions): Promise<operations.GetViewsContextResponse>;
+    /**
+     * The app shell: rail projects, recent sessions, command roster
+     *
+     * @remarks
+     * The workspace's Helix Cloud sessions grouped by repository for the rail (a session with no repository groups under ''), the newest sessions for the command palette, and the command roster generated from the CLI catalog.
+     */
+    getShellView(options?: RequestOptions): Promise<models.ViewsShell>;
+    /**
+     * The Home landing: composer roster and run readiness
+     *
+     * @remarks
+     * The workspace's Helix Cloud models as provider+id pairs (`provider/id` is the id a start sends), provider labels, the default model, the thinking levels a start accepts, and whether the workspace can run a session now (the same answer as `GET /api/helix-cloud/readiness`).
+     */
+    getHomeView(options?: RequestOptions): Promise<models.ViewsHome>;
+    /**
+     * The session thread list
+     *
+     * @remarks
+     * The workspace's Helix Cloud sessions as the web's thread list reads them, newest activity first, archived excluded. Page with `nextCursor`.
+     */
+    listSessionsView(request?: operations.ListSessionsViewRequest | undefined, options?: RequestOptions): Promise<models.ViewsSessionList>;
+    /**
+     * One session thread page
+     *
+     * @remarks
+     * The session, the reports filed against it as artifacts, and the models and thinking levels its composer offers. Events come from `GET /api/helix-cloud/sessions/{reference}/stream`. A session outside the workspace answers 404, as a missing one does.
+     */
+    getSessionView(request: operations.GetSessionViewRequest, options?: RequestOptions): Promise<models.ViewsSessionDetail>;
+    /**
+     * The Factory subject registry
+     *
+     * @remarks
+     * The workspace's managed agents as Factory subjects (spec card, loop stage, activity, deploys, open findings, latest eval), the ones whose spec cannot be read with the reason, and the linked repositories as projects. `kind` and `project` narrow the subjects.
+     */
+    getFactoryView(request?: operations.GetFactoryViewRequest | undefined, options?: RequestOptions): Promise<models.ViewsFactoryRegistry>;
+    /**
+     * One Factory subject page
+     *
+     * @remarks
+     * The subject as the grid reads it, plus its Deployment tab: the newest revisions with their file inventories and the slot serving one of them. File contents come from `GET /api/helix-agent/agents/{slug}/revisions/{rev}/files/{path}`. A spec that cannot be read answers `specExcerpt: null`. A slug outside the workspace answers 404, as a missing one does.
+     */
+    getFactorySubjectView(request: operations.GetFactorySubjectViewRequest, options?: RequestOptions): Promise<models.ViewsFactorySubjectDetail>;
+    /**
+     * The Review board
+     *
+     * @remarks
+     * The workspace's findings, triage items and reports (evaluator, diagnostics, and discovery + HITL apart), plus its linked repositories as projects. `project` and `since` narrow every lane. Writes go to the reports, findings and triage routes.
+     */
+    getReviewView(request?: operations.GetReviewViewRequest | undefined, options?: RequestOptions): Promise<models.ViewsReviewBoard>;
+    /**
+     * The Monitor board
+     *
+     * @remarks
+     * The workspace's triggers and routines (with run health), its newest runs, linked repositories, a runs/failures headline, the Factory subjects a routine can scope to, and the display-only roster of system agents. Writes go to the gateway routes.
+     */
+    getMonitorView(options?: RequestOptions): Promise<models.ViewsMonitorBoard>;
+    /**
+     * One run and a page of its logs
+     *
+     * @remarks
+     * The run and its logs after `after` (poll with `logs.nextAfter` until `logs.done`). A run outside the workspace answers 404, as a missing one does.
+     */
+    getMonitorRunView(request: operations.GetMonitorRunViewRequest, options?: RequestOptions): Promise<models.ViewsMonitorRunDetail>;
+    /**
+     * The workspace's integrations
+     *
+     * @remarks
+     * GitHub and Slack with their connection state and account, as the Configuration page lists them. Connect and disconnect through the gateway integration routes.
+     */
+    listIntegrationsView(options?: RequestOptions): Promise<Array<models.ViewsIntegrationList>>;
+    /**
+     * The sandbox providers
+     *
+     * @remarks
+     * Where session boxes can run: each provider this server is configured with, whether a launch uses it by default, and the facts it declares (region, managed-agent staging, workspace restore). Read-only.
+     */
+    listSandboxProvidersView(options?: RequestOptions): Promise<Array<models.ViewsSandboxProviderList>>;
+}
+//# sourceMappingURL=views.d.ts.map

package/dist/commonjs/sdk/views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.d.ts","sourceRoot":"","sources":["../../../src/sdk/views.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,UAAU,MAAM,+BAA+B,CAAC;AAG5D,qBAAa,KAAM,SAAQ,SAAS;IAClC;;;;;OAKG;IACG,eAAe,CACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,uBAAuB,CAAC;IAO9C;;;;;OAKG;IACG,YAAY,CAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;IAO7B;;;;;OAKG;IACG,WAAW,CACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;IAO5B;;;;;OAKG;IACG,gBAAgB,CACpB,OAAO,CAAC,EAAE,UAAU,CAAC,uBAAuB,GAAG,SAAS,EACxD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAQnC;;;;;OAKG;IACG,cAAc,CAClB,OAAO,EAAE,UAAU,CAAC,qBAAqB,EACzC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAQrC;;;;;OAKG;IACG,cAAc,CAClB,OAAO,CAAC,EAAE,UAAU,CAAC,qBAAqB,GAAG,SAAS,EACtD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC;IAQvC;;;;;OAKG;IACG,qBAAqB,CACzB,OAAO,EAAE,UAAU,CAAC,4BAA4B,EAChD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,yBAAyB,CAAC;IAQ5C;;;;;OAKG;IACG,aAAa,CACjB,OAAO,CAAC,EAAE,UAAU,CAAC,oBAAoB,GAAG,SAAS,EACrD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAQnC;;;;;OAKG;IACG,cAAc,CAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC;IAOpC;;;;;OAKG;IACG,iBAAiB,CACrB,OAAO,EAAE,UAAU,CAAC,wBAAwB,EAC5C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC;IAQxC;;;;;OAKG;IACG,oBAAoB,CACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAO9C;;;;;OAKG;IACG,wBAAwB,CAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;CAMnD"}

package/dist/commonjs/sdk/views.js

@@ -0,0 +1,132 @@
+"use strict";
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Views = void 0;
+const views_get_factory_subject_view_js_1 = require("../funcs/views-get-factory-subject-view.js");
+const views_get_factory_view_js_1 = require("../funcs/views-get-factory-view.js");
+const views_get_home_view_js_1 = require("../funcs/views-get-home-view.js");
+const views_get_monitor_run_view_js_1 = require("../funcs/views-get-monitor-run-view.js");
+const views_get_monitor_view_js_1 = require("../funcs/views-get-monitor-view.js");
+const views_get_review_view_js_1 = require("../funcs/views-get-review-view.js");
+const views_get_session_view_js_1 = require("../funcs/views-get-session-view.js");
+const views_get_shell_view_js_1 = require("../funcs/views-get-shell-view.js");
+const views_get_views_context_js_1 = require("../funcs/views-get-views-context.js");
+const views_list_integrations_view_js_1 = require("../funcs/views-list-integrations-view.js");
+const views_list_sandbox_providers_view_js_1 = require("../funcs/views-list-sandbox-providers-view.js");
+const views_list_sessions_view_js_1 = require("../funcs/views-list-sessions-view.js");
+const sdks_js_1 = require("../lib/sdks.js");
+const fp_js_1 = require("../types/fp.js");
+class Views extends sdks_js_1.ClientSDK {
+    /**
+     * Resolve the workspace the views read
+     *
+     * @remarks
+     * Returns the organization and workspace the caller resolves to. Every views route is read-only and scoped to this workspace.
+     */
+    async getViewsContext(options) {
+        return (0, fp_js_1.unwrapAsync)((0, views_get_views_context_js_1.viewsGetViewsContext)(this, options));
+    }
+    /**
+     * The app shell: rail projects, recent sessions, command roster
+     *
+     * @remarks
+     * The workspace's Helix Cloud sessions grouped by repository for the rail (a session with no repository groups under ''), the newest sessions for the command palette, and the command roster generated from the CLI catalog.
+     */
+    async getShellView(options) {
+        return (0, fp_js_1.unwrapAsync)((0, views_get_shell_view_js_1.viewsGetShellView)(this, options));
+    }
+    /**
+     * The Home landing: composer roster and run readiness
+     *
+     * @remarks
+     * The workspace's Helix Cloud models as provider+id pairs (`provider/id` is the id a start sends), provider labels, the default model, the thinking levels a start accepts, and whether the workspace can run a session now (the same answer as `GET /api/helix-cloud/readiness`).
+     */
+    async getHomeView(options) {
+        return (0, fp_js_1.unwrapAsync)((0, views_get_home_view_js_1.viewsGetHomeView)(this, options));
+    }
+    /**
+     * The session thread list
+     *
+     * @remarks
+     * The workspace's Helix Cloud sessions as the web's thread list reads them, newest activity first, archived excluded. Page with `nextCursor`.
+     */
+    async listSessionsView(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, views_list_sessions_view_js_1.viewsListSessionsView)(this, request, options));
+    }
+    /**
+     * One session thread page
+     *
+     * @remarks
+     * The session, the reports filed against it as artifacts, and the models and thinking levels its composer offers. Events come from `GET /api/helix-cloud/sessions/{reference}/stream`. A session outside the workspace answers 404, as a missing one does.
+     */
+    async getSessionView(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, views_get_session_view_js_1.viewsGetSessionView)(this, request, options));
+    }
+    /**
+     * The Factory subject registry
+     *
+     * @remarks
+     * The workspace's managed agents as Factory subjects (spec card, loop stage, activity, deploys, open findings, latest eval), the ones whose spec cannot be read with the reason, and the linked repositories as projects. `kind` and `project` narrow the subjects.
+     */
+    async getFactoryView(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, views_get_factory_view_js_1.viewsGetFactoryView)(this, request, options));
+    }
+    /**
+     * One Factory subject page
+     *
+     * @remarks
+     * The subject as the grid reads it, plus its Deployment tab: the newest revisions with their file inventories and the slot serving one of them. File contents come from `GET /api/helix-agent/agents/{slug}/revisions/{rev}/files/{path}`. A spec that cannot be read answers `specExcerpt: null`. A slug outside the workspace answers 404, as a missing one does.
+     */
+    async getFactorySubjectView(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, views_get_factory_subject_view_js_1.viewsGetFactorySubjectView)(this, request, options));
+    }
+    /**
+     * The Review board
+     *
+     * @remarks
+     * The workspace's findings, triage items and reports (evaluator, diagnostics, and discovery + HITL apart), plus its linked repositories as projects. `project` and `since` narrow every lane. Writes go to the reports, findings and triage routes.
+     */
+    async getReviewView(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, views_get_review_view_js_1.viewsGetReviewView)(this, request, options));
+    }
+    /**
+     * The Monitor board
+     *
+     * @remarks
+     * The workspace's triggers and routines (with run health), its newest runs, linked repositories, a runs/failures headline, the Factory subjects a routine can scope to, and the display-only roster of system agents. Writes go to the gateway routes.
+     */
+    async getMonitorView(options) {
+        return (0, fp_js_1.unwrapAsync)((0, views_get_monitor_view_js_1.viewsGetMonitorView)(this, options));
+    }
+    /**
+     * One run and a page of its logs
+     *
+     * @remarks
+     * The run and its logs after `after` (poll with `logs.nextAfter` until `logs.done`). A run outside the workspace answers 404, as a missing one does.
+     */
+    async getMonitorRunView(request, options) {
+        return (0, fp_js_1.unwrapAsync)((0, views_get_monitor_run_view_js_1.viewsGetMonitorRunView)(this, request, options));
+    }
+    /**
+     * The workspace's integrations
+     *
+     * @remarks
+     * GitHub and Slack with their connection state and account, as the Configuration page lists them. Connect and disconnect through the gateway integration routes.
+     */
+    async listIntegrationsView(options) {
+        return (0, fp_js_1.unwrapAsync)((0, views_list_integrations_view_js_1.viewsListIntegrationsView)(this, options));
+    }
+    /**
+     * The sandbox providers
+     *
+     * @remarks
+     * Where session boxes can run: each provider this server is configured with, whether a launch uses it by default, and the facts it declares (region, managed-agent staging, workspace restore). Read-only.
+     */
+    async listSandboxProvidersView(options) {
+        return (0, fp_js_1.unwrapAsync)((0, views_list_sandbox_providers_view_js_1.viewsListSandboxProvidersView)(this, options));
+    }
+}
+exports.Views = Views;
+//# sourceMappingURL=views.js.map

package/dist/commonjs/sdk/views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.js","sourceRoot":"","sources":["../../../src/sdk/views.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,kGAAwF;AACxF,kFAAyE;AACzE,4EAAmE;AACnE,0FAAgF;AAChF,kFAAyE;AACzE,gFAAuE;AACvE,kFAAyE;AACzE,8EAAqE;AACrE,oFAA2E;AAC3E,8FAAqF;AACrF,wGAA8F;AAC9F,sFAA6E;AAC7E,4CAA2D;AAG3D,0CAA6C;AAE7C,MAAa,KAAM,SAAQ,mBAAS;IAClC;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CACnB,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,iDAAoB,EACrC,IAAI,EACJ,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAChB,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,2CAAiB,EAClC,IAAI,EACJ,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CACf,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,yCAAgB,EACjC,IAAI,EACJ,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB,CACpB,OAAwD,EACxD,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,mDAAqB,EACtC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAClB,OAAyC,EACzC,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,+CAAmB,EACpC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAClB,OAAsD,EACtD,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,+CAAmB,EACpC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,qBAAqB,CACzB,OAAgD,EAChD,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,8DAA0B,EAC3C,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CACjB,OAAqD,EACrD,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,6CAAkB,EACnC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAClB,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,+CAAmB,EACpC,IAAI,EACJ,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,iBAAiB,CACrB,OAA4C,EAC5C,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,sDAAsB,EACvC,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,oBAAoB,CACxB,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,2DAAyB,EAC1C,IAAI,EACJ,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,wBAAwB,CAC5B,OAAwB;QAExB,OAAO,IAAA,mBAAW,EAAC,IAAA,oEAA6B,EAC9C,IAAI,EACJ,OAAO,CACR,CAAC,CAAC;IACL,CAAC;CACF;AAhMD,sBAgMC"}

package/dist/commonjs/types/discriminated-union.d.ts

@@ -0,0 +1,25 @@
+import * as z from "zod/v4-mini";
+export type Unknown<Discriminator extends string, UnknownValue = "UNKNOWN"> = {
+    [K in Discriminator]: UnknownValue;
+} & {
+    raw: unknown;
+    isUnknown: true;
+};
+export declare function isUnknown<Discriminator extends string>(value: unknown): value is Unknown<Discriminator>;
+/**
+ * Forward-compatible discriminated union parser.
+ *
+ * If the input does not match one of the predefined options, it will be
+ * captured and available as `{ raw: <original input>, [discriminator]: "UNKNOWN", isUnknown: true }`.
+ *
+ * @param inputPropertyName - The discriminator property name in the input payload
+ * @param options - Map of discriminator values to their corresponding schemas
+ * @param opts - Optional configuration object
+ * @param opts.unknownValue - The value to use for the discriminator when the input is unknown (default: "UNKNOWN")
+ * @param opts.outputPropertyName - Output property name if the sanitized (camelCase) property name differs from inputPropertyName
+ */
+export declare function discriminatedUnion<InputDiscriminator extends string, TOptions extends Readonly<Record<string, z.ZodMiniType>>, UnknownValue extends string = "UNKNOWN", OutputDiscriminator extends string = InputDiscriminator>(inputPropertyName: InputDiscriminator, options: TOptions, opts?: {
+    unknownValue?: UnknownValue;
+    outputPropertyName?: OutputDiscriminator;
+}): z.ZodMiniType<z.output<TOptions[keyof TOptions]> | Unknown<OutputDiscriminator, UnknownValue>, unknown>;
+//# sourceMappingURL=discriminated-union.d.ts.map

package/dist/commonjs/types/discriminated-union.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discriminated-union.d.ts","sourceRoot":"","sources":["../../../src/types/discriminated-union.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAMjC,MAAM,MAAM,OAAO,CAAC,aAAa,SAAS,MAAM,EAAE,YAAY,GAAG,SAAS,IACtE;KACC,CAAC,IAAI,aAAa,GAAG,YAAY;CACnC,GACC;IACA,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAEJ,wBAAgB,SAAS,CAAC,aAAa,SAAS,MAAM,EACpD,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,CAEjC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,kBAAkB,SAAS,MAAM,EACjC,QAAQ,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,EACxD,YAAY,SAAS,MAAM,GAAG,SAAS,EACvC,mBAAmB,SAAS,MAAM,GAAG,kBAAkB,EAEvD,iBAAiB,EAAE,kBAAkB,EACrC,OAAO,EAAE,QAAQ,EACjB,IAAI,GAAE;IACJ,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;CACrC,GACL,CAAC,CAAC,WAAW,CACZ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,QAAQ,CAAC,CAAC,GAClC,OAAO,CAAC,mBAAmB,EAAE,YAAY,CAAC,EAC5C,OAAO,CACR,CA+CA"}

package/dist/commonjs/types/discriminated-union.js

@@ -0,0 +1,98 @@
+"use strict";
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isUnknown = isUnknown;
+exports.discriminatedUnion = discriminatedUnion;
+const z = __importStar(require("zod/v4-mini"));
+const default_to_zero_value_js_1 = require("./default-to-zero-value.js");
+const unrecognized_js_1 = require("./unrecognized.js");
+const UNKNOWN = Symbol("UNKNOWN");
+function isUnknown(value) {
+    return typeof value === "object" && value !== null && UNKNOWN in value;
+}
+/**
+ * Forward-compatible discriminated union parser.
+ *
+ * If the input does not match one of the predefined options, it will be
+ * captured and available as `{ raw: <original input>, [discriminator]: "UNKNOWN", isUnknown: true }`.
+ *
+ * @param inputPropertyName - The discriminator property name in the input payload
+ * @param options - Map of discriminator values to their corresponding schemas
+ * @param opts - Optional configuration object
+ * @param opts.unknownValue - The value to use for the discriminator when the input is unknown (default: "UNKNOWN")
+ * @param opts.outputPropertyName - Output property name if the sanitized (camelCase) property name differs from inputPropertyName
+ */
+function discriminatedUnion(inputPropertyName, options, opts = {}) {
+    const { unknownValue = "UNKNOWN", outputPropertyName } = opts;
+    return z.pipe(z.unknown(), z.transform((input) => {
+        const fallback = Object.defineProperties({
+            raw: input,
+            [outputPropertyName ?? inputPropertyName]: unknownValue,
+            isUnknown: true,
+        }, { [UNKNOWN]: { value: true, enumerable: false, configurable: false } });
+        const isObject = typeof input === "object" && input !== null;
+        if (!isObject)
+            return fallback;
+        const discriminator = input[inputPropertyName];
+        if (typeof discriminator !== "string")
+            return fallback;
+        if (!(discriminator in options))
+            return fallback;
+        const schema = options[discriminator];
+        if (!schema)
+            return fallback;
+        // Start counters before parsing to track nested unrecognized/zeroDefault values
+        const unrecognizedCtr = (0, unrecognized_js_1.startCountingUnrecognized)();
+        const zeroDefaultCtr = (0, default_to_zero_value_js_1.startCountingDefaultToZeroValue)();
+        const result = z.safeParse(schema, input);
+        if (!result.success) {
+            // Parse failed - don't propagate any counts from the failed attempt
+            unrecognizedCtr.end(0);
+            zeroDefaultCtr.end(0);
+            return fallback;
+        }
+        // Parse succeeded - propagate the actual counts
+        unrecognizedCtr.end();
+        zeroDefaultCtr.end();
+        if (outputPropertyName) {
+            result.data[outputPropertyName] = discriminator;
+        }
+        return result.data;
+    }));
+}
+//# sourceMappingURL=discriminated-union.js.map

package/dist/commonjs/types/discriminated-union.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discriminated-union.js","sourceRoot":"","sources":["../../../src/types/discriminated-union.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiBH,8BAIC;AAcD,gDA+DC;AAhGD,+CAAiC;AACjC,yEAA6E;AAC7E,uDAA8D;AAE9D,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AAWlC,SAAgB,SAAS,CACvB,KAAc;IAEd,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,CAAC;AACzE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,kBAAkB,CAMhC,iBAAqC,EACrC,OAAiB,EACjB,OAGI,EAAE;IAMN,MAAM,EAAE,YAAY,GAAG,SAAyB,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAC9E,OAAO,CAAC,CAAC,IAAI,CACX,CAAC,CAAC,OAAO,EAAE,EACX,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CACtC;YACE,GAAG,EAAE,KAAK;YACV,CAAC,kBAAkB,IAAI,iBAAiB,CAAC,EAAE,YAAY;YACvD,SAAS,EAAE,IAAa;SACzB,EACD,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,CACvE,CAAC;QAEF,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;QAC7D,IAAI,CAAC,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE/B,MAAM,aAAa,GAAG,KAAK,CAAC,iBAAuC,CAAC,CAAC;QACrE,IAAI,OAAO,aAAa,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAC;QACvD,IAAI,CAAC,CAAC,aAAa,IAAI,OAAO,CAAC;YAAE,OAAO,QAAQ,CAAC;QAEjD,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM;YAAE,OAAO,QAAQ,CAAC;QAE7B,gFAAgF;QAChF,MAAM,eAAe,GAAG,IAAA,2CAAyB,GAAE,CAAC;QACpD,MAAM,cAAc,GAAG,IAAA,0DAA+B,GAAE,CAAC;QAEzD,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,oEAAoE;YACpE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACvB,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACtB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,gDAAgD;QAChD,eAAe,CAAC,GAAG,EAAE,CAAC;QACtB,cAAc,CAAC,GAAG,EAAE,CAAC;QAErB,IAAI,kBAAkB,EAAE,CAAC;YACtB,MAAM,CAAC,IAAY,CAAC,kBAAkB,CAAC,GAAG,aAAa,CAAC;QAC3D,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC,CAAC,CACI,CAAC;AACX,CAAC"}

package/dist/commonjs/types/smart-union.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"smart-union.d.ts","sourceRoot":"","sources":["../../../src/types/smart-union.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAejC;;;GAGG;AACH,wBAAgB,UAAU,CACxB,OAAO,SAAS,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,EAE3E,OAAO,EAAE,OAAO,GACf,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CA2DpE"}
+{"version":3,"file":"smart-union.d.ts","sourceRoot":"","sources":["../../../src/types/smart-union.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAgBjC;;;GAGG;AACH,wBAAgB,UAAU,CACxB,OAAO,SAAS,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,EAE3E,OAAO,EAAE,OAAO,GACf,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CA2DpE"}

package/dist/commonjs/types/smart-union.js

@@ -40,6 +40,7 @@ exports.smartUnion = smartUnion;
 // Not needed if lax mode
 const z = __importStar(require("zod/v4-mini"));
 const default_to_zero_value_js_1 = require("./default-to-zero-value.js");
+const discriminated_union_js_1 = require("./discriminated-union.js");
 const rfcdate_js_1 = require("./rfcdate.js");
 const unrecognized_js_1 = require("./unrecognized.js");
 /**
@@ -123,7 +124,7 @@ function countFieldsRecursive(parsed) {
     let index = 0;
     while (index < queue.length) {
         const value = queue[index++];
-        if (value === undefined) {
+        if (value === undefined || (0, discriminated_union_js_1.isUnknown)(value)) {
             continue;
         }
         // Check if it's a primitive value

package/dist/commonjs/types/smart-union.js.map

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

package/dist/esm/custom/gateway-stream.d.ts

@@ -0,0 +1,146 @@
+/**
+ * HAND-WRITTEN — not generated. Speakeasy never touches `src/custom/`.
+ *
+ * A live, typed reader for `GET /api/gateway/stream` (server-sent events).
+ *
+ * Why it exists: Speakeasy only emits a typed event iterator for SSE on its
+ * Business tier ("serverEvents"); on ours the generated method reads the whole
+ * body as one string, which for a stream that never ends is no stream at all.
+ * This reader opens the stream itself and yields each frame as it arrives.
+ *
+ * Frames (the server's `streamFrameSchema`, gateway/workspace-config/model.ts):
+ *
+ *   id: <cursor>  event: ready   data: {}                          at connect
+ *   id: <cursor>  event: run     data: RunSummary                  a run changed
+ *   id: <cursor>  event: event   data: GatewayEventSummary         an event settled
+ *   id: <cursor>  event: log     data: { runId, entry }            with runId
+ *                 event: ping    data: {}                          keepalive, no id
+ *                 event: error   data: { code, reason }            then the stream ends
+ *
+ * Reconnect: whenever the stream ends or the connection fails, the reader
+ * reconnects with `since` = the id of the last frame it saw, so nothing is
+ * repeated and nothing inside the server's resume bound is lost. A 4xx (other
+ * than 429) is not retried: it throws `GatewayStreamError` with the server's
+ * code. Abort with `signal`.
+ *
+ * Import: `import { streamGatewayUpdates } from '@mutagent/sdk/custom/gateway-stream.js'`.
+ */
+export interface GatewayRunSummary {
+    id: string;
+    eventId: string;
+    state: string;
+    origin: {
+        kind: string;
+        id: string | null;
+    };
+    repository: {
+        repositoryId: string;
+        name: string;
+    } | null;
+    createdAt: string;
+    finishedAt: string | null;
+    error: {
+        code: string;
+        [k: string]: unknown;
+    } | null;
+}
+export interface GatewayEventSummary {
+    id: string;
+    kind: string;
+    source: string;
+    repositoryId: string | null;
+    channelId: string | null;
+    outcome: string;
+    occurredAt: string;
+    receivedAt: string;
+    /** Present (true) only on a Slack mention that files a triage item instead of a run. */
+    filesTriage?: boolean;
+}
+export interface GatewayRunLogEntry {
+    seq: number;
+    at: string;
+    type: string;
+    text: string;
+}
+export type GatewayStreamFrame = {
+    id: string;
+    event: "ready";
+    data: Record<string, never>;
+} | {
+    id: string;
+    event: "run";
+    data: GatewayRunSummary;
+} | {
+    id: string;
+    event: "event";
+    data: GatewayEventSummary;
+} | {
+    id: string;
+    event: "log";
+    data: {
+        runId: string;
+        entry: GatewayRunLogEntry;
+    };
+} | {
+    event: "ping";
+    data: Record<string, never>;
+} | {
+    event: "error";
+    data: {
+        code: string;
+        reason: string;
+    };
+};
+/** A refusal the reader will not retry, or the end of its retries. */
+export declare class GatewayStreamError extends Error {
+    readonly status: number | null;
+    readonly code: string;
+    readonly name = "GatewayStreamError";
+    constructor(status: number | null, code: string, reason: string);
+}
+export interface RawSseFrame {
+    id?: string;
+    event?: string;
+    data: string;
+}
+/**
+ * Parse an SSE body into raw frames, one at a time, as bytes arrive.
+ * Handles LF and CRLF, multi-line `data`, and `:` comments. Cancelling
+ * `signal` cancels the body.
+ */
+export declare function parseSse(body: ReadableStream<Uint8Array>, signal?: AbortSignal): AsyncGenerator<RawSseFrame>;
+type FetchLike = (url: string, init?: RequestInit) => Promise<Response>;
+export interface GatewayStreamOptions {
+    /** API base, e.g. https://api.mutagent.io. */
+    serverURL: string;
+    workspaceId: string;
+    /** Platform API key (sent as `x-api-key`). Defaults to MUTAGENT_API_KEY. */
+    apiKey?: string;
+    /** A session bearer token, instead of an API key. */
+    bearerToken?: string;
+    /** Also stream this run's logs (public run id). */
+    runId?: string;
+    /** Resume after this frame id; omit to start now. */
+    since?: string;
+    signal?: AbortSignal;
+    reconnect?: {
+        /** Failed connections in a row before giving up. Default 10. */
+        maxAttempts?: number;
+        /** First retry delay; doubles per failure. Default 1000 ms. */
+        delayMs?: number;
+        /** Cap on the retry delay. Default 30000 ms. */
+        maxDelayMs?: number;
+    };
+    /** Injected for tests. */
+    fetch?: FetchLike;
+    /** Injected for tests. */
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * Stream the workspace's run, event and (with `runId`) log updates, live, with
+ * automatic resume. Ends when `signal` aborts; throws `GatewayStreamError` on
+ * a refusal or when reconnecting keeps failing.
+ */
+export declare function streamGatewayUpdates(options: GatewayStreamOptions): AsyncGenerator<GatewayStreamFrame>;
+export {};
+//# sourceMappingURL=gateway-stream.d.ts.map

package/dist/esm/custom/gateway-stream.d.ts.map

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