@nebulacomponents/citable 1.18.2 → 1.20.0

package/dist/universal/.agents/skills/citable/schemas/browser-evidence-plan.schema.json

@@ -5,6 +5,181 @@
   "type": "object",
   "additionalProperties": false,
   "required": ["schema_version", "plan_id", "target", "profiles", "limitations"],
+  "definitions": {
+    "network_policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "allowed_host_patterns": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "allowed_methods": {
+          "type": "array",
+          "items": { "type": "string", "enum": ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"] }
+        },
+        "allowed_resource_types": {
+          "type": "array",
+          "items": { "type": "string", "enum": ["document", "stylesheet", "image", "media", "font", "script", "texttrack", "xhr", "fetch", "eventsource", "websocket", "manifest", "other"] }
+        },
+        "capture_request_headers": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "capture_response_headers": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "capture_query_params": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "capture_payload": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "request_body": { "type": "boolean" },
+            "response_body": { "type": "boolean" },
+            "allowed_json_fields": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 }
+            },
+            "hash_only": { "type": "boolean" },
+            "max_bytes": { "type": "integer", "minimum": 0, "maximum": 65536 }
+          }
+        },
+        "max_events": { "type": "integer", "minimum": 1, "maximum": 1000 },
+        "max_field_size": { "type": "integer", "minimum": 1, "maximum": 8192 },
+        "settling_timeout_ms": { "type": "integer", "minimum": 0, "maximum": 5000 }
+      }
+    },
+    "state_policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "checkpoints": {
+          "type": "array",
+          "items": { "type": "string", "enum": ["initial", "step", "final"] }
+        },
+        "capture_url": { "type": "boolean" },
+        "allowed_query_params": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "capture_referrer": { "type": "boolean" },
+        "capture_navigation": { "type": "boolean" },
+        "cookies": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "allowed_names": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 }
+            },
+            "mode": { "enum": ["presence_only", "hash_only", "allowlist_values"] },
+            "max_keys": { "type": "integer", "minimum": 1, "maximum": 100 }
+          }
+        },
+        "local_storage": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "allowed_keys": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 }
+            },
+            "mode": { "enum": ["presence_only", "hash_only", "allowlist_values"] },
+            "max_keys": { "type": "integer", "minimum": 1, "maximum": 100 }
+          }
+        },
+        "session_storage": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "allowed_keys": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 }
+            },
+            "mode": { "enum": ["presence_only", "hash_only", "allowlist_values"] },
+            "max_keys": { "type": "integer", "minimum": 1, "maximum": 100 }
+          }
+        },
+        "globals": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name", "expression"],
+            "properties": {
+              "name": { "type": "string", "pattern": "^[a-zA-Z0-9_.-]+$" },
+              "expression": { "type": "string", "pattern": "^[a-zA-Z0-9_$.\\[\\]'\"]+$" },
+              "mode": { "enum": ["presence_only", "type_only", "hash_only", "scalar_value"] }
+            }
+          }
+        },
+        "dom_queries": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name", "selector", "property"],
+            "properties": {
+              "name": { "type": "string", "pattern": "^[a-zA-Z0-9_.-]+$" },
+              "selector": { "type": "string", "minLength": 1 },
+              "property": { "enum": ["presence", "visible", "text_hash", "text_length", "text_content", "attribute_value"] },
+              "attribute_name": { "type": "string" }
+            }
+          }
+        },
+        "max_observations": { "type": "integer", "minimum": 1, "maximum": 500 },
+        "max_value_length": { "type": "integer", "minimum": 1, "maximum": 4096 }
+      }
+    },
+    "runtime_event_policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "sources": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["source_id", "type"],
+            "properties": {
+              "source_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
+              "type": { "enum": ["global_array", "window_event", "custom_stream"] },
+              "global_name": { "type": "string", "pattern": "^[a-zA-Z0-9_.]+$" },
+              "event_name": { "type": "string", "minLength": 1 },
+              "event_name_key": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "allowed_event_names": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "allowed_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "hash_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "redact_fields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "max_events": { "type": "integer", "minimum": 1, "maximum": 1000 },
+        "max_payload_depth": { "type": "integer", "minimum": 1, "maximum": 10 },
+        "max_field_size": { "type": "integer", "minimum": 1, "maximum": 4096 }
+      }
+    }
+  },
   "properties": {
     "schema_version": { "const": 1 },
     "plan_id": { "type": "string", "pattern": "^BROWSER-PLAN-[A-Z0-9_-]+$" },
@@ -16,13 +191,16 @@
       "properties": {
         "policy_id": { "type": "string", "pattern": "^RENDER-POLICY-[A-Z0-9_-]+$" },
         "review_owner": { "type": "string", "minLength": 1 },
-        "min_text_retention_ratio": { "type": "number", "minimum": 0, "maximum": 1 },
+        "min_text_retention_ratio": { "number": 0, "minimum": 0, "maximum": 1 },
         "require_heading_parity": { "type": "boolean" },
         "require_link_parity": { "type": "boolean" },
         "require_structured_data_parity": { "type": "boolean" },
         "limitations": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
       }
     },
