@tickernelz/paperclip-pro-shared 2026.925.0

package/dist/telemetry/generated/paperclip-telemetry.js

@@ -0,0 +1,297 @@
+// GENERATED — DO NOT EDIT.
+export const PAPERCLIP_EVENTS = {
+    "agent.created": "agent.created",
+    "agent.first_heartbeat": "agent.first_heartbeat",
+    "agent.task_completed": "agent.task_completed",
+    "agent.task_run": "agent.task_run",
+    "company.imported": "company.imported",
+    "error.handler_crash": "error.handler_crash",
+    "goal.created": "goal.created",
+    "install.completed": "install.completed",
+    "install.started": "install.started",
+    "interaction.created": "interaction.created",
+    "interaction.resolved": "interaction.resolved",
+    "project.created": "project.created",
+    "routine.created": "routine.created",
+    "routine.run": "routine.run",
+    "skill.imported": "skill.imported",
+};
+export const PAPERCLIP_ENUM_DESCRIPTIONS = {
+    "agent.created": {
+        "agent_role": {
+            "ceo": "Agent configured for company leadership and board coordination work.",
+            "cto": "Agent configured for technical leadership, architecture, and engineering coordination.",
+            "cmo": "Agent configured for marketing leadership work.",
+            "cfo": "Agent configured for finance leadership work.",
+            "security": "Agent configured for security review, risk, or policy work.",
+            "engineer": "Agent configured for general software engineering work.",
+            "designer": "Agent configured for product, visual, or experience design work.",
+            "pm": "Agent configured for product management or planning work.",
+            "qa": "Agent configured for quality assurance, testing, or validation work.",
+            "devops": "Agent configured for infrastructure, deployment, or operations work.",
+            "researcher": "Agent configured for research and information-gathering work.",
+            "general": "Agent configured as a general-purpose worker without a more specific role.",
+            "other": "Fallback when the agent role is unknown or not represented by the tracked enum."
+        }
+    },
+    "agent.first_heartbeat": {
+        "agent_role": {
+            "ceo": "Agent configured for company leadership and board coordination work.",
+            "cto": "Agent configured for technical leadership, architecture, and engineering coordination.",
+            "cmo": "Agent configured for marketing leadership work.",
+            "cfo": "Agent configured for finance leadership work.",
+            "security": "Agent configured for security review, risk, or policy work.",
+            "engineer": "Agent configured for general software engineering work.",
+            "designer": "Agent configured for product, visual, or experience design work.",
+            "pm": "Agent configured for product management or planning work.",
+            "qa": "Agent configured for quality assurance, testing, or validation work.",
+            "devops": "Agent configured for infrastructure, deployment, or operations work.",
+            "researcher": "Agent configured for research and information-gathering work.",
+            "general": "Agent configured as a general-purpose worker without a more specific role.",
+            "other": "Fallback when the agent role is unknown or not represented by the tracked enum."
+        }
+    },
+    "agent.task_completed": {
+        "adapter_type": {
+            "process": "Agent runtime uses a local process adapter.",
+            "http": "Agent runtime uses a generic HTTP adapter.",
+            "acpx_local": "Agent runtime uses the local ACPX adapter.",
+            "claude_local": "Agent runtime uses the local Claude adapter.",
+            "codex_local": "Agent runtime uses the local Codex adapter.",
+            "cursor_cloud": "Agent runtime uses the Cursor cloud adapter.",
+            "gemini_local": "Agent runtime uses the local Gemini adapter.",
+            "hermes_gateway": "Agent runtime uses the Hermes gateway adapter.",
+            "hermes_local": "Agent runtime uses the local Hermes adapter.",
+            "opencode_local": "Agent runtime uses the local OpenCode adapter.",
+            "pi_local": "Agent runtime uses the local Pi adapter.",
+            "cursor": "Agent runtime uses the Cursor adapter.",
+            "openclaw_gateway": "Agent runtime uses the OpenClaw gateway adapter.",
+            "grok_local": "Agent runtime uses the local Grok adapter.",
+            "kimi_local": "Agent runtime uses the local Kimi adapter.",
+            "other": "Fallback when the adapter type is unknown or not represented by the tracked enum."
+        },
+        "agent_role": {
+            "ceo": "Agent configured for company leadership and board coordination work.",
+            "cto": "Agent configured for technical leadership, architecture, and engineering coordination.",
+            "cmo": "Agent configured for marketing leadership work.",
+            "cfo": "Agent configured for finance leadership work.",
+            "security": "Agent configured for security review, risk, or policy work.",
+            "engineer": "Agent configured for general software engineering work.",
+            "designer": "Agent configured for product, visual, or experience design work.",
+            "pm": "Agent configured for product management or planning work.",
+            "qa": "Agent configured for quality assurance, testing, or validation work.",
+            "devops": "Agent configured for infrastructure, deployment, or operations work.",
+            "researcher": "Agent configured for research and information-gathering work.",
+            "general": "Agent configured as a general-purpose worker without a more specific role.",
+            "other": "Fallback when the agent role is unknown or not represented by the tracked enum."
+        }
+    },
+    "agent.task_run": {
+        "adapter_type": {
+            "process": "Agent runtime uses a local process adapter.",
+            "http": "Agent runtime uses a generic HTTP adapter.",
+            "acpx_local": "Agent runtime uses the local ACPX adapter.",
+            "claude_local": "Agent runtime uses the local Claude adapter.",
+            "codex_local": "Agent runtime uses the local Codex adapter.",
+            "cursor_cloud": "Agent runtime uses the Cursor cloud adapter.",
+            "gemini_local": "Agent runtime uses the local Gemini adapter.",
+            "hermes_gateway": "Agent runtime uses the Hermes gateway adapter.",
+            "hermes_local": "Agent runtime uses the local Hermes adapter.",
+            "opencode_local": "Agent runtime uses the local OpenCode adapter.",
+            "pi_local": "Agent runtime uses the local Pi adapter.",
+            "cursor": "Agent runtime uses the Cursor adapter.",
+            "openclaw_gateway": "Agent runtime uses the OpenClaw gateway adapter.",
+            "grok_local": "Agent runtime uses the local Grok adapter.",
+            "kimi_local": "Agent runtime uses the local Kimi adapter.",
+            "other": "Fallback when the adapter type is unknown or not represented by the tracked enum."
+        },
+        "agent_role": {
+            "ceo": "Agent configured for company leadership and board coordination work.",
+            "cto": "Agent configured for technical leadership, architecture, and engineering coordination.",
+            "cmo": "Agent configured for marketing leadership work.",
+            "cfo": "Agent configured for finance leadership work.",
+            "security": "Agent configured for security review, risk, or policy work.",
+            "engineer": "Agent configured for general software engineering work.",
+            "designer": "Agent configured for product, visual, or experience design work.",
+            "pm": "Agent configured for product management or planning work.",
+            "qa": "Agent configured for quality assurance, testing, or validation work.",
+            "devops": "Agent configured for infrastructure, deployment, or operations work.",
+            "researcher": "Agent configured for research and information-gathering work.",
+            "general": "Agent configured as a general-purpose worker without a more specific role.",
+            "other": "Fallback when the agent role is unknown or not represented by the tracked enum."
+        },
+        "state": {
+            "succeeded": "The agent run finished its task and reached a successful terminal state.",
+            "interrupted": "A user or the board interrupted the agent run before it finished.",
+            "failed": "The agent run reached a terminal state because of an unrecoverable error.",
+            "cancelled": "The agent run was cancelled before it reached a successful terminal state.",
+            "timed_out": "The agent run reached its time limit before it finished."
+        }
+    },
+    "company.imported": {
+        "source_type": {
+            "local_path": "Import source came from a filesystem path on the operator's machine.",
+            "github": "Import source came from a GitHub repository or GitHub-backed reference.",
+            "url": "Import source came from a direct URL.",
+            "catalog": "Import source came from a Paperclip catalog entry.",
+            "skills_sh": "Import source came from a Skills.sh-compatible source.",
+            "unknown": "Source type could not be classified."
+        }
+    },
+    "goal.created": {
+        "goal_level": {
+            "company": "Goal applies at company scope.",
+            "team": "Goal applies at team or group scope.",
+            "agent": "Goal applies to a specific agent.",
+            "task": "Goal applies to task-level work.",
+            "other": "Fallback when the goal level is unknown or not represented by the tracked enum."
+        }
+    },
+    "install.completed": {
+        "adapter_type": {
+            "process": "Agent runtime uses a local process adapter.",
+            "http": "Agent runtime uses a generic HTTP adapter.",
+            "acpx_local": "Agent runtime uses the local ACPX adapter.",
+            "claude_local": "Agent runtime uses the local Claude adapter.",
+            "codex_local": "Agent runtime uses the local Codex adapter.",
+            "cursor_cloud": "Agent runtime uses the Cursor cloud adapter.",
+            "gemini_local": "Agent runtime uses the local Gemini adapter.",
+            "hermes_gateway": "Agent runtime uses the Hermes gateway adapter.",
+            "hermes_local": "Agent runtime uses the local Hermes adapter.",
+            "opencode_local": "Agent runtime uses the local OpenCode adapter.",
+            "pi_local": "Agent runtime uses the local Pi adapter.",
+            "cursor": "Agent runtime uses the Cursor adapter.",
+            "openclaw_gateway": "Agent runtime uses the OpenClaw gateway adapter.",
+            "grok_local": "Agent runtime uses the local Grok adapter.",
+            "kimi_local": "Agent runtime uses the local Kimi adapter.",
+            "other": "Fallback when the adapter type is unknown or not represented by the tracked enum."
+        }
+    },
+    "interaction.created": {
+        "interaction_kind": {
+            "suggest_tasks": "Board-facing interaction that proposes concrete subtasks for acceptance.",
+            "ask_user_questions": "Board-facing interaction that asks structured questions and stores answers.",
+            "request_confirmation": "Board-facing interaction that asks for a single accept or reject decision.",
+            "request_checkbox_confirmation": "Board-facing interaction that asks the board to select options and confirm.",
+            "request_item_verdicts": "Board-facing interaction that collects a verdict for each known item.",
+            "other": "Fallback when the interaction kind is unknown or not represented by the tracked enum."
+        }
+    },
+    "interaction.resolved": {
+        "interaction_kind": {
+            "suggest_tasks": "Board-facing interaction that proposes concrete subtasks for acceptance.",
+            "ask_user_questions": "Board-facing interaction that asks structured questions and stores answers.",
+            "request_confirmation": "Board-facing interaction that asks for a single accept or reject decision.",
+            "request_checkbox_confirmation": "Board-facing interaction that asks the board to select options and confirm.",
+            "request_item_verdicts": "Board-facing interaction that collects a verdict for each known item.",
+            "other": "Fallback when the interaction kind is unknown or not represented by the tracked enum."
+        },
+        "status": {
+            "accepted": "Interaction was accepted.",
+            "rejected": "Interaction was rejected.",
+            "answered": "Ask-user-questions interaction was answered.",
+            "cancelled": "Interaction was cancelled before acceptance or answer.",
+            "expired": "Interaction expired because the bound target became stale or was superseded.",
+            "failed": "Interaction resolution attempted but failed.",
+            "other": "Fallback when the terminal status is unknown or not represented by the tracked enum."
+        },
+        "resolution_reason": {
+            "accepted": "Stored result outcome says the interaction was accepted.",
+            "rejected": "Stored result outcome says the interaction was rejected.",
+            "stale_target": "Bound target, such as an issue document revision, was no longer current.",
+            "superseded_by_comment": "A later user or board comment superseded the pending confirmation.",
+            "superseded_by_newer_request": "A newer confirmation from the same agent superseded the pending confirmation.",
+            "expired": "Interaction expired for a generic expiration reason.",
+            "cancelled": "Interaction was explicitly cancelled.",
+            "skipped": "The board skipped the interaction and returned to ordinary task input.",
+            "other": "Fallback when the resolution reason is unknown or not represented by the tracked enum."
+        },
+        "resolved_by_kind": {
+            "user": "A board or human user resolved the interaction.",
+            "agent": "An agent resolved the interaction.",
+            "system": "Paperclip resolved the interaction automatically.",
+            "other": "Fallback when the resolver kind is unknown or not represented by the tracked enum."
+        },
+        "created_by_kind": {
+            "agent": "Interaction was created by an agent.",
+            "user": "Interaction was created by a board or human user.",
+            "other": "Fallback when the creator kind is unknown or not represented by the tracked enum."
+        },
+        "creator_agent_role": {
+            "ceo": "Agent configured for company leadership and board coordination work.",
+            "cto": "Agent configured for technical leadership, architecture, and engineering coordination.",
+            "cmo": "Agent configured for marketing leadership work.",
+            "cfo": "Agent configured for finance leadership work.",
+            "security": "Agent configured for security review, risk, or policy work.",
+            "engineer": "Agent configured for general software engineering work.",
+            "designer": "Agent configured for product, visual, or experience design work.",
+            "pm": "Agent configured for product management or planning work.",
+            "qa": "Agent configured for quality assurance, testing, or validation work.",
+            "devops": "Agent configured for infrastructure, deployment, or operations work.",
+            "researcher": "Agent configured for research and information-gathering work.",
+            "general": "Agent configured as a general-purpose worker without a more specific role.",
+            "other": "Fallback when the agent role is unknown or not represented by the tracked enum."
+        },
+        "continuation_policy": {
+            "none": "Resolving the interaction does not automatically wake the issue assignee.",
+            "wake_assignee": "Resolving the interaction wakes or returns the issue to the assignee.",
+            "wake_assignee_on_accept": "Accepting the interaction wakes or returns the issue to the assignee.",
+            "other": "Fallback when the continuation policy is unknown or not represented by the tracked enum."
+        },
+        "target_type": {
+            "issue_document": "Interaction is bound to a specific issue document revision.",
+            "custom": "Interaction is bound to a custom target.",
+            "none": "Interaction has no bound target.",
+            "other": "Fallback when the target type is unknown or not represented by the tracked enum."
+        }
+    },
+    "routine.run": {
+        "source": {
+            "schedule": "Routine was triggered by a scheduled trigger.",
+            "manual": "Routine was triggered manually by a user or agent action.",
+            "api": "Routine was triggered through an API request.",
+            "webhook": "Routine was triggered by a webhook.",
+            "other": "Fallback when the source is unknown or not represented by the tracked enum."
+        },
+        "status": {
+            "received": "Routine run was accepted for processing.",
+            "coalesced": "A live execution already existed and the run was coalesced into it.",
+            "skipped": "A live execution already existed and concurrency policy skipped the run.",
+            "issue_created": "Routine dispatch created a new issue and queued the agent wakeup.",
+            "completed": "Routine run completed without needing a new issue.",
+            "failed": "Routine dispatch failed and the run was finalized as failed.",
+            "other": "Fallback when the status is unknown or not represented by the tracked enum."
+        }
+    },
+    "skill.imported": {
+        "source_type": {
+            "local_path": "Import source came from a filesystem path on the operator's machine.",
+            "github": "Import source came from a GitHub repository or GitHub-backed reference.",
+            "url": "Import source came from a direct URL.",
+            "catalog": "Import source came from a Paperclip catalog entry.",
+            "skills_sh": "Import source came from a Skills.sh-compatible source.",
+            "unknown": "Source type could not be classified."
+        }
+    }
+};
+export const SCHEMA_VERSION = "1";
+export function makeEvent(name, dimensions, occurredAt) {
+    return { name, occurredAt, dimensions };
+}
+export function makeBatch(installId, events, 
+/**
+ * Optional client application build version. Paperclip clients report PEP 440
+ * local versions such as <nearest-tag>+<commits-since-tag>.git.<abbrev-sha>;
+ * nearest tags are usually CalVer, but legacy SemVer tags such as 0.3.1 can
+ * appear. Ingest documents this shape but does not strictly enforce PEP 440.
+ */
+version) {
+    return {
+        app: "paperclip",
+        schemaVersion: SCHEMA_VERSION,
+        installId,
+        ...(version === undefined ? {} : { version }),
+        events: [...events]
+    };
+}
+//# sourceMappingURL=paperclip-telemetry.js.map

