@aikdna/kdna-core 0.18.0 → 0.20.0

package/src/workpack-pure.js

@@ -9,7 +9,7 @@
 const fs = require('fs');
 const path = require('path');
 
-// ── Embedded Work Pack Schema v0.1 ──────────────────────────────────
+// ── Embedded Work Pack Schema 0.1 ──────────────────────────────────
 // Self-contained schema with resolved $refs for zero-dependency validation.
 
 const WORK_PACK_SCHEMA = {

package/schema/agent-host-2-receipt.schema.json

@@ -1,206 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/aikdna/kdna/specs/agent-host-2-receipt.schema.json",
-  "title": "KDNA Agent Host 2 Correlated Response Receipt",
-  "description": "Host 2 correlated response envelope. A matched runtime_receipt proves only that the Host boundary accepted the exact Capsule 2 value. A mismatched runtime_receipt proves that the Host rejected the request before provider execution. Neither proves semantic consumption or conformance.",
-  "type": "object",
-  "required": ["protocol", "request_id", "runtime_receipt", "outcome"],
-  "additionalProperties": false,
-  "properties": {
-    "protocol": { "const": "kdna.agent-host/2" },
-    "request_id": { "type": "string", "pattern": "^host_[0-9a-f]{24}$" },
-    "runtime_receipt": { "$ref": "#/$defs/runtimeReceipt" },
-    "outcome": {
-      "oneOf": [{ "$ref": "#/$defs/outcome" }, { "type": "null" }]
-    }
-  },
-  "allOf": [
-    {
-      "if": {
-        "properties": {
-          "runtime_receipt": {
-            "properties": { "provider_execution_status": { "const": "completed" } },
-            "required": ["provider_execution_status"]
-          }
-        },
-        "required": ["runtime_receipt"]
-      },
-      "then": { "properties": { "outcome": { "$ref": "#/$defs/outcome" } } },
-      "else": { "properties": { "outcome": { "type": "null" } } }
-    }
-  ],
-  "$defs": {
-    "sha256": {
-      "type": "string",
-      "pattern": "^sha256:[0-9a-f]{64}$"
-    },
-    "runtimeReceipt": {
-      "type": "object",
-      "required": [
-        "type",
-        "receipt_version",
-        "capsule_version",
-        "capsule_digest_profile",
-        "sender_capsule_delivery_digest",
-        "host_recomputed_capsule_delivery_digest",
-        "echoed_capsule_delivery_digest",
-        "capsule_delivery_comparison",
-        "capsule_schema_validation",
-        "asset_id_correlation",
-        "provider_execution_status",
-        "usage",
-        "semantic_consumption",
-        "model_identity"
-      ],
-      "additionalProperties": false,
-      "properties": {
-        "type": { "const": "kdna.agent-host.runtime-receipt" },
-        "receipt_version": { "const": "1.0.0" },
-        "capsule_version": { "const": "2.0" },
-        "capsule_digest_profile": { "const": "kdna-capsule-jcs-v1" },
-        "sender_capsule_delivery_digest": { "$ref": "#/$defs/sha256" },
-        "host_recomputed_capsule_delivery_digest": { "$ref": "#/$defs/sha256" },
-        "echoed_capsule_delivery_digest": { "$ref": "#/$defs/sha256" },
-        "capsule_delivery_comparison": { "enum": ["matched", "mismatched"] },
-        "capsule_schema_validation": { "const": "passed" },
-        "asset_id_correlation": { "const": "matched" },
-        "provider_execution_status": {
-          "enum": ["completed", "not_started", "failed", "cancelled", "timed_out"]
-        },
-        "usage": { "$ref": "#/$defs/observedUsage" },
-        "semantic_consumption": { "$ref": "#/$defs/semanticConsumption" },
-        "model_identity": { "$ref": "#/$defs/modelIdentity" }
-      },
-      "allOf": [
-        {
-          "if": {
-            "properties": { "capsule_delivery_comparison": { "const": "matched" } },
-            "required": ["capsule_delivery_comparison"]
-          },
-          "then": {
-            "properties": {
-              "provider_execution_status": {
-                "enum": ["completed", "failed", "cancelled", "timed_out"]
-              }
-            }
-          },
-          "else": {
-            "properties": {
-              "provider_execution_status": { "const": "not_started" },
-              "usage": {
-                "properties": {
-                  "tokens_used": { "type": "null" },
-                  "model_calls": { "type": "null" },
-                  "basis": { "const": "not_observed" }
-                }
-              },
-              "model_identity": {
-                "properties": {
-                  "value": { "type": "null" },
-                  "basis": { "const": "not_observed" }
-                }
-              }
-            }
-          }
-        }
-      ]
-    },
-    "semanticConsumption": {
-      "type": "object",
-      "required": ["state", "basis"],
-      "additionalProperties": false,
-      "properties": {
-        "state": { "const": "not_observed" },
-        "basis": { "type": "null" }
-      }
-    },
-    "observedUsage": {
-      "type": "object",
-      "required": ["elapsed_ms", "elapsed_basis", "tokens_used", "model_calls", "basis"],
-      "additionalProperties": false,
-      "properties": {
-        "elapsed_ms": { "type": "integer", "minimum": 0 },
-        "elapsed_basis": { "const": "host_monotonic" },
-        "tokens_used": {
-          "oneOf": [{ "type": "integer", "minimum": 0 }, { "type": "null" }]
-        },
-        "model_calls": {
-          "oneOf": [{ "type": "integer", "minimum": 0 }, { "type": "null" }]
-        },
-        "basis": { "enum": ["host_reported", "not_observed"] }
-      },
-      "allOf": [
-        {
-          "if": {
-            "properties": { "basis": { "const": "host_reported" } },
-            "required": ["basis"]
-          },
-          "then": {
-            "properties": {
-              "tokens_used": { "type": "integer", "minimum": 0 },
-              "model_calls": { "type": "integer", "minimum": 0 }
-            }
-          },
-          "else": {
-            "properties": {
-              "tokens_used": { "type": "null" },
-              "model_calls": { "type": "null" }
-            }
-          }
-        }
-      ]
-    },
-    "modelIdentity": {
-      "type": "object",
-      "required": ["value", "basis"],
-      "additionalProperties": false,
-      "properties": {
-        "value": { "type": ["string", "null"], "minLength": 1 },
-        "basis": { "enum": ["host_reported", "not_observed"] }
-      },
-      "allOf": [
-        {
-          "if": {
-            "properties": { "basis": { "const": "host_reported" } },
-            "required": ["basis"]
-          },
-          "then": { "properties": { "value": { "type": "string", "minLength": 1 } } },
-          "else": { "properties": { "value": { "type": "null" } } }
-        }
-      ]
-    },
-    "outcome": {
-      "type": "object",
-      "required": ["judgment", "usage"],
-      "additionalProperties": false,
-      "properties": {
-        "judgment": { "$ref": "#/$defs/judgment" },
-        "usage": {
-          "oneOf": [{ "$ref": "#/$defs/usage" }, { "type": "null" }]
-        }
-      }
-    },
-    "judgment": {
-      "type": "object",
-      "required": ["answer", "reasoning", "confidence"],
-      "additionalProperties": false,
-      "properties": {
-        "answer": { "type": "string", "minLength": 1 },
-        "reasoning": {
-          "type": "array",
-          "items": { "type": "string" }
-        },
-        "confidence": { "type": ["string", "null"], "minLength": 1 }
-      }
-    },
-    "usage": {
-      "type": "object",
-      "required": ["tokens_used", "model_calls"],
-      "additionalProperties": false,
-      "properties": {
-        "tokens_used": { "type": "integer", "minimum": 0 },
-        "model_calls": { "type": "integer", "minimum": 0 }
-      }
-    }
-  }
-}