+    "network_policy": { "$ref": "#/definitions/network_policy" },
+    "state_policy": { "$ref": "#/definitions/state_policy" },
+    "runtime_event_policy": { "$ref": "#/definitions/runtime_event_policy" },
     "profiles": {
       "type": "array",
       "minItems": 1,
@@ -63,6 +241,9 @@
           "locale": { "type": "string", "minLength": 2 },
           "consent_state": { "enum": ["not_present", "denied", "granted", "unresolved", "unknown"] },
           "authentication_state": { "enum": ["anonymous", "owner_authenticated", "unresolved", "unknown"] },
+          "network_policy": { "$ref": "#/definitions/network_policy" },
+          "state_policy": { "$ref": "#/definitions/state_policy" },
+          "runtime_event_policy": { "$ref": "#/definitions/runtime_event_policy" },
           "steps": {
             "type": "array",
             "items": {
@@ -71,13 +252,15 @@
               "required": ["step_id", "action", "locator", "value_env", "key", "url", "required", "capture_screenshot"],
               "properties": {
                 "step_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
-                "action": { "enum": ["navigate", "click", "fill", "select_option", "check", "press", "wait_for", "assert_visible", "scroll"] },
+                "action": { "enum": ["navigate", "click", "fill", "select_option", "check", "press", "wait_for", "assert_visible", "scroll", "checkpoint"] },
                 "locator": { "type": ["string", "null"] },
                 "value_env": { "type": ["string", "null"], "pattern": "^[A-Z][A-Z0-9_]*$" },
                 "key": { "type": ["string", "null"] },
                 "url": { "type": ["string", "null"], "format": "uri" },
                 "required": { "type": "boolean" },
-                "capture_screenshot": { "type": "boolean" }
+                "capture_screenshot": { "type": "boolean" },
+                "checkpoint_id": { "type": ["string", "null"], "pattern": "^[a-z0-9][a-z0-9_-]*$" },
+                "state_checkpoint": { "type": ["boolean", "null"] }
               }
             }
           },

package/dist/universal/.agents/skills/citable/schemas/browser-network-events.schema.json

@@ -0,0 +1,142 @@
+{
+  "$id": "citable://schemas/browser-network-events.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Browser network activity evidence artifact",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "plan_id",
+    "profile_id",
+    "collected_at",
+    "capture_policy",
+    "summary",
+    "events"
+  ],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "plan_id": { "type": "string" },
+    "profile_id": { "type": "string" },
+    "collected_at": { "type": "string", "format": "date-time" },
+    "capture_policy": { "type": "object" },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["total_requests", "successful_responses", "failed_requests", "filtered_requests", "truncated", "status_codes"],
+      "properties": {
+        "total_requests": { "type": "integer", "minimum": 0 },
+        "successful_responses": { "type": "integer", "minimum": 0 },
+        "failed_requests": { "type": "integer", "minimum": 0 },
+        "filtered_requests": { "type": "integer", "minimum": 0 },
+        "in_flight_requests": { "type": "integer", "minimum": 0 },
+        "collector_status": { "enum": ["complete", "truncated", "failed"] },
+        "truncated": { "type": "boolean" },
+        "truncation_reason": { "type": ["string", "null"] },
+        "status_codes": {
+          "type": "object",
+          "additionalProperties": { "type": "integer" }
+        }
+      }
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "sequence",
+          "transaction_id",
+          "direction",
+          "phase",
+          "timing",
+          "correlation",
+          "request"
+        ],
+        "properties": {
+          "sequence": { "type": "integer", "minimum": 1 },
+          "transaction_id": { "type": "string" },
+          "direction": { "enum": ["request", "response"] },
+          "phase": { "enum": ["request_sent", "response_received", "failed", "redirect"] },
+          "timing": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["monotonic_offset_ms", "timestamp"],
+            "properties": {
+              "monotonic_offset_ms": { "type": "number", "minimum": 0 },
+              "timestamp": { "type": "string", "format": "date-time" }
+            }
+          },
+          "correlation": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["step_id", "step_sequence", "attribution_phase"],
+            "properties": {
+              "step_id": { "type": ["string", "null"] },
+              "step_sequence": { "type": ["integer", "null"] },
+              "checkpoint_id": { "type": ["string", "null"] },
+              "attribution_phase": { "enum": ["initial", "during_step", "between_steps", "post_journey", "ambiguous_async"] },
+              "initiated_step_id": { "type": ["string", "null"] },
+              "completed_step_id": { "type": ["string", "null"] },
+              "ambiguous_async": { "type": "boolean" }
+            }
+          },
+          "request": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["url", "method", "scheme", "host", "path", "resource_type"],
+            "properties": {
+              "url": { "type": "string" },
+              "method": { "type": "string" },
+              "scheme": { "type": "string" },
+              "host": { "type": "string" },
+              "path": { "type": "string" },
+              "resource_type": { "type": "string" },
+              "query": { "type": ["object", "null"] },
+              "query_status": { "enum": ["captured", "not_requested", "filtered", "none_present", "redacted"] },
+              "headers": { "type": ["object", "null"] },
+              "headers_status": { "enum": ["captured", "not_requested", "filtered", "redacted"] },
+              "payload_hash": { "type": ["string", "null"] },
+              "payload_bytes": { "type": ["integer", "null"] },
+              "payload_fields": { "type": ["object", "null"] },
+              "payload_status": { "enum": ["not_requested", "captured", "filtered", "truncated", "unavailable", "hash_only"] }
+            }
+          },
+          "response": {
+            "type": ["object", "null"],
+            "additionalProperties": false,
+            "properties": {
+              "status": { "type": "integer" },
+              "status_text": { "type": "string" },
+              "headers": { "type": ["object", "null"] },
+              "headers_status": { "enum": ["captured", "not_requested", "filtered", "redacted"] },
+              "mime_type": { "type": ["string", "null"] },
+              "body_hash": { "type": ["string", "null"] },
+              "body_bytes": { "type": ["integer", "null"] },
+              "body_fields": { "type": ["object", "null"] },
+              "body_status": { "enum": ["not_requested", "captured", "filtered", "truncated", "unavailable", "hash_only"] },
+              "redirect_url": { "type": ["string", "null"] },
+              "from_cache": { "type": "boolean" }
+            }
+          },
+          "failure": {
+            "type": ["object", "null"],
+            "additionalProperties": false,
+            "properties": {
+              "error_text": { "type": "string" }
+            }
+          },
+          "disposition": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["capture_status", "redacted_count", "filtered_fields"],
+            "properties": {
+              "capture_status": { "enum": ["captured", "filtered", "redacted", "truncated", "error"] },
+              "redacted_count": { "type": "integer", "minimum": 0 },
+              "filtered_fields": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/universal/.agents/skills/citable/schemas/browser-runtime-events.schema.json

@@ -0,0 +1,112 @@
+{
+  "$id": "citable://schemas/browser-runtime-events.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Browser runtime events evidence artifact",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "plan_id",
+    "profile_id",
+    "collected_at",
+    "capture_policy",
+    "summary",
+    "events"
+  ],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "plan_id": { "type": "string" },
+    "profile_id": { "type": "string" },
+    "collected_at": { "type": "string", "format": "date-time" },
+    "capture_policy": { "type": "object" },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["total_events", "by_source", "by_event_name", "truncated"],
+      "properties": {
+        "total_events": { "type": "integer", "minimum": 0 },
+        "filtered_events": { "type": "integer", "minimum": 0 },
+        "collector_status": { "enum": ["complete", "truncated", "failed"] },
+        "by_source": {
+          "type": "object",
+          "additionalProperties": { "type": "integer" }
+        },
+        "by_event_name": {
+          "type": "object",
+          "additionalProperties": { "type": "integer" }
+        },
+        "truncated": { "type": "boolean" },
+        "truncation_reason": { "type": ["string", "null"] },
+        "collector_health": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "status": { "type": "string" },
+            "queue_replaced": { "type": "boolean" },
+            "push_replaced": { "type": "boolean" },
+            "polling_fallback_used": { "type": "boolean" },
+            "supported_contexts": { "type": "array", "items": { "type": "string" } },
+            "unsupported_contexts": { "type": "array", "items": { "type": "string" } }
+          }
+        }
+      }
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "sequence",
+          "source_id",
+          "event_name",
+          "timing",
+          "correlation",
+          "payload"
+        ],
+        "properties": {
+          "sequence": { "type": "integer", "minimum": 1 },
+          "source_id": { "type": "string" },
+          "event_name": { "type": "string" },
+          "occurrence_index": { "type": "integer", "minimum": 1 },
+          "timing": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["monotonic_offset_ms", "timestamp"],
+            "properties": {
+              "monotonic_offset_ms": { "type": "number", "minimum": 0 },
+              "timestamp": { "type": "string", "format": "date-time" }
+            }
+          },
+          "correlation": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["step_id", "step_sequence", "attribution_phase"],
+            "properties": {
+              "step_id": { "type": ["string", "null"] },
+              "step_sequence": { "type": ["integer", "null"] },
+              "checkpoint_id": { "type": ["string", "null"] },
+              "attribution_phase": { "enum": ["initial", "during_step", "between_steps", "post_journey", "ambiguous_async"] },
+              "initiated_step_id": { "type": ["string", "null"] },
+              "completed_step_id": { "type": ["string", "null"] },
+              "ambiguous_async": { "type": "boolean" }
+            }
+          },
+          "payload": {
+            "type": "object"
+          },
+          "disposition": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["capture_status", "redacted_count", "filtered_fields"],
+            "properties": {
+              "capture_status": { "enum": ["captured", "filtered", "redacted", "truncated"] },
+              "redacted_count": { "type": "integer", "minimum": 0 },
+              "filtered_fields": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/universal/.agents/skills/citable/schemas/browser-state-observations.schema.json

@@ -0,0 +1,97 @@
+{
+  "$id": "citable://schemas/browser-state-observations.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Browser state observations evidence artifact",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "plan_id",
+    "profile_id",
+    "collected_at",
+    "capture_policy",
+    "summary",
+    "checkpoints"
+  ],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "plan_id": { "type": "string" },
+    "profile_id": { "type": "string" },
+    "collected_at": { "type": "string", "format": "date-time" },
+    "capture_policy": { "type": "object" },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["total_checkpoints", "total_observations", "truncated"],
+      "properties": {
+        "total_checkpoints": { "type": "integer", "minimum": 0 },
+        "total_observations": { "type": "integer", "minimum": 0 },
+        "collector_status": { "enum": ["complete", "truncated", "failed"] },
+        "truncated": { "type": "boolean" },
+        "truncation_reason": { "type": ["string", "null"] }
+      }
+    },
+    "checkpoints": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "checkpoint_id",
+          "sequence",
+          "timing",
+          "correlation",
+          "state"
+        ],
+        "properties": {
+          "checkpoint_id": { "type": "string" },
+          "sequence": { "type": "integer", "minimum": 1 },
+          "timing": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["monotonic_offset_ms", "timestamp"],
+            "properties": {
+              "monotonic_offset_ms": { "type": "number", "minimum": 0 },
+              "timestamp": { "type": "string", "format": "date-time" }
+            }
+          },
+          "correlation": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["step_id", "step_sequence"],
+            "properties": {
+              "step_id": { "type": ["string", "null"] },
+              "step_sequence": { "type": ["integer", "null"] }
+            }
+          },
+          "state": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["url"],
+            "properties": {
+              "url": { "type": "string" },
+              "query_params": { "type": ["object", "null"] },
+              "referrer": { "type": ["string", "null"] },
+              "navigation_type": { "type": ["string", "null"] },
+              "cookies": { "type": ["object", "null"] },
+              "local_storage": { "type": ["object", "null"] },
+              "session_storage": { "type": ["object", "null"] },
+              "globals": { "type": ["object", "null"] },
+              "dom_queries": { "type": ["object", "null"] }
+            }
+          },
+          "disposition": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["observation_status", "redacted_count", "unavailable_items"],
+            "properties": {
+              "observation_status": { "enum": ["observed", "partially_observed", "truncated", "unavailable"] },
+              "redacted_count": { "type": "integer", "minimum": 0 },
+              "unavailable_items": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/universal/.agents/skills/citable/schemas/collection-result.schema.json

@@ -0,0 +1,35 @@
+{
+  "$id": "citable://schemas/collection-result.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Collection result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "items",
+    "pagination_state",
+    "provider_reported_total",
+    "retrieved_total",
+    "coverage_status",
+    "continuation_state",
+    "limitations",
+    "errors"
+  ],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "items": {
+      "type": "array",
+      "items": {}
+    },
+    "pagination_state": { "type": "object" },
+    "provider_reported_total": { "type": ["integer", "null"], "minimum": 0 },
+    "retrieved_total": { "type": "integer", "minimum": 0 },
+    "coverage_status": {
+      "type": "string",
+      "enum": ["complete", "truncated", "indeterminate", "provider_bounded"]
+    },
+    "continuation_state": { "type": ["object", "null"] },
+    "limitations": { "type": "array", "items": { "type": "string" } },
+    "errors": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/dist/universal/.agents/skills/citable/schemas/config.schema.json

@@ -30,6 +30,8 @@
       "type": "object",
       "properties": {
         "index_target_default": { "type": "boolean" },
+        "max_pages": { "type": "integer", "minimum": 1, "maximum": 10000 },
+        "time_budget_seconds": { "type": "integer", "minimum": 1, "maximum": 86400 },
         "max_crawl_depth": { "type": "integer", "minimum": 1 },
         "thin_content_words": { "type": "integer", "minimum": 1 },
         "fetch_external": { "type": "boolean" },

package/dist/universal/.agents/skills/citable/schemas/cro-report.schema.json

@@ -103,7 +103,14 @@
         "source_identifier": { "type": ["string", "null"] },
         "source_findings_count": { "type": "integer", "minimum": 0 },
         "integrity_hash": { "type": ["string", "null"] },
-        "synthetic_evidence": { "type": "boolean" }
+        "synthetic_evidence": { "type": "boolean" },
+        "package_verified": { "type": "boolean" },
+        "integrity_mode": { "type": "string" },
+        "legacy": { "type": "boolean" },
+        "coverage_status": { "type": "string" },
+        "determination_status": { "type": "string" },
+        "evaluated": { "type": ["integer", "null"], "minimum": 0 },
+        "eligible": { "type": ["integer", "null"], "minimum": 0 }
       },
       "additionalProperties": false
     }