package/dist/telemetry/generated/paperclip-telemetry.js.map

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

package/dist/telemetry/index.d.ts

@@ -0,0 +1,10 @@
+export { TelemetryClient } from "./client.js";
+export { resolveTelemetryConfig, resolveCaps, TELEMETRY_DEFAULTS } from "./config.js";
+export type { TelemetryConfigOverrides } from "./config.js";
+export { loadOrCreateState } from "./state.js";
+export { trackInstallStarted, trackInstallCompleted, trackCompanyImported, trackProjectCreated, trackRoutineCreated, trackRoutineRun, trackGoalCreated, trackAgentCreated, trackSkillImported, trackAgentFirstHeartbeat, trackAgentTaskCompleted, trackAgentTaskRun, trackErrorHandlerCrash, trackInteractionCreated, trackInteractionResolved, trackConnectionCreated, trackConnectionUpdated, trackConnectionInvoked, } from "./events.js";
+export type { TelemetryConfig, TelemetryBackoffConfig, TelemetryState, TelemetryEvent, TelemetryEventEnvelope, TelemetryDimensions, TelemetryDimensionValue, TelemetryEventDimensions, TelemetryEventName, RegisteredPluginEventName, } from "./types.js";
+export type { AnyPaperclipTelemetryEvent, EventDimensionsMap, PaperclipEventName, } from "./generated/paperclip-telemetry.js";
+export { EVENT_RETENTION_CLASS, RETENTION_DAYS } from "./retention.js";
+export type { RetentionClass } from "./retention.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtF,YAAY,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/telemetry/index.js

