@origintrail-official/dkg-adapter-prime-agent 10.0.13

package/dist/session-registry.js

@@ -0,0 +1,206 @@
+/**
+ * Bridge discovery.
+ *
+ * Prime Agent loads extensions per session, into the worker process that owns
+ * that session, so each live session binds its own loopback port. There is no
+ * single well-known endpoint to point the daemon at. The extension therefore
+ * publishes a descriptor file per session and removes it on shutdown; the
+ * daemon reads the directory and picks a live bridge.
+ *
+ * The staleness problem is real: a crashed worker never removes its file, and
+ * an OS may later hand the same port to an unrelated process. Two defences:
+ *  1. `pid` is recorded and checked with signal 0 before a descriptor is used;
+ *  2. `/health` echoes its `sessionId`, so the daemon can detect a descriptor
+ *     that points at the wrong process even when the pid happens to be alive.
+ */
+import { randomUUID } from 'node:crypto';
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { isIP } from 'node:net';
+import { join } from 'node:path';
+/** A session id may become a filename, so keep it to a conservative charset. */
+const SAFE_SESSION_ID = /^[A-Za-z0-9._:-]{1,200}$/;
+// A dead-pid descriptor younger than this is never pruned: it may be a live
+// republication that landed (atomic rename, fresh mtime) between our read and
+// the rm. Mirrored in the extension's start-time prune (`extension.ts`).
+const PRUNE_MIN_AGE_MS = 30_000;
+export function isSafeSessionId(sessionId) {
+    return SAFE_SESSION_ID.test(sessionId);
+}
+export function sessionDescriptorPath(sessionsDir, sessionId) {
+    if (!isSafeSessionId(sessionId)) {
+        throw new Error(`unsafe session id: ${JSON.stringify(sessionId.slice(0, 32))}`);
+    }
+    return join(sessionsDir, `${sessionId}.json`);
+}
+/** Called by the extension when its bridge is listening. */
+export function writeSessionDescriptor(sessionsDir, descriptor) {
+    mkdirSync(sessionsDir, { recursive: true });
+    const path = sessionDescriptorPath(sessionsDir, descriptor.sessionId);
+    const temporaryPath = join(sessionsDir, `.${descriptor.sessionId}.${process.pid}.${randomUUID()}.tmp`);
+    try {
+        // Same-directory rename is atomic: readers see either the complete old
+        // descriptor or the complete new one, never a partially-written JSON file.
+        writeFileSync(temporaryPath, `${JSON.stringify(descriptor, null, 2)}\n`, {
+            mode: 0o600,
+            flag: 'wx',
+        });
+        renameSync(temporaryPath, path);
+    }
+    finally {
+        rmSync(temporaryPath, { force: true });
+    }
+    return path;
+}
+/** Called by the extension on session shutdown. Never throws. */
+export function removeSessionDescriptor(sessionsDir, sessionId) {
+    try {
+        rmSync(sessionDescriptorPath(sessionsDir, sessionId), { force: true });
+    }
+    catch {
+        /* best effort: a leftover file is pruned by the reader's pid check */
+    }
+}
+export function isProcessAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        // Signal 0 performs permission and existence checks without delivering.
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // EPERM means the process exists but belongs to another user.
+        return err?.code === 'EPERM';
+    }
+}
+function isOlderThanPruneAge(path) {
+    try {
+        return Date.now() - statSync(path).mtimeMs >= PRUNE_MIN_AGE_MS;
+    }
+    catch {
+        return false; // already gone: nothing left to prune
+    }
+}
+function parseDescriptor(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed?.sessionId !== 'string' ||
+            typeof parsed?.bridgeUrl !== 'string' ||
+            typeof parsed?.pid !== 'number' ||
+            typeof parsed?.startedAt !== 'string') {
+            return null;
+        }
+        if (!isSafeSessionId(parsed.sessionId))
+            return null;
+        if (!isLoopbackBridgeUrl(parsed.bridgeUrl))
+            return null;
+        // A bad activity stamp invalidates only itself, not the descriptor: the
+        // file still names a live bridge, ordering just falls back to startedAt.
+        if (parsed.lastActiveAt !== undefined && typeof parsed.lastActiveAt !== 'string') {
+            delete parsed.lastActiveAt;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Loopback-only, mirroring the daemon's own rule for Hermes bridge targets. A
+ * descriptor is data written by another process; treat it as untrusted input.
+ */
+export function isLoopbackBridgeUrl(value) {
+    if (!value)
+        return false;
+    try {
+        const { hostname, protocol } = new URL(value);
+        if (protocol !== 'http:' && protocol !== 'https:')
+            return false;
+        return (hostname === 'localhost' ||
+            hostname === '::1' ||
+            hostname === '[::1]' ||
+            (isIP(hostname) === 4 && hostname.startsWith('127.')));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Every descriptor currently on disk whose owning process is still alive.
+ * Stale files are pruned as a side effect so the directory cannot grow
+ * unbounded across crashes.
+ *
+ * Ordered most recently ACTIVE first, not most recently started: Prime Agent's
+ * daemon resumes sessions across terminal restarts, so a resumed session's
+ * descriptor can be newer than the fresh one the operator is actually using.
+ * Routing follows the session whose `lastActiveAt` moved last — that stamp is
+ * written per turn, so the operator's next turn settles the election.
+ */
+export function readLiveSessions(sessionsDir, opts = {}) {
+    const prune = opts.prune ?? true;
+    if (!existsSync(sessionsDir))
+        return [];
+    const live = [];
+    let entries;
+    try {
+        entries = readdirSync(sessionsDir).filter((f) => f.endsWith('.json'));
+    }
+    catch {
+        return [];
+    }
+    for (const entry of entries) {
+        const full = join(sessionsDir, entry);
+        let descriptor = null;
+        try {
+            descriptor = parseDescriptor(readFileSync(full, 'utf8'));
+        }
+        catch {
+            descriptor = null;
+        }
+        // A parse failure may be a concurrent or externally-managed write. Skip it
+        // rather than deleting a descriptor whose ownership/liveness is unknown.
+        if (!descriptor)
+            continue;
+        if (!isProcessAlive(descriptor.pid)) {
+            // A dead pid alone does not justify deleting by path: a respawned
+            // session republishes a LIVE descriptor at this exact path via atomic
+            // rename, and that rename can land between our read and the rm. Only a
+            // file old enough that no republication can explain its mtime is
+            // removed; a wrongly deleted descriptor would be republished on that
+            // session's next agent_start anyway, so the failure mode self-heals.
+            if (prune && isOlderThanPruneAge(full))
+                rmSync(full, { force: true });
+            continue;
+        }
+        live.push(descriptor);
+    }
+    // Most recently active first; startedAt is both the fallback for descriptors
+    // written before lastActiveAt existed and the tiebreak, and sessionId keeps
+    // the order total so equal stamps cannot flap between reads.
+    live.sort((a, b) => (b.lastActiveAt ?? b.startedAt).localeCompare(a.lastActiveAt ?? a.startedAt) ||
+        b.startedAt.localeCompare(a.startedAt) ||
+        a.sessionId.localeCompare(b.sessionId));
+    return live;
+}
+/**
+ * Resolve which session a request should go to.
+ * - explicit id wins, and a miss is an error rather than a silent fallback;
+ * - exactly one live session is unambiguous;
+ * - several live sessions with no id selected is ambiguous by construction, so
+ *   return the most recently active one but report it, letting the caller
+ *   surface a choice.
+ */
+export function selectSession(sessions, requestedSessionId) {
+    if (requestedSessionId) {
+        const match = sessions.find((s) => s.sessionId === requestedSessionId);
+        if (!match) {
+            return { ambiguous: false, error: `no live Prime Agent session with id ${requestedSessionId}` };
+        }
+        return { session: match, ambiguous: false };
+    }
+    if (sessions.length === 0) {
+        return { ambiguous: false, error: 'no live Prime Agent session' };
+    }
+    return { session: sessions[0], ambiguous: sessions.length > 1 };
+}
+//# sourceMappingURL=session-registry.js.map

package/dist/session-registry.js.map

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

package/dist/setup.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Setup lifecycle for the Prime Agent adapter.
+ *
+ * Prime Agent has no memory-provider slot to swap, so "election" here means
+ * registering our extension in `settings.json.extensions`. The ownership and
+ * reversal contract is copied from adapter-hermes deliberately, because it is
+ * the part that has to survive a SIGINT:
+ *
+ *   1. write setup-state.json carrying `priorSettings` (FIRST-WINS)  ← intent
+ *   2. write settings.json.bak.<unix-ms> with the original bytes      ← backup
+ *   3. rewrite settings.json adding our extension path                ← destructive
+ *
+ * An interrupt between any two steps stays recoverable: a later run reads the
+ * persisted snapshot and can restore from the captured backup even if step 3
+ * never happened.
+ *
+ * One asymmetry versus Hermes: `priorMemoryProvider` is a scalar, ours is an
+ * array the user may legitimately edit between setup and disconnect. Restore is
+ * therefore *entry removal*, never wholesale replacement — otherwise we would
+ * silently revert unrelated user edits.
+ */
+import type { PrimeAgentProfileMetadata, PrimeAgentPublishGuardPolicy, PrimeAgentRestoreRequest, PrimeAgentRestoreResult, PrimeAgentSetupPlan, PrimeAgentSetupRequest, PrimeAgentSetupResult, PrimeAgentSetupState, PrimeAgentVerifyResult } from './types.js';
+export declare const MANAGED_BY = "@origintrail-official/dkg-adapter-prime-agent";
+export declare const ADAPTER_STATE_DIRNAME = ".dkg-adapter-prime-agent";
+export declare const SETUP_STATE_FILENAME = "setup-state.json";
+export declare const ADAPTER_CONFIG_FILENAME = "dkg.json";
+export declare const DEFAULT_DAEMON_URL = "http://127.0.0.1:9200";
+export declare const DEFAULT_CONTEXT_GRAPH = "agent-context";
+export declare const DEFAULT_MEMORY_ASSERTION = "memory";
+/** Conservative by construction — see DESIGN.md §Q9. */
+export declare const DEFAULT_PUBLISH_GUARD: PrimeAgentPublishGuardPolicy;
+export interface PrimeAgentSetupOptions {
+    profileName?: string;
+    agentDir?: string;
+    memoryMode?: 'hooks' | 'tools-only';
+    daemonUrl?: string;
+    dkgHome?: string;
+    bridgeToken?: string;
+    contextGraph?: string;
+    memoryAssertion?: string;
+    preserveSettings?: boolean;
+    dryRun?: boolean;
+    /** Injectable for tests; defaults to the shipped extension file. */
+    extensionPath?: string;
+}
+/** `~/.prime/agent` unless PRIME_AGENT_CODING_AGENT_DIR overrides it. */
+export declare function resolveAgentDir(explicit?: string): string;
+/** Absolute path of the extension we register. Ships inside this package. */
+export declare function defaultExtensionPath(): string;
+export declare function resolvePrimeAgentProfile(options?: Pick<PrimeAgentSetupOptions, 'profileName' | 'agentDir' | 'memoryMode'>): PrimeAgentProfileMetadata;
+interface PrimeSettings {
+    extensions?: string[];
+    [k: string]: unknown;
+}
+/** Resolve the same daemon credential used by the daemon-side channel route. */
+export declare function loadDkgAuthToken(dkgHome?: string): string | undefined;
+export declare function readSettings(settingsPath: string): PrimeSettings;
+export declare function readSetupState(profile: PrimeAgentProfileMetadata): PrimeAgentSetupState | undefined;
+/** Non-destructive: computes what setup would do. */
+export declare function planPrimeAgentSetup(options?: PrimeAgentSetupOptions): PrimeAgentSetupPlan;
+/**
+ * The destructive half. Ordering is the contract; see the module comment.
+ */
+export declare function setupPrimeAgentProfile(options?: PrimeAgentSetupOptions): PrimeAgentSetupPlan;
+/**
+ * Restore: surgical first (remove exactly our entry, leave unrelated user edits
+ * intact), backup-rename as fallback, then VERIFY the entry is really gone.
+ */
+export declare function restorePrimeAgentProfile(req?: PrimeAgentRestoreRequest): PrimeAgentRestoreResult;
+export declare function disconnectPrimeAgentProfile(options?: PrimeAgentSetupOptions): PrimeAgentSetupPlan;
+export declare function verifyPrimeAgentProfile(options?: PrimeAgentSetupOptions): PrimeAgentVerifyResult;
+/** Canonical orchestrator, mirroring runHermesSetup's role. */
+export declare function runPrimeAgentSetup(req?: PrimeAgentSetupRequest): Promise<PrimeAgentSetupResult>;
+export declare function runSetup(options?: PrimeAgentSetupRequest): Promise<void>;
+export declare function runVerify(options?: PrimeAgentSetupOptions): Promise<void>;
+export declare function runStatus(options?: PrimeAgentSetupOptions): Promise<void>;
+export declare function runDoctor(options?: PrimeAgentSetupOptions): Promise<void>;
+export declare function runDisconnect(options?: PrimeAgentSetupOptions): Promise<void>;
+export declare function runReconnect(options?: PrimeAgentSetupOptions): Promise<void>;
+export declare function runUninstall(options?: PrimeAgentSetupOptions): Promise<void>;
+export declare const setup: typeof runSetup;
+export declare const verify: typeof runVerify;
+export declare const status: typeof runStatus;
+export declare const doctor: typeof runDoctor;
+export declare const disconnect: typeof runDisconnect;
+export declare const reconnect: typeof runReconnect;
+export declare const uninstall: typeof runUninstall;
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

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