@astrosheep/square 0.4.0 → 0.4.1

package/dist/channel-ports.d.ts

@@ -1,241 +0,0 @@
-import type { Owner } from './neutral.js';
-import type { MessageMetadata, JsonValue, WakeAddress } from './channel-values.js';
-import type { MetadataMatch, DeliveryDeferralFact } from './delivery-deferral.js';
-import type { AttemptOutcome } from './delivery-attempts.js';
-import type { MessageId } from './message.js';
-import type { EndpointGeneration } from './message.js';
-export type { MessageId, EndpointGeneration };
-/** One lower write's custody claim. Every Channel mutation carries exactly one. */
-export type ChannelWriteAuthority = {
-    readonly kind: 'send';
-    readonly actor: string;
-} | {
-    readonly kind: 'endpoint';
-    readonly participant: string;
-    readonly owner: Owner;
-} | {
-    readonly kind: 'endpoint-cleanup';
-    readonly seat: EndpointRef;
-} | {
-    readonly kind: 'participant';
-    readonly seat: EndpointRef;
-};
-/** The only storage surface a Channel is allowed to see: messages, endpoints and their custody. */
-export interface ChannelArtifact {
-    read<T>(select: (facts: ChannelRead) => T, signal?: AbortSignal): Promise<{
-        readonly value: T;
-        readonly version: number;
-    }>;
-    transactAs<T>(authority: ChannelWriteAuthority, change: (facts: ChannelWrite) => T, signal?: AbortSignal): Promise<{
-        readonly value: T;
-        readonly changed: boolean;
-    }>;
-    claimDelivery(input: ChannelDeliveryClaimInput, signal?: AbortSignal): Promise<ChannelDeliveryClaimResult>;
-    prepareDelivery(input: ChannelDeliveryPreparation, signal?: AbortSignal): Promise<boolean>;
-    completeDelivery(input: ChannelDeliveryCompletion, signal?: AbortSignal): Promise<boolean>;
-    cancelDeliveries(seat: EndpointRef, through?: number, signal?: AbortSignal): Promise<boolean>;
-    changed(sinceVersion: number, timeoutMs: number, signal?: AbortSignal): Promise<boolean>;
-    close(): Promise<void>;
-}
-export interface ChannelHeader {
-    readonly revision: number;
-    readonly deliveryRevision: number;
-    readonly nextMessageIndex: number;
-    readonly lastMessageIndex: number;
-}
-/** One Channel message. Body and caller metadata have exactly one authoritative copy. */
-export interface MessageFact {
-    readonly index: number;
-    readonly at: number;
-    readonly from: string;
-    readonly body: string;
-    readonly metadata?: MessageMetadata;
-    /** Sender-chosen preview projection; the stored body remains full. */
-    readonly preview?: string;
-}
-export interface MessageAddressFact {
-    readonly recipient: string;
-    readonly generation?: EndpointGeneration;
-}
-export interface MessageHead {
-    readonly index: number;
-    readonly at: number;
-    readonly from: string;
-    readonly recipient: string;
-    readonly generation?: EndpointGeneration;
-}
-export interface MessageFilter {
-    readonly afterIndex?: number;
-    readonly beforeIndex?: number;
-    readonly throughIndex?: number;
-    readonly indexes?: readonly number[];
-    readonly senders?: readonly string[];
-    readonly senderMatch?: 'identity' | 'exact';
-    readonly afterAt?: number;
-    readonly metadataMatch?: MetadataMatch;
-    readonly search?: {
-        readonly text: string;
-        readonly mode: 'literal' | 'regex';
-    };
-    readonly unseenOnly?: true;
-    readonly currentGeneration?: true;
-}
-export interface MessageDraft {
-    readonly from: string;
-    readonly at: number;
-    readonly body: string;
-    readonly metadata?: MessageMetadata;
-    readonly preview?: string;
-    readonly to: readonly MessageAddressFact[];
-}
-export interface EndpointFact {
-    readonly participant: string;
-    readonly owner: Owner;
-    readonly generation: EndpointGeneration;
-    readonly attachment: 'attached' | 'detached';
-    readonly wakeAddress?: WakeAddress;
-}
-export type EndpointRef = Pick<EndpointFact, 'participant' | 'owner' | 'generation'>;
-/** Upper-owned namespace association; Channel never interprets its selector. */
-export interface ReceiveClaimFact {
-    readonly namespace: string;
-    readonly id: string;
-    readonly owner: string;
-    readonly generation: EndpointGeneration;
-    readonly selector: JsonValue;
-    /** Message-scoped suppression coverage; Channel owns this list, the selector stays opaque. */
-    readonly suppressed: readonly number[];
-    readonly heartbeatAt: number;
-    readonly expiresAt: number;
-}
-export interface ChannelDeliveryEvidence {
-    readonly participant: string;
-    readonly generation: EndpointGeneration;
-    readonly message: MessageId;
-    readonly kind: 'wake' | 'presentation';
-    readonly outcome: AttemptOutcome;
-    readonly attemptN: number;
-    readonly at: number;
-    readonly expiresAt?: number;
-    readonly claimToken?: string;
-    readonly route?: WakeAddress;
-    readonly signature?: string;
-    readonly messageText?: string;
-    readonly diagnostic?: JsonValue;
-    readonly correlation?: {
-        readonly harness: 'claude' | 'opencode' | 'pi';
-        readonly token?: string;
-        readonly messageId?: string;
-        readonly payloadHash?: string;
-    };
-    /** Exact bytes prepared for this attempt; declared before the external effect. */
-    readonly coverage?: 'full' | 'clipped';
-    readonly description?: string;
-    readonly nativeObservations?: readonly {
-        readonly eventId: string;
-        readonly messageId: string;
-        readonly state: 'held' | 'released' | 'dropped';
-        readonly reason?: string;
-        readonly observedAt: number;
-    }[];
-}
-export interface ChannelDeliveryClaimInput {
-    readonly seat: EndpointRef;
-    readonly message: MessageId;
-    readonly kind: 'wake' | 'presentation';
-    readonly observationOf?: string;
-    readonly route?: WakeAddress;
-    readonly at: number;
-    readonly leaseMs: number;
-    readonly claimToken: string;
-}
-export type ChannelDeliveryClaimResult = {
-    readonly status: 'acquired';
-    readonly claimToken: string;
-    readonly attemptN: number;
-} | {
-    readonly status: 'busy' | 'terminal' | 'stale' | 'deferred';
-    readonly evidence?: ChannelDeliveryEvidence;
-};
-export interface ChannelDeliveryPreparation {
-    readonly seat: EndpointRef;
-    readonly claimToken: string;
-    readonly correlation: NonNullable<ChannelDeliveryEvidence['correlation']>;
-    readonly coverage: 'full' | 'clipped';
-    readonly description?: string;
-}
-export interface ChannelDeliveryCompletion {
-    readonly seat: EndpointRef;
-    readonly message: MessageId;
-    readonly claimToken: string;
-    readonly outcome: Exclude<ChannelDeliveryEvidence['outcome'], 'dispatching'>;
-    readonly at: number;
-    readonly signature?: string;
-    readonly messageText?: string;
-    readonly diagnostic?: JsonValue;
-    readonly correlation?: ChannelDeliveryEvidence['correlation'];
-}
-/** Lower read capabilities. Nothing here describes Agora events, routes or attention. */
-export interface ChannelRead {
-    header(): ChannelHeader;
-    message(index: number): MessageFact | undefined;
-    messages(indexes: readonly number[]): readonly MessageFact[];
-    messageHeads(filter: MessageFilter, page: {
-        readonly edge: 'oldest' | 'newest';
-        readonly limit: number;
-    }): {
-        readonly items: readonly MessageFact[];
-        readonly hasMore: boolean;
-    };
-    messageCount(filter: MessageFilter): number;
-    addresses(index: number): readonly MessageAddressFact[];
-    receipt(owner: string, index: number): {
-        readonly at: number;
-    } | undefined;
-    receiptFacts(owner: string, afterIndex: number): {
-        readonly latestAt?: number;
-        readonly latestActorMessageIndex?: number;
-    };
-    directed(recipient: string, filter: MessageFilter, page: {
-        readonly edge: 'oldest' | 'newest';
-        readonly limit: number;
-    }): {
-        readonly items: readonly MessageHead[];
-        readonly hasMore: boolean;
-    };
-    directedCount(recipient: string, filter: MessageFilter): number;
-    endpoint(requested: string): EndpointFact | undefined;
-    endpointsForOwner(owner: Owner): readonly EndpointFact[];
-    endpoints(): readonly EndpointFact[];
-    deliveryEvidence(participant: string, generation: EndpointGeneration, message?: MessageId): readonly ChannelDeliveryEvidence[];
-    deliveryByToken(claimToken: string): ChannelDeliveryEvidence | undefined;
-    cancelledThrough(participant: string, generation: EndpointGeneration): number | undefined;
-    deliveryDeferrals(participant: string, generation: EndpointGeneration): readonly DeliveryDeferralFact[];
-    receiveClaims(owner: string, namespace?: string): readonly ReceiveClaimFact[];
-    claimLease(owner: string, namespace?: string): ReceiveClaimFact | undefined;
-    /** Any live claim of this endpoint covering the message suppresses its pending eligibility. */
-    suppressed(owner: string, generation: EndpointGeneration, index: number, now: number): boolean;
-}
-export interface ChannelWrite extends ChannelRead {
-    publishMessage(draft: MessageDraft): MessageFact;
-    storeEndpoint(endpoint: EndpointFact): boolean;
-    updateWakeAddress(endpoint: EndpointRef, wakeAddress?: WakeAddress): boolean;
-    reattachEndpoint(endpoint: EndpointRef, wakeAddress?: WakeAddress): boolean;
-    detachEndpoint(endpoint: EndpointRef): boolean;
-    removeEndpoint(endpoint: EndpointRef): boolean;
-    cancelThrough(endpoint: EndpointRef, through: number): boolean;
-    markSeen(owner: string, indexes: readonly number[], at: number): number;
-    claimDelivery(input: ChannelDeliveryClaimInput): ChannelDeliveryClaimResult;
-    prepareDelivery(input: ChannelDeliveryPreparation): boolean;
-    completeDelivery(input: ChannelDeliveryCompletion): boolean;
-    observeNativeDelivery(input: {
-        readonly seat: EndpointRef;
-        readonly claimToken: string;
-        readonly observation: NonNullable<ChannelDeliveryEvidence['nativeObservations']>[number];
-    }): boolean;
-    putDeliveryDeferral(seat: EndpointRef, id: string, match: MetadataMatch, expiresAt: number, now: number): boolean;
-    renewDeliveryDeferral(seat: EndpointRef, id: string, expiresAt: number, now: number): boolean;
-    releaseDeliveryDeferral(seat: EndpointRef, id: string, now: number): boolean;
-    putReceiveClaim(claim: ReceiveClaimFact): boolean;
-    removeReceiveClaim(owner: string, namespace: string, id: string): boolean;
-}

