@alienplatform/manager-api 1.3.5 → 1.4.0

package/src/models/workerheartbeatdata.ts

@@ -0,0 +1,421 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4";
+import {
+  KubernetesEventSnapshot,
+  KubernetesEventSnapshot$Outbound,
+  KubernetesEventSnapshot$outboundSchema,
+} from "./kuberneteseventsnapshot.js";
+import {
+  KubernetesPodRuntimeUnitStatus,
+  KubernetesPodRuntimeUnitStatus$Outbound,
+  KubernetesPodRuntimeUnitStatus$outboundSchema,
+} from "./kubernetespodruntimeunitstatus.js";
+import {
+  KubernetesWorkloadKind,
+  KubernetesWorkloadKind$outboundSchema,
+} from "./kubernetesworkloadkind.js";
+import {
+  KubernetesWorkloadStatus,
+  KubernetesWorkloadStatus$Outbound,
+  KubernetesWorkloadStatus$outboundSchema,
+} from "./kubernetesworkloadstatus.js";
+import {
+  LocalRuntimeEventSnapshot,
+  LocalRuntimeEventSnapshot$Outbound,
+  LocalRuntimeEventSnapshot$outboundSchema,
+} from "./localruntimeeventsnapshot.js";
+import {
+  LocalRuntimeUnitStatus,
+  LocalRuntimeUnitStatus$Outbound,
+  LocalRuntimeUnitStatus$outboundSchema,
+} from "./localruntimeunitstatus.js";
+import {
+  MetricSample,
+  MetricSample$Outbound,
+  MetricSample$outboundSchema,
+} from "./metricsample.js";
+import {
+  WorkloadHeartbeatStatus,
+  WorkloadHeartbeatStatus$Outbound,
+  WorkloadHeartbeatStatus$outboundSchema,
+} from "./workloadheartbeatstatus.js";
+import {
+  WorkloadReplicaStatus,
+  WorkloadReplicaStatus$Outbound,
+  WorkloadReplicaStatus$outboundSchema,
+} from "./workloadreplicastatus.js";
+
+export type WorkerHeartbeatDataLocal = {
+  commandSupported: boolean;
+  cpu?: MetricSample | null | undefined;
+  events: Array<LocalRuntimeEventSnapshot>;
+  imagePathPresent: boolean;
+  memory?: MetricSample | null | undefined;
+  pid?: number | null | undefined;
+  process?: LocalRuntimeUnitStatus | null | undefined;
+  readinessProbeOk?: boolean | null | undefined;
+  status: WorkloadHeartbeatStatus;
+  triggerCount: number;
+  backend: "local";
+};
+
+export type WorkerHeartbeatDataKubernetes = {
+  cpu?: MetricSample | null | undefined;
+  events: Array<KubernetesEventSnapshot>;
+  memory?: MetricSample | null | undefined;
+  name: string;
+  namespace: string;
+  pods: Array<KubernetesPodRuntimeUnitStatus>;
+  replicas: WorkloadReplicaStatus;
+  restarts?: number | null | undefined;
+  status: WorkloadHeartbeatStatus;
+  triggerCount: number;
+  workload?: KubernetesWorkloadStatus | null | undefined;
+  workloadKind: KubernetesWorkloadKind;
+  backend: "kubernetes";
+};
+
+export type WorkerHeartbeatDataAzureContainerApps = {
+  appName: string;
+  cpu?: number | null | undefined;
+  environmentName?: string | null | undefined;
+  ingressFqdn?: string | null | undefined;
+  maxReplicas?: number | null | undefined;
+  memory?: string | null | undefined;
+  minReplicas?: number | null | undefined;
+  provisioningState?: string | null | undefined;
+  revision?: string | null | undefined;
+  runningStatus?: string | null | undefined;
+  status: WorkloadHeartbeatStatus;
+  backend: "azureContainerApps";
+};
+
+export type WorkerHeartbeatDataGcpCloudRun = {
+  containerImage?: string | null | undefined;
+  cpuLimit?: string | null | undefined;
+  generation?: number | null | undefined;
+  latestCreatedRevision?: string | null | undefined;
+  latestReadyRevision?: string | null | undefined;
+  maxInstanceCount?: number | null | undefined;
+  memoryLimit?: string | null | undefined;
+  minInstanceCount?: number | null | undefined;
+  observedGeneration?: number | null | undefined;
+  region?: string | null | undefined;
+  service: string;
+  status: WorkloadHeartbeatStatus;
+  trafficCount: number;
+  uri?: string | null | undefined;
+  urls: Array<string>;
+  backend: "gcpCloudRun";
+};
+
+export type WorkerHeartbeatDataAwsLambda = {
+  codeSha256?: string | null | undefined;
+  functionName: string;
+  functionUrlAuthType?: string | null | undefined;
+  functionUrlCorsPresent: boolean;
+  lastModified?: string | null | undefined;
+  lastUpdateStatus?: string | null | undefined;
+  lastUpdateStatusReason?: string | null | undefined;
+  lastUpdateStatusReasonCode?: string | null | undefined;
+  layerCount: number;
+  memorySizeMb?: number | null | undefined;
+  packageType?: string | null | undefined;
+  revisionId?: string | null | undefined;
+  runtime?: string | null | undefined;
+  state?: string | null | undefined;
+  stateReason?: string | null | undefined;
+  stateReasonCode?: string | null | undefined;
+  status: WorkloadHeartbeatStatus;
+  timeoutSeconds?: number | null | undefined;
+  triggerCount: number;
+  version?: string | null | undefined;
+  backend: "awsLambda";
+};
+
+export type WorkerHeartbeatData =
+  | WorkerHeartbeatDataAwsLambda
+  | WorkerHeartbeatDataGcpCloudRun
+  | WorkerHeartbeatDataAzureContainerApps
+  | WorkerHeartbeatDataKubernetes
+  | WorkerHeartbeatDataLocal;
+
+/** @internal */
+export type WorkerHeartbeatDataLocal$Outbound = {
+  commandSupported: boolean;
+  cpu?: MetricSample$Outbound | null | undefined;
+  events: Array<LocalRuntimeEventSnapshot$Outbound>;
+  imagePathPresent: boolean;
+  memory?: MetricSample$Outbound | null | undefined;
+  pid?: number | null | undefined;
+  process?: LocalRuntimeUnitStatus$Outbound | null | undefined;
+  readinessProbeOk?: boolean | null | undefined;
+  status: WorkloadHeartbeatStatus$Outbound;
+  triggerCount: number;
+  backend: "local";
+};
+
+/** @internal */
+export const WorkerHeartbeatDataLocal$outboundSchema: z.ZodType<
+  WorkerHeartbeatDataLocal$Outbound,
+  WorkerHeartbeatDataLocal
+> = z.object({
+  commandSupported: z.boolean(),
+  cpu: z.nullable(MetricSample$outboundSchema).optional(),
+  events: z.array(LocalRuntimeEventSnapshot$outboundSchema),
+  imagePathPresent: z.boolean(),
+  memory: z.nullable(MetricSample$outboundSchema).optional(),
+  pid: z.nullable(z.int()).optional(),
+  process: z.nullable(LocalRuntimeUnitStatus$outboundSchema).optional(),
+  readinessProbeOk: z.nullable(z.boolean()).optional(),
+  status: WorkloadHeartbeatStatus$outboundSchema,
+  triggerCount: z.int(),
+  backend: z.literal("local"),
+});
+
+export function workerHeartbeatDataLocalToJSON(
+  workerHeartbeatDataLocal: WorkerHeartbeatDataLocal,
+): string {
+  return JSON.stringify(
+    WorkerHeartbeatDataLocal$outboundSchema.parse(workerHeartbeatDataLocal),
+  );
+}
+
+/** @internal */
+export type WorkerHeartbeatDataKubernetes$Outbound = {
+  cpu?: MetricSample$Outbound | null | undefined;
+  events: Array<KubernetesEventSnapshot$Outbound>;
+  memory?: MetricSample$Outbound | null | undefined;
+  name: string;
+  namespace: string;
+  pods: Array<KubernetesPodRuntimeUnitStatus$Outbound>;
+  replicas: WorkloadReplicaStatus$Outbound;
+  restarts?: number | null | undefined;
+  status: WorkloadHeartbeatStatus$Outbound;
+  triggerCount: number;
+  workload?: KubernetesWorkloadStatus$Outbound | null | undefined;
+  workloadKind: string;
+  backend: "kubernetes";
+};
+
+/** @internal */
+export const WorkerHeartbeatDataKubernetes$outboundSchema: z.ZodType<
+  WorkerHeartbeatDataKubernetes$Outbound,
+  WorkerHeartbeatDataKubernetes
+> = z.object({
+  cpu: z.nullable(MetricSample$outboundSchema).optional(),
+  events: z.array(KubernetesEventSnapshot$outboundSchema),
+  memory: z.nullable(MetricSample$outboundSchema).optional(),
+  name: z.string(),
+  namespace: z.string(),
+  pods: z.array(KubernetesPodRuntimeUnitStatus$outboundSchema),
+  replicas: WorkloadReplicaStatus$outboundSchema,
+  restarts: z.nullable(z.int()).optional(),
+  status: WorkloadHeartbeatStatus$outboundSchema,
+  triggerCount: z.int(),
+  workload: z.nullable(KubernetesWorkloadStatus$outboundSchema).optional(),
+  workloadKind: KubernetesWorkloadKind$outboundSchema,
+  backend: z.literal("kubernetes"),
+});
+
+export function workerHeartbeatDataKubernetesToJSON(
+  workerHeartbeatDataKubernetes: WorkerHeartbeatDataKubernetes,
+): string {
+  return JSON.stringify(
+    WorkerHeartbeatDataKubernetes$outboundSchema.parse(
+      workerHeartbeatDataKubernetes,
+    ),
+  );
+}
+
+/** @internal */
+export type WorkerHeartbeatDataAzureContainerApps$Outbound = {
+  appName: string;
+  cpu?: number | null | undefined;
+  environmentName?: string | null | undefined;
+  ingressFqdn?: string | null | undefined;
+  maxReplicas?: number | null | undefined;
+  memory?: string | null | undefined;
+  minReplicas?: number | null | undefined;
+  provisioningState?: string | null | undefined;
+  revision?: string | null | undefined;
+  runningStatus?: string | null | undefined;
+  status: WorkloadHeartbeatStatus$Outbound;
+  backend: "azureContainerApps";
+};
+
+/** @internal */
+export const WorkerHeartbeatDataAzureContainerApps$outboundSchema: z.ZodType<
+  WorkerHeartbeatDataAzureContainerApps$Outbound,
+  WorkerHeartbeatDataAzureContainerApps
+> = z.object({
+  appName: z.string(),
+  cpu: z.nullable(z.number()).optional(),
+  environmentName: z.nullable(z.string()).optional(),
+  ingressFqdn: z.nullable(z.string()).optional(),
+  maxReplicas: z.nullable(z.int()).optional(),
+  memory: z.nullable(z.string()).optional(),
+  minReplicas: z.nullable(z.int()).optional(),
+  provisioningState: z.nullable(z.string()).optional(),
+  revision: z.nullable(z.string()).optional(),
+  runningStatus: z.nullable(z.string()).optional(),
+  status: WorkloadHeartbeatStatus$outboundSchema,
+  backend: z.literal("azureContainerApps"),
+});
+
+export function workerHeartbeatDataAzureContainerAppsToJSON(
+  workerHeartbeatDataAzureContainerApps: WorkerHeartbeatDataAzureContainerApps,
+): string {
+  return JSON.stringify(
+    WorkerHeartbeatDataAzureContainerApps$outboundSchema.parse(
+      workerHeartbeatDataAzureContainerApps,
+    ),
+  );
+}
+
+/** @internal */
+export type WorkerHeartbeatDataGcpCloudRun$Outbound = {
+  containerImage?: string | null | undefined;
+  cpuLimit?: string | null | undefined;
+  generation?: number | null | undefined;
+  latestCreatedRevision?: string | null | undefined;
+  latestReadyRevision?: string | null | undefined;
+  maxInstanceCount?: number | null | undefined;
+  memoryLimit?: string | null | undefined;
+  minInstanceCount?: number | null | undefined;
+  observedGeneration?: number | null | undefined;
+  region?: string | null | undefined;
+  service: string;
+  status: WorkloadHeartbeatStatus$Outbound;
+  trafficCount: number;
+  uri?: string | null | undefined;
+  urls: Array<string>;
+  backend: "gcpCloudRun";
+};
+
+/** @internal */
+export const WorkerHeartbeatDataGcpCloudRun$outboundSchema: z.ZodType<
+  WorkerHeartbeatDataGcpCloudRun$Outbound,
+  WorkerHeartbeatDataGcpCloudRun
+> = z.object({
+  containerImage: z.nullable(z.string()).optional(),
+  cpuLimit: z.nullable(z.string()).optional(),
+  generation: z.nullable(z.int()).optional(),
+  latestCreatedRevision: z.nullable(z.string()).optional(),
+  latestReadyRevision: z.nullable(z.string()).optional(),
+  maxInstanceCount: z.nullable(z.int()).optional(),
+  memoryLimit: z.nullable(z.string()).optional(),
+  minInstanceCount: z.nullable(z.int()).optional(),
+  observedGeneration: z.nullable(z.int()).optional(),
+  region: z.nullable(z.string()).optional(),
+  service: z.string(),
+  status: WorkloadHeartbeatStatus$outboundSchema,
+  trafficCount: z.int(),
+  uri: z.nullable(z.string()).optional(),
+  urls: z.array(z.string()),
+  backend: z.literal("gcpCloudRun"),
+});
+
+export function workerHeartbeatDataGcpCloudRunToJSON(
+  workerHeartbeatDataGcpCloudRun: WorkerHeartbeatDataGcpCloudRun,
+): string {
+  return JSON.stringify(
+    WorkerHeartbeatDataGcpCloudRun$outboundSchema.parse(
+      workerHeartbeatDataGcpCloudRun,
+    ),
+  );
+}
+
+/** @internal */
+export type WorkerHeartbeatDataAwsLambda$Outbound = {
+  codeSha256?: string | null | undefined;
+  functionName: string;
+  functionUrlAuthType?: string | null | undefined;
+  functionUrlCorsPresent: boolean;
+  lastModified?: string | null | undefined;
+  lastUpdateStatus?: string | null | undefined;
+  lastUpdateStatusReason?: string | null | undefined;
+  lastUpdateStatusReasonCode?: string | null | undefined;
+  layerCount: number;
+  memorySizeMb?: number | null | undefined;
+  packageType?: string | null | undefined;
+  revisionId?: string | null | undefined;
+  runtime?: string | null | undefined;
+  state?: string | null | undefined;
+  stateReason?: string | null | undefined;
+  stateReasonCode?: string | null | undefined;
+  status: WorkloadHeartbeatStatus$Outbound;
+  timeoutSeconds?: number | null | undefined;
+  triggerCount: number;
+  version?: string | null | undefined;
+  backend: "awsLambda";
+};
+
+/** @internal */
+export const WorkerHeartbeatDataAwsLambda$outboundSchema: z.ZodType<
+  WorkerHeartbeatDataAwsLambda$Outbound,
+  WorkerHeartbeatDataAwsLambda
+> = z.object({
+  codeSha256: z.nullable(z.string()).optional(),
+  functionName: z.string(),
+  functionUrlAuthType: z.nullable(z.string()).optional(),
+  functionUrlCorsPresent: z.boolean(),
+  lastModified: z.nullable(z.string()).optional(),
+  lastUpdateStatus: z.nullable(z.string()).optional(),
+  lastUpdateStatusReason: z.nullable(z.string()).optional(),
+  lastUpdateStatusReasonCode: z.nullable(z.string()).optional(),
+  layerCount: z.int(),
+  memorySizeMb: z.nullable(z.int()).optional(),
+  packageType: z.nullable(z.string()).optional(),
+  revisionId: z.nullable(z.string()).optional(),
+  runtime: z.nullable(z.string()).optional(),
+  state: z.nullable(z.string()).optional(),
+  stateReason: z.nullable(z.string()).optional(),
+  stateReasonCode: z.nullable(z.string()).optional(),
+  status: WorkloadHeartbeatStatus$outboundSchema,
+  timeoutSeconds: z.nullable(z.int()).optional(),
+  triggerCount: z.int(),
+  version: z.nullable(z.string()).optional(),
+  backend: z.literal("awsLambda"),
+});
+
+export function workerHeartbeatDataAwsLambdaToJSON(
+  workerHeartbeatDataAwsLambda: WorkerHeartbeatDataAwsLambda,
+): string {
+  return JSON.stringify(
+    WorkerHeartbeatDataAwsLambda$outboundSchema.parse(
+      workerHeartbeatDataAwsLambda,
+    ),
+  );
+}
+
+/** @internal */
+export type WorkerHeartbeatData$Outbound =
+  | WorkerHeartbeatDataAwsLambda$Outbound
+  | WorkerHeartbeatDataGcpCloudRun$Outbound
+  | WorkerHeartbeatDataAzureContainerApps$Outbound
+  | WorkerHeartbeatDataKubernetes$Outbound
+  | WorkerHeartbeatDataLocal$Outbound;
+
+/** @internal */
+export const WorkerHeartbeatData$outboundSchema: z.ZodType<
+  WorkerHeartbeatData$Outbound,
+  WorkerHeartbeatData
+> = z.union([
+  z.lazy(() => WorkerHeartbeatDataAwsLambda$outboundSchema),
+  z.lazy(() => WorkerHeartbeatDataGcpCloudRun$outboundSchema),
+  z.lazy(() => WorkerHeartbeatDataAzureContainerApps$outboundSchema),
+  z.lazy(() => WorkerHeartbeatDataKubernetes$outboundSchema),
+  z.lazy(() => WorkerHeartbeatDataLocal$outboundSchema),
+]);
+
+export function workerHeartbeatDataToJSON(
+  workerHeartbeatData: WorkerHeartbeatData,
+): string {
+  return JSON.stringify(
+    WorkerHeartbeatData$outboundSchema.parse(workerHeartbeatData),
+  );
+}

package/src/models/workloadheartbeatstatus.ts

@@ -0,0 +1,58 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4";
+import {
+  HeartbeatCollectionIssue,
+  HeartbeatCollectionIssue$Outbound,
+  HeartbeatCollectionIssue$outboundSchema,
+} from "./heartbeatcollectionissue.js";
+import {
+  ObservedHealth,
+  ObservedHealth$outboundSchema,
+} from "./observedhealth.js";
+import {
+  ProviderLifecycleState,
+  ProviderLifecycleState$outboundSchema,
+} from "./providerlifecyclestate.js";
+
+export type WorkloadHeartbeatStatus = {
+  collectionIssues: Array<HeartbeatCollectionIssue>;
+  health: ObservedHealth;
+  lifecycle: ProviderLifecycleState;
+  message?: string | null | undefined;
+  partial: boolean;
+  stale: boolean;
+};
+
+/** @internal */
+export type WorkloadHeartbeatStatus$Outbound = {
+  collectionIssues: Array<HeartbeatCollectionIssue$Outbound>;
+  health: string;
+  lifecycle: string;
+  message?: string | null | undefined;
+  partial: boolean;
+  stale: boolean;
+};
+
+/** @internal */
+export const WorkloadHeartbeatStatus$outboundSchema: z.ZodType<
+  WorkloadHeartbeatStatus$Outbound,
+  WorkloadHeartbeatStatus
+> = z.object({
+  collectionIssues: z.array(HeartbeatCollectionIssue$outboundSchema),
+  health: ObservedHealth$outboundSchema,
+  lifecycle: ProviderLifecycleState$outboundSchema,
+  message: z.nullable(z.string()).optional(),
+  partial: z.boolean(),
+  stale: z.boolean(),
+});
+
+export function workloadHeartbeatStatusToJSON(
+  workloadHeartbeatStatus: WorkloadHeartbeatStatus,
+): string {
+  return JSON.stringify(
+    WorkloadHeartbeatStatus$outboundSchema.parse(workloadHeartbeatStatus),
+  );
+}