@@ -0,0 +1,6 @@
+export { TelemetryClient } from "./client.js";
+export { resolveTelemetryConfig, resolveCaps, TELEMETRY_DEFAULTS } from "./config.js";
+export { loadOrCreateState } from "./state.js";
+export { trackInstallStarted, trackInstallCompleted, trackCompanyImported, trackProjectCreated, trackRoutineCreated, trackRoutineRun, trackGoalCreated, trackAgentCreated, trackSkillImported, trackAgentFirstHeartbeat, trackAgentTaskCompleted, trackAgentTaskRun, trackErrorHandlerCrash, trackInteractionCreated, trackInteractionResolved, trackConnectionCreated, trackConnectionUpdated, trackConnectionInvoked, } from "./events.js";
+export { EVENT_RETENTION_CLASS, RETENTION_DAYS } from "./retention.js";
+//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAkBrB,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/telemetry/proposed-connector-events.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=proposed-connector-events.test.d.ts.map

package/dist/telemetry/proposed-connector-events.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposed-connector-events.test.d.ts","sourceRoot":"","sources":["../../src/telemetry/proposed-connector-events.test.ts"],"names":[],"mappings":""}

package/dist/telemetry/proposed-connector-events.test.js

@@ -0,0 +1,96 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { TelemetryClient } from "./client.js";
+import { resolveTelemetryConfig } from "./config.js";
+import { trackConnectionCreated, trackConnectionUpdated, trackConnectionInvoked, } from "./events.js";
+const TEST_STATE = {
+    installId: "test-install",
+    salt: "test-salt",
+    createdAt: "2026-01-01T00:00:00Z",
+    firstSeenVersion: "0.0.0",
+};
+function makeClient(config) {
+    const stateFactory = vi.fn(() => TEST_STATE);
+    return {
+        client: new TelemetryClient({ enabled: config?.enabled ?? true, endpoint: "http://localhost:9999/ingest" }, stateFactory, "0.0.0-test", () => 0.5),
+        stateFactory,
+    };
+}
+function trackAllProposedConnectorEvents(client) {
+    trackConnectionCreated(client, {
+        connector_key: "github",
+        transport: "mcp_remote",
+        auth_kind: "oauth",
+        setup_flow: "gallery",
+        status: "active",
+        enabled: true,
+    });
+    trackConnectionUpdated(client, {
+        connector_key: "github",
+        transport: "mcp_remote",
+        auth_kind: "oauth",
+        change_source: "api",
+        previous_status: "draft",
+        status: "active",
+        previous_enabled: false,
+        enabled: true,
+    });
+    trackConnectionInvoked(client, {
+        connector_key: "github",
+        transport: "mcp_remote",
+        status: "succeeded",
+        origin: "agent",
+        duration_seconds: 3,
+    });
+}
+describe("proposed connector events against the real TelemetryClient", () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.unstubAllEnvs();
+    });
+    it("cannot queue or send: state stays untouched and nothing hits the wire", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: true }));
+        const { client, stateFactory } = makeClient();
+        trackAllProposedConnectorEvents(client);
+        await client.flush();
+        expect(stateFactory).not.toHaveBeenCalled();
+        expect(fetch).not.toHaveBeenCalled();
+    });
+    it("differential control: a registered event through the same client does send", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: true }));
+        const { client } = makeClient();
+        trackAllProposedConnectorEvents(client);
+        client.track("project.created", {});
+        await client.flush();
+        expect(fetch).toHaveBeenCalledTimes(1);
+        const body = JSON.parse(String((vi.mocked(fetch).mock.calls[0]?.[1]).body));
+        expect(body.events).toEqual([
+            expect.objectContaining({ name: "project.created" }),
+        ]);
+    });
+    it("reports the three connector event names as unregistered", () => {
+        const { client } = makeClient();
+        expect(client.isRegisteredEventName("connection.created")).toBe(false);
+        expect(client.isRegisteredEventName("connection.updated")).toBe(false);
+        expect(client.isRegisteredEventName("connection.invoked")).toBe(false);
+        expect(client.isRegisteredEventName("project.created")).toBe(true);
+    });
+    it("a disabled client drops even registered events", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: true }));
+        const { client, stateFactory } = makeClient({ enabled: false });
+        client.track("project.created", {});
+        await client.flush();
+        expect(stateFactory).not.toHaveBeenCalled();
+        expect(fetch).not.toHaveBeenCalled();
+    });
+    it("environment suppression resolves telemetry off under CI and opt-out flags", () => {
+        vi.stubEnv("PAPERCLIP_TELEMETRY_DISABLED", "1");
+        expect(resolveTelemetryConfig().enabled).toBe(false);
+        vi.unstubAllEnvs();
+        vi.stubEnv("DO_NOT_TRACK", "1");
+        expect(resolveTelemetryConfig().enabled).toBe(false);
+        vi.unstubAllEnvs();
+        vi.stubEnv("GITHUB_ACTIONS", "true");
+        expect(resolveTelemetryConfig().enabled).toBe(false);
+    });
+});
+//# sourceMappingURL=proposed-connector-events.test.js.map

