@dharta/cli 0.6.77 → 0.6.78

package/node_modules/@dharta/contracts/src/artifact-runtime.generated.ts

@@ -0,0 +1,2093 @@
+// Generated from artifact-runtime.json by generate-artifact-runtime-bindings.mjs.
+// Do not edit.
+type DeepReadonly<T> = T extends (...args: never[]) => unknown
+  ? T
+  : T extends readonly (infer Item)[]
+    ? readonly DeepReadonly<Item>[]
+    : T extends object
+      ? { readonly [Key in keyof T]: DeepReadonly<T[Key]> }
+      : T;
+
+function deepFreeze<T>(value: T): DeepReadonly<T> {
+  if (typeof value === "object" && value !== null) {
+    Object.freeze(value);
+    for (const child of Object.values(value)) deepFreeze(child);
+  }
+  return value as DeepReadonly<T>;
+}
+
+export const ARTIFACT_RUNTIME_CATALOG = deepFreeze({
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "contract_version": 2,
+  "manifest": {
+    "id_pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$",
+    "type_id_pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
+    "input_alias_pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
+    "workspace_source_pattern": "^workspace:(?!.*[\\uD800-\\uDFFF])(?!/)(?!.*\\\\)(?!.*//)(?!\\.\\.?(?:$|/))(?!.*[/]\\.\\.?(?:$|/))[^\\u0000/]+(?:/[^\\u0000/]+)*$",
+    "max_title_characters": 200,
+    "max_root_bytes": 1024,
+    "max_root_depth": 32,
+    "max_entry_bytes": 1024,
+    "max_entry_depth": 32,
+    "max_run_bytes": 16384,
+    "max_inputs": 64,
+    "max_input_source_bytes": 2048,
+    "freshness": [
+      "pinned",
+      "follow"
+    ],
+    "reserved_root_paths": [
+      ".dharta/inputs"
+    ]
+  },
+  "trees": {
+    "root": {
+      "max_files": 20000,
+      "max_bytes": 1000000000
+    },
+    "input": {
+      "max_files": 20000,
+      "max_bytes": 1000000000
+    },
+    "all_inputs": {
+      "max_files": 50000,
+      "max_bytes": 5000000000
+    },
+    "static_share": {
+      "max_files": 20000,
+      "max_bytes": 1000000000
+    },
+    "reject_symlinks_escaping_tree": true,
+    "reject_secret_paths": true
+  },
+  "runtime": {
+    "abi": "dharta.artifact.renderer/v1",
+    "shell": "/bin/sh",
+    "shell_arguments": [
+      "-lc"
+    ],
+    "host": "127.0.0.1",
+    "environment": {
+      "DHARTA_ARTIFACT_PORT": {
+        "secret": false,
+        "value": "assigned loopback port"
+      },
+      "DHARTA_ARTIFACT_INPUTS": {
+        "secret": false,
+        "value": "absolute mounted input directory"
+      },
+      "DHARTA_ARTIFACT_TYPE_DIR": {
+        "secret": false,
+        "value": "absolute Type recipe directory when present"
+      },
+      "DHARTA_ARTIFACT_RUN": {
+        "secret": false,
+        "value": "opaque declared shell command"
+      }
+    },
+    "inherited_environment": "allowlist-only",
+    "secret_environment": [],
+    "startup_seconds": 30,
+    "idle_seconds": 300,
+    "absolute_seconds": 3600,
+    "teardown_seconds": 30
+  },
+  "portable_sharing": {
+    "format": "dharta.portable-artifact-execution-pack.v1",
+    "cost_owners": [
+      "publisher",
+      "viewer",
+      "organization"
+    ],
+    "required_live_execution": true,
+    "capabilities": {
+      "network": "none",
+      "workspace": "none",
+      "model": false,
+      "credentials": [],
+      "connections": []
+    },
+    "exclude_producer_sources": true,
+    "exclude_snapshot_ids": true,
+    "exclude_credentials": true
+  },
+  "access": {
+    "public_token_pattern": "^sfl_[A-Za-z0-9_-]{32,96}$",
+    "execution_id_pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$",
+    "execution_id_max_characters": 128,
+    "artifact_version_id_pattern": "^[A-Za-z0-9_-]{1,64}$",
+    "artifact_version_id_max_characters": 64,
+    "audience_digest_pattern": "^[0-9a-f]{64}$",
+    "handoff_digest_pattern": "^[0-9a-f]{64}$",
+    "handoff_token_pattern": "^aat_[A-Za-z0-9_-]{39,1996}$",
+    "origin_label_pattern": "^a-[a-z2-7]{52}$"
+  },
+  "http": {
+    "root_path": "/",
+    "handoff_path": "/_dharta/artifact/handoff",
+    "authorize_path": "/_dharta/artifact/authorize",
+    "open_path": "/_dharta/artifact/open",
+    "access_cookie": "__Host-dharta_artifact_access",
+    "local_access_cookie": "dharta_artifact_access_dev",
+    "root_media_type_essence": "text/html",
+    "allow_media_type_parameters": true,
+    "methods": [
+      "GET",
+      "HEAD",
+      "POST",
+      "PUT",
+      "PATCH",
+      "DELETE",
+      "OPTIONS"
+    ],
+    "max_header_bytes": 65536,
+    "max_request_body_bytes": 16777216,
+    "max_response_body_bytes": 1000000000,
+    "max_websocket_frame_bytes": 1048576,
+    "max_websocket_queue_frames": 2,
+    "max_concurrent_requests": 32,
+    "supports_streaming": true,
+    "supports_ranges": true,
+    "supports_sse": true,
+    "supports_websocket": true
+  },
+  "schemas": {
+    "input_v2": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "source",
+        "freshness"
+      ],
+      "properties": {
+        "source": {
+          "type": "string",
+          "maxLength": 2048,
+          "pattern": "^workspace:(?!.*[\\uD800-\\uDFFF])(?!/)(?!.*\\\\)(?!.*//)(?!\\.\\.?(?:$|/))(?!.*[/]\\.\\.?(?:$|/))[^\\u0000/]+(?:/[^\\u0000/]+)*$",
+          "x-dharta-error": "artifact_input_source_invalid"
+        },
+        "freshness": {
+          "enum": [
+            "pinned",
+            "follow"
+          ],
+          "x-dharta-error": "artifact_input_freshness_required"
+        }
+      },
+      "x-dharta-error": "artifact_input_invalid"
+    },
+    "agent_activation_v1": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "authorities",
+        "budget_cents",
+        "lifetime_seconds",
+        "descendant_ceiling",
+        "activation_mode",
+        "visibility"
+      ],
+      "properties": {
+        "authorities": {
+          "type": "array",
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9_.:-]{0,127}$"
+          }
+        },
+        "budget_cents": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 10000
+        },
+        "lifetime_seconds": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 86400
+        },
+        "descendant_ceiling": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 8
+        },
+        "activation_mode": {
+          "enum": [
+            "resume",
+            "new"
+          ]
+        },
+        "visibility": {
+          "enum": [
+            "headless",
+            "inspectable",
+            "user-facing"
+          ]
+        }
+      },
+      "x-dharta-error": "artifact_agent_activation_invalid"
+    },
+    "artifact_v2": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "contract_version",
+        "id",
+        "title",
+        "root",
+        "inputs"
+      ],
+      "allOf": [
+        {
+          "oneOf": [
+            {
+              "required": [
+                "entry"
+              ],
+              "not": {
+                "required": [
+                  "run"
+                ]
+              }
+            },
+            {
+              "required": [
+                "run"
+              ],
+              "not": {
+                "required": [
+                  "entry"
+                ]
+              }
+            }
+          ],
+          "x-dharta-error": "artifact_presentation_invalid"
+        },
+        {
+          "if": {
+            "required": [
+              "agent_activation"
+            ]
+          },
+          "then": {
+            "properties": {
+              "run": {
+                "const": "karta artifact run agent .",
+                "x-dharta-error": "artifact_agent_activation_runner_required"
+              }
+            },
+            "required": [
+              "run"
+            ]
+          },
+          "x-dharta-error": "artifact_agent_activation_runner_required"
+        }
+      ],
+      "properties": {
+        "contract_version": {
+          "const": 2,
+          "x-dharta-error": "artifact_contract_version_invalid"
+        },
+        "id": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$",
+          "x-dharta-error": "artifact_id_invalid"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200,
+          "pattern": "^(?!.*[\\uD800-\\uDFFF]).+$",
+          "x-dharta-error": "artifact_title_invalid"
+        },
+        "type_id": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
+          "x-dharta-error": "artifact_type_id_invalid"
+        },
+        "root": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 1024,
+          "pattern": "^(?!.*[\\uD800-\\uDFFF])(?!/)(?!.*\\\\)(?!.*//)(?!\\.\\.?(?:$|/))(?!.*[/]\\.\\.?(?:$|/))(?!\\.dharta/inputs(?:/|$))[^\\u0000/]+(?:/[^\\u0000/]+)*$",
+          "x-dharta-error": "artifact_root_invalid"
+        },
+        "entry": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 1024,
+          "pattern": "^(?!.*[\\uD800-\\uDFFF])(?!/)(?!.*\\\\)(?!.*//)(?!\\.\\.?(?:$|/))(?!.*[/]\\.\\.?(?:$|/))[^\\u0000/]+(?:/[^\\u0000/]+)*$",
+          "x-dharta-error": "artifact_entry_invalid"
+        },
+        "run": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16384,
+          "pattern": "^(?!.*[\\uD800-\\uDFFF])[^\\u0000]+$",
+          "x-dharta-error": "artifact_run_invalid"
+        },
+        "agent_activation": {
+          "$ref": "#/$defs/agent_activation_v1"
+        },
+        "inputs": {
+          "type": "object",
+          "maxProperties": 64,
+          "propertyNames": {
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
+            "x-dharta-error": "artifact_input_alias_invalid"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/input_v2"
+          },
+          "x-dharta-error": "artifact_inputs_invalid"
+        }
+      },
+      "x-dharta-error": "artifact_v2_invalid"
+    },
+    "artifact_v1": {
+      "type": "object",
+      "required": [
+        "contract_version",
+        "key",
+        "kind",
+        "title",
+        "entrypoint",
+        "dependencies"
+      ],
+      "properties": {
+        "contract_version": {
+          "const": 1,
+          "x-dharta-error": "artifact_contract_version_invalid"
+        },
+        "key": {
+          "type": "string",
+          "minLength": 1
+        },
+        "kind": {
+          "type": "string",
+          "minLength": 1
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "entrypoint": {
+          "type": "string",
+          "minLength": 1
+        },
+        "dependencies": {
+          "type": "array",
+          "items": {
+            "type": "object"
+          }
+        },
+        "suggested_surface": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": true,
+      "x-dharta-error": "artifact_v1_invalid"
+    },
+    "manifest_document": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "artifacts"
+      ],
+      "properties": {
+        "schema": {
+          "const": 2,
+          "x-dharta-error": "artifact_document_schema_invalid"
+        },
+        "artifacts": {
+          "type": "array",
+          "maxItems": 256,
+          "items": {
+            "oneOf": [
+              {
+                "$ref": "#/$defs/artifact_v1"
+              },
+              {
+                "$ref": "#/$defs/artifact_v2"
+              }
+            ]
+          },
+          "x-dharta-error": "artifact_document_invalid"
+        }
+      },
+      "x-dharta-error": "artifact_document_invalid"
+    },
+    "artifact_summary_input_v2": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "alias",
+        "source",
+        "freshness",
+        "snapshot_id",
+        "kind",
+        "files",
+        "total_bytes"
+      ],
+      "properties": {
+        "alias": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$"
+        },
+        "source": {
+          "type": "string",
+          "maxLength": 2048
+        },
+        "freshness": {
+          "enum": [
+            "pinned",
+            "follow"
+          ]
+        },
+        "snapshot_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "kind": {
+          "enum": [
+            "file",
+            "directory"
+          ]
+        },
+        "files": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "total_bytes": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "artifact_summary_v1": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "contract_version",
+        "artifact_id",
+        "artifact_version_id",
+        "key",
+        "kind",
+        "title",
+        "entrypoint",
+        "renderer",
+        "schema_version",
+        "portability",
+        "snapshot_id",
+        "member_count",
+        "total_bytes",
+        "publish_audiences"
+      ],
+      "properties": {
+        "contract_version": {
+          "const": 1
+        },
+        "artifact_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "artifact_version_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "key": {
+          "type": "string",
+          "minLength": 1
+        },
+        "kind": {
+          "type": "string",
+          "minLength": 1
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "entrypoint": {
+          "type": "string",
+          "minLength": 1
+        },
+        "renderer": {
+          "type": "string",
+          "minLength": 1
+        },
+        "schema_version": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "portability": {
+          "enum": [
+            "static",
+            "explainable",
+            "forkable"
+          ]
+        },
+        "snapshot_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "member_count": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "total_bytes": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "publish_audiences": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "public",
+              "link",
+              "organization",
+              "named"
+            ]
+          }
+        }
+      }
+    },
+    "artifact_summary_v2": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "contract_version",
+        "artifact_id",
+        "artifact_version_id",
+        "id",
+        "title",
+        "root",
+        "snapshot_id",
+        "member_count",
+        "total_bytes",
+        "inputs",
+        "publish_audiences"
+      ],
+      "allOf": [
+        {
+          "oneOf": [
+            {
+              "required": [
+                "entry",
+                "renderer",
+                "presentation_availability"
+              ],
+              "not": {
+                "anyOf": [
+                  {
+                    "required": [
+                      "run"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "execution_availability"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "execution_unavailable_reason"
+                    ]
+                  }
+                ]
+              }
+            },
+            {
+              "required": [
+                "run",
+                "execution_availability"
+              ],
+              "not": {
+                "anyOf": [
+                  {
+                    "required": [
+                      "entry"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "renderer"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "presentation_availability"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "presentation_unavailable_reason"
+                    ]
+                  }
+                ]
+              }
+            }
+          ]
+        },
+        {
+          "if": {
+            "required": [
+              "agent_activation"
+            ]
+          },
+          "then": {
+            "properties": {
+              "run": {
+                "const": "karta artifact run agent ."
+              }
+            },
+            "required": [
+              "run"
+            ]
+          }
+        }
+      ],
+      "properties": {
+        "contract_version": {
+          "const": 2
+        },
+        "artifact_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "artifact_version_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "id": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "root": {
+          "type": "string",
+          "minLength": 1
+        },
+        "entry": {
+          "type": "string",
+          "minLength": 1
+        },
+        "run": {
+          "type": "string",
+          "minLength": 1
+        },
+        "agent_activation": {
+          "$ref": "#/$defs/agent_activation_v1"
+        },
+        "renderer": {
+          "enum": [
+            "builtin.text",
+            "builtin.markdown",
+            "builtin.code",
+            "builtin.image",
+            "builtin.audio",
+            "builtin.video",
+            "builtin.csv",
+            "builtin.pdf",
+            "builtin.html",
+            "builtin.download"
+          ]
+        },
+        "type_id": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$"
+        },
+        "snapshot_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "member_count": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "total_bytes": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "inputs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/artifact_summary_input_v2"
+          }
+        },
+        "presentation_availability": {
+          "enum": [
+            "available",
+            "unavailable"
+          ]
+        },
+        "presentation_unavailable_reason": {
+          "type": "string",
+          "minLength": 1
+        },
+        "execution_availability": {
+          "enum": [
+            "available",
+            "unavailable"
+          ]
+        },
+        "execution_unavailable_reason": {
+          "type": "string",
+          "minLength": 1
+        },
+        "publish_audiences": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "public",
+              "link",
+              "organization",
+              "named"
+            ]
+          }
+        }
+      }
+    },
+    "portable_pack_input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "alias",
+        "freshness",
+        "kind",
+        "tree_digest",
+        "files",
+        "bytes"
+      ],
+      "properties": {
+        "alias": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$"
+        },
+        "freshness": {
+          "enum": [
+            "pinned",
+            "follow"
+          ]
+        },
+        "kind": {
+          "enum": [
+            "file",
+            "directory"
+          ]
+        },
+        "tree_digest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "files": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "bytes": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "portable_pack_member": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "scope",
+        "path",
+        "kind",
+        "size",
+        "mode"
+      ],
+      "properties": {
+        "scope": {
+          "enum": [
+            "root",
+            "input",
+            "type"
+          ]
+        },
+        "alias": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$"
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 1024
+        },
+        "kind": {
+          "enum": [
+            "file",
+            "symlink",
+            "directory"
+          ]
+        },
+        "digest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "size": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "mode": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 4095
+        },
+        "target": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 4096
+        },
+        "target_kind": {
+          "enum": [
+            "file",
+            "directory"
+          ]
+        },
+        "generation": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "portable_execution_capabilities": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "network",
+        "workspace",
+        "model",
+        "credentials",
+        "connections"
+      ],
+      "properties": {
+        "network": {
+          "const": "none"
+        },
+        "workspace": {
+          "const": "none"
+        },
+        "model": {
+          "const": false
+        },
+        "credentials": {
+          "type": "array",
+          "maxItems": 0
+        },
+        "connections": {
+          "type": "array",
+          "maxItems": 0
+        }
+      }
+    },
+    "portable_execution_pack": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "format",
+        "artifact_id",
+        "artifact_version_id",
+        "run",
+        "root",
+        "inputs",
+        "type_id",
+        "type_package_digest",
+        "cost_owner",
+        "capabilities",
+        "members"
+      ],
+      "properties": {
+        "format": {
+          "const": "dharta.portable-artifact-execution-pack.v1"
+        },
+        "artifact_id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "artifact_version_id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "run": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16384
+        },
+        "root": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind",
+            "tree_digest",
+            "files",
+            "bytes"
+          ],
+          "properties": {
+            "kind": {
+              "enum": [
+                "file",
+                "directory"
+              ]
+            },
+            "tree_digest": {
+              "type": "string",
+              "pattern": "^[0-9a-f]{64}$"
+            },
+            "files": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "bytes": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        },
+        "inputs": {
+          "type": "array",
+          "maxItems": 64,
+          "items": {
+            "$ref": "#/$defs/portable_pack_input"
+          }
+        },
+        "type_id": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$"
+        },
+        "type_package_digest": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "cost_owner": {
+          "enum": [
+            "publisher",
+            "viewer",
+            "organization"
+          ]
+        },
+        "capabilities": {
+          "$ref": "#/$defs/portable_execution_capabilities"
+        },
+        "members": {
+          "type": "array",
+          "maxItems": 20000,
+          "items": {
+            "$ref": "#/$defs/portable_pack_member"
+          }
+        }
+      }
+    },
+    "portable_execution_consent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "pack_id",
+        "artifact_version_id",
+        "run",
+        "required_live_execution",
+        "cost_owner",
+        "capabilities",
+        "root",
+        "inputs",
+        "type_id",
+        "unique_files",
+        "unique_bytes",
+        "consent_digest"
+      ],
+      "properties": {
+        "pack_id": {
+          "type": "string",
+          "pattern": "^sp_[0-9a-f]{64}$"
+        },
+        "artifact_version_id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "run": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16384
+        },
+        "required_live_execution": {
+          "const": true
+        },
+        "cost_owner": {
+          "enum": [
+            "publisher",
+            "viewer",
+            "organization"
+          ]
+        },
+        "capabilities": {
+          "$ref": "#/$defs/portable_execution_capabilities"
+        },
+        "root": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "files",
+            "bytes"
+          ],
+          "properties": {
+            "files": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "bytes": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        },
+        "inputs": {
+          "type": "array",
+          "maxItems": 64,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "alias",
+              "freshness",
+              "files",
+              "bytes"
+            ],
+            "properties": {
+              "alias": {
+                "type": "string",
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$"
+              },
+              "freshness": {
+                "enum": [
+                  "pinned",
+                  "follow"
+                ]
+              },
+              "files": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "bytes": {
+                "type": "integer",
+                "minimum": 0
+              }
+            }
+          }
+        },
+        "type_id": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$"
+        },
+        "unique_files": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "unique_bytes": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "consent_digest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        }
+      }
+    },
+    "artifact_execution_session": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "url",
+        "state",
+        "lease_expires_at",
+        "absolute_expires_at",
+        "cost_microusd",
+        "cost_state",
+        "metered_seconds",
+        "artifact_version_id",
+        "renewal_token"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "pattern": "^https://"
+        },
+        "state": {
+          "enum": [
+            "active",
+            "hidden"
+          ]
+        },
+        "lease_expires_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "absolute_expires_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "cost_microusd": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "cost_state": {
+          "enum": [
+            "pending",
+            "final"
+          ]
+        },
+        "metered_seconds": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "artifact_version_id": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9_-]{1,64}$"
+        },
+        "renewal_token": {
+          "type": "string",
+          "pattern": "^sfl_[A-Za-z0-9_-]{32,96}$"
+        }
+      }
+    },
+    "artifact_execution_renewal": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "state",
+        "lease_expires_at",
+        "absolute_expires_at",
+        "cost_microusd",
+        "cost_state",
+        "metered_seconds",
+        "handoff"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$"
+        },
+        "state": {
+          "enum": [
+            "active",
+            "hidden"
+          ]
+        },
+        "lease_expires_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "absolute_expires_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "cost_microusd": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "cost_state": {
+          "enum": [
+            "pending",
+            "final"
+          ]
+        },
+        "metered_seconds": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "handoff": {
+          "type": "string",
+          "pattern": "^aat_[A-Za-z0-9_-]{39,1996}$"
+        }
+      }
+    }
+  },
+  "fixtures": [
+    {
+      "name": "generated-python-viewer",
+      "validator": "manifest",
+      "valid": true,
+      "value": {
+        "schema": 2,
+        "artifacts": [
+          {
+            "contract_version": 2,
+            "id": "energy-landscape",
+            "title": "Energy Landscape",
+            "root": "outputs/energy-landscape",
+            "run": "python energy-landscape-viewer.py",
+            "inputs": {
+              "landscape": {
+                "source": "workspace:simulations/energy-landscape.sqlite",
+                "freshness": "follow"
+              }
+            }
+          }
+        ]
+      }
+    },
+    {
+      "name": "developer-type-recipe",
+      "validator": "manifest",
+      "valid": true,
+      "value": {
+        "schema": 2,
+        "artifacts": [
+          {
+            "contract_version": 2,
+            "id": "investment-report",
+            "title": "Investment Report",
+            "type_id": "investment-report",
+            "root": "outputs/investment-report",
+            "run": "python \"$DHARTA_ARTIFACT_TYPE_DIR/render.py\" report.sqlite",
+            "inputs": {
+              "evidence": {
+                "source": "workspace:evidence",
+                "freshness": "pinned"
+              }
+            }
+          }
+        ]
+      }
+    },
+    {
+      "name": "passive-pdf-entry",
+      "validator": "manifest",
+      "valid": true,
+      "value": {
+        "schema": 2,
+        "artifacts": [
+          {
+            "contract_version": 2,
+            "id": "audit-report",
+            "title": "Audit Report",
+            "root": "outputs/audit-report",
+            "entry": "report.pdf",
+            "inputs": {
+              "audit": {
+                "source": "workspace:audit/source",
+                "freshness": "pinned"
+              }
+            }
+          }
+        ]
+      }
+    },
+    {
+      "name": "static-html-entry",
+      "validator": "manifest",
+      "valid": true,
+      "value": {
+        "schema": 2,
+        "artifacts": [
+          {
+            "contract_version": 2,
+            "id": "interactive-report",
+            "title": "Interactive Report",
+            "root": "outputs/interactive-report",
+            "entry": "index.html",
+            "inputs": {}
+          }
+        ]
+      }
+    },
+    {
+      "name": "interactive-post-websocket",
+      "validator": "manifest",
+      "valid": true,
+      "value": {
+        "schema": 2,
+        "artifacts": [
+          {
+            "contract_version": 2,
+            "id": "simulation",
+            "title": "Interactive Simulation",
+            "root": "outputs/simulation",
+            "run": "python server.py",
+            "inputs": {}
+          }
+        ]
+      }
+    },
+    {
+      "name": "arbitrary-shell-command",
+      "validator": "manifest",
+      "valid": true,
+      "value": {
+        "schema": 2,
+        "artifacts": [
+          {
+            "contract_version": 2,
+            "id": "generated-dashboard",
+            "title": "Generated Dashboard",
+            "root": "outputs/generated-dashboard",
+            "run": "python preprocess.py && http-server index.html --port \"$DHARTA_ARTIFACT_PORT\"",
+            "inputs": {}
+          }
+        ]
+      }
+    },
+    {
+      "name": "shared-sqlite-follow-input",
+      "validator": "manifest",
+      "valid": true,
+      "value": {
+        "schema": 2,
+        "artifacts": [
+          {
+            "contract_version": 2,
+            "id": "landscape-map",
+            "title": "Landscape Map",
+            "root": "outputs/landscape-map",
+            "run": "python map.py",
+            "inputs": {
+              "simulation": {
+                "source": "workspace:simulations/shared.sqlite",
+                "freshness": "follow"
+              }
+            }
+          },
+          {
+            "contract_version": 2,
+            "id": "landscape-table",
+            "title": "Landscape Table",
+            "root": "outputs/landscape-table",
+            "run": "python table.py",
+            "inputs": {
+              "simulation": {
+                "source": "workspace:simulations/shared.sqlite",
+                "freshness": "follow"
+              }
+            }
+          }
+        ]
+      }
+    },
+    {
+      "name": "generated-agent-app",
+      "validator": "manifest",
+      "valid": true,
+      "value": {
+        "schema": 2,
+        "artifacts": [
+          {
+            "contract_version": 2,
+            "id": "scenario-analyst",
+            "title": "Scenario Analyst",
+            "root": "outputs/scenario-analyst",
+            "run": "karta artifact run agent .",
+            "agent_activation": {
+              "authorities": [
+                "model"
+              ],
+              "budget_cents": 100,
+              "lifetime_seconds": 3600,
+              "descendant_ceiling": 0,
+              "activation_mode": "resume",
+              "visibility": "user-facing"
+            },
+            "inputs": {}
+          }
+        ]
+      }
+    },
+    {
+      "name": "agent-activation-on-arbitrary-runner",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_agent_activation_runner_required",
+      "value": {
+        "contract_version": 2,
+        "id": "bad-agent",
+        "title": "Bad Agent",
+        "root": "outputs/bad-agent",
+        "run": "python server.py",
+        "agent_activation": {
+          "authorities": [],
+          "budget_cents": 0,
+          "lifetime_seconds": 3600,
+          "descendant_ceiling": 0,
+          "activation_mode": "resume",
+          "visibility": "headless"
+        },
+        "inputs": {}
+      }
+    },
+    {
+      "name": "mixed-v1-v2",
+      "validator": "manifest",
+      "valid": true,
+      "value": {
+        "schema": 2,
+        "artifacts": [
+          {
+            "contract_version": 1,
+            "key": "legacy-report",
+            "kind": "briefing",
+            "title": "Legacy report",
+            "entrypoint": "reports/legacy.md",
+            "dependencies": [
+              {
+                "role": "render",
+                "path": "reports/legacy.md"
+              }
+            ],
+            "suggested_surface": "artifact"
+          },
+          {
+            "contract_version": 2,
+            "id": "new-report",
+            "title": "New report",
+            "root": "outputs/new-report",
+            "entry": "report.md",
+            "inputs": {}
+          }
+        ]
+      }
+    },
+    {
+      "name": "legacy-v1-extension-roundtrip",
+      "validator": "manifest",
+      "valid": true,
+      "value": {
+        "schema": 2,
+        "artifacts": [
+          {
+            "contract_version": 1,
+            "key": "legacy-evidence",
+            "kind": "audit",
+            "title": "Legacy evidence",
+            "entrypoint": "reports/evidence.md",
+            "dependencies": [
+              {
+                "role": "render",
+                "path": "reports/evidence.md"
+              }
+            ],
+            "provenance": {
+              "snapshot_id": "snap-17",
+              "sources": [
+                "evidence/a.json"
+              ]
+            }
+          }
+        ]
+      }
+    },
+    {
+      "name": "root-traversal",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_root_invalid",
+      "value": {
+        "contract_version": 2,
+        "id": "bad-root",
+        "title": "Bad root",
+        "root": "../secret",
+        "run": "python viewer.py",
+        "inputs": {}
+      }
+    },
+    {
+      "name": "reserved-root-collision",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_root_invalid",
+      "value": {
+        "contract_version": 2,
+        "id": "reserved-root",
+        "title": "Reserved root",
+        "root": ".dharta/inputs/data",
+        "run": "python viewer.py",
+        "inputs": {}
+      }
+    },
+    {
+      "name": "malicious-shell-nul",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_run_invalid",
+      "value": {
+        "contract_version": 2,
+        "id": "bad-shell",
+        "title": "Bad shell",
+        "root": "outputs/bad-shell",
+        "run": "python viewer.py\u0000--escape",
+        "inputs": {}
+      }
+    },
+    {
+      "name": "empty-run",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_run_invalid",
+      "value": {
+        "contract_version": 2,
+        "id": "empty-run",
+        "title": "Empty run",
+        "root": "outputs/empty-run",
+        "run": "",
+        "inputs": {}
+      }
+    },
+    {
+      "name": "missing-presentation",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_presentation_invalid",
+      "value": {
+        "contract_version": 2,
+        "id": "missing-presentation",
+        "title": "Missing Presentation",
+        "root": "outputs/missing-presentation",
+        "inputs": {}
+      }
+    },
+    {
+      "name": "entry-and-run",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_presentation_invalid",
+      "value": {
+        "contract_version": 2,
+        "id": "entry-and-run",
+        "title": "Entry and Run",
+        "root": "outputs/entry-and-run",
+        "entry": "index.html",
+        "run": "python server.py",
+        "inputs": {}
+      }
+    },
+    {
+      "name": "entry-traversal",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_entry_invalid",
+      "value": {
+        "contract_version": 2,
+        "id": "bad-entry",
+        "title": "Bad Entry",
+        "root": "outputs/bad-entry",
+        "entry": "../secret.md",
+        "inputs": {}
+      }
+    },
+    {
+      "name": "empty-entry",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_entry_invalid",
+      "value": {
+        "contract_version": 2,
+        "id": "empty-entry",
+        "title": "Empty Entry",
+        "root": "outputs/empty-entry",
+        "entry": "",
+        "inputs": {}
+      }
+    },
+    {
+      "name": "invalid-run-unicode",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_run_invalid",
+      "value": {
+        "contract_version": 2,
+        "id": "unicode-run",
+        "title": "Unicode run",
+        "root": "outputs/unicode-run",
+        "run": "python __KARTA_UNPAIRED_SURROGATE__",
+        "inputs": {}
+      }
+    },
+    {
+      "name": "invalid-title-unicode",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_title_invalid",
+      "value": {
+        "contract_version": 2,
+        "id": "unicode-title",
+        "title": "__KARTA_UNPAIRED_SURROGATE__",
+        "root": "outputs/unicode-title",
+        "run": "python viewer.py",
+        "inputs": {}
+      }
+    },
+    {
+      "name": "invalid-root-unicode",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_root_invalid",
+      "value": {
+        "contract_version": 2,
+        "id": "unicode-root",
+        "title": "Unicode root",
+        "root": "outputs/__KARTA_UNPAIRED_SURROGATE__",
+        "run": "python viewer.py",
+        "inputs": {}
+      }
+    },
+    {
+      "name": "invalid-input-source-unicode",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_input_source_invalid",
+      "value": {
+        "contract_version": 2,
+        "id": "unicode-input",
+        "title": "Unicode input",
+        "root": "outputs/unicode-input",
+        "run": "python viewer.py",
+        "inputs": {
+          "data": {
+            "source": "workspace:data/__KARTA_UNPAIRED_SURROGATE__",
+            "freshness": "pinned"
+          }
+        }
+      }
+    },
+    {
+      "name": "invalid-type-id",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_type_id_invalid",
+      "value": {
+        "contract_version": 2,
+        "id": "bad-type",
+        "title": "Bad Type",
+        "type_id": "../report",
+        "root": "outputs/bad-type",
+        "run": "python viewer.py",
+        "inputs": {}
+      }
+    },
+    {
+      "name": "implicit-freshness",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_input_freshness_required",
+      "value": {
+        "contract_version": 2,
+        "id": "implicit-freshness",
+        "title": "Implicit freshness",
+        "root": "outputs/implicit",
+        "run": "python viewer.py",
+        "inputs": {
+          "data": {
+            "source": "workspace:data.sqlite"
+          }
+        }
+      }
+    },
+    {
+      "name": "input-alias-traversal",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_input_alias_invalid",
+      "value": {
+        "contract_version": 2,
+        "id": "bad-alias",
+        "title": "Bad alias",
+        "root": "outputs/bad-alias",
+        "run": "python viewer.py",
+        "inputs": {
+          "../data": {
+            "source": "workspace:data.sqlite",
+            "freshness": "pinned"
+          }
+        }
+      }
+    },
+    {
+      "name": "workspace-source-traversal",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_input_source_invalid",
+      "value": {
+        "contract_version": 2,
+        "id": "bad-source",
+        "title": "Bad source",
+        "root": "outputs/bad-source",
+        "run": "python viewer.py",
+        "inputs": {
+          "data": {
+            "source": "workspace:../secret",
+            "freshness": "pinned"
+          }
+        }
+      }
+    },
+    {
+      "name": "unsupported-connection-v1",
+      "validator": "artifact",
+      "valid": false,
+      "error": "artifact_input_source_invalid",
+      "value": {
+        "contract_version": 2,
+        "id": "connection-input",
+        "title": "Connection input",
+        "root": "outputs/connection",
+        "run": "python viewer.py",
+        "inputs": {
+          "market": {
+            "source": "connection:market-production",
+            "freshness": "follow"
+          }
+        }
+      }
+    },
+    {
+      "name": "escaping-symlink",
+      "validator": "tree",
+      "valid": false,
+      "error": "artifact_tree_symlink_escape",
+      "value": {
+        "scope": "root",
+        "files": 3,
+        "bytes": 200,
+        "escaping_symlink": true,
+        "secret_path": false,
+        "reserved_path_collision": false
+      }
+    },
+    {
+      "name": "malformed-tree-null",
+      "validator": "tree",
+      "valid": false,
+      "error": "artifact_tree_invalid",
+      "value": null
+    },
+    {
+      "name": "invalid-tree-scope",
+      "validator": "tree",
+      "valid": false,
+      "error": "artifact_tree_scope_invalid",
+      "value": {
+        "scope": "bogus",
+        "files": 0,
+        "bytes": 0,
+        "escaping_symlink": false,
+        "secret_path": false,
+        "reserved_path_collision": false
+      }
+    },
+    {
+      "name": "bounded-root-tree",
+      "validator": "tree",
+      "valid": true,
+      "value": {
+        "scope": "root",
+        "files": 20000,
+        "bytes": 1000000000,
+        "escaping_symlink": false,
+        "secret_path": false,
+        "reserved_path_collision": false
+      }
+    },
+    {
+      "name": "secret-input-path",
+      "validator": "tree",
+      "valid": false,
+      "error": "artifact_tree_secret_path",
+      "value": {
+        "scope": "input",
+        "files": 1,
+        "bytes": 100,
+        "escaping_symlink": false,
+        "secret_path": true,
+        "reserved_path_collision": false
+      }
+    },
+    {
+      "name": "oversized-root-tree",
+      "validator": "tree",
+      "valid": false,
+      "error": "artifact_tree_files_exceeded",
+      "value": {
+        "scope": "root",
+        "files": 20001,
+        "bytes": 100,
+        "escaping_symlink": false,
+        "secret_path": false,
+        "reserved_path_collision": false
+      }
+    },
+    {
+      "name": "oversized-input-tree",
+      "validator": "tree",
+      "valid": false,
+      "error": "artifact_tree_bytes_exceeded",
+      "value": {
+        "scope": "input",
+        "files": 1,
+        "bytes": 1000000001,
+        "escaping_symlink": false,
+        "secret_path": false,
+        "reserved_path_collision": false
+      }
+    },
+    {
+      "name": "oversized-static-share",
+      "validator": "tree",
+      "valid": false,
+      "error": "artifact_tree_files_exceeded",
+      "value": {
+        "scope": "static_share",
+        "files": 20001,
+        "bytes": 100,
+        "escaping_symlink": false,
+        "secret_path": false,
+        "reserved_path_collision": false
+      }
+    },
+    {
+      "name": "oversized-combined-inputs",
+      "validator": "tree",
+      "valid": false,
+      "error": "artifact_tree_bytes_exceeded",
+      "value": {
+        "scope": "all_inputs",
+        "files": 2,
+        "bytes": 5000000001,
+        "escaping_symlink": false,
+        "secret_path": false,
+        "reserved_path_collision": false
+      }
+    },
+    {
+      "name": "reserved-input-mount-collision",
+      "validator": "tree",
+      "valid": false,
+      "error": "artifact_tree_reserved_path_collision",
+      "value": {
+        "scope": "root",
+        "files": 4,
+        "bytes": 300,
+        "escaping_symlink": false,
+        "secret_path": false,
+        "reserved_path_collision": true
+      }
+    },
+    {
+      "name": "html-with-charset",
+      "validator": "content_type",
+      "valid": true,
+      "value": "text/html; charset=utf-8"
+    },
+    {
+      "name": "non-html-root",
+      "validator": "content_type",
+      "valid": false,
+      "error": "artifact_root_media_type_invalid",
+      "value": "audio/mpeg"
+    }
+  ]
+} as const);
+
+export type ArtifactInputFreshness = "pinned" | "follow";
+
+export interface ArtifactInputV2 {
+  source: string;
+  freshness: "pinned" | "follow";
+}
+
+export interface AgentArtifactActivationRequestV1 {
+  authorities: Array<string>;
+  budget_cents: number;
+  lifetime_seconds: number;
+  descendant_ceiling: number;
+  activation_mode: "resume" | "new";
+  visibility: "headless" | "inspectable" | "user-facing";
+}
+
+export interface ArtifactDeclarationV1 {
+  contract_version: 1;
+  key: string;
+  kind: string;
+  title: string;
+  entrypoint: string;
+  dependencies: Array<Record<string, unknown>>;
+  suggested_surface?: string;
+  [key: string]: unknown;
+}
+
+export interface ArtifactDeclarationV2 {
+  contract_version: 2;
+  id: string;
+  title: string;
+  type_id?: string;
+  root: string;
+  entry?: string;
+  run?: string;
+  agent_activation?: AgentArtifactActivationRequestV1;
+  inputs: Record<string, ArtifactInputV2>;
+}
+
+export interface ArtifactSummaryInputV2 {
+  alias: string;
+  source: string;
+  freshness: "pinned" | "follow";
+  snapshot_id: string;
+  kind: "file" | "directory";
+  files: number;
+  total_bytes: number;
+}
+
+export interface ArtifactSummaryV1 {
+  contract_version: 1;
+  artifact_id: string;
+  artifact_version_id: string;
+  key: string;
+  kind: string;
+  title: string;
+  entrypoint: string;
+  renderer: string;
+  schema_version: number;
+  portability: "static" | "explainable" | "forkable";
+  snapshot_id: string;
+  member_count: number;
+  total_bytes: number;
+  publish_audiences: Array<"public" | "link" | "organization" | "named">;
+}
+
+export interface ArtifactSummaryV2 {
+  contract_version: 2;
+  artifact_id: string;
+  artifact_version_id: string;
+  id: string;
+  title: string;
+  root: string;
+  entry?: string;
+  run?: string;
+  agent_activation?: AgentArtifactActivationRequestV1;
+  renderer?: "builtin.text" | "builtin.markdown" | "builtin.code" | "builtin.image" | "builtin.audio" | "builtin.video" | "builtin.csv" | "builtin.pdf" | "builtin.html" | "builtin.download";
+  type_id?: string;
+  snapshot_id: string;
+  member_count: number;
+  total_bytes: number;
+  inputs: Array<ArtifactSummaryInputV2>;
+  presentation_availability?: "available" | "unavailable";
+  presentation_unavailable_reason?: string;
+  execution_availability?: "available" | "unavailable";
+  execution_unavailable_reason?: string;
+  publish_audiences: Array<"public" | "link" | "organization" | "named">;
+}
+
+export interface PortableArtifactInputWire {
+  alias: string;
+  freshness: "pinned" | "follow";
+  kind: "file" | "directory";
+  tree_digest: string;
+  files: number;
+  bytes: number;
+}
+
+export interface PortableArtifactMemberWire {
+  scope: "root" | "input" | "type";
+  alias?: string;
+  path: string;
+  kind: "file" | "symlink" | "directory";
+  digest?: string;
+  size: number;
+  mode: number;
+  target?: string;
+  target_kind?: "file" | "directory";
+  generation?: number;
+}
+
+export interface PortableExecutionCapabilitiesWire {
+  network: "none";
+  workspace: "none";
+  model: false;
+  credentials: Array<unknown>;
+  connections: Array<unknown>;
+}
+
+export interface PortableExecutionPackWire {
+  format: "dharta.portable-artifact-execution-pack.v1";
+  artifact_id: string;
+  artifact_version_id: string;
+  run: string;
+  root: Record<string, unknown>;
+  inputs: Array<PortableArtifactInputWire>;
+  type_id: string | null;
+  type_package_digest: string | null;
+  cost_owner: "publisher" | "viewer" | "organization";
+  capabilities: PortableExecutionCapabilitiesWire;
+  members: Array<PortableArtifactMemberWire>;
+}
+
+export interface PortableExecutionConsentWire {
+  pack_id: string;
+  artifact_version_id: string;
+  run: string;
+  required_live_execution: true;
+  cost_owner: "publisher" | "viewer" | "organization";
+  capabilities: PortableExecutionCapabilitiesWire;
+  root: Record<string, unknown>;
+  inputs: Array<Record<string, unknown>>;
+  type_id: string | null;
+  unique_files: number;
+  unique_bytes: number;
+  consent_digest: string;
+}
+
+export interface ArtifactExecutionSessionWire {
+  id: string;
+  url: string;
+  state: "active" | "hidden";
+  lease_expires_at: string;
+  absolute_expires_at: string;
+  cost_microusd: number;
+  cost_state: "pending" | "final";
+  metered_seconds: number;
+  artifact_version_id: string;
+  renewal_token: string;
+}
+
+export interface ArtifactExecutionRenewalWire {
+  id: string;
+  state: "active" | "hidden";
+  lease_expires_at: string;
+  absolute_expires_at: string;
+  cost_microusd: number;
+  cost_state: "pending" | "final";
+  metered_seconds: number;
+  handoff: string;
+}
+
+export type ArtifactDeclaration = ArtifactDeclarationV1 | ArtifactDeclarationV2;
+
+export type ArtifactSummaryWire = ArtifactSummaryV1 | ArtifactSummaryV2;
+
+export interface ArtifactManifestDocumentV2 {
+  schema: 2;
+  artifacts: Array<ArtifactDeclarationV1 | ArtifactDeclarationV2>;
+}