@skill-harness/adapters 0.8.0 → 0.10.0

package/dist/pi-daddy-ledger-v2.d.ts

@@ -0,0 +1,460 @@
+/** pi-daddy commit whose contract artifact this schema was taken from. */
+export declare const PI_DADDY_CONTRACT_COMMIT = "1948b9406c13c9730f2fc103e68023d6e58c5e85";
+/** SHA-256 of the byte-exact producer schema file this object was generated from. */
+export declare const PI_DADDY_LEDGER_V2_SCHEMA_SHA256 = "69c3a6856481b9250587c5785a8aadda87baba6cb03c79b209cff4f55f70a81c";
+/** pi-daddy's canonical, closed ledgerVersion 2 event schema (JSON Schema draft 2020-12). */
+export declare const PI_DADDY_LEDGER_V2_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://github.com/mojomanyana/pi-daddy/contracts/ledger/v2/ledger-event.schema.json";
+    readonly title: "pi-daddy ledgerVersion 2 event";
+    readonly description: "One JSON object per JSONL line. This schema covers only explicit ledgerVersion 2 events; legacy GrantRecord lines have no version/event discriminator and are intentionally outside this schema.";
+    readonly oneOf: readonly [{
+        readonly $ref: "#/$defs/capabilityDecision";
+    }, {
+        readonly $ref: "#/$defs/workspaceLease";
+    }, {
+        readonly $ref: "#/$defs/childLifecycle";
+    }, {
+        readonly $ref: "#/$defs/checkReceipt";
+    }];
+    readonly $defs: {
+        readonly correlation: {
+            readonly type: "object";
+            readonly description: "Opaque, non-authoritative controller metadata. String and aggregate byte limits are additionally enforced by the runtime and cannot be represented exactly in JSON Schema.";
+            readonly properties: {
+                readonly schema_version: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly run_id: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly task_id: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly workspace_id: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly context_id: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly phase: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly assurance: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly assurance_effective: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly policy_label: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly assurance_source: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly assurance_scope: {};
+                readonly activated_at: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly plan_digest: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly definition_digest: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly task_digest: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly base_sha: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly head_sha: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly tree_sha: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+                readonly event_seq: {
+                    readonly type: "number";
+                };
+                readonly last_change_seq: {
+                    readonly type: "number";
+                };
+                readonly last_authority_seq: {
+                    readonly type: "number";
+                };
+                readonly check_receipt_id: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly refusalCode: {
+            readonly type: "string";
+            readonly enum: readonly ["CAPABILITY_ESCALATION", "GRANT_ID_MALFORMED", "DEFINITION_NOT_AUTHORIZED", "UNDECLARED_TOOLS", "UNKNOWN_TOOL", "GATED_UNAPPROVED", "APPROVAL_EXPIRED", "APPROVAL_SCOPE_MISMATCH", "APPROVAL_FLOW_FAILED", "DEPTH_EXCEEDED", "FANOUT_EXCEEDED", "EXECUTOR_UNAVAILABLE", "CHILD_TIMED_OUT", "CHILD_CANCELLED", "CHILD_EXIT_NONZERO", "TASK_MISSING", "UNKNOWN_DEFINITION", "CEILING_PATTERNS_UNRESOLVED", "NARROWING_VIOLATED", "DEFINITION_UNREADABLE", "CORRELATION_TOO_LARGE", "CORRELATION_INVALID", "LEDGER_WRITE_FAILED", "FANOUT_FAILED", "WORKSPACE_NOT_REGISTERED", "WORKSPACE_WRITE_CONFLICT", "WORKSPACE_LEASE_STALE", "CHECK_NOT_CONFIGURED", "CHECK_CONFIGURATION_INVALID", "CHECK_IDENTITY_UNAVAILABLE", "CHECK_IDENTITY_MISMATCH"];
+        };
+        readonly refusal: {
+            readonly type: "object";
+            readonly properties: {
+                readonly code: {
+                    readonly $ref: "#/$defs/refusalCode";
+                };
+                readonly message: {
+                    readonly type: "string";
+                };
+                readonly details: {
+                    readonly type: "object";
+                    readonly additionalProperties: {
+                        readonly type: readonly ["string", "number", "boolean", "null"];
+                    };
+                };
+            };
+            readonly required: readonly ["code", "message"];
+            readonly additionalProperties: false;
+        };
+        readonly approvalSource: {
+            readonly type: "string";
+            readonly enum: readonly ["prompt", "session", "persisted", "inherited"];
+        };
+        readonly approvalScope: {
+            readonly type: "string";
+            readonly enum: readonly ["once", "session", "always"];
+        };
+        readonly approvalUse: {
+            readonly type: "object";
+            readonly properties: {
+                readonly max: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly remaining: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+            };
+            readonly required: readonly ["max", "remaining"];
+            readonly additionalProperties: false;
+        };
+        readonly definitionDigest: {
+            readonly type: "object";
+            readonly properties: {
+                readonly name: {
+                    readonly type: "string";
+                };
+                readonly source: {
+                    readonly type: "string";
+                };
+                readonly sha256: {
+                    readonly type: "string";
+                    readonly pattern: "^[a-fA-F0-9]{64}$";
+                };
+            };
+            readonly required: readonly ["name", "source", "sha256"];
+            readonly additionalProperties: false;
+        };
+        readonly capabilityDecision: {
+            readonly type: "object";
+            readonly properties: {
+                readonly ledgerVersion: {
+                    readonly const: 2;
+                };
+                readonly event: {
+                    readonly const: "capability_decision";
+                };
+                readonly ts: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly parentId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly childId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly depth: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly agentType: {
+                    readonly type: "string";
+                };
+                readonly requested: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly parentGrant: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly effective: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly denied: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly clipped: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly gatedBlocked: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly blocked: {
+                    readonly type: "boolean";
+                };
+                readonly reason: {
+                    readonly type: "string";
+                };
+                readonly approved: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly approvalSource: {
+                    readonly $ref: "#/$defs/approvalSource";
+                };
+                readonly approvalSources: {
+                    readonly type: "object";
+                    readonly additionalProperties: {
+                        readonly $ref: "#/$defs/approvalSource";
+                    };
+                };
+                readonly approvalScopes: {
+                    readonly type: "object";
+                    readonly additionalProperties: {
+                        readonly $ref: "#/$defs/approvalScope";
+                    };
+                };
+                readonly approvalExpiresAt: {
+                    readonly type: "object";
+                    readonly additionalProperties: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                };
+                readonly approvalUses: {
+                    readonly type: "object";
+                    readonly additionalProperties: {
+                        readonly $ref: "#/$defs/approvalUse";
+                    };
+                };
+                readonly approvalScope: {
+                    readonly $ref: "#/$defs/approvalScope";
+                };
+                readonly humanDenied: {
+                    readonly const: true;
+                };
+                readonly gateOutcome: {
+                    readonly type: "string";
+                    readonly enum: readonly ["declined", "dismissed", "no-ui", "error"];
+                };
+                readonly definitionDigest: {
+                    readonly $ref: "#/$defs/definitionDigest";
+                };
+                readonly executor: {
+                    readonly type: "string";
+                    readonly enum: readonly ["process", "herdr"];
+                };
+                readonly taskFrom: {
+                    readonly type: "string";
+                };
+                readonly taskDigest: {
+                    readonly type: "string";
+                    readonly pattern: "^[a-fA-F0-9]{64}$";
+                };
+                readonly correlation: {
+                    readonly $ref: "#/$defs/correlation";
+                };
+                readonly refusal: {
+                    readonly $ref: "#/$defs/refusal";
+                };
+            };
+            readonly required: readonly ["ledgerVersion", "event", "ts", "parentId", "childId", "depth", "requested", "parentGrant", "effective", "denied", "clipped", "gatedBlocked", "blocked", "executor", "taskDigest"];
+            readonly additionalProperties: false;
+        };
+        readonly workspaceLease: {
+            readonly type: "object";
+            readonly properties: {
+                readonly ledgerVersion: {
+                    readonly const: 2;
+                };
+                readonly event: {
+                    readonly const: "workspace_lease";
+                };
+                readonly ts: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly childId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly workspaceId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly root: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly access: {
+                    readonly type: "string";
+                    readonly enum: readonly ["read", "write"];
+                };
+                readonly outcome: {
+                    readonly type: "string";
+                    readonly enum: readonly ["acquired", "uncontended", "refused", "released", "released-unrecorded", "lost", "retained", "timeout", "recovered"];
+                };
+                readonly recovered: {
+                    readonly oneOf: readonly [{
+                        readonly type: "boolean";
+                    }, {
+                        readonly const: "unknown";
+                    }];
+                };
+                readonly releaseReason: {
+                    readonly type: "string";
+                };
+                readonly refusal: {
+                    readonly $ref: "#/$defs/refusal";
+                };
+                readonly correlation: {
+                    readonly $ref: "#/$defs/correlation";
+                };
+            };
+            readonly required: readonly ["ledgerVersion", "event", "ts", "childId", "workspaceId", "root", "access", "outcome"];
+            readonly additionalProperties: false;
+        };
+        readonly childLifecycle: {
+            readonly type: "object";
+            readonly properties: {
+                readonly ledgerVersion: {
+                    readonly const: 2;
+                };
+                readonly event: {
+                    readonly const: "child_lifecycle";
+                };
+                readonly ts: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly childId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly state: {
+                    readonly type: "string";
+                    readonly enum: readonly ["starting", "completed", "failed"];
+                };
+                readonly executor: {
+                    readonly type: "string";
+                    readonly enum: readonly ["process", "herdr"];
+                };
+                readonly exitCode: {
+                    readonly type: readonly ["integer", "null"];
+                };
+                readonly signal: {
+                    readonly oneOf: readonly [{
+                        readonly type: "string";
+                        readonly enum: readonly ["SIGABRT", "SIGALRM", "SIGBUS", "SIGCHLD", "SIGCONT", "SIGFPE", "SIGHUP", "SIGILL", "SIGINT", "SIGIO", "SIGIOT", "SIGKILL", "SIGPIPE", "SIGPOLL", "SIGPROF", "SIGPWR", "SIGQUIT", "SIGSEGV", "SIGSTKFLT", "SIGSTOP", "SIGSYS", "SIGTERM", "SIGTRAP", "SIGTSTP", "SIGTTIN", "SIGTTOU", "SIGUNUSED", "SIGURG", "SIGUSR1", "SIGUSR2", "SIGVTALRM", "SIGWINCH", "SIGXCPU", "SIGXFSZ", "SIGBREAK", "SIGLOST", "SIGINFO"];
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+                readonly timedOut: {
+                    readonly const: true;
+                };
+                readonly aborted: {
+                    readonly const: true;
+                };
+                readonly truncated: {
+                    readonly const: true;
+                };
+                readonly reason: {
+                    readonly type: "string";
+                };
+                readonly correlation: {
+                    readonly $ref: "#/$defs/correlation";
+                };
+            };
+            readonly required: readonly ["ledgerVersion", "event", "ts", "childId", "state", "executor"];
+            readonly additionalProperties: false;
+        };
+        readonly checkReceipt: {
+            readonly type: "object";
+            readonly properties: {
+                readonly ledgerVersion: {
+                    readonly const: 2;
+                };
+                readonly event: {
+                    readonly const: "check_receipt";
+                };
+                readonly ts: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly childId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly receiptId: {
+                    readonly type: "string";
+                    readonly pattern: "^[a-fA-F0-9]{64}$";
+                };
+                readonly workspaceId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly checkId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly treeSha: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly correlation: {
+                    readonly $ref: "#/$defs/correlation";
+                };
+            };
+            readonly required: readonly ["ledgerVersion", "event", "ts", "childId", "receiptId", "workspaceId", "checkId", "treeSha"];
+            readonly additionalProperties: false;
+        };
+    };
+};