planr 1.9.0 → 1.10.0-alpha.2

package/scripts/host-capability-runtime/v1/schemas/host-capability-observed-raw.schema.json

@@ -0,0 +1,439 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "planr.host_capability_observed_raw.schema.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "payload_version",
+    "experiment_id",
+    "host_identity",
+    "surface",
+    "tool_name",
+    "event_source",
+    "started_at",
+    "ended_at",
+    "input",
+    "events",
+    "result",
+    "provenance_ref"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "planr.host_capability_observed_raw.v1"
+    },
+    "payload_version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "experiment_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "host_identity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "host",
+        "surface",
+        "version",
+        "adapter_version"
+      ],
+      "properties": {
+        "host": {
+          "type": "string",
+          "minLength": 1
+        },
+        "surface": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "adapter_version": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "surface": {
+      "type": "string",
+      "minLength": 1
+    },
+    "tool_name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "event_source": {
+      "type": "string",
+      "minLength": 1
+    },
+    "started_at": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$"
+    },
+    "ended_at": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$"
+    },
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "input_kind"
+      ],
+      "properties": {
+        "input_kind": {
+          "type": "string",
+          "minLength": 1
+        },
+        "command": {
+          "oneOf": [
+            {
+              "type": "string",
+              "minLength": 1
+            },
+            {
+              "type": "array"
+            }
+          ]
+        },
+        "cwd": {
+          "type": "string",
+          "minLength": 1
+        },
+        "javascript": {
+          "type": "string",
+          "minLength": 1
+        },
+        "probe": {
+          "type": "string",
+          "minLength": 1
+        },
+        "replay_mode": {
+          "type": "string",
+          "minLength": 1
+        },
+        "attempts": {
+          "type": "integer"
+        },
+        "reset_between_attempts": {
+          "type": "boolean"
+        },
+        "tool": {
+          "type": "string",
+          "minLength": 1
+        },
+        "arguments": {
+          "type": "object"
+        },
+        "navigation": {
+          "oneOf": [
+            {
+              "type": "string",
+              "minLength": 1
+            },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "url": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            }
+          ]
+        },
+        "setup": {
+          "oneOf": [
+            {
+              "type": "string",
+              "minLength": 1
+            },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {}
+            }
+          ]
+        },
+        "operations": {
+          "type": "array"
+        },
+        "ui_write_actions": {
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "array"
+            }
+          ]
+        },
+        "function": {
+          "type": "string",
+          "minLength": 1
+        },
+        "args": {
+          "type": "array"
+        }
+      }
+    },
+    "events": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "sequence",
+          "event_name",
+          "payload_version",
+          "tool_name",
+          "event_source",
+          "payload"
+        ],
+        "properties": {
+          "sequence": {
+            "type": "integer"
+          },
+          "event_name": {
+            "type": "string",
+            "minLength": 1
+          },
+          "final": {
+            "type": "boolean"
+          },
+          "payload_version": {
+            "type": "string",
+            "minLength": 1
+          },
+          "tool_name": {
+            "type": "string",
+            "minLength": 1
+          },
+          "event_source": {
+            "type": "string",
+            "minLength": 1
+          },
+          "payload": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "input_kind": {
+                "type": "string",
+                "minLength": 1
+              },
+              "final_status": {
+                "type": "string",
+                "minLength": 1
+              },
+              "status": {
+                "type": "string",
+                "minLength": 1
+              },
+              "isError": {
+                "type": "boolean"
+              },
+              "error": {
+                "type": "string",
+                "minLength": 1
+              },
+              "redacted_message": {
+                "type": "string",
+                "minLength": 1
+              },
+              "exit_code": {
+                "type": "integer"
+              },
+              "call_tool_keys": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "title": {
+                "type": "string",
+                "minLength": 1
+              },
+              "url": {
+                "type": "string",
+                "minLength": 1
+              },
+              "heading_count": {
+                "type": "integer"
+              },
+              "bodyVisible": {
+                "type": "boolean"
+              }
+            }
+          }
+        }
+      }
+    },
+    "result": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "final_status",
+        "availability_reason",
+        "permissions",
+        "sandbox",
+        "missing_fields",
+        "blind_spots",
+        "artifact_refs",
+        "artifact_digests"
+      ],
+      "properties": {
+        "final_status": {
+          "type": "string",
+          "minLength": 1
+        },
+        "availability_reason": {
+          "type": "string",
+          "minLength": 1
+        },
+        "permissions": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "network",
+            "filesystem"
+          ],
+          "properties": {
+            "network": {
+              "type": "string",
+              "minLength": 1
+            },
+            "filesystem": {
+              "type": "string",
+              "minLength": 1
+            },
+            "environment": {
+              "type": "string",
+              "minLength": 1
+            },
+            "secrets": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        },
+        "sandbox": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "mode",
+            "writable_roots"
+          ],
+          "properties": {
+            "mode": {
+              "type": "string",
+              "minLength": 1
+            },
+            "writable_roots": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          }
+        },
+        "missing_fields": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "blind_spots": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "artifact_refs": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "kind",
+              "root_kind",
+              "path",
+              "digest"
+            ],
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1
+              },
+              "kind": {
+                "type": "string",
+                "minLength": 1
+              },
+              "root_kind": {
+                "type": "string",
+                "minLength": 1
+              },
+              "path": {
+                "type": "string",
+                "minLength": 1
+              },
+              "digest": {
+                "type": "string",
+                "pattern": "^sha256:[0-9a-f]{64}$"
+              }
+            }
+          }
+        },
+        "artifact_digests": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string",
+            "pattern": "^sha256:[0-9a-f]{64}$"
+          }
+        },
+        "experiment_plan": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "notes": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "provenance_ref": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "digest"
+      ],
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "digest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        }
+      }
+    }
+  }
+}

