wake-bridge 0.9.0-preview.8

package/dist/src/transport.d.ts

@@ -0,0 +1,23 @@
+import type { MockTransportCall, TransportContext, TransportResult, WakePayload, WakeTransport } from "./types.js";
+/** In-memory transport used by tests and local demos. */
+export declare class MockTransport implements WakeTransport {
+    readonly kind = "mock";
+    readonly calls: MockTransportCall[];
+    private failuresRemaining;
+    private readonly acceptedBatches;
+    failNext(count?: number): void;
+    dispatch(context: TransportContext): TransportResult;
+    hasAccepted(batchId: string): boolean;
+}
+/**
+ * File transport is intentionally boring: one JSON envelope per line.  It is
+ * useful as a scriptable local adapter and never evaluates the envelope as a
+ * shell command or copies source正文 into it.
+ */
+export declare class FileTransport implements WakeTransport {
+    readonly filePath: string;
+    readonly kind = "file";
+    constructor(filePath: string);
+    dispatch(context: TransportContext): TransportResult;
+}
+export type TransportFactory = (payload: WakePayload) => WakeTransport;

package/dist/src/transport.js

@@ -0,0 +1,71 @@
+import { appendFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+/** In-memory transport used by tests and local demos. */
+export class MockTransport {
+    kind = "mock";
+    calls = [];
+    failuresRemaining = 0;
+    acceptedBatches = new Set();
+    failNext(count = 1) {
+        this.failuresRemaining = Math.max(0, Math.floor(count));
+    }
+    dispatch(context) {
+        const call = {
+            attempt_id: context.attempt_id,
+            batch_id: context.batch.id,
+            endpoint_id: context.endpoint.id,
+            generation: context.binding.generation,
+            payload: context.payload,
+            at: new Date().toISOString(),
+        };
+        this.calls.push(call);
+        if (this.failuresRemaining > 0) {
+            this.failuresRemaining -= 1;
+            return {
+                accepted: false,
+                retryable: true,
+                error_class: "mock_failure",
+                error_message: "mock transport configured to fail",
+            };
+        }
+        this.acceptedBatches.add(context.batch.id);
+        return {
+            accepted: true,
+            transport_kind: this.kind,
+            receipt_details: { deduplicated: false },
+        };
+    }
+    hasAccepted(batchId) {
+        return this.acceptedBatches.has(batchId);
+    }
+}
+/**
+ * File transport is intentionally boring: one JSON envelope per line.  It is
+ * useful as a scriptable local adapter and never evaluates the envelope as a
+ * shell command or copies source正文 into it.
+ */
+export class FileTransport {
+    filePath;
+    kind = "file";
+    constructor(filePath) {
+        this.filePath = filePath;
+        mkdirSync(dirname(filePath), { recursive: true });
+    }
+    dispatch(context) {
+        const line = JSON.stringify({
+            attempt_id: context.attempt_id,
+            batch_id: context.batch.id,
+            endpoint_id: context.endpoint.id,
+            generation: context.binding.generation,
+            payload: context.payload,
+            accepted_at: new Date().toISOString(),
+        });
+        appendFileSync(this.filePath, `${line}\n`, { encoding: "utf8", mode: 0o600 });
+        return {
+            accepted: true,
+            transport_kind: this.kind,
+            receipt_details: { path: this.filePath },
+        };
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/src/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,yDAAyD;AACzD,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,MAAM,CAAC;IACd,KAAK,GAAwB,EAAE,CAAC;IACjC,iBAAiB,GAAG,CAAC,CAAC;IACb,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAErD,QAAQ,CAAC,KAAK,GAAG,CAAC;QAChB,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,QAAQ,CAAC,OAAyB;QAChC,MAAM,IAAI,GAAsB;YAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;YAC1B,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE;YAChC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU;YACtC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAC7B,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,IAAI,CAAC,iBAAiB,GAAG,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,iBAAiB,IAAI,CAAC,CAAC;YAC5B,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,SAAS,EAAE,IAAI;gBACf,WAAW,EAAE,cAAc;gBAC3B,aAAa,EAAE,mCAAmC;aACnD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3C,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,cAAc,EAAE,IAAI,CAAC,IAAI;YACzB,eAAe,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE;SACzC,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,OAAe;QACzB,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,aAAa;IAGH;IAFZ,IAAI,GAAG,MAAM,CAAC;IAEvB,YAAqB,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;QACnC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,QAAQ,CAAC,OAAyB;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;YAC1B,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE;YAChC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU;YACtC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC,CAAC;QACH,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9E,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,cAAc,EAAE,IAAI,CAAC,IAAI;YACzB,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;SACzC,CAAC;IACJ,CAAC;CACF"}

package/dist/src/types.d.ts

@@ -0,0 +1,522 @@
+import type { Server } from "node:http";
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type PriorityHint = "low" | "normal" | "high" | "urgent" | string;
+export type EventState = "received" | "matched" | "suppressed" | "batched" | "consumed" | "expired";
+export type ClaimOrigin = "policy" | "self_commitment" | "continuity_watch" | "inactivity_watch";
+export type ClaimState = "pending" | "deferred" | "eligible" | "batched" | "consumed" | "dismissed" | "expired";
+export type DeliveryMode = "immediate" | "scheduled" | "suppress";
+export type QuietHoursPolicy = "defer" | "bypass";
+export type ForegroundPresencePolicy = "defer" | "bypass";
+export type BatchState = "pending" | "waiting_for_endpoint" | "waiting_for_waiter" | "dispatching" | "retry_wait" | "dispatched" | "seen" | "cancelled" | "needs_attention" | "dead_letter";
+export type AttemptState = "leased" | "accepted" | "failed" | "expired";
+export type ReceiptStage = "transport_accepted" | "agent_completed" | "agent_seen" | "agent_consumed" | "agent_acted";
+export type SourceReadSideEffects = "none" | "marks_read" | "consumes" | "unknown";
+export type SourceCredentialCustody = "none" | "connector" | "wake_bridge_process";
+export type SourceUpstreamCredentialBreadth = "none" | "read_only" | "broad" | "unknown";
+export type SourceCursor = JsonValue | null;
+export interface ResourceRef {
+    uri: string;
+    cursor?: string | number | null;
+    [key: string]: unknown;
+}
+export interface WakeEventInput {
+    schema_version?: number;
+    type: string;
+    occurred_at?: string;
+    dedupe_key: string;
+    coalesce_key?: string | null;
+    priority_hint?: PriorityHint | null;
+    attention_channel_hint?: string | null;
+    actor_ref?: string | null;
+    resource: ResourceRef;
+    metadata?: Record<string, JsonValue>;
+    payload_preview?: string | null;
+    /** Optional caller idempotency key. It never changes source dedupe semantics. */
+    idempotency_key?: string | null;
+}
+/** Public capability declaration for one pull source adapter. */
+export interface SourceAdapterManifest {
+    /** Public source SDK contract, independent from this adapter's release version. */
+    contract_version: 1;
+    id: string;
+    version: string;
+    /** Non-secret upstream principal chosen and confirmed by the source owner. */
+    subject_ref: string;
+    /** Non-secret sha256 fence for the connector's current upstream configuration. */
+    binding_fingerprint: string;
+    read_side_effects: SourceReadSideEffects;
+    /** Where the provider credential is actually held, not who owns the account. */
+    credential_custody: SourceCredentialCustody;
+    /** Honest breadth of the provider credential, which may be broader than this connector surface. */
+    upstream_credential_breadth: SourceUpstreamCredentialBreadth;
+    upstream_credential_scopes: string[];
+    /** The narrow operations exposed by the connector to its Wake source adapter. */
+    connector_capabilities: string[];
+}
+export interface SourcePollContext {
+    cursor: SourceCursor;
+    limit: number;
+}
+export interface SourcePollResult {
+    events: WakeEventInput[];
+    next_cursor: SourceCursor;
+    /** True asks the runner to schedule another bounded pass soon. */
+    has_more?: boolean;
+}
+export interface PullSourceAdapter {
+    readonly manifest: SourceAdapterManifest;
+    poll(context: SourcePollContext): Promise<SourcePollResult> | SourcePollResult;
+}
+export interface SourceCheckpoint {
+    instance_id: string;
+    source: string;
+    adapter_version: string;
+    subject_ref: string;
+    binding_fingerprint: string;
+    cursor: SourceCursor;
+    revision: number;
+    updated_at: string;
+}
+/** Agent-facing checkpoint metadata. Opaque provider cursors stay inside Core. */
+export type SourceCheckpointSummary = Omit<SourceCheckpoint, "cursor" | "instance_id">;
+export interface SourceRunResult {
+    source: string;
+    adapter_version: string;
+    checkpoint_revision: number;
+    events_seen: number;
+    events_inserted: number;
+    events_duplicate: number;
+    has_more: boolean;
+}
+/** Owner-controlled local connector. The token authenticates to the connector, not the provider. */
+export interface SourceConnectorConfig {
+    id: string;
+    base_url: string;
+    token_env: string;
+    enabled?: boolean;
+    poll_interval_ms?: number;
+    max_backoff_ms?: number;
+    limit?: number;
+    max_pages_per_cycle?: number;
+}
+export interface SourceConnectorFile {
+    version: 1;
+    sources: SourceConnectorConfig[];
+}
+export type SourceSupervisorState = "idle" | "polling" | "healthy" | "backoff" | "needs_attention" | "stopped";
+export interface SourceSupervisorStatus {
+    source: string;
+    enabled: boolean;
+    state: SourceSupervisorState;
+    last_started_at: string | null;
+    last_success_at: string | null;
+    last_error_at: string | null;
+    last_error_class: string | null;
+    consecutive_failures: number;
+    next_poll_at: string | null;
+    checkpoint_revision: number;
+    checkpoint_subject_ref: string | null;
+    checkpoint_binding_fingerprint: string | null;
+    last_run: SourceRunResult | null;
+}
+export interface SourceVerification {
+    source: string;
+    manifest: SourceAdapterManifest;
+    checkpoint: SourceCheckpointSummary | null;
+    binding_matches: boolean;
+    enabled: boolean;
+}
+export interface WakeEvent extends WakeEventInput {
+    id: string;
+    schema_version: number;
+    instance_id: string;
+    owner_id: string;
+    source: string;
+    occurred_at: string;
+    received_at: string;
+    state: EventState;
+    matched_policy_id?: string | null;
+    matched_policy_version?: number | null;
+}
+export interface PolicyMatch {
+    source?: string;
+    type?: string;
+    actor_ref?: string;
+    attention_channel_hint?: string;
+    metadata?: Record<string, JsonValue | undefined>;
+    /** Dot-path selectors are also accepted for convenient JSON policy files. */
+    [key: string]: unknown;
+}
+export interface PolicyDelivery {
+    mode: DeliveryMode;
+    scheduled_local_time?: string | null;
+    quiet_hours_policy?: QuietHoursPolicy;
+    foreground_presence_policy?: ForegroundPresencePolicy;
+}
+export interface PolicyBatch {
+    coalesce_by?: "coalesce_key" | "type" | "source" | "none" | string;
+    max_events?: number | null;
+    window_ms?: number | null;
+}
+export interface PolicyTarget {
+    attention_channel?: string | null;
+}
+export interface PolicyRule {
+    id: string;
+    version: number;
+    enabled?: boolean;
+    order?: number;
+    match?: PolicyMatch;
+    delivery: PolicyDelivery;
+    batch?: PolicyBatch;
+    target?: PolicyTarget;
+    reason_code?: string;
+    expires_after_ms?: number | null;
+}
+/**
+ * Read-only representation of policy rows created before public policy v1.
+ * Legacy fields are never accepted by current install surfaces and legacy
+ * rules do not participate in matching new events.
+ */
+export interface InstalledPolicyRule extends Omit<PolicyRule, "delivery" | "target"> {
+    delivery: Omit<PolicyDelivery, "mode"> & {
+        mode: DeliveryMode | "debounce" | "digest";
+        debounce_ms?: number | null;
+        cadence_ms?: number | null;
+        max_delay_ms?: number | null;
+    };
+    target?: PolicyTarget & {
+        prefer_transport?: "warm" | "cold" | "any";
+        busy_behavior?: "queue" | "retry" | "steer";
+    };
+}
+/** Stable, owner-authored policy file contract. */
+export interface PolicyFile {
+    schema_version: 1;
+    policies: PolicyRule[];
+}
+export interface PolicyMatchResult {
+    source: string;
+    type: string;
+    matched_policy: PolicyRule;
+}
+export interface PolicyPreviewResult extends PolicyMatchResult {
+    evaluated_at: string;
+    suppressed: boolean;
+    claim: null | {
+        attention_channel: string;
+        eligible_after: string;
+        expires_at: string | null;
+        reason_code: string;
+        defer_while_presence: boolean;
+    };
+    gates: {
+        quiet_hours: {
+            action: QuietHoursPolicy;
+            active: boolean;
+            defer_until: string | null;
+        };
+        foreground_presence: {
+            action: ForegroundPresencePolicy;
+            active: boolean;
+            defer_until: string | null;
+        };
+    };
+    batch: null | {
+        coalesce_by: string;
+        coalesce_key: string | null;
+        max_events: number;
+        window_ms: number;
+    };
+}
+export interface PolicyVersionStatus {
+    id: string;
+    version: number;
+    active: boolean;
+    enabled: boolean;
+    new_event_matching: "eligible" | "disabled" | "legacy_unsupported" | "historical";
+}
+export interface QuietHoursWindow {
+    start: string;
+    end: string;
+}
+export interface QuietHoursConfig {
+    timezone?: string;
+    windows: QuietHoursWindow[];
+}
+export interface BridgeConfig {
+    instance_id: string;
+    owner_id: string;
+    db_path: string;
+    timezone?: string;
+    admin_token?: string;
+    quiet_hours?: QuietHoursConfig | null;
+    presence_ttl_ms?: number;
+    activity_ttl_ms?: number;
+    endpoint_lease_ms?: number;
+    dispatch_lease_ms?: number;
+    retry_delay_ms?: number;
+    batch_window_ms?: number;
+    default_policy?: PolicyRule;
+    policies?: PolicyRule[];
+}
+export interface AttentionClaim {
+    id: string;
+    instance_id: string;
+    origin: ClaimOrigin;
+    event_ids: string[];
+    resource: ResourceRef;
+    policy_id: string;
+    policy_version: number;
+    attention_channel: string;
+    eligible_after: string;
+    expires_at?: string | null;
+    defer_while_presence: boolean;
+    state: ClaimState;
+    reason_code: string;
+    note?: string | null;
+    created_at: string;
+    updated_at: string;
+    snooze_until?: string | null;
+    consumed_result?: JsonValue | null;
+    dismissed_reason?: string | null;
+}
+export interface EndpointRoute {
+    kind: string;
+    priority?: number;
+    address: Record<string, JsonValue>;
+}
+export interface EndpointCapabilities {
+    cold_push?: boolean;
+    warm_resume?: boolean;
+    exact_live_route?: boolean;
+    requires_live_binding?: boolean;
+    queue_when_busy?: boolean;
+    steer_when_busy?: boolean;
+    foreground_presence_observable?: boolean;
+    session_activity_observable?: boolean;
+    activity_progress_observable?: boolean;
+    waiter_turn_settle_compatible?: boolean;
+    session_rebuild_takeover?: boolean;
+    receipt_upper_bound?: string;
+    support_tier?: string;
+    receipt_stages?: ReceiptStage[];
+    [key: string]: JsonValue | undefined;
+}
+export interface EndpointRegistration {
+    id?: string;
+    host_kind: string;
+    session_ref: string;
+    capabilities?: EndpointCapabilities;
+    routes?: EndpointRoute[];
+    lease_ms?: number;
+}
+export interface Endpoint {
+    id: string;
+    instance_id: string;
+    host_kind: string;
+    session_ref: string;
+    lease_token?: string;
+    lease_expires_at: string;
+    capabilities: EndpointCapabilities;
+    routes: EndpointRoute[];
+    registered_at: string;
+    updated_at: string;
+}
+export interface Binding {
+    instance_id: string;
+    attention_channel: string;
+    endpoint_id: string;
+    generation: number;
+    bound_at: string;
+}
+export interface PresenceLease {
+    instance_id: string;
+    attention_channel: string;
+    endpoint_id: string;
+    binding_generation: number;
+    renewed_at: string;
+    expires_at: string;
+    observed_by: string;
+    observation: string;
+}
+export interface PresenceRenewal {
+    attention_channel: string;
+    endpoint_id: string;
+    generation: number;
+    ttl_ms?: number;
+    lease_token?: string;
+    observed_by: string;
+    observation?: string;
+}
+export type ActivityKind = "owner_message_accepted" | "activity_started" | "activity_progress" | "activity_settled" | "wake_started" | "wake_progress" | "wake_settled";
+export interface ActivityObservation {
+    attention_channel: string;
+    endpoint_id: string;
+    generation: number;
+    lease_token?: string;
+    observation_id: string;
+    kind: ActivityKind;
+    observed_at?: string;
+    ttl_ms?: number;
+}
+export interface ActivityObservationResult {
+    duplicate: boolean;
+    watch: ActivityWatch | null;
+}
+export interface ActivityWatchConfiguration {
+    attention_channel: string;
+    enabled: boolean;
+    idle_after_ms: number;
+    mode?: "once" | "repeat";
+    repeat_after_ms?: number;
+}
+export interface ActivityWatch {
+    instance_id: string;
+    attention_channel: string;
+    enabled: boolean;
+    idle_after_ms: number;
+    endpoint_id: string | null;
+    binding_generation: number | null;
+    epoch: number;
+    armed_at: string | null;
+    last_nonwake_activity_at: string | null;
+    activity_lease_expires_at: string | null;
+    fired_epoch: number | null;
+    mode: "once" | "repeat";
+    repeat_after_ms: number;
+    sequence: number;
+    last_triggered_at: string | null;
+    next_due_at: string | null;
+    condition_status: "disabled" | "waiting_for_endpoint" | "unsupported" | "waiting_for_activity" | "watching" | "inactive";
+    limits: {
+        min_interval_ms: number;
+        max_claims_per_tick: number;
+    };
+    updated_at: string;
+}
+export interface WakeBatch {
+    id: string;
+    instance_id: string;
+    policy_id: string;
+    policy_version: number;
+    attention_channel: string;
+    claim_ids: string[];
+    event_ids: string[];
+    coalesce_key?: string | null;
+    state: BatchState;
+    not_before: string;
+    deadline?: string | null;
+    attempt: number;
+    binding_generation?: number | null;
+    created_at: string;
+    updated_at: string;
+    lease_expires_at?: string | null;
+    last_error?: string | null;
+}
+export interface WakeBriefClaim {
+    claim_id: string;
+    event_id?: string;
+    source: string;
+    type: string;
+    resource: ResourceRef;
+    origin: ClaimOrigin;
+    reason_code: string;
+}
+export interface WakePayload {
+    schema_version: number;
+    instance_id: string;
+    wake_batch_id: string;
+    attention_channel: string;
+    claim_refs: WakeBriefClaim[];
+    binding_generation: number;
+}
+export interface TransportContext {
+    batch: WakeBatch;
+    endpoint: Endpoint;
+    binding: Binding;
+    payload: WakePayload;
+    attempt_id: string;
+    /** One-shot nonce generated and persisted by Core before transport dispatch. */
+    delivery_nonce: string;
+}
+export type DeliveryCorrelationState = "outstanding" | "consumed" | "discarded" | "expired";
+export interface DeliveryCorrelation {
+    attempt_id: string;
+    batch_id: string;
+    endpoint_id: string;
+    binding_generation: number;
+    transport_kind: string;
+    nonce_hash: string;
+    state: DeliveryCorrelationState;
+    created_at: string;
+    expires_at: string;
+    consumed_at?: string | null;
+}
+export interface WakeEchoObservation {
+    attention_channel: string;
+    endpoint_id: string;
+    generation: number;
+    lease_token?: string;
+    observation_id: string;
+    delivery_nonce: string;
+    observed_at?: string;
+    ttl_ms?: number;
+}
+export interface TransportResult {
+    accepted: boolean;
+    transport_kind?: string;
+    receipt_details?: Record<string, JsonValue>;
+    retryable?: boolean;
+    /** Optional transport-directed delay before retrying this durable batch. */
+    retry_after_ms?: number;
+    error_class?: string;
+    error_message?: string;
+}
+export interface WakeTransport {
+    readonly kind: string;
+    readonly capabilities?: EndpointCapabilities;
+    dispatch(context: TransportContext): Promise<TransportResult> | TransportResult;
+}
+export interface MockTransportCall {
+    attempt_id: string;
+    batch_id: string;
+    endpoint_id: string;
+    generation: number;
+    payload: WakePayload;
+    at: string;
+}
+export interface Receipt {
+    id: string;
+    batch_id: string;
+    claim_id?: string | null;
+    stage: ReceiptStage;
+    at: string;
+    endpoint_id?: string | null;
+    binding_generation?: number | null;
+    transport_kind?: string | null;
+    details?: Record<string, JsonValue> | null;
+}
+export interface TickResult {
+    inactivity_claims_created: string[];
+    expired_claims: string[];
+    deferred_claims: string[];
+    eligible_claims: string[];
+    batches_created: string[];
+    batches_updated: string[];
+}
+export interface DispatchResult {
+    batch_id: string;
+    status: "accepted" | "waiting_for_endpoint" | "retry_wait" | "needs_attention" | "dead_letter" | "stale_generation" | "skipped";
+    attempt_id?: string;
+    endpoint_id?: string;
+    generation?: number;
+    error_class?: string;
+}
+export interface DaemonHandle {
+    server: Server;
+    close(): Promise<void>;
+}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/src/util.d.ts

@@ -0,0 +1,26 @@
+import type { JsonValue, QuietHoursConfig } from "./types.js";
+export declare const DEFAULT_TIMEZONE = "UTC";
+export declare function id(prefix: string): string;
+export declare function isoNow(now?: Date): string;
+export declare function asDate(value: string | Date): Date;
+export declare function addMs(value: string | Date, milliseconds: number): string;
+export declare function sha256(value: string): string;
+export declare function parseJson<T>(value: unknown, fallback: T): T;
+export declare function stableJson(value: unknown): string;
+export declare function getPath(value: unknown, path: string): unknown;
+export declare function localParts(date: Date, timezone: string): {
+    date: string;
+    hour: number;
+    minute: number;
+    second: number;
+};
+export declare function localMinute(date: Date, timezone: string): number;
+export declare function parseClock(value: string): number;
+export declare function clockInWindow(minute: number, start: number, end: number): boolean;
+export declare function quietWindowAt(date: Date, config: QuietHoursConfig | null | undefined, fallbackTimezone?: string): boolean;
+/** Find the first minute at which a quiet-hours gate is open again. */
+export declare function quietEndAfter(date: Date, config: QuietHoursConfig | null | undefined, fallbackTimezone?: string): Date;
+/** Resolve the next occurrence of HH:mm in a timezone using a bounded search. */
+export declare function nextLocalClock(date: Date, clock: string, timezone: string): Date;
+export declare function jsonValue(value: unknown): JsonValue;
+export declare function assertFiniteMs(value: number | null | undefined, field: string, fallback: number): number;