package/dist/channel-ports.js

@@ -1 +0,0 @@
-export {};

package/dist/channel-presentation.d.ts

@@ -1,17 +0,0 @@
-export declare function escapeSquareTags(text: string): string;
-/** A Channel message has no Agora route or activity record. */
-export declare function projectChannelNotification({ actor, body, preview }: {
-    squarePath: string;
-    recipient: string;
-    actor: string;
-    body: string;
-    preview?: string;
-}): {
-    text: string;
-    full: string;
-    preview: string;
-    description: string;
-    clipped: boolean;
-};
-/** The fixed model-facing outer frame, independent of transport and source. */
-export declare function renderSquareReminder(previews: readonly string[]): string;

package/dist/channel-presentation.js

@@ -1,22 +0,0 @@
-export function escapeSquareTags(text) {
-    return text.replace(/<(\/?)(square-|channel-|system-reminder)/gi, '<\\$1$2');
-}
-/** A Channel message has no Agora route or activity record. */
-export function projectChannelNotification({ actor, body, preview }) {
-    const compact = body.replace(/\r\n/g, '\n');
-    const projected = preview ?? compact;
-    return {
-        // Channel's default notification is the full (or explicitly previewed) escaped body.
-        text: escapeSquareTags(projected),
-        // Human expansion is the stored full body, never a sender-owned preview.
-        full: compact,
-        preview: projected, description: `${actor} sent you a message`, clipped: projected !== compact,
-    };
-}
-/** The fixed model-facing outer frame, independent of transport and source. */
-export function renderSquareReminder(previews) {
-    if (previews.length === 0)
-        return '';
-    return ['', '<system-reminder>', 'This is an external notification, not a direct message from the user.', '',
-        previews.join('\n\n'), '</system-reminder>', ''].join('\n');
-}

