@continuous-labs/sdk 0.0.6 → 0.0.7

package/src/models/world-build.ts

@@ -0,0 +1,58 @@
+/*
+ * 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 openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import {
+  WorldDataSummary,
+  WorldDataSummary$inboundSchema,
+} from "./world-data-summary.js";
+
+/**
+ * Current phase of starting-data preparation.
+ */
+export const Stage = {
+  Planning: "planning",
+  Generating: "generating",
+  Validating: "validating",
+  Complete: "complete",
+} as const;
+/**
+ * Current phase of starting-data preparation.
+ */
+export type Stage = OpenEnum<typeof Stage>;
+
+export type WorldBuild = {
+  /**
+   * Current phase of starting-data preparation.
+   */
+  stage: Stage;
+  summary?: WorldDataSummary | undefined;
+};
+
+/** @internal */
+export const Stage$inboundSchema: z.ZodMiniType<Stage, unknown> = openEnums
+  .inboundSchema(Stage);
+
+/** @internal */
+export const WorldBuild$inboundSchema: z.ZodMiniType<WorldBuild, unknown> = z
+  .object({
+    stage: Stage$inboundSchema,
+    summary: types.optional(WorldDataSummary$inboundSchema),
+  });
+
+export function worldBuildFromJSON(
+  jsonString: string,
+): SafeParseResult<WorldBuild, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => WorldBuild$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'WorldBuild' from JSON`,
+  );
+}

package/src/models/world-data-summary.ts

@@ -0,0 +1,53 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import {
+  WorldRecordCount,
+  WorldRecordCount$inboundSchema,
+} from "./world-record-count.js";
+
+export type WorldDataSummary = {
+  /**
+   * Defaults and inferred choices used to prepare the starting data.
+   */
+  assumptions: Array<string>;
+  /**
+   * Record conditions and counts computed from a complete census of served records.
+   */
+  conditions: Array<string>;
+  /**
+   * Observed starting record counts for each member and record type.
+   */
+  records: Array<WorldRecordCount>;
+  /**
+   * Shared relationships checked against the data and served API values.
+   */
+  relationships: Array<string>;
+};
+
+/** @internal */
+export const WorldDataSummary$inboundSchema: z.ZodMiniType<
+  WorldDataSummary,
+  unknown
+> = z.object({
+  assumptions: z.array(types.string()),
+  conditions: z.array(types.string()),
+  records: z.array(WorldRecordCount$inboundSchema),
+  relationships: z.array(types.string()),
+});
+
+export function worldDataSummaryFromJSON(
+  jsonString: string,
+): SafeParseResult<WorldDataSummary, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => WorldDataSummary$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'WorldDataSummary' from JSON`,
+  );
+}

package/src/models/world-error.ts

