@usestatemachines/sdk 0.3.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/README.md +122 -19
  2. package/agents/SKILL.md +10 -7
  3. package/agents/index.js +6 -6
  4. package/agents/llms.txt +19 -11
  5. package/agents/prompt.md +1 -1
  6. package/esm/extensions/client.d.ts +24 -2
  7. package/esm/extensions/client.js +26 -3
  8. package/esm/extensions/index.d.ts +2 -2
  9. package/esm/extensions/running-environment.d.ts +18 -4
  10. package/esm/extensions/running-environment.js +24 -2
  11. package/esm/extensions/wait.d.ts +3 -1
  12. package/esm/extensions/wait.js +17 -2
  13. package/esm/funcs/environments-get-request-payload.d.ts +11 -0
  14. package/esm/funcs/environments-get-request-payload.js +100 -0
  15. package/esm/funcs/environments-get-request-stats.d.ts +11 -0
  16. package/esm/funcs/environments-get-request-stats.js +103 -0
  17. package/esm/funcs/environments-get-request.d.ts +11 -0
  18. package/esm/funcs/environments-get-request.js +96 -0
  19. package/esm/funcs/environments-list-requests.d.ts +11 -0
  20. package/esm/funcs/environments-list-requests.js +105 -0
  21. package/esm/funcs/environments-resume.d.ts +11 -0
  22. package/esm/funcs/environments-resume.js +93 -0
  23. package/esm/funcs/environments-stop.js +1 -0
  24. package/esm/funcs/environments-suspend.d.ts +11 -0
  25. package/esm/funcs/environments-suspend.js +93 -0
  26. package/esm/lib/config.d.ts +2 -2
  27. package/esm/lib/config.js +2 -2
  28. package/esm/models/environment-app.d.ts +2 -0
  29. package/esm/models/environment-app.js +2 -0
  30. package/esm/models/environment-request-detail.d.ts +40 -0
  31. package/esm/models/environment-request-detail.js +39 -0
  32. package/esm/models/environment-request-stats.d.ts +26 -0
  33. package/esm/models/environment-request-stats.js +31 -0
  34. package/esm/models/environment-request.d.ts +31 -0
  35. package/esm/models/environment-request.js +34 -0
  36. package/esm/models/environment-snapshot.d.ts +3 -2
  37. package/esm/models/environment-snapshot.js +3 -2
  38. package/esm/models/environment.d.ts +4 -0
  39. package/esm/models/environment.js +4 -0
  40. package/esm/models/error-response.d.ts +7 -0
  41. package/esm/models/error-response.js +7 -0
  42. package/esm/models/index.d.ts +4 -0
  43. package/esm/models/index.js +4 -0
  44. package/esm/models/operations/create-environment-definition.d.ts +10 -0
  45. package/esm/models/operations/create-environment-definition.js +3 -0
  46. package/esm/models/operations/get-environment-request-payload.d.ts +23 -0
  47. package/esm/models/operations/get-environment-request-payload.js +19 -0
  48. package/esm/models/operations/get-environment-request-stats.d.ts +70 -0
  49. package/esm/models/operations/get-environment-request-stats.js +55 -0
  50. package/esm/models/operations/get-environment-request.d.ts +25 -0
  51. package/esm/models/operations/get-environment-request.js +21 -0
  52. package/esm/models/operations/index.d.ts +6 -0
  53. package/esm/models/operations/index.js +6 -0
  54. package/esm/models/operations/list-environment-requests.d.ts +75 -0
  55. package/esm/models/operations/list-environment-requests.js +59 -0
  56. package/esm/models/operations/resume-environment.d.ts +25 -0
  57. package/esm/models/operations/resume-environment.js +26 -0
  58. package/esm/models/operations/stop-environment.d.ts +3 -1
  59. package/esm/models/operations/stop-environment.js +8 -2
  60. package/esm/models/operations/suspend-environment.d.ts +25 -0
  61. package/esm/models/operations/suspend-environment.js +26 -0
  62. package/esm/models/release.d.ts +11 -0
  63. package/esm/models/release.js +10 -0
  64. package/esm/models/request-payload-preview.d.ts +31 -0
  65. package/esm/models/request-payload-preview.js +33 -0
  66. package/esm/sdk/environments.d.ts +6 -0
  67. package/esm/sdk/environments.js +24 -0
  68. package/openapi.json +1380 -29
  69. package/package.json +4 -3
