@ascenda-one/agent-mcp 0.1.8 → 0.1.9

package/dist/cli.js

@@ -419,6 +419,93 @@ var require_out = __commonJS({
   }
 });
 
+// ../packages/tool-kit/out/eventLog.js
+var require_eventLog = __commonJS({
+  "../packages/tool-kit/out/eventLog.js"(exports) {
+    "use strict";
+    var __createBinding = exports && exports.__createBinding || (Object.create ? function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    } : function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    });
+    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? function(o, v) {
+      Object.defineProperty(o, "default", { enumerable: true, value: v });
+    } : function(o, v) {
+      o["default"] = v;
+    });
+    var __importStar = exports && exports.__importStar || /* @__PURE__ */ function() {
+      var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function(o2) {
+          var ar = [];
+          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
+          return ar;
+        };
+        return ownKeys(o);
+      };
+      return function(mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) {
+          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        }
+        __setModuleDefault(result, mod);
+        return result;
+      };
+    }();
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.EVENT_LOG_ENV_VAR = void 0;
+    exports.expandUserPath = expandUserPath;
+    exports.resolveEventLogPath = resolveEventLogPath;
+    exports.appendEventLog = appendEventLog;
+    var fs = __importStar(__require("fs"));
+    var os = __importStar(__require("os"));
+    var path = __importStar(__require("path"));
+    exports.EVENT_LOG_ENV_VAR = "ASCENDA_EVENT_LOG_FILE";
+    var MAX_BYTES = 5 * 1024 * 1024;
+    function expandUserPath(configured) {
+      const value = configured?.trim();
+      if (!value)
+        return void 0;
+      if (value === "~")
+        return os.homedir();
+      if (value.startsWith("~/"))
+        return path.join(os.homedir(), value.slice(2));
+      return path.resolve(value);
+    }
+    function resolveEventLogPath() {
+      return expandUserPath(process.env[exports.EVENT_LOG_ENV_VAR]);
+    }
+    function appendEventLog(logFilePath, entry) {
+      try {
+        rotateIfLarge(logFilePath);
+        const dir = path.dirname(logFilePath);
+        fs.mkdirSync(dir, { recursive: true, mode: 448 });
+        fs.appendFileSync(logFilePath, `${JSON.stringify(entry)}
+`, { encoding: "utf8", mode: 384 });
+        if (process.platform !== "win32")
+          fs.chmodSync(logFilePath, 384);
+      } catch {
+      }
+    }
+    function rotateIfLarge(logFilePath) {
+      try {
+        if (fs.statSync(logFilePath).size < MAX_BYTES)
+          return;
+        fs.renameSync(logFilePath, `${logFilePath}.1`);
+      } catch {
+      }
+    }
+  }
+});
+
 // ../packages/tool-kit/out/http.js
 var require_http = __commonJS({
   "../packages/tool-kit/out/http.js"(exports) {
@@ -428,6 +515,7 @@ var require_http = __commonJS({
     exports.createPairingSession = createPairingSession;
     exports.getPairingStatus = getPairingStatus;
     exports.renewToolToken = renewToolToken;
+    exports.isRetryableStatus = isRetryableStatus;
     exports.postToolEvent = postToolEvent;
     exports.postToolEventsBatch = postToolEventsBatch;
     exports.parseIngestResponse = parseIngestResponse;
@@ -473,26 +561,34 @@ var require_http = __commonJS({
         throw new AscendaApiError(response.status, void 0, await response.text());
       return await response.json();
     }
+    function isRetryableStatus(status) {
+      return status === 408 || status === 429 || status !== void 0 && status >= 500 && status <= 599;
+    }
     async function postToolEvent(apiBaseUrl, eventWriteToken, payload, signal) {
-      const response = await fetch(`${apiBaseUrl}/v1/tool-events`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json", Authorization: `Bearer ${eventWriteToken}` },
-        body: JSON.stringify(payload),
-        signal
-      });
-      return parseIngestResponse(response);
+      return sendIngest(`${apiBaseUrl}/v1/tool-events`, eventWriteToken, JSON.stringify(payload), signal);
     }
-    async function postToolEventsBatch(apiBaseUrl, eventWriteToken, payloads) {
-      const response = await fetch(`${apiBaseUrl}/v1/tool-events/batch`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json", Authorization: `Bearer ${eventWriteToken}` },
-        body: JSON.stringify({ events: payloads })
-      });
-      return parseIngestResponse(response);
+    async function postToolEventsBatch(apiBaseUrl, eventWriteToken, payloads, signal) {
+      return sendIngest(`${apiBaseUrl}/v1/tool-events/batch`, eventWriteToken, JSON.stringify({ events: payloads }), signal);
+    }
+    async function sendIngest(url, eventWriteToken, body, signal) {
+      try {
+        const response = await fetch(url, {
+          method: "POST",
+          headers: { "Content-Type": "application/json", Authorization: `Bearer ${eventWriteToken}` },
+          body,
+          signal
+        });
+        return parseIngestResponse(response);
+      } catch (error2) {
+        return {
+          result: "transport_error",
+          detail: error2 instanceof Error ? `${error2.name}: ${error2.message}` : String(error2)
+        };
+      }
     }
     async function parseIngestResponse(response) {
       if (response.ok)
-        return "accepted";
+        return { result: "accepted", httpStatus: response.status };
       const body = await response.text();
       let errorCode;
       try {
@@ -500,13 +596,14 @@ var require_http = __commonJS({
       } catch {
         errorCode = void 0;
       }
+      const base = { httpStatus: response.status, errorCode, detail: body || void 0 };
       if (response.status === 401)
-        return "auth_failed";
+        return { ...base, result: "auth_failed" };
       if (response.status === 403 && errorCode === "consent_missing_or_expired")
-        return "consent_missing";
+        return { ...base, result: "consent_missing" };
       if (response.status === 400 || response.status === 422)
-        return "validation_failed";
-      throw new AscendaApiError(response.status, errorCode, body);
+        return { ...base, result: "validation_failed" };
+      return { ...base, result: "transport_error" };
     }
   }
 });
@@ -556,6 +653,7 @@ var require_tokenStore = __commonJS({
     exports.defaultTokenFilePath = defaultTokenFilePath2;
     exports.persistEventWriteToken = persistEventWriteToken2;
     exports.readTokenFile = readTokenFile2;
+    exports.sanitizeFilePart = sanitizeFilePart;
     var fs = __importStar(__require("fs"));
     var os = __importStar(__require("os"));
     var path = __importStar(__require("path"));
@@ -587,15 +685,144 @@ var require_tokenStore = __commonJS({
   }
 });
 
+// ../packages/tool-kit/out/stateStore.js
+var require_stateStore = __commonJS({
+  "../packages/tool-kit/out/stateStore.js"(exports) {
+    "use strict";
+    var __createBinding = exports && exports.__createBinding || (Object.create ? function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    } : function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    });
+    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? function(o, v) {
+      Object.defineProperty(o, "default", { enumerable: true, value: v });
+    } : function(o, v) {
+      o["default"] = v;
+    });
+    var __importStar = exports && exports.__importStar || /* @__PURE__ */ function() {
+      var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function(o2) {
+          var ar = [];
+          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
+          return ar;
+        };
+        return ownKeys(o);
+      };
+      return function(mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) {
+          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        }
+        __setModuleDefault(result, mod);
+        return result;
+      };
+    }();
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.defaultStateFilePath = defaultStateFilePath;
+    exports.readCollectorState = readCollectorState;
+    exports.recordSendOutcome = recordSendOutcome;
+    exports.shouldAnnounceFailure = shouldAnnounceFailure;
+    exports.markFailureNotified = markFailureNotified;
+    var fs = __importStar(__require("fs"));
+    var os = __importStar(__require("os"));
+    var path = __importStar(__require("path"));
+    var tokenStore_1 = require_tokenStore();
+    function defaultStateFilePath(toolInstallationId) {
+      return path.join(os.homedir(), ".ascenda", "state", `${(0, tokenStore_1.sanitizeFilePart)(toolInstallationId)}.json`);
+    }
+    function readCollectorState(stateFilePath) {
+      try {
+        if (!fs.existsSync(stateFilePath))
+          return void 0;
+        const raw = fs.readFileSync(stateFilePath, "utf8").trim();
+        if (!raw)
+          return void 0;
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object")
+          return void 0;
+        return parsed;
+      } catch {
+        return void 0;
+      }
+    }
+    function recordSendOutcome(stateFilePath, toolInstallationId, outcome, detail = {}) {
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const previous = readCollectorState(stateFilePath);
+      const accepted = outcome === "accepted";
+      const next = {
+        toolInstallationId,
+        lastAttemptAt: now,
+        lastSuccessAt: accepted ? now : previous?.lastSuccessAt,
+        lastOutcome: outcome,
+        consecutiveFailures: accepted ? 0 : (previous?.consecutiveFailures ?? 0) + 1,
+        ...detail.httpStatus !== void 0 ? { httpStatus: detail.httpStatus } : {},
+        ...detail.errorCode !== void 0 ? { errorCode: detail.errorCode } : {},
+        ...detail.detail !== void 0 ? { detail: truncate(detail.detail) } : {},
+        // A success closes the episode; a failure either opens one or continues
+        // the one already open. Carrying `notifiedFailingSince` across a
+        // continuing episode is what keeps the notice to once per outage.
+        ...accepted ? {} : { failingSince: previous?.failingSince ?? now },
+        ...accepted ? {} : previous?.notifiedFailingSince !== void 0 ? { notifiedFailingSince: previous.notifiedFailingSince } : {}
+      };
+      writeStateFile(stateFilePath, next);
+      return next;
+    }
+    function shouldAnnounceFailure(state) {
+      if (!state || state.consecutiveFailures === 0 || !state.failingSince)
+        return false;
+      return state.notifiedFailingSince !== state.failingSince;
+    }
+    function markFailureNotified(stateFilePath, state) {
+      if (!state.failingSince)
+        return;
+      writeStateFile(stateFilePath, { ...state, notifiedFailingSince: state.failingSince });
+    }
+    function writeStateFile(stateFilePath, state) {
+      const temporaryPath = `${stateFilePath}.${process.pid}.tmp`;
+      try {
+        const dir = path.dirname(stateFilePath);
+        fs.mkdirSync(dir, { recursive: true, mode: 448 });
+        fs.writeFileSync(temporaryPath, `${JSON.stringify(state, null, 2)}
+`, { encoding: "utf8", mode: 384 });
+        fs.renameSync(temporaryPath, stateFilePath);
+        if (process.platform !== "win32")
+          fs.chmodSync(stateFilePath, 384);
+      } catch {
+        try {
+          if (fs.existsSync(temporaryPath))
+            fs.unlinkSync(temporaryPath);
+        } catch {
+        }
+      }
+    }
+    function truncate(value) {
+      const collapsed = value.replace(/\s+/g, " ").trim();
+      return collapsed.length > 200 ? `${collapsed.slice(0, 197)}...` : collapsed;
+    }
+  }
+});
+
 // ../packages/tool-kit/out/eventSender.js
 var require_eventSender = __commonJS({
   "../packages/tool-kit/out/eventSender.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.AscendaEventSender = exports.AscendaSemanticEventError = void 0;
+    exports.buildEventPayload = buildEventPayload;
     var tool_contract_1 = require_out();
+    var eventLog_1 = require_eventLog();
     var http_1 = require_http();
     var tokenStore_1 = require_tokenStore();
+    var stateStore_1 = require_stateStore();
     var AscendaSemanticEventError = class extends Error {
       constructor(message) {
         super(message);
@@ -603,27 +830,32 @@ var require_eventSender = __commonJS({
       }
     };
     exports.AscendaSemanticEventError = AscendaSemanticEventError;
+    function buildEventPayload(identity, mapped) {
+      return {
+        toolInstallationId: identity.toolInstallationId,
+        source: identity.source,
+        occurredAt: (/* @__PURE__ */ new Date()).toISOString(),
+        sessionId: identity.sessionId ?? void 0,
+        workspaceHash: identity.workspaceHash ?? void 0,
+        consentScope: tool_contract_1.ASCENDA_CONSENT_SCOPE,
+        provenance: tool_contract_1.ASCENDA_PROVENANCE,
+        privacyMode: "metadata_only",
+        ...mapped,
+        metadata: mapped.metadata ?? {}
+      };
+    }
+    var DEFAULT_TIMEOUT_MS = 5e3;
+    var RETRY_DELAY_MS = 250;
     var AscendaEventSender2 = class {
       config;
       eventWriteToken;
+      lastState;
       constructor(config2) {
         this.config = config2;
         this.eventWriteToken = config2.eventWriteToken;
       }
       async send(mapped) {
-        const payload = {
-          toolInstallationId: this.config.toolInstallationId,
-          source: this.config.source,
-          occurredAt: (/* @__PURE__ */ new Date()).toISOString(),
-          sessionId: this.config.sessionId ?? void 0,
-          workspaceHash: this.config.workspaceHash ?? void 0,
-          consentScope: tool_contract_1.ASCENDA_CONSENT_SCOPE,
-          provenance: tool_contract_1.ASCENDA_PROVENANCE,
-          privacyMode: "metadata_only",
-          ...mapped,
-          metadata: mapped.metadata ?? {}
-        };
-        return this.post(payload);
+        return this.post(buildEventPayload(this.config, mapped));
       }
       /**
        * Sends one of the six agent-observed types (dark-flow-gap-analysis §2.1).
@@ -694,32 +926,263 @@ var require_eventSender = __commonJS({
         };
         return this.post(payload);
       }
+      /**
+       * The single choke point every event passes through, and therefore the only
+       * honest place to journal one. Recording here rather than in each adapter is
+       * deliberate: Claude Code, Codex, the GitHub collector and the MCP server all
+       * send through this method, and the defect being fixed showed up in three
+       * separate components because each was left to notice its own failures.
+       */
       async post(payload) {
-        let result = await (0, http_1.postToolEvent)(this.config.apiBaseUrl, this.eventWriteToken, payload, this.signal());
-        if (result === "auth_failed") {
-          const renewed = await this.renewEventToken();
-          if (!renewed)
-            return "auth_failed";
-          result = await (0, http_1.postToolEvent)(this.config.apiBaseUrl, this.eventWriteToken, payload, this.signal());
+        const outcome = await this.attempt(payload);
+        this.lastState = (0, stateStore_1.recordSendOutcome)(this.stateFilePath(), this.config.toolInstallationId, outcome.result, {
+          httpStatus: outcome.httpStatus,
+          errorCode: outcome.errorCode,
+          detail: outcome.detail
+        });
+        this.log(payload, outcome.result);
+        return outcome.result;
+      }
+      /**
+       * Two recoveries, each tried once. A rejected token gets a renewal and one
+       * replay — rotation is expected and should heal unattended. A transport
+       * error gets one retry, because the common cases (a restarting instance, a
+       * proxy blip, a 429) clear in well under a second and the alternative is
+       * losing the event outright.
+       */
+      async attempt(payload) {
+        const outcome = await (0, http_1.postToolEvent)(this.config.apiBaseUrl, this.eventWriteToken, payload, this.signal());
+        if (outcome.result === "auth_failed") {
+          if (!await this.renewEventToken())
+            return outcome;
+          return (0, http_1.postToolEvent)(this.config.apiBaseUrl, this.eventWriteToken, payload, this.signal());
         }
-        return result;
+        if (outcome.result === "transport_error" && (outcome.httpStatus === void 0 || (0, http_1.isRetryableStatus)(outcome.httpStatus))) {
+          await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS));
+          return (0, http_1.postToolEvent)(this.config.apiBaseUrl, this.eventWriteToken, payload, this.signal());
+        }
+        return outcome;
+      }
+      /**
+       * The state written by the most recent send, so a caller can decide whether
+       * to surface a one-time notice without re-reading the journal it just wrote.
+       */
+      get state() {
+        return this.lastState;
+      }
+      stateFilePath() {
+        return this.config.stateFilePath ?? (0, stateStore_1.defaultStateFilePath)(this.config.toolInstallationId);
+      }
+      /** Never throws: a renewal that errors is a failed renewal, not a failed turn. */
+      /**
+       * Every send path funnels through {@link post}, so semantic and
+       * collaboration signals are logged on the same terms as host events — the
+       * log would be misleading as an audit of what left the machine otherwise.
+       *
+       * An unreachable backend used to be logged as `other` from a catch block.
+       * It is now `transport_error` through the ordinary path, because the
+       * transport returns that outcome instead of throwing.
+       */
+      log(payload, delivery) {
+        const logFile = this.config.eventLogFile === void 0 ? (0, eventLog_1.resolveEventLogPath)() : this.config.eventLogFile;
+        if (!logFile)
+          return;
+        (0, eventLog_1.appendEventLog)(logFile, { loggedAt: (/* @__PURE__ */ new Date()).toISOString(), delivery, payload });
       }
       async renewEventToken() {
-        const renewed = await (0, http_1.renewToolToken)(this.config.apiBaseUrl, this.eventWriteToken, this.signal());
-        if (!renewed)
+        try {
+          const renewed = await (0, http_1.renewToolToken)(this.config.apiBaseUrl, this.eventWriteToken, this.signal());
+          if (!renewed)
+            return false;
+          this.eventWriteToken = renewed.eventWriteToken;
+          (0, tokenStore_1.persistEventWriteToken)(this.config.tokenFilePath, renewed.eventWriteToken);
+          return true;
+        } catch {
           return false;
-        this.eventWriteToken = renewed.eventWriteToken;
-        (0, tokenStore_1.persistEventWriteToken)(this.config.tokenFilePath, renewed.eventWriteToken);
-        return true;
+        }
       }
       signal() {
-        return this.config.timeoutMs ? AbortSignal.timeout(this.config.timeoutMs) : void 0;
+        return AbortSignal.timeout(this.config.timeoutMs ?? DEFAULT_TIMEOUT_MS);
       }
     };
     exports.AscendaEventSender = AscendaEventSender2;
   }
 });
 
