@astrosheep/square 0.3.70 → 0.3.71

package/dist/square-projections.d.ts

@@ -1,7 +1,5 @@
-import { type InboxMembership, type SquareState } from './model.js';
-import type { HostLedgerPort, SquareArtifactPort, PresentationEvidenceProjection, PresentationProjection, SessionBindingProjection } from './ports.js';
-import { deriveDeliveryModel } from './delivery.js';
-import { type WakeEligibility } from './wake-eligibility.js';
+import { type InboxMembership } from './model.js';
+import type { HostLedgerPort, PresentationEvidenceProjection, SessionBindingProjection } from './ports.js';
 /** A fresh blocking catch owns only the notifications admitted by its filter. */
 export declare function pendingAtBoundary(inbox: InboxMembership[]): InboxMembership[];
 /**
@@ -21,36 +19,6 @@ export declare function projectSessionBindings(input: {
     readonly location?: string;
     readonly now?: number;
 }): Promise<readonly SessionBindingProjection[]>;
-export declare function projectPresentation(input: {
-    readonly artifact: SquareArtifactPort;
-    readonly binding: SessionBindingProjection;
-    readonly now?: number;
-}): Promise<PresentationProjection>;
-export interface NativePendingPreview {
-    readonly payload: string;
-    readonly clipped: boolean;
-}
-/** The one native pending preview. `epoch` matches exactly, and each harness pins its own address entry. */
-export type NativePendingPreviewInput = {
-    readonly location: string;
-    readonly sessionId: string;
-    readonly participant: string;
-    readonly actIndex: number;
-    readonly epoch?: number;
-    readonly cancelledThrough?: number;
-    readonly now: number;
-} & ({
-    readonly routeKind: 'claude-native';
-    readonly address: {
-        readonly endpoint: string;
-    };
-} | {
-    readonly routeKind: 'opencode-server';
-    readonly address: {
-        readonly sessionId: string;
-    };
-});
-export declare function nativePendingPreview(state: SquareState, input: NativePendingPreviewInput): NativePendingPreview | undefined;
 export declare function projectPresentationEvidence(input: {
     readonly hostLedger: HostLedgerPort;
     readonly location?: string;
@@ -61,11 +29,3 @@ export declare function projectPresentationEvidence(input: {
 }): Promise<readonly PresentationEvidenceProjection[]>;
 /** Successful boundary output, including a clipped preview, suppresses awareness wake. */
 export declare function presentationSuppressesWake(evidence: readonly Pick<PresentationEvidenceProjection, 'outcome'>[]): boolean;
-/** Read primary evidence once; wake behavior belongs to the pure eligibility projection. */
-export declare function projectWakeEvidenceFromState(input: {
-    readonly location: string;
-    readonly state: SquareState;
-    readonly hostLedger: HostLedgerPort;
-    readonly now: number;
-    readonly delivery?: ReturnType<typeof deriveDeliveryModel>;
-}): Promise<WakeEligibility>;

package/dist/square-projections.js

@@ -1,10 +1,7 @@
 import { formatActivityId } from './square-core.js';
 import { nameKey } from './model.js';
-import { deriveDeliveryModel, leaseOwnsNotification } from './delivery.js';
-import { freshWatchLease } from './runtime.js';
-import { attentionBodyIsClipped, renderAttentionPreview } from './attention-presentation.js';
+import { leaseOwnsNotification } from './delivery.js';
 import { canonicalPath } from './canonical-path.js';
-import { projectWakeEligibility } from './wake-eligibility.js';
 /** A fresh blocking catch owns only the notifications admitted by its filter. */
 export function pendingAtBoundary(inbox) {
     return inbox.map((membership) => {
@@ -57,29 +54,6 @@ export async function projectSessionBindings(input) {
         updatedAt: record.updatedAt ?? 0,
     }));
 }
-export async function projectPresentation(input) {
-    const { state } = await input.artifact.read();
-    const delivery = deriveDeliveryModel(state);
-    const known = delivery.knownParticipant(input.binding.participant);
-    if (known === undefined || !delivery.joinedRecipients().some((recipient) => recipient.toLocaleLowerCase() === known.toLocaleLowerCase()))
-        return { binding: input.binding, joined: false, notifications: [] };
-    const binding = input.binding.participant === known ? input.binding : { ...input.binding, participant: known };
-    const notifications = delivery.pendingFor(known).map(({ item, route }) => ({ actIndex: item.index, actor: item.actor, at: item.at, route, body: item.body }));
-    const lease = freshWatchLease(state, known, input.now ?? Date.now());
-    return { binding, joined: true, notifications, ...(lease === undefined ? {} : { catchLease: lease }) };
-}
-export function nativePendingPreview(state, input) {
-    const route = state.routes?.find((candidate) => candidate.kind === input.routeKind && candidate.sessionId === input.sessionId
-        && candidate.epoch === input.epoch && nameKey(candidate.participant) === nameKey(input.participant)
-        && (input.routeKind === 'claude-native' ? candidate.address.endpoint === input.address.endpoint : candidate.address.sessionId === input.address.sessionId));
-    if (!route || input.actIndex <= (input.cancelledThrough ?? -1))
-        return undefined;
-    const notification = deriveDeliveryModel(state).pendingFor(input.participant).find((entry) => entry.item.index === input.actIndex);
-    const lease = freshWatchLease(state, input.participant, input.now);
-    if (!notification || (lease !== undefined && leaseOwnsNotification(lease, { ...notification.item, recipient: input.participant, route: notification.route })))
-        return undefined;
-    return { payload: renderAttentionPreview({ squarePath: input.location, recipient: input.participant, actIndex: input.actIndex, actor: notification.item.actor, route: notification.route, body: notification.item.body }), clipped: attentionBodyIsClipped(notification.item.body) };
-}
 export async function projectPresentationEvidence(input) {
     const rows = await input.hostLedger.listEvidence({ kind: 'presentation', location: input.location, participant: input.participant, session: input.sessionId, activity: input.activity, now: input.now });
     return rows.map((row) => ({ location: row.location, participant: row.participant, sessionId: row.session, activity: row.activity, outcome: row.outcome, ...(row.at === undefined ? {} : { at: row.at }) }));
@@ -88,13 +62,3 @@ export async function projectPresentationEvidence(input) {
 export function presentationSuppressesWake(evidence) {
     return evidence.some((row) => row.outcome === 'clipped' || row.outcome === 'presented');
 }
-/** Read primary evidence once; wake behavior belongs to the pure eligibility projection. */
-export async function projectWakeEvidenceFromState(input) {
-    const canonicalLocation = await canonicalPath(input.location);
-    const delivery = input.delivery ?? deriveDeliveryModel(input.state);
-    const owners = await input.hostLedger.listPresence({ location: canonicalLocation, now: input.now });
-    const evidence = await input.hostLedger.listEvidence({ location: canonicalLocation, now: input.now });
-    const wakeRecords = evidence.filter((row) => row.kind === 'wake');
-    const presentations = evidence.filter((row) => row.kind === 'presentation').map((row) => ({ location: row.location, participant: row.participant, sessionId: row.session, activity: row.activity, outcome: row.outcome, ...(row.at === undefined ? {} : { at: row.at }) }));
-    return projectWakeEligibility({ state: input.state, location: canonicalLocation, owners, wakeRecords, presentations, now: input.now, delivery });
-}

package/dist/square-sqlite.d.ts

@@ -0,0 +1,59 @@
+import { type DatabaseSync } from 'node:sqlite';
+import { SquareError, type ActivityObservation, type HardCap, type StoredAct, type WakeRoute, type WatchLease } from './model.js';
+import type { SquareRead, RouteFact } from './ports.js';
+import { type LandingWriter } from './square-domain.js';
+/** Explicit import/export DTOs, not a runtime transaction model. */
+export interface SquareRuntimeState {
+    nextActIndex: number;
+    observations: Record<string, Record<string, ActivityObservation>>;
+    leases: Record<string, WatchLease>;
+}
+export interface SquareState {
+    hardCap: HardCap;
+    throttlePerMinute?: number;
+    preamble: string[];
+    warmup: string[];
+    acts: StoredAct[];
+    routes?: WakeRoute[];
+    runtime: SquareRuntimeState;
+}
+export declare function emptyRuntimeState(nextActIndex?: number): SquareRuntimeState;
+export declare const APPLICATION_ID = 1397838405;
+export declare const V1_SNAPSHOT_TABLE = "square_snapshot";
+export interface LegacyFraming {
+    readonly applicationId: number;
+    readonly userVersion: number;
+    readonly journalMode: string;
+}
+/**
+ * The one recovery command for an owned legacy artifact, with a shell-quoted
+ * path. Kept beside framing recognition so the refusal and migration
+ * instruction cannot drift apart. This codec stays free of the renderer.
+ */
+export declare function migrationRecoveryCommand(location: string): string;
+/**
+ * Read-only legacy framing: application id, format version, journal mode and the
+ * exact owned snapshot schema. It decodes no snapshot payload, writes no pragma
+ * and runs no DDL, so ordinary open can establish ownership before offering
+ * the migration command. Anything else is unrelated or unsupported, not repaired.
+ */
+export declare function validateLegacyFraming(database: DatabaseSync, applicationId: number, location?: string): LegacyFraming;
+export declare const SCHEMA_SQL = "CREATE TABLE square_meta (\n  id INTEGER PRIMARY KEY CHECK (id = 1),\n  revision INTEGER NOT NULL CHECK (revision BETWEEN 0 AND 9007199254740991),\n  next_act_index INTEGER NOT NULL CHECK (next_act_index BETWEEN 0 AND 9007199254740991),\n  hard_cap INTEGER CHECK (hard_cap BETWEEN 1 AND 9007199254740991),\n  throttle_per_minute INTEGER CHECK (throttle_per_minute BETWEEN 1 AND 9007199254740991),\n  preamble_json TEXT NOT NULL CHECK (json_valid(preamble_json)),\n  warmup_json TEXT NOT NULL CHECK (json_valid(warmup_json))\n);\nCREATE TABLE activities (\n  act_index INTEGER PRIMARY KEY CHECK (act_index BETWEEN 0 AND 9007199254740991),\n  at REAL NOT NULL,\n  kind TEXT NOT NULL CHECK (kind IN ('join','done','say','hold','resume','read','listen','ignore')),\n  actor_json TEXT COLLATE BINARY,\n  actor_key_json TEXT COLLATE BINARY,\n  reach TEXT CHECK (reach = 'bell'),\n  reply_index INTEGER CHECK (reply_index >= 0 AND reply_index < act_index),\n  payload_json TEXT NOT NULL CHECK (json_valid(payload_json)),\n  CHECK ((actor_json IS NULL) = (actor_key_json IS NULL)),\n  CHECK (kind IN ('hold','resume') OR actor_json IS NOT NULL),\n  CHECK (kind = 'say' OR (reach IS NULL AND reply_index IS NULL))\n);\nCREATE INDEX activity_kind_index ON activities(kind, act_index);\nCREATE INDEX activity_actor_index ON activities(actor_key_json, act_index);\nCREATE INDEX activity_say_actor_index ON activities(actor_key_json, act_index) WHERE kind='say';\nCREATE INDEX activity_say_time ON activities(at, act_index) WHERE kind='say';\nCREATE INDEX activity_bell_actor_time ON activities(actor_key_json, at, act_index) WHERE kind='say' AND reach='bell';\n\nCREATE TABLE receipts (\n  owner_json TEXT COLLATE BINARY NOT NULL,\n  act_index INTEGER NOT NULL CHECK (act_index BETWEEN 0 AND 9007199254740991),\n  at REAL NOT NULL,\n  PRIMARY KEY (owner_json, act_index)\n) WITHOUT ROWID;\nCREATE INDEX receipt_owner_time ON receipts(owner_json, at);\nCREATE TABLE catch_leases (\n  owner_json TEXT COLLATE BINARY PRIMARY KEY NOT NULL,\n  lease_id_json TEXT NOT NULL,\n  heartbeat_at REAL NOT NULL,\n  expires_at REAL NOT NULL CHECK (expires_at >= heartbeat_at),\n  filter_json TEXT CHECK (filter_json IS NULL OR json_valid(filter_json))\n) WITHOUT ROWID;\n\nCREATE TABLE routes (\n  position INTEGER PRIMARY KEY CHECK (position >= 0),\n  participant_key_json TEXT COLLATE BINARY NOT NULL,\n  session_json TEXT COLLATE BINARY NOT NULL,\n  kind TEXT NOT NULL CHECK (kind IN ('opencode-server','codex-queue','claude-native','paseo')),\n  updated_at REAL NOT NULL,\n  payload_json TEXT NOT NULL CHECK (json_valid(payload_json))\n);\nCREATE INDEX route_participant ON routes(participant_key_json, position);\nCREATE INDEX route_session ON routes(session_json, position);\n\nCREATE TABLE participants (\n  name_key_json TEXT COLLATE BINARY PRIMARY KEY NOT NULL,\n  name_json TEXT NOT NULL,\n  first_index INTEGER NOT NULL UNIQUE,\n  joined INTEGER NOT NULL CHECK (joined IN (0,1)),\n  done INTEGER NOT NULL CHECK (done IN (0,1)),\n  say_count INTEGER NOT NULL CHECK (say_count >= 0),\n  last_active_at REAL,\n  last_join_index INTEGER,\n  CHECK (NOT (joined=1 AND done=1))\n) WITHOUT ROWID;\nCREATE TABLE attention (\n  listener_key_json TEXT COLLATE BINARY NOT NULL,\n  target_key_json TEXT COLLATE BINARY NOT NULL,\n  target_json TEXT NOT NULL,\n  kind TEXT NOT NULL CHECK (kind IN ('listen','ignore')),\n  since_index INTEGER NOT NULL,\n  PRIMARY KEY (listener_key_json, target_key_json)\n) WITHOUT ROWID;\nCREATE INDEX attention_target ON attention(target_key_json, kind, listener_key_json);\nCREATE TABLE landed_audience (\n  act_index INTEGER NOT NULL,\n  recipient_key_json TEXT COLLATE BINARY NOT NULL,\n  recipient_order INTEGER NOT NULL CHECK (recipient_order >= 0),\n  route TEXT NOT NULL CHECK (route IN ('mention','reply','attention','bell')),\n  PRIMARY KEY (act_index, recipient_key_json),\n  UNIQUE (act_index, recipient_order)\n) WITHOUT ROWID;\nCREATE INDEX audience_recipient ON landed_audience(recipient_key_json, act_index);";
+export declare function invalidArtifact(detail: string): SquareError;
+export declare function validateStoredActivity(value: unknown): StoredAct;
+export declare function validateWatchLease(value: unknown): WatchLease;
+export declare function validateRoute(value: unknown): RouteFact;
+export declare function validateSqliteHeader(db: DatabaseSync, location?: string): void;
+export interface SqliteDriver extends SquareRead, LandingWriter {
+    readonly changed: boolean;
+}
+export declare function createSqliteDriver(db: DatabaseSync): SqliteDriver;
+export declare function legacyRouteFact(value: Record<string, unknown>): RouteFact;
+/** Explicit import only. Caller owns transaction, legacy validation and format publication. */
+export declare function initializeSqlite(db: DatabaseSync, state: SquareState, revision?: number): void;
+/** Exceptional export projection for fixtures, never a runtime fallback. */
+export declare function exportSqliteState(db: DatabaseSync): SquareState;
+/** Full read-only integrity inspection, including maintained-index replay comparison. */
+export declare function inspectSqlite(db: DatabaseSync): {
+    standingCount: number;
+};