@alienplatform/sdk 3.3.68 → 3.3.70

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 (2) hide show
  1. package/dist/registry.js +297 -6
  2. package/package.json +4 -4
package/dist/registry.js CHANGED
@@ -6016,6 +6016,22 @@ const AlienEventSchema = union([
6016
6016
  * Do not edit manually.
6017
6017
  */
6018
6018
  /**
6019
+ * @description AWS Bedrock AI binding configuration
6020
+ */
6021
+ const BedrockAiBindingSchema = object({ "region": string().describe("The AWS region where Bedrock is accessed (for example `us-east-1`). The gateway builds\n`https://bedrock-runtime.<region>.amazonaws.com` from it, so parsing refuses anything\nthat is not a plain AWS region name.") }).describe("AWS Bedrock AI binding configuration");
6022
+ /**
6023
+ * Generated by Kubb (https://kubb.dev/).
6024
+ * Do not edit manually.
6025
+ */
6026
+ /**
6027
+ * @description A managed cloud AI service the workload reaches with its ambient identity. The installer owns\nthe identity and its permissions; Alien grants nothing for it.
6028
+ */
6029
+ const AmbientAiBindingSchema = lazy(() => BedrockAiBindingSchema).and(object({ "service": _enum(["bedrock"]) })).describe("AWS Bedrock AI binding configuration").describe("A managed cloud AI service the workload reaches with its ambient identity. The installer owns\nthe identity and its permissions; Alien grants nothing for it.");
6030
+ /**
6031
+ * Generated by Kubb (https://kubb.dev/).
6032
+ * Do not edit manually.
6033
+ */
6034
+ /**
6019
6035
  * @description CPU architecture.
6020
6036
  */
6021
6037
  const ArchitectureSchema = _enum(["arm64", "x86_64"]).describe("CPU architecture.");
@@ -7813,17 +7829,18 @@ const AzureManagementConfigSchema = object({
7813
7829
  * Do not edit manually.
7814
7830
  */
7815
7831
  /**
7816
- * @description Setup-owned subnet coordinates consumed by an internal sandbox gateway load balancer.
7832
+ * @description Setup-owned subnet coordinates consumed by the sandbox gateway VMs.
7817
7833
  */
7818
7834
  const AzureSandboxNetworkSchema = object({
7819
7835
  "gatewayCidrs": array(string()).describe("Gateway ranges allowed by the sandbox subnet NSGs on TCP 3128. Deployments set up before\nthe admin port was removed from that rule also allow TCP 3129; both are accepted."),
7820
- "gatewaySubnetIds": array(string()).describe("Undelegated subnet reserved for the gateway load balancer's frontend."),
7836
+ "gatewayIps": optional(array(string()).describe("Static private IPs of the setup-created gateway VMs (one per replica). Setup releases\nthat predate the VMs leave this empty, and Internet sandboxes then refuse to start.")),
7837
+ "gatewaySubnetIds": array(string()).describe("Undelegated subnet reserved for the gateway replicas' static NICs."),
7821
7838
  "sandboxCidrs": array(string()).describe("Sandbox source ranges allowed on the proxy listener."),
7822
7839
  "sandboxCidrsByResource": optional(object({}).catchall(array(string())).describe("Dedicated source ranges keyed by Sandbox resource id for exact linked-resource access.")),
7823
7840
  "sandboxSubnetIds": array(string()).describe("Dedicated delegated subnets whose sandboxes use the gateway."),
7824
7841
  "vpcCidrs": array(string()).describe("Every VNet range excluded from gateway destinations."),
7825
7842
  "workloadCidrs": array(string()).describe("Workload source ranges allowed on the authenticated admin listener.")
7826
- }).describe("Setup-owned subnet coordinates consumed by an internal sandbox gateway load balancer.");
7843
+ }).describe("Setup-owned subnet coordinates consumed by the sandbox gateway VMs.");
7827
7844
  object({
7828
7845
  "applicationGatewaySubnetId": string().describe("Dedicated subnet for classic Azure Application Gateway ingress.").nullish(),
7829
7846
  "applicationGatewaySubnetName": string().describe("Dedicated subnet name for classic Azure Application Gateway ingress.").nullish(),
@@ -9807,6 +9824,66 @@ const CustomDomainConfigSchema = object({
9807
9824
  * Do not edit manually.
9808
9825
  */
9809
9826
  /**
9827
+ * @description The type of a resource an extension defines, such as `acme/dns-zone`.
9828
+ */
9829
+ const CustomResourceTypeSchema = string().regex(/^(?!(?:alien|experimental)\/)[^/]+\/.+$/).describe("The type of a resource an extension defines, such as `acme/dns-zone`.");
9830
+ /**
9831
+ * Generated by Kubb (https://kubb.dev/).
9832
+ * Do not edit manually.
9833
+ */
9834
+ /**
9835
+ * @description A binding to an existing resource of a type an extension defines, such as a DNS zone the\ncustomer already has. Its fields are the resource\'s outputs, as the type\'s descriptor declares\nthem in `schemas.outputs`.
9836
+ */
9837
+ const CustomExternalBindingSchema = object({
9838
+ "service": string().describe("The service the existing resource lives in, such as `route53`."),
9839
+ get "type"() {
9840
+ return CustomResourceTypeSchema.describe("The type of a resource an extension defines, such as `acme/dns-zone`.");
9841
+ }
9842
+ }).catchall(any().describe("The resource's outputs, such as its `zoneId`.")).describe("A binding to an existing resource of a type an extension defines, such as a DNS zone the\ncustomer already has. Its fields are the resource's outputs, as the type's descriptor declares\nthem in `schemas.outputs`.");
9843
+ /**
9844
+ * Generated by Kubb (https://kubb.dev/).
9845
+ * Do not edit manually.
9846
+ */
9847
+ /**
9848
+ * @description The status fields every heartbeat carries, so a custom heartbeat\'s health reads like a\nbuilt-in one\'s.
9849
+ */
9850
+ const CustomHeartbeatStatusSchema = object({
9851
+ get "collectionIssues"() {
9852
+ return array(HeartbeatCollectionIssueSchema);
9853
+ },
9854
+ get "health"() {
9855
+ return ObservedHealthSchema;
9856
+ },
9857
+ get "lifecycle"() {
9858
+ return ProviderLifecycleStateSchema;
9859
+ },
9860
+ "message": string().nullish(),
9861
+ "partial": boolean(),
9862
+ "stale": boolean()
9863
+ }).describe("The status fields every heartbeat carries, so a custom heartbeat's health reads like a\nbuilt-in one's.");
9864
+ /**
9865
+ * Generated by Kubb (https://kubb.dev/).
9866
+ * Do not edit manually.
9867
+ */
9868
+ const CustomHeartbeatDataSchema = object({
9869
+ "details": optional(object({}).catchall(lazy(() => ValueSchema)).describe("Type-specific fields the extension's controller reports, which Alien does not read.")),
9870
+ get "status"() {
9871
+ return CustomHeartbeatStatusSchema.describe("The status fields every heartbeat carries, so a custom heartbeat's health reads like a\nbuilt-in one's.");
9872
+ }
9873
+ });
9874
+ object({
9875
+ get "data"() {
9876
+ return CustomHeartbeatDataSchema;
9877
+ },
9878
+ get "resourceType"() {
9879
+ return CustomResourceTypeSchema.describe("The type of a resource an extension defines, such as `acme/dns-zone`.");
9880
+ }
9881
+ }).describe("The heartbeat of a resource whose type an extension defines.");
9882
+ /**
9883
+ * Generated by Kubb (https://kubb.dev/).
9884
+ * Do not edit manually.
9885
+ */
9886
+ /**
9810
9887
  * @description Whether matching operations run without approval.
9811
9888
  */
9812
9889
  const OperationApprovalDecisionSchema = _enum(["auto", "manual"]).describe("Whether matching operations run without approval.");
@@ -10462,6 +10539,104 @@ union([
10462
10539
  * Do not edit manually.
10463
10540
  */
10464
10541
  /**
10542
+ * @description What a workload that links a resource of this type gets.\n\nThe extension computes a link\'s environment variables from the resource\'s outputs, and\ndeclares their names here, so a release can see two links that set the same variable. The\npermission sets are fixed per type, because setup grants them before the resource has outputs.
10543
+ */
10544
+ const LinkDescriptorSchema = object({
10545
+ "env": optional(array(string()).describe("Names of the environment variables the workload gets. A link that sets any other name\nfails the deployment.")),
10546
+ "permissionSets": array(string()).describe("Ids of the permission sets the workload gets on the linked resource.")
10547
+ }).describe("What a workload that links a resource of this type gets.\n\nThe extension computes a link's environment variables from the resource's outputs, and\ndeclares their names here, so a release can see two links that set the same variable. The\npermission sets are fixed per type, because setup grants them before the resource has outputs.");
10548
+ /**
10549
+ * Generated by Kubb (https://kubb.dev/).
10550
+ * Do not edit manually.
10551
+ */
10552
+ /**
10553
+ * @description Where a resource\'s private network endpoints are, in terms deployment can resolve to an\naddress range before the resource itself exists.
10554
+ */
10555
+ const PrivateEndpointPlacementSchema = _enum(["stackNetwork"]).describe("Where a resource's private network endpoints are, in terms deployment can resolve to an\naddress range before the resource itself exists.");
10556
+ /**
10557
+ * Generated by Kubb (https://kubb.dev/).
10558
+ * Do not edit manually.
10559
+ */
10560
+ /**
10561
+ * @description The JSON schemas of a resource type\'s config and outputs.
10562
+ */
10563
+ const ResourceTypeSchemasSchema = object({
10564
+ "config": object({}).catchall(any()).describe("The schema of the resource's config."),
10565
+ "outputs": object({}).catchall(any()).describe("The schema of the resource's outputs.")
10566
+ }).describe("The JSON schemas of a resource type's config and outputs.");
10567
+ /**
10568
+ * Generated by Kubb (https://kubb.dev/).
10569
+ * Do not edit manually.
10570
+ */
10571
+ /**
10572
+ * @description The platforms each setup path supports for one resource type.
10573
+ */
10574
+ const SetupSupportSchema = object({
10575
+ get "cloudformation"() {
10576
+ return array(PlatformSchema.describe("Represents the target cloud platform.")).describe("Platforms with a CloudFormation emitter.");
10577
+ },
10578
+ get "helm"() {
10579
+ return array(PlatformSchema.describe("Represents the target cloud platform.")).describe("Platforms with a Helm emitter.");
10580
+ },
10581
+ get "importers"() {
10582
+ return array(PlatformSchema.describe("Represents the target cloud platform.")).describe("Platforms with an importer, which reads a resource a setup template created.");
10583
+ },
10584
+ get "terraform"() {
10585
+ return array(PlatformSchema.describe("Represents the target cloud platform.")).describe("Platforms with a Terraform emitter.");
10586
+ }
10587
+ }).describe("The platforms each setup path supports for one resource type.");
10588
+ /**
10589
+ * Generated by Kubb (https://kubb.dev/).
10590
+ * Do not edit manually.
10591
+ */
10592
+ /**
10593
+ * @description What Alien knows about a resource type an extension defines.
10594
+ */
10595
+ const ResourceTypeDescriptorSchema = object({
10596
+ get "controllerPlatforms"() {
10597
+ return array(PlatformSchema.describe("Represents the target cloud platform.")).describe("The platforms the extension ships a controller for this type on.");
10598
+ },
10599
+ "holdsData": boolean().describe("Whether deleting the resource can lose the customer's data. Removing a deployment keeps\nsuch a resource unless the deletion erases data."),
10600
+ get "lifecycles"() {
10601
+ return array(ResourceLifecycleSchema.describe("Describes the lifecycle of a resource within a stack, determining how it's managed and deployed.")).describe("The lifecycles a resource of this type may have.");
10602
+ },
10603
+ get "link"() {
10604
+ return LinkDescriptorSchema.describe("What a workload that links a resource of this type gets.\n\nThe extension computes a link's environment variables from the resource's outputs, and\ndeclares their names here, so a release can see two links that set the same variable. The\npermission sets are fixed per type, because setup grants them before the resource has outputs.");
10605
+ },
10606
+ get "permissionSets"() {
10607
+ return array(PermissionSetSchema.describe("A permission set that can be applied across different cloud platforms")).describe("The permission sets the extension defines for this type. Their ids are\n`<extension>/<type>/<name>`.");
10608
+ },
10609
+ get "privateNetworkEndpoints"() {
10610
+ return union([PrivateEndpointPlacementSchema, _null()]).optional();
10611
+ },
10612
+ "requiresNetwork": optional(boolean().describe("Whether the type needs the stack's network. Alien then creates the network on AWS, GCP\nand Azure.")),
10613
+ get "schemas"() {
10614
+ return ResourceTypeSchemasSchema.describe("The JSON schemas of a resource type's config and outputs.");
10615
+ },
10616
+ "services": optional(object({}).catchall(array(string())).describe("The cloud services the type needs enabled, per platform: GCP APIs such as\n\"dns.googleapis.com\", Azure resource providers such as \"Microsoft.Network\". Alien enables\nthem with the services its own resource types need.")),
10617
+ get "setup"() {
10618
+ return SetupSupportSchema.describe("The platforms each setup path supports for one resource type.");
10619
+ }
10620
+ }).describe("What Alien knows about a resource type an extension defines.");
10621
+ /**
10622
+ * Generated by Kubb (https://kubb.dev/).
10623
+ * Do not edit manually.
10624
+ */
10625
+ /**
10626
+ * @description An extension a stack uses, and the resource types it defines.
10627
+ */
10628
+ const ExtensionManifestSchema = object({
10629
+ "digest": string().describe("The sha256 digest of the extension's bundle. Every loader checks the bundle against it."),
10630
+ "egress": optional(array(string()).describe("The origins (`https://host[:port]`) the extension's controllers may call besides its\ncloud, as its bundle declares them. The setup template shows them to the customer.")),
10631
+ "name": string().describe("The extension's name, the first part of each type it defines, such as \"acme\"."),
10632
+ "resourceTypes": object({}).catchall(lazy(() => ResourceTypeDescriptorSchema).describe("What Alien knows about a resource type an extension defines.")).describe("The resource types the extension defines, keyed by type name, such as \"acme/dns-zone\"."),
10633
+ "version": string().describe("The extension's version.")
10634
+ }).describe("An extension a stack uses, and the resource types it defines.");
10635
+ /**
10636
+ * Generated by Kubb (https://kubb.dev/).
10637
+ * Do not edit manually.
10638
+ */
10639
+ /**
10465
10640
  * @description External AI provider binding configuration (BYO-key).\n\nThe operator-supplied secret rides inside the binding via\n`BindingValue<String>`, so it is a literal on cloud platforms and gains\nKubernetes SecretRef resolution for free (`extract_binding_secrets` walks\nthe binding JSON for `secretRef`).
10466
10641
  */
10467
10642
  const ExternalAiBindingSchema = object({
@@ -10475,6 +10650,14 @@ const ExternalAiBindingSchema = object({
10475
10650
  * Do not edit manually.
10476
10651
  */
10477
10652
  /**
10653
+ * @description What an installer supplies for an AI resource with an external binding.\n\nTwo inputs, told apart by whether the JSON carries a `service` tag (other than `external-ai`):\n- `{ \"provider\", \"apiKey\" }` — BYO key (the original input; stored deployments and Helm values\n carry it, so it parses exactly as before). `{ \"service\": \"external-ai\", \"provider\",\n \"apiKey\" }` also parses, as it did before the cloud-identity form existed.\n- `{ \"service\": \"bedrock\", \"region\" }` — the cloud\'s own AI service, called with the workload\'s\n ambient identity (for example an EKS pod\'s IRSA role). No key, no Secret.\n\nThe cloud-identity form needs the pod to have its own AWS identity: on Kubernetes, an IRSA role\non the service account (or an EKS Pod Identity association) with `bedrock:InvokeModel` and\n`bedrock:InvokeModelWithResponseStream`. Without one the gateway refuses to sign and never uses\nthe node\'s role. The `region` must be a plain AWS region name such as `us-east-1`.\n\nAccess is not checked at install time (the setup credentials cannot speak for the pod\'s role):\nit is checked on the first call, and a model the role cannot use fails with\n`provider_access_unavailable`.\n\nUntagged, because the BYO-key input has no tag and must keep parsing unchanged. The two shapes\ncannot overlap: the ambient one requires `service`, the key one requires `provider` and `apiKey`.\n`Deserialize` is hand-written (see below) so a typo gets an error naming both accepted forms, and\nso an ambient input carrying an unused key such as `apiKey` is refused instead of dropped.
10654
+ */
10655
+ const ExternalAiSchema = union([lazy(() => AmbientAiBindingSchema), lazy(() => ExternalAiBindingSchema)]).describe("What an installer supplies for an AI resource with an external binding.\n\nTwo inputs, told apart by whether the JSON carries a `service` tag (other than `external-ai`):\n- `{ \"provider\", \"apiKey\" }` — BYO key (the original input; stored deployments and Helm values\n carry it, so it parses exactly as before). `{ \"service\": \"external-ai\", \"provider\",\n \"apiKey\" }` also parses, as it did before the cloud-identity form existed.\n- `{ \"service\": \"bedrock\", \"region\" }` — the cloud's own AI service, called with the workload's\n ambient identity (for example an EKS pod's IRSA role). No key, no Secret.\n\nThe cloud-identity form needs the pod to have its own AWS identity: on Kubernetes, an IRSA role\non the service account (or an EKS Pod Identity association) with `bedrock:InvokeModel` and\n`bedrock:InvokeModelWithResponseStream`. Without one the gateway refuses to sign and never uses\nthe node's role. The `region` must be a plain AWS region name such as `us-east-1`.\n\nAccess is not checked at install time (the setup credentials cannot speak for the pod's role):\nit is checked on the first call, and a model the role cannot use fails with\n`provider_access_unavailable`.\n\nUntagged, because the BYO-key input has no tag and must keep parsing unchanged. The two shapes\ncannot overlap: the ambient one requires `service`, the key one requires `provider` and `apiKey`.\n`Deserialize` is hand-written (see below) so a typo gets an error naming both accepted forms, and\nso an ambient input carrying an unused key such as `apiKey` is refused instead of dropped.");
10656
+ /**
10657
+ * Generated by Kubb (https://kubb.dev/).
10658
+ * Do not edit manually.
10659
+ */
10660
+ /**
10478
10661
  * @description GCP Firestore KV binding configuration
10479
10662
  */
10480
10663
  const FirestoreKvBindingSchema = object({
@@ -10969,7 +11152,8 @@ const ExternalBindingSchema = union([
10969
11152
  lazy(() => ContainerAppsEnvironmentBindingSchema).and(object({ "type": _enum(["container_apps_environment"]) })).describe("Binding configuration for a pre-existing Azure Container Apps Environment.\n\nUsed when deploying to an existing environment instead of having Alien provision one.\nThis is useful for shared environments (e.g., test infrastructure) or enterprise\nsetups where environments are managed by a separate team."),
10970
11153
  lazy(() => PostgresBindingSchema).and(object({ "type": _enum(["postgres"]) })).describe("Connection details for a Postgres database, one variant per backend."),
10971
11154
  lazy(() => RedisBindingSchema).and(object({ "type": _enum(["redis"]) })).describe("Connection details for a Redis-compatible server, one variant per backend.\n\nService tags are unique across all binding enums (serde dispatches on\n`service` alone), so the key-value store's `redis` tag is not reused."),
10972
- lazy(() => ExternalAiBindingSchema).and(object({ "type": _enum(["ai"]) })).describe("External AI provider binding configuration (BYO-key).\n\nThe operator-supplied secret rides inside the binding via\n`BindingValue<String>`, so it is a literal on cloud platforms and gains\nKubernetes SecretRef resolution for free (`extract_binding_secrets` walks\nthe binding JSON for `secretRef`).")
11155
+ lazy(() => ExternalAiSchema).and(object({ "type": _enum(["ai"]) })).describe("What an installer supplies for an AI resource with an external binding.\n\nTwo inputs, told apart by whether the JSON carries a `service` tag (other than `external-ai`):\n- `{ \"provider\", \"apiKey\" }` — BYO key (the original input; stored deployments and Helm values\n carry it, so it parses exactly as before). `{ \"service\": \"external-ai\", \"provider\",\n \"apiKey\" }` also parses, as it did before the cloud-identity form existed.\n- `{ \"service\": \"bedrock\", \"region\" }` — the cloud's own AI service, called with the workload's\n ambient identity (for example an EKS pod's IRSA role). No key, no Secret.\n\nThe cloud-identity form needs the pod to have its own AWS identity: on Kubernetes, an IRSA role\non the service account (or an EKS Pod Identity association) with `bedrock:InvokeModel` and\n`bedrock:InvokeModelWithResponseStream`. Without one the gateway refuses to sign and never uses\nthe node's role. The `region` must be a plain AWS region name such as `us-east-1`.\n\nAccess is not checked at install time (the setup credentials cannot speak for the pod's role):\nit is checked on the first call, and a model the role cannot use fails with\n`provider_access_unavailable`.\n\nUntagged, because the BYO-key input has no tag and must keep parsing unchanged. The two shapes\ncannot overlap: the ambient one requires `service`, the key one requires `provider` and `apiKey`.\n`Deserialize` is hand-written (see below) so a typo gets an error naming both accepted forms, and\nso an ambient input carrying an unused key such as `apiKey` is refused instead of dropped."),
11156
+ lazy(() => CustomExternalBindingSchema)
10973
11157
  ]).describe("Represents a binding to pre-existing infrastructure.\n\nThe binding type must match the resource type it's applied to.\nValidated at runtime by the executor.");
10974
11158
  /**
10975
11159
  * Generated by Kubb (https://kubb.dev/).
@@ -12377,6 +12561,19 @@ const QueueBatchConfigSchema = object({
12377
12561
  * Generated by Kubb (https://kubb.dev/).
12378
12562
  * Do not edit manually.
12379
12563
  */
12564
+ /**
12565
+ * @description Where a Queue moves messages that keep failing.\n\nThe target is a normal Queue in the same stack with the same lifecycle. The attempt count is\napproximate: it is the cloud\'s own delivery count (SQS counts every receive, Pub/Sub is\nbest-effort). The payload is preserved; there is no portable failure reason.
12566
+ */
12567
+ const QueueDeadLetterSchema = object({
12568
+ "maxAttempts": optional(int().min(5).max(100).default(5).describe("Deliveries after which the message moves (5 to 100, default 5).")),
12569
+ get "queue"() {
12570
+ return ResourceRefSchema.describe("Reference to a resource by its stable id and resource type.");
12571
+ }
12572
+ }).describe("Where a Queue moves messages that keep failing.\n\nThe target is a normal Queue in the same stack with the same lifecycle. The attempt count is\napproximate: it is the cloud's own delivery count (SQS counts every receive, Pub/Sub is\nbest-effort). The payload is preserved; there is no portable failure reason.");
12573
+ /**
12574
+ * Generated by Kubb (https://kubb.dev/).
12575
+ * Do not edit manually.
12576
+ */
12380
12577
  const QueueHeartbeatDataSchema = union([
12381
12578
  lazy(() => AwsSqsQueueHeartbeatDataSchema).and(object({ "backend": _enum(["awsSqs"]) })),
12382
12579
  lazy(() => GcpPubSubQueueHeartbeatDataSchema).and(object({ "backend": _enum(["gcpPubSub"]) })),
@@ -12398,7 +12595,12 @@ object({
12398
12595
  "identifier": string().describe("Platform-specific identifier or URL (e.g., SQS URL, Pub/Sub topic/subscription).").nullish(),
12399
12596
  "queueName": string().describe("The name of the queue (platform-specific physical name).")
12400
12597
  }).describe("Outputs generated by a successfully provisioned Queue.");
12401
- object({ "id": string().describe("Identifier for the queue. Must contain only alphanumeric characters, hyphens, and underscores ([A-Za-z0-9-_]).\nMaximum 64 characters.") }).describe("Represents a message queue resource with minimal, portable semantics.\nQueue integrates with platform-native services (AWS SQS, GCP Pub/Sub, Azure Service Bus).");
12598
+ object({
12599
+ get "deadLetter"() {
12600
+ return union([QueueDeadLetterSchema, _null()]).optional();
12601
+ },
12602
+ "id": string().describe("Identifier for the queue. Must contain only alphanumeric characters, hyphens, and underscores ([A-Za-z0-9-_]).\nMaximum 64 characters.")
12603
+ }).describe("Represents a message queue resource with minimal, portable semantics.\nQueue integrates with platform-native services (AWS SQS, GCP Pub/Sub, Azure Service Bus).");
12402
12604
  /**
12403
12605
  * Generated by Kubb (https://kubb.dev/).
12404
12606
  * Do not edit manually.
@@ -12738,6 +12940,14 @@ const ResourceHeartbeatDataSchema = union([
12738
12940
  return SandboxHeartbeatDataSchema.describe("Content-free telemetry about what a sandbox resource is running.\n\nNever anything from inside a sandbox. A controller reaches only the cloud's management APIs,\nand the whole point of the resource is that the control plane cannot see what runs in it.");
12739
12941
  },
12740
12942
  "resourceType": _enum(["sandbox"])
12943
+ }),
12944
+ object({
12945
+ get "data"() {
12946
+ return CustomHeartbeatDataSchema;
12947
+ },
12948
+ get "resourceType"() {
12949
+ return CustomResourceTypeSchema.describe("The type of a resource an extension defines, such as `acme/dns-zone`.");
12950
+ }
12741
12951
  })
12742
12952
  ]);
12743
12953
  object({
@@ -12826,11 +13036,68 @@ const SandboxEgressSchema = union([union([
12826
13036
  * Do not edit manually.
12827
13037
  */
12828
13038
  /**
13039
+ * @description A private service the image\'s own sockets may reach without the gateway.
13040
+ */
13041
+ const SandboxImageConnectionSchema = object({
13042
+ "port": int().min(0).describe("TCP port. Never 53."),
13043
+ get "to"() {
13044
+ return ResourceRefSchema.describe("Reference to a resource by its stable id and resource type.");
13045
+ }
13046
+ }).describe("A private service the image's own sockets may reach without the gateway.");
13047
+ /**
13048
+ * Generated by Kubb (https://kubb.dev/).
13049
+ * Do not edit manually.
13050
+ */
13051
+ /**
13052
+ * @description A file system type an image may ask the agent to mount.
13053
+ */
13054
+ const SandboxImageMountTypeSchema = _enum([
13055
+ "nfs",
13056
+ "tmpfs",
13057
+ "bind"
13058
+ ]).describe("A file system type an image may ask the agent to mount.");
13059
+ /**
13060
+ * Generated by Kubb (https://kubb.dev/).
13061
+ * Do not edit manually.
13062
+ */
13063
+ /**
13064
+ * @description One mount an image may ask for.
13065
+ */
13066
+ const SandboxImageMountSchema = object({
13067
+ "from": string().describe("Source of a bind mount: the path of a declared `tmpfs` mount. The\nbind's own path must be inside a declared `nfs` mount. Required for bind and refused for\nother types.").nullish(),
13068
+ "path": string().describe("Absolute, normalized path the mount is placed at. It may not be or contain a system path\n(`/`, `/opt/alien`, `/proc`, `/sys`, `/dev`, `/run`, `/etc`, `/usr`, `/bin`, `/sbin`,\n`/boot`, `/lib*`)."),
13069
+ "size": string().describe("Size of a tmpfs, as a whole quantity such as `8Gi` or `512Mi`. Required for tmpfs and\nrefused for other types.").nullish(),
13070
+ get "type"() {
13071
+ return SandboxImageMountTypeSchema.describe("A file system type an image may ask the agent to mount.");
13072
+ }
13073
+ }).describe("One mount an image may ask for.");
13074
+ /**
13075
+ * Generated by Kubb (https://kubb.dev/).
13076
+ * Do not edit manually.
13077
+ */
13078
+ /**
13079
+ * @description What a sandbox\'s image may do beyond the default root image grant.\n\nConnections bypass the deployment gateway and its connection log, and isolation between the\nworkloads inside the image stays the image\'s responsibility; setup says both to the customer.
13080
+ */
13081
+ const SandboxImagePermissionsSchema = object({
13082
+ get "connections"() {
13083
+ return array(SandboxImageConnectionSchema.describe("A private service the image's own sockets may reach without the gateway.")).describe("Private services the image's sockets may reach directly.").optional();
13084
+ },
13085
+ get "mounts"() {
13086
+ return array(SandboxImageMountSchema.describe("One mount an image may ask for.")).describe("Mounts the image may ask the agent for.").optional();
13087
+ }
13088
+ }).describe("What a sandbox's image may do beyond the default root image grant.\n\nConnections bypass the deployment gateway and its connection log, and isolation between the\nworkloads inside the image stays the image's responsibility; setup says both to the customer.");
13089
+ /**
13090
+ * Generated by Kubb (https://kubb.dev/).
13091
+ * Do not edit manually.
13092
+ */
13093
+ /**
12829
13094
  * @description How long a sandbox may live and when it is paused.\n\nDeclaration-time ceilings, not per-request values: every sandbox created through this\ndeclaration\'s binding is held to them, whatever a caller asks for at runtime.
12830
13095
  */
12831
13096
  const SandboxLifecyclePolicySchema = object({
12832
13097
  "idlePauseSeconds": int().min(0).describe("Idle period after which the sandbox is paused, where the platform supports it.\n\nStored state written before the rename calls this `idleSuspendSeconds`.").nullish(),
12833
- "maxLifetimeSeconds": int().min(0).describe("Wall-clock ceiling on a single sandbox, after which the platform terminates it.\n\nOptional because not every backend has the primitive: Kubernetes has\n`activeDeadlineSeconds` and AWS `maximumDurationInSeconds`, while neither Azure nor Local\nexpose one, so declaring a ceiling there is refused at plan time rather than accepted and\nnever applied. AWS caps it at 8 hours.").nullish()
13098
+ "maxLifetimeSeconds": int().min(0).describe("Wall-clock ceiling on a single sandbox, after which the platform terminates it.\n\nOptional because not every backend has the primitive: Kubernetes has\n`activeDeadlineSeconds` and AWS `maximumDurationInSeconds`, while neither Azure nor Local\nexpose one, so declaring a ceiling there is refused at plan time rather than accepted and\nnever applied. AWS caps it at 8 hours.").nullish(),
13099
+ "onPause": array(string()).describe("A program the agent runs inside the image, with the image's own grant, before the\nplatform pauses the sandbox with its memory kept. Killed by process group at a deadline.\nBest effort: the image must also survive a stop with no warning. The program must be one\nof the image's own files, not on a declared image-permissions mount. AWS only.").nullish(),
13100
+ "onResume": array(string()).describe("A program the agent runs inside the image after such a pause resumes. Best effort, with a\ndeadline. The same rule for the program applies. AWS only.").nullish()
12834
13101
  }).describe("How long a sandbox may live and when it is paused.\n\nDeclaration-time ceilings, not per-request values: every sandbox created through this\ndeclaration's binding is held to them, whatever a caller asks for at runtime.");
12835
13102
  /**
12836
13103
  * Generated by Kubb (https://kubb.dev/).
@@ -12869,6 +13136,9 @@ object({
12869
13136
  return SandboxEgressSchema.describe("Outbound network policy");
12870
13137
  },
12871
13138
  "id": string().describe("Identifier for the sandbox. Must be DNS-compatible: lowercase letters, digits and hyphens,\nstarting and ending with a letter or digit, with no consecutive hyphens."),
13139
+ get "imagePermissions"() {
13140
+ return union([SandboxImagePermissionsSchema, _null()]).optional();
13141
+ },
12872
13142
  get "lifecycle"() {
12873
13143
  return SandboxLifecyclePolicySchema.describe("How long a sandbox may live and when it is paused.\n\nDeclaration-time ceilings, not per-request values: every sandbox created through this\ndeclaration's binding is held to them, whatever a caller asks for at runtime.");
12874
13144
  },
@@ -12887,6 +13157,7 @@ object({
12887
13157
  "resourceId": string().describe("The platform-specific resource name/ID\n- AWS: Role name\n- GCP: Service Account unique ID\n- Azure: Managed Identity resource ID")
12888
13158
  }).describe("Outputs generated by a successfully provisioned ServiceAccount.");
12889
13159
  object({
13160
+ "extension": string().describe("The extension whose controllers run as this identity. No workload may assume it: on a\ncloud Alien's manager does, the way it assumes the remote bindings identity, and on\nKubernetes the Operator's pod does, the way it assumes the management identity.").nullish(),
12890
13161
  "id": string().describe("Identifier for the service account. Must contain only alphanumeric characters, hyphens, and underscores ([A-Za-z0-9-_]).\nMaximum 64 characters."),
12891
13162
  "resourcePermissionSets": optional(object({}).catchall(array(lazy(() => PermissionSetSchema).describe("A permission set that can be applied across different cloud platforms"))).describe("Resolved grants for concrete resource IDs, captured for setup comparison.")),
12892
13163
  get "stackPermissionSets"() {
@@ -13171,8 +13442,12 @@ const StackInputDefinitionSchema = object({
13171
13442
  }).describe("Stack input definition serialized into a release stack.");
13172
13443
  union([object({ "external": string().describe("Reference to another stack by ID") }), _enum(["current"])]).describe("Reference to a stack for management permissions");
13173
13444
  object({
13445
+ "builtArchitectures": optional(object({}).catchall(array(lazy(() => ArchitectureSchema).describe("CPU architecture."))).describe("Set by `alien build` for a Kubernetes stack: the CPU architectures of the image\nbuilt for each Container, Daemon and Worker, by resource id (more than one means a\nmulti-architecture image). Pods of a single-architecture image are placed on\nmatching nodes. A resource with no entry was not recorded (a prebuilt image or an\nolder release), so no architecture is selected. Build output replaces any value\nwritten in the stack definition.\n\nKept on the stack, not on the resources: older managers and Operators read every\nresource strictly and refuse a field they do not know, but ignore an unknown\nstack-level field.")),
13174
13446
  "dynamicContainerImageResources": optional(array(string()).describe("Released Container resources whose image repositories are approved for\ncontainers created after installation.")),
13175
13447
  "dynamicContainerRepositories": optional(array(string()).describe("Exact image repositories approved for containers created after installation.\nThe runtime API also requires an immutable SHA-256 digest.")),
13448
+ get "extensions"() {
13449
+ return array(ExtensionManifestSchema.describe("An extension a stack uses, and the resource types it defines.")).describe("Extensions whose resource types this stack may use, in the order the stack lists them.").optional();
13450
+ },
13176
13451
  "id": string().describe("Unique identifier for the stack"),
13177
13452
  get "inputs"() {
13178
13453
  return array(StackInputDefinitionSchema.describe("Stack input definition serialized into a release stack.")).describe("Input definitions required before setup or deployment can proceed.").optional();
@@ -13994,6 +14269,14 @@ defineError({
13994
14269
  internal: false,
13995
14270
  httpStatusCode: 400
13996
14271
  });
14272
+ defineError({
14273
+ code: "INVALID_RESOURCE_TYPE",
14274
+ context: object({ type: string() }),
14275
+ message: ({ type }) => `Resource type '${type}' must be named '<extension>/<type>', such as 'acme/dns-zone'; the extension names 'alien' and 'experimental' are reserved`,
14276
+ retryable: false,
14277
+ internal: false,
14278
+ httpStatusCode: 400
14279
+ });
13997
14280
  defineError({
13998
14281
  code: "INVALID_INPUT_CONDITION",
13999
14282
  context: object({
@@ -14006,6 +14289,14 @@ defineError({
14006
14289
  internal: false,
14007
14290
  httpStatusCode: 400
14008
14291
  });
14292
+ defineError({
14293
+ code: "INVALID_QUEUE_DEAD_LETTER",
14294
+ context: object({ reason: string() }),
14295
+ message: ({ reason }) => `Invalid queue dead-letter setting: ${reason}`,
14296
+ retryable: false,
14297
+ internal: false,
14298
+ httpStatusCode: 400
14299
+ });
14009
14300
  defineError({
14010
14301
  code: "INVALID_STORAGE_NOTIFICATION",
14011
14302
  context: object({ reason: string() }),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@alienplatform/sdk",
3
- "version": "3.3.68",
3
+ "version": "3.3.70",
4
4
  "type": "module",
5
5
  "files": [
6
6
  "dist"
@@ -57,9 +57,9 @@
57
57
  "nice-grpc": "^2.1.11",
58
58
  "nice-grpc-common": "^2.0.2",
59
59
  "zod": "^4.5.2",
60
- "@alienplatform/ai-gateway": "^3.3.68",
61
- "@alienplatform/bindings": "^3.3.68",
62
- "@alienplatform/core": "^3.3.68"
60
+ "@alienplatform/ai-gateway": "^3.3.70",
61
+ "@alienplatform/bindings": "^3.3.70",
62
+ "@alienplatform/core": "^3.3.70"
63
63
  },
64
64
  "scripts": {
65
65
  "build": "tsdown && tsc --emitDeclarationOnly",