core-runtime-engine 11.5.1__py3-none-any.whl

core_runtime/data/schemas/core/context_threshold.v1.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://core-runtime-engine.local/schemas/core/context_threshold.v1.json",
+  "title": "ContextThreshold.v1",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schema_version", "status", "source_type", "source_id", "should_compress_now", "reason"],
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "const": "core.context_threshold.v1"
+    },
+    "status": {
+      "type": "string"
+    },
+    "source_type": {
+      "type": "string",
+      "minLength": 1
+    },
+    "source_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "should_compress_now": {
+      "type": "boolean"
+    },
+    "reason": {
+      "type": "string"
+    },
+    "current_usage_percent": {
+      "type": "number"
+    },
+    "previous_usage_percent": {
+      "type": "number"
+    },
+    "ema_usage_percent": {
+      "type": "number"
+    },
+    "compression_threshold_percent": {
+      "type": "number"
+    },
+    "recommended_action": {
+      "type": "string"
+    }
+  }
+}

core_runtime/data/schemas/core/contract_program.v1.json

@@ -0,0 +1,186 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://core-runtime-engine.local/schemas/core/contract_program.v1.json",
+  "title": "ContractProgram.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "type",
+    "program_id",
+    "program_version",
+    "authority",
+    "effect_policy",
+    "capabilities",
+    "limits",
+    "instructions",
+    "source_refs",
+    "declared_loss",
+    "fingerprint"
+  ],
+  "properties": {
+    "schema_version": {"type": "string", "const": "core.contract_program.v1"},
+    "type": {"type": "string", "const": "contract_program"},
+    "program_id": {"type": "string", "minLength": 1, "maxLength": 128},
+    "program_version": {"type": "string", "minLength": 1, "maxLength": 64},
+    "authority": {"type": "string", "const": "validation_only"},
+    "effect_policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["external_effects", "network_access", "filesystem_access", "state_apply"],
+      "properties": {
+        "external_effects": {"type": "boolean"},
+        "network_access": {"type": "boolean"},
+        "filesystem_access": {"type": "boolean"},
+        "state_apply": {"type": "boolean"}
+      }
+    },
+    "capabilities": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "enum": ["read_input", "assert", "derive", "stage_transition", "emit_result"]
+      }
+    },
+    "limits": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["max_steps", "max_items", "max_emits"],
+      "properties": {
+        "max_steps": {"type": "integer", "minimum": 1, "maximum": 128},
+        "max_items": {"type": "integer", "minimum": 0, "maximum": 10000},
+        "max_emits": {"type": "integer", "minimum": 0, "maximum": 128}
+      }
+    },
+    "instructions": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 128,
+      "items": {"$ref": "#/$defs/instruction"}
+    },
+    "source_refs": {"$ref": "#/$defs/refs"},
+    "declared_loss": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {"type": "string", "minLength": 1, "maxLength": 256}
+    },
+    "fingerprint": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"}
+  },
+  "$defs": {
+    "ref": {"type": "string", "minLength": 1, "maxLength": 256, "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"},
+    "refs": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {"$ref": "#/$defs/ref"}
+    },
+    "key": {"type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z][A-Za-z0-9_]{0,127}$"},
+    "scalar": {"type": ["string", "number", "integer", "boolean", "null"]},
+    "load_instruction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["opcode", "key", "output"],
+      "properties": {
+        "opcode": {"const": "load"},
+        "key": {"$ref": "#/$defs/key"},
+        "output": {"$ref": "#/$defs/key"}
+      }
+    },
+    "assert_instruction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["opcode", "key", "equals"],
+      "properties": {
+        "opcode": {"const": "assert"},
+        "key": {"$ref": "#/$defs/key"},
+        "equals": {"$ref": "#/$defs/scalar"}
+      }
+    },
+    "derive_instruction": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["opcode", "operation", "input_keys", "output"],
+          "properties": {
+            "opcode": {"const": "derive"},
+            "operation": {"type": "string", "enum": ["copy", "count"]},
+            "input_keys": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 128,
+              "uniqueItems": true,
+              "items": {"$ref": "#/$defs/key"}
+            },
+            "output": {"$ref": "#/$defs/key"}
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["opcode", "operation", "registry_key", "input_keys", "output"],
+          "properties": {
+            "opcode": {"const": "derive"},
+            "operation": {"const": "registry"},
+            "registry_key": {
+              "type": "string",
+              "enum": ["rank.quantity.v1", "member.scale_adapter.v1", "regex.grammar_context.v1"]
+            },
+            "input_keys": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 128,
+              "uniqueItems": true,
+              "items": {"$ref": "#/$defs/key"}
+            },
+            "output": {"$ref": "#/$defs/key"}
+          }
+        }
+      ]
+    },
+    "transition_instruction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["opcode", "transition_id", "before_ref", "after_ref", "reversibility_class"],
+      "properties": {
+        "opcode": {"const": "transition"},
+        "transition_id": {"$ref": "#/$defs/ref"},
+        "before_ref": {"$ref": "#/$defs/ref"},
+        "after_ref": {"$ref": "#/$defs/ref"},
+        "reversibility_class": {"type": "string", "enum": ["reversible", "compensable", "irreversible", "unknown"]}
+      }
+    },
+    "emit_instruction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["opcode", "code", "value_key"],
+      "properties": {
+        "opcode": {"const": "emit"},
+        "code": {"type": "string", "minLength": 1, "maxLength": 128},
+        "value_key": {"$ref": "#/$defs/key"}
+      }
+    },
+    "halt_instruction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["opcode", "status"],
+      "properties": {
+        "opcode": {"const": "halt"},
+        "status": {"type": "string", "enum": ["passed", "blocked", "insufficient_data"]}
+      }
+    },
+    "instruction": {
+      "oneOf": [
+        {"$ref": "#/$defs/load_instruction"},
+        {"$ref": "#/$defs/assert_instruction"},
+        {"$ref": "#/$defs/derive_instruction"},
+        {"$ref": "#/$defs/transition_instruction"},
+        {"$ref": "#/$defs/emit_instruction"},
+        {"$ref": "#/$defs/halt_instruction"}
+      ]
+    }
+  }
+}