package/dist/channel-sqlite-schema.d.ts

@@ -1,13 +0,0 @@
-import type { DatabaseSync } from 'node:sqlite';
-import type { StoreFormat } from './artifact-store.js';
-/** Channel owns this schema in both standalone and composed artifacts. */
-export declare const CHANNEL_SCHEMA_SQL = "CREATE TABLE channel_meta (\n  id INTEGER PRIMARY KEY CHECK (id = 1),\n  next_msg_index INTEGER NOT NULL CHECK (next_msg_index BETWEEN 0 AND 9007199254740991),\n  description TEXT NOT NULL\n);\nCREATE TABLE messages (\n  msg_index INTEGER PRIMARY KEY CHECK (msg_index BETWEEN 0 AND 9007199254740991),\n  at REAL NOT NULL, from_json TEXT NOT NULL, from_key_json TEXT NOT NULL,\n  body_json TEXT NOT NULL CHECK (json_valid(body_json)),\n  metadata_json TEXT CHECK (metadata_json IS NULL OR json_valid(metadata_json)), preview TEXT\n);\nCREATE INDEX message_sender ON messages(from_key_json,msg_index);\nCREATE TABLE message_addresses (\n  msg_index INTEGER NOT NULL, recipient_key_json TEXT NOT NULL, recipient_json TEXT NOT NULL,\n  recipient_order INTEGER NOT NULL CHECK (recipient_order >= 0), generation_json TEXT,\n  PRIMARY KEY (msg_index,recipient_key_json), UNIQUE(msg_index,recipient_order)\n) WITHOUT ROWID;\nCREATE INDEX message_recipient ON message_addresses(recipient_key_json,msg_index);\nCREATE TABLE receipts (\n  owner_key_json TEXT NOT NULL, msg_index INTEGER NOT NULL, at REAL NOT NULL,\n  PRIMARY KEY (owner_key_json,msg_index)\n) WITHOUT ROWID;\nCREATE INDEX receipt_owner_time ON receipts(owner_key_json,at);\nCREATE TABLE endpoints (\n  participant_key_json TEXT PRIMARY KEY NOT NULL, participant_json TEXT NOT NULL,\n  owner_json TEXT NOT NULL, generation_json TEXT NOT NULL,\n  wake_address_json TEXT CHECK (wake_address_json IS NULL OR json_valid(wake_address_json)),\n  attachment TEXT NOT NULL CHECK (attachment IN ('attached','detached'))\n) WITHOUT ROWID;\nCREATE INDEX endpoint_owner ON endpoints(owner_json);\nCREATE TABLE delivery_evidence (\n  participant_key_json TEXT NOT NULL, participant_json TEXT NOT NULL, generation_json TEXT NOT NULL,\n  msg_index INTEGER NOT NULL, kind TEXT NOT NULL CHECK (kind IN ('wake','presentation')),\n  attempt_n INTEGER NOT NULL CHECK (attempt_n >= 0), outcome TEXT NOT NULL,\n  at REAL NOT NULL, expires_at REAL, claim_token_json TEXT,\n  payload_json TEXT NOT NULL CHECK (json_valid(payload_json)),\n  PRIMARY KEY (participant_key_json,generation_json,msg_index,kind,attempt_n)\n) WITHOUT ROWID;\nCREATE UNIQUE INDEX delivery_claim_token ON delivery_evidence(claim_token_json) WHERE claim_token_json IS NOT NULL;\nCREATE TABLE delivery_cancellations (\n  participant_key_json TEXT NOT NULL, generation_json TEXT NOT NULL, through_index INTEGER NOT NULL,\n  PRIMARY KEY (participant_key_json,generation_json)\n) WITHOUT ROWID;\nCREATE TABLE delivery_deferrals (\n  participant_key_json TEXT NOT NULL, participant_json TEXT NOT NULL, generation_json TEXT NOT NULL,\n  deferral_id_json TEXT NOT NULL, match_json TEXT NOT NULL CHECK (json_valid(match_json)), expires_at REAL NOT NULL,\n  PRIMARY KEY (participant_key_json,generation_json,deferral_id_json)\n) WITHOUT ROWID;\nCREATE INDEX delivery_deferral_expiry ON delivery_deferrals(participant_key_json,generation_json,expires_at);\nCREATE TABLE receive_claims (\n  namespace_key_json TEXT NOT NULL, owner_key_json TEXT NOT NULL, generation_json TEXT NOT NULL,\n  claim_id_json TEXT NOT NULL, heartbeat_at REAL NOT NULL, expires_at REAL NOT NULL CHECK (expires_at >= heartbeat_at),\n  selector_json TEXT NOT NULL CHECK (json_valid(selector_json)), suppressed_json TEXT NOT NULL CHECK (json_valid(suppressed_json)),\n  PRIMARY KEY (namespace_key_json,owner_key_json)\n) WITHOUT ROWID;";
-export declare function initializeChannelSqlite(db: DatabaseSync, description?: string): void;
-export declare function resetChannelSqlite(db: DatabaseSync): void;
-export declare const channelLowerSchema: {
-    schemaSql: string;
-    initialize: typeof initializeChannelSqlite;
-    reset: typeof resetChannelSqlite;
-};
-export declare const channelStoreFormat: StoreFormat;
-export declare function initializeStandaloneChannel(db: DatabaseSync, revision?: number, description?: string): void;

