@phigon/observer 8.0.1

package/dist/src/activity/adapters/opencode.js

@@ -0,0 +1,137 @@
+import { ActivityKind, AgentKind, } from "../../generated/phigon/v1/common_pb.js";
+import { LifecyclePhase, ToolPhase, } from "../../generated/phigon/v1/telemetry_pb.js";
+import { activityDraft, errorDraft, lifecycleDraft, toolDrafts, } from "../normalize.js";
+import { nestedField, objectValue, stringField, } from "../record.js";
+class OpenCodeActivityAdapter {
+    id = "opencode";
+    agentKind = AgentKind.GENERIC;
+    #startedSessions = new Set();
+    #messageRoles = new Map();
+    parse(record, context) {
+        try {
+            const object = objectValue(record);
+            if (object === null)
+                return [];
+            const observedContext = {
+                ...context,
+                observedAt: openCodeObservedAt(object, context.observedAt),
+            };
+            const type = normalizeOpenCodeType(stringField(object, "type"));
+            const part = objectValue(object["part"]);
+            this.#rememberMessageRole(objectValue(object["message_info"]), context.sessionId);
+            if (type === "message.updated") {
+                this.#rememberMessageRole(objectValue(object["info"]), context.sessionId);
+                return [];
+            }
+            const partType = normalizeOpenCodeType(stringField(part, "type"));
+            const normalizedType = type === "message.part.updated"
+                ? partType
+                : type;
+            if (normalizedType === "step_start") {
+                if (this.#startedSessions.has(context.sessionId))
+                    return [];
+                this.#rememberStarted(context.sessionId);
+                return [lifecycleDraft(this.agentKind, observedContext, LifecyclePhase.STARTED, "OpenCode task started.")];
+            }
+            if (normalizedType === "step_finish") {
+                const reason = stringField(part, "reason");
+                if (reason !== "stop")
+                    return [];
+                this.#startedSessions.delete(context.sessionId);
+                return [lifecycleDraft(this.agentKind, observedContext, LifecyclePhase.IDLE, "OpenCode task completed.")];
+            }
+            if (normalizedType === "text" && part !== null) {
+                if (stringField(part, "text").trim() === "") {
+                    // OpenCode emits an empty text-part update before the completed
+                    // text update. Keep the native event, but do not invent an empty
+                    // chat bubble from an incomplete streaming part.
+                    return [];
+                }
+                const messageID = stringField(part, "messageID") ||
+                    stringField(part, "messageId");
+                const messageRole = this.#messageRoles.get(`${context.sessionId}\u0000${messageID}`);
+                if (type === "message.part.updated" && messageRole === "user") {
+                    return [activityDraft(this.agentKind, observedContext, ActivityKind.PROMPT, "User prompt submitted.", part["text"], "promptContent", "text")];
+                }
+                if (type === "message.part.updated" &&
+                    (messageRole === undefined || messageRole === "conflict")) {
+                    // A text part without a stable provider-reported message role is
+                    // preserved as vendor evidence but never guessed into a speaker.
+                    return [];
+                }
+                return [activityDraft(this.agentKind, observedContext, ActivityKind.RESPONSE, "Agent response produced.", part["text"], "responseContent", "text")];
+            }
+            if ((normalizedType === "tool_use" || normalizedType === "tool") &&
+                part !== null) {
+                const state = objectValue(part["state"]);
+                const status = stringField(state, "status");
+                return toolDrafts(this.agentKind, observedContext, {
+                    invocationId: part["callID"],
+                    toolName: part["tool"],
+                    phase: openCodeToolPhase(status),
+                    arguments: state?.["input"],
+                    output: state?.["output"],
+                    exitCode: nestedField(state, "metadata", "exitCode"),
+                });
+            }
+            if (/error|failed|crash/iu.test(normalizedType)) {
+                return [errorDraft(this.agentKind, observedContext, normalizedType)];
+            }
+            return [];
+        }
+        catch {
+            return [errorDraft(this.agentKind, context, "malformed_record")];
+        }
+    }
+    #rememberStarted(sessionId) {
+        this.#startedSessions.add(sessionId);
+        if (this.#startedSessions.size <= 4_096)
+            return;
+        const oldest = this.#startedSessions.values().next().value;
+        if (typeof oldest === "string")
+            this.#startedSessions.delete(oldest);
+    }
+    #rememberMessageRole(info, sessionID) {
+        if (info === null)
+            return;
+        const messageID = stringField(info, "id");
+        const role = stringField(info, "role");
+        if (messageID === "" ||
+            (role !== "user" && role !== "assistant"))
+            return;
+        const key = `${sessionID}\u0000${messageID}`;
+        const current = this.#messageRoles.get(key);
+        this.#messageRoles.set(key, current === undefined || current === role ? role : "conflict");
+        if (this.#messageRoles.size <= 8_192)
+            return;
+        const oldest = this.#messageRoles.keys().next().value;
+        if (typeof oldest === "string")
+            this.#messageRoles.delete(oldest);
+    }
+}
+function normalizeOpenCodeType(value) {
+    return value
+        .replace(/\.\d+$/u, "")
+        .replace(/-/gu, "_");
+}
+function openCodeObservedAt(object, fallback) {
+    const timestamp = object["timestamp"];
+    if (typeof timestamp !== "number" || !Number.isFinite(timestamp)) {
+        return fallback;
+    }
+    const parsed = new Date(timestamp);
+    return Number.isNaN(parsed.getTime()) ? fallback : parsed;
+}
+function openCodeToolPhase(status) {
+    if (status === "completed")
+        return ToolPhase.SUCCEEDED;
+    if (status === "error" || status === "failed")
+        return ToolPhase.FAILED;
+    if (status === "cancelled")
+        return ToolPhase.CANCELLED;
+    if (status === "running")
+        return ToolPhase.RUNNING;
+    return ToolPhase.REQUESTED;
+}
+export const openCodeActivityAdapter = new OpenCodeActivityAdapter();
+//# sourceMappingURL=opencode.js.map

package/dist/src/activity/adapters/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../../../src/activity/adapters/opencode.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,SAAS,GACV,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,cAAc,EACd,SAAS,GACV,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,aAAa,EACb,UAAU,EACV,cAAc,EACd,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,cAAc,CAAC;AAOtB,MAAM,uBAAuB;IAClB,EAAE,GAAG,UAAU,CAAC;IAChB,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC;IAC9B,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,aAAa,GAAG,IAAI,GAAG,EAA6C,CAAC;IAE9E,KAAK,CAAC,MAAe,EAAE,OAAqB;QAC1C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,EAAE,CAAC;YAC/B,MAAM,eAAe,GAAG;gBACtB,GAAG,OAAO;gBACV,UAAU,EAAE,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC;aAC3D,CAAC;YACF,MAAM,IAAI,GAAG,qBAAqB,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAChE,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACzC,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YAClF,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBAC/B,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;gBAC1E,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YAClE,MAAM,cAAc,GAAG,IAAI,KAAK,sBAAsB;gBACpD,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,IAAI,CAAC;YAET,IAAI,cAAc,KAAK,YAAY,EAAE,CAAC;gBACpC,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC;oBAAE,OAAO,EAAE,CAAC;gBAC5D,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBACzC,OAAO,CAAC,cAAc,CACpB,IAAI,CAAC,SAAS,EACd,eAAe,EACf,cAAc,CAAC,OAAO,EACtB,wBAAwB,CACzB,CAAC,CAAC;YACL,CAAC;YACD,IAAI,cAAc,KAAK,aAAa,EAAE,CAAC;gBACrC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAC3C,IAAI,MAAM,KAAK,MAAM;oBAAE,OAAO,EAAE,CAAC;gBACjC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBAChD,OAAO,CAAC,cAAc,CACpB,IAAI,CAAC,SAAS,EACd,eAAe,EACf,cAAc,CAAC,IAAI,EACnB,0BAA0B,CAC3B,CAAC,CAAC;YACL,CAAC;YACD,IAAI,cAAc,KAAK,MAAM,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAC/C,IAAI,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;oBAC5C,gEAAgE;oBAChE,iEAAiE;oBACjE,iDAAiD;oBACjD,OAAO,EAAE,CAAC;gBACZ,CAAC;gBACD,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC;oBAC9C,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBACjC,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,SAAS,SAAS,SAAS,EAAE,CAAC,CAAC;gBACrF,IAAI,IAAI,KAAK,sBAAsB,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;oBAC9D,OAAO,CAAC,aAAa,CACnB,IAAI,CAAC,SAAS,EACd,eAAe,EACf,YAAY,CAAC,MAAM,EACnB,wBAAwB,EACxB,IAAI,CAAC,MAAM,CAAC,EACZ,eAAe,EACf,MAAM,CACP,CAAC,CAAC;gBACL,CAAC;gBACD,IACE,IAAI,KAAK,sBAAsB;oBAC/B,CAAC,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,UAAU,CAAC,EACzD,CAAC;oBACD,iEAAiE;oBACjE,iEAAiE;oBACjE,OAAO,EAAE,CAAC;gBACZ,CAAC;gBACD,OAAO,CAAC,aAAa,CACnB,IAAI,CAAC,SAAS,EACd,eAAe,EACf,YAAY,CAAC,QAAQ,EACrB,0BAA0B,EAC1B,IAAI,CAAC,MAAM,CAAC,EACZ,iBAAiB,EACjB,MAAM,CACP,CAAC,CAAC;YACL,CAAC;YACD,IACE,CAAC,cAAc,KAAK,UAAU,IAAI,cAAc,KAAK,MAAM,CAAC;gBAC5D,IAAI,KAAK,IAAI,EACb,CAAC;gBACD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;gBACzC,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;gBAC5C,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,EAAE;oBACjD,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC;oBAC5B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;oBACtB,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC;oBAChC,SAAS,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC;oBAC3B,MAAM,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC;oBACzB,QAAQ,EAAE,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC;iBACrD,CAAC,CAAC;YACL,CAAC;YACD,IAAI,sBAAsB,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;gBAChD,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC,CAAC;YACvE,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,gBAAgB,CAAC,SAAiB;QAChC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,IAAI,KAAK;YAAE,OAAO;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QAC3D,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvE,CAAC;IAED,oBAAoB,CAAC,IAAoC,EAAE,SAAiB;QAC1E,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO;QAC1B,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,IACE,SAAS,KAAK,EAAE;YAChB,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,WAAW,CAAC;YACzC,OAAO;QACT,MAAM,GAAG,GAAG,GAAG,SAAS,SAAS,SAAS,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC,aAAa,CAAC,GAAG,CACpB,GAAG,EACH,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAC9D,CAAC;QACF,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,IAAI,KAAK;YAAE,OAAO;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QACtD,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpE,CAAC;CACF;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,OAAO,KAAK;SACT,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,kBAAkB,CACzB,MAA+B,EAC/B,QAAc;IAEd,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACjE,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;AAC5D,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAc;IACvC,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC,SAAS,CAAC;IACvD,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC,MAAM,CAAC;IACvE,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC,SAAS,CAAC;IACvD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC,OAAO,CAAC;IACnD,OAAO,SAAS,CAAC,SAAS,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAClC,IAAI,uBAAuB,EAAE,CAAC"}

package/dist/src/activity/bridges.d.ts

@@ -0,0 +1,7 @@
+export type ActivityBridgeAgent = Readonly<{
+    id: string;
+    displayName: string;
+}>;
+export declare const activityBridgeAgents: readonly ActivityBridgeAgent[];
+export declare function activityBridgeAgent(id: string): ActivityBridgeAgent | undefined;
+//# sourceMappingURL=bridges.d.ts.map

package/dist/src/activity/bridges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridges.d.ts","sourceRoot":"","sources":["../../../src/activity/bridges.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAAC;AAEH,eAAO,MAAM,oBAAoB,EAAE,SAAS,mBAAmB,EAa3D,CAAC;AAEL,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,MAAM,GACT,mBAAmB,GAAG,SAAS,CAEjC"}

package/dist/src/activity/bridges.js

@@ -0,0 +1,17 @@
+export const activityBridgeAgents = Object.freeze([
+    { id: "generic", displayName: "Generic AI agent" },
+    { id: "aider", displayName: "Aider" },
+    { id: "amp", displayName: "Amp" },
+    { id: "cursor", displayName: "Cursor Agent" },
+    { id: "gemini", displayName: "Gemini CLI" },
+    { id: "opencode", displayName: "OpenCode" },
+    { id: "goose", displayName: "Goose" },
+    { id: "amazon-q", displayName: "Amazon Q Developer CLI" },
+    { id: "openhands", displayName: "OpenHands" },
+    { id: "cline", displayName: "Cline" },
+    { id: "continue", displayName: "Continue" },
+]);
+export function activityBridgeAgent(id) {
+    return activityBridgeAgents.find((agent) => agent.id === id);
+}
+//# sourceMappingURL=bridges.js.map

package/dist/src/activity/bridges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridges.js","sourceRoot":"","sources":["../../../src/activity/bridges.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,oBAAoB,GAC/B,MAAM,CAAC,MAAM,CAAC;IACZ,EAAE,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAE;IAClD,EAAE,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE;IACrC,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE;IACjC,EAAE,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;IAC7C,EAAE,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;IAC3C,EAAE,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE;IAC3C,EAAE,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE;IACrC,EAAE,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,wBAAwB,EAAE;IACzD,EAAE,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE;IAC7C,EAAE,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE;IACrC,EAAE,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE;CAC5C,CAAC,CAAC;AAEL,MAAM,UAAU,mBAAmB,CACjC,EAAU;IAEV,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/src/activity/collector.d.ts

@@ -0,0 +1,90 @@
+import type { ObserverConfig } from "../config.js";
+import type { CollectionPolicy } from "../config.js";
+import type { StoredMachineCredential } from "../credential-store.js";
+import { type AgentIdentity, type AgentInventory } from "../generated/phigon/v1/identity_pb.js";
+import { type EventEnvelope } from "../generated/phigon/v1/telemetry_pb.js";
+import { JSONLSourceReader, type ActivitySource } from "./source-reader.js";
+export declare const historySyncQueueHeadroom = 1024;
+export type ActivityCollectorMetrics = Readonly<{
+    sourceRecords: number;
+    malformedRecords: number;
+    oversizedRecords: number;
+    emittedEvents: number;
+    rateLimitedEvents: number;
+    oversizedEvents: number;
+    lastSequence: bigint;
+    pendingCheckpoints: number;
+    backpressuredScans: number;
+}>;
+export type HistorySyncSummary = Readonly<{
+    filesDiscovered: number;
+    recordsScanned: number;
+    eventsUploaded: number;
+    throughSequence: bigint;
+}>;
+export type ActivityCollectorOptions = Readonly<{
+    config: ObserverConfig;
+    credential: StoredMachineCredential;
+    initialSequence: bigint;
+    initialAcknowledgedSequence?: bigint;
+    durableDelivery?: boolean;
+    emit: (event: EventEnvelope) => void;
+    sources?: readonly ActivitySource[];
+    additionalSources?: () => Promise<readonly ActivitySource[]>;
+    reader?: JSONLSourceReader;
+    clock?: () => Date;
+    policy?: CollectionPolicy;
+    canCollect?: () => boolean;
+    canSyncHistory?: () => boolean;
+    onSourceIdentity?: (identity: AgentIdentity) => void | Promise<void>;
+}>;
+export declare class ActivityCollector {
+    #private;
+    constructor(options: ActivityCollectorOptions);
+    updateInventory(inventory: AgentInventory): void;
+    updatePolicy(policy: CollectionPolicy): void;
+    resetSequence(acknowledgedSequence: bigint, allocationSequence?: bigint): void;
+    acknowledge(sequence: bigint): Promise<void>;
+    scanOnce(): Promise<ActivityCollectorMetrics>;
+    syncHistory(signal?: AbortSignal): Promise<HistorySyncSummary>;
+    run(signal: AbortSignal): Promise<void>;
+    metrics(): ActivityCollectorMetrics;
+    sourceIdentities(): AgentIdentity[];
+}
+export declare function mergeInventoryWithSourceIdentities(inventory: AgentInventory, sourceIdentities: readonly AgentIdentity[]): AgentInventory;
+export declare function attributedRuntimeAgentID(agents: readonly AgentIdentity[], record: unknown): string | undefined;
+export type ReportedProcessIdentity = Readonly<{
+    processKey?: string;
+    processID?: bigint;
+    conflict: boolean;
+    coverageComplete: boolean;
+}>;
+/**
+ * Keeps agent-native process claims independent from inventory/OS evidence.
+ * A PID can reject a contradictory match, but can never create one.
+ */
+export declare function reportedProcessIdentity(record: unknown): ReportedProcessIdentity;
+/**
+ * Uses a provider-reported session only on adapters whose records carry that
+ * identity per event. Missing, invalid, or conflicting claims fail closed to
+ * the source-file identity so concurrent transcripts are never guessed into
+ * one conversation.
+ */
+export declare function reportedSessionID(adapterID: string, record: unknown, sourceID: string): string;
+export type ReportedGenericAgentIdentity = Readonly<{
+    hint?: string;
+    displayName?: string;
+    conflict: boolean;
+    coverageComplete: boolean;
+}>;
+/**
+ * Keeps user-provided custom bridge identity independent from vendor claims.
+ * A single consistent label can name an unattributed source, while conflicts,
+ * invalid claims, and missing evidence always fail closed.
+ */
+export declare function reportedGenericAgentIdentity(record: unknown, configuredDisplayName?: string): ReportedGenericAgentIdentity;
+export declare function registeredAgentActivitySources(registrations: readonly Readonly<{
+    displayName: string;
+    activityDirectories: readonly string[];
+}>[]): readonly ActivitySource[];
+//# sourceMappingURL=collector.d.ts.map

package/dist/src/activity/collector.d.ts.map

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