@boxxy/pepys 0.0.0-stage → 0.1.3

package/dist/generated/boxxy-work-boundary.d.ts

@@ -0,0 +1,566 @@
+declare const idTag: unique symbol;
+declare const kindTag: unique symbol;
+export type EntityID = string & {
+    readonly [idTag]: 'EntityID';
+};
+type KindedID<Kind extends string> = EntityID & {
+    readonly [kindTag]: Kind;
+};
+export type BoxxyAttemptID = KindedID<'boxxy:attempt'>;
+export declare function toBoxxyAttemptID(id: string): BoxxyAttemptID;
+export declare function parseBoxxyAttemptID(text: string): BoxxyAttemptID | undefined;
+export type BoxxyItemID = KindedID<'boxxy:item'>;
+export declare function toBoxxyItemID(id: string): BoxxyItemID;
+export declare function parseBoxxyItemID(text: string): BoxxyItemID | undefined;
+export type GithubPullRequestID = KindedID<'github:pull_request'>;
+export declare function toGithubPullRequestID(id: string): GithubPullRequestID;
+export declare function parseGithubPullRequestID(text: string): GithubPullRequestID | undefined;
+export type TelemetrySessionID = KindedID<'telemetry:session'>;
+export declare function toTelemetrySessionID(id: string): TelemetrySessionID;
+export declare function parseTelemetrySessionID(text: string): TelemetrySessionID | undefined;
+export interface BoxxyWorkModel {
+    input: string;
+}
+export type BoxxyWorkMessage = {
+    kind: 'apply';
+    input: string;
+} | {
+    kind: 'reset';
+};
+export declare function initBoxxyWorkModel(): BoxxyWorkModel;
+export declare function updateBoxxyWorkModel(model: BoxxyWorkModel, message: BoxxyWorkMessage): BoxxyWorkModel;
+export interface BoxxyItemFiledPayload {
+    id: string;
+    kind: string;
+    repo: string;
+    title: string;
+    outcome: string;
+    acceptance: BoxxyItemFiledPayloadAcceptanceItem[];
+    fields: BoxxyItemFiledPayloadFields;
+    labels: string[];
+    foundInAttempt: string | null;
+    filedBy: unknown;
+    filedAt: number;
+    closedAt: number | null;
+    closeReason: string | null;
+    storeVersion: number;
+}
+export interface BoxxyItemFiledPayloadAcceptanceItem {
+    id: string;
+    text: string;
+    evidence: string[];
+}
+export interface BoxxyItemFiledPayloadFields {
+    designMode: unknown;
+}
+export interface BoxxyItemNotedPayload {
+    seq: number;
+    text: string;
+    storeVersion: number;
+}
+export interface BoxxyItemEditedPayload {
+    title: unknown;
+    outcome: unknown;
+    acceptance: unknown;
+    kind: unknown;
+    fields: unknown;
+    labels: unknown;
+    byAttempt: string | null;
+    storeVersion: number;
+}
+export interface BoxxyItemClosedPayload {
+    reason: string;
+    byAttempt: string | null;
+    ended: BoxxyItemClosedPayloadEndedItem[];
+    storeVersion: number;
+}
+export interface BoxxyItemClosedPayloadEndedItem {
+    attempt: string;
+    how: 'settled' | 'closing';
+}
+export interface BoxxyRelationAddedPayload {
+    source: string;
+    target: string;
+    type: string;
+    storeVersion: number;
+}
+export interface BoxxyRelationRemovedPayload {
+    source: string;
+    target: string;
+    type: string;
+    storeVersion: number;
+}
+export interface BoxxyLeverRecordedPayload {
+    seq: number;
+    kind: unknown;
+    item: string;
+    until: number | null;
+    expiresAt: number | null;
+    reason: string | null;
+    phase: string | null;
+    actor: unknown;
+    at: number;
+    storeVersion: number;
+}
+export interface BoxxyAttemptClaimedPayload {
+    attempt: string;
+    phase: string;
+    number: number;
+    round: number;
+    mode: 'agent' | 'attended';
+    pool: string;
+    fields: unknown;
+    seats: BoxxyAttemptClaimedPayloadSeatsItem[];
+    recipeHash: string;
+    skillsRef: string | null;
+    rulesVersion: string;
+    storeVersion: number;
+}
+export interface BoxxyAttemptClaimedPayloadSeatsItem {
+    limit: string;
+}
+export interface BoxxyDecisionRecordedPayload {
+    id: string;
+    attempt: string;
+    item: string;
+    kind: 'start' | 'wake';
+    pool: string;
+    rulesVersion: string;
+    snapshotHash: string;
+    storeVersion: number;
+    pepysOffsets: unknown;
+    faults: BoxxyDecisionRecordedPayloadFaultsItem[];
+    limits: BoxxyDecisionRecordedPayloadLimitsItem[];
+    at: number;
+}
+export interface BoxxyDecisionRecordedPayloadFaultsItem {
+    plugin: string;
+    kind: 'signal' | 'gate' | 'waiver' | 'admission' | 'propagation' | 'filter-field';
+    item: string | null;
+    error: string;
+}
+export interface BoxxyDecisionRecordedPayloadLimitsItem {
+    limit: string;
+    held: number;
+    max: number;
+}
+export interface BoxxyAttemptStartedPayload {
+    attempt: string;
+    atcSession: string;
+    resumeFallback: boolean;
+    caller: BoxxyAttemptStartedPayloadCaller | null;
+    storeVersion: number;
+}
+export interface BoxxyAttemptStartedPayloadCaller {
+    issuer: string;
+    subject: string;
+}
+export interface BoxxyAttemptSpawnUnansweredPayload {
+    attempt: string;
+    reason: string;
+    storeVersion: number;
+}
+export interface BoxxyAttemptReconciledPayload {
+    attempt: string;
+    atcSession: string;
+    caller: BoxxyAttemptReconciledPayloadCaller | null;
+    storeVersion: number;
+}
+export interface BoxxyAttemptReconciledPayloadCaller {
+    issuer: string;
+    subject: string;
+}
+export interface BoxxyAttemptSessionBoundPayload {
+    attempt: string;
+    atcSession: string;
+    agentSession: string;
+    product: 'claude_code' | 'codex';
+    source: 'worker' | 'hook';
+    seenAt: number;
+    storeVersion: number;
+}
+export interface BoxxyAttemptSleptPayload {
+    attempt: string;
+    idleSince: number;
+    asked: boolean;
+    storeVersion: number;
+}
+export interface BoxxyAttemptWakeRequestedPayload {
+    attempt: string;
+    by: 'command' | 'session-ran' | 'host-slept-unasked';
+    storeVersion: number;
+}
+export interface BoxxyAttemptWokenPayload {
+    attempt: string;
+    holdGen: number;
+    seats: BoxxyAttemptWokenPayloadSeatsItem[];
+    overCap: boolean;
+    storeVersion: number;
+}
+export interface BoxxyAttemptWokenPayloadSeatsItem {
+    limit: string;
+}
+export interface BoxxyAttemptResumedPayload {
+    attempt: string;
+    atcSession: string;
+    caller: BoxxyAttemptResumedPayloadCaller | null;
+    storeVersion: number;
+}
+export interface BoxxyAttemptResumedPayloadCaller {
+    issuer: string;
+    subject: string;
+}
+export interface BoxxyAttemptClosedOutPayload {
+    attempt: string;
+    phase: string;
+    closeOut: unknown;
+    hash: string;
+    storeVersion: number;
+}
+export interface BoxxyAttemptTimedOutPayload {
+    attempt: string;
+    phase: string;
+    afterMinutes: number;
+    storeVersion: number;
+}
+export interface BoxxyAttemptTurnEndedPayload {
+    attempt: string;
+    phase: string;
+    storeVersion: number;
+}
+export interface BoxxyAttemptSettledPayload {
+    attempt: string;
+    phase: string;
+    round: number;
+    state: 'succeeded' | 'failed';
+    failure: string | null;
+    outcome: string;
+    returnedOutcome: string | null;
+    closing: 'closed-out' | 'timed-out' | 'item-closed' | 'stalled' | 'skill-missing' | 'turn-ended' | 'usage-limit' | null;
+    asleep: boolean;
+    sessionStopped: boolean;
+    endedAt: number;
+    criteria: BoxxyAttemptSettledPayloadCriteriaItem[];
+    matched: string[];
+    frictionDropped: number;
+    skippedEffects: BoxxyAttemptSettledPayloadSkippedEffectsItem[];
+    storeVersion: number;
+}
+export interface BoxxyAttemptSettledPayloadCriteriaItem {
+    criterion: string;
+    evidence: string[];
+}
+export interface BoxxyAttemptSettledPayloadSkippedEffectsItem {
+    effect: 'file-item' | 'close-item' | 'add-relation' | 'set-kind' | 'set-field' | 'set-acceptance' | 'record-proposal';
+    reason: string;
+}
+export interface BoxxyProposalRecordedPayload {
+    target: BoxxyProposalRecordedPayloadTarget;
+    change: string;
+    attempt: string;
+    storeVersion: number;
+}
+export interface BoxxyProposalRecordedPayloadTarget {
+    kind: 'skill' | 'rule' | 'lint' | 'agents-md' | 'tool';
+    name: string;
+}
+export interface BoxxyEvidenceRecordedPayload {
+    attempt: string;
+    kind: 'pull_request' | 'commit' | 'test' | 'ci-run' | 'live-check';
+    ref: string;
+    observed: string | null;
+    storeVersion: number;
+}
+export interface BoxxyPullRequestLinkedPayload {
+    attempt: string;
+    repo: string;
+    number: number;
+    url: string;
+    pullRequestId: string;
+    source: 'hook' | 'watch';
+    storeVersion: number;
+}
+export interface BoxxyCommitLinkedPayload {
+    attempt: string;
+    repo: string;
+    sha: string;
+    pullRequestNumber: number;
+    storeVersion: number;
+}
+export interface BoxxyPullRequestMergedPayload {
+    attempt: string;
+    repo: string;
+    number: number;
+    pullRequestId: string;
+    mergedAt: number;
+    mergeCommit: string;
+    storeVersion: number;
+}
+export interface BoxxyPullRequestClosedPayload {
+    attempt: string;
+    repo: string;
+    number: number;
+    pullRequestId: string;
+    storeVersion: number;
+}
+export type BoxxyWorkFact = {
+    id: string;
+    type: 'boxxy.item.filed';
+    entity: string;
+    at: string;
+    payload: BoxxyItemFiledPayload;
+} | {
+    id: string;
+    type: 'boxxy.item.noted';
+    entity: string;
+    at: string;
+    payload: BoxxyItemNotedPayload;
+} | {
+    id: string;
+    type: 'boxxy.item.edited';
+    entity: string;
+    at: string;
+    payload: BoxxyItemEditedPayload;
+} | {
+    id: string;
+    type: 'boxxy.item.closed';
+    entity: string;
+    at: string;
+    payload: BoxxyItemClosedPayload;
+} | {
+    id: string;
+    type: 'boxxy.relation.added';
+    entity: string;
+    at: string;
+    payload: BoxxyRelationAddedPayload;
+} | {
+    id: string;
+    type: 'boxxy.relation.removed';
+    entity: string;
+    at: string;
+    payload: BoxxyRelationRemovedPayload;
+} | {
+    id: string;
+    type: 'boxxy.lever.recorded';
+    entity: string;
+    at: string;
+    payload: BoxxyLeverRecordedPayload;
+} | {
+    id: string;
+    type: 'boxxy.attempt.claimed';
+    entity: string;
+    at: string;
+    payload: BoxxyAttemptClaimedPayload;
+} | {
+    id: string;
+    type: 'boxxy.decision.recorded';
+    entity: string;
+    at: string;
+    payload: BoxxyDecisionRecordedPayload;
+} | {
+    id: string;
+    type: 'boxxy.attempt.started';
+    entity: string;
+    at: string;
+    payload: BoxxyAttemptStartedPayload;
+} | {
+    id: string;
+    type: 'boxxy.attempt.spawn_unanswered';
+    entity: string;
+    at: string;
+    payload: BoxxyAttemptSpawnUnansweredPayload;
+} | {
+    id: string;
+    type: 'boxxy.attempt.reconciled';
+    entity: string;
+    at: string;
+    payload: BoxxyAttemptReconciledPayload;
+} | {
+    id: string;
+    type: 'boxxy.attempt.session_bound';
+    entity: string;
+    at: string;
+    payload: BoxxyAttemptSessionBoundPayload;
+} | {
+    id: string;
+    type: 'boxxy.attempt.slept';
+    entity: string;
+    at: string;
+    payload: BoxxyAttemptSleptPayload;
+} | {
+    id: string;
+    type: 'boxxy.attempt.wake_requested';
+    entity: string;
+    at: string;
+    payload: BoxxyAttemptWakeRequestedPayload;
+} | {
+    id: string;
+    type: 'boxxy.attempt.woken';
+    entity: string;
+    at: string;
+    payload: BoxxyAttemptWokenPayload;
+} | {
+    id: string;
+    type: 'boxxy.attempt.resumed';
+    entity: string;
+    at: string;
+    payload: BoxxyAttemptResumedPayload;
+} | {
+    id: string;
+    type: 'boxxy.attempt.closed_out';
+    entity: string;
+    at: string;
+    payload: BoxxyAttemptClosedOutPayload;
+} | {
+    id: string;
+    type: 'boxxy.attempt.timed_out';
+    entity: string;
+    at: string;
+    payload: BoxxyAttemptTimedOutPayload;
+} | {
+    id: string;
+    type: 'boxxy.attempt.turn_ended';
+    entity: string;
+    at: string;
+    payload: BoxxyAttemptTurnEndedPayload;
+} | {
+    id: string;
+    type: 'boxxy.attempt.settled';
+    entity: string;
+    at: string;
+    payload: BoxxyAttemptSettledPayload;
+} | {
+    id: string;
+    type: 'boxxy.proposal.recorded';
+    entity: string;
+    at: string;
+    payload: BoxxyProposalRecordedPayload;
+} | {
+    id: string;
+    type: 'boxxy.evidence.recorded';
+    entity: string;
+    at: string;
+    payload: BoxxyEvidenceRecordedPayload;
+} | {
+    id: string;
+    type: 'boxxy.pull_request.linked';
+    entity: string;
+    at: string;
+    payload: BoxxyPullRequestLinkedPayload;
+} | {
+    id: string;
+    type: 'boxxy.commit.linked';
+    entity: string;
+    at: string;
+    payload: BoxxyCommitLinkedPayload;
+} | {
+    id: string;
+    type: 'boxxy.pull_request.merged';
+    entity: string;
+    at: string;
+    payload: BoxxyPullRequestMergedPayload;
+} | {
+    id: string;
+    type: 'boxxy.pull_request.closed';
+    entity: string;
+    at: string;
+    payload: BoxxyPullRequestClosedPayload;
+};
+export declare function readScopeFacts(scope: BoxxyItemID): BoxxyWorkFact[];
+export interface BoxxyItemRow {
+    id: BoxxyItemID;
+    kind: string;
+    repo: string;
+    title: string;
+    design_mode: string | null;
+    filed_at: string;
+    closed_at: string | null;
+    close_reason: string | null;
+    updated_at: string;
+}
+export interface BoxxyAttemptRow {
+    id: BoxxyAttemptID;
+    item_id: EntityID;
+    phase: string;
+    number: number;
+    round: number;
+    mode: string;
+    pool: string;
+    recipe_hash: string;
+    rules_version: string;
+    atc_session: string | null;
+    state: string;
+    outcome: string | null;
+    failure: string | null;
+    claimed_at: string;
+    started_at: string | null;
+    closed_out_at: string | null;
+    ended_at: string | null;
+    sleeps: unknown;
+    updated_at: string;
+}
+export interface BoxxyAttemptSessionRow {
+    attempt_id: EntityID;
+    session_id: EntityID;
+    key: string;
+    product: string | null;
+    caller_issuer: string | null;
+    caller_subject: string | null;
+    bound_at: string;
+}
+export type BoxxyWorkOperation = {
+    upsert: {
+        boxxy_item: BoxxyItemRow;
+    };
+} | {
+    upsert: {
+        boxxy_attempt: BoxxyAttemptRow;
+    };
+} | {
+    upsert: {
+        boxxy_attempt_session: BoxxyAttemptSessionRow;
+    };
+} | {
+    link: {
+        type: 'ran_in';
+        from: BoxxyAttemptID;
+        to: TelemetrySessionID;
+        confidence: number;
+        evidence: string;
+    };
+} | {
+    link: {
+        type: 'produced';
+        from: BoxxyAttemptID;
+        to: GithubPullRequestID;
+        confidence: number;
+        evidence: string;
+    };
+} | {
+    link: {
+        type: 'attempt_of';
+        from: BoxxyAttemptID;
+        to: BoxxyItemID;
+        confidence: number;
+        evidence: string;
+    };
+};
+export declare function linkRanIn(link: {
+    from: BoxxyAttemptID;
+    to: TelemetrySessionID;
+    confidence: number;
+    evidence: string;
+}): BoxxyWorkOperation;
+export declare function linkProduced(link: {
+    from: BoxxyAttemptID;
+    to: GithubPullRequestID;
+    confidence: number;
+    evidence: string;
+}): BoxxyWorkOperation;
+export declare function linkAttemptOf(link: {
+    from: BoxxyAttemptID;
+    to: BoxxyItemID;
+    confidence: number;
+    evidence: string;
+}): BoxxyWorkOperation;
+export {};

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { buildBoxxyPlugin } from './build-boxxy-plugin.ts';
+export type { DeliveryInput, DeliveryReadRow, DeliveryReads, ForeignReads, GithubPullRequestConsumer, OpaqueConsumer, StageTimeReads, TelemetryModelRequestConsumer, TelemetryTurnCostConsumer, } from './queries/types.ts';
+export { boxxySource } from './boxxy-source.ts';
+export type { BoxxyQueryClient, UncheckedQueryClient } from './types.ts';
+export { boxxyWorkConsumer } from './work/boxxy-work-consumer.ts';