package/schema/agent-host-2-request.schema.json

@@ -1,135 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/aikdna/kdna/specs/agent-host-2-request.schema.json",
-  "title": "KDNA Agent Host 2 Request",
-  "description": "Strict Host 2 request carrying one exact Runtime Capsule 2, its Plan correlation, detached delivery digest P, projection/result contracts, and enforceable limits.",
-  "type": "object",
-  "required": [
-    "protocol",
-    "request_id",
-    "plan_ref",
-    "runtime_contract",
-    "projection_contract",
-    "result_contract",
-    "budget",
-    "constraints",
-    "phase",
-    "task",
-    "authority",
-    "asset",
-    "capsule"
-  ],
-  "additionalProperties": false,
-  "properties": {
-    "protocol": { "const": "kdna.agent-host/2" },
-    "request_id": { "type": "string", "pattern": "^host_[0-9a-f]{24}$" },
-    "plan_ref": { "$ref": "#/$defs/planRef" },
-    "runtime_contract": { "$ref": "#/$defs/runtimeContract" },
-    "projection_contract": { "$ref": "#/$defs/projectionContract" },
-    "result_contract": { "$ref": "#/$defs/resultContract" },
-    "budget": { "$ref": "#/$defs/budget" },
-    "constraints": { "$ref": "#/$defs/constraints" },
-    "phase": { "const": "single_judgment" },
-    "task": { "$ref": "#/$defs/task" },
-    "authority": { "$ref": "#/$defs/authority" },
-    "asset": { "$ref": "#/$defs/asset" },
-    "capsule": {
-      "$ref": "https://github.com/aikdna/kdna/specs/runtime-capsule-2.schema.json"
-    }
-  },
-  "$defs": {
-    "sha256": {
-      "type": "string",
-      "pattern": "^sha256:[0-9a-f]{64}$"
-    },
-    "assetId": {
-      "type": "string",
-      "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*(:[a-zA-Z0-9_.-]+)+$"
-    },
-    "semver": {
-      "type": "string",
-      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+([+-].+)?$"
-    },
-    "planRef": {
-      "type": "object",
-      "required": ["plan_id", "plan_digest_profile", "plan_digest"],
-      "additionalProperties": false,
-      "properties": {
-        "plan_id": { "type": "string", "pattern": "^plan_[0-9a-f]{16}$" },
-        "plan_digest_profile": { "const": "kdna-consumption-plan-jcs-v1" },
-        "plan_digest": { "$ref": "#/$defs/sha256" }
-      }
-    },
-    "runtimeContract": {
-      "type": "object",
-      "required": ["capsule_version", "capsule_digest_profile", "capsule_delivery_digest"],
-      "additionalProperties": false,
-      "properties": {
-        "capsule_version": { "const": "2.0" },
-        "capsule_digest_profile": { "const": "kdna-capsule-jcs-v1" },
-        "capsule_delivery_digest": { "$ref": "#/$defs/sha256" }
-      }
-    },
-    "projectionContract": {
-      "type": "object",
-      "required": ["profile", "required_digest_profile", "require_packaged_asset"],
-      "additionalProperties": false,
-      "properties": {
-        "profile": { "enum": ["index", "compact", "scenario", "full"] },
-        "required_digest_profile": { "const": "kdna-capsule-digests-v1" },
-        "require_packaged_asset": { "const": true }
-      }
-    },
-    "resultContract": {
-      "type": "object",
-      "required": ["shape"],
-      "additionalProperties": false,
-      "properties": {
-        "shape": { "const": "structured_judgment" }
-      }
-    },
-    "budget": {
-      "$ref": "https://github.com/aikdna/kdna/specs/consumption-plan-1.schema.json#/$defs/budget"
-    },
-    "constraints": {
-      "$ref": "https://github.com/aikdna/kdna/specs/consumption-plan-1.schema.json#/$defs/constraints"
-    },
-    "task": {
-      "$ref": "https://github.com/aikdna/kdna/specs/consumption-plan-1.schema.json#/$defs/task"
-    },
-    "authority": {
-      "type": "object",
-      "required": ["asset_id", "role", "final_decision"],
-      "additionalProperties": false,
-      "properties": {
-        "asset_id": { "$ref": "#/$defs/assetId" },
-        "role": { "const": "primary" },
-        "final_decision": { "const": true }
-      }
-    },
-    "asset": {
-      "type": "object",
-      "required": [
-        "asset_id",
-        "asset_uid",
-        "version",
-        "judgment_version",
-        "access",
-        "role",
-        "expected_digests"
-      ],
-      "additionalProperties": false,
-      "properties": {
-        "asset_id": { "$ref": "#/$defs/assetId" },
-        "asset_uid": { "type": "string", "format": "uri" },
-        "version": { "$ref": "#/$defs/semver" },
-        "judgment_version": { "$ref": "#/$defs/semver" },
-        "access": { "enum": ["public", "licensed", "remote"] },
-        "role": { "const": "primary" },
-        "expected_digests": {
-          "$ref": "https://github.com/aikdna/kdna/specs/consumption-plan-1.schema.json#/$defs/expectedDigests"
-        }
-      }
-    }
-  }
-}