@@ -0,0 +1,63 @@
+/*
+ * 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 openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+/**
+ * Stable World error code.
+ */
+export const WorldErrorCode = {
+  WorldBuildCanceled: "world_build_canceled",
+  WorldStartFailed: "world_start_failed",
+  WorldCreateFailed: "world_create_failed",
+  WorldFailed: "world_failed",
+  WorldPopulationFailed: "world_population_failed",
+  WorldPopulationUnsupported: "world_population_unsupported",
+  WorldPopulationInvalid: "world_population_invalid",
+  WorldPopulationUnavailable: "world_population_unavailable",
+} as const;
+/**
+ * Stable World error code.
+ */
+export type WorldErrorCode = OpenEnum<typeof WorldErrorCode>;
+
+export type WorldError = {
+  /**
+   * Stable World error code.
+   */
+  code: WorldErrorCode;
+  /**
+   * Safe human-readable error detail.
+   */
+  detail: string;
+};
+
+/** @internal */
+export const WorldErrorCode$inboundSchema: z.ZodMiniType<
+  WorldErrorCode,
+  unknown
+> = openEnums.inboundSchema(WorldErrorCode);
+
+/** @internal */
+export const WorldError$inboundSchema: z.ZodMiniType<WorldError, unknown> = z
+  .object({
+    code: WorldErrorCode$inboundSchema,
+    detail: types.string(),
+  });
+
+export function worldErrorFromJSON(
+  jsonString: string,
+): SafeParseResult<WorldError, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => WorldError$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'WorldError' from JSON`,
+  );
+}

package/src/models/world-record-count.ts

@@ -0,0 +1,58 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+export type WorldRecordCount = {
+  /**
+   * Number of stored starting records of this type.
+   */
+  count: number;
+  /**
+   * Record type reported by the Simulator.
+   */
+  entity: string;
+  /**
+   * Position in the selected Simulator list, starting at zero.
+   */
+  memberIndex: number;
+  /**
+   * Stable ID of the Simulator for this member.
+   */
+  simulatorId: string;
+};
+
+/** @internal */
+export const WorldRecordCount$inboundSchema: z.ZodMiniType<
+  WorldRecordCount,
+  unknown
+> = z.pipe(
+  z.object({
+    count: types.number(),
+    entity: types.string(),
+    member_index: types.number(),
+    simulator_id: types.string(),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "member_index": "memberIndex",
+      "simulator_id": "simulatorId",
+    });
+  }),
+);
+
+export function worldRecordCountFromJSON(
+  jsonString: string,
+): SafeParseResult<WorldRecordCount, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => WorldRecordCount$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'WorldRecordCount' from JSON`,
+  );
+}

package/src/models/world.ts

@@ -10,17 +10,15 @@ import { OpenEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import * as types from "../types/primitives.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
-import {
-  ResourceError,
-  ResourceError$inboundSchema,
-} from "./resource-error.js";
+import { WorldBuild, WorldBuild$inboundSchema } from "./world-build.js";
+import { WorldError, WorldError$inboundSchema } from "./world-error.js";
 import {
   WorldSimulation,
   WorldSimulation$inboundSchema,
 } from "./world-simulation.js";
 
 /**
- * building while the build runs; ready when the World can be started; running or stopped once its Simulations exist; failed when the first start could not create its Simulations; canceled when the build was canceled.
+ * building while the build runs; ready when it can be started; running or stopped once its Simulations exist; failed when building or first start fails; canceled when the build was canceled.
  */
 export const WorldStatus = {
   Building: "building",
@@ -31,26 +29,27 @@ export const WorldStatus = {
   Canceled: "canceled",
 } as const;
 /**
- * building while the build runs; ready when the World can be started; running or stopped once its Simulations exist; failed when the first start could not create its Simulations; canceled when the build was canceled.
+ * building while the build runs; ready when it can be started; running or stopped once its Simulations exist; failed when building or first start fails; canceled when the build was canceled.
  */
 export type WorldStatus = OpenEnum<typeof WorldStatus>;
 
 export type World = {
+  build?: WorldBuild | undefined;
   /**
-   * World creation time.
+   * Time when the World build started.
    */
   createdAt: Date;
-  error: ResourceError | null;
+  error: WorldError | null;
   /**
    * World ID.
    */
   id: string;
   /**
-   * Build guidance stored with the World.
+   * Instructions for the initial synthetic data and relationships.
    */
   instructions: string;
   /**
-   * Simulations in the World. Empty unless the World is running or stopped.
+   * Created member Simulations. This list is empty before first start.
    */
   simulations: Array<WorldSimulation>;
   /**
@@ -58,7 +57,7 @@ export type World = {
    */
   simulators: Array<string>;
   /**
-   * building while the build runs; ready when the World can be started; running or stopped once its Simulations exist; failed when the first start could not create its Simulations; canceled when the build was canceled.
+   * building while the build runs; ready when it can be started; running or stopped once its Simulations exist; failed when building or first start fails; canceled when the build was canceled.
    */
   status: WorldStatus;
 };
@@ -70,8 +69,9 @@ export const WorldStatus$inboundSchema: z.ZodMiniType<WorldStatus, unknown> =
 /** @internal */
 export const World$inboundSchema: z.ZodMiniType<World, unknown> = z.pipe(
   z.object({
+    build: types.optional(WorldBuild$inboundSchema),
     created_at: types.date(),
-    error: types.nullable(ResourceError$inboundSchema),
+    error: types.nullable(WorldError$inboundSchema),
     id: types.string(),
     instructions: types.string(),
     simulations: z.array(WorldSimulation$inboundSchema),

package/src/sdk/simulators.ts

@@ -39,7 +39,7 @@ export class Simulators extends ClientSDK {
   async buildSimulator(
     request: operations.BuildSimulatorRequest,
     options?: RequestOptions,
-  ): Promise<models.Simulator> {
+  ): Promise<operations.BuildSimulatorResponse> {
     return unwrapAsync(simulatorsBuildSimulator(
       this,
       request,

package/src/sdk/worlds.ts

@@ -36,7 +36,7 @@ export class Worlds extends ClientSDK {
    * Build World
    *
    * @remarks
-   * Starts an asynchronous World build from one or more ready Simulators and returns the World in the building state. Start the World once it is ready 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.
    */
   async buildWorld(
     request: models.BuildWorldRequest,

package/esm/models/resource-error.d.ts

@@ -1,17 +0,0 @@
-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 ResourceError = {
-    /**
-     * Stable machine-readable error code.
-     */
-    code: string;
-    /**
-     * Safe human-readable error detail.
-     */
-    detail: string;
-};
-/** @internal */
-export declare const ResourceError$inboundSchema: z.ZodMiniType<ResourceError, unknown>;
-export declare function resourceErrorFromJSON(jsonString: string): SafeParseResult<ResourceError, SDKValidationError>;
-//# sourceMappingURL=resource-error.d.ts.map

package/esm/models/resource-error.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resource-error.d.ts","sourceRoot":"","sources":["../../src/models/resource-error.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,2BAA2B,EAAE,CAAC,CAAC,WAAW,CACrD,aAAa,EACb,OAAO,CAIP,CAAC;AAEH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAMpD"}

package/esm/models/resource-error.js

@@ -1,15 +0,0 @@
-/*
- * 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 ResourceError$inboundSchema = z.object({
-    code: types.string(),
-    detail: types.string(),
-});
-export function resourceErrorFromJSON(jsonString) {
-    return safeParse(jsonString, (x) => ResourceError$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ResourceError' from JSON`);
-}
-//# sourceMappingURL=resource-error.js.map

package/esm/models/resource-error.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resource-error.js","sourceRoot":"","sources":["../../src/models/resource-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAC;AAchD,gBAAgB;AAChB,MAAM,CAAC,MAAM,2BAA2B,GAGpC,CAAC,CAAC,MAAM,CAAC;IACX,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CACnC,UAAkB,EACkC;IACpD,OAAO,SAAS,CACd,UAAU,EACV,CAAC,CAAC,EAAE,EAAE,CAAC,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EACvD,2CAA2C,CAC5C,CAAC;AAAA,CACH"}

package/src/models/resource-error.ts

@@ -1,39 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-
-import * as z from "zod/v4-mini";
-import { safeParse } from "../lib/schemas.js";
-import { Result as SafeParseResult } from "../types/fp.js";
-import * as types from "../types/primitives.js";
-import { SDKValidationError } from "./errors/sdk-validation-error.js";
-
-export type ResourceError = {
-  /**
-   * Stable machine-readable error code.
-   */
-  code: string;
-  /**
-   * Safe human-readable error detail.
-   */
-  detail: string;
-};
-
-/** @internal */
-export const ResourceError$inboundSchema: z.ZodMiniType<
-  ResourceError,
-  unknown
-> = z.object({
-  code: types.string(),
-  detail: types.string(),
-});
-
-export function resourceErrorFromJSON(
-  jsonString: string,
-): SafeParseResult<ResourceError, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => ResourceError$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'ResourceError' from JSON`,
-  );
-}