package/dist/channel-sqlite-schema.js

@@ -1,81 +0,0 @@
-import { initializeStorageMeta, resetStorageMeta, STORAGE_META_SQL, validateSchema } from './sqlite-framing.js';
-import { requireFact } from './sqlite-values.js';
-/** Channel owns this schema in both standalone and composed artifacts. */
-export const CHANNEL_SCHEMA_SQL = `CREATE TABLE channel_meta (
-  id INTEGER PRIMARY KEY CHECK (id = 1),
-  next_msg_index INTEGER NOT NULL CHECK (next_msg_index BETWEEN 0 AND 9007199254740991),
-  description TEXT NOT NULL
-);
-CREATE TABLE messages (
-  msg_index INTEGER PRIMARY KEY CHECK (msg_index BETWEEN 0 AND 9007199254740991),
-  at REAL NOT NULL, from_json TEXT NOT NULL, from_key_json TEXT NOT NULL,
-  body_json TEXT NOT NULL CHECK (json_valid(body_json)),
-  metadata_json TEXT CHECK (metadata_json IS NULL OR json_valid(metadata_json)), preview TEXT
-);
-CREATE INDEX message_sender ON messages(from_key_json,msg_index);
-CREATE TABLE message_addresses (
-  msg_index INTEGER NOT NULL, recipient_key_json TEXT NOT NULL, recipient_json TEXT NOT NULL,
-  recipient_order INTEGER NOT NULL CHECK (recipient_order >= 0), generation_json TEXT,
-  PRIMARY KEY (msg_index,recipient_key_json), UNIQUE(msg_index,recipient_order)
-) WITHOUT ROWID;
-CREATE INDEX message_recipient ON message_addresses(recipient_key_json,msg_index);
-CREATE TABLE receipts (
-  owner_key_json TEXT NOT NULL, msg_index INTEGER NOT NULL, at REAL NOT NULL,
-  PRIMARY KEY (owner_key_json,msg_index)
-) WITHOUT ROWID;
-CREATE INDEX receipt_owner_time ON receipts(owner_key_json,at);
-CREATE TABLE endpoints (
-  participant_key_json TEXT PRIMARY KEY NOT NULL, participant_json TEXT NOT NULL,
-  owner_json TEXT NOT NULL, generation_json TEXT NOT NULL,
-  wake_address_json TEXT CHECK (wake_address_json IS NULL OR json_valid(wake_address_json)),
-  attachment TEXT NOT NULL CHECK (attachment IN ('attached','detached'))
-) WITHOUT ROWID;
-CREATE INDEX endpoint_owner ON endpoints(owner_json);
-CREATE TABLE delivery_evidence (
-  participant_key_json TEXT NOT NULL, participant_json TEXT NOT NULL, generation_json TEXT NOT NULL,
-  msg_index INTEGER NOT NULL, kind TEXT NOT NULL CHECK (kind IN ('wake','presentation')),
-  attempt_n INTEGER NOT NULL CHECK (attempt_n >= 0), outcome TEXT NOT NULL,
-  at REAL NOT NULL, expires_at REAL, claim_token_json TEXT,
-  payload_json TEXT NOT NULL CHECK (json_valid(payload_json)),
-  PRIMARY KEY (participant_key_json,generation_json,msg_index,kind,attempt_n)
-) WITHOUT ROWID;
-CREATE UNIQUE INDEX delivery_claim_token ON delivery_evidence(claim_token_json) WHERE claim_token_json IS NOT NULL;
-CREATE TABLE delivery_cancellations (
-  participant_key_json TEXT NOT NULL, generation_json TEXT NOT NULL, through_index INTEGER NOT NULL,
-  PRIMARY KEY (participant_key_json,generation_json)
-) WITHOUT ROWID;
-CREATE TABLE delivery_deferrals (
-  participant_key_json TEXT NOT NULL, participant_json TEXT NOT NULL, generation_json TEXT NOT NULL,
-  deferral_id_json TEXT NOT NULL, match_json TEXT NOT NULL CHECK (json_valid(match_json)), expires_at REAL NOT NULL,
-  PRIMARY KEY (participant_key_json,generation_json,deferral_id_json)
-) WITHOUT ROWID;
-CREATE INDEX delivery_deferral_expiry ON delivery_deferrals(participant_key_json,generation_json,expires_at);
-CREATE TABLE receive_claims (
-  namespace_key_json TEXT NOT NULL, owner_key_json TEXT NOT NULL, generation_json TEXT NOT NULL,
-  claim_id_json TEXT NOT NULL, heartbeat_at REAL NOT NULL, expires_at REAL NOT NULL CHECK (expires_at >= heartbeat_at),
-  selector_json TEXT NOT NULL CHECK (json_valid(selector_json)), suppressed_json TEXT NOT NULL CHECK (json_valid(suppressed_json)),
-  PRIMARY KEY (namespace_key_json,owner_key_json)
-) WITHOUT ROWID;`;
-export function initializeChannelSqlite(db, description = '# Channel\n') {
-    db.exec(CHANNEL_SCHEMA_SQL);
-    db.prepare('INSERT INTO channel_meta(id,next_msg_index,description) VALUES(1,0,?)').run(description);
-}
-export function resetChannelSqlite(db) {
-    for (const table of ['receive_claims', 'delivery_deferrals', 'delivery_cancellations', 'delivery_evidence', 'endpoints', 'receipts', 'message_addresses', 'messages', 'channel_meta'])
-        db.exec(`DROP TABLE ${table}`);
-}
-export const channelLowerSchema = { schemaSql: CHANNEL_SCHEMA_SQL, initialize: initializeChannelSqlite, reset: resetChannelSqlite };
-export const channelStoreFormat = {
-    applicationId: 0x43484e4c, userVersion: 1, observerKey: 'channel',
-    validate(db, location) {
-        const identity = db.prepare('SELECT application_id, user_version FROM pragma_application_id, pragma_user_version').get();
-        requireFact(identity.application_id === this.applicationId, 'unrelated SQLite database.');
-        requireFact(identity.user_version === this.userVersion, 'unsupported Channel SQLite format version.');
-        validateSchema(db, `${STORAGE_META_SQL}\n${CHANNEL_SCHEMA_SQL}`, location);
-    },
-    reset(db) { resetChannelSqlite(db); resetStorageMeta(db); },
-};
-export function initializeStandaloneChannel(db, revision = 0, description = '# Channel\n') {
-    initializeStorageMeta(db, revision);
-    initializeChannelSqlite(db, description);
-}