package/schema/agent-host-capabilities-1.schema.json

@@ -1,40 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/aikdna/kdna/specs/agent-host-capabilities-1.schema.json",
-  "title": "KDNA Agent Host Capability Descriptor 1.0",
-  "description": "Orthogonal capabilities observed before Plan 1.0 execution. Supported execution pairs are decided by the execution contract verifier, not inferred as a cartesian product by this schema.",
-  "type": "object",
-  "required": [
-    "type",
-    "version",
-    "capability_basis",
-    "host_protocols",
-    "capsule_versions",
-    "capsule_digest_profiles"
-  ],
-  "additionalProperties": false,
-  "properties": {
-    "type": { "const": "kdna.agent-host.capabilities" },
-    "version": { "const": "1.0" },
-    "capability_basis": {
-      "enum": ["registered_descriptor", "legacy_assumption"]
-    },
-    "host_protocols": {
-      "type": "array",
-      "minItems": 1,
-      "uniqueItems": true,
-      "items": { "enum": ["kdna.agent-host/2", "kdna.agent-host/1"] }
-    },
-    "capsule_versions": {
-      "type": "array",
-      "minItems": 1,
-      "uniqueItems": true,
-      "items": { "enum": ["2.0", "1.0"] }
-    },
-    "capsule_digest_profiles": {
-      "type": "array",
-      "uniqueItems": true,
-      "items": { "const": "kdna-capsule-jcs-v1" }
-    }
-  }
-}