core_runtime/data/schemas/core/contract_program.v2.json

@@ -0,0 +1,187 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://core-runtime-engine.local/schemas/core/contract_program.v2.json",
+  "title": "ContractProgram.v2",
+  "description": "Contract-Oriented Reproducible Evaluation: 6 eslabones, 9 verdicts, DSK v3 declarations.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "contract_id",
+    "eslabones"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "const": "core.contract_program.v2"
+    },
+    "contract_id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "eslabones": {
+      "type": "array",
+      "minItems": 6,
+      "maxItems": 6,
+      "items": {
+        "$ref": "#/$defs/eslabon"
+      }
+    }
+  },
+  "$defs": {
+    "eslabon_name": {
+      "type": "string",
+      "enum": [
+        "PERFIL",
+        "VOCABULARIO",
+        "QUERYSPEC",
+        "RESULTADO",
+        "VISTA",
+        "EVIDENCIA"
+      ]
+    },
+    "authority_ceiling": {
+      "type": "string",
+      "enum": [
+        "reference_only",
+        "advisory_only",
+        "domain_authoritative",
+        "externally_validated"
+      ]
+    },
+    "declared_loss": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "properties",
+        "evidence_refs"
+      ],
+      "properties": {
+        "properties": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256
+          }
+        },
+        "evidence_refs": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256
+          }
+        }
+      }
+    },
+    "temporal_invariant": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "captured_at",
+        "valid_until"
+      ],
+      "properties": {
+        "captured_at": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        },
+        "valid_until": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        }
+      }
+    },
+    "translation_map": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "source_field",
+        "target_field"
+      ],
+      "properties": {
+        "source_field": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "target_field": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        }
+      }
+    },
+    "paraphrase_intent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "confirmed_by"
+      ],
+      "properties": {
+        "confirmed_by": {
+          "type": "string",
+          "enum": [
+            "operator",
+            "agent"
+          ]
+        }
+      }
+    },
+    "dsk_declaration": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "composition_rule",
+        "declared_loss",
+        "authority_ceiling"
+      ],
+      "properties": {
+        "composition_rule": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "declared_loss": {
+          "$ref": "#/$defs/declared_loss"
+        },
+        "authority_ceiling": {
+          "$ref": "#/$defs/authority_ceiling"
+        },
+        "temporal_invariant": {
+          "$ref": "#/$defs/temporal_invariant"
+        },
+        "translation_map": {
+          "$ref": "#/$defs/translation_map"
+        },
+        "paraphrase_intent": {
+          "$ref": "#/$defs/paraphrase_intent"
+        }
+      }
+    },
+    "eslabon": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "dsk_declaration"
+      ],
+      "properties": {
+        "name": {
+          "$ref": "#/$defs/eslabon_name"
+        },
+        "dsk_declaration": {
+          "$ref": "#/$defs/dsk_declaration"
+        }
+      }
+    }
+  }
+}

core_runtime/data/schemas/core/control_decision.v1.json