package/dist/channel-transport.d.ts

@@ -1,62 +0,0 @@
-import type { WakeRoute } from './channel-values.js';
-import type { MessageId } from './message.js';
-/** One wake executor; final send must use the supplied custody gate. */
-export interface WakeTransportPort {
-    probe?(route: WakeRoute): Promise<boolean | {
-        readonly outcome: 'not-capable';
-        readonly diagnostic?: string;
-    }>;
-    attempt(request: WakeRequest, timeoutMs: number, beforeSend: () => Promise<boolean>): Promise<WakeOutcome>;
-}
-export interface WakePresentation {
-    readonly payload: string;
-    readonly coverage: 'full' | 'clipped';
-    readonly description?: string;
-}
-export interface WakeProjectionContext {
-    readonly location: string;
-    readonly participant: string;
-    readonly message: MessageId;
-    readonly actor: string;
-    readonly seat: {
-        readonly participant: string;
-        readonly owner: string;
-        readonly generation: string;
-    };
-    readonly route: WakeRoute;
-}
-export type WakeProjection = (context: WakeProjectionContext) => Promise<WakePresentation | undefined>;
-export interface WakeRequest extends WakeProjectionContext {
-    readonly claimToken?: string;
-    readonly attemptN?: number;
-    readonly channel: {
-        prepare(input: {
-            readonly correlation: {
-                readonly harness: 'claude' | 'opencode' | 'pi';
-                readonly token?: string;
-                readonly messageId?: string;
-                readonly payloadHash?: string;
-            };
-            readonly coverage: 'full' | 'clipped';
-            readonly description?: string;
-        }, signal?: AbortSignal): Promise<boolean>;
-    };
-    readonly presentation?: WakePresentation;
-}
-export type WakeOutcome = {
-    readonly outcome: 'accepted';
-    readonly signature?: string;
-} | {
-    readonly outcome: 'failed';
-    readonly message?: string;
-    readonly signature?: string;
-    readonly diagnostic?: unknown;
-} | {
-    readonly outcome: 'not-capable';
-    readonly diagnostic?: string;
-} | {
-    readonly outcome: 'unknown';
-    readonly signature?: string;
-    readonly message?: string;
-    readonly diagnostic?: unknown;
-};

