@components-kit/open-workbook-excel-core 0.1.0

package/dist/snapshot-manager.d.ts

@@ -0,0 +1,20 @@
+import { type A1Range, type DiffSummary, type SnapshotId, type SnapshotRef, type WorkbookId, type WorkbookSnapshotResponse } from "@components-kit/open-workbook-protocol";
+export interface WorkbookSnapshotRecord extends SnapshotRef {
+    payload: WorkbookSnapshotResponse;
+    invalidatedAt?: string;
+}
+export declare class SnapshotManager {
+    private readonly snapshots;
+    createSnapshot(input: {
+        workbookId: WorkbookId;
+        reason: string;
+        affectedRanges: A1Range[];
+        payload: WorkbookSnapshotResponse;
+    }): WorkbookSnapshotRecord;
+    getSnapshot(snapshotId: SnapshotId): WorkbookSnapshotRecord | undefined;
+    listSnapshots(workbookId: WorkbookId): WorkbookSnapshotRecord[];
+    invalidate(snapshotId: SnapshotId): WorkbookSnapshotRecord | undefined;
+    deleteSnapshot(snapshotId: SnapshotId): boolean;
+    compare(leftId: SnapshotId, rightId: SnapshotId): DiffSummary | undefined;
+}
+//# sourceMappingURL=snapshot-manager.d.ts.map

package/dist/snapshot-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-manager.d.ts","sourceRoot":"","sources":["../src/snapshot-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,wBAAwB,EAE9B,MAAM,wCAAwC,CAAC;AAEhD,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,OAAO,EAAE,wBAAwB,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiD;IAE3E,cAAc,CAAC,KAAK,EAAE;QACpB,UAAU,EAAE,UAAU,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,OAAO,EAAE,CAAC;QAC1B,OAAO,EAAE,wBAAwB,CAAC;KACnC,GAAG,sBAAsB;IAc1B,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,sBAAsB,GAAG,SAAS;IAIvE,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,sBAAsB,EAAE;IAM/D,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,sBAAsB,GAAG,SAAS;IAStE,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;IAI/C,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS;CAiC1E"}

package/dist/snapshot-manager.js