+// ../packages/tool-kit/out/hookAdapter.js
+var require_hookAdapter = __commonJS({
+  "../packages/tool-kit/out/hookAdapter.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.DEFAULT_API_BASE_URL = void 0;
+    exports.loadCliAgentConfig = loadCliAgentConfig;
+    exports.deliverHookEvents = deliverHookEvents;
+    var eventLog_1 = require_eventLog();
+    var eventSender_1 = require_eventSender();
+    var tokenStore_1 = require_tokenStore();
+    exports.DEFAULT_API_BASE_URL = "https://api.ascenda.one";
+    function loadCliAgentConfig(toolType, sessionIdFromHook) {
+      const apiBaseUrl = (process.env.ASCENDA_API_BASE_URL ?? exports.DEFAULT_API_BASE_URL).replace(/\/$/, "");
+      const toolInstallationIdRaw = process.env.ASCENDA_TOOL_INSTALLATION_ID;
+      if (!toolInstallationIdRaw)
+        throw new Error("Missing ASCENDA_TOOL_INSTALLATION_ID");
+      const toolInstallationId = toolInstallationIdRaw.trim().includes(":") ? toolInstallationIdRaw.trim() : `${toolType}:${toolInstallationIdRaw.trim()}`;
+      const tokenFilePath = process.env.ASCENDA_EVENT_WRITE_TOKEN_FILE ?? (0, tokenStore_1.defaultTokenFilePath)(toolInstallationId);
+      const fileToken = (0, tokenStore_1.readTokenFile)(tokenFilePath);
+      const eventWriteToken = fileToken ?? process.env.ASCENDA_EVENT_WRITE_TOKEN;
+      if (!eventWriteToken)
+        throw new Error("Missing ASCENDA_EVENT_WRITE_TOKEN (or token file)");
+      if (!fileToken)
+        (0, tokenStore_1.persistEventWriteToken)(tokenFilePath, eventWriteToken);
+      return {
+        apiBaseUrl,
+        toolInstallationId,
+        eventWriteToken,
+        tokenFilePath,
+        sessionId: process.env.ASCENDA_SESSION_ID ?? sessionIdFromHook ?? null,
+        workspaceHash: process.env.ASCENDA_WORKSPACE_HASH ?? null,
+        // Agents await command hooks; fail fast rather than stall the user's turn.
+        timeoutMs: parsePositiveInt(process.env.ASCENDA_HTTP_TIMEOUT_MS) ?? 3e3
+      };
+    }
+    async function deliverHookEvents(events, options) {
+      if (events.length === 0)
+        return;
+      const notice = options.onNotice ?? ((message) => console.error(message));
+      let config2;
+      try {
+        config2 = loadCliAgentConfig(options.toolType, options.sessionId);
+      } catch (error2) {
+        const logFile = (0, eventLog_1.resolveEventLogPath)();
+        if (!logFile)
+          throw error2;
+        for (const event of events) {
+          (0, eventLog_1.appendEventLog)(logFile, {
+            loggedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            delivery: "not_sent",
+            payload: (0, eventSender_1.buildEventPayload)({
+              toolInstallationId: `${options.toolType}:unpaired`,
+              source: options.source,
+              sessionId: options.sessionId ?? null,
+              workspaceHash: process.env.ASCENDA_WORKSPACE_HASH ?? null
+            }, event)
+          });
+        }
+        return;
+      }
+      const sender = new eventSender_1.AscendaEventSender({
+        apiBaseUrl: config2.apiBaseUrl,
+        toolInstallationId: config2.toolInstallationId,
+        source: options.source,
+        eventWriteToken: config2.eventWriteToken,
+        tokenFilePath: config2.tokenFilePath,
+        sessionId: config2.sessionId,
+        workspaceHash: config2.workspaceHash,
+        timeoutMs: config2.timeoutMs
+      });
+      for (const event of events) {
+        const result = await sender.send(event);
+        if (result === "accepted")
+          continue;
+        if (result === "consent_missing") {
+          notice("Ascenda telemetry paused: renew IDE telemetry consent in the Ascenda app.");
+        } else if (result === "auth_failed") {
+          notice("Ascenda telemetry paused: connection revoked or expired. Re-pair via an Ascenda IDE extension or pairing-sim.");
+        } else if (result === "transport_error") {
+          notice("Ascenda telemetry paused: the ingest endpoint could not be reached. Your work is unaffected.");
+        } else {
+          notice(`Ascenda telemetry rejected: ${result}`);
+        }
+        return;
+      }
+    }
+    function parsePositiveInt(value) {
+      const n = Number(value);
+      return Number.isInteger(n) && n > 0 ? n : void 0;
+    }
+  }
+});
+
+// ../packages/tool-kit/out/turnState.js
+var require_turnState = __commonJS({
+  "../packages/tool-kit/out/turnState.js"(exports) {
+    "use strict";
+    var __createBinding = exports && exports.__createBinding || (Object.create ? function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    } : function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    });
+    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? function(o, v) {
+      Object.defineProperty(o, "default", { enumerable: true, value: v });
+    } : function(o, v) {
+      o["default"] = v;
+    });
+    var __importStar = exports && exports.__importStar || /* @__PURE__ */ function() {
+      var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function(o2) {
+          var ar = [];
+          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
+          return ar;
+        };
+        return ownKeys(o);
+      };
+      return function(mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) {
+          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        }
+        __setModuleDefault(result, mod);
+        return result;
+      };
+    }();
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.recordTurnStart = recordTurnStart;
+    exports.consumeTurnDurationMs = consumeTurnDurationMs;
+    var fs = __importStar(__require("fs"));
+    var os = __importStar(__require("os"));
+    var path = __importStar(__require("path"));
+    var stateDir = () => process.env.ASCENDA_STATE_DIR ?? path.join(os.homedir(), ".ascenda", "state");
+    function turnFile(agent, sessionId) {
+      return path.join(stateDir(), `${sanitize(agent)}-turn-${sanitize(sessionId)}`);
+    }
+    function sanitize(value) {
+      return value.replace(/[^a-zA-Z0-9._-]/g, "_");
+    }
+    function recordTurnStart(agent, sessionId, now = Date.now()) {
+      if (!sessionId)
+        return;
+      try {
+        fs.mkdirSync(stateDir(), { recursive: true });
+        fs.writeFileSync(turnFile(agent, sessionId), String(now), { encoding: "utf8", mode: 384 });
+      } catch {
+      }
+    }
+    function consumeTurnDurationMs(agent, sessionId, now = Date.now()) {
+      if (!sessionId)
+        return void 0;
+      const file = turnFile(agent, sessionId);
+      try {
+        const started = Number(fs.readFileSync(file, "utf8").trim());
+        fs.rmSync(file, { force: true });
+        if (!Number.isFinite(started) || started <= 0 || started > now)
+          return void 0;
+        return now - started;
+      } catch {
+        return void 0;
+      }
+    }
+  }
+});
+
 // ../packages/tool-kit/out/salt.js
 var require_salt = __commonJS({
   "../packages/tool-kit/out/salt.js"(exports) {
@@ -934,7 +1397,8 @@ var require_out2 = __commonJS({
   "../packages/tool-kit/out/index.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.parseIngestResponse = exports.postToolEventsBatch = exports.postToolEvent = exports.renewToolToken = exports.getPairingStatus = exports.createPairingSession = exports.AscendaApiError = exports.liveBusSocketCandidates = exports.liveBusSocketPath = exports.bucketPromptSize = exports.emitLiveSignal = exports.hashWithMachineSalt = exports.readOrCreateMachineSalt = exports.machineSaltFilePath = exports.readTokenFile = exports.persistEventWriteToken = exports.defaultTokenFilePath = exports.AscendaSemanticEventError = exports.AscendaEventSender = exports.looksLikeCorrection = exports.outcomeForHook = exports.inferOutcome = exports.getNestedNumber = exports.getNestedString = exports.getNested = exports.getNumber = exports.getString = exports.isAfterHours = exports.bucketDurationMs = exports.bucketLinesChanged = exports.invitesDebrief = exports.classifyWorkMilestone = exports.isReworkGitAction = exports.classifyGitAction = exports.isVerificationCommand = exports.classifyCommand = void 0;
+    exports.postToolEventsBatch = exports.postToolEvent = exports.renewToolToken = exports.getPairingStatus = exports.createPairingSession = exports.AscendaApiError = exports.liveBusSocketCandidates = exports.liveBusSocketPath = exports.bucketPromptSize = exports.emitLiveSignal = 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.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.isAfterHours = exports.bucketDurationMs = exports.bucketLinesChanged = exports.invitesDebrief = exports.classifyWorkMilestone = exports.isReworkGitAction = exports.classifyGitAction = exports.isVerificationCommand = exports.classifyCommand = void 0;
+    exports.isRetryableStatus = exports.parseIngestResponse = void 0;
     var commandClassifier_1 = require_commandClassifier();
     Object.defineProperty(exports, "classifyCommand", { enumerable: true, get: function() {
       return commandClassifier_1.classifyCommand;
@@ -999,6 +1463,39 @@ var require_out2 = __commonJS({
     Object.defineProperty(exports, "AscendaSemanticEventError", { enumerable: true, get: function() {
       return eventSender_1.AscendaSemanticEventError;
     } });
+    Object.defineProperty(exports, "buildEventPayload", { enumerable: true, get: function() {
+      return eventSender_1.buildEventPayload;
+    } });
+    var eventLog_1 = require_eventLog();
+    Object.defineProperty(exports, "EVENT_LOG_ENV_VAR", { enumerable: true, get: function() {
+      return eventLog_1.EVENT_LOG_ENV_VAR;
+    } });
+    Object.defineProperty(exports, "appendEventLog", { enumerable: true, get: function() {
+      return eventLog_1.appendEventLog;
+    } });
+    Object.defineProperty(exports, "expandUserPath", { enumerable: true, get: function() {
+      return eventLog_1.expandUserPath;
+    } });
+    Object.defineProperty(exports, "resolveEventLogPath", { enumerable: true, get: function() {
+      return eventLog_1.resolveEventLogPath;
+    } });
+    var hookAdapter_1 = require_hookAdapter();
+    Object.defineProperty(exports, "DEFAULT_API_BASE_URL", { enumerable: true, get: function() {
+      return hookAdapter_1.DEFAULT_API_BASE_URL;
+    } });
+    Object.defineProperty(exports, "deliverHookEvents", { enumerable: true, get: function() {
+      return hookAdapter_1.deliverHookEvents;
+    } });
+    Object.defineProperty(exports, "loadCliAgentConfig", { enumerable: true, get: function() {
+      return hookAdapter_1.loadCliAgentConfig;
+    } });
+    var turnState_1 = require_turnState();
+    Object.defineProperty(exports, "consumeTurnDurationMs", { enumerable: true, get: function() {
+      return turnState_1.consumeTurnDurationMs;
+    } });
+    Object.defineProperty(exports, "recordTurnStart", { enumerable: true, get: function() {
+      return turnState_1.recordTurnStart;
+    } });
     var tokenStore_1 = require_tokenStore();
     Object.defineProperty(exports, "defaultTokenFilePath", { enumerable: true, get: function() {
       return tokenStore_1.defaultTokenFilePath;
@@ -1009,6 +1506,22 @@ var require_out2 = __commonJS({
     Object.defineProperty(exports, "readTokenFile", { enumerable: true, get: function() {
       return tokenStore_1.readTokenFile;
     } });
+    var stateStore_1 = require_stateStore();
+    Object.defineProperty(exports, "defaultStateFilePath", { enumerable: true, get: function() {
+      return stateStore_1.defaultStateFilePath;
+    } });
+    Object.defineProperty(exports, "readCollectorState", { enumerable: true, get: function() {
+      return stateStore_1.readCollectorState;
+    } });
+    Object.defineProperty(exports, "recordSendOutcome", { enumerable: true, get: function() {
+      return stateStore_1.recordSendOutcome;
+    } });
+    Object.defineProperty(exports, "shouldAnnounceFailure", { enumerable: true, get: function() {
+      return stateStore_1.shouldAnnounceFailure;
+    } });
+    Object.defineProperty(exports, "markFailureNotified", { enumerable: true, get: function() {
+      return stateStore_1.markFailureNotified;
+    } });
     var salt_1 = require_salt();
     Object.defineProperty(exports, "machineSaltFilePath", { enumerable: true, get: function() {
       return salt_1.machineSaltFilePath;
@@ -1054,6 +1567,9 @@ var require_out2 = __commonJS({
     Object.defineProperty(exports, "parseIngestResponse", { enumerable: true, get: function() {
       return http_1.parseIngestResponse;
     } });
+    Object.defineProperty(exports, "isRetryableStatus", { enumerable: true, get: function() {
+      return http_1.isRetryableStatus;
+    } });
   }
 });
 

package/package.json

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