package/dist/channel-transport.js

@@ -1 +0,0 @@
-export {};

package/dist/channel.d.ts

@@ -1,84 +0,0 @@
-import type { WakeAddress } from './channel-values.js';
-import type { Owner, OperationControl } from './neutral.js';
-import type { HarnessSessionChannel } from './participant-identity.js';
-import type { WakeTransportPort } from './channel-transport.js';
-import type { MetadataMatch, DeliveryDeferral } from './channel-metadata.js';
-import type { MessageId } from './message.js';
-import type { AckResult, ChannelEndpointHold, ChannelEndpointSummary, ChannelHistoryQuery, ChannelHistoryResult, ChannelPendingOptions, ChannelPendingResult, ChannelReceiveResult, ChannelSendInput, ChannelSendResult } from './channel-facade.js';
-export { harnessOwner, decodeHarnessOwner, localUserOwner } from './owner.js';
-export type { MessageMetadata, WakeAddress } from './channel-values.js';
-export type { MessageId } from './message.js';
-export type { MessageCursor, MessageQuery, MessageSearch, ChannelTruncate, ChannelSendInput, ChannelSendResult, ChannelMessage, ChannelPendingOptions, ChannelPendingResult, ChannelReceiveResult, ChannelHistoryQuery, ChannelHistoryResult, AckResult, ChannelEndpointSummary, ChannelEndpointHold } from './channel-facade.js';
-export type { MetadataMatch, DeliveryDeferral } from './channel-metadata.js';
-export type { Owner, OperationControl } from './neutral.js';
-export type { WakeTransportPort } from './channel-transport.js';
-export type { HarnessSessionChannel } from './participant-identity.js';
-export interface ResolvedHarnessSession {
-    readonly channel: HarnessSessionChannel;
-    readonly sessionId: string;
-    readonly agentId?: string;
-    readonly owner: Owner;
-    readonly wakeAddress?: WakeAddress;
-}
-export declare function resolveHarnessSession(env?: NodeJS.ProcessEnv): ResolvedHarnessSession | undefined;
-export interface ChannelOpenInput {
-    readonly path: string;
-    readonly cwd?: string;
-    readonly env?: NodeJS.ProcessEnv;
-    readonly clock?: () => number;
-    readonly wakeTransport?: WakeTransportPort | false;
-}
-export interface ChannelCreateInput extends ChannelOpenInput {
-    readonly force?: boolean;
-    readonly description?: string;
-}
-type EndpointOptions = {
-    readonly owner: Owner;
-    readonly wakeAddress?: WakeAddress;
-};
-type EndpointIdentity = {
-    readonly owner: Owner;
-    readonly generation: string;
-};
-/** A trusted handle to one independent message channel. */
-export declare class Channel {
-    #private;
-    private constructor();
-    static open(input: ChannelOpenInput, control?: OperationControl): Promise<Channel>;
-    static create(input: ChannelCreateInput, control?: OperationControl): Promise<Channel>;
-    static inMemory(input?: Omit<ChannelCreateInput, 'path' | 'force'>): Channel;
-    get location(): string;
-    attach(name: string, options: EndpointOptions & {
-        readonly takeover?: boolean;
-    }, control?: OperationControl): Promise<ChannelEndpoint>;
-    reattach(name: string, options: EndpointOptions, control?: OperationControl): Promise<ChannelEndpoint | null>;
-    endpoint(name: string, options: {
-        readonly owner: Owner;
-    }): Promise<ChannelEndpoint>;
-    endpointsOf(owner: Owner): Promise<readonly ChannelEndpointHold[]>;
-    listEndpoints(control?: OperationControl): Promise<readonly ChannelEndpointSummary[]>;
-    detach(name: string, identity: EndpointIdentity): Promise<true | null>;
-    cancelDeliveries(name: string, identity: EndpointIdentity, control?: OperationControl): Promise<boolean>;
-    remove(name: string, identity: EndpointIdentity): Promise<boolean>;
-    send(input: ChannelSendInput, control?: OperationControl): Promise<ChannelSendResult>;
-    history(query?: ChannelHistoryQuery, control?: OperationControl): Promise<ChannelHistoryResult>;
-    close(): Promise<void>;
-}
-/** Fenced to one attached endpoint generation. */
-export declare class ChannelEndpoint {
-    #private;
-    private constructor();
-    get name(): string;
-    get generation(): string;
-    pending(options?: ChannelPendingOptions, control?: OperationControl): Promise<ChannelPendingResult>;
-    ack(ids: readonly MessageId[], control?: OperationControl): Promise<AckResult>;
-    receive(options?: ChannelPendingOptions, control?: OperationControl): Promise<ChannelReceiveResult>;
-    deferDelivery(input: Readonly<{
-        match: MetadataMatch;
-        durationMs: number;
-    }>, control?: OperationControl): Promise<DeliveryDeferral>;
-    renewDeliveryDeferral(id: string, durationMs: number, control?: OperationControl): Promise<DeliveryDeferral | null>;
-    releaseDeliveryDeferral(id: string, control?: OperationControl): Promise<boolean>;
-    send(input: Omit<ChannelSendInput, 'from'>, control?: OperationControl): Promise<ChannelSendResult>;
-    leave(control?: OperationControl): Promise<void>;
-}

package/dist/channel.js

@@ -1,60 +0,0 @@
-import { Channel as ChannelCore, resolveHarnessSession as resolveSession } from './channel-internal.js';
-export { harnessOwner, decodeHarnessOwner, localUserOwner } from './owner.js';
-export function resolveHarnessSession(env = process.env) {
-    return resolveSession(env);
-}
-const endpointKey = Symbol('ChannelEndpoint');
-let wrapEndpoint;
-/** A trusted handle to one independent message channel. */
-export class Channel {
-    #core;
-    constructor(core) { this.#core = core; }
-    static async open(input, control) {
-        return new Channel(await ChannelCore.open(input, control));
-    }
-    static async create(input, control) {
-        return new Channel(await ChannelCore.create(input, control));
-    }
-    static inMemory(input = {}) {
-        return new Channel(ChannelCore.inMemory(input));
-    }
-    get location() { return this.#core.location; }
-    async attach(name, options, control) {
-        return wrapEndpoint(await this.#core.attach(name, options, control));
-    }
-    async reattach(name, options, control) {
-        const endpoint = await this.#core.reattach(name, options, control);
-        return endpoint === null ? null : wrapEndpoint(endpoint);
-    }
-    async endpoint(name, options) {
-        return wrapEndpoint(await this.#core.endpoint(name, options));
-    }
-    endpointsOf(owner) { return this.#core.endpointsOf(owner); }
-    listEndpoints(control) { return this.#core.listEndpoints(control); }
-    detach(name, identity) { return this.#core.detach(name, identity); }
-    cancelDeliveries(name, identity, control) { return this.#core.cancelDeliveries(name, identity, control); }
-    remove(name, identity) { return this.#core.remove(name, identity); }
-    send(input, control) { return this.#core.send(input, control); }
-    history(query, control) { return this.#core.history(query, control); }
-    close() { return this.#core.close(); }
-}
-/** Fenced to one attached endpoint generation. */
-export class ChannelEndpoint {
-    #core;
-    constructor(core, key) {
-        if (key !== endpointKey)
-            throw new TypeError('Channel endpoints are obtained from a Channel.');
-        this.#core = core;
-    }
-    static { wrapEndpoint = core => new ChannelEndpoint(core, endpointKey); }
-    get name() { return this.#core.name; }
-    get generation() { return this.#core.generation; }
-    pending(options, control) { return this.#core.pending(options, control); }
-    ack(ids, control) { return this.#core.ack(ids, control); }
-    receive(options, control) { return this.#core.receive(options, control); }
-    deferDelivery(input, control) { return this.#core.deferDelivery(input, control); }
-    renewDeliveryDeferral(id, durationMs, control) { return this.#core.renewDeliveryDeferral(id, durationMs, control); }
-    releaseDeliveryDeferral(id, control) { return this.#core.releaseDeliveryDeferral(id, control); }
-    send(input, control) { return this.#core.send(input, control); }
-    leave(control) { return this.#core.leave(control); }
-}

package/dist/claude-delivery-status.d.ts

@@ -1,13 +0,0 @@
-export interface ClaudeDeliveryObservation {
-    readonly eventId: string;
-    readonly messageId: string;
-    readonly state: 'held' | 'released' | 'dropped';
-    readonly reason?: string;
-    readonly observedAt: number;
-}
-export interface ClaudeDeliveryStatus extends ClaudeDeliveryObservation {
-    readonly provider: 'claude';
-    readonly sessionId: string;
-}
-/** This receiver-owned observation is not a model tool and grants no delivery authority. */
-export declare function recordClaudeDeliveryStatus(input: ClaudeDeliveryStatus, env?: NodeJS.ProcessEnv): Promise<boolean>;

package/dist/claude-delivery-status.js

@@ -1,46 +0,0 @@
-import { createArtifactPort } from './artifact.js';
-import { decodeHarnessOwner } from './owner.js';
-import { indexedSquareEntries } from './square-index.js';
-const holdReasons = new Set(['explicit-setting', 'managed-setting', 'repo-setting', 'invalid-setting', 'bypass-default', 'mode-unknown', 'mode-mismatch', 'no-mode-asserted']);
-const dropReasons = new Set(['expired', 'refused', 'dropped', 'discarded']);
-const uuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-/** This receiver-owned observation is not a model tool and grants no delivery authority. */
-export async function recordClaudeDeliveryStatus(input, env = process.env) {
-    if (!input || input.provider !== 'claude' || typeof input.sessionId !== 'string' || !input.sessionId
-        || typeof input.messageId !== 'string' || !uuid.test(input.messageId)
-        || typeof input.eventId !== 'string' || !uuid.test(input.eventId)
-        || !Number.isFinite(input.observedAt) || input.observedAt < 0
-        || !['held', 'released', 'dropped'].includes(input.state)
-        || (input.state === 'held' ? !holdReasons.has(input.reason ?? '')
-            : input.state === 'dropped' ? !dropReasons.has(input.reason ?? '') : input.reason !== undefined))
-        return false;
-    const paths = new Set((await indexedSquareEntries({}, env)).filter(entry => {
-        const coordinate = decodeHarnessOwner(entry.owner);
-        return coordinate?.channel === 'claude-code' && coordinate.session === input.sessionId;
-    }).map(entry => entry.location));
-    for (const location of paths) {
-        const artifact = createArtifactPort(location);
-        try {
-            const { value: match } = await artifact.read((facts) => facts.roster().flatMap((participant) => {
-                const seat = facts.seat(participant.name);
-                if (seat === undefined || seat.attachment !== 'attached' || seat.wakeAddress?.kind !== 'claude-native'
-                    || seat.wakeAddress.address.sessionId !== input.sessionId)
-                    return [];
-                const evidence = facts.deliveryEvidence(seat.participant, seat.generation).find((row) => row.correlation?.harness === 'claude' && row.correlation.messageId === input.messageId && row.claimToken !== undefined);
-                return evidence === undefined ? [] : [{ seat, evidence }];
-            }));
-            if (match.length === 0)
-                continue;
-            const { seat, evidence } = match[0];
-            const ref = { participant: seat.participant, owner: seat.owner, generation: seat.generation };
-            return (await artifact.transactAs({ kind: 'participant', seat: ref }, (facts) => facts.channel.observeNativeDelivery({ seat: ref, claimToken: evidence.claimToken, observation: {
-                    eventId: input.eventId, messageId: input.messageId, state: input.state,
-                    ...(input.reason === undefined ? {} : { reason: input.reason }), observedAt: input.observedAt,
-                } }))).value;
-        }
-        finally {
-            await artifact.close();
-        }
-    }
-    return false;
-}

package/dist/cmd/notify-once.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};