@ascenda-one/claude-code-hooks 0.1.4 → 0.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +12 -9
- package/dist/cli.js +69 -9
- package/dist/cli.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -60,21 +60,24 @@ Then wire the events yourself — see [Register hooks manually](#register-hooks-
|
|
|
60
60
|
|
|
61
61
|
### Pair first (both routes)
|
|
62
62
|
|
|
63
|
-
Neither route sends anything until this machine is paired
|
|
64
|
-
no QR code of its own; it reuses a pairing made elsewhere.
|
|
63
|
+
Neither route sends anything until this machine is paired:
|
|
65
64
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
65
|
+
```bash
|
|
66
|
+
npx -y @ascenda-one/claude-code-hooks pair
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
It prints a 6-digit code — confirm it in the Ascenda app under
|
|
70
|
+
**Connections → Ingest telemetry** — then saves the write token to
|
|
71
|
+
`~/.ascenda/tokens/` and prints the one line left to do by hand:
|
|
70
72
|
|
|
71
73
|
```bash
|
|
72
|
-
export ASCENDA_TOOL_INSTALLATION_ID="claude_code:<uuid>" #
|
|
74
|
+
export ASCENDA_TOOL_INSTALLATION_ID="claude_code:<uuid>" # printed by `pair`
|
|
73
75
|
```
|
|
74
76
|
|
|
75
77
|
Add that to your shell profile (`~/.zshrc`, `~/.bashrc`) and restart Claude
|
|
76
|
-
Code. The
|
|
77
|
-
|
|
78
|
+
Code. The token itself is never copied around — every CLI tool reads it from
|
|
79
|
+
the file `pair` wrote. (The editor extension's pairing cannot be reused here:
|
|
80
|
+
its token lives in the editor's private secret storage.)
|
|
78
81
|
|
|
79
82
|
> **This variable is required, not optional.** Without it every hook
|
|
80
83
|
> invocation exits with `Missing ASCENDA_TOOL_INSTALLATION_ID`. The adapter
|
package/dist/cli.js
CHANGED
|
@@ -335,8 +335,8 @@ var require_http = __commonJS({
|
|
|
335
335
|
"use strict";
|
|
336
336
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
337
337
|
exports.AscendaApiError = void 0;
|
|
338
|
-
exports.createPairingSession =
|
|
339
|
-
exports.getPairingStatus =
|
|
338
|
+
exports.createPairingSession = createPairingSession2;
|
|
339
|
+
exports.getPairingStatus = getPairingStatus2;
|
|
340
340
|
exports.renewToolToken = renewToolToken;
|
|
341
341
|
exports.postToolEvent = postToolEvent;
|
|
342
342
|
exports.postToolEventsBatch = postToolEventsBatch;
|
|
@@ -352,7 +352,7 @@ var require_http = __commonJS({
|
|
|
352
352
|
}
|
|
353
353
|
};
|
|
354
354
|
exports.AscendaApiError = AscendaApiError2;
|
|
355
|
-
async function
|
|
355
|
+
async function createPairingSession2(apiBaseUrl, toolInstallationId, toolType, displayName) {
|
|
356
356
|
const response = await fetch(`${apiBaseUrl}/v1/tool-pairing-sessions`, {
|
|
357
357
|
method: "POST",
|
|
358
358
|
headers: { "Content-Type": "application/json" },
|
|
@@ -362,7 +362,7 @@ var require_http = __commonJS({
|
|
|
362
362
|
throw new AscendaApiError2(response.status, void 0, await response.text());
|
|
363
363
|
return await response.json();
|
|
364
364
|
}
|
|
365
|
-
async function
|
|
365
|
+
async function getPairingStatus2(apiBaseUrl, pairingSessionId) {
|
|
366
366
|
const response = await fetch(`${apiBaseUrl}/v1/tool-pairing-sessions/${encodeURIComponent(pairingSessionId)}/status`, {
|
|
367
367
|
method: "GET",
|
|
368
368
|
headers: { Accept: "application/json" }
|
|
@@ -463,16 +463,16 @@ var require_tokenStore = __commonJS({
|
|
|
463
463
|
};
|
|
464
464
|
}();
|
|
465
465
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
466
|
-
exports.defaultTokenFilePath =
|
|
467
|
-
exports.persistEventWriteToken =
|
|
466
|
+
exports.defaultTokenFilePath = defaultTokenFilePath3;
|
|
467
|
+
exports.persistEventWriteToken = persistEventWriteToken3;
|
|
468
468
|
exports.readTokenFile = readTokenFile2;
|
|
469
469
|
var fs = __importStar(__require("fs"));
|
|
470
470
|
var os = __importStar(__require("os"));
|
|
471
471
|
var path = __importStar(__require("path"));
|
|
472
|
-
function
|
|
472
|
+
function defaultTokenFilePath3(toolInstallationId) {
|
|
473
473
|
return path.join(os.homedir(), ".ascenda", "tokens", sanitizeFilePart(toolInstallationId));
|
|
474
474
|
}
|
|
475
|
-
function
|
|
475
|
+
function persistEventWriteToken3(tokenFilePath, token) {
|
|
476
476
|
const dir = path.dirname(tokenFilePath);
|
|
477
477
|
fs.mkdirSync(dir, { recursive: true, mode: 448 });
|
|
478
478
|
fs.writeFileSync(tokenFilePath, token, { encoding: "utf8", mode: 384 });
|
|
@@ -825,6 +825,10 @@ var require_out2 = __commonJS({
|
|
|
825
825
|
}
|
|
826
826
|
});
|
|
827
827
|
|
|
828
|
+
// src/cli.ts
|
|
829
|
+
var import_tool_kit6 = __toESM(require_out2(), 1);
|
|
830
|
+
import { randomUUID } from "node:crypto";
|
|
831
|
+
|
|
828
832
|
// src/ascendaClient.ts
|
|
829
833
|
var import_tool_kit = __toESM(require_out2(), 1);
|
|
830
834
|
var import_tool_kit2 = __toESM(require_out2(), 1);
|
|
@@ -1060,9 +1064,65 @@ function sanitiseToolName(toolName) {
|
|
|
1060
1064
|
// src/cli.ts
|
|
1061
1065
|
var INTENTION_INVITE = "Ascenda tip: if it's natural, you can ask what would make this session count before diving in \u2014 one line is enough. Not a required step, and skip it entirely if the user is already mid-task.";
|
|
1062
1066
|
var MILESTONE_DEBRIEF_INVITE = "Ascenda tip: that finished a piece of work. If the moment suits, it's worth a short debrief \u2014 what moved, what's still unresolved, and what you'd do differently next time. One or two lines. Skip it if they're already onto the next thing.";
|
|
1067
|
+
async function runPair() {
|
|
1068
|
+
const apiBaseUrl = (process.env.ASCENDA_API_BASE_URL ?? "https://api.ascenda.one").replace(/\/$/, "");
|
|
1069
|
+
const flagIndex = process.argv.indexOf("--tool-type");
|
|
1070
|
+
const toolType = flagIndex !== -1 ? (process.argv[flagIndex + 1] ?? "").trim() || ASCENDA_TOOL_TYPE : ASCENDA_TOOL_TYPE;
|
|
1071
|
+
const existing = process.env.ASCENDA_TOOL_INSTALLATION_ID?.trim();
|
|
1072
|
+
const toolInstallationId = existing && existing.includes(":") ? existing : `${toolType}:${randomUUID()}`;
|
|
1073
|
+
const session = await (0, import_tool_kit6.createPairingSession)(apiBaseUrl, toolInstallationId, toolType, toolType === ASCENDA_TOOL_TYPE ? "Claude Code" : toolType);
|
|
1074
|
+
const code = session.deviceCode ?? session.code;
|
|
1075
|
+
process.stdout.write(
|
|
1076
|
+
`
|
|
1077
|
+
Pairing code: ${code}
|
|
1078
|
+
|
|
1079
|
+
In the Ascenda app: Connections -> Ingest telemetry -> paste the code -> Pair tool.
|
|
1080
|
+
Waiting for confirmation (expires ${session.expiresAt})...
|
|
1081
|
+
|
|
1082
|
+
`
|
|
1083
|
+
);
|
|
1084
|
+
const deadline = Date.now() + 11 * 60 * 1e3;
|
|
1085
|
+
while (Date.now() < deadline) {
|
|
1086
|
+
await new Promise((resolve) => setTimeout(resolve, 3e3));
|
|
1087
|
+
const status = await (0, import_tool_kit6.getPairingStatus)(apiBaseUrl, session.pairingSessionId);
|
|
1088
|
+
if (status.status === "pending") continue;
|
|
1089
|
+
if (status.status !== "paired") {
|
|
1090
|
+
process.stderr.write(`Pairing ${status.status}. Run the command again for a fresh code.
|
|
1091
|
+
`);
|
|
1092
|
+
process.exitCode = 1;
|
|
1093
|
+
return;
|
|
1094
|
+
}
|
|
1095
|
+
const pairedId = status.toolInstallationId ?? toolInstallationId;
|
|
1096
|
+
if (!status.eventWriteToken) {
|
|
1097
|
+
process.stderr.write(
|
|
1098
|
+
"Paired, but the server did not deliver a write token. Disconnect this tool in the Ascenda app and run the command again.\n"
|
|
1099
|
+
);
|
|
1100
|
+
process.exitCode = 1;
|
|
1101
|
+
return;
|
|
1102
|
+
}
|
|
1103
|
+
const tokenFilePath = (0, import_tool_kit6.defaultTokenFilePath)(pairedId);
|
|
1104
|
+
(0, import_tool_kit6.persistEventWriteToken)(tokenFilePath, status.eventWriteToken);
|
|
1105
|
+
process.stdout.write(
|
|
1106
|
+
`Paired. Write token saved to ${tokenFilePath}
|
|
1107
|
+
|
|
1108
|
+
One step left \u2014 add this to your shell profile (~/.zshrc), then restart Claude Code:
|
|
1109
|
+
|
|
1110
|
+
export ASCENDA_TOOL_INSTALLATION_ID="${pairedId}"
|
|
1111
|
+
|
|
1112
|
+
`
|
|
1113
|
+
);
|
|
1114
|
+
return;
|
|
1115
|
+
}
|
|
1116
|
+
process.stderr.write("Timed out waiting for confirmation. Run the command again for a fresh code.\n");
|
|
1117
|
+
process.exitCode = 1;
|
|
1118
|
+
}
|
|
1063
1119
|
async function main() {
|
|
1064
1120
|
const hookName = process.argv[2];
|
|
1065
|
-
if (!hookName) throw new Error("Usage: ascenda-claude-hook <ClaudeHookEventName>");
|
|
1121
|
+
if (!hookName) throw new Error("Usage: ascenda-claude-hook <ClaudeHookEventName> | pair");
|
|
1122
|
+
if (hookName === "pair") {
|
|
1123
|
+
await runPair();
|
|
1124
|
+
return;
|
|
1125
|
+
}
|
|
1066
1126
|
const input = await readJsonFromStdin();
|
|
1067
1127
|
if (hookName === "SessionStart" && isNewSessionStart(input) && process.env.ASCENDA_DISABLE_INTENTION_INVITE !== "true") {
|
|
1068
1128
|
process.stdout.write(JSON.stringify({
|
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED