@skill-harness/adapters 0.11.0 → 0.13.0

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

@@ -0,0 +1,683 @@
+export declare const PI_DADDY_LEDGER_V3_CONTRACT_COMMIT = "4a9524394ca995fd74ed9bbb836dc4e73cda3b8c";
+export declare const PI_DADDY_LEDGER_V3_CONTRACT_TREE = "7c006bff213142634f0f911ba9bd6add363ecaae";
+export declare const PI_DADDY_LEDGER_V3_SCHEMA_SHA256 = "64e3d875e74bc32fa43fb96892605548259cd16f6ed6678646d73cc56280c511";
+export declare const PI_DADDY_LEDGER_V3_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://github.com/mojomanyana/pi-daddy/contracts/ledger/v3/ledger-event.schema.json";
+    readonly title: "pi-daddy ledgerVersion 3 event";
+    readonly description: "One JSON object per JSONL line. Version 3 adds unique execution identity and explicit parent execution identity; legacy and v2 lines 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 $ref: "#/$defs/workflowFact";
+    }];
+    readonly $defs: {
+        readonly timestamp: {
+            readonly type: "string";
+            readonly format: "date-time";
+            readonly pattern: ":[0-5][0-9](?:\\.[0-9]+)?(?:[Zz]|[+-][0-9]{2}:[0-9]{2})$";
+        };
+        readonly correlation: {
+            readonly type: "object";
+            readonly description: "Non-authoritative controller metadata under the pinned 1.0 contract. 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 const: "1.0";
+                };
+                readonly run_id: {
+                    readonly $ref: "#/$defs/ledgerCorrelationIdentifier";
+                };
+                readonly task_id: {
+                    readonly $ref: "#/$defs/ledgerCorrelationIdentifier";
+                };
+                readonly workspace_id: {
+                    readonly $ref: "#/$defs/ledgerCorrelationIdentifier";
+                };
+                readonly context_id: {
+                    readonly $ref: "#/$defs/ledgerCorrelationIdentifier";
+                };
+                readonly phase: {
+                    readonly $ref: "#/$defs/ledgerCorrelationIdentifier";
+                };
+                readonly assurance: {
+                    readonly $ref: "#/$defs/ledgerCorrelationIdentifier";
+                };
+                readonly assurance_effective: {
+                    readonly $ref: "#/$defs/ledgerCorrelationIdentifier";
+                };
+                readonly policy_label: {
+                    readonly $ref: "#/$defs/ledgerCorrelationIdentifier";
+                };
+                readonly assurance_source: {
+                    readonly $ref: "#/$defs/ledgerCorrelationIdentifier";
+                };
+                readonly assurance_scope: {
+                    readonly oneOf: readonly [{
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly type: {
+                                readonly const: "entire-run";
+                            };
+                            readonly selectors: {
+                                readonly type: "array";
+                                readonly maxItems: 0;
+                            };
+                        };
+                        readonly required: readonly ["type", "selectors"];
+                        readonly additionalProperties: false;
+                    }, {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly type: {
+                                readonly const: "selectors";
+                            };
+                            readonly selectors: {
+                                readonly type: "array";
+                                readonly minItems: 1;
+                                readonly items: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                            };
+                        };
+                        readonly required: readonly ["type", "selectors"];
+                        readonly additionalProperties: false;
+                    }];
+                };
+                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 ledgerDisplayIdentifier: {
+            readonly type: "string";
+            readonly pattern: "^[A-Za-z0-9@*][A-Za-z0-9@*._:/-]{0,511}$";
+        };
+        readonly ledgerCorrelationIdentifier: {
+            readonly type: "string";
+            readonly pattern: "^[A-Za-z0-9@*][A-Za-z0-9@*._:/-]{0,127}$";
+        };
+        readonly ledgerCapabilityIdentifier: {
+            readonly type: "string";
+            readonly pattern: "^(tool|skill|agent|workspace|ext):[A-Za-z0-9@*][A-Za-z0-9@*._/-]{0,255}$";
+        };
+        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", "MODEL_UNRESOLVED", "GRANT_STORE_INVALID", "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_NOT_AUTHORIZED", "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: 3;
+                };
+                readonly event: {
+                    readonly const: "capability_decision";
+                };
+                readonly ts: {
+                    readonly $ref: "#/$defs/timestamp";
+                };
+                readonly parentId: {
+                    readonly $ref: "#/$defs/ledgerDisplayIdentifier";
+                };
+                readonly childId: {
+                    readonly $ref: "#/$defs/ledgerDisplayIdentifier";
+                };
+                readonly depth: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly agentType: {
+                    readonly $ref: "#/$defs/ledgerDisplayIdentifier";
+                };
+                readonly requested: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/ledgerCapabilityIdentifier";
+                    };
+                };
+                readonly parentGrant: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/ledgerCapabilityIdentifier";
+                    };
+                };
+                readonly effective: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/ledgerCapabilityIdentifier";
+                    };
+                };
+                readonly denied: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/ledgerCapabilityIdentifier";
+                    };
+                };
+                readonly clipped: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/ledgerCapabilityIdentifier";
+                    };
+                };
+                readonly gatedBlocked: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/ledgerCapabilityIdentifier";
+                    };
+                };
+                readonly blocked: {
+                    readonly type: "boolean";
+                };
+                readonly reason: {
+                    readonly type: "string";
+                };
+                readonly approved: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/ledgerCapabilityIdentifier";
+                    };
+                };
+                readonly approvalSource: {
+                    readonly $ref: "#/$defs/approvalSource";
+                };
+                readonly approvalSources: {
+                    readonly type: "object";
+                    readonly propertyNames: {
+                        readonly $ref: "#/$defs/ledgerCapabilityIdentifier";
+                    };
+                    readonly additionalProperties: {
+                        readonly $ref: "#/$defs/approvalSource";
+                    };
+                };
+                readonly approvalScopes: {
+                    readonly type: "object";
+                    readonly propertyNames: {
+                        readonly $ref: "#/$defs/ledgerCapabilityIdentifier";
+                    };
+                    readonly additionalProperties: {
+                        readonly $ref: "#/$defs/approvalScope";
+                    };
+                };
+                readonly approvalExpiresAt: {
+                    readonly type: "object";
+                    readonly propertyNames: {
+                        readonly $ref: "#/$defs/ledgerCapabilityIdentifier";
+                    };
+                    readonly additionalProperties: {
+                        readonly $ref: "#/$defs/timestamp";
+                    };
+                };
+                readonly approvalUses: {
+                    readonly type: "object";
+                    readonly propertyNames: {
+                        readonly $ref: "#/$defs/ledgerCapabilityIdentifier";
+                    };
+                    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 $ref: "#/$defs/ledgerDisplayIdentifier";
+                };
+                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 executionId: {
+                    readonly $ref: "#/$defs/executionId";
+                };
+                readonly parentExecutionId: {
+                    readonly oneOf: readonly [{
+                        readonly $ref: "#/$defs/executionId";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+                readonly taskFromExecutionId: {
+                    readonly $ref: "#/$defs/executionId";
+                };
+            };
+            readonly required: readonly ["ledgerVersion", "event", "ts", "executionId", "parentExecutionId", "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: 3;
+                };
+                readonly event: {
+                    readonly const: "workspace_lease";
+                };
+                readonly ts: {
+                    readonly $ref: "#/$defs/timestamp";
+                };
+                readonly childId: {
+                    readonly $ref: "#/$defs/ledgerDisplayIdentifier";
+                };
+                readonly workspaceId: {
+                    readonly $ref: "#/$defs/ledgerDisplayIdentifier";
+                };
+                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 executionId: {
+                    readonly $ref: "#/$defs/executionId";
+                };
+                readonly parentExecutionId: {
+                    readonly oneOf: readonly [{
+                        readonly $ref: "#/$defs/executionId";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+            };
+            readonly required: readonly ["ledgerVersion", "event", "ts", "executionId", "parentExecutionId", "childId", "workspaceId", "root", "access", "outcome"];
+            readonly additionalProperties: false;
+        };
+        readonly childLifecycle: {
+            readonly type: "object";
+            readonly properties: {
+                readonly ledgerVersion: {
+                    readonly const: 3;
+                };
+                readonly event: {
+                    readonly const: "child_lifecycle";
+                };
+                readonly ts: {
+                    readonly $ref: "#/$defs/timestamp";
+                };
+                readonly childId: {
+                    readonly $ref: "#/$defs/ledgerDisplayIdentifier";
+                };
+                readonly state: {
+                    readonly type: "string";
+                    readonly enum: readonly ["starting", "running", "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 executionId: {
+                    readonly $ref: "#/$defs/executionId";
+                };
+                readonly parentExecutionId: {
+                    readonly oneOf: readonly [{
+                        readonly $ref: "#/$defs/executionId";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+                readonly deadlineAt: {
+                    readonly $ref: "#/$defs/timestamp";
+                };
+                readonly herdrPaneId: {
+                    readonly $ref: "#/$defs/ledgerDisplayIdentifier";
+                };
+                readonly herdrAgentName: {
+                    readonly $ref: "#/$defs/ledgerDisplayIdentifier";
+                };
+            };
+            readonly required: readonly ["ledgerVersion", "event", "ts", "executionId", "parentExecutionId", "childId", "state", "executor"];
+            readonly additionalProperties: false;
+            readonly allOf: readonly [{
+                readonly if: {
+                    readonly properties: {
+                        readonly state: {
+                            readonly enum: readonly ["starting", "running"];
+                        };
+                    };
+                    readonly required: readonly ["state"];
+                };
+                readonly then: {
+                    readonly required: readonly ["deadlineAt"];
+                };
+            }, {
+                readonly if: {
+                    readonly anyOf: readonly [{
+                        readonly required: readonly ["herdrPaneId"];
+                    }, {
+                        readonly required: readonly ["herdrAgentName"];
+                    }];
+                };
+                readonly then: {
+                    readonly required: readonly ["herdrPaneId", "herdrAgentName"];
+                    readonly properties: {
+                        readonly executor: {
+                            readonly const: "herdr";
+                        };
+                    };
+                };
+            }];
+        };
+        readonly checkReceipt: {
+            readonly type: "object";
+            readonly properties: {
+                readonly ledgerVersion: {
+                    readonly const: 3;
+                };
+                readonly event: {
+                    readonly const: "check_receipt";
+                };
+                readonly ts: {
+                    readonly $ref: "#/$defs/timestamp";
+                };
+                readonly childId: {
+                    readonly $ref: "#/$defs/ledgerDisplayIdentifier";
+                };
+                readonly receiptId: {
+                    readonly type: "string";
+                    readonly pattern: "^[a-fA-F0-9]{64}$";
+                };
+                readonly workspaceId: {
+                    readonly $ref: "#/$defs/ledgerDisplayIdentifier";
+                };
+                readonly checkId: {
+                    readonly $ref: "#/$defs/ledgerDisplayIdentifier";
+                };
+                readonly treeSha: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly correlation: {
+                    readonly $ref: "#/$defs/correlation";
+                };
+                readonly executionId: {
+                    readonly $ref: "#/$defs/executionId";
+                };
+                readonly parentExecutionId: {
+                    readonly oneOf: readonly [{
+                        readonly $ref: "#/$defs/executionId";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+            };
+            readonly required: readonly ["ledgerVersion", "event", "ts", "executionId", "parentExecutionId", "childId", "receiptId", "workspaceId", "checkId", "treeSha"];
+            readonly additionalProperties: false;
+        };
+        readonly executionId: {
+            readonly type: "string";
+            readonly pattern: "^exec:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$";
+        };
+        readonly workflowFact: {
+            readonly type: "object";
+            readonly properties: {
+                readonly ledgerVersion: {
+                    readonly const: 3;
+                };
+                readonly event: {
+                    readonly const: "workflow_fact";
+                };
+                readonly ts: {
+                    readonly $ref: "#/$defs/timestamp";
+                };
+                readonly factId: {
+                    readonly type: "string";
+                    readonly pattern: "^fact:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$";
+                };
+                readonly source: {
+                    readonly type: "string";
+                    readonly pattern: "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$";
+                };
+                readonly provenance: {
+                    readonly enum: readonly ["planned", "observed", "controller_validated"];
+                };
+                readonly kind: {
+                    readonly enum: readonly ["workflow_phase", "inline_skill", "transition"];
+                };
+                readonly subject: {
+                    readonly type: "string";
+                    readonly pattern: "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$";
+                };
+                readonly state: {
+                    readonly enum: readonly ["pending", "observed", "started", "completed", "blocked"];
+                };
+                readonly correlation: {
+                    readonly allOf: readonly [{
+                        readonly $ref: "#/$defs/correlation";
+                    }, {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly run_id: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                        };
+                        readonly required: readonly ["run_id"];
+                    }];
+                };
+            };
+            readonly required: readonly ["ledgerVersion", "event", "ts", "factId", "source", "provenance", "kind", "subject", "state", "correlation"];
+            readonly additionalProperties: false;
+            readonly allOf: readonly [{
+                readonly if: {
+                    readonly properties: {
+                        readonly provenance: {
+                            readonly const: "planned";
+                        };
+                    };
+                    readonly required: readonly ["provenance"];
+                };
+                readonly then: {
+                    readonly properties: {
+                        readonly state: {
+                            readonly const: "pending";
+                        };
+                    };
+                };
+            }, {
+                readonly if: {
+                    readonly properties: {
+                        readonly provenance: {
+                            readonly const: "observed";
+                        };
+                    };
+                    readonly required: readonly ["provenance"];
+                };
+                readonly then: {
+                    readonly properties: {
+                        readonly state: {
+                            readonly const: "observed";
+                        };
+                    };
+                };
+            }, {
+                readonly if: {
+                    readonly properties: {
+                        readonly provenance: {
+                            readonly const: "controller_validated";
+                        };
+                    };
+                    readonly required: readonly ["provenance"];
+                };
+                readonly then: {
+                    readonly properties: {
+                        readonly state: {
+                            readonly enum: readonly ["started", "completed", "blocked"];
+                        };
+                    };
+                };
+            }];
+        };
+    };
+};