@ascenda-one/agent-mcp 0.1.3

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,wEAAwE;IACxE,0EAA0E;IAC1E,0EAA0E;IAC1E,wBAAwB;IACxB,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/config.js

@@ -0,0 +1,46 @@
+import { defaultTokenFilePath, persistEventWriteToken, readTokenFile } from "@ascenda-one/tool-kit";
+import { randomUUID } from "node:crypto";
+/**
+ * Unlike the hook CLIs (one process per invocation, one tool type each),
+ * this server is long-lived and host-agnostic — the same binary runs under
+ * Claude Code, Cursor, or anything else that can launch an MCP server. It
+ * therefore does **not** mint a tool-type prefix the way
+ * `ascenda-claude-code-hooks`/`ascenda-codex-hooks` do: minting one here
+ * would pair this process as a *third* tool even when the same physical
+ * installation already paired through a hook or an IDE extension, silently
+ * fragmenting one person's telemetry across multiple tool identities.
+ *
+ * The user is expected to reuse the fully-qualified id already shown by
+ * their existing pairing (`ascenda-claude-hook doctor`-equivalent output,
+ * or the extension's "Ascenda: Show Status" command) — an id that already
+ * contains `:`. An unqualified value is refused rather than guessed.
+ */
+export function loadConfigFromEnv() {
+    const apiBaseUrl = (process.env.ASCENDA_API_BASE_URL ?? "https://api.ascenda.one").replace(/\/$/, "");
+    const toolInstallationId = process.env.ASCENDA_TOOL_INSTALLATION_ID?.trim();
+    if (!toolInstallationId) {
+        throw new Error("Missing ASCENDA_TOOL_INSTALLATION_ID");
+    }
+    if (!toolInstallationId.includes(":")) {
+        throw new Error("ASCENDA_TOOL_INSTALLATION_ID must be the fully-qualified id from your existing pairing " +
+            '(e.g. "claude_code:abc123"), not a bare id. This server reuses an existing pairing rather ' +
+            "than minting a new one — copy the value your hook adapter or IDE extension already shows.");
+    }
+    const tokenFilePath = process.env.ASCENDA_EVENT_WRITE_TOKEN_FILE ?? defaultTokenFilePath(toolInstallationId);
+    const fileToken = readTokenFile(tokenFilePath);
+    const eventWriteToken = fileToken ?? process.env.ASCENDA_EVENT_WRITE_TOKEN;
+    if (!eventWriteToken) {
+        throw new Error("Missing ASCENDA_EVENT_WRITE_TOKEN (or token file) — pair this tool installation first.");
+    }
+    if (!fileToken)
+        persistEventWriteToken(tokenFilePath, eventWriteToken);
+    return {
+        apiBaseUrl,
+        toolInstallationId,
+        eventWriteToken,
+        tokenFilePath,
+        sessionId: process.env.ASCENDA_SESSION_ID ?? randomUUID(),
+        workspaceHash: process.env.ASCENDA_WORKSPACE_HASH ?? null
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAgBzC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,yBAAyB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEtG,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,IAAI,EAAE,CAAC;IAC5E,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,yFAAyF;YACvF,4FAA4F;YAC5F,2FAA2F,CAC9F,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;IAC7G,MAAM,SAAS,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,eAAe,GAAG,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;IAC3E,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,wFAAwF,CAAC,CAAC;IAC5G,CAAC;IACD,IAAI,CAAC,SAAS;QAAE,sBAAsB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IAEvE,OAAO;QACL,UAAU;QACV,kBAAkB;QAClB,eAAe;QACf,aAAa;QACb,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,UAAU,EAAE;QACzD,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,IAAI;KAC1D,CAAC;AACJ,CAAC"}

package/dist/server.js

@@ -0,0 +1,135 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AscendaEventSender, bucketDurationMs } from "@ascenda-one/tool-kit";
+import { SEMANTIC_WORK_SIGNAL_EVENT_TYPES } from "@ascenda-one/tool-contract";
+import { z } from "zod";
+/**
+ * Named {@link AscendaEventMetadata} keys — reserved, so a skill's free-form
+ * `evidenceCounts`/`evidenceFlags` keys can never collide with (and silently
+ * overwrite) a field the wire type gives specific meaning to.
+ */
+const RESERVED_METADATA_KEYS = new Set([
+    "skillVersion",
+    "taskFingerprint",
+    "language",
+    "fileType",
+    "durationBucket",
+    "tokenPressureBucket",
+    "linesChangedBucket",
+    "commandClass",
+    "outcome",
+    "trigger",
+    "promptClass",
+    "reason",
+    "afterHours",
+    "activity",
+    "message",
+    "host",
+    "toolName",
+    "simulated",
+    "relatedEventType"
+]);
+/**
+ * Bare identifiers only (`scopeChanges`, not `"the user said X"`). This is
+ * the structural half of "never raw content": the schema below has no field
+ * a skill could stuff a sentence into in the first place, and this pattern
+ * closes the one place a caller supplies its own keys.
+ */
+const EVIDENCE_KEY_PATTERN = /^[a-zA-Z][a-zA-Z0-9]*$/;
+const eventTypeSchema = z.enum(SEMANTIC_WORK_SIGNAL_EVENT_TYPES);
+const evidenceKeySchema = z.string().regex(EVIDENCE_KEY_PATTERN, "must be a bare identifier, not free text");
+const inputShape = {
+    eventType: eventTypeSchema.describe("Which semantic pattern was observed. One of the six work-signal types " +
+        "— see the ascenda-agent-skills package for what each one means and " +
+        "the evidence that should accompany it."),
+    skillVersion: z
+        .string()
+        .regex(/^\d+\.\d+\.\d+(-[a-zA-Z0-9.]+)?$/, "must be a semver version, e.g. 1.0.0")
+        .describe("The emitting skill's own version. Mandatory: emission depends on the " +
+        "model remembering to call this tool, which drifts across model and " +
+        "skill revisions — without a version stamp, a changed emission rate " +
+        "is indistinguishable from a changed work pattern."),
+    taskFingerprint: z
+        .string()
+        .regex(/^[a-f0-9]{16,64}$/i, "must be a hash (hex), never the task itself")
+        .optional()
+        .describe("A local hash identifying the task across attempts, if the skill computed one. Never raw task text."),
+    windowMinutes: z
+        .number()
+        .int()
+        .positive()
+        .max(1440)
+        .optional()
+        .describe("Roughly how many minutes the observed pattern spans. Bucketed before it leaves this process."),
+    evidenceCounts: z
+        .record(evidenceKeySchema, z.number().int())
+        .optional()
+        .describe('Named integer counts, e.g. { "scopeChanges": 4, "unresolvedDecisions": 3 }. No free text.'),
+    evidenceFlags: z
+        .record(evidenceKeySchema, z.boolean())
+        .optional()
+        .describe('Named booleans, e.g. { "originalGoalRetained": false }. No free text.')
+};
+export function buildServer(config) {
+    const server = new McpServer({ name: "ascenda-agent-mcp", version: "0.1.0" });
+    const sender = new AscendaEventSender({
+        apiBaseUrl: config.apiBaseUrl,
+        toolInstallationId: config.toolInstallationId,
+        source: "mcp_server",
+        eventWriteToken: config.eventWriteToken,
+        tokenFilePath: config.tokenFilePath,
+        sessionId: config.sessionId,
+        workspaceHash: config.workspaceHash,
+        timeoutMs: 5000
+    });
+    server.registerTool("ascenda_emit_work_signal", {
+        title: "Emit an Ascenda work-friction signal",
+        description: "Report an observable work pattern — repeated approach churn, drift from a " +
+            "declared goal, a stalled or recovered session, a declared intention or scope " +
+            "change. Report the pattern, not a diagnosis: never infer or state the user's " +
+            "emotional or mental state, and never assert severity — Ascenda evaluates that " +
+            "server-side against the person's own baseline. This tool never transmits " +
+            "prompt content, code, file names, or any other project content; the schema " +
+            "accepts only enumerated event types, a version stamp, an optional hash, and " +
+            "named counts/flags.",
+        inputSchema: inputShape
+    }, async (args) => {
+        for (const key of [...Object.keys(args.evidenceCounts ?? {}), ...Object.keys(args.evidenceFlags ?? {})]) {
+            if (RESERVED_METADATA_KEYS.has(key)) {
+                return errorResult(`"${key}" is a reserved metadata field name and cannot be used as an evidence key.`);
+            }
+        }
+        const durationBucket = args.windowMinutes ? bucketDurationMs(args.windowMinutes * 60_000) : undefined;
+        const metadata = {
+            skillVersion: args.skillVersion,
+            ...(args.taskFingerprint ? { taskFingerprint: args.taskFingerprint } : {}),
+            ...(durationBucket ? { durationBucket } : {}),
+            ...(args.evidenceCounts ?? {}),
+            ...(args.evidenceFlags ?? {})
+        };
+        try {
+            const result = await sender.sendSemanticSignal({
+                eventType: args.eventType,
+                metadata
+            });
+            if (result === "accepted") {
+                return { content: [{ type: "text", text: "accepted" }] };
+            }
+            if (result === "consent_missing") {
+                return errorResult("Ascenda rejected this: semantic-signal consent is missing or expired. " +
+                    "Grant it in the Ascenda app before this tool can report patterns.");
+            }
+            if (result === "auth_failed") {
+                return errorResult("Ascenda rejected this: the event write token is invalid or revoked. Re-pair this tool.");
+            }
+            return errorResult(`Ascenda rejected this: ${result}.`);
+        }
+        catch (error) {
+            return errorResult(error instanceof Error ? error.message : String(error));
+        }
+    });
+    return server;
+}
+function errorResult(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAmD,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AAC/H,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;GAIG;AACH,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,cAAc;IACd,iBAAiB;IACjB,UAAU;IACV,UAAU;IACV,gBAAgB;IAChB,qBAAqB;IACrB,oBAAoB;IACpB,cAAc;IACd,SAAS;IACT,SAAS;IACT,aAAa;IACb,QAAQ;IACR,YAAY;IACZ,UAAU;IACV,SAAS;IACT,MAAM;IACN,UAAU;IACV,WAAW;IACX,kBAAkB;CACnB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AAEtD,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAC5B,gCAAoE,CACrE,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,oBAAoB,EAAE,0CAA0C,CAAC,CAAC;AAE7G,MAAM,UAAU,GAAG;IACjB,SAAS,EAAE,eAAe,CAAC,QAAQ,CACjC,wEAAwE;QACtE,qEAAqE;QACrE,wCAAwC,CAC3C;IACD,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,KAAK,CAAC,kCAAkC,EAAE,sCAAsC,CAAC;SACjF,QAAQ,CACP,uEAAuE;QACrE,qEAAqE;QACrE,qEAAqE;QACrE,mDAAmD,CACtD;IACH,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,KAAK,CAAC,oBAAoB,EAAE,6CAA6C,CAAC;SAC1E,QAAQ,EAAE;SACV,QAAQ,CAAC,oGAAoG,CAAC;IACjH,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,8FAA8F,CAAC;IAC3G,cAAc,EAAE,CAAC;SACd,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC;SAC3C,QAAQ,EAAE;SACV,QAAQ,CAAC,2FAA2F,CAAC;IACxG,aAAa,EAAE,CAAC;SACb,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SACtC,QAAQ,EAAE;SACV,QAAQ,CAAC,uEAAuE,CAAC;CACrF,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,MAAwB;IAClD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC;QACpC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;QAC7C,MAAM,EAAE,YAAY;QACpB,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CACjB,0BAA0B,EAC1B;QACE,KAAK,EAAE,sCAAsC;QAC7C,WAAW,EACT,4EAA4E;YAC5E,+EAA+E;YAC/E,+EAA+E;YAC/E,gFAAgF;YAChF,2EAA2E;YAC3E,6EAA6E;YAC7E,8EAA8E;YAC9E,qBAAqB;QACvB,WAAW,EAAE,UAAU;KACxB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACxG,IAAI,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpC,OAAO,WAAW,CAAC,IAAI,GAAG,4EAA4E,CAAC,CAAC;YAC1G,CAAC;QACH,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtG,MAAM,QAAQ,GAAoD;YAChE,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC;YAC9B,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC;SAC9B,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC;gBAC7C,SAAS,EAAE,IAAI,CAAC,SAAsC;gBACtD,QAAQ;aACT,CAAC,CAAC;YACH,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;gBAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;YAC3D,CAAC;YACD,IAAI,MAAM,KAAK,iBAAiB,EAAE,CAAC;gBACjC,OAAO,WAAW,CAChB,wEAAwE;oBACtE,mEAAmE,CACtE,CAAC;YACJ,CAAC;YACD,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;gBAC7B,OAAO,WAAW,CAAC,wFAAwF,CAAC,CAAC;YAC/G,CAAC;YACD,OAAO,WAAW,CAAC,0BAA0B,MAAM,GAAG,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "publishConfig": { "access": "public" },
+  "name": "@ascenda-one/agent-mcp",
+  "version": "0.1.3",
+  "description": "MCP server exposing ascenda_emit_work_signal — the one submission interface for agent-observed (semantic) work-friction signals.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ascendaone-com/ai-engineer-tools.git",
+    "directory": "ascenda-agent-mcp"
+  },
+  "type": "module",
+  "files": ["dist"],
+  "bin": {
+    "ascenda-agent-mcp": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p ./ && npm run bundle",
+    "watch": "tsc -w -p ./",
+    "bundle": "esbuild src/cli.ts --bundle --platform=node --format=esm --banner:js=\"import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);\" --outfile=dist/cli.js",
+    "test": "npm run build && node --test tests/*.test.mjs"
+  },
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.10",
+    "typescript": "^5.5.0",
+    "@ascenda-one/tool-contract": "*",
+    "@ascenda-one/tool-kit": "*"
+  }
+}