@roackb2/heddle 1.3.0 → 1.5.0

package/dist/src/core/runtime/daemon/host-resolver.js

@@ -0,0 +1,61 @@
+/**
+ * Runtime host resolver.
+ *
+ * Resolves whether the current workspace has a live daemon owner. This is
+ * daemon-discovery policy, not CLI/web presentation.
+ */
+import { FileDaemonRegistryRepository } from './registry-repository.js';
+import { RuntimeDaemonRegistryService } from './registry-service.js';
+import { RuntimeWorkspaceService } from '../../../core/runtime/workspaces/index.js';
+const DEFAULT_STALE_AFTER_MS = 45_000;
+export class RuntimeHostResolver {
+    static resolveWorkspaceHost(input) {
+        const workspace = RuntimeWorkspaceService.resolveContext(input).activeWorkspace;
+        const registryPath = input.registryPath ?? FileDaemonRegistryRepository.resolvePath();
+        const registration = RuntimeDaemonRegistryService.readWorkspaceRegistration(registryPath, workspace.id, workspace.stateRoot);
+        const owner = registration?.owner;
+        if (!owner) {
+            return {
+                kind: 'none',
+                registryPath,
+                workspaceId: workspace.id,
+            };
+        }
+        const now = input.now ?? Date.now();
+        const lastSeenAt = Date.parse(owner.lastSeenAt);
+        const ageMs = Number.isFinite(lastSeenAt) ? Math.max(0, now - lastSeenAt) : Number.POSITIVE_INFINITY;
+        const staleByAge = ageMs > (input.staleAfterMs ?? DEFAULT_STALE_AFTER_MS);
+        const pidAlive = owner.pid > 0 ? (input.isPidAlive ?? RuntimeHostResolver.isPidAlive)(owner.pid) : true;
+        const stale = staleByAge || !pidAlive;
+        return {
+            kind: 'daemon',
+            registryPath,
+            workspaceId: workspace.id,
+            ownerId: owner.ownerId,
+            endpoint: {
+                host: owner.host,
+                port: owner.port,
+            },
+            startedAt: owner.startedAt,
+            lastSeenAt: owner.lastSeenAt,
+            stale,
+            ageMs,
+        };
+    }
+    static isPidAlive(pid) {
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch (error) {
+            if (RuntimeHostResolver.isNodeError(error) && error.code === 'EPERM') {
+                return true;
+            }
+            return false;
+        }
+    }
+    static isNodeError(error) {
+        return typeof error === 'object' && error !== null && 'code' in error;
+    }
+}
+//# sourceMappingURL=host-resolver.js.map

package/dist/src/core/runtime/daemon/host-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-resolver.js","sourceRoot":"","sources":["../../../../../src/core/runtime/daemon/host-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAErE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAEtC,MAAM,OAAO,mBAAmB;IAC9B,MAAM,CAAC,oBAAoB,CAAC,KAA8B;QACxD,MAAM,SAAS,GAAG,uBAAuB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC;QAChF,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,4BAA4B,CAAC,WAAW,EAAE,CAAC;QACtF,MAAM,YAAY,GAAG,4BAA4B,CAAC,yBAAyB,CACzE,YAAY,EACZ,SAAS,CAAC,EAAE,EACZ,SAAS,CAAC,SAAS,CACpB,CAAC;QACF,MAAM,KAAK,GAAG,YAAY,EAAE,KAAK,CAAC;QAElC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,YAAY;gBACZ,WAAW,EAAE,SAAS,CAAC,EAAE;aAC1B,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;QACrG,MAAM,UAAU,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,sBAAsB,CAAC,CAAC;QAC1E,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,IAAI,mBAAmB,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACxG,MAAM,KAAK,GAAG,UAAU,IAAI,CAAC,QAAQ,CAAC;QAEtC,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,YAAY;YACZ,WAAW,EAAE,SAAS,CAAC,EAAE;YACzB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE;gBACR,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB;YACD,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,KAAK;YACL,KAAK;SACN,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,UAAU,CAAC,GAAW;QACnC,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,mBAAmB,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrE,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,WAAW,CAAC,KAAc;QACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,CAAC;IACxE,CAAC;CACF"}