package/src/models/workloadreplicastatus.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4";
+
+export type WorkloadReplicaStatus = {
+  available?: number | null | undefined;
+  current?: number | null | undefined;
+  desired?: number | null | undefined;
+  misscheduled?: number | null | undefined;
+  ready?: number | null | undefined;
+  updated?: number | null | undefined;
+};
+
+/** @internal */
+export type WorkloadReplicaStatus$Outbound = {
+  available?: number | null | undefined;
+  current?: number | null | undefined;
+  desired?: number | null | undefined;
+  misscheduled?: number | null | undefined;
+  ready?: number | null | undefined;
+  updated?: number | null | undefined;
+};
+
+/** @internal */
+export const WorkloadReplicaStatus$outboundSchema: z.ZodType<
+  WorkloadReplicaStatus$Outbound,
+  WorkloadReplicaStatus
+> = z.object({
+  available: z.nullable(z.int()).optional(),
+  current: z.nullable(z.int()).optional(),
+  desired: z.nullable(z.int()).optional(),
+  misscheduled: z.nullable(z.int()).optional(),
+  ready: z.nullable(z.int()).optional(),
+  updated: z.nullable(z.int()).optional(),
+});
+
+export function workloadReplicaStatusToJSON(
+  workloadReplicaStatus: WorkloadReplicaStatus,
+): string {
+  return JSON.stringify(
+    WorkloadReplicaStatus$outboundSchema.parse(workloadReplicaStatus),
+  );
+}

