@phigon/observer 8.0.1

package/dist/src/custom-agent-registry.js

@@ -0,0 +1,288 @@
+import { randomUUID } from "node:crypto";
+import { chmod, mkdir, readFile, rename, unlink, writeFile, } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, isAbsolute, join, relative, resolve, sep, } from "node:path";
+const registryVersion = 1;
+const maxRegistrations = 128;
+const maxRegistryBytes = 1 << 20;
+const idPattern = /^[a-z0-9][a-z0-9-]{0,62}$/u;
+const namePattern = /^[A-Za-z0-9][A-Za-z0-9._+-]{0,127}$/u;
+const capabilityPattern = /^[a-z0-9][a-z0-9:._+-]{0,63}$/u;
+const reservedCapabilities = new Set([
+    "native-activity",
+    "process-instance",
+    "source-isolated",
+    "unattributed",
+]);
+const reservedCapabilityPrefixes = ["agent-product:", "process-key:"];
+export class CustomAgentRegistry {
+    #dataDirectory;
+    #path;
+    constructor(dataDirectory) {
+        this.#dataDirectory = dataDirectory;
+        this.#path = join(dataDirectory, "custom-agents.json");
+    }
+    async list() {
+        let raw;
+        try {
+            raw = await readFile(this.#path, "utf8");
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code === "ENOENT")
+                return [];
+            throw error;
+        }
+        if (Buffer.byteLength(raw, "utf8") > maxRegistryBytes) {
+            throw new Error("Custom agent registry exceeds the 1 MiB safety limit.");
+        }
+        let value;
+        try {
+            value = JSON.parse(raw);
+        }
+        catch {
+            throw new Error("Custom agent registry is not valid JSON.");
+        }
+        if (typeof value !== "object" ||
+            value === null ||
+            !("version" in value) ||
+            value.version !== registryVersion ||
+            !("agents" in value) ||
+            !Array.isArray(value.agents) ||
+            value.agents.length > maxRegistrations) {
+            throw new Error("Custom agent registry is invalid.");
+        }
+        const agents = value.agents.map(validatedRegistration);
+        const ids = new Set(agents.map((agent) => agent.id));
+        if (ids.size !== agents.length) {
+            throw new Error("Custom agent registry contains duplicate IDs.");
+        }
+        validateClaimConflicts(agents);
+        return agents.sort((left, right) => left.id.localeCompare(right.id));
+    }
+    async add(value) {
+        const registration = validatedRegistration(value);
+        const existing = await this.list();
+        if (existing.some((agent) => agent.id === registration.id)) {
+            throw new Error(`Custom agent ${registration.id} already exists; remove it before replacing its monitoring definition.`);
+        }
+        if (existing.length >= maxRegistrations) {
+            throw new Error(`Custom agent registry is limited to ${maxRegistrations} agents.`);
+        }
+        const agents = [...existing, registration];
+        validateClaimConflicts(agents);
+        await this.#save(agents);
+        return registration;
+    }
+    async remove(id) {
+        const normalizedID = validatedID(id);
+        const existing = await this.list();
+        const removed = existing.find((agent) => agent.id === normalizedID);
+        if (removed === undefined)
+            return undefined;
+        await this.#save(existing.filter((agent) => agent.id !== normalizedID));
+        return removed;
+    }
+    async #save(agents) {
+        await mkdir(this.#dataDirectory, { recursive: true, mode: 0o700 });
+        await chmod(this.#dataDirectory, 0o700);
+        const temporary = `${this.#path}.${process.pid}.${randomUUID()}.tmp`;
+        const registry = {
+            version: registryVersion,
+            agents: [...agents].sort((left, right) => left.id.localeCompare(right.id)),
+        };
+        try {
+            await writeFile(temporary, `${JSON.stringify(registry, null, 2)}\n`, {
+                encoding: "utf8",
+                flag: "wx",
+                mode: 0o600,
+            });
+            await rename(temporary, this.#path);
+            await chmod(this.#path, 0o600);
+        }
+        catch (error) {
+            try {
+                await unlink(temporary);
+            }
+            catch {
+                // The temporary file may not have been created.
+            }
+            throw error;
+        }
+    }
+}
+export function customAgentRegistration(value) {
+    return validatedRegistration({
+        id: value.id,
+        displayName: value.displayName,
+        executableNames: value.executableNames ?? [],
+        processNames: value.processNames ?? [],
+        configurationPaths: value.configurationPaths ?? [],
+        activityDirectories: value.activityDirectories ?? [],
+        capabilities: value.capabilities ?? ["activity"],
+    });
+}
+function validatedRegistration(value) {
+    if (typeof value !== "object" || value === null) {
+        throw new Error("Custom agent registration is invalid.");
+    }
+    const object = value;
+    const id = validatedID(object["id"]);
+    const displayName = validatedDisplayName(object["displayName"]);
+    const executableNames = validatedList(object["executableNames"], "executable name", namePattern);
+    const processNames = validatedList(object["processNames"], "process name", namePattern);
+    const configurationPaths = validatedPaths(object["configurationPaths"], "configuration path");
+    const activityDirectories = validatedPaths(object["activityDirectories"], "activity directory", true);
+    const capabilities = validatedList(object["capabilities"], "capability", capabilityPattern);
+    if (capabilities.some(isReservedCapability)) {
+        throw new Error("Custom agent capabilities cannot claim Phigon-managed identity or evidence properties.");
+    }
+    if (executableNames.length === 0 &&
+        processNames.length === 0 &&
+        configurationPaths.length === 0 &&
+        activityDirectories.length === 0) {
+        throw new Error("Custom agent requires at least one executable, process, configuration path, or activity directory.");
+    }
+    return Object.freeze({
+        id,
+        displayName,
+        executableNames,
+        processNames,
+        configurationPaths,
+        activityDirectories,
+        capabilities: capabilities.length === 0 ? ["activity"] : capabilities,
+    });
+}
+function isReservedCapability(value) {
+    return reservedCapabilities.has(value) ||
+        reservedCapabilityPrefixes.some((prefix) => value.startsWith(prefix));
+}
+function validatedID(value) {
+    if (typeof value !== "string" || !idPattern.test(value)) {
+        throw new Error("Custom agent ID must use 1-63 lowercase letters, digits, or hyphens.");
+    }
+    return value;
+}
+function validatedDisplayName(value) {
+    if (typeof value !== "string" ||
+        value !== value.trim() ||
+        value.length === 0 ||
+        Buffer.byteLength(value, "utf8") > 128 ||
+        /[\u0000-\u001f\u007f]/u.test(value)) {
+        throw new Error("Custom agent display name must be 1-128 printable characters.");
+    }
+    return value;
+}
+function validatedList(value, label, pattern) {
+    if (!Array.isArray(value) || value.length > 32) {
+        throw new Error(`Custom agent ${label} list is invalid.`);
+    }
+    const result = value.map((entry) => {
+        if (typeof entry !== "string" || !pattern.test(entry)) {
+            throw new Error(`Custom agent ${label} is invalid.`);
+        }
+        return entry;
+    });
+    return [...new Set(result)].sort();
+}
+function validatedPaths(value, label, scopedDirectory = false) {
+    if (!Array.isArray(value) || value.length > 32) {
+        throw new Error(`Custom agent ${label} list is invalid.`);
+    }
+    const result = value.map((entry) => {
+        if (typeof entry !== "string" ||
+            entry !== entry.trim() ||
+            entry.length === 0 ||
+            Buffer.byteLength(entry, "utf8") > 1024 ||
+            /[\u0000-\u001f\u007f]/u.test(entry)) {
+            throw new Error(`Custom agent ${label} is invalid.`);
+        }
+        const normalized = normalizedRegistrationPath(entry);
+        if (scopedDirectory &&
+            (dirname(normalized) === normalized ||
+                normalized === normalizedRegistrationPath("~"))) {
+            throw new Error("Custom agent activity directory must be scoped below the filesystem root and home directory.");
+        }
+        return entry;
+    });
+    return [...new Set(result)].sort();
+}
+function validateClaimConflicts(agents) {
+    validateNamedClaims(agents, "executableNames", "executable name");
+    validateNamedClaims(agents, "processNames", "process name");
+    validateExactPathClaims(agents, "configurationPaths", "configuration path");
+    validateActivityDirectoryClaims(agents);
+}
+function validateNamedClaims(agents, property, label) {
+    const owners = new Map();
+    for (const agent of agents) {
+        for (const claim of agent[property]) {
+            const normalized = claim.toLowerCase().replace(/\.exe$/u, "");
+            const owner = owners.get(normalized);
+            if (owner !== undefined) {
+                throw conflictingClaimError(label, claim, owner, agent.id);
+            }
+            owners.set(normalized, agent.id);
+        }
+    }
+}
+function validateExactPathClaims(agents, property, label) {
+    const owners = new Map();
+    for (const agent of agents) {
+        for (const path of agent[property]) {
+            const normalized = normalizedRegistrationPath(path);
+            const owner = owners.get(normalized);
+            if (owner !== undefined) {
+                throw conflictingClaimError(label, path, owner, agent.id);
+            }
+            owners.set(normalized, agent.id);
+        }
+    }
+}
+function validateActivityDirectoryClaims(agents) {
+    const claims = [];
+    for (const agent of agents) {
+        for (const path of agent.activityDirectories) {
+            const normalized = normalizedRegistrationPath(path);
+            const overlap = claims.find((claim) => pathsOverlap(claim.normalized, normalized));
+            if (overlap !== undefined) {
+                throw conflictingClaimError("activity directory", path, overlap.id, agent.id);
+            }
+            claims.push({ id: agent.id, path, normalized });
+        }
+    }
+}
+function normalizedRegistrationPath(value) {
+    let expanded = value;
+    if (value === "~")
+        expanded = homedir();
+    else if (value.startsWith("~/") || value.startsWith("~\\")) {
+        expanded = join(homedir(), value.slice(2));
+    }
+    else if (value.startsWith("~")) {
+        throw new Error("Custom agent paths must be absolute or begin with ~/ for the current user's home directory.");
+    }
+    if (!isAbsolute(expanded)) {
+        throw new Error("Custom agent paths must be absolute or begin with ~/ for the current user's home directory.");
+    }
+    const normalized = resolve(expanded).normalize("NFC");
+    return process.platform === "win32" || process.platform === "darwin"
+        ? normalized.toLowerCase()
+        : normalized;
+}
+function pathsOverlap(left, right) {
+    return isWithin(left, right) || isWithin(right, left);
+}
+function isWithin(root, candidate) {
+    const path = relative(root, candidate);
+    return path === "" || (!path.startsWith(`..${sep}`) && path !== "..");
+}
+function conflictingClaimError(label, value, leftID, rightID) {
+    const ownership = leftID === rightID
+        ? `within ${leftID}`
+        : `between ${leftID} and ${rightID}`;
+    return new Error(`Custom agent ${label} ${JSON.stringify(value)} is ambiguous ${ownership}; monitoring definitions must use independent evidence.`);
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=custom-agent-registry.js.map

package/dist/src/custom-agent-registry.js.map

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

package/dist/src/discovery/adapters/claude.d.ts

@@ -0,0 +1,3 @@
+import type { AgentDiscoveryAdapter } from "../types.js";
+export declare const claudeAdapter: AgentDiscoveryAdapter;
+//# sourceMappingURL=claude.d.ts.map

package/dist/src/discovery/adapters/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../../src/discovery/adapters/claude.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAsBzD,eAAO,MAAM,aAAa,EAAE,qBAI3B,CAAC"}

package/dist/src/discovery/adapters/claude.js

@@ -0,0 +1,26 @@
+import { AgentKind } from "../../generated/phigon/v1/common_pb.js";
+import { discoverKnownAgent, } from "../known-agent.js";
+const spec = {
+    id: "claude",
+    kind: AgentKind.CLAUDE,
+    displayName: "Claude Code",
+    executableNames: ["claude"],
+    processNames: ["claude", "claude-code"],
+    configurationPaths: [
+        "~/.claude",
+        "~/Library/Application Support/Claude",
+    ],
+    capabilities: [
+        "activity",
+        "filesystem",
+        "git",
+        "mcp",
+        "native-activity",
+        "terminal",
+    ],
+};
+export const claudeAdapter = {
+    id: spec.id,
+    discover: (evidence, observedAt) => discoverKnownAgent(spec, evidence, observedAt),
+};
+//# sourceMappingURL=claude.js.map

package/dist/src/discovery/adapters/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../../src/discovery/adapters/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACnE,OAAO,EACL,kBAAkB,GAEnB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,IAAI,GAAmB;IAC3B,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,SAAS,CAAC,MAAM;IACtB,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,CAAC,QAAQ,CAAC;IAC3B,YAAY,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC;IACvC,kBAAkB,EAAE;QAClB,WAAW;QACX,sCAAsC;KACvC;IACD,YAAY,EAAE;QACZ,UAAU;QACV,YAAY;QACZ,KAAK;QACL,KAAK;QACL,iBAAiB;QACjB,UAAU;KACX;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAA0B;IAClD,EAAE,EAAE,IAAI,CAAC,EAAE;IACX,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,CACjC,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC;CACjD,CAAC"}

package/dist/src/discovery/adapters/codex.d.ts

@@ -0,0 +1,3 @@
+import type { AgentDiscoveryAdapter } from "../types.js";
+export declare const codexAdapter: AgentDiscoveryAdapter;
+//# sourceMappingURL=codex.d.ts.map

package/dist/src/discovery/adapters/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../../src/discovery/adapters/codex.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAmBzD,eAAO,MAAM,YAAY,EAAE,qBAI1B,CAAC"}

package/dist/src/discovery/adapters/codex.js

@@ -0,0 +1,23 @@
+import { AgentKind } from "../../generated/phigon/v1/common_pb.js";
+import { discoverKnownAgent, } from "../known-agent.js";
+const spec = {
+    id: "codex",
+    kind: AgentKind.CODEX,
+    displayName: "OpenAI Codex",
+    executableNames: ["codex"],
+    processNames: ["codex"],
+    configurationPaths: ["~/.codex"],
+    capabilities: [
+        "activity",
+        "filesystem",
+        "git",
+        "mcp",
+        "native-activity",
+        "terminal",
+    ],
+};
+export const codexAdapter = {
+    id: spec.id,
+    discover: (evidence, observedAt) => discoverKnownAgent(spec, evidence, observedAt),
+};
+//# sourceMappingURL=codex.js.map

package/dist/src/discovery/adapters/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../../src/discovery/adapters/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACnE,OAAO,EACL,kBAAkB,GAEnB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,IAAI,GAAmB;IAC3B,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,SAAS,CAAC,KAAK;IACrB,WAAW,EAAE,cAAc;IAC3B,eAAe,EAAE,CAAC,OAAO,CAAC;IAC1B,YAAY,EAAE,CAAC,OAAO,CAAC;IACvB,kBAAkB,EAAE,CAAC,UAAU,CAAC;IAChC,YAAY,EAAE;QACZ,UAAU;QACV,YAAY;QACZ,KAAK;QACL,KAAK;QACL,iBAAiB;QACjB,UAAU;KACX;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,EAAE,EAAE,IAAI,CAAC,EAAE;IACX,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,CACjC,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC;CACjD,CAAC"}

package/dist/src/discovery/adapters/custom.d.ts

@@ -0,0 +1,4 @@
+import type { CustomAgentRegistry } from "../../custom-agent-registry.js";
+import type { AgentDiscoveryAdapter } from "../types.js";
+export declare function customAgentAdapter(registry: CustomAgentRegistry): AgentDiscoveryAdapter;
+//# sourceMappingURL=custom.d.ts.map

package/dist/src/discovery/adapters/custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../../../src/discovery/adapters/custom.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAM1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,mBAAmB,GAC5B,qBAAqB,CAsBvB"}

package/dist/src/discovery/adapters/custom.js

@@ -0,0 +1,24 @@
+import { AgentKind } from "../../generated/phigon/v1/common_pb.js";
+import { combineAdapterResults, discoverKnownAgent, } from "../known-agent.js";
+export function customAgentAdapter(registry) {
+    return {
+        id: "custom",
+        async discover(evidence, observedAt) {
+            const registrations = await registry.list();
+            const results = await Promise.all(registrations.map((registration) => {
+                const spec = {
+                    id: `custom:${registration.id}`,
+                    kind: AgentKind.GENERIC,
+                    displayName: registration.displayName,
+                    executableNames: registration.executableNames,
+                    processNames: registration.processNames,
+                    configurationPaths: registration.configurationPaths,
+                    capabilities: registration.capabilities,
+                };
+                return discoverKnownAgent(spec, evidence, observedAt);
+            }));
+            return combineAdapterResults("custom", results);
+        },
+    };
+}
+//# sourceMappingURL=custom.js.map

package/dist/src/discovery/adapters/custom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.js","sourceRoot":"","sources":["../../../../src/discovery/adapters/custom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAEnE,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GAEnB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,UAAU,kBAAkB,CAChC,QAA6B;IAE7B,OAAO;QACL,EAAE,EAAE,QAAQ;QACZ,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU;YACjC,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE;gBACjC,MAAM,IAAI,GAAmB;oBAC3B,EAAE,EAAE,UAAU,YAAY,CAAC,EAAE,EAAE;oBAC/B,IAAI,EAAE,SAAS,CAAC,OAAO;oBACvB,WAAW,EAAE,YAAY,CAAC,WAAW;oBACrC,eAAe,EAAE,YAAY,CAAC,eAAe;oBAC7C,YAAY,EAAE,YAAY,CAAC,YAAY;oBACvC,kBAAkB,EAAE,YAAY,CAAC,kBAAkB;oBACnD,YAAY,EAAE,YAAY,CAAC,YAAY;iBACxC,CAAC;gBACF,OAAO,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;YACxD,CAAC,CAAC,CACH,CAAC;YACF,OAAO,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/discovery/adapters/generic.d.ts

@@ -0,0 +1,3 @@
+import type { AgentDiscoveryAdapter } from "../types.js";
+export declare const genericAdapter: AgentDiscoveryAdapter;
+//# sourceMappingURL=generic.d.ts.map

package/dist/src/discovery/adapters/generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../../../src/discovery/adapters/generic.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAuHzD,eAAO,MAAM,cAAc,EAAE,qBAU5B,CAAC"}

package/dist/src/discovery/adapters/generic.js

@@ -0,0 +1,126 @@
+import { AgentKind } from "../../generated/phigon/v1/common_pb.js";
+import { combineAdapterResults, discoverKnownAgent, } from "../known-agent.js";
+const genericAgents = [
+    {
+        id: "generic:aider",
+        kind: AgentKind.GENERIC,
+        displayName: "Aider",
+        executableNames: ["aider"],
+        processNames: ["aider"],
+        configurationPaths: ["~/.aider"],
+        capabilities: ["activity", "filesystem", "git", "terminal"],
+    },
+    {
+        id: "generic:amp",
+        kind: AgentKind.GENERIC,
+        displayName: "Amp",
+        executableNames: ["amp"],
+        processNames: ["amp"],
+        configurationPaths: ["~/.config/amp"],
+        capabilities: ["activity", "filesystem", "git", "terminal"],
+    },
+    {
+        id: "generic:cursor-agent",
+        kind: AgentKind.GENERIC,
+        displayName: "Cursor Agent",
+        executableNames: ["cursor-agent"],
+        processNames: ["cursor-agent"],
+        configurationPaths: ["~/.cursor"],
+        capabilities: ["activity", "filesystem", "git", "terminal"],
+    },
+    {
+        id: "generic:gemini",
+        kind: AgentKind.GENERIC,
+        displayName: "Gemini CLI",
+        executableNames: ["gemini"],
+        processNames: ["gemini"],
+        configurationPaths: ["~/.gemini"],
+        capabilities: ["activity", "filesystem", "mcp", "terminal"],
+    },
+    {
+        id: "generic:opencode",
+        kind: AgentKind.GENERIC,
+        displayName: "OpenCode",
+        executableNames: ["opencode"],
+        processNames: ["opencode"],
+        configurationPaths: ["~/.config/opencode"],
+        capabilities: ["activity", "filesystem", "git", "terminal"],
+    },
+    {
+        id: "generic:goose",
+        kind: AgentKind.GENERIC,
+        displayName: "Goose",
+        executableNames: ["goose"],
+        processNames: ["goose"],
+        configurationPaths: ["~/.config/goose"],
+        capabilities: ["activity", "filesystem", "mcp", "terminal"],
+    },
+    {
+        id: "generic:copilot",
+        kind: AgentKind.GENERIC,
+        displayName: "GitHub Copilot CLI",
+        executableNames: ["copilot"],
+        processNames: ["copilot"],
+        configurationPaths: ["~/.copilot"],
+        capabilities: [
+            "activity",
+            "filesystem",
+            "git",
+            "native-activity",
+            "terminal",
+        ],
+    },
+    {
+        id: "generic:amazon-q",
+        kind: AgentKind.GENERIC,
+        displayName: "Amazon Q Developer CLI",
+        executableNames: ["q"],
+        processNames: ["q"],
+        configurationPaths: ["~/.aws/amazonq"],
+        capabilities: ["activity", "filesystem", "terminal"],
+    },
+    {
+        id: "generic:openhands",
+        kind: AgentKind.GENERIC,
+        displayName: "OpenHands",
+        executableNames: ["openhands"],
+        processNames: ["openhands"],
+        configurationPaths: ["~/.openhands"],
+        capabilities: ["activity", "browser", "filesystem", "terminal"],
+    },
+    {
+        id: "generic:cline",
+        kind: AgentKind.GENERIC,
+        displayName: "Cline",
+        executableNames: [],
+        processNames: [],
+        configurationPaths: ["~/.cline"],
+        capabilities: ["activity", "browser", "filesystem", "mcp", "terminal"],
+    },
+    {
+        id: "generic:continue",
+        kind: AgentKind.GENERIC,
+        displayName: "Continue",
+        executableNames: [],
+        processNames: [],
+        configurationPaths: ["~/.continue"],
+        capabilities: ["activity", "filesystem", "mcp", "terminal"],
+    },
+    {
+        id: "generic:jsonl",
+        kind: AgentKind.GENERIC,
+        displayName: "Generic JSONL agent",
+        executableNames: [],
+        processNames: [],
+        configurationPaths: ["~/.phigon/agent-events"],
+        capabilities: ["activity", "tools"],
+    },
+];
+export const genericAdapter = {
+    id: "generic",
+    async discover(evidence, observedAt) {
+        const results = await Promise.all(genericAgents.map((spec) => discoverKnownAgent(spec, evidence, observedAt)));
+        return combineAdapterResults("generic", results);
+    },
+};
+//# sourceMappingURL=generic.js.map

package/dist/src/discovery/adapters/generic.js.map

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

package/dist/src/discovery/adapters/hermes.d.ts

@@ -0,0 +1,3 @@
+import type { AgentDiscoveryAdapter } from "../types.js";
+export declare const hermesAdapter: AgentDiscoveryAdapter;
+//# sourceMappingURL=hermes.d.ts.map

package/dist/src/discovery/adapters/hermes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes.d.ts","sourceRoot":"","sources":["../../../../src/discovery/adapters/hermes.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAkBzD,eAAO,MAAM,aAAa,EAAE,qBAI3B,CAAC"}

package/dist/src/discovery/adapters/hermes.js

@@ -0,0 +1,22 @@
+import { AgentKind } from "../../generated/phigon/v1/common_pb.js";
+import { discoverKnownAgent, } from "../known-agent.js";
+const spec = {
+    id: "hermes",
+    kind: AgentKind.HERMES,
+    displayName: "Hermes Agent",
+    executableNames: ["hermes", "hermes-agent"],
+    processNames: ["hermes", "hermes-agent"],
+    configurationPaths: ["~/.hermes"],
+    capabilities: [
+        "activity",
+        "browser",
+        "filesystem",
+        "native-activity",
+        "terminal",
+    ],
+};
+export const hermesAdapter = {
+    id: spec.id,
+    discover: (evidence, observedAt) => discoverKnownAgent(spec, evidence, observedAt),
+};
+//# sourceMappingURL=hermes.js.map

package/dist/src/discovery/adapters/hermes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes.js","sourceRoot":"","sources":["../../../../src/discovery/adapters/hermes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACnE,OAAO,EACL,kBAAkB,GAEnB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,IAAI,GAAmB;IAC3B,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,SAAS,CAAC,MAAM;IACtB,WAAW,EAAE,cAAc;IAC3B,eAAe,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC;IAC3C,YAAY,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC;IACxC,kBAAkB,EAAE,CAAC,WAAW,CAAC;IACjC,YAAY,EAAE;QACZ,UAAU;QACV,SAAS;QACT,YAAY;QACZ,iBAAiB;QACjB,UAAU;KACX;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAA0B;IAClD,EAAE,EAAE,IAAI,CAAC,EAAE;IACX,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,CACjC,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC;CACjD,CAAC"}

package/dist/src/discovery/adapters/openclaw.d.ts

@@ -0,0 +1,3 @@
+import type { AgentDiscoveryAdapter } from "../types.js";
+export declare const openClawAdapter: AgentDiscoveryAdapter;
+//# sourceMappingURL=openclaw.d.ts.map

package/dist/src/discovery/adapters/openclaw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw.d.ts","sourceRoot":"","sources":["../../../../src/discovery/adapters/openclaw.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAkBzD,eAAO,MAAM,eAAe,EAAE,qBAI7B,CAAC"}

package/dist/src/discovery/adapters/openclaw.js

@@ -0,0 +1,22 @@
+import { AgentKind } from "../../generated/phigon/v1/common_pb.js";
+import { discoverKnownAgent, } from "../known-agent.js";
+const spec = {
+    id: "openclaw",
+    kind: AgentKind.OPENCLAW,
+    displayName: "OpenClaw",
+    executableNames: ["openclaw", "openclaw-agent"],
+    processNames: ["openclaw", "openclaw-agent"],
+    configurationPaths: ["~/.openclaw"],
+    capabilities: [
+        "activity",
+        "browser",
+        "filesystem",
+        "native-activity",
+        "terminal",
+    ],
+};
+export const openClawAdapter = {
+    id: spec.id,
+    discover: (evidence, observedAt) => discoverKnownAgent(spec, evidence, observedAt),
+};
+//# sourceMappingURL=openclaw.js.map

package/dist/src/discovery/adapters/openclaw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw.js","sourceRoot":"","sources":["../../../../src/discovery/adapters/openclaw.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACnE,OAAO,EACL,kBAAkB,GAEnB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,IAAI,GAAmB;IAC3B,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,SAAS,CAAC,QAAQ;IACxB,WAAW,EAAE,UAAU;IACvB,eAAe,EAAE,CAAC,UAAU,EAAE,gBAAgB,CAAC;IAC/C,YAAY,EAAE,CAAC,UAAU,EAAE,gBAAgB,CAAC;IAC5C,kBAAkB,EAAE,CAAC,aAAa,CAAC;IACnC,YAAY,EAAE;QACZ,UAAU;QACV,SAAS;QACT,YAAY;QACZ,iBAAiB;QACjB,UAAU;KACX;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAA0B;IACpD,EAAE,EAAE,IAAI,CAAC,EAAE;IACX,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,CACjC,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC;CACjD,CAAC"}