@continuous-labs/sdk 0.0.5 → 0.0.7

package/src/funcs/simulators-build-simulator.ts

@@ -28,7 +28,6 @@ import {
 import * as errors from "../models/errors/index.js";
 import { ResponseValidationError } from "../models/errors/response-validation-error.js";
 import { SDKValidationError } from "../models/errors/sdk-validation-error.js";
-import * as models from "../models/index.js";
 import * as operations from "../models/operations/index.js";
 import { APICall, APIPromise } from "../types/async.js";
 import { isBlobLike } from "../types/blobs.js";
@@ -39,7 +38,7 @@ import { isReadableStream } from "../types/streams.js";
  * Build Simulator
  *
  * @remarks
- * Creates a Simulator from an OpenAPI or WSDL source. The build runs asynchronously. Send multipart/form-data with one JSON request part, and one spec file part for a spec build.
+ * Starts an asynchronous Simulator build and returns the Simulator with status building. Send multipart/form-data with a JSON part named request. To build from a document, add a file part named spec with the OpenAPI or WSDL document. For an incremental build, omit spec and set parent_id and instructions.
  */
 export function simulatorsBuildSimulator(
   client: ContinuousCore,
@@ -47,7 +46,7 @@ export function simulatorsBuildSimulator(
   options?: RequestOptions,
 ): APIPromise<
   Result<
-    models.Simulator,
+    operations.BuildSimulatorResponse,
     | errors.ErrorT
     | ContinuousError
     | ResponseValidationError
@@ -73,7 +72,7 @@ async function $do(
 ): Promise<
   [
     Result<
-      models.Simulator,
+      operations.BuildSimulatorResponse,
       | errors.ErrorT
       | ContinuousError
       | ResponseValidationError
@@ -188,7 +187,7 @@ async function $do(
   };
 
   const [result] = await M.match<
-    models.Simulator,
+    operations.BuildSimulatorResponse,
     | errors.ErrorT
     | ContinuousError
     | ResponseValidationError
@@ -199,14 +198,24 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(202, models.Simulator$inboundSchema),
+    M.json(202, operations.BuildSimulatorResponse$inboundSchema, {
+      key: "Result",
+    }),
     M.jsonErr(
-      [400, 401, 403, 404, 408, 409, 413, 415, 422, 429],
+      [400, 401, 408, 409, 413, 415, 422],
       errors.ErrorT$inboundSchema,
       { ctype: "application/problem+json" },
     ),
-    M.jsonErr([500, 503], errors.ErrorT$inboundSchema, {
+    M.jsonErr(429, errors.ErrorT$inboundSchema, {
+      ctype: "application/problem+json",
+      hdrs: true,
+    }),
+    M.jsonErr(500, errors.ErrorT$inboundSchema, {
+      ctype: "application/problem+json",
+    }),
+    M.jsonErr(503, errors.ErrorT$inboundSchema, {
       ctype: "application/problem+json",
+      hdrs: true,
     }),
     M.fail("4XX"),
     M.fail("5XX"),

package/src/funcs/simulators-cancel-simulator-build.ts

@@ -167,7 +167,7 @@ async function $do(
     | SDKValidationError
   >(
     M.json(200, models.Simulator$inboundSchema),
-    M.jsonErr([400, 401, 403, 404, 409, 422], errors.ErrorT$inboundSchema, {
+    M.jsonErr([401, 403, 404, 422], errors.ErrorT$inboundSchema, {
       ctype: "application/problem+json",
     }),
     M.jsonErr([500, 503], errors.ErrorT$inboundSchema, {

package/src/funcs/simulators-delete-simulator.ts

@@ -165,7 +165,7 @@ async function $do(
     | SDKValidationError
   >(
     M.nil(204, z.void()),
-    M.jsonErr([400, 401, 403, 404, 409, 422], errors.ErrorT$inboundSchema, {
+    M.jsonErr([401, 403, 404, 409, 422], errors.ErrorT$inboundSchema, {
       ctype: "application/problem+json",
     }),
     M.jsonErr([500, 503], errors.ErrorT$inboundSchema, {

package/src/funcs/simulators-get-simulator.ts

@@ -166,7 +166,7 @@ async function $do(
     | SDKValidationError
   >(
     M.json(200, models.Simulator$inboundSchema),
-    M.jsonErr([400, 401, 403, 404, 422], errors.ErrorT$inboundSchema, {
+    M.jsonErr([401, 403, 404, 422], errors.ErrorT$inboundSchema, {
       ctype: "application/problem+json",
     }),
     M.jsonErr([500, 503], errors.ErrorT$inboundSchema, {

package/src/funcs/simulators-list-simulators.ts

@@ -172,7 +172,7 @@ async function $do(
     | SDKValidationError
   >(
     M.json(200, models.ListSimulatorsResponse$inboundSchema),
-    M.jsonErr([400, 401, 403, 404, 422], errors.ErrorT$inboundSchema, {
+    M.jsonErr([400, 401, 422], errors.ErrorT$inboundSchema, {
       ctype: "application/problem+json",
     }),
     M.jsonErr([500, 503], errors.ErrorT$inboundSchema, {

package/src/funcs/worlds-build-world.ts

@@ -31,7 +31,7 @@ import { Result } from "../types/fp.js";
  * Build World
  *
  * @remarks
- * Builds a World definition from stable Simulator IDs. Start the World to create its Simulations.
+ * Starts an asynchronous World build from ready Simulators and returns it in the building state. Instructions generate and validate initial synthetic data. Start the World once it is ready to create its Simulations.
  */
 export function worldsBuildWorld(
   client: ContinuousCore,
@@ -161,7 +161,7 @@ async function $do(
   >(
     M.json(202, models.World$inboundSchema),
     M.jsonErr(
-      [400, 401, 403, 404, 408, 409, 413, 415, 422],
+      [400, 401, 408, 409, 413, 415, 422],
       errors.ErrorT$inboundSchema,
       { ctype: "application/problem+json" },
     ),

package/src/funcs/worlds-cancel-world-build.ts

@@ -167,7 +167,7 @@ async function $do(
     | SDKValidationError
   >(
     M.json(200, models.World$inboundSchema),
-    M.jsonErr([400, 401, 403, 404, 409], errors.ErrorT$inboundSchema, {
+    M.jsonErr([401, 403, 404], errors.ErrorT$inboundSchema, {
       ctype: "application/problem+json",
     }),
     M.jsonErr([500, 503], errors.ErrorT$inboundSchema, {

package/src/funcs/worlds-delete-world.ts

@@ -165,7 +165,7 @@ async function $do(
     | SDKValidationError
   >(
     M.nil(204, z.void()),
-    M.jsonErr([400, 401, 403, 404, 409], errors.ErrorT$inboundSchema, {
+    M.jsonErr([401, 403, 404], errors.ErrorT$inboundSchema, {
       ctype: "application/problem+json",
     }),
     M.jsonErr([500, 503], errors.ErrorT$inboundSchema, {

package/src/funcs/worlds-get-world.ts

@@ -166,7 +166,7 @@ async function $do(
     | SDKValidationError
   >(
     M.json(200, models.World$inboundSchema),
-    M.jsonErr([400, 401, 403, 404], errors.ErrorT$inboundSchema, {
+    M.jsonErr([401, 403, 404], errors.ErrorT$inboundSchema, {
       ctype: "application/problem+json",
     }),
     M.jsonErr([500, 503], errors.ErrorT$inboundSchema, {

package/src/funcs/worlds-list-worlds.ts

@@ -167,7 +167,7 @@ async function $do(
     | SDKValidationError
   >(
     M.json(200, models.ListWorldsResponse$inboundSchema),
-    M.jsonErr([400, 401, 403, 404, 422], errors.ErrorT$inboundSchema, {
+    M.jsonErr([400, 401, 422], errors.ErrorT$inboundSchema, {
       ctype: "application/problem+json",
     }),
     M.jsonErr([500, 503], errors.ErrorT$inboundSchema, {

package/src/funcs/worlds-start-world.ts

@@ -32,7 +32,7 @@ import { Result } from "../types/fp.js";
  * Start World
  *
  * @remarks
- * Creates member Simulations on first start. Later starts restore stopped Simulations from saved state.
+ * Starts every Simulation in the World. The first start creates the Simulations; later starts restore them from saved state. The World must be ready or stopped, and the workspace must have room for all members under its active-Simulation limit. A running World is returned unchanged.
  */
 export function worldsStartWorld(
   client: ContinuousCore,
@@ -166,7 +166,7 @@ async function $do(
     | SDKValidationError
   >(
     M.json(200, models.World$inboundSchema),
-    M.jsonErr([400, 401, 403, 404, 409, 429], errors.ErrorT$inboundSchema, {
+    M.jsonErr([401, 403, 404, 409, 429], errors.ErrorT$inboundSchema, {
       ctype: "application/problem+json",
     }),
     M.jsonErr([500, 503], errors.ErrorT$inboundSchema, {

package/src/funcs/worlds-stop-world.ts

@@ -166,7 +166,7 @@ async function $do(
     | SDKValidationError
   >(
     M.json(200, models.World$inboundSchema),
-    M.jsonErr([400, 401, 403, 404, 409], errors.ErrorT$inboundSchema, {
+    M.jsonErr([401, 403, 404, 409], errors.ErrorT$inboundSchema, {
       ctype: "application/problem+json",
     }),
     M.jsonErr([500, 503], errors.ErrorT$inboundSchema, {

package/src/lib/config.ts

@@ -61,7 +61,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "v1",
-  sdkVersion: "0.0.5",
+  sdkVersion: "0.0.7",
   genVersion: "2.935.1",
-  userAgent: "speakeasy-sdk/typescript 0.0.5 2.935.1 v1 @continuous-labs/sdk",
+  userAgent: "speakeasy-sdk/typescript 0.0.7 2.935.1 v1 @continuous-labs/sdk",
 } as const;

package/src/models/build-simulator-request.ts

@@ -7,14 +7,14 @@ import { remap as remap$ } from "../lib/primitives.js";
 import { ClosedEnum } from "../types/enums.js";
 
 /**
- * Builder provider. The default is claude.
+ * Model provider that builds the Simulator. Defaults to claude.
  */
 export const Builder = {
   Openai: "openai",
   Claude: "claude",
 } as const;
 /**
- * Builder provider. The default is claude.
+ * Model provider that builds the Simulator. Defaults to claude.
  */
 export type Builder = ClosedEnum<typeof Builder>;
 
@@ -32,15 +32,15 @@ export type SpecKind = ClosedEnum<typeof SpecKind>;
 
 export type BuildSimulatorRequest = {
   /**
-   * Builder provider. The default is claude.
+   * Model provider that builds the Simulator. Defaults to claude.
    */
   builder?: Builder | undefined;
   /**
-   * Optional operation filter regular expressions. Supply at most 64 expressions, with 1,024 characters in each expression. An empty list keeps all operations.
+   * Regular expressions (RE2 syntax) that select the operations to implement. Each is matched against the OpenAPI operationId or the WSDL operation name; an operation is kept when any expression matches, and an OpenAPI operation without an operationId is dropped. At most 64 expressions of at most 1,024 characters each. Omit or send an empty list to keep every operation. Not allowed for an incremental build.
    */
   filter?: Array<string> | undefined;
   /**
-   * Build guidance. At most 16,384 characters and 65,536 UTF-8 bytes. U+0000 is not permitted.
+   * Instructions for the builder. Required for an incremental build. At most 16,384 characters and 65,536 UTF-8 bytes; must not be blank or contain U+0000.
    */
   instructions?: string | undefined;
   /**
@@ -48,7 +48,7 @@ export type BuildSimulatorRequest = {
    */
   name?: string | undefined;
   /**
-   * Stable parent Simulator ID for an incremental build.
+   * Parent Simulator ID. With instructions and no spec this starts an incremental build: the parent must be ready, and the request takes no filter or spec_kind.
    */
   parentId?: string | undefined;
   /**

package/src/models/build-world-request.ts

@@ -6,11 +6,11 @@ import * as z from "zod/v4-mini";
 
 export type BuildWorldRequest = {
   /**
-   * Build guidance. At most 16,384 characters and 65,536 UTF-8 bytes. U+0000 is not permitted.
+   * Describe the initial data, scenario, and relationships. Populated Worlds support up to 8 selected Simulators and 1,000 starting records in total. Named record types replace their default data. At most 16,384 characters and 65,536 UTF-8 bytes. U+0000 is not permitted.
    */
   instructions?: string | undefined;
   /**
-   * Stable Simulator IDs for the World.
+   * Simulator IDs for the World.
    */
   simulators: Array<string>;
 };

package/src/models/create-simulation-request.ts

@@ -11,7 +11,7 @@ export type CreateSimulationRequest = {
    */
   name?: string | undefined;
   /**
-   * Stable ID of the ready Simulator.
+   * ID of the ready Simulator.
    */
   simulatorId: string;
 };

package/src/models/created-simulation.ts

@@ -12,7 +12,7 @@ import * as types from "../types/primitives.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 
 /**
- * Current Simulation status.
+ * Current status. running serves requests. paused means the Simulation was idle and the platform paused it; the next request wakes it. stopped means its state is saved and requests return 409 until you start it.
  */
 export const CreatedSimulationStatus = {
   Running: "running",
@@ -20,7 +20,7 @@ export const CreatedSimulationStatus = {
   Stopped: "stopped",
 } as const;
 /**
- * Current Simulation status.
+ * Current status. running serves requests. paused means the Simulation was idle and the platform paused it; the next request wakes it. stopped means its state is saved and requests return 409 until you start it.
  */
 export type CreatedSimulationStatus = OpenEnum<typeof CreatedSimulationStatus>;
 
@@ -30,7 +30,7 @@ export type CreatedSimulation = {
    */
   createdAt: Date;
   /**
-   * Data-plane endpoint for the Simulation.
+   * Base URL for requests to the Simulation.
    */
   endpoint: string;
   /**
@@ -38,7 +38,7 @@ export type CreatedSimulation = {
    */
   expiresAt: Date;
   /**
-   * Stable Simulation ID.
+   * Simulation ID.
    */
   id: string;
   /**
@@ -46,19 +46,19 @@ export type CreatedSimulation = {
    */
   name: string;
   /**
-   * Stable source Simulation ID for a fork, or null.
+   * Source Simulation ID for a fork, or null.
    */
   parentId: string | null;
   /**
-   * Stable ID of the Simulator.
+   * ID of the Simulator.
    */
   simulatorId: string;
   /**
-   * Current Simulation status.
+   * Current status. running serves requests. paused means the Simulation was idle and the platform paused it; the next request wakes it. stopped means its state is saved and requests return 409 until you start it.
    */
   status: CreatedSimulationStatus;
   /**
-   * One-time data-plane token.
+   * Token for requests to the Simulation endpoint. Send it in the X-Continuous-Simulation-Token header. It is returned only here; list and get omit it. Create more with POST /v1/simulations/{id}/tokens.
    */
   token: string;
 };

package/src/models/index.ts

@@ -12,11 +12,15 @@ export * from "./list-simulations-response.js";
 export * from "./list-simulators-response.js";
 export * from "./list-worlds-response.js";
 export * from "./mint-simulation-token-request.js";
-export * from "./resource-error.js";
 export * from "./security.js";
 export * from "./simulation-token.js";
 export * from "./simulation.js";
+export * from "./simulator-error.js";
 export * from "./simulator.js";
 export * from "./step.js";
+export * from "./world-build.js";
+export * from "./world-data-summary.js";
+export * from "./world-error.js";
+export * from "./world-record-count.js";
 export * from "./world-simulation.js";
 export * from "./world.js";

package/src/models/list-worlds-response.ts

@@ -12,7 +12,7 @@ import { World, World$inboundSchema } from "./world.js";
 
 export type ListWorldsResponse = {
   /**
-   * Cursor for the next page, or null when this is the last page.
+   * Cursor for the next page, or null.
    */
   nextCursor: string | null;
   /**

package/src/models/operations/build-simulator.ts

@@ -3,7 +3,11 @@
  */
 
 import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
 import { blobLikeSchema } from "../../types/blobs.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
 import * as models from "../index.js";
 
 export type Spec = {
@@ -14,11 +18,16 @@ export type Spec = {
 export type BuildSimulatorRequest = {
   request: models.BuildSimulatorRequest;
   /**
-   * OpenAPI or WSDL file. A spec build sends it. At most 67,108,864 UTF-8 bytes.
+   * OpenAPI or WSDL document, UTF-8 encoded, at most 64 MiB. Required unless the request is an incremental build (parent_id and instructions, no spec).
    */
   spec?: Spec | Blob | undefined;
 };
 
+export type BuildSimulatorResponse = {
+  headers: { [k: string]: Array<string> };
+  result: models.Simulator;
+};
+
 /** @internal */
 export type Spec$Outbound = {
   fileName: string;
@@ -66,3 +75,30 @@ export function buildSimulatorRequestToJSON(
     BuildSimulatorRequest$outboundSchema.parse(buildSimulatorRequest),
   );
 }
+
+/** @internal */
+export const BuildSimulatorResponse$inboundSchema: z.ZodMiniType<
+  BuildSimulatorResponse,
+  unknown
+> = z.pipe(
+  z.object({
+    Headers: z._default(z.record(z.string(), z.array(z.string())), {}),
+    Result: models.Simulator$inboundSchema,
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "Headers": "headers",
+      "Result": "result",
+    });
+  }),
+);
+
+export function buildSimulatorResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<BuildSimulatorResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => BuildSimulatorResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'BuildSimulatorResponse' from JSON`,
+  );
+}

package/src/models/operations/cancel-simulator-build.ts

@@ -6,7 +6,7 @@ import * as z from "zod/v4-mini";
 
 export type CancelSimulatorBuildRequest = {
   /**
-   * Stable Simulator ID.
+   * Simulator ID.
    */
   id: string;
 };

package/src/models/operations/cancel-world-build.ts

@@ -6,7 +6,7 @@ import * as z from "zod/v4-mini";
 
 export type CancelWorldBuildRequest = {
   /**
-   * Stable World ID.
+   * World ID.
    */
   id: string;
 };

package/src/models/operations/delete-simulation.ts

@@ -6,7 +6,7 @@ import * as z from "zod/v4-mini";
 
 export type DeleteSimulationRequest = {
   /**
-   * Stable resource ID.
+   * Simulation ID.
    */
   id: string;
 };

package/src/models/operations/delete-simulator.ts

@@ -6,7 +6,7 @@ import * as z from "zod/v4-mini";
 
 export type DeleteSimulatorRequest = {
   /**
-   * Stable Simulator ID.
+   * Simulator ID.
    */
   id: string;
 };

package/src/models/operations/delete-world.ts

@@ -6,7 +6,7 @@ import * as z from "zod/v4-mini";
 
 export type DeleteWorldRequest = {
   /**
-   * Stable World ID.
+   * World ID.
    */
   id: string;
 };

package/src/models/operations/fork-simulation.ts

@@ -7,7 +7,7 @@ import * as models from "../index.js";
 
 export type ForkSimulationRequest = {
   /**
-   * Stable source Simulation ID.
+   * Source Simulation ID.
    */
   id: string;
   body: models.ForkSimulationRequest;

package/src/models/operations/get-simulation.ts

@@ -6,7 +6,7 @@ import * as z from "zod/v4-mini";
 
 export type GetSimulationRequest = {
   /**
-   * Stable Simulation ID.
+   * Simulation ID.
    */
   id: string;
 };

package/src/models/operations/get-simulator.ts

@@ -6,7 +6,7 @@ import * as z from "zod/v4-mini";
 
 export type GetSimulatorRequest = {
   /**
-   * Stable Simulator ID.
+   * Simulator ID.
    */
   id: string;
 };

package/src/models/operations/get-world.ts

@@ -6,7 +6,7 @@ import * as z from "zod/v4-mini";
 
 export type GetWorldRequest = {
   /**
-   * Stable World ID.
+   * World ID.
    */
   id: string;
 };

package/src/models/operations/list-simulation-steps.ts

@@ -6,7 +6,7 @@ import * as z from "zod/v4-mini";
 
 export type ListSimulationStepsRequest = {
   /**
-   * Stable Simulation ID.
+   * Simulation ID.
    */
   id: string;
   /**

package/src/models/operations/list-simulations.ts

@@ -7,7 +7,7 @@ import { remap as remap$ } from "../../lib/primitives.js";
 import { ClosedEnum } from "../../types/enums.js";
 
 /**
- * Optional lifecycle status filter.
+ * Optional status filter.
  */
 export const ListSimulationsStatus = {
   Running: "running",
@@ -15,17 +15,17 @@ export const ListSimulationsStatus = {
   Stopped: "stopped",
 } as const;
 /**
- * Optional lifecycle status filter.
+ * Optional status filter.
  */
 export type ListSimulationsStatus = ClosedEnum<typeof ListSimulationsStatus>;
 
 export type ListSimulationsRequest = {
   /**
-   * Optional lifecycle status filter.
+   * Optional status filter.
    */
   status?: ListSimulationsStatus | undefined;
   /**
-   * Optional stable Simulator ID filter.
+   * Optional Simulator ID filter.
    */
   simulatorId?: string | undefined;
   /**

package/src/models/operations/list-simulators.ts

@@ -25,7 +25,7 @@ export type ListSimulatorsRequest = {
    */
   status?: ListSimulatorsStatus | undefined;
   /**
-   * Optional exact Simulator name. Prefix a catalog name with continuous/. Names cannot start with smr_.
+   * Return only the Simulator with this exact name. For a Simulator from the Continuous catalog, prefix the name with continuous/. Names cannot start with smr_.
    */
   name?: string | undefined;
   /**

package/src/models/operations/list-worlds.ts

@@ -10,7 +10,7 @@ export type ListWorldsRequest = {
    */
   limit?: number | undefined;
   /**
-   * Opaque cursor from the previous page.
+   * Opaque next_cursor value from a previous page.
    */
   cursor?: string | undefined;
 };

package/src/models/operations/mint-simulation-token.ts

@@ -7,7 +7,7 @@ import * as models from "../index.js";
 
 export type MintSimulationTokenRequest = {
   /**
-   * Stable Simulation ID.
+   * Simulation ID.
    */
   id: string;
   body: models.MintSimulationTokenRequest;

package/src/models/operations/start-simulation.ts

@@ -6,7 +6,7 @@ import * as z from "zod/v4-mini";
 
 export type StartSimulationRequest = {
   /**
-   * Stable Simulation ID.
+   * Simulation ID.
    */
   id: string;
 };

package/src/models/operations/start-world.ts

@@ -6,7 +6,7 @@ import * as z from "zod/v4-mini";
 
 export type StartWorldRequest = {
   /**
-   * Stable World ID.
+   * World ID.
    */
   id: string;
 };

package/src/models/operations/stop-simulation.ts

@@ -6,7 +6,7 @@ import * as z from "zod/v4-mini";
 
 export type StopSimulationRequest = {
   /**
-   * Stable Simulation ID.
+   * Simulation ID.
    */
   id: string;
 };

package/src/models/operations/stop-world.ts

@@ -6,7 +6,7 @@ import * as z from "zod/v4-mini";
 
 export type StopWorldRequest = {
   /**
-   * Stable World ID.
+   * World ID.
    */
   id: string;
 };

package/src/models/simulation-token.ts

@@ -15,7 +15,7 @@ export type SimulationToken = {
    */
   expiresAt: Date;
   /**
-   * New data-plane token.
+   * New token for requests to the Simulation endpoint. Send it in the X-Continuous-Simulation-Token header.
    */
   token: string;
 };