package/dist/telemetry/proposed-connector-events.test.js.map

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

package/dist/telemetry/readme-contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=readme-contract.test.d.ts.map

package/dist/telemetry/readme-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme-contract.test.d.ts","sourceRoot":"","sources":["../../src/telemetry/readme-contract.test.ts"],"names":[],"mappings":""}

package/dist/telemetry/readme-contract.test.js

@@ -0,0 +1,17 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it } from "vitest";
+import * as generatedTelemetry from "./generated/paperclip-telemetry.js";
+const readmePath = fileURLToPath(new URL("./README.md", import.meta.url));
+describe("telemetry README contract", () => {
+    it("documents generated event helper exports that exist", () => {
+        const readme = readFileSync(readmePath, "utf8");
+        expect(generatedTelemetry.SCHEMA_VERSION).toBeDefined();
+        expect(generatedTelemetry.makeEvent).toBeTypeOf("function");
+        expect(generatedTelemetry.makeBatch).toBeTypeOf("function");
+        expect(readme).toContain("`SCHEMA_VERSION`, `makeEvent()`, and `makeBatch()`");
+        expect(readme).not.toContain("createPaperclipTelemetryEvent");
+        expect(readme).not.toContain("createPaperclipTelemetryEnvelope");
+    });
+});
+//# sourceMappingURL=readme-contract.test.js.map