@@ -0,0 +1,25 @@
1
+ import * as z from "zod/v4-mini";
2
+ import { Result as SafeParseResult } from "../../types/fp.js";
3
+ import { SDKValidationError } from "../errors/sdk-validation-error.js";
4
+ import * as models from "../index.js";
5
+ export type ResumeEnvironmentRequest = {
6
+ environmentId: string;
7
+ idempotencyKey?: string | undefined;
8
+ };
9
+ /**
10
+ * Environment queued to run again on the data it was suspended with
11
+ */
12
+ export type ResumeEnvironmentResponse = {
13
+ data: models.Environment;
14
+ };
15
+ /** @internal */
16
+ export type ResumeEnvironmentRequest$Outbound = {
17
+ environmentId: string;
18
+ "idempotency-key"?: string | undefined;
19
+ };
20
+ /** @internal */
21
+ export declare const ResumeEnvironmentRequest$outboundSchema: z.ZodMiniType<ResumeEnvironmentRequest$Outbound, ResumeEnvironmentRequest>;
22
+ export declare function resumeEnvironmentRequestToJSON(resumeEnvironmentRequest: ResumeEnvironmentRequest): string;
23
+ /** @internal */
24
+ export declare const ResumeEnvironmentResponse$inboundSchema: z.ZodMiniType<ResumeEnvironmentResponse, unknown>;
25
+ export declare function resumeEnvironmentResponseFromJSON(jsonString: string): SafeParseResult<ResumeEnvironmentResponse, SDKValidationError>;
@@ -0,0 +1,26 @@
1
+ /*
2
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
3
+ */
4
+ import * as z from "zod/v4-mini";
5
+ import { remap as remap$ } from "../../lib/primitives.js";
6
+ import { safeParse } from "../../lib/schemas.js";
7
+ import * as models from "../index.js";
8
+ /** @internal */
9
+ export const ResumeEnvironmentRequest$outboundSchema = z.pipe(z.object({
10
+ environmentId: z.string(),
11
+ idempotencyKey: z.optional(z.string()),
12
+ }), z.transform((v) => {
13
+ return remap$(v, {
14
+ idempotencyKey: "idempotency-key",
15
+ });
16
+ }));
17
+ export function resumeEnvironmentRequestToJSON(resumeEnvironmentRequest) {
18
+ return JSON.stringify(ResumeEnvironmentRequest$outboundSchema.parse(resumeEnvironmentRequest));
19
+ }
20
+ /** @internal */
21
+ export const ResumeEnvironmentResponse$inboundSchema = z.object({
22
+ data: models.Environment$inboundSchema,
23
+ });
24
+ export function resumeEnvironmentResponseFromJSON(jsonString) {
25
+ return safeParse(jsonString, (x) => ResumeEnvironmentResponse$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ResumeEnvironmentResponse' from JSON`);
26
+ }
@@ -4,9 +4,10 @@ import { SDKValidationError } from "../errors/sdk-validation-error.js";
4
4
  import * as models from "../index.js";
5
5
  export type StopEnvironmentRequest = {
6
6
  environmentId: string;
7
+ idempotencyKey?: string | undefined;
7
8
  };
8
9
  /**
9
- * Environment stopped or stopping
10
+ * Environment stopping or stopped; its data is discarded
10
11
  */
11
12
  export type StopEnvironmentResponse = {
12
13
  data: models.Environment;
@@ -14,6 +15,7 @@ export type StopEnvironmentResponse = {
14
15
  /** @internal */
15
16
  export type StopEnvironmentRequest$Outbound = {
16
17
  environmentId: string;
18
+ "idempotency-key"?: string | undefined;
17
19
  };
18
20
  /** @internal */
19
21
  export declare const StopEnvironmentRequest$outboundSchema: z.ZodMiniType<StopEnvironmentRequest$Outbound, StopEnvironmentRequest>;
@@ -2,12 +2,18 @@
2
2
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
3
3
  */
4
4
  import * as z from "zod/v4-mini";
5
+ import { remap as remap$ } from "../../lib/primitives.js";
5
6
  import { safeParse } from "../../lib/schemas.js";
6
7
  import * as models from "../index.js";
7
8
  /** @internal */
8
- export const StopEnvironmentRequest$outboundSchema = z.object({
9
+ export const StopEnvironmentRequest$outboundSchema = z.pipe(z.object({
9
10
  environmentId: z.string(),
10
- });
11
+ idempotencyKey: z.optional(z.string()),
12
+ }), z.transform((v) => {
13
+ return remap$(v, {
14
+ idempotencyKey: "idempotency-key",
15
+ });
16
+ }));
11
17
  export function stopEnvironmentRequestToJSON(stopEnvironmentRequest) {
12
18
  return JSON.stringify(StopEnvironmentRequest$outboundSchema.parse(stopEnvironmentRequest));
13
19
  }
@@ -0,0 +1,25 @@
1
+ import * as z from "zod/v4-mini";
2
+ import { Result as SafeParseResult } from "../../types/fp.js";
3
+ import { SDKValidationError } from "../errors/sdk-validation-error.js";
4
+ import * as models from "../index.js";
5
+ export type SuspendEnvironmentRequest = {
6
+ environmentId: string;
7
+ idempotencyKey?: string | undefined;
8
+ };
9
+ /**
10
+ * Environment suspending or suspended: its sandboxes go, its data stays for a resume
11
+ */
12
+ export type SuspendEnvironmentResponse = {
13
+ data: models.Environment;
14
+ };
15
+ /** @internal */
16
+ export type SuspendEnvironmentRequest$Outbound = {
17
+ environmentId: string;
18
+ "idempotency-key"?: string | undefined;
19
+ };
20
+ /** @internal */
21
+ export declare const SuspendEnvironmentRequest$outboundSchema: z.ZodMiniType<SuspendEnvironmentRequest$Outbound, SuspendEnvironmentRequest>;
22
+ export declare function suspendEnvironmentRequestToJSON(suspendEnvironmentRequest: SuspendEnvironmentRequest): string;
23
+ /** @internal */
24
+ export declare const SuspendEnvironmentResponse$inboundSchema: z.ZodMiniType<SuspendEnvironmentResponse, unknown>;
25
+ export declare function suspendEnvironmentResponseFromJSON(jsonString: string): SafeParseResult<SuspendEnvironmentResponse, SDKValidationError>;
@@ -0,0 +1,26 @@
1
+ /*
2
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
3
+ */
4
+ import * as z from "zod/v4-mini";
5
+ import { remap as remap$ } from "../../lib/primitives.js";
6
+ import { safeParse } from "../../lib/schemas.js";
7
+ import * as models from "../index.js";
8
+ /** @internal */
9
+ export const SuspendEnvironmentRequest$outboundSchema = z.pipe(z.object({
10
+ environmentId: z.string(),
11
+ idempotencyKey: z.optional(z.string()),
12
+ }), z.transform((v) => {
13
+ return remap$(v, {
14
+ idempotencyKey: "idempotency-key",
15
+ });
16
+ }));
17
+ export function suspendEnvironmentRequestToJSON(suspendEnvironmentRequest) {
18
+ return JSON.stringify(SuspendEnvironmentRequest$outboundSchema.parse(suspendEnvironmentRequest));
19
+ }
20
+ /** @internal */
21
+ export const SuspendEnvironmentResponse$inboundSchema = z.object({
22
+ data: models.Environment$inboundSchema,
23
+ });
24
+ export function suspendEnvironmentResponseFromJSON(jsonString) {
25
+ return safeParse(jsonString, (x) => SuspendEnvironmentResponse$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'SuspendEnvironmentResponse' from JSON`);
26
+ }
@@ -9,6 +9,14 @@ export declare const Qualification: {
9
9
  readonly Qualified: "qualified";
10
10
  };
11
11
  export type Qualification = OpenEnum<typeof Qualification>;
12
+ export declare const ReleaseStatus: {
13
+ readonly Candidate: "candidate";
14
+ readonly Default: "default";
15
+ readonly Available: "available";
16
+ readonly Retired: "retired";
17
+ readonly Gone: "gone";
18
+ };
19
+ export type ReleaseStatus = OpenEnum<typeof ReleaseStatus>;
12
20
  export type Release = {
13
21
  actors: Array<ReleaseActor>;
14
22
  apis: Array<ApiProfile>;
@@ -17,10 +25,13 @@ export type Release = {
17
25
  id: string;
18
26
  qualification: Qualification;
19
27
  retiredAt: Date | null;
28
+ status: ReleaseStatus;
20
29
  version: string;
21
30
  };
22
31
  /** @internal */
23
32
  export declare const Qualification$inboundSchema: z.ZodMiniType<Qualification, unknown>;
24
33
  /** @internal */
34
+ export declare const ReleaseStatus$inboundSchema: z.ZodMiniType<ReleaseStatus, unknown>;
35
+ /** @internal */
25
36
  export declare const Release$inboundSchema: z.ZodMiniType<Release, unknown>;
26
37
  export declare function releaseFromJSON(jsonString: string): SafeParseResult<Release, SDKValidationError>;
@@ -11,9 +11,18 @@ export const Qualification = {
11
11
  Development: "development",
12
12
  Qualified: "qualified",
13
13
  };
14
+ export const ReleaseStatus = {
15
+ Candidate: "candidate",
16
+ Default: "default",
17
+ Available: "available",
18
+ Retired: "retired",
19
+ Gone: "gone",
20
+ };
14
21
  /** @internal */
15
22
  export const Qualification$inboundSchema = openEnums.inboundSchema(Qualification);
16
23
  /** @internal */
24
+ export const ReleaseStatus$inboundSchema = openEnums.inboundSchema(ReleaseStatus);
25
+ /** @internal */
17
26
  export const Release$inboundSchema = z.object({
18
27
  actors: z.array(ReleaseActor$inboundSchema),
19
28
  apis: z.array(ApiProfile$inboundSchema),
@@ -22,6 +31,7 @@ export const Release$inboundSchema = z.object({
22
31
  id: types.string(),
23
32
  qualification: Qualification$inboundSchema,
24
33
  retiredAt: types.nullable(types.date()),
34
+ status: ReleaseStatus$inboundSchema,
25
35
  version: types.string(),
26
36
  });
27
37
  export function releaseFromJSON(jsonString) {
@@ -0,0 +1,31 @@
1
+ import * as z from "zod/v4-mini";
2
+ import { OpenEnum } from "../types/enums.js";
3
+ import { Result as SafeParseResult } from "../types/fp.js";
4
+ import { SDKValidationError } from "./errors/sdk-validation-error.js";
5
+ export declare const Coverage: {
6
+ readonly Captured: "captured";
7
+ readonly Redacted: "redacted";
8
+ readonly Omitted: "omitted";
9
+ };
10
+ export type Coverage = OpenEnum<typeof Coverage>;
11
+ export declare const Encoding: {
12
+ readonly Utf8: "utf8";
13
+ readonly Binary: "binary";
14
+ };
15
+ export type Encoding = OpenEnum<typeof Encoding>;
16
+ export type RequestPayloadPreview = {
17
+ bytes: number | null;
18
+ contentType: string | null;
19
+ coverage: Coverage;
20
+ encoding: Encoding;
21
+ preview: string | null;
22
+ previewTruncated: boolean;
23
+ reason: string | null;
24
+ };
25
+ /** @internal */
26
+ export declare const Coverage$inboundSchema: z.ZodMiniType<Coverage, unknown>;
27
+ /** @internal */
28
+ export declare const Encoding$inboundSchema: z.ZodMiniType<Encoding, unknown>;
29
+ /** @internal */
30
+ export declare const RequestPayloadPreview$inboundSchema: z.ZodMiniType<RequestPayloadPreview, unknown>;
31
+ export declare function requestPayloadPreviewFromJSON(jsonString: string): SafeParseResult<RequestPayloadPreview, SDKValidationError>;
@@ -0,0 +1,33 @@
1
+ /*
2
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
3
+ */
4
+ import * as z from "zod/v4-mini";
5
+ import { safeParse } from "../lib/schemas.js";
6
+ import * as openEnums from "../types/enums.js";
7
+ import * as types from "../types/primitives.js";
8
+ export const Coverage = {
9
+ Captured: "captured",
10
+ Redacted: "redacted",
11
+ Omitted: "omitted",
12
+ };
13
+ export const Encoding = {
14
+ Utf8: "utf8",
15
+ Binary: "binary",
16
+ };
17
+ /** @internal */
18
+ export const Coverage$inboundSchema = openEnums.inboundSchema(Coverage);
19
+ /** @internal */
20
+ export const Encoding$inboundSchema = openEnums.inboundSchema(Encoding);
21
+ /** @internal */
22
+ export const RequestPayloadPreview$inboundSchema = z.object({
23
+ bytes: types.nullable(types.number()),
24
+ contentType: types.nullable(types.string()),
25
+ coverage: Coverage$inboundSchema,
26
+ encoding: Encoding$inboundSchema,
27
+ preview: types.nullable(types.string()),
28
+ previewTruncated: types.boolean(),
29
+ reason: types.nullable(types.string()),
30
+ });
31
+ export function requestPayloadPreviewFromJSON(jsonString) {
32
+ return safeParse(jsonString, (x) => RequestPayloadPreview$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'RequestPayloadPreview' from JSON`);
33
+ }
@@ -6,7 +6,13 @@ export declare class Environments extends ClientSDK {
6
6
  getConnection(request: operations.GetConnectionRequest, options?: RequestOptions): Promise<operations.GetConnectionResponse>;
7
7
  reveal(request: operations.RevealConnectionRequest, options?: RequestOptions): Promise<operations.RevealConnectionResponse>;
8
8
  events(request: operations.ListEnvironmentEventsRequest, options?: RequestOptions): Promise<models.EventPage>;
9
+ listRequests(request: operations.ListEnvironmentRequestsRequest, options?: RequestOptions): Promise<operations.ListEnvironmentRequestsResponse>;
10
+ getRequestStats(request: operations.GetEnvironmentRequestStatsRequest, options?: RequestOptions): Promise<operations.GetEnvironmentRequestStatsResponse>;
11
+ getRequest(request: operations.GetEnvironmentRequestRequest, options?: RequestOptions): Promise<operations.GetEnvironmentRequestResponse>;
12
+ getRequestPayload(request: operations.GetEnvironmentRequestPayloadRequest, options?: RequestOptions): Promise<ReadableStream<Uint8Array>>;
13
+ resume(request: operations.ResumeEnvironmentRequest, options?: RequestOptions): Promise<operations.ResumeEnvironmentResponse>;
9
14
  stop(request: operations.StopEnvironmentRequest, options?: RequestOptions): Promise<operations.StopEnvironmentResponse>;
15
+ suspend(request: operations.SuspendEnvironmentRequest, options?: RequestOptions): Promise<operations.SuspendEnvironmentResponse>;
10
16
  list(request: operations.ListEnvironmentsRequest, options?: RequestOptions): Promise<operations.ListEnvironmentsResponse>;
11
17
  create(request: operations.CreateEnvironmentsRequest, options?: RequestOptions): Promise<operations.CreateEnvironmentsResponse>;
12
18
  }
@@ -4,10 +4,16 @@
4
4
  import { environmentsCreate } from "../funcs/environments-create.js";
5
5
  import { environmentsEvents } from "../funcs/environments-events.js";
6
6
  import { environmentsGetConnection } from "../funcs/environments-get-connection.js";
7
+ import { environmentsGetRequestPayload } from "../funcs/environments-get-request-payload.js";
8
+ import { environmentsGetRequestStats } from "../funcs/environments-get-request-stats.js";
9
+ import { environmentsGetRequest } from "../funcs/environments-get-request.js";
7
10
  import { environmentsGet } from "../funcs/environments-get.js";
11
+ import { environmentsListRequests } from "../funcs/environments-list-requests.js";
8
12
  import { environmentsList } from "../funcs/environments-list.js";
13
+ import { environmentsResume } from "../funcs/environments-resume.js";
9
14
  import { environmentsReveal } from "../funcs/environments-reveal.js";
10
15
  import { environmentsStop } from "../funcs/environments-stop.js";
16
+ import { environmentsSuspend } from "../funcs/environments-suspend.js";
11
17
  import { ClientSDK } from "../lib/sdks.js";
12
18
  import { unwrapAsync } from "../types/fp.js";
13
19
  export class Environments extends ClientSDK {
@@ -23,9 +29,27 @@ export class Environments extends ClientSDK {
23
29
  async events(request, options) {
24
30
  return unwrapAsync(environmentsEvents(this, request, options));
25
31
  }
32
+ async listRequests(request, options) {
33
+ return unwrapAsync(environmentsListRequests(this, request, options));
34
+ }
35
+ async getRequestStats(request, options) {
36
+ return unwrapAsync(environmentsGetRequestStats(this, request, options));
37
+ }
38
+ async getRequest(request, options) {
39
+ return unwrapAsync(environmentsGetRequest(this, request, options));
40
+ }
41
+ async getRequestPayload(request, options) {
42
+ return unwrapAsync(environmentsGetRequestPayload(this, request, options));
43
+ }
44
+ async resume(request, options) {
45
+ return unwrapAsync(environmentsResume(this, request, options));
46
+ }
26
47
  async stop(request, options) {
27
48
  return unwrapAsync(environmentsStop(this, request, options));
28
49
  }
50
+ async suspend(request, options) {
51
+ return unwrapAsync(environmentsSuspend(this, request, options));
52
+ }
29
53
  async list(request, options) {
30
54
  return unwrapAsync(environmentsList(this, request, options));
31
55
  }