@usestatemachines/sdk 0.8.1 → 0.9.1

package/esm/models/error.d.ts

@@ -15,6 +15,7 @@ export declare const ErrorCode: {
     readonly LastWorkspace: "last_workspace";
     readonly WorkspaceArchived: "workspace_archived";
     readonly VersionInUse: "version_in_use";
+    readonly UiDisabled: "ui_disabled";
     readonly BodyTooLarge: "body_too_large";
     readonly VersionUnavailable: "version_unavailable";
     readonly EnvironmentLimitReached: "environment_limit_reached";

package/esm/models/error.js

@@ -18,6 +18,7 @@ export const ErrorCode = {
     LastWorkspace: "last_workspace",
     WorkspaceArchived: "workspace_archived",
     VersionInUse: "version_in_use",
+    UiDisabled: "ui_disabled",
     BodyTooLarge: "body_too_large",
     VersionUnavailable: "version_unavailable",
     EnvironmentLimitReached: "environment_limit_reached",

package/esm/models/index.d.ts

@@ -3,6 +3,7 @@ export * from "./app-entry.js";
 export * from "./app.js";
 export * from "./audit-event.js";
 export * from "./body-preview.js";
+export * from "./browser-capability.js";
 export * from "./create-environment-app.js";
 export * from "./create-environment.js";
 export * from "./credential.js";
@@ -11,6 +12,7 @@ export * from "./environment-failure.js";
 export * from "./environment-status.js";
 export * from "./environment.js";
 export * from "./error.js";
+export * from "./launch-ui-session.js";
 export * from "./mcp-server.js";
 export * from "./mcp-tool.js";
 export * from "./me.js";
@@ -23,5 +25,8 @@ export * from "./security.js";
 export * from "./service.js";
 export * from "./snapshot-status.js";
 export * from "./snapshot.js";
+export * from "./ui-session-launch.js";
+export * from "./ui-session-mode.js";
+export * from "./ui-session-revocation.js";
 export * from "./version.js";
 export * from "./workspace.js";

package/esm/models/index.js

@@ -6,6 +6,7 @@ export * from "./app-entry.js";
 export * from "./app.js";
 export * from "./audit-event.js";
 export * from "./body-preview.js";
+export * from "./browser-capability.js";
 export * from "./create-environment-app.js";
 export * from "./create-environment.js";
 export * from "./credential.js";
@@ -14,6 +15,7 @@ export * from "./environment-failure.js";
 export * from "./environment-status.js";
 export * from "./environment.js";
 export * from "./error.js";
+export * from "./launch-ui-session.js";
 export * from "./mcp-server.js";
 export * from "./mcp-tool.js";
 export * from "./me.js";
@@ -26,5 +28,8 @@ export * from "./security.js";
 export * from "./service.js";
 export * from "./snapshot-status.js";
 export * from "./snapshot.js";
+export * from "./ui-session-launch.js";
+export * from "./ui-session-mode.js";
+export * from "./ui-session-revocation.js";
 export * from "./version.js";
 export * from "./workspace.js";

package/esm/models/launch-ui-session.d.ts

@@ -0,0 +1,26 @@
+import * as z from "zod/v4-mini";
+import { UiSessionMode } from "./ui-session-mode.js";
+export type LaunchUiSession = {
+    actorId: string;
+    /**
+     * The path the session opens first, with an optional query. It must match one of the service's document routes.
+     */
+    entryPath: string;
+    /**
+     * The exact origin of the page that posts the grant. The exchange refuses any other Origin, and an embedded session allows only this origin to frame it.
+     */
+    launcherOrigin: string;
+    mode: UiSessionMode;
+    serviceId: string;
+};
+/** @internal */
+export type LaunchUiSession$Outbound = {
+    actorId: string;
+    entryPath: string;
+    launcherOrigin: string;
+    mode: string;
+    serviceId: string;
+};
+/** @internal */
+export declare const LaunchUiSession$outboundSchema: z.ZodMiniType<LaunchUiSession$Outbound, LaunchUiSession>;
+export declare function launchUiSessionToJSON(launchUiSession: LaunchUiSession): string;

package/esm/models/launch-ui-session.js

@@ -0,0 +1,16 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+import { UiSessionMode$outboundSchema, } from "./ui-session-mode.js";
+/** @internal */
+export const LaunchUiSession$outboundSchema = z.object({
+    actorId: z.string(),
+    entryPath: z.string(),
+    launcherOrigin: z.string(),
+    mode: UiSessionMode$outboundSchema,
+    serviceId: z.string(),
+});
+export function launchUiSessionToJSON(launchUiSession) {
+    return JSON.stringify(LaunchUiSession$outboundSchema.parse(launchUiSession));
+}

package/esm/models/operations/index.d.ts

@@ -9,13 +9,16 @@ export * from "./get-request-stats.js";
 export * from "./get-request.js";
 export * from "./get-snapshot.js";
 export * from "./get-workspace.js";
+export * from "./launch-ui-session.js";
 export * from "./list-apps.js";
 export * from "./list-audit-events.js";
 export * from "./list-environment-creators.js";
 export * from "./list-environments.js";
 export * from "./list-requests.js";
+export * from "./list-snapshot-creators.js";
 export * from "./list-snapshots.js";
 export * from "./list-versions.js";
 export * from "./list-workspaces.js";
+export * from "./revoke-ui-session.js";
 export * from "./update-environment.js";
 export * from "./update-snapshot.js";

package/esm/models/operations/index.js

@@ -12,13 +12,16 @@ export * from "./get-request-stats.js";
 export * from "./get-request.js";
 export * from "./get-snapshot.js";
 export * from "./get-workspace.js";
+export * from "./launch-ui-session.js";
 export * from "./list-apps.js";
 export * from "./list-audit-events.js";
 export * from "./list-environment-creators.js";
 export * from "./list-environments.js";
 export * from "./list-requests.js";
+export * from "./list-snapshot-creators.js";
 export * from "./list-snapshots.js";
 export * from "./list-versions.js";
 export * from "./list-workspaces.js";
+export * from "./revoke-ui-session.js";
 export * from "./update-environment.js";
 export * from "./update-snapshot.js";

package/esm/models/operations/launch-ui-session.d.ts

@@ -0,0 +1,16 @@
+import * as z from "zod/v4-mini";
+import * as models from "../index.js";
+export type LaunchUiSessionRequest = {
+    environmentId: string;
+    appName: string;
+    body: models.LaunchUiSession;
+};
+/** @internal */
+export type LaunchUiSessionRequest$Outbound = {
+    environmentId: string;
+    appName: string;
+    body: models.LaunchUiSession$Outbound;
+};
+/** @internal */
+export declare const LaunchUiSessionRequest$outboundSchema: z.ZodMiniType<LaunchUiSessionRequest$Outbound, LaunchUiSessionRequest>;
+export declare function launchUiSessionRequestToJSON(launchUiSessionRequest: LaunchUiSessionRequest): string;

package/esm/models/operations/launch-ui-session.js

@@ -0,0 +1,14 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+import * as models from "../index.js";
+/** @internal */
+export const LaunchUiSessionRequest$outboundSchema = z.object({
+    environmentId: z.string(),
+    appName: z.string(),
+    body: models.LaunchUiSession$outboundSchema,
+});
+export function launchUiSessionRequestToJSON(launchUiSessionRequest) {
+    return JSON.stringify(LaunchUiSessionRequest$outboundSchema.parse(launchUiSessionRequest));
+}

package/esm/models/operations/list-snapshot-creators.d.ts

@@ -0,0 +1,23 @@
+import * as z from "zod/v4-mini";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+import * as models from "../index.js";
+export type ListSnapshotCreatorsRequest = {
+    workspaceId?: string | undefined;
+};
+/**
+ * Each principal that created a snapshot in the workspace, by name
+ */
+export type ListSnapshotCreatorsResponse = {
+    data: Array<models.Principal>;
+};
+/** @internal */
+export type ListSnapshotCreatorsRequest$Outbound = {
+    workspaceId?: string | undefined;
+};
+/** @internal */
+export declare const ListSnapshotCreatorsRequest$outboundSchema: z.ZodMiniType<ListSnapshotCreatorsRequest$Outbound, ListSnapshotCreatorsRequest>;
+export declare function listSnapshotCreatorsRequestToJSON(listSnapshotCreatorsRequest: ListSnapshotCreatorsRequest): string;
+/** @internal */
+export declare const ListSnapshotCreatorsResponse$inboundSchema: z.ZodMiniType<ListSnapshotCreatorsResponse, unknown>;
+export declare function listSnapshotCreatorsResponseFromJSON(jsonString: string): SafeParseResult<ListSnapshotCreatorsResponse, SDKValidationError>;

package/esm/models/operations/list-snapshot-creators.js

@@ -0,0 +1,20 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import * as models from "../index.js";
+/** @internal */
+export const ListSnapshotCreatorsRequest$outboundSchema = z.object({
+    workspaceId: z.optional(z.string()),
+});
+export function listSnapshotCreatorsRequestToJSON(listSnapshotCreatorsRequest) {
+    return JSON.stringify(ListSnapshotCreatorsRequest$outboundSchema.parse(listSnapshotCreatorsRequest));
+}
+/** @internal */
+export const ListSnapshotCreatorsResponse$inboundSchema = z.object({
+    data: z.array(models.Principal$inboundSchema),
+});
+export function listSnapshotCreatorsResponseFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => ListSnapshotCreatorsResponse$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ListSnapshotCreatorsResponse' from JSON`);
+}

package/esm/models/operations/list-snapshots.d.ts

@@ -8,6 +8,9 @@ export type ListSnapshotsRequest = {
     workspaceId?: string | undefined;
     environmentId?: string | undefined;
     status?: Array<models.SnapshotStatus> | undefined;
+    appId?: Array<string> | undefined;
+    createdBy?: Array<string> | undefined;
+    search?: string | undefined;
 };
 /**
  * The workspace's snapshots, newest first
@@ -23,6 +26,9 @@ export type ListSnapshotsRequest$Outbound = {
     workspaceId?: string | undefined;
     environmentId?: string | undefined;
     status?: Array<string> | undefined;
+    appId?: Array<string> | undefined;
+    createdBy?: Array<string> | undefined;
+    search?: string | undefined;
 };
 /** @internal */
 export declare const ListSnapshotsRequest$outboundSchema: z.ZodMiniType<ListSnapshotsRequest$Outbound, ListSnapshotsRequest>;

package/esm/models/operations/list-snapshots.js

@@ -12,6 +12,9 @@ export const ListSnapshotsRequest$outboundSchema = z.object({
     workspaceId: z.optional(z.string()),
     environmentId: z.optional(z.string()),
     status: z.optional(z.array(models.SnapshotStatus$outboundSchema)),
+    appId: z.optional(z.array(z.string())),
+    createdBy: z.optional(z.array(z.string())),
+    search: z.optional(z.string()),
 });
 export function listSnapshotsRequestToJSON(listSnapshotsRequest) {
     return JSON.stringify(ListSnapshotsRequest$outboundSchema.parse(listSnapshotsRequest));

package/esm/models/operations/revoke-ui-session.d.ts

@@ -0,0 +1,15 @@
+import * as z from "zod/v4-mini";
+export type RevokeUiSessionRequest = {
+    environmentId: string;
+    appName: string;
+    sessionId: string;
+};
+/** @internal */
+export type RevokeUiSessionRequest$Outbound = {
+    environmentId: string;
+    appName: string;
+    sessionId: string;
+};
+/** @internal */
+export declare const RevokeUiSessionRequest$outboundSchema: z.ZodMiniType<RevokeUiSessionRequest$Outbound, RevokeUiSessionRequest>;
+export declare function revokeUiSessionRequestToJSON(revokeUiSessionRequest: RevokeUiSessionRequest): string;

package/esm/models/operations/revoke-ui-session.js

@@ -0,0 +1,13 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+/** @internal */
+export const RevokeUiSessionRequest$outboundSchema = z.object({
+    environmentId: z.string(),
+    appName: z.string(),
+    sessionId: z.string(),
+});
+export function revokeUiSessionRequestToJSON(revokeUiSessionRequest) {
+    return JSON.stringify(RevokeUiSessionRequest$outboundSchema.parse(revokeUiSessionRequest));
+}

package/esm/models/service.d.ts

@@ -1,6 +1,7 @@
 import * as z from "zod/v4-mini";
 import { OpenEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
+import { BrowserCapability } from "./browser-capability.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 import { McpServer } from "./mcp-server.js";
 export declare const Visibility: {
@@ -9,6 +10,7 @@ export declare const Visibility: {
 };
 export type Visibility = OpenEnum<typeof Visibility>;
 export type Service = {
+    browser?: BrowserCapability | undefined;
     description: string;
     id: string;
     limitations: Array<string>;

package/esm/models/service.js

@@ -5,6 +5,7 @@ import * as z from "zod/v4-mini";
 import { safeParse } from "../lib/schemas.js";
 import * as openEnums from "../types/enums.js";
 import * as types from "../types/primitives.js";
+import { BrowserCapability$inboundSchema, } from "./browser-capability.js";
 import { McpServer$inboundSchema } from "./mcp-server.js";
 export const Visibility = {
     Public: "public",
@@ -14,6 +15,7 @@ export const Visibility = {
 export const Visibility$inboundSchema = openEnums.inboundSchema(Visibility);
 /** @internal */
 export const Service$inboundSchema = z.object({
+    browser: types.optional(BrowserCapability$inboundSchema),
     description: types.string(),
     id: types.string(),
     limitations: z.array(types.string()),

package/esm/models/ui-session-launch.d.ts

@@ -0,0 +1,21 @@
+import * as z from "zod/v4-mini";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import { UiSessionMode } from "./ui-session-mode.js";
+export type UiSessionLaunch = {
+    actorId: string;
+    appName: string;
+    entryPath: string;
+    environmentId: string;
+    exchangeUrl: string;
+    expiresAt: Date;
+    grant: string;
+    grantExpiresAt: Date;
+    mode: UiSessionMode;
+    origin: string;
+    serviceId: string;
+    sessionId: string;
+};
+/** @internal */
+export declare const UiSessionLaunch$inboundSchema: z.ZodMiniType<UiSessionLaunch, unknown>;
+export declare function uiSessionLaunchFromJSON(jsonString: string): SafeParseResult<UiSessionLaunch, SDKValidationError>;

package/esm/models/ui-session-launch.js

@@ -0,0 +1,25 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import * as types from "../types/primitives.js";
+import { UiSessionMode$inboundSchema, } from "./ui-session-mode.js";
+/** @internal */
+export const UiSessionLaunch$inboundSchema = z.object({
+    actorId: types.string(),
+    appName: types.string(),
+    entryPath: types.string(),
+    environmentId: types.string(),
+    exchangeUrl: types.string(),
+    expiresAt: types.date(),
+    grant: types.string(),
+    grantExpiresAt: types.date(),
+    mode: UiSessionMode$inboundSchema,
+    origin: types.string(),
+    serviceId: types.string(),
+    sessionId: types.string(),
+});
+export function uiSessionLaunchFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => UiSessionLaunch$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'UiSessionLaunch' from JSON`);
+}

package/esm/models/ui-session-mode.d.ts

@@ -0,0 +1,11 @@
+import * as z from "zod/v4-mini";
+import { OpenEnum } from "../types/enums.js";
+export declare const UiSessionMode: {
+    readonly Embedded: "embedded";
+    readonly Page: "page";
+};
+export type UiSessionMode = OpenEnum<typeof UiSessionMode>;
+/** @internal */
+export declare const UiSessionMode$inboundSchema: z.ZodMiniType<UiSessionMode, unknown>;
+/** @internal */
+export declare const UiSessionMode$outboundSchema: z.ZodMiniType<string, UiSessionMode>;

package/esm/models/ui-session-mode.js

@@ -0,0 +1,12 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as openEnums from "../types/enums.js";
+export const UiSessionMode = {
+    Embedded: "embedded",
+    Page: "page",
+};
+/** @internal */
+export const UiSessionMode$inboundSchema = openEnums.inboundSchema(UiSessionMode);
+/** @internal */
+export const UiSessionMode$outboundSchema = openEnums.outboundSchema(UiSessionMode);

package/esm/models/ui-session-revocation.d.ts

@@ -0,0 +1,12 @@
+import * as z from "zod/v4-mini";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+export type UiSessionRevocation = {
+    appName: string;
+    environmentId: string;
+    revokedAt: Date;
+    sessionId: string;
+};
+/** @internal */
+export declare const UiSessionRevocation$inboundSchema: z.ZodMiniType<UiSessionRevocation, unknown>;
+export declare function uiSessionRevocationFromJSON(jsonString: string): SafeParseResult<UiSessionRevocation, SDKValidationError>;

package/esm/models/ui-session-revocation.js

@@ -0,0 +1,16 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import * as types from "../types/primitives.js";
+/** @internal */
+export const UiSessionRevocation$inboundSchema = z.object({
+    appName: types.string(),
+    environmentId: types.string(),
+    revokedAt: types.date(),
+    sessionId: types.string(),
+});
+export function uiSessionRevocationFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => UiSessionRevocation$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'UiSessionRevocation' from JSON`);
+}

package/esm/sdk/sdk.d.ts

@@ -1,5 +1,6 @@
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
 import { Apps } from "./apps.js";
 import { AuditEvents } from "./audit-events.js";
 import { Environments } from "./environments.js";
@@ -19,5 +20,14 @@ export declare class StateMachines extends ClientSDK {
     get snapshots(): Snapshots;
     private _workspaces?;
     get workspaces(): Workspaces;
+    /**
+     * Launches a browser session of one actor in an app's UI. The answer holds a one-use grant and no reusable credential. Return it only to the browser of the user it is for, which posts the grant to `exchangeUrl` from `launcherOrigin`.
+     */
+    launchUiSession(request: operations.LaunchUiSessionRequest, options?: RequestOptions): Promise<models.UiSessionLaunch>;
+    /**
+     * Revokes a browser session that the caller's own credential launched. Revoking again answers the same result. Another credential's session is not found.
+     */
+    revokeUiSession(request: operations.RevokeUiSessionRequest, options?: RequestOptions): Promise<models.UiSessionRevocation>;
     me(options?: RequestOptions): Promise<models.Me>;
+    listSnapshotCreators(request?: operations.ListSnapshotCreatorsRequest | undefined, options?: RequestOptions): Promise<operations.ListSnapshotCreatorsResponse>;
 }

package/esm/sdk/sdk.js

@@ -1,7 +1,10 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
+import { launchUiSession } from "../funcs/launch-ui-session.js";
+import { listSnapshotCreators } from "../funcs/list-snapshot-creators.js";
 import { me } from "../funcs/me.js";
+import { revokeUiSession } from "../funcs/revoke-ui-session.js";
 import { ClientSDK } from "../lib/sdks.js";
 import { unwrapAsync } from "../types/fp.js";
 import { Apps } from "./apps.js";
@@ -35,7 +38,22 @@ export class StateMachines extends ClientSDK {
     get workspaces() {
         return (this._workspaces ?? (this._workspaces = new Workspaces(this._options)));
     }
+    /**
+     * Launches a browser session of one actor in an app's UI. The answer holds a one-use grant and no reusable credential. Return it only to the browser of the user it is for, which posts the grant to `exchangeUrl` from `launcherOrigin`.
+     */
+    async launchUiSession(request, options) {
+        return unwrapAsync(launchUiSession(this, request, options));
+    }
+    /**
+     * Revokes a browser session that the caller's own credential launched. Revoking again answers the same result. Another credential's session is not found.
+     */
+    async revokeUiSession(request, options) {
+        return unwrapAsync(revokeUiSession(this, request, options));
+    }
     async me(options) {
         return unwrapAsync(me(this, options));
     }
+    async listSnapshotCreators(request, options) {
+        return unwrapAsync(listSnapshotCreators(this, request, options));
+    }
 }