@astrosheep/square 0.3.44 → 0.3.46

package/claude-plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "square",
-  "version": "0.3.44",
+  "version": "0.3.46",
   "description": "Native Claude Code turn-boundary delivery for Square participants",
   "author": {
     "name": "Square"

package/codex-plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "square",
-  "version": "0.3.44",
+  "version": "0.3.46",
   "description": "Shared Square activity with reliable participant attention at Codex boundaries.",
   "author": {
     "name": "Square"

package/dist/artifact.d.ts

@@ -1,4 +1,5 @@
-import { type BuildOptions, type HardCap, type SquareState, type SquareRuntimeState } from './model.js';
+import { type SquareState } from './model.js';
+export { createSquareState, emptyRuntimeState } from './square-state.js';
 export interface DoctorProblem {
     kind: string;
     message: string;
@@ -8,12 +9,32 @@ export interface DiagnoseResult {
     problems: DoctorProblem[];
     state?: SquareState;
 }
-export declare function emptyRuntimeState(nextActIndex?: number): SquareRuntimeState;
-export declare function createSquareState(options: BuildOptions & {
-    hardCap: HardCap;
-}, snippet: string): SquareState;
-export declare function encodeSquare(squareState: SquareState): Buffer;
-export declare function decodeSquare(bytes: Buffer): SquareState;
+export interface SquareSnapshot {
+    readonly state: SquareState;
+    readonly revision: number;
+}
+/** Creates a new SQLite artifact only when its pathname did not already exist. */
+export declare function createSquareFile(squarePath: string, state: SquareState): Promise<boolean>;
+/**
+ * Reads a complete validated snapshot, yielding between transient SQLite lock
+ * conflicts. The URI remains create-disabled throughout the retry loop.
+ */
+export declare function readSquareSnapshot(squarePath: string, signal?: AbortSignal): Promise<SquareSnapshot>;
+export type SquareTransition<R> = (state: SquareState, revision: number) => {
+    state?: SquareState;
+    result: R;
+};
+/**
+ * Executes one synchronous SquareState transition under SQLite's write lock.
+ * A busy COMMIT retries on this same transaction, so fn is never replayed.
+ */
+export declare function transactSquareSnapshot<R>(squarePath: string, fn: SquareTransition<R>, signal?: AbortSignal, forceCommit?: boolean): Promise<{
+    result: R;
+    revision: number;
+    changed: boolean;
+}>;
+/** Replaces an existing validated snapshot in place and always advances its revision. */
+export declare function replaceSquareSnapshot(squarePath: string, state: SquareState): Promise<SquareSnapshot>;
 export declare function writeSquareFile(squarePath: string, squareState: SquareState): Promise<void>;
 export declare function loadSquare(squarePath: string): Promise<SquareState>;
 export declare function probeSquare(squarePath: string): Promise<SquareState | undefined>;