@fractal_cloud/sdk 1.3.0 → 1.3.1

package/README.md

@@ -253,6 +253,26 @@ src/
       network_and_compute/paas/   # AWS (ECS, EKS), Azure (AKS, Container Apps, Container Instance), GCP (GKE, Cloud Run), OCI (Container Instance)
 ```
 
+## Debug logging
+
+Set `FRACTAL_DEBUG=true` to log every outbound HTTP request and every inbound response to stdout. This covers all API calls made by `fractal.deploy()`, `liveSystem.deploy()`, `fractal.destroy()`, and `liveSystem.destroy()`.
+
+```
+[2026-03-11T14:23:00Z] DEBUG → GET https://api.fractal.cloud/livesystems/my-ls
+[2026-03-11T14:23:00Z] DEBUG ← 404 GET https://api.fractal.cloud/livesystems/my-ls  body=null
+[2026-03-11T14:23:00Z] DEBUG → POST https://api.fractal.cloud/livesystems  body={"liveSystemId":"..."}
+[2026-03-11T14:23:00Z] DEBUG ← 201 POST https://api.fractal.cloud/livesystems  body=null
+```
+
+- Authentication headers (`X-ClientID`, `X-ClientSecret`) are never logged.
+- Request and response bodies are truncated to 2 000 characters.
+- Both success and error responses are logged.
+- Works in all deploy modes (`fire-and-forget` and `wait`).
+
+```bash
+FRACTAL_DEBUG=true node build/src/index.js
+```
+
 ## Contributing and feedback
 
 Contributions and feedback are welcome.

package/dist/index.cjs

@@ -1167,6 +1167,60 @@ let BlueprintComponent;
 	_BlueprintComponent.getBuilder = getBlueprintComponentBuilder;
 })(BlueprintComponent || (BlueprintComponent = {}));
 
+//#endregion
+//#region src/debug.ts
+/**
+* Debug logging for Fractal Cloud SDK HTTP calls.
+*
+* Enabled by setting the FRACTAL_DEBUG environment variable to "true".
+* When enabled, every outbound API request and every inbound response
+* (including error responses) is printed to stdout in the format:
+*
+*   [ISO-8601] DEBUG → METHOD URL [label]  body=<json>
+*   [ISO-8601] DEBUG ← STATUS METHOD URL [label]  body=<json>
+*
+* Authentication headers are never logged.
+* If the request body cannot be serialised to JSON (e.g. circular reference),
+* a <non-serialisable> marker is logged instead of crashing.
+*/
+const isEnabled = () => process.env["FRACTAL_DEBUG"]?.toLowerCase() === "true";
+const trySerialise = (value) => {
+	try {
+		return JSON.stringify(value);
+	} catch {
+		return "<non-serialisable>";
+	}
+};
+/**
+* Logs an outbound HTTP request when debug mode is active.
+* @param method  HTTP method in uppercase, e.g. "GET"
+* @param url     Full request URL
+* @param body    Optional request body (JSON-serialised; not truncated)
+* @param label   Optional context label shown in brackets, e.g. "existence check"
+*/
+const debugRequest = (method, url, body, label) => {
+	if (!isEnabled()) return;
+	const ts = (/* @__PURE__ */ new Date()).toISOString();
+	const labelStr = label ? ` [${label}]` : "";
+	const bodyStr = body !== void 0 ? `  body=${trySerialise(body)}` : "";
+	console.log(`[${ts}] DEBUG → ${method} ${url}${labelStr}${bodyStr}`);
+};
+/**
+* Logs an inbound HTTP response (or error response) when debug mode is active.
+* @param method  HTTP method of the originating request
+* @param url     Full request URL
+* @param status  HTTP status code received
+* @param body    Optional response body (JSON-serialised; not truncated)
+* @param label   Optional context label shown in brackets
+*/
+const debugResponse = (method, url, status, body, label) => {
+	if (!isEnabled()) return;
+	const ts = (/* @__PURE__ */ new Date()).toISOString();
+	const labelStr = label ? ` [${label}]` : "";
+	const bodyStr = body !== void 0 ? `  body=${trySerialise(body)}` : "";
+	console.log(`[${ts}] DEBUG ← ${status} ${method} ${url}${labelStr}${bodyStr}`);
+};
+
 //#endregion
 //#region src/fractal/service.ts
 const CLIENT_ID_HEADER$1 = "X-ClientID";
@@ -1192,39 +1246,57 @@ const deployFractal = async (credentials, fractal) => {
 	const target = fractal.id.toString();
 	const fractalUrl = `${FRACTAL_API_URL$1}/blueprints/${target.replace(":", "/")}`;
 	let getFractalResponse;
+	debugRequest("GET", fractalUrl, void 0, "existence check");
 	try {
 		getFractalResponse = await superagent.default.get(fractalUrl).ok((res) => res.status === 200 || res.status === 404).set(authHeaders$1(credentials)).send();
+		debugResponse("GET", fractalUrl, getFractalResponse.status, getFractalResponse.body, "existence check");
 	} catch (err) {
+		const e = err;
+		debugResponse("GET", fractalUrl, e.status ?? 0, e.response?.body, "existence check");
 		throw toApiError$1("check fractal existence", target, err);
 	}
+	const method = getFractalResponse.status === 200 ? "PUT" : "POST";
 	const request = getFractalResponse.status === 200 ? superagent.default.put(fractalUrl) : superagent.default.post(fractalUrl);
+	const body = {
+		description: fractal.description,
+		isPrivate: fractal.isPrivate,
+		components: fractal.components.map((c) => ({
+			type: c.type.toString(),
+			id: c.id.value.toString(),
+			version: c.version.toString(),
+			displayName: c.displayName,
+			description: c.description,
+			parameters: c.parameters.toMap(),
+			dependencies: c.dependencies.map((d) => d.id.value.toString()),
+			links: c.links.map((l) => ({
+				componentId: l.id.value.toString(),
+				settings: l.parameters.toMap()
+			})),
+			outputFields: Object.keys(c.outputFields.value),
+			isLocked: c.isLocked,
+			recreateOnFailure: c.recreateOnFailure
+		}))
+	};
+	debugRequest(method, fractalUrl, body);
 	try {
-		await request.set(authHeaders$1(credentials)).send({
-			description: fractal.description,
-			isPrivate: fractal.isPrivate,
-			components: fractal.components.map((c) => ({
-				...c,
-				type: c.type.toString(),
-				id: c.id.value.toString(),
-				version: c.version.toString(),
-				parameters: c.parameters.toMap(),
-				dependencies: c.dependencies.map((d) => d.id.value.toString()),
-				links: c.links.map((l) => ({
-					componentId: l.id.value.toString(),
-					settings: l.parameters.toMap()
-				})),
-				outputFields: Object.keys(c.outputFields.value)
-			}))
-		});
+		const response = await request.set(authHeaders$1(credentials)).send(body);
+		debugResponse(method, fractalUrl, response.status, response.body);
 	} catch (err) {
+		const e = err;
+		debugResponse(method, fractalUrl, e.status ?? 0, e.response?.body);
 		throw toApiError$1(getFractalResponse.status === 200 ? "update fractal" : "create fractal", target, err);
 	}
 };
 const destroyFractal = async (credentials, id) => {
 	const target = id.toString();
+	const url = `${FRACTAL_API_URL$1}/blueprints/${target.replace(":", "/")}`;
+	debugRequest("DELETE", url);
 	try {
-		await superagent.default.delete(`${FRACTAL_API_URL$1}/blueprints/${target.replace(":", "/")}`).set(authHeaders$1(credentials));
+		const response = await superagent.default.delete(url).set(authHeaders$1(credentials));
+		debugResponse("DELETE", url, response.status, response.body);
 	} catch (err) {
+		const e = err;
+		debugResponse("DELETE", url, e.status ?? 0, e.response?.body);
 		throw toApiError$1("destroy fractal", target, err);
 	}
 };
@@ -1910,17 +1982,21 @@ const buildBody = (liveSystem) => ({
 	provider: liveSystem.genericProvider,
 	blueprintMap: liveSystem.components.reduce((acc, c) => {
 		acc[c.id.value.toString()] = {
-			...c,
 			type: c.type.toString(),
 			id: c.id.value.toString(),
 			version: c.version.toString(),
+			displayName: c.displayName,
+			description: c.description,
+			provider: c.provider,
 			parameters: c.parameters.toMap(),
 			dependencies: c.dependencies.map((d) => d.id.value.toString()),
 			links: c.links.map((l) => ({
 				componentId: l.id.value.toString(),
 				settings: l.parameters.toMap()
 			})),
-			outputFields: c.outputFields.value
+			outputFields: c.outputFields.value,
+			isLocked: c.isLocked,
+			recreateOnFailure: c.recreateOnFailure
 		};
 		return acc;
 	}, {}),
@@ -1938,22 +2014,39 @@ const submitDeploy = async (credentials, liveSystem) => {
 	const target = liveSystem.id.toString();
 	const liveSystemUrl = `${FRACTAL_API_URL}/livesystems/${target}`;
 	let getResponse;
+	debugRequest("GET", liveSystemUrl, void 0, "existence check");
 	try {
 		getResponse = await superagent.default.get(liveSystemUrl).ok((res) => res.status === 200 || res.status === 404).set(authHeaders(credentials)).send();
+		debugResponse("GET", liveSystemUrl, getResponse.status, getResponse.body, "existence check");
 	} catch (err) {
+		const e = err;
+		debugResponse("GET", liveSystemUrl, e.status ?? 0, e.response?.body, "existence check");
 		throw toApiError("check live system existence", target, err);
 	}
+	const method = getResponse.status === 200 ? "PUT" : "POST";
+	const submitUrl = getResponse.status === 200 ? liveSystemUrl : `${FRACTAL_API_URL}/livesystems`;
 	const request = getResponse.status === 200 ? superagent.default.put(liveSystemUrl) : superagent.default.post(`${FRACTAL_API_URL}/livesystems`);
+	const body = buildBody(liveSystem);
+	debugRequest(method, submitUrl, body);
 	try {
-		await request.set(authHeaders(credentials)).send(buildBody(liveSystem));
+		const response = await request.set(authHeaders(credentials)).send(body);
+		debugResponse(method, submitUrl, response.status, response.body);
 	} catch (err) {
+		const e = err;
+		debugResponse(method, submitUrl, e.status ?? 0, e.response?.body);
 		throw toApiError(getResponse.status === 200 ? "update live system" : "create live system", target, err);
 	}
 };
 const getLiveSystemStatus = async (credentials, id) => {
+	const url = `${FRACTAL_API_URL}/livesystems/${id.toString()}`;
+	debugRequest("GET", url, void 0, "status poll");
 	try {
-		return (await superagent.default.get(`${FRACTAL_API_URL}/livesystems/${id.toString()}`).set(authHeaders(credentials)).send()).body.status;
+		const response = await superagent.default.get(url).set(authHeaders(credentials)).send();
+		debugResponse("GET", url, response.status, response.body, "status poll");
+		return response.body.status;
 	} catch (err) {
+		const e = err;
+		debugResponse("GET", url, e.status ?? 0, e.response?.body, "status poll");
 		throw toApiError("get live system status", id.toString(), err);
 	}
 };
@@ -2035,9 +2128,14 @@ const deployLiveSystem = async (credentials, liveSystem, options = { mode: "fire
 	});
 };
 const destroyLiveSystem = async (credentials, id) => {
+	const url = `${FRACTAL_API_URL}/livesystems/${id.toString()}`;
+	debugRequest("DELETE", url);
 	try {
-		await superagent.default.delete(`${FRACTAL_API_URL}/livesystems/${id.toString()}`).set(authHeaders(credentials));
+		const response = await superagent.default.delete(url).set(authHeaders(credentials));
+		debugResponse("DELETE", url, response.status, response.body);
 	} catch (err) {
+		const e = err;
+		debugResponse("DELETE", url, e.status ?? 0, e.response?.body);
 		throw toApiError("destroy live system", id.toString(), err);
 	}
 };
@@ -2167,6 +2265,7 @@ const getLiveSystemBuilder = () => {
 		},
 		reset: () => {
 			internalState.id = DEFAULT_LIVE_SYSTEM.id;
+			internalState.parameters = DEFAULT_LIVE_SYSTEM.parameters;
 			internalState.requesterId = DEFAULT_LIVE_SYSTEM.requesterId;
 			internalState.fractalId = DEFAULT_LIVE_SYSTEM.fractalId;
 			internalState.description = DEFAULT_LIVE_SYSTEM.description;

package/dist/index.d.cts

@@ -2791,6 +2791,15 @@ declare namespace AwsEcsCluster {
 }
 //#endregion
 //#region src/live_system/component/network_and_compute/paas/ecs_task_definition.d.ts
+/**
+ * Branded live-system component produced by AwsEcsTaskDefinition builders.
+ * The brand prevents passing an arbitrary LiveSystemComponent to
+ * AwsEcsService.withTaskDefinition() — only a value produced by
+ * AwsEcsTaskDefinition.satisfy() or AwsEcsTaskDefinition.create() is accepted.
+ */
+type AwsEcsTaskDefinitionComponent = LiveSystemComponent & {
+  readonly _brand: 'AwsEcsTaskDefinition';
+};
 /**
  * Returned by satisfy() — blueprint params (image, port, cpu, memory) are
  * locked. Only IAM role ARNs and network mode can be added here.
@@ -2802,7 +2811,7 @@ type SatisfiedAwsEcsTaskDefinitionBuilder = {
   withNetworkMode: (mode: string) => SatisfiedAwsEcsTaskDefinitionBuilder;
   withExecutionRoleArn: (arn: string) => SatisfiedAwsEcsTaskDefinitionBuilder;
   withTaskRoleArn: (arn: string) => SatisfiedAwsEcsTaskDefinitionBuilder;
-  build: () => LiveSystemComponent;
+  build: () => AwsEcsTaskDefinitionComponent;
 };
 type AwsEcsTaskDefinitionBuilder = {
   withId: (id: string) => AwsEcsTaskDefinitionBuilder;
@@ -2817,7 +2826,7 @@ type AwsEcsTaskDefinitionBuilder = {
   withNetworkMode: (mode: string) => AwsEcsTaskDefinitionBuilder;
   withExecutionRoleArn: (arn: string) => AwsEcsTaskDefinitionBuilder;
   withTaskRoleArn: (arn: string) => AwsEcsTaskDefinitionBuilder;
-  build: () => LiveSystemComponent;
+  build: () => AwsEcsTaskDefinitionComponent;
 };
 type AwsEcsTaskDefinitionConfig = {
   id: string;
@@ -2845,7 +2854,7 @@ declare namespace AwsEcsTaskDefinition {
    * AwsEcsService that satisfies the same workload.
    */
   const satisfy: (workload: BlueprintComponent) => SatisfiedAwsEcsTaskDefinitionBuilder;
-  const create: (config: AwsEcsTaskDefinitionConfig) => LiveSystemComponent;
+  const create: (config: AwsEcsTaskDefinitionConfig) => AwsEcsTaskDefinitionComponent;
 }
 //#endregion
 //#region src/live_system/component/network_and_compute/paas/ecs_service.d.ts
@@ -2861,8 +2870,11 @@ type SatisfiedAwsEcsServiceBuilder = {
    * Declares a live-system-only dependency on the ECS Task Definition that
    * this service will run. This has no blueprint equivalent — it is an
    * AWS-specific sub-component relationship.
+   *
+   * Only accepts an AwsEcsTaskDefinitionComponent produced by
+   * AwsEcsTaskDefinition.satisfy() or AwsEcsTaskDefinition.create().
    */
-  withTaskDefinition: (taskDef: LiveSystemComponent) => SatisfiedAwsEcsServiceBuilder;
+  withTaskDefinition: (taskDef: AwsEcsTaskDefinitionComponent) => SatisfiedAwsEcsServiceBuilder;
   build: () => LiveSystemComponent;
 };
 type AwsEcsServiceBuilder = {
@@ -3378,4 +3390,4 @@ type Environment = Environment$1;
 declare const LiveSystem: typeof LiveSystem$1;
 type LiveSystem = LiveSystem$1;
 //#endregion
-export { AwsEcsCluster, type AwsEcsClusterBuilder, type AwsEcsClusterConfig, AwsEcsService, type AwsEcsServiceBuilder, type AwsEcsServiceConfig, AwsEcsTaskDefinition, type AwsEcsTaskDefinitionBuilder, type AwsEcsTaskDefinitionConfig, AwsEksCluster, type AwsEksClusterBuilder, type AwsEksClusterConfig, AwsSecurityGroup, type AwsSecurityGroupBuilder, type AwsSecurityGroupConfig, AwsSubnet, type AwsSubnetBuilder, type AwsSubnetConfig, AwsVpc, type AwsVpcBuilder, type AwsVpcConfig, AzureAksCluster, type AzureAksClusterBuilder, type AzureAksClusterConfig, AzureContainerApp, type AzureContainerAppBuilder, type AzureContainerAppConfig, AzureContainerAppsEnvironment, type AzureContainerAppsEnvironmentBuilder, type AzureContainerAppsEnvironmentConfig, AzureContainerInstance, type AzureContainerInstanceBuilder, type AzureContainerInstanceConfig, AzureNsg, type AzureNsgBuilder, type AzureNsgConfig, AzureSubnet, type AzureSubnetBuilder, type AzureSubnetConfig, AzureVm, type AzureVmBuilder, type AzureVmConfig, AzureVnet, type AzureVnetBuilder, type AzureVnetConfig, BoundedContext, ContainerPlatform, type ContainerPlatformBuilder, type ContainerPlatformComponent, type ContainerPlatformConfig, Ec2Instance, type Ec2InstanceBuilder, type Ec2InstanceConfig, Environment, Fractal, GcpCloudRunService, type GcpCloudRunServiceBuilder, type GcpCloudRunServiceConfig, GcpFirewall, type GcpFirewallBuilder, type GcpFirewallConfig, GcpGkeCluster, type GcpGkeClusterBuilder, type GcpGkeClusterConfig, GcpSubnet, type GcpSubnetBuilder, type GcpSubnetConfig, GcpVm, type GcpVmBuilder, type GcpVmConfig, GcpVpc, type GcpVpcBuilder, type GcpVpcConfig, HetznerFirewall, type HetznerFirewallBuilder, type HetznerFirewallConfig, HetznerNetwork, type HetznerNetworkBuilder, type HetznerNetworkConfig, HetznerServer, type HetznerServerBuilder, type HetznerServerConfig, HetznerSubnet, type HetznerSubnetBuilder, type HetznerSubnetConfig, InfrastructureDomain, type IngressRule, KebabCaseString, LiveSystem, OciContainerInstance, type OciContainerInstanceBuilder, type OciContainerInstanceConfig, OciInstance, type OciInstanceBuilder, type OciInstanceConfig, OciSecurityList, type OciSecurityListBuilder, type OciSecurityListConfig, OciSubnet, type OciSubnetBuilder, type OciSubnetConfig, OciVcn, type OciVcnBuilder, type OciVcnConfig, OwnerId, OwnerType, PascalCaseString, type SatisfiedAwsEcsClusterBuilder, type SatisfiedAwsEcsServiceBuilder, type SatisfiedAwsEcsTaskDefinitionBuilder, type SatisfiedAwsEksClusterBuilder, type SatisfiedAwsSecurityGroupBuilder, type SatisfiedAwsSubnetBuilder, type SatisfiedAwsVpcBuilder, type SatisfiedAzureAksClusterBuilder, type SatisfiedAzureContainerAppBuilder, type SatisfiedAzureContainerAppsEnvironmentBuilder, type SatisfiedAzureContainerInstanceBuilder, type SatisfiedAzureNsgBuilder, type SatisfiedAzureSubnetBuilder, type SatisfiedAzureVmBuilder, type SatisfiedAzureVnetBuilder, type SatisfiedEc2Builder, type SatisfiedGcpCloudRunServiceBuilder, type SatisfiedGcpFirewallBuilder, type SatisfiedGcpGkeClusterBuilder, type SatisfiedGcpSubnetBuilder, type SatisfiedGcpVmBuilder, type SatisfiedGcpVpcBuilder, type SatisfiedHetznerFirewallBuilder, type SatisfiedHetznerNetworkBuilder, type SatisfiedHetznerServerBuilder, type SatisfiedHetznerSubnetBuilder, type SatisfiedOciContainerInstanceBuilder, type SatisfiedOciInstanceBuilder, type SatisfiedOciSecurityListBuilder, type SatisfiedOciSubnetBuilder, type SatisfiedOciVcnBuilder, SecurityGroup, type SecurityGroupBuilder, type SecurityGroupComponent, type SecurityGroupConfig, ServiceAccountCredentials, ServiceAccountId, ServiceDeliveryModel, Subnet, type SubnetBuilder, type SubnetComponent, type SubnetConfig, type SubnetResult, Version, VirtualMachine, type VirtualMachineBuilder, type VirtualMachineComponent, type VirtualMachineConfig, VirtualNetwork, type VirtualNetworkBuilder, type VirtualNetworkComponent, type VirtualNetworkConfig, type VirtualNetworkResult, type VmPortLink, Workload, type WorkloadBuilder, type WorkloadComponent, type WorkloadConfig, type WorkloadPortLink };
+export { AwsEcsCluster, type AwsEcsClusterBuilder, type AwsEcsClusterConfig, AwsEcsService, type AwsEcsServiceBuilder, type AwsEcsServiceConfig, AwsEcsTaskDefinition, type AwsEcsTaskDefinitionBuilder, type AwsEcsTaskDefinitionComponent, type AwsEcsTaskDefinitionConfig, AwsEksCluster, type AwsEksClusterBuilder, type AwsEksClusterConfig, AwsSecurityGroup, type AwsSecurityGroupBuilder, type AwsSecurityGroupConfig, AwsSubnet, type AwsSubnetBuilder, type AwsSubnetConfig, AwsVpc, type AwsVpcBuilder, type AwsVpcConfig, AzureAksCluster, type AzureAksClusterBuilder, type AzureAksClusterConfig, AzureContainerApp, type AzureContainerAppBuilder, type AzureContainerAppConfig, AzureContainerAppsEnvironment, type AzureContainerAppsEnvironmentBuilder, type AzureContainerAppsEnvironmentConfig, AzureContainerInstance, type AzureContainerInstanceBuilder, type AzureContainerInstanceConfig, AzureNsg, type AzureNsgBuilder, type AzureNsgConfig, AzureSubnet, type AzureSubnetBuilder, type AzureSubnetConfig, AzureVm, type AzureVmBuilder, type AzureVmConfig, AzureVnet, type AzureVnetBuilder, type AzureVnetConfig, BoundedContext, ContainerPlatform, type ContainerPlatformBuilder, type ContainerPlatformComponent, type ContainerPlatformConfig, Ec2Instance, type Ec2InstanceBuilder, type Ec2InstanceConfig, Environment, Fractal, GcpCloudRunService, type GcpCloudRunServiceBuilder, type GcpCloudRunServiceConfig, GcpFirewall, type GcpFirewallBuilder, type GcpFirewallConfig, GcpGkeCluster, type GcpGkeClusterBuilder, type GcpGkeClusterConfig, GcpSubnet, type GcpSubnetBuilder, type GcpSubnetConfig, GcpVm, type GcpVmBuilder, type GcpVmConfig, GcpVpc, type GcpVpcBuilder, type GcpVpcConfig, HetznerFirewall, type HetznerFirewallBuilder, type HetznerFirewallConfig, HetznerNetwork, type HetznerNetworkBuilder, type HetznerNetworkConfig, HetznerServer, type HetznerServerBuilder, type HetznerServerConfig, HetznerSubnet, type HetznerSubnetBuilder, type HetznerSubnetConfig, InfrastructureDomain, type IngressRule, KebabCaseString, LiveSystem, OciContainerInstance, type OciContainerInstanceBuilder, type OciContainerInstanceConfig, OciInstance, type OciInstanceBuilder, type OciInstanceConfig, OciSecurityList, type OciSecurityListBuilder, type OciSecurityListConfig, OciSubnet, type OciSubnetBuilder, type OciSubnetConfig, OciVcn, type OciVcnBuilder, type OciVcnConfig, OwnerId, OwnerType, PascalCaseString, type SatisfiedAwsEcsClusterBuilder, type SatisfiedAwsEcsServiceBuilder, type SatisfiedAwsEcsTaskDefinitionBuilder, type SatisfiedAwsEksClusterBuilder, type SatisfiedAwsSecurityGroupBuilder, type SatisfiedAwsSubnetBuilder, type SatisfiedAwsVpcBuilder, type SatisfiedAzureAksClusterBuilder, type SatisfiedAzureContainerAppBuilder, type SatisfiedAzureContainerAppsEnvironmentBuilder, type SatisfiedAzureContainerInstanceBuilder, type SatisfiedAzureNsgBuilder, type SatisfiedAzureSubnetBuilder, type SatisfiedAzureVmBuilder, type SatisfiedAzureVnetBuilder, type SatisfiedEc2Builder, type SatisfiedGcpCloudRunServiceBuilder, type SatisfiedGcpFirewallBuilder, type SatisfiedGcpGkeClusterBuilder, type SatisfiedGcpSubnetBuilder, type SatisfiedGcpVmBuilder, type SatisfiedGcpVpcBuilder, type SatisfiedHetznerFirewallBuilder, type SatisfiedHetznerNetworkBuilder, type SatisfiedHetznerServerBuilder, type SatisfiedHetznerSubnetBuilder, type SatisfiedOciContainerInstanceBuilder, type SatisfiedOciInstanceBuilder, type SatisfiedOciSecurityListBuilder, type SatisfiedOciSubnetBuilder, type SatisfiedOciVcnBuilder, SecurityGroup, type SecurityGroupBuilder, type SecurityGroupComponent, type SecurityGroupConfig, ServiceAccountCredentials, ServiceAccountId, ServiceDeliveryModel, Subnet, type SubnetBuilder, type SubnetComponent, type SubnetConfig, type SubnetResult, Version, VirtualMachine, type VirtualMachineBuilder, type VirtualMachineComponent, type VirtualMachineConfig, VirtualNetwork, type VirtualNetworkBuilder, type VirtualNetworkComponent, type VirtualNetworkConfig, type VirtualNetworkResult, type VmPortLink, Workload, type WorkloadBuilder, type WorkloadComponent, type WorkloadConfig, type WorkloadPortLink };

package/dist/index.d.mts

@@ -2791,6 +2791,15 @@ declare namespace AwsEcsCluster {
 }
 //#endregion
 //#region src/live_system/component/network_and_compute/paas/ecs_task_definition.d.ts
+/**
+ * Branded live-system component produced by AwsEcsTaskDefinition builders.
+ * The brand prevents passing an arbitrary LiveSystemComponent to
+ * AwsEcsService.withTaskDefinition() — only a value produced by
+ * AwsEcsTaskDefinition.satisfy() or AwsEcsTaskDefinition.create() is accepted.
+ */
+type AwsEcsTaskDefinitionComponent = LiveSystemComponent & {
+  readonly _brand: 'AwsEcsTaskDefinition';
+};
 /**
  * Returned by satisfy() — blueprint params (image, port, cpu, memory) are
  * locked. Only IAM role ARNs and network mode can be added here.
@@ -2802,7 +2811,7 @@ type SatisfiedAwsEcsTaskDefinitionBuilder = {
   withNetworkMode: (mode: string) => SatisfiedAwsEcsTaskDefinitionBuilder;
   withExecutionRoleArn: (arn: string) => SatisfiedAwsEcsTaskDefinitionBuilder;
   withTaskRoleArn: (arn: string) => SatisfiedAwsEcsTaskDefinitionBuilder;
-  build: () => LiveSystemComponent;
+  build: () => AwsEcsTaskDefinitionComponent;
 };
 type AwsEcsTaskDefinitionBuilder = {
   withId: (id: string) => AwsEcsTaskDefinitionBuilder;
@@ -2817,7 +2826,7 @@ type AwsEcsTaskDefinitionBuilder = {
   withNetworkMode: (mode: string) => AwsEcsTaskDefinitionBuilder;
   withExecutionRoleArn: (arn: string) => AwsEcsTaskDefinitionBuilder;
   withTaskRoleArn: (arn: string) => AwsEcsTaskDefinitionBuilder;
-  build: () => LiveSystemComponent;
+  build: () => AwsEcsTaskDefinitionComponent;
 };
 type AwsEcsTaskDefinitionConfig = {
   id: string;
@@ -2845,7 +2854,7 @@ declare namespace AwsEcsTaskDefinition {
    * AwsEcsService that satisfies the same workload.
    */
   const satisfy: (workload: BlueprintComponent) => SatisfiedAwsEcsTaskDefinitionBuilder;
-  const create: (config: AwsEcsTaskDefinitionConfig) => LiveSystemComponent;
+  const create: (config: AwsEcsTaskDefinitionConfig) => AwsEcsTaskDefinitionComponent;
 }
 //#endregion
 //#region src/live_system/component/network_and_compute/paas/ecs_service.d.ts
@@ -2861,8 +2870,11 @@ type SatisfiedAwsEcsServiceBuilder = {
    * Declares a live-system-only dependency on the ECS Task Definition that
    * this service will run. This has no blueprint equivalent — it is an
    * AWS-specific sub-component relationship.
+   *
+   * Only accepts an AwsEcsTaskDefinitionComponent produced by
+   * AwsEcsTaskDefinition.satisfy() or AwsEcsTaskDefinition.create().
    */
-  withTaskDefinition: (taskDef: LiveSystemComponent) => SatisfiedAwsEcsServiceBuilder;
+  withTaskDefinition: (taskDef: AwsEcsTaskDefinitionComponent) => SatisfiedAwsEcsServiceBuilder;
   build: () => LiveSystemComponent;
 };
 type AwsEcsServiceBuilder = {
@@ -3378,4 +3390,4 @@ type Environment = Environment$1;
 declare const LiveSystem: typeof LiveSystem$1;
 type LiveSystem = LiveSystem$1;
 //#endregion
-export { AwsEcsCluster, type AwsEcsClusterBuilder, type AwsEcsClusterConfig, AwsEcsService, type AwsEcsServiceBuilder, type AwsEcsServiceConfig, AwsEcsTaskDefinition, type AwsEcsTaskDefinitionBuilder, type AwsEcsTaskDefinitionConfig, AwsEksCluster, type AwsEksClusterBuilder, type AwsEksClusterConfig, AwsSecurityGroup, type AwsSecurityGroupBuilder, type AwsSecurityGroupConfig, AwsSubnet, type AwsSubnetBuilder, type AwsSubnetConfig, AwsVpc, type AwsVpcBuilder, type AwsVpcConfig, AzureAksCluster, type AzureAksClusterBuilder, type AzureAksClusterConfig, AzureContainerApp, type AzureContainerAppBuilder, type AzureContainerAppConfig, AzureContainerAppsEnvironment, type AzureContainerAppsEnvironmentBuilder, type AzureContainerAppsEnvironmentConfig, AzureContainerInstance, type AzureContainerInstanceBuilder, type AzureContainerInstanceConfig, AzureNsg, type AzureNsgBuilder, type AzureNsgConfig, AzureSubnet, type AzureSubnetBuilder, type AzureSubnetConfig, AzureVm, type AzureVmBuilder, type AzureVmConfig, AzureVnet, type AzureVnetBuilder, type AzureVnetConfig, BoundedContext, ContainerPlatform, type ContainerPlatformBuilder, type ContainerPlatformComponent, type ContainerPlatformConfig, Ec2Instance, type Ec2InstanceBuilder, type Ec2InstanceConfig, Environment, Fractal, GcpCloudRunService, type GcpCloudRunServiceBuilder, type GcpCloudRunServiceConfig, GcpFirewall, type GcpFirewallBuilder, type GcpFirewallConfig, GcpGkeCluster, type GcpGkeClusterBuilder, type GcpGkeClusterConfig, GcpSubnet, type GcpSubnetBuilder, type GcpSubnetConfig, GcpVm, type GcpVmBuilder, type GcpVmConfig, GcpVpc, type GcpVpcBuilder, type GcpVpcConfig, HetznerFirewall, type HetznerFirewallBuilder, type HetznerFirewallConfig, HetznerNetwork, type HetznerNetworkBuilder, type HetznerNetworkConfig, HetznerServer, type HetznerServerBuilder, type HetznerServerConfig, HetznerSubnet, type HetznerSubnetBuilder, type HetznerSubnetConfig, InfrastructureDomain, type IngressRule, KebabCaseString, LiveSystem, OciContainerInstance, type OciContainerInstanceBuilder, type OciContainerInstanceConfig, OciInstance, type OciInstanceBuilder, type OciInstanceConfig, OciSecurityList, type OciSecurityListBuilder, type OciSecurityListConfig, OciSubnet, type OciSubnetBuilder, type OciSubnetConfig, OciVcn, type OciVcnBuilder, type OciVcnConfig, OwnerId, OwnerType, PascalCaseString, type SatisfiedAwsEcsClusterBuilder, type SatisfiedAwsEcsServiceBuilder, type SatisfiedAwsEcsTaskDefinitionBuilder, type SatisfiedAwsEksClusterBuilder, type SatisfiedAwsSecurityGroupBuilder, type SatisfiedAwsSubnetBuilder, type SatisfiedAwsVpcBuilder, type SatisfiedAzureAksClusterBuilder, type SatisfiedAzureContainerAppBuilder, type SatisfiedAzureContainerAppsEnvironmentBuilder, type SatisfiedAzureContainerInstanceBuilder, type SatisfiedAzureNsgBuilder, type SatisfiedAzureSubnetBuilder, type SatisfiedAzureVmBuilder, type SatisfiedAzureVnetBuilder, type SatisfiedEc2Builder, type SatisfiedGcpCloudRunServiceBuilder, type SatisfiedGcpFirewallBuilder, type SatisfiedGcpGkeClusterBuilder, type SatisfiedGcpSubnetBuilder, type SatisfiedGcpVmBuilder, type SatisfiedGcpVpcBuilder, type SatisfiedHetznerFirewallBuilder, type SatisfiedHetznerNetworkBuilder, type SatisfiedHetznerServerBuilder, type SatisfiedHetznerSubnetBuilder, type SatisfiedOciContainerInstanceBuilder, type SatisfiedOciInstanceBuilder, type SatisfiedOciSecurityListBuilder, type SatisfiedOciSubnetBuilder, type SatisfiedOciVcnBuilder, SecurityGroup, type SecurityGroupBuilder, type SecurityGroupComponent, type SecurityGroupConfig, ServiceAccountCredentials, ServiceAccountId, ServiceDeliveryModel, Subnet, type SubnetBuilder, type SubnetComponent, type SubnetConfig, type SubnetResult, Version, VirtualMachine, type VirtualMachineBuilder, type VirtualMachineComponent, type VirtualMachineConfig, VirtualNetwork, type VirtualNetworkBuilder, type VirtualNetworkComponent, type VirtualNetworkConfig, type VirtualNetworkResult, type VmPortLink, Workload, type WorkloadBuilder, type WorkloadComponent, type WorkloadConfig, type WorkloadPortLink };
+export { AwsEcsCluster, type AwsEcsClusterBuilder, type AwsEcsClusterConfig, AwsEcsService, type AwsEcsServiceBuilder, type AwsEcsServiceConfig, AwsEcsTaskDefinition, type AwsEcsTaskDefinitionBuilder, type AwsEcsTaskDefinitionComponent, type AwsEcsTaskDefinitionConfig, AwsEksCluster, type AwsEksClusterBuilder, type AwsEksClusterConfig, AwsSecurityGroup, type AwsSecurityGroupBuilder, type AwsSecurityGroupConfig, AwsSubnet, type AwsSubnetBuilder, type AwsSubnetConfig, AwsVpc, type AwsVpcBuilder, type AwsVpcConfig, AzureAksCluster, type AzureAksClusterBuilder, type AzureAksClusterConfig, AzureContainerApp, type AzureContainerAppBuilder, type AzureContainerAppConfig, AzureContainerAppsEnvironment, type AzureContainerAppsEnvironmentBuilder, type AzureContainerAppsEnvironmentConfig, AzureContainerInstance, type AzureContainerInstanceBuilder, type AzureContainerInstanceConfig, AzureNsg, type AzureNsgBuilder, type AzureNsgConfig, AzureSubnet, type AzureSubnetBuilder, type AzureSubnetConfig, AzureVm, type AzureVmBuilder, type AzureVmConfig, AzureVnet, type AzureVnetBuilder, type AzureVnetConfig, BoundedContext, ContainerPlatform, type ContainerPlatformBuilder, type ContainerPlatformComponent, type ContainerPlatformConfig, Ec2Instance, type Ec2InstanceBuilder, type Ec2InstanceConfig, Environment, Fractal, GcpCloudRunService, type GcpCloudRunServiceBuilder, type GcpCloudRunServiceConfig, GcpFirewall, type GcpFirewallBuilder, type GcpFirewallConfig, GcpGkeCluster, type GcpGkeClusterBuilder, type GcpGkeClusterConfig, GcpSubnet, type GcpSubnetBuilder, type GcpSubnetConfig, GcpVm, type GcpVmBuilder, type GcpVmConfig, GcpVpc, type GcpVpcBuilder, type GcpVpcConfig, HetznerFirewall, type HetznerFirewallBuilder, type HetznerFirewallConfig, HetznerNetwork, type HetznerNetworkBuilder, type HetznerNetworkConfig, HetznerServer, type HetznerServerBuilder, type HetznerServerConfig, HetznerSubnet, type HetznerSubnetBuilder, type HetznerSubnetConfig, InfrastructureDomain, type IngressRule, KebabCaseString, LiveSystem, OciContainerInstance, type OciContainerInstanceBuilder, type OciContainerInstanceConfig, OciInstance, type OciInstanceBuilder, type OciInstanceConfig, OciSecurityList, type OciSecurityListBuilder, type OciSecurityListConfig, OciSubnet, type OciSubnetBuilder, type OciSubnetConfig, OciVcn, type OciVcnBuilder, type OciVcnConfig, OwnerId, OwnerType, PascalCaseString, type SatisfiedAwsEcsClusterBuilder, type SatisfiedAwsEcsServiceBuilder, type SatisfiedAwsEcsTaskDefinitionBuilder, type SatisfiedAwsEksClusterBuilder, type SatisfiedAwsSecurityGroupBuilder, type SatisfiedAwsSubnetBuilder, type SatisfiedAwsVpcBuilder, type SatisfiedAzureAksClusterBuilder, type SatisfiedAzureContainerAppBuilder, type SatisfiedAzureContainerAppsEnvironmentBuilder, type SatisfiedAzureContainerInstanceBuilder, type SatisfiedAzureNsgBuilder, type SatisfiedAzureSubnetBuilder, type SatisfiedAzureVmBuilder, type SatisfiedAzureVnetBuilder, type SatisfiedEc2Builder, type SatisfiedGcpCloudRunServiceBuilder, type SatisfiedGcpFirewallBuilder, type SatisfiedGcpGkeClusterBuilder, type SatisfiedGcpSubnetBuilder, type SatisfiedGcpVmBuilder, type SatisfiedGcpVpcBuilder, type SatisfiedHetznerFirewallBuilder, type SatisfiedHetznerNetworkBuilder, type SatisfiedHetznerServerBuilder, type SatisfiedHetznerSubnetBuilder, type SatisfiedOciContainerInstanceBuilder, type SatisfiedOciInstanceBuilder, type SatisfiedOciSecurityListBuilder, type SatisfiedOciSubnetBuilder, type SatisfiedOciVcnBuilder, SecurityGroup, type SecurityGroupBuilder, type SecurityGroupComponent, type SecurityGroupConfig, ServiceAccountCredentials, ServiceAccountId, ServiceDeliveryModel, Subnet, type SubnetBuilder, type SubnetComponent, type SubnetConfig, type SubnetResult, Version, VirtualMachine, type VirtualMachineBuilder, type VirtualMachineComponent, type VirtualMachineConfig, VirtualNetwork, type VirtualNetworkBuilder, type VirtualNetworkComponent, type VirtualNetworkConfig, type VirtualNetworkResult, type VmPortLink, Workload, type WorkloadBuilder, type WorkloadComponent, type WorkloadConfig, type WorkloadPortLink };

package/dist/index.mjs

@@ -1138,6 +1138,60 @@ let BlueprintComponent;
 	_BlueprintComponent.getBuilder = getBlueprintComponentBuilder;
 })(BlueprintComponent || (BlueprintComponent = {}));
 
+//#endregion
+//#region src/debug.ts
+/**
+* Debug logging for Fractal Cloud SDK HTTP calls.
+*
+* Enabled by setting the FRACTAL_DEBUG environment variable to "true".
+* When enabled, every outbound API request and every inbound response
+* (including error responses) is printed to stdout in the format:
+*
+*   [ISO-8601] DEBUG → METHOD URL [label]  body=<json>
+*   [ISO-8601] DEBUG ← STATUS METHOD URL [label]  body=<json>
+*
+* Authentication headers are never logged.
+* If the request body cannot be serialised to JSON (e.g. circular reference),
+* a <non-serialisable> marker is logged instead of crashing.
+*/
+const isEnabled = () => process.env["FRACTAL_DEBUG"]?.toLowerCase() === "true";
+const trySerialise = (value) => {
+	try {
+		return JSON.stringify(value);
+	} catch {
+		return "<non-serialisable>";
+	}
+};
+/**
+* Logs an outbound HTTP request when debug mode is active.
+* @param method  HTTP method in uppercase, e.g. "GET"
+* @param url     Full request URL
+* @param body    Optional request body (JSON-serialised; not truncated)
+* @param label   Optional context label shown in brackets, e.g. "existence check"
+*/
+const debugRequest = (method, url, body, label) => {
+	if (!isEnabled()) return;
+	const ts = (/* @__PURE__ */ new Date()).toISOString();
+	const labelStr = label ? ` [${label}]` : "";
+	const bodyStr = body !== void 0 ? `  body=${trySerialise(body)}` : "";
+	console.log(`[${ts}] DEBUG → ${method} ${url}${labelStr}${bodyStr}`);
+};
+/**
+* Logs an inbound HTTP response (or error response) when debug mode is active.
+* @param method  HTTP method of the originating request
+* @param url     Full request URL
+* @param status  HTTP status code received
+* @param body    Optional response body (JSON-serialised; not truncated)
+* @param label   Optional context label shown in brackets
+*/
+const debugResponse = (method, url, status, body, label) => {
+	if (!isEnabled()) return;
+	const ts = (/* @__PURE__ */ new Date()).toISOString();
+	const labelStr = label ? ` [${label}]` : "";
+	const bodyStr = body !== void 0 ? `  body=${trySerialise(body)}` : "";
+	console.log(`[${ts}] DEBUG ← ${status} ${method} ${url}${labelStr}${bodyStr}`);
+};
+
 //#endregion
 //#region src/fractal/service.ts
 const CLIENT_ID_HEADER$1 = "X-ClientID";
@@ -1163,39 +1217,57 @@ const deployFractal = async (credentials, fractal) => {
 	const target = fractal.id.toString();
 	const fractalUrl = `${FRACTAL_API_URL$1}/blueprints/${target.replace(":", "/")}`;
 	let getFractalResponse;
+	debugRequest("GET", fractalUrl, void 0, "existence check");
 	try {
 		getFractalResponse = await superagent.get(fractalUrl).ok((res) => res.status === 200 || res.status === 404).set(authHeaders$1(credentials)).send();
+		debugResponse("GET", fractalUrl, getFractalResponse.status, getFractalResponse.body, "existence check");
 	} catch (err) {
+		const e = err;
+		debugResponse("GET", fractalUrl, e.status ?? 0, e.response?.body, "existence check");
 		throw toApiError$1("check fractal existence", target, err);
 	}
+	const method = getFractalResponse.status === 200 ? "PUT" : "POST";
 	const request = getFractalResponse.status === 200 ? superagent.put(fractalUrl) : superagent.post(fractalUrl);
+	const body = {
+		description: fractal.description,
+		isPrivate: fractal.isPrivate,
+		components: fractal.components.map((c) => ({
+			type: c.type.toString(),
+			id: c.id.value.toString(),
+			version: c.version.toString(),
+			displayName: c.displayName,
+			description: c.description,
+			parameters: c.parameters.toMap(),
+			dependencies: c.dependencies.map((d) => d.id.value.toString()),
+			links: c.links.map((l) => ({
+				componentId: l.id.value.toString(),
+				settings: l.parameters.toMap()
+			})),
+			outputFields: Object.keys(c.outputFields.value),
+			isLocked: c.isLocked,
+			recreateOnFailure: c.recreateOnFailure
+		}))
+	};
+	debugRequest(method, fractalUrl, body);
 	try {
-		await request.set(authHeaders$1(credentials)).send({
-			description: fractal.description,
-			isPrivate: fractal.isPrivate,
-			components: fractal.components.map((c) => ({
-				...c,
-				type: c.type.toString(),
-				id: c.id.value.toString(),
-				version: c.version.toString(),
-				parameters: c.parameters.toMap(),
-				dependencies: c.dependencies.map((d) => d.id.value.toString()),
-				links: c.links.map((l) => ({
-					componentId: l.id.value.toString(),
-					settings: l.parameters.toMap()
-				})),
-				outputFields: Object.keys(c.outputFields.value)
-			}))
-		});
+		const response = await request.set(authHeaders$1(credentials)).send(body);
+		debugResponse(method, fractalUrl, response.status, response.body);
 	} catch (err) {
+		const e = err;
+		debugResponse(method, fractalUrl, e.status ?? 0, e.response?.body);
 		throw toApiError$1(getFractalResponse.status === 200 ? "update fractal" : "create fractal", target, err);
 	}
 };
 const destroyFractal = async (credentials, id) => {
 	const target = id.toString();
+	const url = `${FRACTAL_API_URL$1}/blueprints/${target.replace(":", "/")}`;
+	debugRequest("DELETE", url);
 	try {
-		await superagent.delete(`${FRACTAL_API_URL$1}/blueprints/${target.replace(":", "/")}`).set(authHeaders$1(credentials));
+		const response = await superagent.delete(url).set(authHeaders$1(credentials));
+		debugResponse("DELETE", url, response.status, response.body);
 	} catch (err) {
+		const e = err;
+		debugResponse("DELETE", url, e.status ?? 0, e.response?.body);
 		throw toApiError$1("destroy fractal", target, err);
 	}
 };
@@ -1881,17 +1953,21 @@ const buildBody = (liveSystem) => ({
 	provider: liveSystem.genericProvider,
 	blueprintMap: liveSystem.components.reduce((acc, c) => {
 		acc[c.id.value.toString()] = {
-			...c,
 			type: c.type.toString(),
 			id: c.id.value.toString(),
 			version: c.version.toString(),
+			displayName: c.displayName,
+			description: c.description,
+			provider: c.provider,
 			parameters: c.parameters.toMap(),
 			dependencies: c.dependencies.map((d) => d.id.value.toString()),
 			links: c.links.map((l) => ({
 				componentId: l.id.value.toString(),
 				settings: l.parameters.toMap()
 			})),
-			outputFields: c.outputFields.value
+			outputFields: c.outputFields.value,
+			isLocked: c.isLocked,
+			recreateOnFailure: c.recreateOnFailure
 		};
 		return acc;
 	}, {}),
@@ -1909,22 +1985,39 @@ const submitDeploy = async (credentials, liveSystem) => {
 	const target = liveSystem.id.toString();
 	const liveSystemUrl = `${FRACTAL_API_URL}/livesystems/${target}`;
 	let getResponse;
+	debugRequest("GET", liveSystemUrl, void 0, "existence check");
 	try {
 		getResponse = await superagent.get(liveSystemUrl).ok((res) => res.status === 200 || res.status === 404).set(authHeaders(credentials)).send();
+		debugResponse("GET", liveSystemUrl, getResponse.status, getResponse.body, "existence check");
 	} catch (err) {
+		const e = err;
+		debugResponse("GET", liveSystemUrl, e.status ?? 0, e.response?.body, "existence check");
 		throw toApiError("check live system existence", target, err);
 	}
+	const method = getResponse.status === 200 ? "PUT" : "POST";
+	const submitUrl = getResponse.status === 200 ? liveSystemUrl : `${FRACTAL_API_URL}/livesystems`;
 	const request = getResponse.status === 200 ? superagent.put(liveSystemUrl) : superagent.post(`${FRACTAL_API_URL}/livesystems`);
+	const body = buildBody(liveSystem);
+	debugRequest(method, submitUrl, body);
 	try {
-		await request.set(authHeaders(credentials)).send(buildBody(liveSystem));
+		const response = await request.set(authHeaders(credentials)).send(body);
+		debugResponse(method, submitUrl, response.status, response.body);
 	} catch (err) {
+		const e = err;
+		debugResponse(method, submitUrl, e.status ?? 0, e.response?.body);
 		throw toApiError(getResponse.status === 200 ? "update live system" : "create live system", target, err);
 	}
 };
 const getLiveSystemStatus = async (credentials, id) => {
+	const url = `${FRACTAL_API_URL}/livesystems/${id.toString()}`;
+	debugRequest("GET", url, void 0, "status poll");
 	try {
-		return (await superagent.get(`${FRACTAL_API_URL}/livesystems/${id.toString()}`).set(authHeaders(credentials)).send()).body.status;
+		const response = await superagent.get(url).set(authHeaders(credentials)).send();
+		debugResponse("GET", url, response.status, response.body, "status poll");
+		return response.body.status;
 	} catch (err) {
+		const e = err;
+		debugResponse("GET", url, e.status ?? 0, e.response?.body, "status poll");
 		throw toApiError("get live system status", id.toString(), err);
 	}
 };
@@ -2006,9 +2099,14 @@ const deployLiveSystem = async (credentials, liveSystem, options = { mode: "fire
 	});
 };
 const destroyLiveSystem = async (credentials, id) => {
+	const url = `${FRACTAL_API_URL}/livesystems/${id.toString()}`;
+	debugRequest("DELETE", url);
 	try {
-		await superagent.delete(`${FRACTAL_API_URL}/livesystems/${id.toString()}`).set(authHeaders(credentials));
+		const response = await superagent.delete(url).set(authHeaders(credentials));
+		debugResponse("DELETE", url, response.status, response.body);
 	} catch (err) {
+		const e = err;
+		debugResponse("DELETE", url, e.status ?? 0, e.response?.body);
 		throw toApiError("destroy live system", id.toString(), err);
 	}
 };
@@ -2138,6 +2236,7 @@ const getLiveSystemBuilder = () => {
 		},
 		reset: () => {
 			internalState.id = DEFAULT_LIVE_SYSTEM.id;
+			internalState.parameters = DEFAULT_LIVE_SYSTEM.parameters;
 			internalState.requesterId = DEFAULT_LIVE_SYSTEM.requesterId;
 			internalState.fractalId = DEFAULT_LIVE_SYSTEM.fractalId;
 			internalState.description = DEFAULT_LIVE_SYSTEM.description;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fractal_cloud/sdk",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Typescript Fractal Cloud SDK",
   "license": "GPL-3.0-or-later",
   "author": "Fractal Cloud",