package/scripts/host-capability-runtime/v1/schemas/host-capability-provenance.schema.json

@@ -0,0 +1,178 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "planr.host_capability_provenance.schema.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "schema_ref",
+    "schema_digest",
+    "suite_id",
+    "captures"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "planr.host_capability_provenance.v1"
+    },
+    "schema_ref": {
+      "type": "string",
+      "minLength": 1
+    },
+    "schema_digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "suite_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "captures": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "experiment_id",
+          "source_kind",
+          "host",
+          "surface",
+          "input_kind",
+          "observation_mode",
+          "tool_name",
+          "event_source",
+          "host_version",
+          "adapter_version",
+          "claim_source",
+          "availability_reason",
+          "probe_checks",
+          "missing_fields",
+          "artifact_ids",
+          "captured_at"
+        ],
+        "properties": {
+          "experiment_id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "source_kind": {
+            "type": "string",
+            "minLength": 1
+          },
+          "host": {
+            "type": "string",
+            "minLength": 1
+          },
+          "surface": {
+            "type": "string",
+            "minLength": 1
+          },
+          "input_kind": {
+            "type": "string",
+            "minLength": 1
+          },
+          "observation_mode": {
+            "type": "string",
+            "minLength": 1
+          },
+          "tool_name": {
+            "type": "string",
+            "minLength": 1
+          },
+          "event_source": {
+            "type": "string",
+            "minLength": 1
+          },
+          "host_version": {
+            "type": "string",
+            "minLength": 1
+          },
+          "adapter_version": {
+            "type": "string",
+            "minLength": 1
+          },
+          "claim_source": {
+            "type": "string",
+            "minLength": 1
+          },
+          "availability_reason": {
+            "type": "string",
+            "minLength": 1
+          },
+          "probe_checks": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "name",
+                "outcome"
+              ],
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "outcome": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "detail": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            }
+          },
+          "missing_fields": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "artifact_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "captured_at": {
+            "type": "string",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$"
+          },
+          "external_producer": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "name",
+              "version",
+              "captured_at",
+              "envelope_digest"
+            ],
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1
+              },
+              "version": {
+                "type": "string",
+                "minLength": 1
+              },
+              "captured_at": {
+                "type": "string",
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$"
+              },
+              "envelope_digest": {
+                "type": "string",
+                "pattern": "^sha256:[0-9a-f]{64}$"
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/scripts/planr-host-capability-validator

@@ -0,0 +1,51 @@
+#!/usr/bin/env sh
+set -eu
+
+script_dir="$(CDPATH=; cd -- "$(dirname -- "$0")" && pwd)"
+package_root="$(CDPATH=; cd -- "$script_dir/.." && pwd)"
+
+detect_target() {
+  os_name="$(uname -s | tr '[:upper:]' '[:lower:]')"
+  arch_name="$(uname -m)"
+
+  case "$os_name" in
+    darwin) os_name="darwin" ;;
+    linux) os_name="linux" ;;
+    *)
+      echo "unsupported OS for planr-host-capability-validator: $os_name" >&2
+      exit 127
+      ;;
+  esac
+
+  case "$arch_name" in
+    arm64 | aarch64) arch_name="arm64" ;;
+    x86_64 | amd64) arch_name="x86_64" ;;
+    *)
+      echo "unsupported architecture for planr-host-capability-validator: $arch_name" >&2
+      exit 127
+      ;;
+  esac
+
+  printf '%s-%s\n' "$os_name" "$arch_name"
+}
+
+target="${PLANR_TARGET:-$(detect_target)}"
+
+for candidate in \
+  "$package_root/npm/native/$target/planr-host-capability-validator" \
+  "$package_root/target/release/planr-host-capability-validator" \
+  "$package_root/target/debug/planr-host-capability-validator"
+do
+  if [ -x "$candidate" ]; then
+    exec "$candidate" "$@"
+  fi
+done
+
+if [ -f "$package_root/Cargo.toml" ]; then
+  cargo build --manifest-path "$package_root/Cargo.toml" --bin planr-host-capability-validator >/dev/null
+  exec "$package_root/target/debug/planr-host-capability-validator" "$@"
+fi
+
+echo "planr-host-capability-validator binary was not found for $target" >&2
+echo "Expected npm/native/$target/planr-host-capability-validator or a local cargo build." >&2
+exit 127