@@ -0,0 +1,114 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://core-runtime-engine.local/schemas/core/control_decision.v1.json",
+  "title": "ControlDecision.v1",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema_version",
+    "type",
+    "decision_id",
+    "intent_ref",
+    "target_ref",
+    "decision",
+    "reason",
+    "policy_refs",
+    "entropy_signal_refs",
+    "reversibility_class",
+    "evidence_required",
+    "created_at",
+    "fingerprint"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "const": "core.control_decision.v1"
+    },
+    "type": {
+      "type": "string",
+      "const": "control_decision"
+    },
+    "decision_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "intent_ref": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?!/).+"
+    },
+    "target_ref": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?!/).+"
+    },
+    "decision": {
+      "type": "string",
+      "enum": ["allow", "simulate_only", "require_confirmation", "block"]
+    },
+    "reason": {
+      "type": "string",
+      "minLength": 1
+    },
+    "policy_refs": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "pattern": "^(?!/).+"
+      }
+    },
+    "entropy_signal_refs": {
+      "type": "array",
+      "minItems": 0,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "pattern": "^(?!/).+"
+      }
+    },
+    "reversibility_class": {
+      "type": "string",
+      "enum": ["reversible", "compensable", "irreversible", "unknown"]
+    },
+    "evidence_required": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "source_refs": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "pattern": "^(?!/).+"
+      }
+    },
+    "evidence_refs": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "pattern": "^(?!/).+"
+      }
+    },
+    "created_at": {
+      "type": "string",
+      "minLength": 1
+    },
+    "fingerprint": {
+      "type": "string",
+      "minLength": 1
+    },
+    "warnings": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  }
+}

core_runtime/data/schemas/core/dsk.v3.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://core-runtime-engine.local/schemas/core/dsk.v3.json",
+  "title": "Deterministic Scale Kernel v3",
+  "description": "One explicit, typed and reproducible scale crossing.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "dsk_id", "crossing", "authority", "captured_at"],
+  "properties": {
+    "schema_version": {"type": "string", "const": "core.dsk.v3"},
+    "dsk_id": {"type": "string", "minLength": 1, "maxLength": 256},
+    "crossing": {"$ref": "#/$defs/crossing"},
+    "authority": {"$ref": "#/$defs/authority"},
+    "captured_at": {"type": "string", "minLength": 1, "maxLength": 64},
+    "policies": {"$ref": "#/$defs/policies"}
+  },
+  "$defs": {
+    "quantity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["resource", "unit"],
+      "properties": {
+        "resource": {"type": "string", "minLength": 1, "maxLength": 128},
+        "unit": {"type": "string", "minLength": 1, "maxLength": 128},
+        "value": {"type": "number"}
+      }
+    },
+    "conversion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source_unit", "target_unit", "numerator", "denominator"],
+      "properties": {
+        "source_unit": {"type": "string", "minLength": 1, "maxLength": 128},
+        "target_unit": {"type": "string", "minLength": 1, "maxLength": 128},
+        "numerator": {"type": "integer", "minimum": 1},
+        "denominator": {"type": "integer", "minimum": 1}
+      }
+    },
+    "crossing": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source", "target", "conversion", "composition_rule", "declared_loss", "evidence_refs"],
+      "properties": {
+        "source": {"$ref": "#/$defs/quantity"},
+        "target": {"$ref": "#/$defs/quantity"},
+        "conversion": {"$ref": "#/$defs/conversion"},
+        "composition_rule": {"type": "string", "minLength": 1, "maxLength": 256},
+        "declared_loss": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {"type": "string", "minLength": 1, "maxLength": 256}
+        },
+        "evidence_refs": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {"type": "string", "minLength": 1, "maxLength": 256}
+        }
+      }
+    },
+    "authority": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ceiling", "source"],
+      "properties": {
+        "ceiling": {
+          "type": "string",
+          "enum": ["reference_only", "advisory_only", "domain_authoritative", "externally_validated"]
+        },
+        "source": {"type": "string", "enum": ["source_declaration", "external_validator"]}
+      }
+    },
+    "policies": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "discrete_multiple": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["multiple"],
+          "properties": {
+            "multiple": {"type": "integer", "minimum": 1}
+          }
+        },
+        "resolution": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["max_decimal_places"],
+          "properties": {
+            "max_decimal_places": {"type": "integer", "minimum": 0, "maximum": 18}
+          }
+        },
+        "threshold": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["minimum_value"],
+          "properties": {
+            "minimum_value": {"type": "number"}
+          }
+        }
+      }
+    }
+  }
+}

core_runtime/data/schemas/core/effect_result.v1.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://core-runtime-engine.local/schemas/core/effect_result.v1.json",
+  "title": "EffectResult.v1",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schema_version", "status", "effect_type", "dry_run", "reason"],
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "const": "core.effect_result.v1"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["dry_run", "sent", "skipped", "applied", "failed"]
+    },
+    "effect_type": {
+      "type": "string",
+      "minLength": 1
+    },
+    "dry_run": {
+      "type": "boolean"
+    },
+    "reason": {
+      "type": "string"
+    },
+    "provider": {
+      "type": "string"
+    },
+    "target_ref": {
+      "type": "string"
+    },
+    "payload": {},
+    "response": {},
+    "error": {
+      "type": "string"
+    }
+  }
+}