@@ -0,0 +1,64 @@
+import { makeId } from "@components-kit/open-workbook-protocol";
+export class SnapshotManager {
+    snapshots = new Map();
+    createSnapshot(input) {
+        const snapshotId = makeId("snapshot");
+        const snapshot = {
+            snapshotId,
+            workbookId: input.workbookId,
+            createdAt: new Date().toISOString(),
+            reason: input.reason,
+            affectedRanges: input.affectedRanges,
+            payload: input.payload
+        };
+        this.snapshots.set(snapshotId, snapshot);
+        return snapshot;
+    }
+    getSnapshot(snapshotId) {
+        return this.snapshots.get(snapshotId);
+    }
+    listSnapshots(workbookId) {
+        return [...this.snapshots.values()]
+            .filter((snapshot) => snapshot.workbookId === workbookId)
+            .sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+    invalidate(snapshotId) {
+        const snapshot = this.snapshots.get(snapshotId);
+        if (!snapshot) {
+            return undefined;
+        }
+        snapshot.invalidatedAt = new Date().toISOString();
+        return snapshot;
+    }
+    deleteSnapshot(snapshotId) {
+        return this.snapshots.delete(snapshotId);
+    }
+    compare(leftId, rightId) {
+        const left = this.snapshots.get(leftId);
+        const right = this.snapshots.get(rightId);
+        if (!left || !right) {
+            return undefined;
+        }
+        const changedRanges = [];
+        let cellsChanged = 0;
+        for (const rightRange of right.payload.rangeSnapshots) {
+            const leftRange = left.payload.rangeSnapshots.find((candidate) => candidate.fingerprint.range.sheetName === rightRange.fingerprint.range.sheetName &&
+                candidate.fingerprint.range.address === rightRange.fingerprint.range.address);
+            if (!leftRange || leftRange.fingerprint.hash !== rightRange.fingerprint.hash) {
+                changedRanges.push(rightRange.fingerprint.range);
+                cellsChanged += rightRange.fingerprint.cellCount;
+            }
+        }
+        return {
+            title: `Snapshot diff ${leftId} -> ${rightId}`,
+            changedRanges,
+            cellsChanged,
+            formulasChanged: 0,
+            stylesChanged: 0,
+            tablesChanged: 0,
+            sheetsChanged: left.payload.workbookFingerprint.structureHash === right.payload.workbookFingerprint.structureHash ? 0 : 1,
+            destructiveLevel: changedRanges.length > 0 ? "values" : "none"
+        };
+    }
+}
+//# sourceMappingURL=snapshot-manager.js.map

package/dist/snapshot-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-manager.js","sourceRoot":"","sources":["../src/snapshot-manager.ts"],"names":[],"mappings":"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"}

package/dist/task-registry.d.ts

@@ -0,0 +1,34 @@
+import type { AgentId, TaskBlocker, TaskId, WorkbookId, WorkbookScope } from "@components-kit/open-workbook-protocol";
+import { type TaskRecord, type TransactionId, type PlanId, type BackupId } from "@components-kit/open-workbook-protocol";
+export interface CreateTaskInput {
+    workbookId: WorkbookId;
+    goal: string;
+    role?: string | undefined;
+    priority?: TaskRecord["priority"] | undefined;
+    assignedAgentId?: AgentId | undefined;
+    allowedScopes?: WorkbookScope[] | undefined;
+    dependencies?: TaskId[] | undefined;
+}
+export declare class TaskRegistry {
+    private readonly tasks;
+    create(input: CreateTaskInput): TaskRecord;
+    claim(taskId: TaskId, agentId: AgentId): TaskRecord;
+    update(taskId: TaskId, patch: Partial<Pick<TaskRecord, "goal" | "role" | "priority" | "status" | "progress" | "currentStep" | "blockers" | "assignedAgentId" | "allowedScopes" | "dependencies" | "errorMessage">>): TaskRecord;
+    setProgress(taskId: TaskId, progress: number, currentStep?: string | undefined): TaskRecord;
+    addBlocker(taskId: TaskId, input: Pick<TaskBlocker, "message" | "severity"> & {
+        scope?: TaskBlocker["scope"] | undefined;
+    }): TaskRecord;
+    resolveBlocker(taskId: TaskId, blockerId: string): TaskRecord;
+    attachPlan(taskId: TaskId, planId: PlanId): TaskRecord | undefined;
+    attachTransaction(taskId: TaskId, transactionId: TransactionId): TaskRecord | undefined;
+    attachBackups(taskId: TaskId, backupIds: BackupId[]): TaskRecord | undefined;
+    complete(taskId: TaskId): TaskRecord;
+    fail(taskId: TaskId, errorMessage: string): TaskRecord;
+    cancel(taskId: TaskId): TaskRecord;
+    get(taskId: TaskId): TaskRecord | undefined;
+    list(workbookId?: WorkbookId): TaskRecord[];
+    load(records: TaskRecord[]): void;
+    dump(): TaskRecord[];
+    private require;
+}
+//# sourceMappingURL=task-registry.d.ts.map

package/dist/task-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-registry.d.ts","sourceRoot":"","sources":["../src/task-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACtH,OAAO,EAAU,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAEjI,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IAC9C,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,aAAa,CAAC,EAAE,aAAa,EAAE,GAAG,SAAS,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACrC;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IAEvD,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU;IA4B1C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU;IAInD,MAAM,CACJ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,CACZ,IAAI,CACF,UAAU,EACV,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,iBAAiB,GAAG,eAAe,GAAG,cAAc,GAAG,cAAc,CAC1J,CACF,GACA,UAAU;IAYb,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU;IAK3F,UAAU,CACR,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,UAAU,CAAC,GAAG;QACjD,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;KAC1C,GACA,UAAU;IAeb,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU;IAgB7D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAUlE,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,UAAU,GAAG,SAAS;IAUvF,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,UAAU,GAAG,SAAS;IAU5E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;IAIpC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,UAAU;IAItD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;IAIlC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI3C,IAAI,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE;IAM3C,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI;IAWjC,IAAI,IAAI,UAAU,EAAE;IAIpB,OAAO,CAAC,OAAO;CAOhB"}

package/dist/task-registry.js

@@ -0,0 +1,141 @@
+import { makeId } from "@components-kit/open-workbook-protocol";
+export class TaskRegistry {
+    tasks = new Map();
+    create(input) {
+        const now = new Date().toISOString();
+        const task = {
+            taskId: makeId("task"),
+            workbookId: input.workbookId,
+            goal: input.goal,
+            priority: input.priority ?? "normal",
+            status: input.assignedAgentId ? "claimed" : "open",
+            progress: 0,
+            blockers: [],
+            allowedScopes: input.allowedScopes ?? [],
+            dependencies: input.dependencies ?? [],
+            planIds: [],
+            transactionIds: [],
+            rollbackBackupIds: [],
+            createdAt: now,
+            updatedAt: now
+        };
+        if (input.role !== undefined) {
+            task.role = input.role;
+        }
+        if (input.assignedAgentId !== undefined) {
+            task.assignedAgentId = input.assignedAgentId;
+        }
+        this.tasks.set(task.taskId, task);
+        return task;
+    }
+    claim(taskId, agentId) {
+        return this.update(taskId, { assignedAgentId: agentId, status: "claimed" });
+    }
+    update(taskId, patch) {
+        const task = this.require(taskId);
+        Object.assign(task, patch, { updatedAt: new Date().toISOString() });
+        if (patch.status === "completed") {
+            task.completedAt = new Date().toISOString();
+        }
+        if (patch.status === "failed") {
+            task.failedAt = new Date().toISOString();
+        }
+        return task;
+    }
+    setProgress(taskId, progress, currentStep) {
+        const clamped = Math.max(0, Math.min(100, Math.round(progress)));
+        return this.update(taskId, currentStep === undefined ? { progress: clamped } : { progress: clamped, currentStep });
+    }
+    addBlocker(taskId, input) {
+        const task = this.require(taskId);
+        const blocker = {
+            blockerId: makeId("blocker"),
+            message: input.message,
+            severity: input.severity,
+            status: "open",
+            createdAt: new Date().toISOString()
+        };
+        if (input.scope !== undefined) {
+            blocker.scope = input.scope;
+        }
+        return this.update(taskId, { blockers: [...task.blockers, blocker], status: input.severity === "blocked" ? "blocked" : task.status });
+    }
+    resolveBlocker(taskId, blockerId) {
+        const task = this.require(taskId);
+        const now = new Date().toISOString();
+        return this.update(taskId, {
+            blockers: task.blockers.map((blocker) => blocker.blockerId === blockerId
+                ? {
+                    ...blocker,
+                    status: "resolved",
+                    resolvedAt: now
+                }
+                : blocker)
+        });
+    }
+    attachPlan(taskId, planId) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            return undefined;
+        }
+        task.planIds = [...new Set([...task.planIds, planId])];
+        task.updatedAt = new Date().toISOString();
+        return task;
+    }
+    attachTransaction(taskId, transactionId) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            return undefined;
+        }
+        task.transactionIds = [...new Set([...task.transactionIds, transactionId])];
+        task.updatedAt = new Date().toISOString();
+        return task;
+    }
+    attachBackups(taskId, backupIds) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            return undefined;
+        }
+        task.rollbackBackupIds = [...new Set([...task.rollbackBackupIds, ...backupIds])];
+        task.updatedAt = new Date().toISOString();
+        return task;
+    }
+    complete(taskId) {
+        return this.update(taskId, { status: "completed" });
+    }
+    fail(taskId, errorMessage) {
+        return this.update(taskId, { status: "failed", errorMessage });
+    }
+    cancel(taskId) {
+        return this.update(taskId, { status: "cancelled" });
+    }
+    get(taskId) {
+        return this.tasks.get(taskId);
+    }
+    list(workbookId) {
+        return [...this.tasks.values()]
+            .filter((task) => workbookId === undefined || task.workbookId === workbookId)
+            .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+    }
+    load(records) {
+        this.tasks.clear();
+        for (const record of records) {
+            this.tasks.set(record.taskId, {
+                ...record,
+                progress: record.progress ?? 0,
+                blockers: record.blockers ?? []
+            });
+        }
+    }
+    dump() {
+        return [...this.tasks.values()].map((task) => ({ ...task }));
+    }
+    require(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        return task;
+    }
+}
+//# sourceMappingURL=task-registry.js.map

