nexakit 0.0.0-stage → 0.2.0

package/schemas/agent-client-native-preflight.schema.json

@@ -0,0 +1,90 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-toolkit.local/schemas/agent-client-native-preflight.schema.json",
+  "$defs": {
+    "sha": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+    "ref": {"type": ["string", "null"], "pattern": "^[a-z][a-z0-9-]{0,63}$"},
+    "time": {"type": ["string", "null"], "format": "date-time"},
+    "assessment": {
+      "type": "object", "additionalProperties": false,
+      "required": ["source", "referenceId", "checkedAt", "scopeSha256"],
+      "properties": {
+        "source": {"enum": ["documented", "operator-attested", "locally-observed", "pending"]},
+        "referenceId": {"$ref": "#/$defs/ref"}, "checkedAt": {"$ref": "#/$defs/time"},
+        "scopeSha256": {"anyOf": [{"$ref": "#/$defs/sha"}, {"type": "null"}]}
+      }
+    },
+    "field": {
+      "type": "object", "additionalProperties": false,
+      "required": ["name", "state", "assessment"],
+      "properties": {
+        "name": {"enum": ["policy", "hooks", "commands", "mcp", "connectors", "api-helper", "third-party", "fallback", "delegation"]},
+        "state": {"enum": ["absent", "disabled", "present", "unknown"]}, "assessment": {"$ref": "#/$defs/assessment"}
+      }
+    },
+    "projection": {
+      "type": "object", "additionalProperties": false, "required": ["safeSource", "fields"],
+      "properties": {"safeSource": {"type": "boolean"}, "fields": {"type": "array", "maxItems": 9, "items": {"$ref": "#/$defs/field"}}}
+    },
+    "auth": {
+      "type": "object", "additionalProperties": false,
+      "required": ["loggedIn", "authMethod", "subscriptionType"],
+      "properties": {
+        "loggedIn": {"type": "boolean"},
+        "authMethod": {"enum": ["none", "claude.ai", "oauth_token", "api_key", "api_key_helper", "third_party"]},
+        "subscriptionType": {"enum": ["pro", "max", "team", "enterprise", "free", null]}
+      }
+    },
+    "access": {
+      "type": "object", "additionalProperties": false, "required": ["data", "assessment"],
+      "properties": {"data": {"$ref": "#/$defs/auth"}, "assessment": {"$ref": "#/$defs/assessment"}}
+    },
+    "economy": {
+      "type": "object", "additionalProperties": false,
+      "required": ["state", "source", "referenceId", "receivedAt", "scopeSha256", "sessionContinuity"],
+      "properties": {
+        "state": {"enum": ["disabled", "enabled", "unknown"]}, "source": {"enum": ["operator-attested", "pending"]},
+        "referenceId": {"$ref": "#/$defs/ref"}, "receivedAt": {"$ref": "#/$defs/time"},
+        "scopeSha256": {"anyOf": [{"$ref": "#/$defs/sha"}, {"type": "null"}]}, "sessionContinuity": {"type": ["boolean", "null"]}
+      }
+    },
+    "input": {
+      "type": "object", "additionalProperties": false,
+      "required": ["schemaVersion", "scope", "now", "candidateScopeSha256", "projection"],
+      "properties": {
+        "schemaVersion": {"const": "1.0.0"}, "scope": {"const": "native-preflight-only"},
+        "now": {"type": "string", "format": "date-time"}, "candidateScopeSha256": {"$ref": "#/$defs/sha"},
+        "projection": {"$ref": "#/$defs/projection"}, "access": {"$ref": "#/$defs/access"}, "economy": {"$ref": "#/$defs/economy"}
+      }
+    },
+    "accessReport": {
+      "type": "object", "additionalProperties": false,
+      "required": ["scope", "state", "nativeExecuted", "spawnAttempts", "inferenceRequested", "actualModelCalls", "runtimeReady", "verifiedAdmission", "externalBillingVerified", "remoteCancellationVerified", "terminationConfirmed", "stdoutBytes", "stderrBytes", "elapsedMs", "preflight", "reasons"],
+      "properties": {
+        "scope": {"const": "native-access-only"}, "state": {"enum": ["blocked", "completed", "failed", "canceled", "timed-out", "indeterminate"]},
+        "nativeExecuted": {"type": "boolean"}, "spawnAttempts": {"type": "integer", "minimum": 0, "maximum": 1},
+        "inferenceRequested": {"const": false}, "actualModelCalls": {"type": "null"}, "runtimeReady": {"const": false},
+        "verifiedAdmission": {"const": false}, "externalBillingVerified": {"const": false}, "remoteCancellationVerified": {"const": false},
+        "terminationConfirmed": {"type": "boolean"},
+        "stdoutBytes": {"type": "integer", "minimum": 0, "maximum": 9007199254740991},
+        "stderrBytes": {"type": "integer", "minimum": 0, "maximum": 9007199254740991},
+        "elapsedMs": {"type": "integer", "minimum": 0, "maximum": 9007199254740991},
+        "preflight": {"anyOf": [{"$ref": "#/$defs/report"}, {"type": "null"}]},
+        "reasons": {"type": "array", "uniqueItems": true, "maxItems": 24, "items": {"enum": ["access-controls-insufficient", "access-local-check-failed", "access-signal-unconfirmed", "access-group-unconfirmed", "access-termination-unconfirmed", "access-response-invalid", "access-deadline", "access-descendants-unconfirmed", "access-spawn-failed", "access-process-error", "access-output-limit", "access-stderr-limit", "access-utf8-invalid", "access-canceled", "access-completed", "access-preflight-incompatible", "access-workspace-cleanup-required"]}}
+      }
+    },
+    "report": {
+      "type": "object", "additionalProperties": false,
+      "required": ["scope", "state", "queryEligible", "nativeExecuted", "inferenceRequested", "actualModelCalls", "runtimeReady", "verifiedAdmission", "externalBillingVerified", "remoteCancellationVerified", "reasons", "unresolvedFields", "audit"],
+      "properties": {
+        "scope": {"const": "native-preflight-only"}, "state": {"enum": ["invalid", "incomplete", "blocked", "review-complete"]},
+        "queryEligible": {"type": "boolean"}, "nativeExecuted": {"const": false}, "inferenceRequested": {"const": false},
+        "actualModelCalls": {"type": "null"}, "runtimeReady": {"const": false}, "verifiedAdmission": {"const": false},
+        "externalBillingVerified": {"const": false}, "remoteCancellationVerified": {"const": false},
+        "reasons": {"type": "array", "uniqueItems": true, "maxItems": 32, "items": {"enum": ["preflight-invalid-input", "preflight-binding-mismatch", "preflight-duplicate-field", "safe-projection-unavailable", "preflight-critical-control-present", "preflight-controls-unresolved", "preflight-evidence-rejected", "preflight-access-unresolved", "preflight-access-incompatible", "preflight-subscription-unresolved", "preflight-economy-unresolved", "preflight-economy-enabled", "preflight-session-unresolved", "preflight-review-complete"]}},
+        "unresolvedFields": {"type": "array", "uniqueItems": true, "maxItems": 9, "items": {"$ref": "#/$defs/field/properties/name"}},
+        "audit": {"type": "object", "additionalProperties": false, "required": ["inputSha256"], "properties": {"inputSha256": {"anyOf": [{"$ref": "#/$defs/sha"}, {"type": "null"}]}}}
+      }
+    }
+  }
+}

package/schemas/agent-client-output.schema.json

@@ -0,0 +1,551 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-toolkit.local/schemas/agent-client-output.schema.json",
+  "title": "Offline Client Output v1",
+  "description": "Parsing de capturas como datos no autenticados; no ejecuta ni certifica clientes.",
+  "$ref": "#/$defs/metadata",
+  "$defs": {
+    "config": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "supportedClients"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "const": "1.0.0"
+        },
+        "supportedClients": {
+          "type": "array",
+          "maxItems": 64,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "descriptor",
+              "formatId"
+            ],
+            "properties": {
+              "descriptor": {
+                "$ref": "https://agent-toolkit.local/schemas/agent-client-adapter.schema.json#/$defs/client"
+              },
+              "formatId": {
+                "enum": [
+                  "codex-jsonl-text-v1",
+                  "claude-jsonl-text-v1"
+                ]
+              }
+            }
+          }
+        }
+      }
+    },
+    "process": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "exitCode",
+        "signal",
+        "elapsedSeconds"
+      ],
+      "properties": {
+        "exitCode": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 255
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "signal": {
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^SIG[A-Z0-9]{1,24}$"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "elapsedSeconds": {
+          "anyOf": [
+            {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 86400
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "plan",
+        "captureRef"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "const": "1.0.0"
+        },
+        "plan": {
+          "$ref": "https://agent-toolkit.local/schemas/agent-client-adapter.schema.json#/$defs/report"
+        },
+        "captureRef": {
+          "$ref": "https://agent-toolkit.local/schemas/agent-client-adapter.schema.json#/$defs/id"
+        },
+        "processObservation": {
+          "$ref": "#/$defs/process"
+        }
+      }
+    },
+    "observation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "value",
+        "verification",
+        "match",
+        "source",
+        "scope"
+      ],
+      "properties": {
+        "value": {
+          "anyOf": [
+            {
+              "$ref": "https://agent-toolkit.local/schemas/agent-client-adapter.schema.json#/$defs/id"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "verification": {
+          "enum": [
+            "reported",
+            "unknown"
+          ]
+        },
+        "match": {
+          "enum": [
+            "matched",
+            "mismatched",
+            "unknown"
+          ]
+        },
+        "source": {
+          "anyOf": [
+            {
+              "enum": [
+                "client-init",
+                "claude-assistant-message"
+              ]
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "scope": {
+          "anyOf": [
+            {
+              "enum": [
+                "configuration",
+                "response"
+              ]
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": { "verification": { "const": "unknown" } },
+            "required": ["verification"]
+          },
+          "then": {
+            "properties": {
+              "value": { "type": "null" },
+              "match": { "const": "unknown" },
+              "source": { "type": "null" },
+              "scope": { "type": "null" }
+            }
+          },
+          "else": {
+            "properties": {
+              "value": { "type": "string" },
+              "match": { "enum": ["matched", "mismatched"] },
+              "source": { "type": "string" },
+              "scope": { "type": "string" }
+            }
+          }
+        }
+      ]
+    },
+    "usage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "inputTokens",
+        "outputTokens",
+        "cacheReadTokens",
+        "reasoningTokens",
+        "totalTokens"
+      ],
+      "properties": {
+        "inputTokens": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "outputTokens": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "cacheReadTokens": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "reasoningTokens": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "totalTokens": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      }
+    },
+    "report": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "parserVersion",
+        "state",
+        "nativeState",
+        "executed",
+        "verifiedExecution",
+        "reviewRequired",
+        "client",
+        "captureRef",
+        "identity",
+        "requested",
+        "response",
+        "model",
+        "configuredModel",
+        "configuredEffort",
+        "effort",
+        "usage",
+        "usageScope",
+        "durationSeconds",
+        "processObservation",
+        "eventCount",
+        "stderrBytes",
+        "reasons",
+        "audit"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "const": "1.0.0"
+        },
+        "parserVersion": {
+          "const": "1.0.0"
+        },
+        "state": {
+          "enum": [
+            "invalid",
+            "blocked",
+            "incomplete",
+            "accepted"
+          ]
+        },
+        "nativeState": {
+          "enum": [
+            "unknown",
+            "completed",
+            "failed",
+            "canceled",
+            "interrupted",
+            "waiting",
+            "running"
+          ]
+        },
+        "executed": {
+          "const": false
+        },
+        "verifiedExecution": {
+          "const": false
+        },
+        "reviewRequired": {
+          "const": true
+        },
+        "client": {
+          "anyOf": [
+            {
+              "$ref": "https://agent-toolkit.local/schemas/agent-client-adapter.schema.json#/$defs/client"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "captureRef": {
+          "anyOf": [
+            {
+              "$ref": "https://agent-toolkit.local/schemas/agent-client-adapter.schema.json#/$defs/id"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "identity": {
+          "$ref": "https://agent-toolkit.local/schemas/agent-client-adapter.schema.json#/$defs/report/properties/identity"
+        },
+        "requested": {
+          "anyOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "model",
+                "effort"
+              ],
+              "properties": {
+                "model": {
+                  "$ref": "https://agent-toolkit.local/schemas/agent-client-adapter.schema.json#/$defs/id"
+                },
+                "effort": {
+                  "$ref": "https://agent-toolkit.local/schemas/agent-client-adapter.schema.json#/$defs/id"
+                }
+              }
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "response": {
+          "anyOf": [
+            {
+              "type": "string",
+              "maxLength": 1048576
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "model": {
+          "$ref": "#/$defs/observation"
+        },
+        "configuredModel": {
+          "$ref": "#/$defs/observation"
+        },
+        "configuredEffort": {
+          "$ref": "#/$defs/observation"
+        },
+        "effort": {
+          "$ref": "#/$defs/observation",
+          "const": { "value": null, "verification": "unknown", "match": "unknown", "source": null, "scope": null }
+        },
+        "usage": {
+          "$ref": "#/$defs/usage"
+        },
+        "usageScope": {
+          "anyOf": [
+            {
+              "enum": [
+                "terminal-native-report"
+              ]
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "durationSeconds": {
+          "anyOf": [
+            {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 86400
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "processObservation": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/process"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "eventCount": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 10000
+        },
+        "stderrBytes": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 65536
+        },
+        "reasons": {
+          "type": "array",
+          "uniqueItems": true,
+          "maxItems": 128,
+          "items": {
+            "$ref": "https://agent-toolkit.local/schemas/agent-client-adapter.schema.json#/$defs/id"
+          }
+        },
+        "audit": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "planSha256",
+            "stdoutSha256",
+            "stderrSha256"
+          ],
+          "properties": {
+            "planSha256": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "pattern": "^[a-f0-9]{64}$"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "stdoutSha256": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "pattern": "^[a-f0-9]{64}$"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "stderrSha256": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "pattern": "^[a-f0-9]{64}$"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          }
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "state": {
+                "const": "accepted"
+              }
+            },
+            "required": [
+              "state"
+            ]
+          },
+          "then": {
+            "properties": {
+              "nativeState": {
+                "const": "completed"
+              },
+              "response": {
+                "type": "string",
+                "minLength": 1
+              },
+              "client": { "type": "object" },
+              "identity": { "type": "object" },
+              "captureRef": { "type": "string" },
+              "requested": { "type": "object" },
+              "processObservation": {
+                "type": "object",
+                "properties": {
+                  "exitCode": { "const": 0 },
+                  "signal": { "type": "null" }
+                }
+              }
+            }
+          },
+          "else": {
+            "properties": {
+              "response": {
+                "type": "null"
+              }
+            }
+          }
+        }
+      ]
+    }
+  }
+}