package/schema/consumption-plan-1.schema.json

@@ -1,280 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/aikdna/kdna/specs/consumption-plan-1.schema.json",
-  "title": "KDNA ConsumptionPlan 1.0",
-  "description": "Strict opt-in single-asset plan for Capsule 2 delivery to Agent Host 2. Plan 0.9 remains the default Capsule 1 / Host 1 contract.",
-  "type": "object",
-  "required": [
-    "type",
-    "plan_version",
-    "plan_id",
-    "created_at",
-    "mode",
-    "task",
-    "asset_ref",
-    "projection_request",
-    "host_request",
-    "result_request",
-    "budget",
-    "constraints",
-    "trace_policy",
-    "integrity"
-  ],
-  "additionalProperties": false,
-  "properties": {
-    "type": { "const": "kdna.consumption.plan" },
-    "plan_version": { "const": "1.0.0" },
-    "plan_id": { "type": "string", "pattern": "^plan_[0-9a-f]{16}$" },
-    "created_at": { "type": "string", "format": "date-time" },
-    "mode": { "const": "single" },
-    "task": { "$ref": "#/$defs/task" },
-    "asset_ref": { "$ref": "#/$defs/assetRef" },
-    "projection_request": { "$ref": "#/$defs/projectionRequest" },
-    "host_request": { "$ref": "#/$defs/hostRequest" },
-    "result_request": { "$ref": "#/$defs/resultRequest" },
-    "budget": { "$ref": "#/$defs/budget" },
-    "constraints": { "$ref": "#/$defs/constraints" },
-    "trace_policy": { "$ref": "#/$defs/tracePolicy" },
-    "integrity": { "$ref": "#/$defs/integrity" }
-  },
-  "$defs": {
-    "sha256": {
-      "type": "string",
-      "pattern": "^sha256:[0-9a-f]{64}$"
-    },
-    "semver": {
-      "type": "string",
-      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+([+-].+)?$"
-    },
-    "assetId": {
-      "type": "string",
-      "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*(:[a-zA-Z0-9_.-]+)+$"
-    },
-    "task": {
-      "type": "object",
-      "required": ["summary", "task_family", "context"],
-      "additionalProperties": false,
-      "properties": {
-        "summary": { "type": "string", "minLength": 1, "maxLength": 500 },
-        "task_family": { "type": ["string", "null"], "minLength": 1 },
-        "context": true
-      }
-    },
-    "expectedDigest": {
-      "type": "object",
-      "required": ["value", "basis", "source", "comparison"],
-      "additionalProperties": false,
-      "properties": {
-        "value": { "$ref": "#/$defs/sha256" },
-        "basis": { "type": "string" },
-        "source": {
-          "enum": [
-            "caller",
-            "registry",
-            "install_receipt",
-            "lockfile",
-            "kdna.json.content_digest",
-            "checksums.json.entry_set_digest",
-            "checksums.json.asset_digest"
-          ]
-        },
-        "comparison": { "enum": ["matched", "not_compared"] }
-      },
-      "allOf": [
-        {
-          "if": {
-            "properties": { "source": { "const": "caller" } },
-            "required": ["source"]
-          },
-          "then": { "properties": { "comparison": { "const": "not_compared" } } },
-          "else": { "properties": { "comparison": { "const": "matched" } } }
-        }
-      ]
-    },
-    "assetRef": {
-      "type": "object",
-      "required": [
-        "asset_id",
-        "asset_uid",
-        "version",
-        "judgment_version",
-        "access",
-        "expected_digests"
-      ],
-      "additionalProperties": false,
-      "properties": {
-        "asset_id": { "$ref": "#/$defs/assetId" },
-        "asset_uid": { "type": "string", "format": "uri" },
-        "version": { "$ref": "#/$defs/semver" },
-        "judgment_version": { "$ref": "#/$defs/semver" },
-        "access": { "enum": ["public", "licensed", "remote"] },
-        "expected_digests": { "$ref": "#/$defs/expectedDigests" }
-      }
-    },
-    "expectedDigests": {
-      "type": "object",
-      "required": ["asset", "content", "runtime_entry_set"],
-      "additionalProperties": false,
-      "properties": {
-        "asset": {
-          "oneOf": [
-            {
-              "allOf": [
-                { "$ref": "#/$defs/expectedDigest" },
-                {
-                  "properties": {
-                    "basis": { "const": "kdna-container-bytes-v1" },
-                    "source": {
-                      "enum": ["caller", "registry", "install_receipt", "lockfile"]
-                    }
-                  }
-                }
-              ]
-            },
-            { "type": "null" }
-          ]
-        },
-        "content": {
-          "oneOf": [
-            {
-              "allOf": [
-                { "$ref": "#/$defs/expectedDigest" },
-                {
-                  "properties": {
-                    "basis": { "const": "kdna-content-tree-v1" },
-                    "source": {
-                      "enum": [
-                        "caller",
-                        "registry",
-                        "install_receipt",
-                        "lockfile",
-                        "kdna.json.content_digest"
-                      ]
-                    }
-                  }
-                }
-              ]
-            },
-            { "type": "null" }
-          ]
-        },
-        "runtime_entry_set": {
-          "oneOf": [
-            {
-              "allOf": [
-                { "$ref": "#/$defs/expectedDigest" },
-                {
-                  "properties": {
-                    "basis": { "const": "kdna-runtime-entry-set-v1" },
-                    "source": {
-                      "enum": [
-                        "caller",
-                        "registry",
-                        "install_receipt",
-                        "lockfile",
-                        "checksums.json.entry_set_digest",
-                        "checksums.json.asset_digest"
-                      ]
-                    }
-                  }
-                }
-              ]
-            },
-            { "type": "null" }
-          ]
-        }
-      }
-    },
-    "projectionRequest": {
-      "type": "object",
-      "required": [
-        "profile",
-        "accepted_capsule_versions",
-        "required_digest_profile",
-        "require_packaged_asset"
-      ],
-      "additionalProperties": false,
-      "properties": {
-        "profile": { "enum": ["index", "compact", "scenario", "full"] },
-        "accepted_capsule_versions": {
-          "type": "array",
-          "prefixItems": [{ "const": "2.0" }],
-          "minItems": 1,
-          "maxItems": 1
-        },
-        "required_digest_profile": { "const": "kdna-capsule-digests-v1" },
-        "require_packaged_asset": { "const": true }
-      }
-    },
-    "hostRequest": {
-      "type": "object",
-      "required": ["accepted_protocols"],
-      "additionalProperties": false,
-      "properties": {
-        "accepted_protocols": {
-          "type": "array",
-          "prefixItems": [{ "const": "kdna.agent-host/2" }],
-          "minItems": 1,
-          "maxItems": 1
-        }
-      }
-    },
-    "resultRequest": {
-      "type": "object",
-      "required": ["shape"],
-      "additionalProperties": false,
-      "properties": {
-        "shape": { "const": "structured_judgment" }
-      }
-    },
-    "budget": {
-      "type": "object",
-      "required": [
-        "max_projection_chars",
-        "max_task_chars",
-        "deadline_ms",
-        "max_tokens",
-        "max_model_calls"
-      ],
-      "additionalProperties": false,
-      "properties": {
-        "max_projection_chars": { "type": "integer", "minimum": 0 },
-        "max_task_chars": { "type": "integer", "minimum": 0 },
-        "deadline_ms": { "type": "integer", "minimum": 1 },
-        "max_tokens": {
-          "oneOf": [{ "type": "integer", "minimum": 0 }, { "type": "null" }]
-        },
-        "max_model_calls": {
-          "oneOf": [{ "type": "integer", "minimum": 0 }, { "type": "null" }]
-        }
-      }
-    },
-    "constraints": {
-      "type": "object",
-      "required": ["enforce_before_host", "reject_on_exceed"],
-      "additionalProperties": false,
-      "properties": {
-        "enforce_before_host": { "const": true },
-        "reject_on_exceed": { "const": true }
-      }
-    },
-    "tracePolicy": {
-      "type": "object",
-      "required": ["emit", "storage"],
-      "additionalProperties": false,
-      "properties": {
-        "emit": { "const": true },
-        "storage": { "enum": ["ephemeral", "session", "persistent"] }
-      }
-    },
-    "integrity": {
-      "type": "object",
-      "required": ["profile", "plan_digest"],
-      "additionalProperties": false,
-      "properties": {
-        "profile": { "const": "kdna-consumption-plan-jcs-v1" },
-        "plan_digest": { "$ref": "#/$defs/sha256" }
-      }
-    }
-  }
-}