pi-daddy 0.28.0 → 0.32.0

package/dist/resource-budget.d.ts

@@ -1,334 +0,0 @@
-import { readIntentWork } from "./intent-application.ts";
-import { type WorkIntentBinding, type IntentRequest, type IntentAdmission } from "./intent-control.ts";
-import { type DispatchAuthority, type DispatchRequest } from "./dispatch-control.ts";
-export interface ResourceLimits {
-    maxAttempts: number;
-    maxInputBytes: number;
-    maxConcurrent: number;
-}
-export interface BudgetBinding<V extends "1.0" | "2.0" | "3.0" | "4.0" = "1.0"> {
-    version: V;
-    directory: string;
-    device: string;
-    inode: string;
-    journalDevice: string;
-    journalInode: string;
-    authorityDigest: string;
-    limits: ResourceLimits;
-    intent?: V extends "3.0" ? WorkIntentBinding : never;
-}
-export type DispatchBudgetBinding = BudgetBinding<"2.0">;
-export type ExperimentBudgetBinding = BudgetBinding<"4.0">;
-export type GovernedBudgetBinding = BudgetBinding<"1.0" | "2.0" | "3.0" | "4.0">;
-export type IntentBudgetBinding = BudgetBinding<"3.0"> & {
-    intent: WorkIntentBinding;
-};
-export interface AttemptDemand {
-    attemptId: string;
-    orderId: string;
-    experimentId: string;
-    kind: "primary" | "retry" | "shadow" | "descendant";
-    parentAttemptId: string | null;
-    inputBytes: number;
-    inputDigest: string;
-}
-interface Reservation extends AttemptDemand {
-    intent?: IntentAdmission;
-    owner: string;
-    state: "reserved" | "settled";
-    outcome: string | null;
-}
-export interface BudgetSnapshot {
-    attempts: number;
-    inputBytes: number;
-    active: number;
-    reservations: readonly Readonly<Reservation>[];
-}
-export interface ResourcePermit {
-    readonly attemptId: string;
-    settle(outcome: "completed" | "failed" | "cancelled"): Promise<void>;
-}
-/** Exclusive original-permit handoff for the separate opt-in IPC route. No mint/recovery API. */
-export declare function claimResourcePermit(owner: object, permit: ResourcePermit, bindingDigest: string, expected: AttemptDemand): Readonly<{
-    admission: Promise<void>;
-    settle: (outcome: "completed" | "failed" | "cancelled") => Promise<void>;
-}>;
-export declare class ResourceAdmissionError extends Error {
-    readonly code: "INVALID" | "AUTHORITY_CHANGED" | "DUPLICATE" | "EXHAUSTED" | "OWNERSHIP_LOST" | "DISPATCH_BLOCKED";
-    constructor(code: ResourceAdmissionError["code"], message: string);
-}
-/** Explicit one-time creation, never implicit reset/recovery. Keep this binding outside the mutable journal. */
-type BudgetCreation = {
-    directory: string;
-    authorityDigest: string;
-    limits: ResourceLimits;
-};
-export declare function createResourceBudget(input: BudgetCreation): Promise<Readonly<BudgetBinding>>;
-/** Explicit opt-in v2 journal; old readers refuse rather than ignore control events. */
-export declare function createDispatchBudget(input: BudgetCreation): Promise<Readonly<DispatchBudgetBinding>>;
-export declare function createIntentBudget(input: BudgetCreation, intent: Parameters<typeof readIntentWork>[0]): Promise<Readonly<IntentBudgetBinding>>;
-/** Explicit batch semantics. All queued slots remain conservatively active until original settlement. */
-export declare function createExperimentBudget(input: BudgetCreation): Promise<Readonly<ExperimentBudgetBinding>>;
-/** Host-side arithmetic for this exact independently retained binding. Not a money/CPU/memory cap. */
-export declare function openResourceBudget<T extends GovernedBudgetBinding>(input: T): Readonly<{
-    binding: Readonly<T>;
-    reserveBatch(inputs: readonly AttemptDemand[]): Promise<readonly Readonly<ResourcePermit>[]>;
-    intentControls(input: DispatchAuthority | null): Readonly<{
-        inspect: () => Promise<{
-            readonly dispatchPaused: boolean;
-            readonly nextObligation: {
-                readonly kind: import("./work-ledger-types.ts").RevisionKind;
-                readonly id: string;
-                readonly revision: number;
-                readonly digest: string;
-            } | null;
-            readonly revision: number;
-            readonly selection: {
-                readonly snapshot: {
-                    readonly id: string;
-                    readonly digest: string;
-                };
-                readonly event: {
-                    readonly eventId: string;
-                    readonly digest: string;
-                };
-            };
-            readonly priorities: readonly {
-                readonly obligation: {
-                    readonly kind: import("./work-ledger-types.ts").RevisionKind;
-                    readonly id: string;
-                    readonly revision: number;
-                    readonly digest: string;
-                };
-                readonly rank: number;
-            }[];
-            readonly records: readonly {
-                readonly requestId: string;
-                readonly digest: string;
-                readonly expectedRevision: number;
-                readonly expectedSelection: {
-                    readonly snapshot: {
-                        readonly id: string;
-                        readonly digest: string;
-                    };
-                    readonly event: {
-                        readonly eventId: string;
-                        readonly digest: string;
-                    };
-                };
-                readonly action: IntentRequest["action"];
-                readonly selection: {
-                    readonly snapshot: {
-                        readonly id: string;
-                        readonly digest: string;
-                    };
-                    readonly event: {
-                        readonly eventId: string;
-                        readonly digest: string;
-                    };
-                };
-                readonly priorities: readonly {
-                    readonly obligation: {
-                        readonly kind: import("./work-ledger-types.ts").RevisionKind;
-                        readonly id: string;
-                        readonly revision: number;
-                        readonly digest: string;
-                    };
-                    readonly rank: number;
-                }[];
-                readonly events: readonly {
-                    readonly eventId: string;
-                    readonly digest: string;
-                }[];
-                readonly decision: "approved" | "authority-unavailable" | "stale" | "busy";
-                readonly application: "pending-or-unknown" | "applied" | "not-applied";
-                readonly outcome: "pending-or-unknown" | "selection-applied" | "priority-applied" | "refused";
-                readonly resultSelection: {
-                    readonly snapshot: {
-                        readonly id: string;
-                        readonly digest: string;
-                    };
-                    readonly event: {
-                        readonly eventId: string;
-                        readonly digest: string;
-                    };
-                } | null;
-            }[];
-            readonly version: "intent-controller-snapshot-v1";
-            readonly bindingDigest: string;
-            readonly admission: "blocked-pending" | "intent-ready";
-            readonly acceptance: "not-assessed";
-            readonly freshness: "snapshot-unknown";
-        }>;
-        request(input: IntentRequest): Promise<{
-            readonly revision: number;
-            readonly selection: {
-                readonly snapshot: {
-                    readonly id: string;
-                    readonly digest: string;
-                };
-                readonly event: {
-                    readonly eventId: string;
-                    readonly digest: string;
-                };
-            };
-            readonly priorities: readonly {
-                readonly obligation: {
-                    readonly kind: import("./work-ledger-types.ts").RevisionKind;
-                    readonly id: string;
-                    readonly revision: number;
-                    readonly digest: string;
-                };
-                readonly rank: number;
-            }[];
-            readonly records: readonly {
-                readonly requestId: string;
-                readonly digest: string;
-                readonly expectedRevision: number;
-                readonly expectedSelection: {
-                    readonly snapshot: {
-                        readonly id: string;
-                        readonly digest: string;
-                    };
-                    readonly event: {
-                        readonly eventId: string;
-                        readonly digest: string;
-                    };
-                };
-                readonly action: IntentRequest["action"];
-                readonly selection: {
-                    readonly snapshot: {
-                        readonly id: string;
-                        readonly digest: string;
-                    };
-                    readonly event: {
-                        readonly eventId: string;
-                        readonly digest: string;
-                    };
-                };
-                readonly priorities: readonly {
-                    readonly obligation: {
-                        readonly kind: import("./work-ledger-types.ts").RevisionKind;
-                        readonly id: string;
-                        readonly revision: number;
-                        readonly digest: string;
-                    };
-                    readonly rank: number;
-                }[];
-                readonly events: readonly {
-                    readonly eventId: string;
-                    readonly digest: string;
-                }[];
-                readonly decision: "approved" | "authority-unavailable" | "stale" | "busy";
-                readonly application: "pending-or-unknown" | "applied" | "not-applied";
-                readonly outcome: "pending-or-unknown" | "selection-applied" | "priority-applied" | "refused";
-                readonly resultSelection: {
-                    readonly snapshot: {
-                        readonly id: string;
-                        readonly digest: string;
-                    };
-                    readonly event: {
-                        readonly eventId: string;
-                        readonly digest: string;
-                    };
-                } | null;
-            }[];
-            readonly version: "intent-controller-snapshot-v1";
-            readonly bindingDigest: string;
-            readonly admission: "blocked-pending" | "intent-ready";
-            readonly acceptance: "not-assessed";
-            readonly freshness: "snapshot-unknown";
-        }>;
-        reconcile(input: IntentRequest): Promise<{
-            readonly revision: number;
-            readonly selection: {
-                readonly snapshot: {
-                    readonly id: string;
-                    readonly digest: string;
-                };
-                readonly event: {
-                    readonly eventId: string;
-                    readonly digest: string;
-                };
-            };
-            readonly priorities: readonly {
-                readonly obligation: {
-                    readonly kind: import("./work-ledger-types.ts").RevisionKind;
-                    readonly id: string;
-                    readonly revision: number;
-                    readonly digest: string;
-                };
-                readonly rank: number;
-            }[];
-            readonly records: readonly {
-                readonly requestId: string;
-                readonly digest: string;
-                readonly expectedRevision: number;
-                readonly expectedSelection: {
-                    readonly snapshot: {
-                        readonly id: string;
-                        readonly digest: string;
-                    };
-                    readonly event: {
-                        readonly eventId: string;
-                        readonly digest: string;
-                    };
-                };
-                readonly action: IntentRequest["action"];
-                readonly selection: {
-                    readonly snapshot: {
-                        readonly id: string;
-                        readonly digest: string;
-                    };
-                    readonly event: {
-                        readonly eventId: string;
-                        readonly digest: string;
-                    };
-                };
-                readonly priorities: readonly {
-                    readonly obligation: {
-                        readonly kind: import("./work-ledger-types.ts").RevisionKind;
-                        readonly id: string;
-                        readonly revision: number;
-                        readonly digest: string;
-                    };
-                    readonly rank: number;
-                }[];
-                readonly events: readonly {
-                    readonly eventId: string;
-                    readonly digest: string;
-                }[];
-                readonly decision: "approved" | "authority-unavailable" | "stale" | "busy";
-                readonly application: "pending-or-unknown" | "applied" | "not-applied";
-                readonly outcome: "pending-or-unknown" | "selection-applied" | "priority-applied" | "refused";
-                readonly resultSelection: {
-                    readonly snapshot: {
-                        readonly id: string;
-                        readonly digest: string;
-                    };
-                    readonly event: {
-                        readonly eventId: string;
-                        readonly digest: string;
-                    };
-                } | null;
-            }[];
-            readonly version: "intent-controller-snapshot-v1";
-            readonly bindingDigest: string;
-            readonly admission: "blocked-pending" | "intent-ready";
-            readonly acceptance: "not-assessed";
-            readonly freshness: "snapshot-unknown";
-        }>;
-    }>;
-    controls(input: DispatchAuthority | null): Readonly<{
-        inspect: () => Promise<Readonly<import("./dispatch-control.ts").DispatchSnapshot>>;
-        reconcile(requestId: string): Promise<Readonly<import("./dispatch-control.ts").DispatchSnapshot>>;
-        request(input: DispatchRequest): Promise<Readonly<import("./dispatch-control.ts").DispatchSnapshot>>;
-    }>;
-    /** Explicit control-path synchronization; unlike inspect, this takes the existing journal lock. */
-    controlSnapshot(): Promise<Readonly<BudgetSnapshot>>;
-    inspect(): Promise<Readonly<BudgetSnapshot>>;
-    reserve(input: AttemptDemand, selection?: IntentAdmission): Promise<Readonly<ResourcePermit>>;
-}>;
-export declare function resourceBindingDigest(b: GovernedBudgetBinding): string;
-export {};
-//# sourceMappingURL=resource-budget.d.ts.map

package/dist/resource-budget.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resource-budget.d.ts","sourceRoot":"","sources":["../src/resource-budget.ts"],"names":[],"mappings":"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"}