@agents-tower/core 0.1.0 → 0.1.2

package/dist/adapters/contract-harness.d.ts

@@ -0,0 +1,8 @@
+import type { ProjectAdapter } from "./types";
+export declare const PROVIDER_CONTRACT_VERSION = 1;
+export interface ContractCheckOptions {
+    projectRoot?: string;
+    refreshTimeoutMs?: number;
+}
+export declare function validateAdapterShape(adapter: ProjectAdapter): string[];
+export declare function runAdapterContractChecks(adapter: ProjectAdapter, options?: ContractCheckOptions): Promise<string[]>;

package/dist/adapters/contract-harness.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROVIDER_CONTRACT_VERSION = void 0;
+exports.validateAdapterShape = validateAdapterShape;
+exports.runAdapterContractChecks = runAdapterContractChecks;
+exports.PROVIDER_CONTRACT_VERSION = 1;
+const VALID_HEALTH_STATUSES = new Set(["ready", "unconfigured", "degraded", "error"]);
+const VALID_CONFIDENCES = new Set(["typed", "inferred"]);
+function checkSnapshotShape(snapshot, adapterId, failures) {
+    if (!snapshot || typeof snapshot !== "object") {
+        failures.push(`${adapterId}: getCachedSnapshot() must return an AdapterSnapshot object`);
+        return;
+    }
+    if (snapshot.adapterId !== adapterId) {
+        failures.push(`${adapterId}: snapshot.adapterId must equal the adapter id (got ${String(snapshot.adapterId)})`);
+    }
+    if (!Number.isFinite(Date.parse(snapshot.generatedAt))) {
+        failures.push(`${adapterId}: snapshot.generatedAt must be a parseable ISO timestamp`);
+    }
+    for (const field of ["agents", "events", "notes"]) {
+        if (!Array.isArray(snapshot[field])) {
+            failures.push(`${adapterId}: snapshot.${field} must be an array`);
+        }
+    }
+    if (!snapshot.health || !VALID_HEALTH_STATUSES.has(snapshot.health.status)) {
+        failures.push(`${adapterId}: snapshot.health.status must be one of ${Array.from(VALID_HEALTH_STATUSES).join("/")}`);
+    }
+    if (snapshot.health && snapshot.health.status !== "ready" && !snapshot.health.detail) {
+        failures.push(`${adapterId}: non-ready health must carry a human-readable detail`);
+    }
+    for (const agent of Array.isArray(snapshot.agents) ? snapshot.agents : []) {
+        if (!VALID_CONFIDENCES.has(agent.confidence)) {
+            failures.push(`${adapterId}: agent ${agent.id} confidence must be typed or inferred`);
+            break;
+        }
+    }
+}
+function validateAdapterShape(adapter) {
+    const failures = [];
+    if (!adapter || typeof adapter !== "object") {
+        return ["adapter must be an object"];
+    }
+    if (typeof adapter.id !== "string" || adapter.id.length === 0) {
+        failures.push("adapter.id must be a non-empty string");
+    }
+    if (typeof adapter.source !== "string" || adapter.source.length === 0) {
+        failures.push(`${adapter.id ?? "adapter"}: source must be a non-empty string`);
+    }
+    if (!adapter.capabilities || typeof adapter.capabilities !== "object") {
+        failures.push(`${adapter.id}: capabilities must be an object (empty object is fine)`);
+    }
+    if (typeof adapter.createSource !== "function") {
+        failures.push(`${adapter.id}: createSource(context) must be a function`);
+    }
+    if (adapter.capabilities?.discoverProjects === true && typeof adapter.discoverProjects !== "function") {
+        failures.push(`${adapter.id}: capabilities.discoverProjects requires a discoverProjects() implementation`);
+    }
+    return failures;
+}
+async function runAdapterContractChecks(adapter, options = {}) {
+    const failures = validateAdapterShape(adapter);
+    if (failures.length > 0) {
+        return failures;
+    }
+    const projectRoot = options.projectRoot ?? "/tmp/agents-tower-contract-fixture";
+    const refreshTimeoutMs = options.refreshTimeoutMs ?? 10_000;
+    let source;
+    try {
+        source = adapter.createSource({ projectRoot });
+    }
+    catch (error) {
+        failures.push(`${adapter.id}: createSource threw synchronously: ${error instanceof Error ? error.message : String(error)}`);
+        return failures;
+    }
+    for (const method of ["warm", "refresh", "getCachedSnapshot", "dispose"]) {
+        if (typeof source[method] !== "function") {
+            failures.push(`${adapter.id}: source.${method} must be a function`);
+        }
+    }
+    if (failures.length > 0) {
+        return failures;
+    }
+    checkSnapshotShape(source.getCachedSnapshot(), adapter.id, failures);
+    try {
+        await Promise.race([
+            source.refresh("manual"),
+            new Promise((_, reject) => setTimeout(() => reject(new Error("refresh timed out")), refreshTimeoutMs))
+        ]);
+    }
+    catch (error) {
+        failures.push(`${adapter.id}: refresh("manual") must resolve without throwing (providers report failures via degraded/error health): `
+            + (error instanceof Error ? error.message : String(error)));
+    }
+    checkSnapshotShape(source.getCachedSnapshot(), adapter.id, failures);
+    try {
+        await source.dispose();
+    }
+    catch (error) {
+        failures.push(`${adapter.id}: dispose() must resolve without throwing: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return failures;
+}
+//# sourceMappingURL=contract-harness.js.map

package/dist/adapters/contract-harness.js.map

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

package/dist/adapters/cursor-cloud.js

@@ -21,7 +21,7 @@ exports.cursorCloudAdapter = {
                         source: "cursor",
                         notes: [availabilityNote],
                         generatedAt,
-                        health: (0, helpers_1.degradedHealth)(availabilityNote, generatedAt)
+                        health: (0, helpers_1.unconfiguredHealth)(availabilityNote, generatedAt)
                     });
                 }
                 const snapshotData = await (0, cursor_1.loadCursorCloudProjectSnapshotData)(context.projectRoot, {

package/dist/adapters/cursor-cloud.js.map

@@ -1 +1 @@
-{"version":3,"file":"cursor-cloud.js","sourceRoot":"","sources":["../../src/adapters/cursor-cloud.ts"],"names":[],"mappings":";;;AAAA,sCAAgG;AAEhG,uCAAiE;AACjE,mDAAsD;AAEzC,QAAA,kBAAkB,GAAmB;IAChD,EAAE,EAAE,cAAc;IAClB,MAAM,EAAE,QAAQ;IAChB,YAAY,EAAE,EAAE;IAChB,YAAY,CAAC,OAAO;QAClB,MAAM,2BAA2B,GAAG,IAAI,GAAG,EAAuB,CAAC;QACnE,IAAI,sBAAsB,GAAG,KAAK,CAAC;QACnC,OAAO,IAAI,mCAAmB,CAAC,KAAK,IAAI,EAAE;YACxC,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,gBAAgB,GAAG,MAAM,IAAA,wCAA+B,EAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBACpF,IAAI,gBAAgB,EAAE,CAAC;oBACrB,OAAO,IAAA,8BAAoB,EAAC;wBAC1B,SAAS,EAAE,cAAc;wBACzB,MAAM,EAAE,QAAQ;wBAChB,KAAK,EAAE,CAAC,gBAAgB,CAAC;wBACzB,WAAW;wBACX,MAAM,EAAE,IAAA,wBAAc,EAAC,gBAAgB,EAAE,WAAW,CAAC;qBACtD,CAAC,CAAC;gBACL,CAAC;gBAED,MAAM,YAAY,GAAG,MAAM,IAAA,2CAAkC,EAAC,OAAO,CAAC,WAAW,EAAE;oBACjF,2BAA2B;oBAC3B,sBAAsB;iBACvB,CAAC,CAAC;gBACH,sBAAsB,GAAG,IAAI,CAAC;gBAC9B,OAAO,IAAA,8BAAoB,EAAC;oBAC1B,SAAS,EAAE,cAAc;oBACzB,MAAM,EAAE,QAAQ;oBAChB,MAAM,EAAE,YAAY,CAAC,MAAM;oBAC3B,MAAM,EAAE,YAAY,CAAC,MAAM;oBAC3B,WAAW;iBACZ,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,sBAAsB,GAAG,IAAI,CAAC;gBAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,OAAO,IAAA,8BAAoB,EAAC;oBAC1B,SAAS,EAAE,cAAc;oBACzB,MAAM,EAAE,QAAQ;oBAChB,WAAW;oBACX,KAAK,EAAE,CAAC,yCAAyC,OAAO,EAAE,CAAC;oBAC3D,MAAM,EAAE,IAAA,wBAAc,EAAC,OAAO,EAAE,WAAW,CAAC;iBAC7C,CAAC,CAAC;YACL,CAAC;QACH,CAAC,EAAE,IAAA,8BAAoB,EAAC,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;CACF,CAAC"}
+{"version":3,"file":"cursor-cloud.js","sourceRoot":"","sources":["../../src/adapters/cursor-cloud.ts"],"names":[],"mappings":";;;AAAA,sCAAgG;AAEhG,uCAAqF;AACrF,mDAAsD;AAEzC,QAAA,kBAAkB,GAAmB;IAChD,EAAE,EAAE,cAAc;IAClB,MAAM,EAAE,QAAQ;IAChB,YAAY,EAAE,EAAE;IAChB,YAAY,CAAC,OAAO;QAClB,MAAM,2BAA2B,GAAG,IAAI,GAAG,EAAuB,CAAC;QACnE,IAAI,sBAAsB,GAAG,KAAK,CAAC;QACnC,OAAO,IAAI,mCAAmB,CAAC,KAAK,IAAI,EAAE;YACxC,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,gBAAgB,GAAG,MAAM,IAAA,wCAA+B,EAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBACpF,IAAI,gBAAgB,EAAE,CAAC;oBACrB,OAAO,IAAA,8BAAoB,EAAC;wBAC1B,SAAS,EAAE,cAAc;wBACzB,MAAM,EAAE,QAAQ;wBAChB,KAAK,EAAE,CAAC,gBAAgB,CAAC;wBACzB,WAAW;wBACX,MAAM,EAAE,IAAA,4BAAkB,EAAC,gBAAgB,EAAE,WAAW,CAAC;qBAC1D,CAAC,CAAC;gBACL,CAAC;gBAED,MAAM,YAAY,GAAG,MAAM,IAAA,2CAAkC,EAAC,OAAO,CAAC,WAAW,EAAE;oBACjF,2BAA2B;oBAC3B,sBAAsB;iBACvB,CAAC,CAAC;gBACH,sBAAsB,GAAG,IAAI,CAAC;gBAC9B,OAAO,IAAA,8BAAoB,EAAC;oBAC1B,SAAS,EAAE,cAAc;oBACzB,MAAM,EAAE,QAAQ;oBAChB,MAAM,EAAE,YAAY,CAAC,MAAM;oBAC3B,MAAM,EAAE,YAAY,CAAC,MAAM;oBAC3B,WAAW;iBACZ,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,sBAAsB,GAAG,IAAI,CAAC;gBAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,OAAO,IAAA,8BAAoB,EAAC;oBAC1B,SAAS,EAAE,cAAc;oBACzB,MAAM,EAAE,QAAQ;oBAChB,WAAW;oBACX,KAAK,EAAE,CAAC,yCAAyC,OAAO,EAAE,CAAC;oBAC3D,MAAM,EAAE,IAAA,wBAAc,EAAC,OAAO,EAAE,WAAW,CAAC;iBAC7C,CAAC,CAAC;YACL,CAAC;QACH,CAAC,EAAE,IAAA,8BAAoB,EAAC,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;CACF,CAAC"}

package/dist/adapters/helpers.d.ts

@@ -2,6 +2,8 @@ import type { AdapterHealth, AdapterSnapshot } from "./types";
 import type { CloudTask, DashboardAgent, DashboardEvent } from "../types";
 export declare function readyHealth(detail?: string | null, generatedAt?: string): AdapterHealth;
 export declare function degradedHealth(detail: string, generatedAt?: string): AdapterHealth;
+export declare function errorHealth(detail: string, generatedAt?: string): AdapterHealth;
+export declare function unconfiguredHealth(detail: string, generatedAt?: string): AdapterHealth;
 export declare function emptyAdapterSnapshot(input: {
     adapterId: string;
     source: DashboardAgent["source"];

package/dist/adapters/helpers.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readyHealth = readyHealth;
 exports.degradedHealth = degradedHealth;
+exports.errorHealth = errorHealth;
+exports.unconfiguredHealth = unconfiguredHealth;
 exports.emptyAdapterSnapshot = emptyAdapterSnapshot;
 function readyHealth(detail = null, generatedAt = new Date().toISOString()) {
     return {
@@ -17,6 +19,20 @@ function degradedHealth(detail, generatedAt = new Date().toISOString()) {
         lastUpdatedAt: generatedAt
     };
 }
+function errorHealth(detail, generatedAt = new Date().toISOString()) {
+    return {
+        status: "error",
+        detail,
+        lastUpdatedAt: generatedAt
+    };
+}
+function unconfiguredHealth(detail, generatedAt = new Date().toISOString()) {
+    return {
+        status: "unconfigured",
+        detail,
+        lastUpdatedAt: generatedAt
+    };
+}
 function emptyAdapterSnapshot(input) {
     const generatedAt = input.generatedAt ?? new Date().toISOString();
     return {

package/dist/adapters/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/adapters/helpers.ts"],"names":[],"mappings":";;AAGA,kCAMC;AAED,wCAMC;AAED,oDAsBC;AAtCD,SAAgB,WAAW,CAAC,SAAwB,IAAI,EAAE,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IAC9F,OAAO;QACL,MAAM,EAAE,OAAO;QACf,MAAM;QACN,aAAa,EAAE,WAAW;KAC3B,CAAC;AACJ,CAAC;AAED,SAAgB,cAAc,CAAC,MAAc,EAAE,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IACnF,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,MAAM;QACN,aAAa,EAAE,WAAW;KAC3B,CAAC;AACJ,CAAC;AAED,SAAgB,oBAAoB,CAAC,KAUpC;IACC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClE,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,WAAW;QACX,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;QAClC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,EAAE,WAAW,CAAC;KACvE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/adapters/helpers.ts"],"names":[],"mappings":";;AAGA,kCAMC;AAED,wCAMC;AAED,kCAMC;AAED,gDAMC;AAED,oDAsBC;AAtDD,SAAgB,WAAW,CAAC,SAAwB,IAAI,EAAE,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IAC9F,OAAO;QACL,MAAM,EAAE,OAAO;QACf,MAAM;QACN,aAAa,EAAE,WAAW;KAC3B,CAAC;AACJ,CAAC;AAED,SAAgB,cAAc,CAAC,MAAc,EAAE,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IACnF,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,MAAM;QACN,aAAa,EAAE,WAAW;KAC3B,CAAC;AACJ,CAAC;AAED,SAAgB,WAAW,CAAC,MAAc,EAAE,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IAChF,OAAO;QACL,MAAM,EAAE,OAAO;QACf,MAAM;QACN,aAAa,EAAE,WAAW;KAC3B,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAAC,MAAc,EAAE,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IACvF,OAAO;QACL,MAAM,EAAE,cAAc;QACtB,MAAM;QACN,aAAa,EAAE,WAAW;KAC3B,CAAC;AACJ,CAAC;AAED,SAAgB,oBAAoB,CAAC,KAUpC;IACC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClE,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,WAAW;QACX,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;QAClC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,EAAE,WAAW,CAAC;KACvE,CAAC;AACJ,CAAC"}

package/dist/adapters/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./types";
+export * from "./contract-harness";
 export declare const PROJECT_ADAPTERS: readonly [import("./types").ProjectAdapter, import("./types").ProjectAdapter, import("./types").ProjectAdapter, import("./types").ProjectAdapter, import("./types").ProjectAdapter, import("./types").ProjectAdapter, import("./types").ProjectAdapter, import("./types").ProjectAdapter];

package/dist/adapters/index.js

@@ -24,6 +24,7 @@ const hermes_1 = require("./hermes");
 const openclaw_1 = require("./openclaw");
 const presence_1 = require("./presence");
 __exportStar(require("./types"), exports);
+__exportStar(require("./contract-harness"), exports);
 exports.PROJECT_ADAPTERS = [
     codex_local_1.codexLocalAdapter,
     claude_1.claudeAdapter,

package/dist/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qCAAyC;AACzC,+CAAkD;AAClD,+CAAkD;AAClD,iDAAoD;AACpD,iDAAoD;AACpD,qCAAyC;AACzC,yCAA6C;AAC7C,yCAA6C;AAE7C,0CAAwB;AAEX,QAAA,gBAAgB,GAAG;IAC9B,+BAAiB;IACjB,sBAAa;IACb,iCAAkB;IAClB,iCAAkB;IAClB,sBAAa;IACb,0BAAe;IACf,0BAAe;IACf,+BAAiB;CACT,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qCAAyC;AACzC,+CAAkD;AAClD,+CAAkD;AAClD,iDAAoD;AACpD,iDAAoD;AACpD,qCAAyC;AACzC,yCAA6C;AAC7C,yCAA6C;AAE7C,0CAAwB;AACxB,qDAAmC;AAEtB,QAAA,gBAAgB,GAAG;IAC9B,+BAAiB;IACjB,sBAAa;IACb,iCAAkB;IAClB,iCAAkB;IAClB,sBAAa;IACb,0BAAe;IACf,0BAAe;IACf,+BAAiB;CACT,CAAC"}

package/dist/adapters/types.d.ts

@@ -1,6 +1,6 @@
-import type { CloudTask, DashboardAgent, DashboardEvent } from "../types";
+import type { CloudTask, DashboardAgent, DashboardEvent, ProviderHealthStatus } from "../types";
 import type { DiscoveredProject } from "../project-paths";
-export type AdapterHealthStatus = "ready" | "degraded" | "error";
+export type AdapterHealthStatus = ProviderHealthStatus;
 export type AdapterRefreshReason = "warm" | "startup" | "interval" | "manual" | "event";
 export interface AdapterCapabilities {
     discoverProjects?: boolean;

package/dist/audit.d.ts

@@ -0,0 +1,17 @@
+export interface AuditRecord {
+    at: string;
+    actor: "browser" | "cli";
+    action: string;
+    target: {
+        projectRoot: string;
+        requestId?: string;
+        threadId?: string;
+    };
+    detail: string | null;
+    outcome: "ok" | "error";
+    error?: string;
+}
+export declare function appendAuditRecord(record: Omit<AuditRecord, "at"> & {
+    at?: string;
+}): AuditRecord;
+export declare function readAuditJournal(limit?: number): AuditRecord[];

package/dist/audit.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appendAuditRecord = appendAuditRecord;
+exports.readAuditJournal = readAuditJournal;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const app_settings_1 = require("./app-settings");
+function auditJournalPath() {
+    return (0, node_path_1.join)((0, app_settings_1.getAppDataDirectory)(), "audit", "journal.jsonl");
+}
+function appendAuditRecord(record) {
+    const complete = {
+        at: record.at ?? new Date().toISOString(),
+        actor: record.actor,
+        action: record.action,
+        target: record.target,
+        detail: record.detail ?? null,
+        outcome: record.outcome,
+        ...(record.error ? { error: record.error } : {})
+    };
+    const path = auditJournalPath();
+    (0, node_fs_1.mkdirSync)((0, node_path_1.join)((0, app_settings_1.getAppDataDirectory)(), "audit"), { recursive: true });
+    (0, node_fs_1.appendFileSync)(path, `${JSON.stringify(complete)}\n`);
+    return complete;
+}
+function readAuditJournal(limit = 50) {
+    const path = auditJournalPath();
+    if (!(0, node_fs_1.existsSync)(path)) {
+        return [];
+    }
+    const lines = (0, node_fs_1.readFileSync)(path, "utf8").split(/\r?\n/).filter(Boolean);
+    const records = [];
+    for (const line of lines.slice(-Math.max(1, limit))) {
+        try {
+            records.push(JSON.parse(line));
+        }
+        catch {
+            // Skip corrupted lines rather than failing the whole read.
+        }
+    }
+    return records;
+}
+//# sourceMappingURL=audit.js.map

package/dist/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":";;AAuBA,8CAcC;AAED,4CAeC;AAtDD,qCAA8E;AAC9E,yCAAiC;AAEjC,iDAAqD;AAgBrD,SAAS,gBAAgB;IACvB,OAAO,IAAA,gBAAI,EAAC,IAAA,kCAAmB,GAAE,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;AAC/D,CAAC;AAED,SAAgB,iBAAiB,CAAC,MAAiD;IACjF,MAAM,QAAQ,GAAgB;QAC5B,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACzC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;QAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjD,CAAC;IACF,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;IAChC,IAAA,mBAAS,EAAC,IAAA,gBAAI,EAAC,IAAA,kCAAmB,GAAE,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,IAAA,wBAAc,EAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,gBAAgB,CAAC,KAAK,GAAG,EAAE;IACzC,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;IAChC,IAAI,CAAC,IAAA,oBAAU,EAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAG,IAAA,sBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxE,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAgB,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;QAC7D,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/coordination.d.ts

@@ -0,0 +1,28 @@
+import type { CoordinationClaim, CoordinationClaimView } from "./types";
+export declare const DEFAULT_CLAIM_TTL_MS: number;
+export declare function startCoordinationClaim(input: {
+    projectRoot: string;
+    objective: string;
+    scope?: string[];
+    branch?: string | null;
+    agentLabel?: string | null;
+    blockedOn?: string | null;
+    ttlMs?: number;
+    nowMs?: number;
+}): CoordinationClaim;
+export declare function heartbeatCoordinationClaim(projectRoot: string, id: string, options?: {
+    ttlMs?: number;
+    blockedOn?: string | null;
+    nowMs?: number;
+}): CoordinationClaim | null;
+export declare function releaseCoordinationClaim(projectRoot: string, id: string, options?: {
+    handoff?: boolean;
+    nowMs?: number;
+}): CoordinationClaim | null;
+export declare function listCoordinationClaims(projectRoot: string, nowMs?: number): CoordinationClaimView[];
+export interface ClaimOverlapAdvice {
+    verdict: "proceed" | "caution";
+    reasons: string[];
+    overlapping: CoordinationClaimView[];
+}
+export declare function adviseOnClaimOverlap(projectRoot: string, requestedScope: string[], nowMs?: number): ClaimOverlapAdvice;

package/dist/coordination.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CLAIM_TTL_MS = void 0;
+exports.startCoordinationClaim = startCoordinationClaim;
+exports.heartbeatCoordinationClaim = heartbeatCoordinationClaim;
+exports.releaseCoordinationClaim = releaseCoordinationClaim;
+exports.listCoordinationClaims = listCoordinationClaims;
+exports.adviseOnClaimOverlap = adviseOnClaimOverlap;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const app_settings_1 = require("./app-settings");
+const project_paths_1 = require("./project-paths");
+exports.DEFAULT_CLAIM_TTL_MS = 20 * 60 * 1000;
+const RESOLVED_CLAIM_RETENTION_MS = 10 * 60 * 1000;
+const STALE_CLAIM_RETENTION_MS = 24 * 60 * 60 * 1000;
+function claimsDirectory(projectRoot) {
+    const hash = (0, node_crypto_1.createHash)("sha256").update((0, project_paths_1.projectPathIdentityKey)(projectRoot) ?? projectRoot).digest("hex").slice(0, 16);
+    return (0, node_path_1.join)((0, app_settings_1.getAppDataDirectory)(), "coordination", hash);
+}
+function claimFilePath(projectRoot, id) {
+    return (0, node_path_1.join)(claimsDirectory(projectRoot), `${id}.json`);
+}
+function readClaimFile(path) {
+    try {
+        const parsed = JSON.parse((0, node_fs_1.readFileSync)(path, "utf8"));
+        return typeof parsed?.id === "string" && typeof parsed?.objective === "string" ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeClaimFile(claim) {
+    const directory = claimsDirectory(claim.projectRoot);
+    (0, node_fs_1.mkdirSync)(directory, { recursive: true });
+    (0, node_fs_1.writeFileSync)(claimFilePath(claim.projectRoot, claim.id), `${JSON.stringify(claim, null, 2)}\n`);
+}
+function claimLifecycle(claim, nowMs) {
+    if (claim.status === "released" || claim.status === "handoff") {
+        return claim.status;
+    }
+    const expiresMs = Date.parse(claim.expiresAt);
+    return Number.isFinite(expiresMs) && nowMs > expiresMs ? "stale" : "active";
+}
+function shouldPruneClaim(claim, lifecycle, nowMs) {
+    if (lifecycle === "released" || lifecycle === "handoff") {
+        const heartbeatMs = Date.parse(claim.heartbeatAt);
+        return !Number.isFinite(heartbeatMs) || nowMs - heartbeatMs > RESOLVED_CLAIM_RETENTION_MS;
+    }
+    if (lifecycle === "stale") {
+        const expiresMs = Date.parse(claim.expiresAt);
+        return !Number.isFinite(expiresMs) || nowMs - expiresMs > STALE_CLAIM_RETENTION_MS;
+    }
+    return false;
+}
+function startCoordinationClaim(input) {
+    const nowMs = input.nowMs ?? Date.now();
+    const ttlMs = Number.isFinite(input.ttlMs) && input.ttlMs > 0 ? input.ttlMs : exports.DEFAULT_CLAIM_TTL_MS;
+    const now = new Date(nowMs).toISOString();
+    const claim = {
+        id: (0, node_crypto_1.randomUUID)(),
+        projectRoot: input.projectRoot,
+        objective: input.objective,
+        scope: input.scope?.filter(Boolean) ?? [],
+        branch: input.branch ?? null,
+        agentLabel: input.agentLabel ?? null,
+        status: "active",
+        blockedOn: input.blockedOn ?? null,
+        createdAt: now,
+        heartbeatAt: now,
+        expiresAt: new Date(nowMs + ttlMs).toISOString()
+    };
+    writeClaimFile(claim);
+    return claim;
+}
+function heartbeatCoordinationClaim(projectRoot, id, options = {}) {
+    const existing = readClaimFile(claimFilePath(projectRoot, id));
+    if (!existing || existing.status !== "active") {
+        return null;
+    }
+    const nowMs = options.nowMs ?? Date.now();
+    const ttlMs = Number.isFinite(options.ttlMs) && options.ttlMs > 0 ? options.ttlMs : exports.DEFAULT_CLAIM_TTL_MS;
+    const updated = {
+        ...existing,
+        blockedOn: options.blockedOn !== undefined ? options.blockedOn : existing.blockedOn,
+        heartbeatAt: new Date(nowMs).toISOString(),
+        expiresAt: new Date(nowMs + ttlMs).toISOString()
+    };
+    writeClaimFile(updated);
+    return updated;
+}
+function releaseCoordinationClaim(projectRoot, id, options = {}) {
+    const existing = readClaimFile(claimFilePath(projectRoot, id));
+    if (!existing) {
+        return null;
+    }
+    const nowMs = options.nowMs ?? Date.now();
+    const updated = {
+        ...existing,
+        status: options.handoff === true ? "handoff" : "released",
+        heartbeatAt: new Date(nowMs).toISOString()
+    };
+    writeClaimFile(updated);
+    return updated;
+}
+function listCoordinationClaims(projectRoot, nowMs = Date.now()) {
+    const directory = claimsDirectory(projectRoot);
+    if (!(0, node_fs_1.existsSync)(directory)) {
+        return [];
+    }
+    const views = [];
+    for (const entry of (0, node_fs_1.readdirSync)(directory)) {
+        if (!entry.endsWith(".json")) {
+            continue;
+        }
+        const path = (0, node_path_1.join)(directory, entry);
+        const claim = readClaimFile(path);
+        if (!claim) {
+            (0, node_fs_1.rmSync)(path, { force: true });
+            continue;
+        }
+        const lifecycle = claimLifecycle(claim, nowMs);
+        if (shouldPruneClaim(claim, lifecycle, nowMs)) {
+            (0, node_fs_1.rmSync)(path, { force: true });
+            continue;
+        }
+        views.push({ ...claim, lifecycle });
+    }
+    return views.sort((left, right) => right.heartbeatAt.localeCompare(left.heartbeatAt));
+}
+function normalizedScopePath(value) {
+    return value.replace(/\\/g, "/").replace(/\/+$/g, "").toLowerCase();
+}
+function scopesOverlap(left, right) {
+    const a = normalizedScopePath(left);
+    const b = normalizedScopePath(right);
+    return a === b || a.startsWith(`${b}/`) || b.startsWith(`${a}/`);
+}
+function adviseOnClaimOverlap(projectRoot, requestedScope, nowMs = Date.now()) {
+    const claims = listCoordinationClaims(projectRoot, nowMs)
+        .filter((claim) => claim.lifecycle === "active" || claim.lifecycle === "stale");
+    const overlapping = claims.filter((claim) => claim.scope.length > 0
+        && requestedScope.some((requested) => claim.scope.some((declared) => scopesOverlap(requested, declared))));
+    if (overlapping.length === 0) {
+        return {
+            verdict: "proceed",
+            reasons: claims.length === 0
+                ? ["No declared claims for this project."]
+                : ["Declared scopes appear disjoint from the requested paths."],
+            overlapping: []
+        };
+    }
+    const reasons = overlapping.map((claim) => claim.lifecycle === "stale"
+        ? `Stale claim "${claim.objective}" overlaps and was not explicitly released — confirm before proceeding.`
+        : `Active claim "${claim.objective}"${claim.agentLabel ? ` by ${claim.agentLabel}` : ""} overlaps the requested scope.`);
+    return { verdict: "caution", reasons, overlapping };
+}
+//# sourceMappingURL=coordination.js.map

package/dist/coordination.js.map

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

package/dist/history.d.ts

@@ -0,0 +1,17 @@
+import type { DashboardSnapshot } from "./types";
+export type HistoryEventKind = "wait.opened" | "wait.resolved" | "session.started" | "session.finished";
+export interface HistoryEvent {
+    at: string;
+    kind: HistoryEventKind;
+    projectLabel: string;
+    agentLabel: string;
+    provenance: string;
+    detail: string | null;
+    waitMs?: number;
+}
+export interface HistoryFleetView {
+    projects: Pick<DashboardSnapshot, "projectLabel" | "agents">[];
+}
+export declare function diffFleetForHistory(previous: HistoryFleetView | null, next: HistoryFleetView, nowMs?: number): HistoryEvent[];
+export declare function appendHistoryEvents(events: HistoryEvent[]): void;
+export declare function readHistoryEvents(sinceMs: number, nowMs?: number): HistoryEvent[];

package/dist/history.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diffFleetForHistory = diffFleetForHistory;
+exports.appendHistoryEvents = appendHistoryEvents;
+exports.readHistoryEvents = readHistoryEvents;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const app_settings_1 = require("./app-settings");
+const HISTORY_JOURNAL_MAX_BYTES = 2 * 1024 * 1024;
+function historyDirectory() {
+    return (0, node_path_1.join)((0, app_settings_1.getAppDataDirectory)(), "history");
+}
+function historyJournalPath() {
+    return (0, node_path_1.join)(historyDirectory(), "journal.jsonl");
+}
+function isBusy(agent) {
+    return agent.isCurrent === true || agent.isOngoing === true;
+}
+function trackedAgents(fleet) {
+    const tracked = new Map();
+    for (const project of fleet.projects) {
+        for (const agent of project.agents) {
+            tracked.set(agent.id, { agent, projectLabel: project.projectLabel });
+        }
+    }
+    return tracked;
+}
+function diffFleetForHistory(previous, next, nowMs = Date.now()) {
+    const at = new Date(nowMs).toISOString();
+    const events = [];
+    const before = previous ? trackedAgents(previous) : new Map();
+    const after = trackedAgents(next);
+    for (const [id, { agent, projectLabel }] of after) {
+        const prior = before.get(id);
+        if (agent.needsUser && !prior?.agent.needsUser) {
+            events.push({
+                at,
+                kind: "wait.opened",
+                projectLabel,
+                agentLabel: agent.label,
+                provenance: agent.provenance,
+                detail: agent.needsUser.kind
+            });
+        }
+        if (!agent.needsUser && prior?.agent.needsUser) {
+            const openedMs = Date.parse(prior.agent.updatedAt);
+            events.push({
+                at,
+                kind: "wait.resolved",
+                projectLabel,
+                agentLabel: agent.label,
+                provenance: agent.provenance,
+                detail: prior.agent.needsUser?.kind ?? null,
+                waitMs: Number.isFinite(openedMs) ? Math.max(0, nowMs - openedMs) : undefined
+            });
+        }
+        if (previous && isBusy(agent) && (!prior || !isBusy(prior.agent))) {
+            events.push({
+                at,
+                kind: "session.started",
+                projectLabel,
+                agentLabel: agent.label,
+                provenance: agent.provenance,
+                detail: agent.detail || null
+            });
+        }
+        if (prior && isBusy(prior.agent) && !isBusy(agent)) {
+            events.push({
+                at,
+                kind: "session.finished",
+                projectLabel,
+                agentLabel: agent.label,
+                provenance: agent.provenance,
+                detail: agent.detail || null
+            });
+        }
+    }
+    for (const [id, { agent, projectLabel }] of before) {
+        if (after.has(id)) {
+            continue;
+        }
+        if (isBusy(agent)) {
+            events.push({
+                at,
+                kind: "session.finished",
+                projectLabel,
+                agentLabel: agent.label,
+                provenance: agent.provenance,
+                detail: agent.detail || null
+            });
+        }
+        if (agent.needsUser) {
+            const openedMs = Date.parse(agent.updatedAt);
+            events.push({
+                at,
+                kind: "wait.resolved",
+                projectLabel,
+                agentLabel: agent.label,
+                provenance: agent.provenance,
+                detail: agent.needsUser.kind,
+                waitMs: Number.isFinite(openedMs) ? Math.max(0, nowMs - openedMs) : undefined
+            });
+        }
+    }
+    return events;
+}
+function appendHistoryEvents(events) {
+    if (events.length === 0) {
+        return;
+    }
+    (0, node_fs_1.mkdirSync)(historyDirectory(), { recursive: true });
+    const path = historyJournalPath();
+    try {
+        if ((0, node_fs_1.existsSync)(path) && (0, node_fs_1.statSync)(path).size > HISTORY_JOURNAL_MAX_BYTES) {
+            (0, node_fs_1.renameSync)(path, (0, node_path_1.join)(historyDirectory(), "journal.previous.jsonl"));
+        }
+    }
+    catch {
+        // Rotation is best-effort; appending still proceeds.
+    }
+    (0, node_fs_1.appendFileSync)(path, events.map((event) => JSON.stringify(event)).join("\n") + "\n");
+}
+function readHistoryEvents(sinceMs, nowMs = Date.now()) {
+    const events = [];
+    for (const file of ["journal.previous.jsonl", "journal.jsonl"]) {
+        const path = (0, node_path_1.join)(historyDirectory(), file);
+        if (!(0, node_fs_1.existsSync)(path)) {
+            continue;
+        }
+        for (const line of (0, node_fs_1.readFileSync)(path, "utf8").split(/\r?\n/)) {
+            if (!line) {
+                continue;
+            }
+            try {
+                const event = JSON.parse(line);
+                const atMs = Date.parse(event.at);
+                if (Number.isFinite(atMs) && atMs >= sinceMs && atMs <= nowMs) {
+                    events.push(event);
+                }
+            }
+            catch {
+                // Skip corrupted lines.
+            }
+        }
+    }
+    return events.sort((left, right) => left.at.localeCompare(right.at));
+}
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

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

package/dist/index.d.ts

@@ -3,12 +3,15 @@ export * from "./aseprite";
 export * from "./appearance";
 export * from "./app-server";
 export * from "./app-settings";
+export * from "./audit";
 export * from "./cloud";
+export * from "./coordination";
 export * from "./claude-agent-sdk";
 export * from "./claude-home-cache";
 export * from "./codex-command";
 export { normalizeRepositoryUrl } from "./cursor-lib/shared";
 export * from "./domain/workspace-activity";
+export * from "./history";
 export * from "./hermes";
 export * from "./hermes-hook-install";
 export * from "./openclaw";

package/dist/index.js

@@ -20,13 +20,16 @@ __exportStar(require("./aseprite"), exports);
 __exportStar(require("./appearance"), exports);
 __exportStar(require("./app-server"), exports);
 __exportStar(require("./app-settings"), exports);
+__exportStar(require("./audit"), exports);
 __exportStar(require("./cloud"), exports);
+__exportStar(require("./coordination"), exports);
 __exportStar(require("./claude-agent-sdk"), exports);
 __exportStar(require("./claude-home-cache"), exports);
 __exportStar(require("./codex-command"), exports);
 var shared_1 = require("./cursor-lib/shared");
 Object.defineProperty(exports, "normalizeRepositoryUrl", { enumerable: true, get: function () { return shared_1.normalizeRepositoryUrl; } });
 __exportStar(require("./domain/workspace-activity"), exports);
+__exportStar(require("./history"), exports);
 __exportStar(require("./hermes"), exports);
 __exportStar(require("./hermes-hook-install"), exports);
 __exportStar(require("./openclaw"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,6CAA2B;AAC3B,+CAA6B;AAC7B,+CAA6B;AAC7B,iDAA+B;AAC/B,0CAAwB;AACxB,qDAAmC;AACnC,sDAAoC;AACpC,kDAAgC;AAChC,8CAA6D;AAApD,gHAAA,sBAAsB,OAAA;AAC/B,8DAA4C;AAC5C,2CAAyB;AACzB,wDAAsC;AACtC,6CAA2B;AAC3B,6CAA2B;AAC3B,qDAAmC;AACnC,kDAAgC;AAChC,oDAAkC;AAClC,gDAA8B;AAC9B,+DAA6C;AAC7C,kEAAgD;AAChD,0EAAwD;AACxD,+DAA6C;AAC7C,gEAA8C;AAC9C,0DAAwC;AACxC,6CAA2B;AAC3B,0CAAwB;AACxB,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,6CAA2B;AAC3B,+CAA6B;AAC7B,+CAA6B;AAC7B,iDAA+B;AAC/B,0CAAwB;AACxB,0CAAwB;AACxB,iDAA+B;AAC/B,qDAAmC;AACnC,sDAAoC;AACpC,kDAAgC;AAChC,8CAA6D;AAApD,gHAAA,sBAAsB,OAAA;AAC/B,8DAA4C;AAC5C,4CAA0B;AAC1B,2CAAyB;AACzB,wDAAsC;AACtC,6CAA2B;AAC3B,6CAA2B;AAC3B,qDAAmC;AACnC,kDAAgC;AAChC,oDAAkC;AAClC,gDAA8B;AAC9B,+DAA6C;AAC7C,kEAAgD;AAChD,0EAAwD;AACxD,+DAA6C;AAC7C,gEAA8C;AAC9C,0DAAwC;AACxC,6CAA2B;AAC3B,0CAAwB;AACxB,6CAA2B"}

package/dist/services/snapshot-assembler.js

@@ -7,6 +7,7 @@ const app_settings_1 = require("../app-settings");
 const room_config_1 = require("../room-config");
 const project_identity_1 = require("../project-identity");
 const workload_policy_1 = require("../domain/workload-policy");
+const coordination_1 = require("../coordination");
 const workspace_activity_1 = require("../domain/workspace-activity");
 const activity_summary_1 = require("../snapshot-lib/activity-summary");
 const project_paths_1 = require("../project-paths");
@@ -32,6 +33,16 @@ function aggregateNotes(snapshots) {
 function aggregateCloudTasks(snapshots) {
     return snapshots.flatMap((snapshot) => snapshot.cloudTasks ?? []);
 }
+function aggregateProviderHealth(snapshots) {
+    return snapshots.map((snapshot) => ({
+        adapterId: snapshot.adapterId,
+        provider: snapshot.source,
+        status: snapshot.health.status,
+        detail: snapshot.health.detail,
+        lastUpdatedAt: snapshot.health.lastUpdatedAt,
+        snapshotGeneratedAt: snapshot.generatedAt
+    }));
+}
 function parseGitStatusPath(line) {
     const rawPath = line.slice(3).trim();
     if (!rawPath) {
@@ -157,7 +168,9 @@ async function assembleProjectSnapshot(input) {
         cloudTasks,
         events,
         activity,
-        notes: aggregateNotes(input.adapterSnapshots)
+        notes: aggregateNotes(input.adapterSnapshots),
+        providerHealth: aggregateProviderHealth(input.adapterSnapshots),
+        claims: (0, coordination_1.listCoordinationClaims)(projectRoot, now)
     }, now);
     const diagnostics = freshUnseatedHotChangeAgentDiagnostics(snapshot, now);
     return diagnostics.length > 0

package/dist/services/snapshot-assembler.js.map

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

package/dist/types.d.ts

@@ -348,6 +348,33 @@ export interface WorkspaceActivitySnapshot {
     hotTools: HotToolSummary[];
     runningCommands: RunningCommandSummary[];
 }
+export type CoordinationClaimStatus = "active" | "released" | "handoff";
+export type CoordinationClaimLifecycle = "active" | "stale" | "released" | "handoff";
+export interface CoordinationClaim {
+    id: string;
+    projectRoot: string;
+    objective: string;
+    scope: string[];
+    branch: string | null;
+    agentLabel: string | null;
+    status: CoordinationClaimStatus;
+    blockedOn: string | null;
+    createdAt: string;
+    heartbeatAt: string;
+    expiresAt: string;
+}
+export interface CoordinationClaimView extends CoordinationClaim {
+    lifecycle: CoordinationClaimLifecycle;
+}
+export type ProviderHealthStatus = "ready" | "unconfigured" | "degraded" | "error";
+export interface ProviderHealth {
+    adapterId: string;
+    provider: DashboardAgent["source"];
+    status: ProviderHealthStatus;
+    detail: string | null;
+    lastUpdatedAt: string | null;
+    snapshotGeneratedAt: string;
+}
 export interface DashboardSnapshot {
     projectRoot: string;
     projectLabel: string;
@@ -359,6 +386,8 @@ export interface DashboardSnapshot {
     events: DashboardEvent[];
     activity: WorkspaceActivitySnapshot;
     notes: string[];
+    providerHealth: ProviderHealth[];
+    claims: CoordinationClaimView[];
 }
 export interface SnapshotOptions {
     projectRoot: string;

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@agents-tower/core",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Kundara/AgentsOfficeTower.git",
+    "directory": "packages/core"
+  },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [