@dsh-enhanced/assistant-actions 0.1.30

package/lib/broker-ledger.d.ts

@@ -0,0 +1,131 @@
+import { brokerRequestDigest, type BrokerClientRequest, type BrokerGrantProjection, type BrokerGrantAuthorityUnsigned, type BrokerSuccessResult } from './broker-protocol.js';
+export type BrokerTerminalStatus = 'succeeded' | 'failed' | 'unknown';
+export type BrokerRequestStatus = 'prepared' | 'dispatched' | BrokerTerminalStatus;
+export type BrokerInspectKind = 'repository' | 'branch' | 'file' | 'pull-request' | 'checks' | 'reviews';
+export interface ExternalGitHubGrant extends BrokerGrantAuthorityUnsigned {
+    digest: string;
+}
+export type ExternalGitHubGrantUnsigned = Omit<ExternalGitHubGrant, 'digest'>;
+export type ExternalGrantMirror = BrokerGrantProjection;
+export interface BrokerAuthority {
+    ownerId: string;
+    fence: number;
+    generation: number;
+}
+export interface BrokerLedgerOutcome {
+    status: BrokerTerminalStatus;
+    dispatched: boolean;
+    result: BrokerSuccessResult | null;
+    error: {
+        code: string;
+    } | null;
+    completedAt: number;
+}
+export interface BrokerLedgerRecord {
+    actionId: string;
+    requestId: string;
+    clientKeyId: string;
+    owner: BrokerClientRequest['owner'];
+    sessionId: string;
+    agentId: string;
+    rootCallId: string;
+    callId: string;
+    grantId: string;
+    grantRevision: number;
+    grantDigest: string;
+    requestDigest: string;
+    operation: 'commit' | 'pull-request' | 'inspect';
+    repository: string;
+    branch: string;
+    expectedHeadOid: string | null;
+    payloadDigest: string;
+    budgetReservationId: string;
+    bytes: number;
+    costUnits: number;
+    deadline: number;
+    policyEpoch: number;
+    emergencyEpoch: number;
+    generation: number;
+    status: BrokerRequestStatus;
+    version: number;
+    outcome?: BrokerLedgerOutcome;
+}
+export interface BrokerControlSnapshot {
+    instanceId: string;
+    generation: number;
+    controlVersion: number;
+    policyEpoch: number;
+    emergencyEpoch: number;
+    stopped: boolean;
+    draining: boolean;
+}
+export interface BrokerControlMutation extends BrokerControlSnapshot {
+    abortActionIds: readonly string[];
+}
+export type BrokerAdminMutation = {
+    operation: 'stop';
+    expectedControlVersion: number;
+    reason: string;
+} | {
+    operation: 'resume';
+    expectedControlVersion: number;
+    expectedGeneration: number;
+    reason: string;
+} | {
+    operation: 'revoke';
+    expectedControlVersion: number;
+    grantId: string;
+    grantRevision: number;
+    grantDigest: string;
+    policyEpoch: number;
+    emergencyEpoch: number;
+    reason: string;
+};
+export declare class BrokerLedgerError extends Error {
+    readonly code: 'invalid-input' | 'unsafe-file' | 'schema' | 'controller' | 'conflict' | 'limit' | 'grant' | 'state' | 'stopped';
+    constructor(code: 'invalid-input' | 'unsafe-file' | 'schema' | 'controller' | 'conflict' | 'limit' | 'grant' | 'state' | 'stopped');
+}
+export declare function externalGrantMirror(grant: ExternalGitHubGrantUnsigned): ExternalGrantMirror;
+export declare function brokerGrantDigest(grant: ExternalGitHubGrantUnsigned): string;
+export declare function withBrokerGrantDigest(grant: ExternalGitHubGrantUnsigned): ExternalGitHubGrant;
+export declare function normalizeBrokerGrant(value: unknown): ExternalGitHubGrant;
+export declare function brokerPayloadBytes(request: BrokerClientRequest): number;
+export declare const brokerLedgerRequestDigest: typeof brokerRequestDigest;
+export declare class ExternalBrokerLedger {
+    #private;
+    constructor(databasePath: string, instanceId: string, options?: {
+        now?: () => number;
+        beforeDatabaseOpen?: () => void;
+    });
+    claimController(ownerId: string, ttlMs?: number): BrokerAuthority;
+    renewController(authority: BrokerAuthority, ttlMs?: number): void;
+    hasController(authority: BrokerAuthority): boolean;
+    releaseController(authority: BrokerAuthority): void;
+    syncGrants(values: readonly ExternalGitHubGrant[], policyEpoch: number, authority: BrokerAuthority): BrokerControlMutation;
+    grant(id: string): ExternalGitHubGrant | undefined;
+    prepare(request: BrokerClientRequest, authority: BrokerAuthority): {
+        record: BrokerLedgerRecord;
+        created: boolean;
+    };
+    dispatch(actionId: string, version: number, requestDigestValue: string, credentialId: string, leaseExpiresAt: number, authority: BrokerAuthority): BrokerLedgerRecord;
+    settle(actionId: string, version: number, requestDigestValue: string, value: BrokerLedgerOutcome, authority: BrokerAuthority): BrokerLedgerRecord;
+    failPrepared(actionId: string, version: number, requestDigestValue: string, code: string, authority: BrokerAuthority): BrokerLedgerRecord;
+    status(clientKeyId: string, actionId: string, requestDigestValue: string): BrokerLedgerRecord | undefined;
+    terminalizeActive(reason: string, authority: BrokerAuthority): BrokerControlMutation;
+    consumeAdminNonce(adminKeyId: string, nonce: string, requestDigestValue: string, expiresAt: number, authority: BrokerAuthority): void;
+    applyAdminMutation(input: Readonly<{
+        adminKeyId: string;
+        nonce: string;
+        requestDigest: string;
+        expiresAt: number;
+        mutation: BrokerAdminMutation;
+        authority: BrokerAuthority;
+    }>): BrokerControlMutation;
+    stop(expectedControlVersion: number, reason: string, authority: BrokerAuthority): BrokerControlMutation;
+    resume(expectedControlVersion: number, reason: string, authority: BrokerAuthority): BrokerControlMutation;
+    beginDrain(expectedControlVersion: number, reason: string, authority: BrokerAuthority): BrokerControlMutation;
+    revoke(grantId: string, revision: number, expectedControlVersion: number, reason: string, authority: BrokerAuthority): BrokerControlMutation;
+    snapshot(): BrokerControlSnapshot;
+    close(): void;
+}
+//# sourceMappingURL=broker-ledger.d.ts.map

package/lib/broker-ledger.d.ts.map

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