@agent-wire/terminal 1.6.0

package/dist/local-pull.js

@@ -0,0 +1,173 @@
+import { mkdir, readFile, writeFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { homedir } from 'os';
+import { dirname, isAbsolute, resolve } from 'path';
+export function defaultLocalPullManifestPath() {
+    return resolve(homedir(), '.wire-node', 'sync-manifest.json');
+}
+function expandHomePath(path) {
+    if (path === '~')
+        return homedir();
+    if (path.startsWith('~/') || path.startsWith('~\\'))
+        return resolve(homedir(), path.slice(2));
+    return path;
+}
+function normalizeTarget(path) {
+    return resolve(expandHomePath(path));
+}
+function nonEmptyString(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+export async function loadLocalPullManifest(manifestPath) {
+    const path = normalizeTarget(manifestPath || defaultLocalPullManifestPath());
+    const raw = await readFile(path, 'utf-8');
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed.subscriptions)) {
+        throw new Error('Invalid local-sync manifest: subscriptions must be an array');
+    }
+    for (const [index, sub] of parsed.subscriptions.entries()) {
+        if (!nonEmptyString(sub.handle_path)) {
+            throw new Error(`Invalid local-sync manifest: subscriptions[${index}].handle_path is required`);
+        }
+        if (!Array.isArray(sub.local_targets) || sub.local_targets.length === 0) {
+            throw new Error(`Invalid local-sync manifest: subscriptions[${index}].local_targets must be a non-empty array`);
+        }
+    }
+    return { path, manifest: { ...parsed, state: parsed.state || {} } };
+}
+export async function writeDefaultLocalPullManifest(manifestPath) {
+    const path = normalizeTarget(manifestPath || defaultLocalPullManifestPath());
+    if (existsSync(path))
+        return path;
+    const manifest = {
+        subscriptions: [
+            {
+                handle_path: 'playful/128/240',
+                follow_supersessions: true,
+                local_targets: ['~/.wire-node/cache/operating-dictionary.md'],
+            },
+            {
+                handle_path: 'playful/128/242',
+                follow_supersessions: true,
+                local_targets: ['~/.wire-node/cache/onboarding-kit.md'],
+            },
+            {
+                handle_path: 'playful/128/245',
+                follow_supersessions: true,
+                local_targets: ['~/.wire-node/cache/standard-ops-kit.md'],
+            },
+            {
+                handle_path: 'playful/117/45',
+                follow_supersessions: true,
+                local_targets: ['~/.wire-node/cache/fleet-ops-kit.md'],
+            },
+        ],
+        state: {},
+    };
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, JSON.stringify(manifest, null, 2), 'utf-8');
+    return path;
+}
+async function readExisting(path) {
+    try {
+        return await readFile(path, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+function contributionBody(result) {
+    return nonEmptyString(result.body)
+        ?? nonEmptyString(result.content)
+        ?? nonEmptyString(result.text)
+        ?? '';
+}
+export async function pullLocalSubscriptions(api, options) {
+    if (options?.init) {
+        await writeDefaultLocalPullManifest(options.manifestPath);
+    }
+    const { path, manifest } = await loadLocalPullManifest(options?.manifestPath);
+    const state = manifest.state || {};
+    const results = [];
+    for (const sub of manifest.subscriptions) {
+        const result = {
+            handle_path: sub.handle_path,
+            resolved_handle_path: null,
+            title: 'Untitled',
+            targets: [],
+            changed: false,
+        };
+        try {
+            const contribution = await api.accessContribution(sub.handle_path);
+            const resolvedHandlePath = nonEmptyString(contribution.handle_path) ?? sub.handle_path;
+            const title = nonEmptyString(contribution.title) ?? 'Untitled';
+            const body = contributionBody(contribution);
+            result.resolved_handle_path = resolvedHandlePath;
+            result.title = title;
+            if (!body) {
+                result.error = 'Contribution response did not include body/content/text';
+                results.push(result);
+                continue;
+            }
+            for (const target of sub.local_targets) {
+                const targetPath = normalizeTarget(target);
+                if (!isAbsolute(targetPath)) {
+                    result.targets.push({ path: target, status: 'skipped', error: 'Target path did not resolve to an absolute path' });
+                    continue;
+                }
+                const existing = await readExisting(targetPath);
+                if (existing === body) {
+                    result.targets.push({ path: targetPath, status: 'unchanged' });
+                    continue;
+                }
+                result.changed = true;
+                if (options?.dryRun) {
+                    result.targets.push({ path: targetPath, status: 'skipped' });
+                    continue;
+                }
+                await mkdir(dirname(targetPath), { recursive: true });
+                await writeFile(targetPath, body, 'utf-8');
+                result.targets.push({ path: targetPath, status: 'written' });
+            }
+            state[sub.handle_path] = {
+                last_handle_path: resolvedHandlePath,
+                last_title: title,
+                last_synced_at: new Date().toISOString(),
+            };
+        }
+        catch (err) {
+            result.error = err instanceof Error ? err.message : String(err);
+        }
+        results.push(result);
+    }
+    if (!options?.dryRun) {
+        await writeFile(path, JSON.stringify({ ...manifest, state }, null, 2), 'utf-8');
+    }
+    return {
+        manifest_path: path,
+        pulled: results.filter((r) => !r.error && r.changed).length,
+        unchanged: results.filter((r) => !r.error && !r.changed).length,
+        failed: results.filter((r) => r.error || r.targets.some((t) => t.error)).length,
+        results,
+    };
+}
+export function formatLocalPullReport(report) {
+    const lines = [`Wire local pull: ${report.manifest_path}`];
+    for (const result of report.results) {
+        if (result.error) {
+            lines.push(`  x ${result.handle_path}: ${result.error}`);
+            continue;
+        }
+        const advanced = result.resolved_handle_path && result.resolved_handle_path !== result.handle_path
+            ? ` -> ${result.resolved_handle_path}`
+            : '';
+        lines.push(`  ${result.changed ? '->' : '✓'} ${result.handle_path}${advanced} (${result.title})`);
+        for (const target of result.targets) {
+            const suffix = target.error ? `: ${target.error}` : '';
+            lines.push(`     ${target.status} ${target.path}${suffix}`);
+        }
+    }
+    lines.push(`Pulled ${report.pulled}; unchanged ${report.unchanged}; failed ${report.failed}.`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=local-pull.js.map

package/dist/local-pull.js.map

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

package/dist/lockfile.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Attempt to acquire the daemon lock. Writes this process's PID.
+ * Returns true if acquired, false if another live process holds it.
+ * Cleans up stale lockfiles (dead PIDs) automatically.
+ */
+export declare function acquireLock(): boolean;
+/**
+ * Release the daemon lock. Call on SIGINT/SIGTERM.
+ */
+export declare function releaseLock(): void;
+/**
+ * Check if a background worker daemon is already running.
+ * Returns the PID if running, null otherwise.
+ * Cleans up stale lockfiles automatically.
+ */
+export declare function isWorkerRunning(): number | null;

package/dist/lockfile.js

@@ -0,0 +1,78 @@
+import { readFileSync, writeFileSync, unlinkSync, existsSync } from 'fs';
+import { join } from 'path';
+import { CONFIG_DIR } from './config.js';
+const LOCK_PATH = join(CONFIG_DIR, 'daemon.lock');
+/**
+ * Attempt to acquire the daemon lock. Writes this process's PID.
+ * Returns true if acquired, false if another live process holds it.
+ * Cleans up stale lockfiles (dead PIDs) automatically.
+ */
+export function acquireLock() {
+    if (existsSync(LOCK_PATH)) {
+        const existingPid = readLockPid();
+        if (existingPid !== null && isProcessAlive(existingPid)) {
+            return false; // Lock held by a live process
+        }
+        // Stale lockfile — clean up
+        try {
+            unlinkSync(LOCK_PATH);
+        }
+        catch { /* ignore */ }
+    }
+    writeFileSync(LOCK_PATH, String(process.pid), 'utf-8');
+    return true;
+}
+/**
+ * Release the daemon lock. Call on SIGINT/SIGTERM.
+ */
+export function releaseLock() {
+    try {
+        // Only remove if we own it
+        const pid = readLockPid();
+        if (pid === process.pid) {
+            unlinkSync(LOCK_PATH);
+        }
+    }
+    catch { /* ignore — file may already be gone */ }
+}
+/**
+ * Check if a background worker daemon is already running.
+ * Returns the PID if running, null otherwise.
+ * Cleans up stale lockfiles automatically.
+ */
+export function isWorkerRunning() {
+    if (!existsSync(LOCK_PATH))
+        return null;
+    const pid = readLockPid();
+    if (pid === null)
+        return null;
+    if (isProcessAlive(pid)) {
+        return pid;
+    }
+    // Stale lockfile — clean up
+    try {
+        unlinkSync(LOCK_PATH);
+    }
+    catch { /* ignore */ }
+    return null;
+}
+function readLockPid() {
+    try {
+        const content = readFileSync(LOCK_PATH, 'utf-8').trim();
+        const pid = parseInt(content, 10);
+        return isNaN(pid) ? null : pid;
+    }
+    catch {
+        return null;
+    }
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0); // Signal 0 = check if process exists
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=lockfile.js.map

package/dist/lockfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockfile.js","sourceRoot":"","sources":["../src/lockfile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACzE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAElD;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,MAAM,WAAW,GAAG,WAAW,EAAE,CAAC;QAClC,IAAI,WAAW,KAAK,IAAI,IAAI,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;YACxD,OAAO,KAAK,CAAC,CAAC,8BAA8B;QAC9C,CAAC;QACD,4BAA4B;QAC5B,IAAI,CAAC;YAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IACvD,CAAC;IAED,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC;QACH,2BAA2B;QAC3B,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;QAC1B,IAAI,GAAG,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC;YACxB,UAAU,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,uCAAuC,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAExC,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;IAC1B,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAE9B,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC;QAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACxD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,qCAAqC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,43 @@
+interface SubstrateSurfaceConfig {
+    surface: string;
+    toolName: string;
+    canonicalPath: string;
+    aliasPath: string;
+    method: string;
+    configHandle?: string;
+    title?: string;
+}
+interface SurfaceConfigWireItem {
+    type?: string;
+    title?: string;
+    handle_path?: string;
+    structured_data?: Record<string, unknown>;
+}
+declare function normalizeSurfaceName(name: string): string;
+declare function surfaceToolName(surface: string): string;
+declare function parseSurfaceConfig(item: SurfaceConfigWireItem): SubstrateSurfaceConfig | null;
+declare function dedupeSurfaces(surfaces: SubstrateSurfaceConfig[]): SubstrateSurfaceConfig[];
+declare function normalizeApiRootPath(path: string): string;
+declare function fingerprintSubstrateSurfaces(surfaces: SubstrateSurfaceConfig[]): string;
+declare function parseToolRefreshPollIntervalMs(items: SurfaceConfigWireItem[]): {
+    pollIntervalMs: number;
+    source: string;
+    handle?: string;
+};
+export declare const __mcpSurfaceTestInternals: {
+    normalizeSurfaceName: typeof normalizeSurfaceName;
+    surfaceToolName: typeof surfaceToolName;
+    parseSurfaceConfig: typeof parseSurfaceConfig;
+    dedupeSurfaces: typeof dedupeSurfaces;
+    normalizeApiRootPath: typeof normalizeApiRootPath;
+    SURFACE_REFRESH_TTL_MS: number;
+    fingerprintSubstrateSurfaces: typeof fingerprintSubstrateSurfaces;
+    parseToolRefreshPollIntervalMs: typeof parseToolRefreshPollIntervalMs;
+};
+export interface McpServerOptions {
+    noWorker?: boolean;
+    transport?: 'stdio' | 'http';
+    port?: number;
+}
+export declare function startMcpServer(options?: McpServerOptions): Promise<void>;
+export {};