@xenosystem/agent-interface-host 0.1.3

package/dist/localHostLease.js

@@ -0,0 +1,167 @@
+import { open, mkdir, rm, unlink } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { randomBytes } from 'node:crypto';
+import { DEFAULT_LEASE_STALE_AFTER_MS, confirmLeaseOwnerGone, defaultProcessAlive, isLeaseOwnerGone, isNodeError, parseLeaseRecord, publicDescriptor, readLeaseRecord, } from '@xenosystem/agent-interface-client/local';
+/**
+ * Exclusive, per-user authority lease. The lock record doubles as local
+ * transport discovery; its bearer token is returned only to the lease owner.
+ */
+export class LocalAgentHostLease {
+    path;
+    record;
+    now;
+    released = false;
+    constructor(path, record, now) {
+        this.path = path;
+        this.record = record;
+        this.now = now;
+    }
+    get descriptor() {
+        return publicDescriptor(this.record);
+    }
+    get transportToken() {
+        if (this.released)
+            throw new Error('The Agent host lease is no longer active.');
+        return this.record.transportToken;
+    }
+    async heartbeat() {
+        this.assertActive();
+        const handle = await open(this.path, 'r+');
+        try {
+            const current = parseLeaseRecord(await handle.readFile({ encoding: 'utf8' }));
+            if (current.transportToken !== this.record.transportToken) {
+                this.released = true;
+                throw new Error('The Agent host authority lease was replaced by another process.');
+            }
+            this.record.heartbeatAt = this.now();
+            await handle.truncate(0);
+            await handle.write(`${JSON.stringify(this.record)}\n`, 0, 'utf8');
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        const verified = await readLeaseRecord(this.path);
+        if (verified.transportToken !== this.record.transportToken) {
+            this.released = true;
+            throw new Error('The Agent host authority lease was lost while heartbeating.');
+        }
+        return this.descriptor;
+    }
+    async release() {
+        if (this.released)
+            return false;
+        this.released = true;
+        let current;
+        try {
+            current = await readLeaseRecord(this.path);
+        }
+        catch (error) {
+            if (isNodeError(error, 'ENOENT'))
+                return false;
+            throw error;
+        }
+        if (current.transportToken !== this.record.transportToken)
+            return false;
+        try {
+            await unlink(this.path);
+            return true;
+        }
+        catch (error) {
+            if (isNodeError(error, 'ENOENT'))
+                return false;
+            throw error;
+        }
+    }
+    assertActive() {
+        if (this.released)
+            throw new Error('The Agent host lease is no longer active.');
+    }
+}
+export async function acquireLocalAgentHostLease(options) {
+    if (!options.rootDirectory.trim())
+        throw new Error('Agent host lease rootDirectory is required.');
+    if (!options.instanceId.trim())
+        throw new Error('Agent host lease instanceId is required.');
+    if (!options.endpoint.trim())
+        throw new Error('Agent host lease endpoint is required.');
+    if (!Number.isInteger(options.protocolVersion) || options.protocolVersion <= 0) {
+        throw new Error('Agent host lease protocolVersion must be a positive integer.');
+    }
+    const now = options.now || Date.now;
+    const pid = options.pid ?? process.pid;
+    const isProcessAlive = options.isProcessAlive || defaultProcessAlive;
+    const probeEndpoint = options.probeEndpoint;
+    const staleAfterMs = options.staleAfterMs;
+    await mkdir(options.rootDirectory, { recursive: true });
+    const path = join(options.rootDirectory, 'agent-host.lock');
+    for (let attempt = 0; attempt < 3; attempt += 1) {
+        const at = now();
+        const record = {
+            schemaVersion: 1,
+            instanceId: options.instanceId,
+            pid,
+            endpoint: options.endpoint,
+            protocolVersion: options.protocolVersion,
+            acquiredAt: at,
+            heartbeatAt: at,
+            transportToken: randomBytes(32).toString('base64url'),
+        };
+        try {
+            const handle = await open(path, 'wx', 0o600);
+            try {
+                await handle.writeFile(`${JSON.stringify(record)}\n`, { encoding: 'utf8' });
+                await handle.sync();
+            }
+            finally {
+                await handle.close();
+            }
+            return { acquired: true, lease: new LocalAgentHostLease(path, record, now) };
+        }
+        catch (error) {
+            if (!isNodeError(error, 'EEXIST'))
+                throw error;
+        }
+        let owner;
+        try {
+            owner = await readLeaseRecord(path);
+        }
+        catch (error) {
+            if (isNodeError(error, 'ENOENT'))
+                continue;
+            throw error;
+        }
+        // The SHARED rule — see `confirmLeaseOwnerGone`. Restating it here is how the
+        // two callers would come to disagree about whether a host is alive.
+        //
+        // 🔴 CONFIRMED, not inferred. The pure rule treats a live pid as proof the owner lives,
+        // and pids are recycled: a crashed host whose pid was later reused would wedge this
+        // FOREVER — every future host refusing to start, with no way out but a human deleting
+        // the lock file. The confirming form probes the endpoint when the cheap rule is
+        // ambiguous, because "does anything answer" is the property we actually care about and
+        // "does some process have that number" never was.
+        const stale = await confirmLeaseOwnerGone({
+            heartbeatAt: owner.heartbeatAt,
+            pid: owner.pid,
+            endpoint: owner.endpoint,
+            at,
+            ...(staleAfterMs === undefined ? {} : { staleAfterMs }),
+            isProcessAlive,
+            ...(probeEndpoint ? { probeEndpoint } : {}),
+        });
+        if (!stale)
+            return { acquired: false, owner: publicDescriptor(owner) };
+        try {
+            await unlink(path);
+        }
+        catch (error) {
+            if (!isNodeError(error, 'ENOENT'))
+                throw error;
+        }
+    }
+    const owner = await readLeaseRecord(path);
+    return { acquired: false, owner: publicDescriptor(owner) };
+}
+// Re-exported so existing importers of this module are unaffected by the extraction.
+export { DEFAULT_LEASE_STALE_AFTER_MS, isLeaseOwnerGone, inspectLocalAgentHostLease, readLocalAgentHostLeaseConnection, } from '@xenosystem/agent-interface-client/local';
+//# sourceMappingURL=localHostLease.js.map

package/dist/localHostLease.js.map

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

package/dist/localHostPaths.d.ts

@@ -0,0 +1,30 @@
+export interface ResolveLocalAgentHostPathsOptions {
+    homeDirectory: string;
+    hostRootDirectory?: string;
+    acpRegistryRootDirectory?: string;
+}
+export interface LocalAgentHostPaths {
+    userXenoRoot: string;
+    hostRootDirectory: string;
+    stateRepositoryRoot: string;
+    stateDatabaseFile: string;
+    stateBackupsDirectory: string;
+    stateReportsDirectory: string;
+    stateMigrationLockFile: string;
+    workspaceFile: string;
+    conversationsDirectory: string;
+    runtimeEventsDirectory: string;
+    workspaceAuthorityRoot: string;
+    acpRegistryRootDirectory: string;
+    managedConversationRoot: string;
+    layout: 'target-sqlite' | 'isolated-host';
+}
+/**
+ * Resolves one deterministic data layout for every surface that can launch the
+ * per-user Agent host. The stable lease/RPC root remains versioned so an older
+ * Hub and the standalone app cannot elect competing owners during rollout.
+ * Transactional state uses the product-owned ~/.xeno/agent root. An explicit
+ * host root produces a fully isolated layout for tests and development profiles.
+ */
+export declare function resolveLocalAgentHostPaths(options: ResolveLocalAgentHostPathsOptions): LocalAgentHostPaths;
+//# sourceMappingURL=localHostPaths.d.ts.map

package/dist/localHostPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localHostPaths.d.ts","sourceRoot":"","sources":["../src/localHostPaths.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iCAAiC;IAChD,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;IACzB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,iBAAiB,EAAE,MAAM,CAAA;IACzB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,sBAAsB,EAAE,MAAM,CAAA;IAC9B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,wBAAwB,EAAE,MAAM,CAAA;IAChC,uBAAuB,EAAE,MAAM,CAAA;IAC/B,MAAM,EAAE,eAAe,GAAG,eAAe,CAAA;CAC1C;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,iCAAiC,GACzC,mBAAmB,CAyCrB"}

package/dist/localHostPaths.js

@@ -0,0 +1,60 @@
+import { join, resolve } from 'node:path';
+import { resolveLocalAgentHostRoot } from '@xenosystem/agent-interface-client/local';
+/**
+ * Resolves one deterministic data layout for every surface that can launch the
+ * per-user Agent host. The stable lease/RPC root remains versioned so an older
+ * Hub and the standalone app cannot elect competing owners during rollout.
+ * Transactional state uses the product-owned ~/.xeno/agent root. An explicit
+ * host root produces a fully isolated layout for tests and development profiles.
+ */
+export function resolveLocalAgentHostPaths(options) {
+    const homeDirectory = requiredPath(options.homeDirectory, 'homeDirectory');
+    const userXenoRoot = resolve(homeDirectory, '.xeno');
+    const explicitHostRoot = optionalPath(options.hostRootDirectory);
+    // 🔴 DERIVED, never restated. A surface (the CLI as a `headless-client`, Spawn next) can
+    // only import the published client, so the lease root is defined THERE and imported here.
+    // Two copies of this join would diverge silently: attach would return `no-host` forever,
+    // which is indistinguishable from "the host is not running".
+    const hostRootDirectory = resolveLocalAgentHostRoot({
+        homeDirectory,
+        ...(explicitHostRoot ? { hostRootDirectory: explicitHostRoot } : {}),
+    });
+    const isolated = Boolean(explicitHostRoot);
+    const stateRepositoryRoot = isolated
+        ? join(hostRootDirectory, 'state')
+        : join(userXenoRoot, 'agent');
+    const acpRegistryRootDirectory = optionalPath(options.acpRegistryRootDirectory)
+        || (isolated ? join(hostRootDirectory, 'acp-registry') : userXenoRoot);
+    return {
+        userXenoRoot,
+        hostRootDirectory,
+        stateRepositoryRoot,
+        stateDatabaseFile: join(stateRepositoryRoot, 'state.sqlite'),
+        stateBackupsDirectory: join(stateRepositoryRoot, 'backups'),
+        stateReportsDirectory: join(stateRepositoryRoot, 'reports'),
+        stateMigrationLockFile: join(stateRepositoryRoot, 'migration.lock'),
+        workspaceFile: isolated
+            ? join(stateRepositoryRoot, 'workspaces.json')
+            : join(userXenoRoot, 'workspaces.json'),
+        conversationsDirectory: isolated
+            ? join(stateRepositoryRoot, 'conversations')
+            : join(userXenoRoot, 'agent-chats'),
+        runtimeEventsDirectory: isolated
+            ? join(hostRootDirectory, 'runtime-events')
+            : join(userXenoRoot, 'runtime-events'),
+        workspaceAuthorityRoot: join(hostRootDirectory, 'workspace'),
+        acpRegistryRootDirectory,
+        managedConversationRoot: join(acpRegistryRootDirectory, 'acp-chat-workspaces'),
+        layout: isolated ? 'isolated-host' : 'target-sqlite',
+    };
+}
+function requiredPath(value, field) {
+    const cleaned = optionalPath(value);
+    if (!cleaned)
+        throw new Error(`Agent host ${field} is required.`);
+    return cleaned;
+}
+function optionalPath(value) {
+    return typeof value === 'string' && value.trim() ? resolve(value.trim()) : undefined;
+}
+//# sourceMappingURL=localHostPaths.js.map

package/dist/localHostPaths.js.map

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

package/dist/localRpcTransport.d.ts

@@ -0,0 +1,21 @@
+import { type LocalAgentHostRpcServerOptions } from '@xenosystem/agent-interface-client/local';
+export declare class LocalAgentHostRpcServer {
+    private readonly transport;
+    private readonly endpoint;
+    private readonly transportToken;
+    private readonly handshakeTimeoutMs;
+    /** Sockets accepted but not yet authenticated, oldest first (insertion order). */
+    private readonly pending;
+    private readonly protocolVersion;
+    private readonly maxFrameBytes;
+    private readonly removeStaleEndpoint;
+    private readonly sockets;
+    private server;
+    constructor(options: LocalAgentHostRpcServerOptions);
+    get listening(): boolean;
+    start(): Promise<void>;
+    close(): Promise<void>;
+    private accept;
+}
+export { LocalAgentHostRpcClientTransport, resolveLocalAgentHostEndpoint, LOCAL_AGENT_HOST_DEFAULT_MAX_FRAME_BYTES, LOCAL_AGENT_HOST_ABSOLUTE_MAX_FRAME_BYTES, } from '@xenosystem/agent-interface-client/local';
+//# sourceMappingURL=localRpcTransport.d.ts.map

package/dist/localRpcTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localRpcTransport.d.ts","sourceRoot":"","sources":["../src/localRpcTransport.ts"],"names":[],"mappings":"AAkBA,OAAO,EAUL,KAAK,8BAA8B,EAIpC,MAAM,0CAA0C,CAAA;AAmDjD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAQ;IAC3C,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,MAAM,CAAsB;gBAExB,OAAO,EAAE,8BAA8B;IAYnD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiCtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B,OAAO,CAAC,MAAM;CA0Hf;AA8KD,OAAO,EACL,gCAAgC,EAChC,6BAA6B,EAC7B,wCAAwC,EACxC,yCAAyC,GAC1C,MAAM,0CAA0C,CAAA"}