package/dist/task-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-registry.js","sourceRoot":"","sources":["../src/task-registry.ts"],"names":[],"mappings":"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"}

package/dist/template-registry.d.ts

@@ -0,0 +1,46 @@
+import type { TemplateId, TemplateRef, WorkbookId } from "@components-kit/open-workbook-protocol";
+export interface TemplateFingerprint {
+    structureHash: string;
+    formulaHash: string;
+    styleHash: string;
+    filterHash: string;
+    tableHash: string;
+    printLayoutHash: string;
+}
+export interface TemplateFingerprintPayload {
+    structure: unknown;
+    formulas: unknown;
+    styles: unknown;
+    filters: unknown;
+    tables: unknown;
+    printLayout: unknown;
+}
+export interface TemplateRecord extends TemplateRef {
+    workbookId?: WorkbookId;
+    sourceSheetName: string;
+    fingerprint: TemplateFingerprint;
+    fingerprintPayload: TemplateFingerprintPayload;
+    dataRegions: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface RegisterTemplateInput {
+    name: string;
+    scope: "workbook" | "local";
+    sourceSheetName: string;
+    workbookId?: WorkbookId;
+    dataRegions?: string[];
+    fingerprintPayload: TemplateFingerprintPayload;
+}
+export declare class TemplateRegistry {
+    private readonly records;
+    register(input: RegisterTemplateInput): TemplateRecord;
+    get(templateId: TemplateId): TemplateRecord | undefined;
+    unregister(templateId: TemplateId): boolean;
+    list(options?: {
+        workbookId?: WorkbookId;
+    }): TemplateRecord[];
+    load(records: TemplateRecord[]): void;
+    dump(): TemplateRecord[];
+}
+//# sourceMappingURL=template-registry.d.ts.map

package/dist/template-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-registry.d.ts","sourceRoot":"","sources":["../src/template-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAIlG,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,mBAAmB,CAAC;IACjC,kBAAkB,EAAE,0BAA0B,CAAC;IAC/C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB,EAAE,0BAA0B,CAAC;CAChD;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IAEjE,QAAQ,CAAC,KAAK,EAAE,qBAAqB,GAAG,cAAc;IAiCtD,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS;IAIvD,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;IAI3C,IAAI,CAAC,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,UAAU,CAAA;KAAO,GAAG,cAAc,EAAE;IASjE,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI;IAOrC,IAAI,IAAI,cAAc,EAAE;CAGzB"}

package/dist/template-registry.js

@@ -0,0 +1,60 @@
+import { makeId } from "@components-kit/open-workbook-protocol";
+import { hashStable } from "./fingerprint.js";
+export class TemplateRegistry {
+    records = new Map();
+    register(input) {
+        if (input.scope === "workbook" && !input.workbookId) {
+            throw new Error("Workbook templates require workbookId");
+        }
+        const templateId = makeId("template");
+        const now = new Date().toISOString();
+        const record = {
+            templateId,
+            name: input.name,
+            scope: input.scope,
+            version: 1,
+            sourceSheetName: input.sourceSheetName,
+            dataRegions: input.dataRegions ?? [],
+            fingerprint: {
+                structureHash: hashStable(input.fingerprintPayload.structure),
+                formulaHash: hashStable(input.fingerprintPayload.formulas),
+                styleHash: hashStable(input.fingerprintPayload.styles),
+                filterHash: hashStable(input.fingerprintPayload.filters),
+                tableHash: hashStable(input.fingerprintPayload.tables),
+                printLayoutHash: hashStable(input.fingerprintPayload.printLayout)
+            },
+            fingerprintPayload: input.fingerprintPayload,
+            createdAt: now,
+            updatedAt: now
+        };
+        if (input.workbookId !== undefined) {
+            record.workbookId = input.workbookId;
+        }
+        this.records.set(templateId, record);
+        return record;
+    }
+    get(templateId) {
+        return this.records.get(templateId);
+    }
+    unregister(templateId) {
+        return this.records.delete(templateId);
+    }
+    list(options = {}) {
+        return [...this.records.values()].filter((record) => {
+            if (record.scope === "local") {
+                return true;
+            }
+            return !options.workbookId || record.workbookId === options.workbookId;
+        });
+    }
+    load(records) {
+        this.records.clear();
+        for (const record of records) {
+            this.records.set(record.templateId, { ...record });
+        }
+    }
+    dump() {
+        return [...this.records.values()].map((record) => ({ ...record }));
+    }
+}
+//# sourceMappingURL=template-registry.js.map

package/dist/template-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-registry.js","sourceRoot":"","sources":["../src/template-registry.ts"],"names":[],"mappings":"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"}

package/dist/transaction-manager.d.ts

@@ -0,0 +1,33 @@
+import { type AgentId, type BackupId, type DiffSummary, type LockId, type OperationTelemetry, type OperationWarning, type PlanId, type RangeFingerprint, type TaskId, type TransactionId, type TransactionRecord, type WorkbookId, type WorkbookScope, type DestructiveLevel } from "@components-kit/open-workbook-protocol";
+export interface CreateTransactionInput {
+    workbookId: WorkbookId;
+    agentId?: AgentId | undefined;
+    taskId?: TaskId | undefined;
+    planId?: PlanId | undefined;
+    goal: string;
+    scopes: WorkbookScope[];
+    baseFingerprints?: RangeFingerprint[];
+    destructiveLevel: DestructiveLevel;
+}
+export declare class TransactionManager {
+    private readonly transactions;
+    create(input: CreateTransactionInput): TransactionRecord;
+    markApplying(transactionId: TransactionId, locks: LockId[]): TransactionRecord;
+    markApplied(transactionId: TransactionId, result: {
+        backups: BackupId[];
+        warnings: OperationWarning[];
+        diffSummary?: DiffSummary | undefined;
+        telemetry?: OperationTelemetry | undefined;
+    }): TransactionRecord;
+    markFailed(transactionId: TransactionId, errorCode: string, errorMessage: string, warnings?: OperationWarning[]): TransactionRecord;
+    markBlocked(transactionId: TransactionId, errorCode: string, errorMessage: string, warnings?: OperationWarning[]): TransactionRecord;
+    markRolledBack(transactionId: TransactionId): TransactionRecord;
+    get(transactionId: TransactionId): TransactionRecord | undefined;
+    getLaterApplied(transaction: TransactionRecord): TransactionRecord[];
+    list(workbookId?: WorkbookId): TransactionRecord[];
+    load(records: TransactionRecord[]): void;
+    dump(): TransactionRecord[];
+    markInterrupted(message?: string): TransactionRecord[];
+    private update;
+}
+//# sourceMappingURL=transaction-manager.d.ts.map

package/dist/transaction-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-manager.d.ts","sourceRoot":"","sources":["../src/transaction-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,MAAM,EACX,KAAK,gBAAgB,EACrB,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,iBAAiB,EAEtB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,wCAAwC,CAAC;AAEhD,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACtC,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+C;IAE5E,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,iBAAiB;IA2BxD,YAAY,CAAC,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,iBAAiB;IAQ9E,WAAW,CACT,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE;QACN,OAAO,EAAE,QAAQ,EAAE,CAAC;QACpB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;QAC7B,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;QACtC,SAAS,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;KAC5C,GACA,iBAAiB;IAgBpB,UAAU,CAAC,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,GAAE,gBAAgB,EAAO,GAAG,iBAAiB;IAUvI,WAAW,CAAC,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,GAAE,gBAAgB,EAAO,GAAG,iBAAiB;IAUxI,cAAc,CAAC,aAAa,EAAE,aAAa,GAAG,iBAAiB;IAI/D,GAAG,CAAC,aAAa,EAAE,aAAa,GAAG,iBAAiB,GAAG,SAAS;IAIhE,eAAe,CAAC,WAAW,EAAE,iBAAiB,GAAG,iBAAiB,EAAE;IAOpE,IAAI,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,iBAAiB,EAAE;IAMlD,IAAI,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAOxC,IAAI,IAAI,iBAAiB,EAAE;IAI3B,eAAe,CAAC,OAAO,SAAsD,GAAG,iBAAiB,EAAE;IAcnG,OAAO,CAAC,MAAM;CAQf"}

package/dist/transaction-manager.js

@@ -0,0 +1,118 @@
+import { makeId } from "@components-kit/open-workbook-protocol";
+export class TransactionManager {
+    transactions = new Map();
+    create(input) {
+        const transaction = {
+            transactionId: makeId("txn"),
+            workbookId: input.workbookId,
+            status: "queued",
+            goal: input.goal,
+            scopes: input.scopes,
+            locks: [],
+            baseFingerprints: input.baseFingerprints ?? [],
+            backups: [],
+            warnings: [],
+            destructiveLevel: input.destructiveLevel,
+            queuedAt: new Date().toISOString()
+        };
+        if (input.agentId !== undefined) {
+            transaction.agentId = input.agentId;
+        }
+        if (input.taskId !== undefined) {
+            transaction.taskId = input.taskId;
+        }
+        if (input.planId !== undefined) {
+            transaction.planId = input.planId;
+        }
+        this.transactions.set(transaction.transactionId, transaction);
+        return transaction;
+    }
+    markApplying(transactionId, locks) {
+        return this.update(transactionId, {
+            status: "applying",
+            locks,
+            startedAt: new Date().toISOString()
+        });
+    }
+    markApplied(transactionId, result) {
+        const patch = {
+            status: "applied",
+            backups: result.backups,
+            warnings: result.warnings,
+            finishedAt: new Date().toISOString()
+        };
+        if (result.diffSummary !== undefined) {
+            patch.diffSummary = result.diffSummary;
+        }
+        if (result.telemetry !== undefined) {
+            patch.telemetry = result.telemetry;
+        }
+        return this.update(transactionId, patch);
+    }
+    markFailed(transactionId, errorCode, errorMessage, warnings = []) {
+        return this.update(transactionId, {
+            status: "failed",
+            errorCode,
+            errorMessage,
+            warnings,
+            finishedAt: new Date().toISOString()
+        });
+    }
+    markBlocked(transactionId, errorCode, errorMessage, warnings = []) {
+        return this.update(transactionId, {
+            status: "blocked",
+            errorCode,
+            errorMessage,
+            warnings,
+            finishedAt: new Date().toISOString()
+        });
+    }
+    markRolledBack(transactionId) {
+        return this.update(transactionId, { status: "rolled_back", finishedAt: new Date().toISOString() });
+    }
+    get(transactionId) {
+        return this.transactions.get(transactionId);
+    }
+    getLaterApplied(transaction) {
+        const ordered = [...this.transactions.values()];
+        const index = ordered.findIndex((candidate) => candidate.transactionId === transaction.transactionId);
+        const candidates = index >= 0 ? ordered.slice(index + 1) : ordered;
+        return candidates.filter((candidate) => candidate.workbookId === transaction.workbookId && candidate.status === "applied");
+    }
+    list(workbookId) {
+        return [...this.transactions.values()]
+            .filter((transaction) => workbookId === undefined || transaction.workbookId === workbookId)
+            .sort((a, b) => (b.finishedAt ?? b.startedAt ?? b.queuedAt).localeCompare(a.finishedAt ?? a.startedAt ?? a.queuedAt));
+    }
+    load(records) {
+        this.transactions.clear();
+        for (const record of records) {
+            this.transactions.set(record.transactionId, { ...record });
+        }
+    }
+    dump() {
+        return [...this.transactions.values()].map((transaction) => ({ ...transaction }));
+    }
+    markInterrupted(message = "Daemon restarted before the transaction finished.") {
+        const interrupted = [];
+        for (const transaction of this.transactions.values()) {
+            if (transaction.status === "queued" || transaction.status === "applying") {
+                transaction.status = "blocked";
+                transaction.errorCode = "DAEMON_RESTARTED";
+                transaction.errorMessage = message;
+                transaction.finishedAt = new Date().toISOString();
+                interrupted.push(transaction);
+            }
+        }
+        return interrupted;
+    }
+    update(transactionId, patch) {
+        const transaction = this.transactions.get(transactionId);
+        if (!transaction) {
+            throw new Error(`Transaction not found: ${transactionId}`);
+        }
+        Object.assign(transaction, patch);
+        return transaction;
+    }
+}
+//# sourceMappingURL=transaction-manager.js.map

package/dist/transaction-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-manager.js","sourceRoot":"","sources":["../src/transaction-manager.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@components-kit/open-workbook-excel-core",
+  "version": "0.1.0",
+  "description": "Core planning, backup, snapshot, template, permission, and range utilities for Open Workbook.",
+  "license": "MIT",
+  "type": "module",
+  "homepage": "https://github.com/components-kit/open-workbook#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/components-kit/open-workbook.git",
+    "directory": "packages/excel-core"
+  },
+  "bugs": {
+    "url": "https://github.com/components-kit/open-workbook/issues"
+  },
+  "keywords": [
+    "excel",
+    "spreadsheet",
+    "planning",
+    "backup",
+    "template"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@components-kit/open-workbook-protocol": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}