package/dist/telemetry/readme-contract.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme-contract.test.js","sourceRoot":"","sources":["../../src/telemetry/readme-contract.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,kBAAkB,MAAM,oCAAoC,CAAC;AAEzE,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,aAAa,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1E,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAEhD,MAAM,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC;QACxD,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,oDAAoD,CAAC,CAAC;QAC/E,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/telemetry/retention.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Telemetry retention contract.
+ *
+ * Defines the retention class for each Paperclip telemetry event and the
+ * corresponding retention window in days. This is a housekeeping/cost
+ * concern separate from the event schema: it is updated by data-infra
+ * and does not require a schema version bump.
+ *
+ * Retention class definitions
+ * ─────────────────────────────────────────────────────────────────────────
+ * operational_enum_count
+ *   Events that carry only enums, booleans, counts, and coarse buckets.
+ *   No token material (I5-clean) and no PII. Retention is a housekeeping
+ *   and query-cost concern, not a privacy concern.
+ *   Window: 90 days.
+ */
+/** Retention window in days for each telemetry event class. */
+export declare const RETENTION_DAYS: {
+    /**
+     * Enum/count/bucket events: no token material, no PII.
+     * Retention is a housekeeping and query-cost concern only.
+     */
+    readonly operational_enum_count: 90;
+};
+/** Identifies which retention class an event belongs to. */
+export type RetentionClass = keyof typeof RETENTION_DAYS;
+/**
+ * Maps first-party event names to their retention class.
+ *
+ * Key type is intentionally `string` rather than a tighter union because this
+ * contract also covers events emitted by external systems (e.g. the Codex CLI)
+ * that are not part of the shared generated `PaperclipEventName` type. When an
+ * event is promoted to the first-party schema, prefer tightening its entry to
+ * the named union type via an overloaded record.
+ *
+ * codex.credential_health
+ *   Emits credential-observability fields: enums (credential source, sync
+ *   outcome), booleans (rotation detected, refresh succeeded), and coarse
+ *   counts (rotations detected). No token material and no PII.
+ *   External-system event (Codex CLI) — not yet in PaperclipEventName.
+ *   Class: operational_enum_count — 90-day window.
+ */
+export declare const EVENT_RETENTION_CLASS: Partial<Record<string, RetentionClass>>;
+//# sourceMappingURL=retention.d.ts.map

package/dist/telemetry/retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/telemetry/retention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,+DAA+D;AAC/D,eAAO,MAAM,cAAc;IACzB;;;OAGG;qCACqB,EAAE;CACe,CAAC;AAE5C,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,cAAc,CAAC;AAEzD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAIzE,CAAC"}

package/dist/telemetry/retention.js

@@ -0,0 +1,46 @@
+/**
+ * Telemetry retention contract.
+ *
+ * Defines the retention class for each Paperclip telemetry event and the
+ * corresponding retention window in days. This is a housekeeping/cost
+ * concern separate from the event schema: it is updated by data-infra
+ * and does not require a schema version bump.
+ *
+ * Retention class definitions
+ * ─────────────────────────────────────────────────────────────────────────
+ * operational_enum_count
+ *   Events that carry only enums, booleans, counts, and coarse buckets.
+ *   No token material (I5-clean) and no PII. Retention is a housekeeping
+ *   and query-cost concern, not a privacy concern.
+ *   Window: 90 days.
+ */
+/** Retention window in days for each telemetry event class. */
+export const RETENTION_DAYS = {
+    /**
+     * Enum/count/bucket events: no token material, no PII.
+     * Retention is a housekeeping and query-cost concern only.
+     */
+    operational_enum_count: 90,
+};
+/**
+ * Maps first-party event names to their retention class.
+ *
+ * Key type is intentionally `string` rather than a tighter union because this
+ * contract also covers events emitted by external systems (e.g. the Codex CLI)
+ * that are not part of the shared generated `PaperclipEventName` type. When an
+ * event is promoted to the first-party schema, prefer tightening its entry to
+ * the named union type via an overloaded record.
+ *
+ * codex.credential_health
+ *   Emits credential-observability fields: enums (credential source, sync
+ *   outcome), booleans (rotation detected, refresh succeeded), and coarse
+ *   counts (rotations detected). No token material and no PII.
+ *   External-system event (Codex CLI) — not yet in PaperclipEventName.
+ *   Class: operational_enum_count — 90-day window.
+ */
+export const EVENT_RETENTION_CLASS = {
+    "codex.credential_health": "operational_enum_count",
+    "interaction.created": "operational_enum_count",
+    "interaction.resolved": "operational_enum_count",
+};
+//# sourceMappingURL=retention.js.map