package/src/sdk/deploymentgroups.ts

@@ -21,6 +21,14 @@ export class DeploymentGroups extends ClientSDK {
     ));
   }
 
+  /**
+   * Every handler in this file runs `auth::require_auth(&state, &headers)`
+   * and then threads `&subject` into the `DeploymentStore` calls — see the
+   * trait doc on [`DeploymentStore`] for the convention.
+   *
+   * @remarks
+   * `POST /v1/deployment-groups` — Inbound: workspace bearer.
+   */
   async createDeploymentGroup(
     request: models.CreateDeploymentGroupRequest,
     options?: RequestOptions,

package/src/sdk/deployments.ts

@@ -26,6 +26,17 @@ export class Deployments extends ClientSDK {
     ));
   }
 
+  /**
+   * Every handler in this file runs `auth::require_auth(&state, &headers)`
+   * and then threads `&subject` into the `DeploymentStore` calls. Embedders
+   * that proxy to an upstream API can use the subject's `bearer_token` for
+   * passthrough; single-tenant impls ignore it. See the trait doc on
+   * [`DeploymentStore`] for the full convention.
+   *
+   * @remarks
+   * `POST /v1/deployments` — Inbound: workspace / project / dg bearer (or
+   * authenticated user). Deployment-scoped tokens cannot create deployments.
+   */
   async createDeployment(
     request: models.CreateDeploymentRequest,
     options?: RequestOptions,

package/src/sdk/sdk.ts

@@ -10,6 +10,7 @@ import { Deployments } from "./deployments.js";
 import { Health } from "./health.js";
 import { Leases } from "./leases.js";
 import { Releases } from "./releases.js";
+import { StackImport } from "./stackimport.js";
 import { Sync } from "./sync.js";
 import { Whoami } from "./whoami.js";
 
@@ -54,6 +55,11 @@ export class AlienManager extends ClientSDK {
     return (this._credentials ??= new Credentials(this._options));
   }
 
+  private _stackImport?: StackImport;
+  get stackImport(): StackImport {
+    return (this._stackImport ??= new StackImport(this._options));
+  }
+
   private _whoami?: Whoami;
   get whoami(): Whoami {
     return (this._whoami ??= new Whoami(this._options));

package/src/sdk/stackimport.ts

@@ -0,0 +1,32 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { stackImportStackImport } from "../funcs/stackImportStackImport.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class StackImport extends ClientSDK {
+  /**
+   * `POST /v1/stack/import` — Inbound: deployment-group bearer.
+   *
+   * @remarks
+   * The body's `deploymentGroupToken` field is informational (mirrored back
+   * for log correlation) — actual authentication is the standard `Authorization
+   * Bearer` header processed by [`auth::require_auth`]. The handler tolerates
+   * the body field being either the raw token or empty; it never reads
+   * credentials from the body to make the secret path uniform with every
+   * other endpoint.
+   */
+  async stackImport(
+    request: models.StackImportRequest,
+    options?: RequestOptions,
+  ): Promise<models.StackImportResponse> {
+    return unwrapAsync(stackImportStackImport(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/sync.ts

@@ -12,6 +12,13 @@ import * as models from "../models/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
 export class Sync extends ClientSDK {
+  /**
+   * `POST /v1/initialize` — Inbound: deployment-group bearer (typical),
+   * or workspace bearer for self-hosted operator workflows. New deployments
+   * are created via `DeploymentStore::create_deployment(caller, …)` so
+   * embedders that proxy to an upstream API write the row in the dg's
+   * workspace, not the manager's.
+   */
   async initialize(
     request: models.InitializeRequest,
     options?: RequestOptions,
@@ -23,6 +30,11 @@ export class Sync extends ClientSDK {
     ));
   }
 
+  /**
+   * `POST /v1/sync` — Inbound: deployment bearer. The agent-driven sync
+   * path; `caller: &Subject` is threaded into the store so embedders see
+   * the agent's own scope.
+   */
   async agentSync(
     request: models.AgentSyncRequest,
     options?: RequestOptions,
@@ -34,6 +46,11 @@ export class Sync extends ClientSDK {
     ));
   }
 
+  /**
+   * `POST /v1/sync/acquire` — Inbound: workspace / dg / deployment bearer.
+   * `caller: &Subject` is threaded into `DeploymentStore::acquire` so
+   * embedders can authorize against the inbound caller's scope.
+   */
   async acquire(
     request: models.AcquireRequest,
     options?: RequestOptions,
@@ -45,6 +62,10 @@ export class Sync extends ClientSDK {
     ));
   }
 
+  /**
+   * `POST /v1/sync/reconcile` — Inbound: workspace / dg / deployment
+   * bearer. `caller: &Subject` is threaded into `DeploymentStore::reconcile`.
+   */
   async reconcile(
     request: models.ReconcileRequest,
     options?: RequestOptions,
@@ -56,6 +77,10 @@ export class Sync extends ClientSDK {
     ));
   }
 
+  /**
+   * `POST /v1/sync/release` — Inbound: workspace / dg / deployment bearer.
+   * `caller: &Subject` is threaded into `DeploymentStore::release`.
+   */
   async release(
     request: models.ReleaseRequest,
     options?: RequestOptions,

package/esm/models/platform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/models/platform.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;CAOX,CAAC;AACX;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEnD,gBAAgB;AAChB,eAAO,MAAM,sBAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,QAAQ,CAE7D,CAAC;AACF,gBAAgB;AAChB,eAAO,MAAM,uBAAuB,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,QAAQ,CACvC,CAAC"}

package/esm/models/platform.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/models/platform.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;CACJ,CAAC;AAMX,gBAAgB;AAChB,MAAM,CAAC,MAAM,sBAAsB,GAA+B,CAAC,CAAC,IAAI,CACtE,QAAQ,CACT,CAAC;AACF,gBAAgB;AAChB,MAAM,CAAC,MAAM,uBAAuB,GAClC,sBAAsB,CAAC"}