package/dist/src/core/runtime/daemon/index.d.ts

@@ -0,0 +1,6 @@
+export { RuntimeHostResolver } from './host-resolver.js';
+export { RuntimeHostMessages } from './messages.js';
+export { FileDaemonRegistryRepository } from './registry-repository.js';
+export { RuntimeDaemonRegistryService } from './registry-service.js';
+export type { ClearDaemonWorkspaceRegistrationInput, DaemonOwnerRecord, DaemonRegistry, RegisteredWorkspaceRecord, RegisterKnownWorkspacesInput, ResolvedRuntimeHost, ResolveRuntimeHostInput, UpsertDaemonWorkspaceRegistrationInput, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/runtime/daemon/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/runtime/daemon/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACrE,YAAY,EACV,qCAAqC,EACrC,iBAAiB,EACjB,cAAc,EACd,yBAAyB,EACzB,4BAA4B,EAC5B,mBAAmB,EACnB,uBAAuB,EACvB,sCAAsC,GACvC,MAAM,YAAY,CAAC"}

package/dist/src/core/runtime/daemon/index.js

@@ -0,0 +1,5 @@
+export { RuntimeHostResolver } from './host-resolver.js';
+export { RuntimeHostMessages } from './messages.js';
+export { FileDaemonRegistryRepository } from './registry-repository.js';
+export { RuntimeDaemonRegistryService } from './registry-service.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/runtime/daemon/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/runtime/daemon/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/core/runtime/daemon/messages.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Runtime host message formatter.
+ *
+ * Keeps daemon-owner notices and conflict text together so host adapters do not
+ * each invent slightly different wording for the same runtime-owner state.
+ */
+import type { ResolvedRuntimeHost } from './types.js';
+export declare class RuntimeHostMessages {
+    static formatNotice(command: string, host: ResolvedRuntimeHost): string | undefined;
+    static embeddedCommandConflict(command: string, host: ResolvedRuntimeHost): string | undefined;
+    static daemonStartConflict(host: ResolvedRuntimeHost): string | undefined;
+}
+//# sourceMappingURL=messages.d.ts.map

package/dist/src/core/runtime/daemon/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../../../src/core/runtime/daemon/messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS;IAqBnF,MAAM,CAAC,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS;IAa9F,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS;CAY1E"}

package/dist/src/core/runtime/daemon/messages.js

@@ -0,0 +1,43 @@
+export class RuntimeHostMessages {
+    static formatNotice(command, host) {
+        if (host.kind !== 'daemon' || host.stale) {
+            return undefined;
+        }
+        if (command === 'chat') {
+            return [
+                'Heddle notice: a live daemon is attached to this workspace.',
+                `daemon=http://${host.endpoint.host}:${host.endpoint.port}`,
+                `workspace=${host.workspaceId}`,
+                'Embedded chat still works here; avoid writing to the same session from multiple clients.',
+            ].join(' ');
+        }
+        return [
+            `Heddle notice: workspace is currently owned by a daemon for \`${command}\`.`,
+            `daemon=http://${host.endpoint.host}:${host.endpoint.port}`,
+            `workspace=${host.workspaceId}`,
+        ].join(' ');
+    }
+    static embeddedCommandConflict(command, host) {
+        if (host.kind !== 'daemon' || host.stale) {
+            return undefined;
+        }
+        return [
+            `Workspace ${host.workspaceId} is currently owned by a live Heddle daemon.`,
+            `Refusing embedded \`${command}\` to avoid conflicting runtime owners.`,
+            `daemon=http://${host.endpoint.host}:${host.endpoint.port}`,
+            'Use the daemon-backed control plane, stop the daemon, or rerun with `--force-owner-conflict`.',
+        ].join(' ');
+    }
+    static daemonStartConflict(host) {
+        if (host.kind !== 'daemon' || host.stale) {
+            return undefined;
+        }
+        return [
+            `Workspace ${host.workspaceId} is already owned by a live Heddle daemon.`,
+            'Refusing to start a second daemon.',
+            `daemon=http://${host.endpoint.host}:${host.endpoint.port}`,
+            'Stop the existing daemon first or rerun with `--force-owner-conflict`.',
+        ].join(' ');
+    }
+}
+//# sourceMappingURL=messages.js.map

package/dist/src/core/runtime/daemon/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../../../src/core/runtime/daemon/messages.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,mBAAmB;IAC9B,MAAM,CAAC,YAAY,CAAC,OAAe,EAAE,IAAyB;QAC5D,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACzC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YACvB,OAAO;gBACL,6DAA6D;gBAC7D,iBAAiB,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;gBAC3D,aAAa,IAAI,CAAC,WAAW,EAAE;gBAC/B,0FAA0F;aAC3F,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACd,CAAC;QAED,OAAO;YACL,iEAAiE,OAAO,KAAK;YAC7E,iBAAiB,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;YAC3D,aAAa,IAAI,CAAC,WAAW,EAAE;SAChC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;IAED,MAAM,CAAC,uBAAuB,CAAC,OAAe,EAAE,IAAyB;QACvE,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACzC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO;YACL,aAAa,IAAI,CAAC,WAAW,8CAA8C;YAC3E,uBAAuB,OAAO,yCAAyC;YACvE,iBAAiB,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;YAC3D,+FAA+F;SAChG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;IAED,MAAM,CAAC,mBAAmB,CAAC,IAAyB;QAClD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACzC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO;YACL,aAAa,IAAI,CAAC,WAAW,4CAA4C;YACzE,oCAAoC;YACpC,iBAAiB,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;YAC3D,wEAAwE;SACzE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;CACF"}

package/dist/src/core/runtime/daemon/registry-repository.d.ts

@@ -0,0 +1,12 @@
+import type { DaemonRegistry } from './types.js';
+export declare class FileDaemonRegistryRepository {
+    private readonly registryPath;
+    constructor(args: {
+        registryPath: string;
+    });
+    static resolvePath(baseDir?: string): string;
+    exists(): boolean;
+    readRaw(): unknown | undefined;
+    save(registry: DaemonRegistry): void;
+}
+//# sourceMappingURL=registry-repository.d.ts.map

package/dist/src/core/runtime/daemon/registry-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-repository.d.ts","sourceRoot":"","sources":["../../../../../src/core/runtime/daemon/registry-repository.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,4BAA4B;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE;IAI1C,MAAM,CAAC,WAAW,CAAC,OAAO,SAA6B,GAAG,MAAM;IAIhE,MAAM,IAAI,OAAO;IAIjB,OAAO,IAAI,OAAO,GAAG,SAAS;IAQ9B,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;CAIrC"}

package/dist/src/core/runtime/daemon/registry-repository.js

@@ -0,0 +1,33 @@
+/**
+ * File-backed daemon registry repository.
+ *
+ * Owns registry path resolution and JSON I/O. Registry semantics live in
+ * `RuntimeDaemonRegistryService`.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { DaemonRegistrySchema } from './schemas.js';
+export class FileDaemonRegistryRepository {
+    registryPath;
+    constructor(args) {
+        this.registryPath = args.registryPath;
+    }
+    static resolvePath(baseDir = join(homedir(), '.heddle')) {
+        return join(resolve(baseDir), 'daemon-registry.json');
+    }
+    exists() {
+        return existsSync(this.registryPath);
+    }
+    readRaw() {
+        if (!this.exists()) {
+            return undefined;
+        }
+        return JSON.parse(readFileSync(this.registryPath, 'utf8'));
+    }
+    save(registry) {
+        mkdirSync(dirname(this.registryPath), { recursive: true });
+        writeFileSync(this.registryPath, `${JSON.stringify(DaemonRegistrySchema.parse(registry), null, 2)}\n`, 'utf8');
+    }
+}
+//# sourceMappingURL=registry-repository.js.map

package/dist/src/core/runtime/daemon/registry-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-repository.js","sourceRoot":"","sources":["../../../../../src/core/runtime/daemon/registry-repository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD,MAAM,OAAO,4BAA4B;IACtB,YAAY,CAAS;IAEtC,YAAY,IAA8B;QACxC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC;IACxD,CAAC;IAED,MAAM;QACJ,OAAO,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IAED,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAY,CAAC;IACxE,CAAC;IAED,IAAI,CAAC,QAAwB;QAC3B,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjH,CAAC;CACF"}

package/dist/src/core/runtime/daemon/registry-service.d.ts

@@ -0,0 +1,16 @@
+import type { ClearDaemonWorkspaceRegistrationInput, DaemonRegistry, RegisteredWorkspaceRecord, RegisterKnownWorkspacesInput, UpsertDaemonWorkspaceRegistrationInput } from './types.js';
+export declare class RuntimeDaemonRegistryService {
+    static read(registryPath: string): DaemonRegistry;
+    static upsertWorkspaceRegistration(input: UpsertDaemonWorkspaceRegistrationInput): DaemonRegistry;
+    static clearWorkspaceRegistration(input: ClearDaemonWorkspaceRegistrationInput): DaemonRegistry;
+    static readWorkspaceRegistration(registryPath: string, workspaceId: string, stateRoot?: string): RegisteredWorkspaceRecord | null;
+    static registerKnownWorkspaces(input: RegisterKnownWorkspacesInput): DaemonRegistry;
+    private static saveNext;
+    private static createEmptyRegistry;
+    private static normalizeRegistry;
+    private static normalizeWorkspaceRecord;
+    private static normalizeOwner;
+    private static toRecordMap;
+    private static workspaceRecordKey;
+}
+//# sourceMappingURL=registry-service.d.ts.map

package/dist/src/core/runtime/daemon/registry-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-service.d.ts","sourceRoot":"","sources":["../../../../../src/core/runtime/daemon/registry-service.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,qCAAqC,EAErC,cAAc,EACd,yBAAyB,EACzB,4BAA4B,EAC5B,sCAAsC,EACvC,MAAM,YAAY,CAAC;AAGpB,qBAAa,4BAA4B;IACvC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc;IAKjD,MAAM,CAAC,2BAA2B,CAAC,KAAK,EAAE,sCAAsC,GAAG,cAAc;IAuBjG,MAAM,CAAC,0BAA0B,CAAC,KAAK,EAAE,qCAAqC,GAAG,cAAc;IA0B/F,MAAM,CAAC,yBAAyB,CAC9B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,yBAAyB,GAAG,IAAI;IAUnC,MAAM,CAAC,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,cAAc;IAsBnF,OAAO,CAAC,MAAM,CAAC,QAAQ;IAKvB,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAQlC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAmBhC,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAYvC,OAAO,CAAC,MAAM,CAAC,cAAc;IAkB7B,OAAO,CAAC,MAAM,CAAC,WAAW;IAO1B,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAGlC"}

package/dist/src/core/runtime/daemon/registry-service.js

@@ -0,0 +1,141 @@
+/**
+ * Runtime daemon registry service.
+ *
+ * Owns the domain behavior for recording known workspaces, claiming daemon
+ * ownership, clearing daemon ownership, and resolving workspace registrations.
+ */
+import { resolve } from 'node:path';
+import { DaemonRegistryReadSchema } from './schemas.js';
+import { FileDaemonRegistryRepository } from './registry-repository.js';
+export class RuntimeDaemonRegistryService {
+    static read(registryPath) {
+        const repository = new FileDaemonRegistryRepository({ registryPath });
+        return RuntimeDaemonRegistryService.normalizeRegistry(repository.readRaw());
+    }
+    static upsertWorkspaceRegistration(input) {
+        const registry = RuntimeDaemonRegistryService.read(input.registryPath);
+        const now = input.owner.lastSeenAt ?? new Date().toISOString();
+        const nextRecords = RuntimeDaemonRegistryService.toRecordMap(registry.workspaces);
+        for (const workspace of input.workspaces) {
+            nextRecords.set(RuntimeDaemonRegistryService.workspaceRecordKey(workspace), {
+                workspace,
+                owner: {
+                    ...input.owner,
+                    lastSeenAt: now,
+                },
+                updatedAt: now,
+            });
+        }
+        return RuntimeDaemonRegistryService.saveNext(input.registryPath, {
+            version: 1,
+            updatedAt: now,
+            workspaces: Array.from(nextRecords.values()),
+        });
+    }
+    static clearWorkspaceRegistration(input) {
+        const registry = RuntimeDaemonRegistryService.read(input.registryPath);
+        const targetIds = new Set(input.workspaceIds);
+        const targetStateRoots = new Set((input.stateRoots ?? []).map((stateRoot) => resolve(stateRoot)));
+        const now = new Date().toISOString();
+        return RuntimeDaemonRegistryService.saveNext(input.registryPath, {
+            version: 1,
+            updatedAt: now,
+            workspaces: registry.workspaces.map((record) => {
+                const matchesWorkspace = targetIds.has(record.workspace.id)
+                    || targetStateRoots.has(resolve(record.workspace.stateRoot));
+                if (!matchesWorkspace || record.owner?.ownerId !== input.ownerId) {
+                    return record;
+                }
+                return {
+                    ...record,
+                    owner: undefined,
+                    updatedAt: now,
+                };
+            }),
+        });
+    }
+    static readWorkspaceRegistration(registryPath, workspaceId, stateRoot) {
+        const registry = RuntimeDaemonRegistryService.read(registryPath);
+        const normalizedStateRoot = stateRoot ? resolve(stateRoot) : undefined;
+        return registry.workspaces.find((record) => (normalizedStateRoot ?
+            resolve(record.workspace.stateRoot) === normalizedStateRoot
+            : record.workspace.id === workspaceId)) ?? null;
+    }
+    static registerKnownWorkspaces(input) {
+        const registryPath = input.registryPath ?? FileDaemonRegistryRepository.resolvePath();
+        const registry = RuntimeDaemonRegistryService.read(registryPath);
+        const now = new Date().toISOString();
+        const nextRecords = RuntimeDaemonRegistryService.toRecordMap(registry.workspaces);
+        for (const workspace of input.workspaces) {
+            const existing = nextRecords.get(RuntimeDaemonRegistryService.workspaceRecordKey(workspace));
+            nextRecords.set(RuntimeDaemonRegistryService.workspaceRecordKey(workspace), {
+                workspace,
+                owner: existing?.owner,
+                updatedAt: now,
+            });
+        }
+        return RuntimeDaemonRegistryService.saveNext(registryPath, {
+            version: 1,
+            updatedAt: now,
+            workspaces: Array.from(nextRecords.values()),
+        });
+    }
+    static saveNext(registryPath, registry) {
+        new FileDaemonRegistryRepository({ registryPath }).save(registry);
+        return registry;
+    }
+    static createEmptyRegistry() {
+        return {
+            version: 1,
+            updatedAt: new Date(0).toISOString(),
+            workspaces: [],
+        };
+    }
+    static normalizeRegistry(raw) {
+        if (raw === undefined) {
+            return RuntimeDaemonRegistryService.createEmptyRegistry();
+        }
+        const parsed = DaemonRegistryReadSchema.safeParse(raw);
+        if (!parsed.success) {
+            return RuntimeDaemonRegistryService.createEmptyRegistry();
+        }
+        return {
+            version: 1,
+            updatedAt: parsed.data.updatedAt?.trim() || new Date().toISOString(),
+            workspaces: (parsed.data.workspaces ?? []).flatMap((record) => (record.workspace ? [RuntimeDaemonRegistryService.normalizeWorkspaceRecord(record)] : [])),
+        };
+    }
+    static normalizeWorkspaceRecord(record) {
+        return {
+            workspace: record.workspace,
+            owner: RuntimeDaemonRegistryService.normalizeOwner(record.owner),
+            updatedAt: record.updatedAt?.trim() || new Date().toISOString(),
+        };
+    }
+    static normalizeOwner(owner) {
+        if (!owner?.ownerId || !owner.host || typeof owner.port !== 'number' || !owner.startedAt || !owner.lastSeenAt) {
+            return undefined;
+        }
+        return {
+            ownerId: owner.ownerId,
+            mode: 'daemon',
+            host: owner.host,
+            port: owner.port,
+            pid: typeof owner.pid === 'number' ? owner.pid : 0,
+            startedAt: owner.startedAt,
+            lastSeenAt: owner.lastSeenAt,
+            workspaceRoot: owner.workspaceRoot ?? '',
+            stateRoot: owner.stateRoot ?? '',
+        };
+    }
+    static toRecordMap(records) {
+        return new Map(records.map((record) => [
+            RuntimeDaemonRegistryService.workspaceRecordKey(record.workspace),
+            record,
+        ]));
+    }
+    static workspaceRecordKey(workspace) {
+        return resolve(workspace.stateRoot);
+    }
+}
+//# sourceMappingURL=registry-service.js.map

package/dist/src/core/runtime/daemon/registry-service.js.map

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

package/dist/src/core/runtime/daemon/schemas.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Zod schemas for daemon registry persistence.
+ *
+ * This file is the JSON contract for `.heddle/daemon-registry.json`, which
+ * lets hosts discover live daemon owners for known workspaces.
+ */
+import { z } from 'zod';
+export declare const DaemonOwnerRecordSchema: z.ZodObject<{
+    ownerId: z.ZodString;
+    mode: z.ZodLiteral<"daemon">;
+    host: z.ZodString;
+    port: z.ZodNumber;
+    pid: z.ZodNumber;
+    startedAt: z.ZodString;
+    lastSeenAt: z.ZodString;
+    workspaceRoot: z.ZodString;
+    stateRoot: z.ZodString;
+}, z.core.$strip>;
+export declare const RegisteredWorkspaceRecordSchema: z.ZodObject<{
+    workspace: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        anchorRoot: z.ZodString;
+        repoRoots: z.ZodArray<z.ZodString>;
+        stateRoot: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>;
+    owner: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        ownerId: z.ZodString;
+        mode: z.ZodLiteral<"daemon">;
+        host: z.ZodString;
+        port: z.ZodNumber;
+        pid: z.ZodNumber;
+        startedAt: z.ZodString;
+        lastSeenAt: z.ZodString;
+        workspaceRoot: z.ZodString;
+        stateRoot: z.ZodString;
+    }, z.core.$strip>>>;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const DaemonRegistrySchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    updatedAt: z.ZodString;
+    workspaces: z.ZodArray<z.ZodObject<{
+        workspace: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            anchorRoot: z.ZodString;
+            repoRoots: z.ZodArray<z.ZodString>;
+            stateRoot: z.ZodString;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, z.core.$strip>;
+        owner: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            ownerId: z.ZodString;
+            mode: z.ZodLiteral<"daemon">;
+            host: z.ZodString;
+            port: z.ZodNumber;
+            pid: z.ZodNumber;
+            startedAt: z.ZodString;
+            lastSeenAt: z.ZodString;
+            workspaceRoot: z.ZodString;
+            stateRoot: z.ZodString;
+        }, z.core.$strip>>>;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const DaemonRegistryReadSchema: z.ZodObject<{
+    version: z.ZodCatch<z.ZodOptional<z.ZodLiteral<1>>>;
+    updatedAt: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    workspaces: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        workspace: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            anchorRoot: z.ZodString;
+            repoRoots: z.ZodArray<z.ZodString>;
+            stateRoot: z.ZodString;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, z.core.$strip>>;
+        owner: z.ZodOptional<z.ZodCatch<z.ZodOptional<z.ZodObject<{
+            ownerId: z.ZodString;
+            mode: z.ZodLiteral<"daemon">;
+            host: z.ZodString;
+            port: z.ZodNumber;
+            pid: z.ZodNumber;
+            startedAt: z.ZodString;
+            lastSeenAt: z.ZodString;
+            workspaceRoot: z.ZodString;
+            stateRoot: z.ZodString;
+        }, z.core.$strip>>>>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/src/core/runtime/daemon/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/runtime/daemon/schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,uBAAuB;;;;;;;;;;iBAUlC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;iBAK1C,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI/B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAInC,CAAC"}

package/dist/src/core/runtime/daemon/schemas.js

@@ -0,0 +1,36 @@
+/**
+ * Zod schemas for daemon registry persistence.
+ *
+ * This file is the JSON contract for `.heddle/daemon-registry.json`, which
+ * lets hosts discover live daemon owners for known workspaces.
+ */
+import { z } from 'zod';
+import { WorkspaceDescriptorSchema } from '../../../core/runtime/workspaces/schemas.js';
+export const DaemonOwnerRecordSchema = z.object({
+    ownerId: z.string().describe('Unique daemon owner identifier for this registration.'),
+    mode: z.literal('daemon').describe('Runtime owner mode. Currently only daemon owners are persisted here.'),
+    host: z.string().describe('HTTP host where the daemon control plane listens.'),
+    port: z.number().describe('HTTP port where the daemon control plane listens.'),
+    pid: z.number().describe('Local process id for stale-owner detection.'),
+    startedAt: z.string().describe('Timestamp when this daemon owner started.'),
+    lastSeenAt: z.string().describe('Timestamp when this daemon owner last refreshed its registration.'),
+    workspaceRoot: z.string().describe('Filesystem workspace root used by this daemon owner.'),
+    stateRoot: z.string().describe('Heddle state root used by this daemon owner.'),
+});
+export const RegisteredWorkspaceRecordSchema = z.object({
+    workspace: WorkspaceDescriptorSchema.describe('Workspace descriptor known to the daemon registry.'),
+    owner: DaemonOwnerRecordSchema.optional().catch(undefined)
+        .describe('Live daemon owner for this workspace when one is registered.'),
+    updatedAt: z.string().describe('Timestamp when this registry record was last changed.'),
+});
+export const DaemonRegistrySchema = z.object({
+    version: z.literal(1).describe('Daemon registry format version.'),
+    updatedAt: z.string().describe('Timestamp when this registry was last written.'),
+    workspaces: z.array(RegisteredWorkspaceRecordSchema).describe('Known workspace records and optional daemon owners.'),
+});
+export const DaemonRegistryReadSchema = z.object({
+    version: z.literal(1).optional().catch(1),
+    updatedAt: z.string().optional().catch(undefined),
+    workspaces: z.array(RegisteredWorkspaceRecordSchema.partial()).optional().catch(undefined),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/src/core/runtime/daemon/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../../src/core/runtime/daemon/schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;IACrF,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,sEAAsE,CAAC;IAC1G,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IAC9E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IAC9E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACvE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAC3E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mEAAmE,CAAC;IACpG,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IAC1F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CAC/E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,SAAS,EAAE,yBAAyB,CAAC,QAAQ,CAAC,oDAAoD,CAAC;IACnG,KAAK,EAAE,uBAAuB,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;SACvD,QAAQ,CAAC,8DAA8D,CAAC;IAC3E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;CACxF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACjE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAChF,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC,QAAQ,CAAC,qDAAqD,CAAC;CACrH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;CAC3F,CAAC,CAAC"}

package/dist/src/core/runtime/daemon/types.d.ts

@@ -0,0 +1,66 @@
+import type { WorkspaceDescriptor } from '../../../core/runtime/workspaces/index.js';
+export type DaemonOwnerRecord = {
+    ownerId: string;
+    mode: 'daemon';
+    host: string;
+    port: number;
+    pid: number;
+    startedAt: string;
+    lastSeenAt: string;
+    workspaceRoot: string;
+    stateRoot: string;
+};
+export type RegisteredWorkspaceRecord = {
+    workspace: WorkspaceDescriptor;
+    owner?: DaemonOwnerRecord;
+    updatedAt: string;
+};
+export type DaemonRegistry = {
+    version: 1;
+    updatedAt: string;
+    workspaces: RegisteredWorkspaceRecord[];
+};
+export type UpsertDaemonWorkspaceRegistrationInput = {
+    registryPath: string;
+    workspaces: WorkspaceDescriptor[];
+    owner: Omit<DaemonOwnerRecord, 'lastSeenAt'> & {
+        lastSeenAt?: string;
+    };
+};
+export type ClearDaemonWorkspaceRegistrationInput = {
+    registryPath: string;
+    workspaceIds: string[];
+    stateRoots?: string[];
+    ownerId: string;
+};
+export type RegisterKnownWorkspacesInput = {
+    registryPath?: string;
+    workspaces: WorkspaceDescriptor[];
+};
+export type ResolveRuntimeHostInput = {
+    workspaceRoot: string;
+    stateRoot: string;
+    registryPath?: string;
+    now?: number;
+    staleAfterMs?: number;
+    isPidAlive?: (pid: number) => boolean;
+};
+export type ResolvedRuntimeHost = {
+    kind: 'none';
+    registryPath: string;
+    workspaceId: string;
+} | {
+    kind: 'daemon';
+    registryPath: string;
+    workspaceId: string;
+    ownerId: string;
+    endpoint: {
+        host: string;
+        port: number;
+    };
+    startedAt: string;
+    lastSeenAt: string;
+    stale: boolean;
+    ageMs: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/runtime/daemon/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/runtime/daemon/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,mBAAmB,CAAC;IAC/B,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,yBAAyB,EAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,sCAAsC,GAAG;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxE,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,mBAAmB,EAAE,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAC3B;IACE,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC"}

package/dist/src/core/runtime/daemon/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/core/runtime/daemon/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/runtime/daemon/types.ts"],"names":[],"mappings":""}

package/dist/src/core/runtime/loop/checkpoint.d.ts

@@ -0,0 +1,33 @@
+import type { ChatMessage, LlmProvider } from '../../../core/llm/types.js';
+import type { RunResult } from '../../../core/types.js';
+import type { AgentLoopCheckpoint, AgentLoopState } from './types.js';
+/**
+ * Owns agent-loop state snapshots and checkpoint conversion.
+ */
+export declare class AgentLoopCheckpointService {
+    static createFinishedState(args: {
+        runId: string;
+        goal: string;
+        model: string;
+        provider: LlmProvider;
+        workspaceRoot: string;
+        startedAt: string;
+        finishedAt: string;
+        result: RunResult;
+    }): AgentLoopState;
+    static createCheckpoint(state: AgentLoopState, options?: {
+        createdAt?: string;
+    }): AgentLoopCheckpoint;
+    static generateRunId(): string;
+    static historyFromState(state: AgentLoopState): ChatMessage[];
+    static historyFromCheckpoint(checkpoint: AgentLoopCheckpoint): ChatMessage[];
+    static resolveHistory(options: {
+        history?: ChatMessage[];
+        resumeFrom?: AgentLoopState | AgentLoopCheckpoint;
+    }): ChatMessage[] | undefined;
+    static resolveResumeMetadata(resumeFrom: AgentLoopState | AgentLoopCheckpoint | undefined): {
+        checkpointRunId: string;
+        priorTraceEvents: number;
+    } | undefined;
+}
+//# sourceMappingURL=checkpoint.d.ts.map