@ascenda-one/agent-mcp 0.1.13 → 0.1.15

package/dist/cli.js

@@ -381,12 +381,155 @@ var require_payload = __commonJS({
   }
 });
 
+// ../packages/tool-contract/out/metricKeys.js
+var require_metricKeys = __commonJS({
+  "../packages/tool-contract/out/metricKeys.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.METRIC_KEYS = void 0;
+    exports.backendMetricKeys = backendMetricKeys;
+    var CONTEXT_WINDOW_CANONICAL_ALIASES = [
+      "contextWindowPeakPct",
+      "context_window_peak_pct",
+      "contextWindowPct",
+      "context_window_pct"
+    ];
+    var CONTEXT_WINDOW_CURSOR_PERCENT_ALIASES = ["contextUsagePercent"];
+    exports.METRIC_KEYS = {
+      // ── Read by a backend reader ────────────────────────────────────────────
+      contextWindowPeakPct: {
+        readBy: ["backend", "handoff"],
+        backendAliases: CONTEXT_WINDOW_CANONICAL_ALIASES,
+        unit: "fraction of the context window (0\u20131; uncapped for >200k contexts)",
+        note: "Claude Code reports a true per-session peak. Cursor reports its composer's last known occupancy under the same key \u2014 the closest its store can answer, and not the same measurement."
+      },
+      contextUsagePercent: {
+        readBy: ["backend", "handoff"],
+        backendAliases: CONTEXT_WINDOW_CURSOR_PERCENT_ALIASES,
+        unit: "percent (0\u2013100)",
+        note: "Cursor's own column name. Superseded by contextWindowPeakPct on the wire; kept because the handoff reads it and imported rows carry it. Unit-explicit on the backend: always divided by 100, never put through the fraction-or-percent heuristic."
+      },
+      promptCount: { readBy: ["backend", "handoff"], backendAliases: ["promptCount", "prompt_count"] },
+      sessionMinutes: { readBy: ["backend"], backendAliases: ["sessionMinutes", "session_minutes"], unit: "minutes" },
+      durationBucket: { readBy: ["backend", "handoff"], backendAliases: ["durationBucket", "duration_bucket"] },
+      afterHoursPrompts: { readBy: ["backend", "handoff"], backendAliases: ["afterHoursPrompts", "after_hours_prompts"] },
+      inputTokens: { readBy: ["backend"], backendAliases: ["inputTokens", "input_tokens"], unit: "tokens" },
+      outputTokens: { readBy: ["backend"], backendAliases: ["outputTokens", "output_tokens"], unit: "tokens" },
+      cacheReadTokens: { readBy: ["backend"], backendAliases: ["cacheReadTokens", "cache_read_tokens"], unit: "tokens" },
+      queuedPrompts: { readBy: ["backend"], backendAliases: ["queuedPrompts", "queued_prompts"] },
+      linesChangedBucket: { readBy: ["backend"], backendAliases: ["linesChangedBucket", "lines_changed_bucket"] },
+      // ── Read by the local handoff only ──────────────────────────────────────
+      activeMinutes: { readBy: ["handoff"], unit: "minutes" },
+      afterHoursRequests: { readBy: ["handoff"] },
+      approximateLintErrorsCount: { readBy: ["handoff"] },
+      canceledCount: { readBy: ["handoff"] },
+      chatEditCount: { readBy: ["handoff"] },
+      compactionCount: {
+        readBy: ["handoff"],
+        note: "The backend counts context_compression_* event rows, not this key. Both are emitted; this one is for the handoff."
+      },
+      contextWindowPeakTokens: {
+        readBy: ["handoff"],
+        unit: "tokens",
+        note: "The measured quantity, with no assumed denominator. Prefer this to the ratio for any within-person baseline."
+      },
+      date: { readBy: ["handoff"] },
+      errorCount: { readBy: ["handoff"] },
+      filesChangedCount: { readBy: ["handoff"] },
+      humanChangesCount: { readBy: ["handoff"] },
+      linesAdded: { readBy: ["handoff"] },
+      linesRemoved: { readBy: ["handoff"] },
+      primaryModel: { readBy: ["handoff"] },
+      requestCount: { readBy: ["handoff"] },
+      sessionStartedAt: { readBy: ["handoff"] },
+      subagentComposers: { readBy: ["handoff"] },
+      subagentToolCallCount: {
+        readBy: ["handoff"],
+        note: "Claude Code only: calls made inside subagent transcripts, kept out of toolCallCount so the main-loop count matches what the wire events carry."
+      },
+      subagentTranscripts: { readBy: ["handoff"] },
+      toolCallCount: {
+        readBy: ["handoff"],
+        note: "The backend counts ai_tool_call_started event rows, not this key \u2014 same split as compactionCount. Deduplicated on the tool-call id; see each extractor for what one call means in its store."
+      },
+      toolCallsUndated: {
+        readBy: ["handoff"],
+        note: "Cursor only: calls whose every record carries an empty createdAt. Counted in toolCallCount, but no event exists for them \u2014 the wire total is smaller than this session count by exactly this number."
+      },
+      toolFailureCount: { readBy: ["handoff"] },
+      totalEntryCount: { readBy: ["handoff"] },
+      userModifiedEditCount: {
+        readBy: ["handoff"],
+        note: "Null, never 0 \u2014 Claude Code never sets userModified true, so 0 would assert 'no AI edit was ever corrected by hand'."
+      },
+      // ── Diagnostic: read by nobody, on purpose ──────────────────────────────
+      abandonedPromptCount: { readBy: ["diagnostic"] },
+      // Epoch-marker metrics. The marker is local-only and never reaches the wire
+      // (see EXTRACTION_EPOCH_KIND), but it travels as a NormalizedHistoricalEvent
+      // and so is keyed by the same vocabulary.
+      windowOldest: { readBy: ["handoff"], note: "Oldest event the extraction saw \u2014 the marker's left edge." },
+      windowNewest: { readBy: ["handoff"], note: "Newest event the extraction saw \u2014 the marker's right edge." },
+      projectsWithNoReadableTranscript: { readBy: ["diagnostic"] },
+      unparsedComposerHeaders: { readBy: ["diagnostic"] },
+      unknownComposerHeaderTypes: { readBy: ["diagnostic"] },
+      orphanedBubbles: { readBy: ["diagnostic"] },
+      orphanedSubagentBubbles: { readBy: ["diagnostic"] },
+      sessionsWithoutTimeline: { readBy: ["diagnostic"] },
+      emptyComposers: { readBy: ["diagnostic"] },
+      apiErrorCount: { readBy: ["diagnostic"] },
+      assistantTurns: { readBy: ["diagnostic"] },
+      compactionAutoCount: { readBy: ["diagnostic"] },
+      compactionManualCount: { readBy: ["diagnostic"] },
+      editDayCount: { readBy: ["diagnostic"] },
+      emptyChatSessions: { readBy: ["diagnostic"] },
+      gitBranch: { readBy: ["diagnostic"] },
+      linesChanged: { readBy: ["diagnostic"] },
+      malformedChatSessionLines: { readBy: ["diagnostic"] },
+      malformedHistoryEntries: { readBy: ["diagnostic"] },
+      mode: { readBy: ["diagnostic"] },
+      modelCount: { readBy: ["diagnostic"] },
+      modelSwitchCount: { readBy: ["diagnostic"] },
+      rapidRepromptCount: { readBy: ["diagnostic"] },
+      schemaUnreadable: { readBy: ["diagnostic"] },
+      sessionCount: { readBy: ["diagnostic"] },
+      sessionsFromBubbleTimeline: { readBy: ["diagnostic"] },
+      sessionsFromCheckpointTimeline: { readBy: ["diagnostic"] },
+      sessionsFromRecencyTimeline: { readBy: ["diagnostic"] },
+      subagentAssistantTurns: { readBy: ["diagnostic"] },
+      subagentPrompts: { readBy: ["diagnostic"] },
+      subagentTokensTotal: { readBy: ["diagnostic"] },
+      toolName: {
+        readBy: ["diagnostic"],
+        note: "Set per ai_tool_call_started event by #43's extractors and shipped in wire metadata, but no reader resolves it server-side yet (the backend's ToolName column is MCP audit, not telemetry). Registered after the fact: #38 and #43 merged past each other, and the union caught it on the next compile \u2014 metaLines all over again."
+      },
+      toolResultCount: { readBy: ["diagnostic"] },
+      toolResultErrorCount: { readBy: ["diagnostic"] },
+      unknownBubbles: { readBy: ["diagnostic"] },
+      unknownLines: { readBy: ["diagnostic"] },
+      metaLines: {
+        readBy: ["diagnostic"],
+        note: 'Recognised-but-skipped transcript machinery (file-history-snapshot, queued-command, \u2026). Split out of unknownLines by #43 so that number keeps meaning "a type nobody has looked at". Registered here after the fact: #41 and #43 merged past each other, and the union caught it on the next compile \u2014 which is this module doing its job.'
+      },
+      unparsedBubbles: { readBy: ["diagnostic"] },
+      unparsedChatSessionFiles: { readBy: ["diagnostic"] },
+      unparsedHistoryFiles: { readBy: ["diagnostic"] },
+      unparsedLines: { readBy: ["diagnostic"] },
+      unreadableChatSessionFiles: { readBy: ["diagnostic"] },
+      unreadableHistoryFiles: { readBy: ["diagnostic"] },
+      unrecognisedChatSessionFiles: { readBy: ["diagnostic"] }
+    };
+    function backendMetricKeys() {
+      return Object.entries(exports.METRIC_KEYS).filter(([, spec]) => spec.readBy.includes("backend")).map(([key, spec]) => [key, spec.backendAliases ?? [key]]);
+    }
+  }
+});
+
 // ../packages/tool-contract/out/index.js
 var require_out = __commonJS({
   "../packages/tool-contract/out/index.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.ASCENDA_SEMANTIC_PROVENANCE = exports.ASCENDA_HISTORICAL_CONSENT_SCOPE = exports.ASCENDA_COLLABORATION_CONSENT_SCOPE = exports.ASCENDA_SEMANTIC_CONSENT_SCOPE = exports.ASCENDA_PROVENANCE = exports.ASCENDA_CONSENT_SCOPE = exports.EVENT_WORKLOAD_CATEGORY = exports.COLLABORATION_EVENT_TYPES = exports.SEMANTIC_WORK_SIGNAL_EVENT_TYPES = void 0;
+    exports.backendMetricKeys = exports.METRIC_KEYS = exports.ASCENDA_SEMANTIC_PROVENANCE = exports.ASCENDA_HISTORICAL_CONSENT_SCOPE = exports.ASCENDA_COLLABORATION_CONSENT_SCOPE = exports.ASCENDA_SEMANTIC_CONSENT_SCOPE = exports.ASCENDA_PROVENANCE = exports.ASCENDA_CONSENT_SCOPE = exports.EVENT_WORKLOAD_CATEGORY = exports.COLLABORATION_EVENT_TYPES = exports.SEMANTIC_WORK_SIGNAL_EVENT_TYPES = void 0;
     exports.SEMANTIC_WORK_SIGNAL_EVENT_TYPES = [
       "approach_churn_detected",
       "goal_drift_detected",
@@ -445,6 +588,13 @@ var require_out = __commonJS({
     exports.ASCENDA_COLLABORATION_CONSENT_SCOPE = "workflow_telemetry";
     exports.ASCENDA_HISTORICAL_CONSENT_SCOPE = "historical_import";
     exports.ASCENDA_SEMANTIC_PROVENANCE = "semantic_work_signals";
+    var metricKeys_1 = require_metricKeys();
+    Object.defineProperty(exports, "METRIC_KEYS", { enumerable: true, get: function() {
+      return metricKeys_1.METRIC_KEYS;
+    } });
+    Object.defineProperty(exports, "backendMetricKeys", { enumerable: true, get: function() {
+      return metricKeys_1.backendMetricKeys;
+    } });
   }
 });
 
@@ -679,6 +829,7 @@ var require_tokenStore = __commonJS({
       };
     }();
     Object.defineProperty(exports, "__esModule", { value: true });
+    exports.ascendaHome = ascendaHome;
     exports.defaultTokenFilePath = defaultTokenFilePath2;
     exports.persistEventWriteToken = persistEventWriteToken2;
     exports.readTokenFile = readTokenFile2;
@@ -686,8 +837,11 @@ var require_tokenStore = __commonJS({
     var fs = __importStar(__require("fs"));
     var os = __importStar(__require("os"));
     var path = __importStar(__require("path"));
+    function ascendaHome() {
+      return process.env.ASCENDA_HOME ?? path.join(os.homedir(), ".ascenda");
+    }
     function defaultTokenFilePath2(toolInstallationId) {
-      return path.join(os.homedir(), ".ascenda", "tokens", sanitizeFilePart(toolInstallationId));
+      return path.join(ascendaHome(), "tokens", sanitizeFilePart(toolInstallationId));
     }
     function persistEventWriteToken2(tokenFilePath, token) {
       const dir = path.dirname(tokenFilePath);
@@ -1646,6 +1800,7 @@ var require_liveBus = __commonJS({
     var path = __importStar(__require("path"));
     var WRITE_TIMEOUT_MS = 50;
     var APP_BUNDLE_ID = "one.ascenda.ascendaMissionControl";
+    var SAVER_HOST_BUNDLE_ID = "com.apple.ScreenSaver.Engine.legacyScreenSaver";
     function liveBusSocketCandidates() {
       const override = process.env.ASCENDA_LIVE_BUS_SOCKET;
       if (override)
@@ -1653,7 +1808,8 @@ var require_liveBus = __commonJS({
       const home = os.homedir();
       return [
         path.join(home, ".ascenda", "live.sock"),
-        path.join(home, "Library", "Containers", APP_BUNDLE_ID, "Data", ".ascenda", "live.sock")
+        path.join(home, "Library", "Containers", APP_BUNDLE_ID, "Data", ".ascenda", "live.sock"),
+        path.join(home, "Library", "Containers", SAVER_HOST_BUNDLE_ID, "Data", "l.sock")
       ];
     }
     function liveBusSocketPath() {
@@ -1725,8 +1881,8 @@ var require_out2 = __commonJS({
   "../packages/tool-kit/out/index.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.workContextRegistryFilePath = exports.readWorkContextRegistry = exports.recordWorkContextAlias = exports.recordWorkContext = exports.deriveWorkContext = exports.hashWithMachineSalt = exports.readOrCreateMachineSalt = exports.machineSaltFilePath = exports.markFailureNotified = exports.shouldAnnounceFailure = exports.recordSendOutcome = exports.readCollectorState = exports.defaultStateFilePath = exports.readTokenFile = exports.persistEventWriteToken = exports.defaultTokenFilePath = exports.recordTurnStart = exports.consumeTurnDurationMs = exports.resolveContextHashes = exports.loadCliAgentConfig = exports.deliverHookEvents = exports.DEFAULT_API_BASE_URL = exports.resolveEventLogPath = exports.expandUserPath = exports.appendEventLog = exports.EVENT_LOG_ENV_VAR = exports.buildEventPayload = exports.AscendaSemanticEventError = exports.AscendaEventSender = exports.looksLikeCorrection = exports.outcomeForHook = exports.inferOutcome = exports.getNestedNumber = exports.getNestedString = exports.getNested = exports.getNumber = exports.getString = exports.localHourAt = exports.utcOffsetMinutesAt = exports.BUSINESS_DAY = exports.isOutsideBusinessHours = exports.isAfterHours = exports.bucketDurationMs = exports.bucketLinesChanged = exports.invitesDebrief = exports.classifyWorkMilestone = exports.isReworkGitAction = exports.classifyGitAction = exports.isVerificationCommand = exports.classifyCommand = void 0;
-    exports.isRetryableStatus = exports.parseIngestResponse = exports.postToolEventsBatch = exports.postToolEvent = exports.renewToolToken = exports.getPairingStatus = exports.createPairingSession = exports.AscendaApiError = exports.liveBusSocketCandidates = exports.liveBusSocketPath = exports.bucketPromptSize = exports.emitLiveSignal = void 0;
+    exports.readWorkContextRegistry = exports.recordWorkContextAlias = exports.recordWorkContext = exports.deriveWorkContext = exports.hashWithMachineSalt = exports.readOrCreateMachineSalt = exports.machineSaltFilePath = exports.markFailureNotified = exports.shouldAnnounceFailure = exports.recordSendOutcome = exports.readCollectorState = exports.defaultStateFilePath = exports.readTokenFile = exports.persistEventWriteToken = exports.defaultTokenFilePath = exports.ascendaHome = exports.recordTurnStart = exports.consumeTurnDurationMs = exports.resolveContextHashes = exports.loadCliAgentConfig = exports.deliverHookEvents = exports.DEFAULT_API_BASE_URL = exports.resolveEventLogPath = exports.expandUserPath = exports.appendEventLog = exports.EVENT_LOG_ENV_VAR = exports.buildEventPayload = exports.AscendaSemanticEventError = exports.AscendaEventSender = exports.looksLikeCorrection = exports.outcomeForHook = exports.inferOutcome = exports.getNestedNumber = exports.getNestedString = exports.getNested = exports.getNumber = exports.getString = exports.localHourAt = exports.utcOffsetMinutesAt = exports.BUSINESS_DAY = exports.isOutsideBusinessHours = exports.isAfterHours = exports.bucketDurationMs = exports.bucketLinesChanged = exports.invitesDebrief = exports.classifyWorkMilestone = exports.isReworkGitAction = exports.classifyGitAction = exports.isVerificationCommand = exports.classifyCommand = void 0;
+    exports.isRetryableStatus = exports.parseIngestResponse = exports.postToolEventsBatch = exports.postToolEvent = exports.renewToolToken = exports.getPairingStatus = exports.createPairingSession = exports.AscendaApiError = exports.liveBusSocketCandidates = exports.liveBusSocketPath = exports.bucketPromptSize = exports.emitLiveSignal = exports.workContextRegistryFilePath = void 0;
     var commandClassifier_1 = require_commandClassifier();
     Object.defineProperty(exports, "classifyCommand", { enumerable: true, get: function() {
       return commandClassifier_1.classifyCommand;
@@ -1840,6 +1996,9 @@ var require_out2 = __commonJS({
       return turnState_1.recordTurnStart;
     } });
     var tokenStore_1 = require_tokenStore();
+    Object.defineProperty(exports, "ascendaHome", { enumerable: true, get: function() {
+      return tokenStore_1.ascendaHome;
+    } });
     Object.defineProperty(exports, "defaultTokenFilePath", { enumerable: true, get: function() {
       return tokenStore_1.defaultTokenFilePath;
     } });

package/package.json

@@ -1,7 +1,7 @@
 {
   "publishConfig": { "access": "public" },
   "name": "@ascenda-one/agent-mcp",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "MCP server exposing ascenda_emit_work_signal — the one submission interface for agent-observed (semantic) work-friction signals.",
   "repository": {
     "type": "git",