package/dist/telemetry/retention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.js","sourceRoot":"","sources":["../../src/telemetry/retention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;;;OAGG;IACH,sBAAsB,EAAE,EAAE;CACe,CAAC;AAK5C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA4C;IAC5E,yBAAyB,EAAE,wBAAwB;IACnD,qBAAqB,EAAE,wBAAwB;IAC/C,sBAAsB,EAAE,wBAAwB;CACjD,CAAC"}

package/dist/telemetry/retention.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=retention.test.d.ts.map

package/dist/telemetry/retention.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.test.d.ts","sourceRoot":"","sources":["../../src/telemetry/retention.test.ts"],"names":[],"mappings":""}

package/dist/telemetry/retention.test.js

@@ -0,0 +1,20 @@
+import { describe, expect, it } from "vitest";
+import { EVENT_RETENTION_CLASS, RETENTION_DAYS, } from "./retention.js";
+describe("telemetry retention contract", () => {
+    it("operational_enum_count has a 90-day retention window", () => {
+        expect(RETENTION_DAYS.operational_enum_count).toBe(90);
+    });
+    it("codex.credential_health is assigned the operational_enum_count class", () => {
+        expect(EVENT_RETENTION_CLASS["codex.credential_health"]).toBe("operational_enum_count");
+    });
+    it("codex.credential_health resolves to 90 days", () => {
+        const cls = EVENT_RETENTION_CLASS["codex.credential_health"];
+        expect(cls).toBeDefined();
+        expect(RETENTION_DAYS[cls]).toBe(90);
+    });
+    it("interaction compatibility telemetry uses enum/count retention", () => {
+        expect(EVENT_RETENTION_CLASS["interaction.created"]).toBe("operational_enum_count");
+        expect(EVENT_RETENTION_CLASS["interaction.resolved"]).toBe("operational_enum_count");
+    });
+});
+//# sourceMappingURL=retention.test.js.map

package/dist/telemetry/retention.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.test.js","sourceRoot":"","sources":["../../src/telemetry/retention.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,cAAc,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,CAAC,qBAAqB,CAAC,yBAAyB,CAAC,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,GAAG,GAAG,qBAAqB,CAAC,yBAAyB,CAAC,CAAC;QAC7D,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,CAAC,cAAc,CAAC,GAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACpF,MAAM,CAAC,qBAAqB,CAAC,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/telemetry/state.d.ts

@@ -0,0 +1,3 @@
+import type { TelemetryState } from "./types.js";
+export declare function loadOrCreateState(stateDir: string, version: string): TelemetryState;
+//# sourceMappingURL=state.d.ts.map