@ascenda-one/codex-hooks 0.1.18 → 0.1.19
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 +53 -24
- package/dist/cli.js +212 -87
- package/dist/cli.js.map +1 -1
- package/dist/setup.js +44 -0
- package/dist/setup.js.map +1 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -27,48 +27,67 @@ Codex **awaits** command hooks and treats **exit code 2 as blocking** the user's
|
|
|
27
27
|
|
|
28
28
|
- [Codex CLI](https://developers.openai.com/codex) with hooks support (v0.117+)
|
|
29
29
|
- Node.js **20+**
|
|
30
|
-
- A pairing to reuse (see [Pair first](#pair-first) below)
|
|
31
30
|
|
|
32
|
-
### 1.
|
|
31
|
+
### 1. Set up
|
|
33
32
|
|
|
34
|
-
|
|
33
|
+
One command pairs Codex, installs the hook binary, and registers the hooks:
|
|
35
34
|
|
|
36
35
|
```bash
|
|
37
|
-
npx @ascenda-one/codex-hooks --
|
|
36
|
+
npx -y @ascenda-one/codex-hooks setup --scope user
|
|
38
37
|
```
|
|
39
38
|
|
|
40
|
-
|
|
39
|
+
It prints a 6-digit code — confirm it in the Ascenda app under
|
|
40
|
+
**Connections → Ingest telemetry** — then writes:
|
|
41
|
+
|
|
42
|
+
- the write token to `~/.ascenda/tokens/`
|
|
43
|
+
- the pairing to `tools.codex` in `~/.ascenda/credentials.json`
|
|
44
|
+
- the hook entries to `~/.codex/hooks.json`
|
|
45
|
+
|
|
46
|
+
**There is no shell profile line to add.** Codex reads its identity from the
|
|
47
|
+
credentials file, which is per agent — so pairing Codex cannot disturb a
|
|
48
|
+
Claude Code or Cursor pairing on the same machine, and a Codex hook launched
|
|
49
|
+
from the Dock with an empty environment still names itself correctly.
|
|
50
|
+
|
|
51
|
+
`--scope user` registers machine-wide. Omit it and hooks land in
|
|
52
|
+
`<cwd>/.codex/hooks.json`, instrumenting that project only — which is the
|
|
53
|
+
default, so pass the flag unless you mean one repo.
|
|
54
|
+
|
|
55
|
+
### 2. Check it
|
|
41
56
|
|
|
42
57
|
```bash
|
|
43
|
-
npx
|
|
58
|
+
npx @ascenda-one/codex-hooks status
|
|
44
59
|
```
|
|
45
60
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
61
|
+
Names the pairing, the binary and how many of the 7 events are registered.
|
|
62
|
+
Exits non-zero when something is missing, so it can gate a CI step.
|
|
63
|
+
|
|
64
|
+
To undo everything it wrote:
|
|
49
65
|
|
|
50
66
|
```bash
|
|
51
|
-
|
|
67
|
+
npx @ascenda-one/codex-hooks uninstall
|
|
52
68
|
```
|
|
53
69
|
|
|
54
|
-
|
|
55
|
-
|
|
70
|
+
### 3. Restart Codex
|
|
71
|
+
|
|
72
|
+
Hooks are read at startup.
|
|
73
|
+
|
|
74
|
+
### On a Dev backend with no phone
|
|
56
75
|
|
|
57
|
-
|
|
76
|
+
`setup --local` points at the [dev server](../ascenda-dev-server), which
|
|
77
|
+
auto-confirms the pairing:
|
|
58
78
|
|
|
59
79
|
```bash
|
|
60
|
-
|
|
61
|
-
|
|
80
|
+
node ../ascenda-dev-server/dist/cli.js # in another terminal
|
|
81
|
+
npx @ascenda-one/codex-hooks setup --local --scope user
|
|
62
82
|
```
|
|
63
83
|
|
|
64
|
-
`
|
|
65
|
-
`http://localhost:5002` or the Azure Dev host for development.
|
|
84
|
+
`--api-base-url` takes any other host; the default is `https://api.ascenda.one`.
|
|
66
85
|
|
|
67
|
-
###
|
|
86
|
+
### Registering hooks by hand
|
|
68
87
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
88
|
+
`setup` is the supported path. [`examples/hooks.json`](./examples/hooks.json)
|
|
89
|
+
is the same content for anyone who would rather merge it themselves, or who
|
|
90
|
+
needs the inline `config.toml` form:
|
|
72
91
|
|
|
73
92
|
```toml
|
|
74
93
|
[[hooks.UserPromptSubmit]]
|
|
@@ -78,10 +97,20 @@ command = "npx -y @ascenda-one/codex-hooks UserPromptSubmit"
|
|
|
78
97
|
timeout = 10
|
|
79
98
|
```
|
|
80
99
|
|
|
81
|
-
|
|
100
|
+
A hand-merged file still needs a pairing — run `setup` for that, or export
|
|
101
|
+
`ASCENDA_TOOL_INSTALLATION_ID` yourself. The environment variable wins over
|
|
102
|
+
the credentials file when both are present, so exporting one id on a machine
|
|
103
|
+
running two agents sends both agents' work under it.
|
|
104
|
+
|
|
105
|
+
### Verify
|
|
106
|
+
|
|
107
|
+
Run a Codex session, then read the send journal at
|
|
108
|
+
`~/.ascenda/state/<installationId>.json`. It records every attempt including
|
|
109
|
+
failures, so an absent file means "never ran" rather than "ran and failed" —
|
|
110
|
+
which is the distinction the hook's own exit code cannot give you, since it
|
|
111
|
+
always exits `0` (see the safety contract above).
|
|
82
112
|
|
|
83
|
-
|
|
84
|
-
the hook exits `0`, which it always does (see the safety contract above).
|
|
113
|
+
Set `ASCENDA_EVENT_LOG_FILE` to also log each payload locally.
|
|
85
114
|
|
|
86
115
|
## Build from source
|
|
87
116
|
|
package/dist/cli.js
CHANGED
|
@@ -583,7 +583,61 @@ var require_out = __commonJS({
|
|
|
583
583
|
"../packages/tool-contract/out/index.js"(exports) {
|
|
584
584
|
"use strict";
|
|
585
585
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
586
|
-
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.TOOL_EVENT_DELIVERED_STATUSES = exports.IDEMPOTENCY_KEY_MAX_LENGTH = exports.EVENT_METADATA_FIELDS = exports.COLLABORATION_EVENT_TYPES = exports.SEMANTIC_WORK_SIGNAL_EVENT_TYPES = void 0;
|
|
586
|
+
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.TOOL_EVENT_DELIVERED_STATUSES = exports.IDEMPOTENCY_KEY_MAX_LENGTH = exports.EVENT_METADATA_FIELDS = exports.COLLABORATION_EVENT_TYPES = exports.SEMANTIC_WORK_SIGNAL_EVENT_TYPES = exports.ASCENDA_ELAPSED_QUANTITIES = exports.ASCENDA_ACTIVE_TIME_QUANTITIES = exports.ASCENDA_TOOL_TYPES = exports.ASCENDA_TELEMETRY_SOURCES = void 0;
|
|
587
|
+
exports.combineDisjointHalves = combineDisjointHalves;
|
|
588
|
+
exports.requireComparableQuantities = requireComparableQuantities;
|
|
589
|
+
exports.ASCENDA_TELEMETRY_SOURCES = [
|
|
590
|
+
"vscode_extension",
|
|
591
|
+
"cursor_mcp",
|
|
592
|
+
"claude_code",
|
|
593
|
+
"copilot_otel",
|
|
594
|
+
"cli_agent",
|
|
595
|
+
"mcp_server",
|
|
596
|
+
"activity_signals",
|
|
597
|
+
"code_forge"
|
|
598
|
+
];
|
|
599
|
+
exports.ASCENDA_TOOL_TYPES = [
|
|
600
|
+
"vscode_extension",
|
|
601
|
+
"cursor_mcp",
|
|
602
|
+
"claude_code",
|
|
603
|
+
"copilot_otel",
|
|
604
|
+
"cli_agent",
|
|
605
|
+
"mcp_server",
|
|
606
|
+
"github_collector",
|
|
607
|
+
"other"
|
|
608
|
+
];
|
|
609
|
+
exports.ASCENDA_ACTIVE_TIME_QUANTITIES = [
|
|
610
|
+
"coverage",
|
|
611
|
+
"hands_on",
|
|
612
|
+
"supervising",
|
|
613
|
+
"block_coverage",
|
|
614
|
+
"hands_on_agent_hours",
|
|
615
|
+
"supervising_agent_hours"
|
|
616
|
+
];
|
|
617
|
+
exports.ASCENDA_ELAPSED_QUANTITIES = {
|
|
618
|
+
coverage: true,
|
|
619
|
+
hands_on: true,
|
|
620
|
+
supervising: true,
|
|
621
|
+
block_coverage: true,
|
|
622
|
+
hands_on_agent_hours: false,
|
|
623
|
+
supervising_agent_hours: false
|
|
624
|
+
};
|
|
625
|
+
var DISJOINT_HALVES = [
|
|
626
|
+
["hands_on", "supervising", "coverage"],
|
|
627
|
+
["supervising", "hands_on", "coverage"]
|
|
628
|
+
];
|
|
629
|
+
function combineDisjointHalves(left, leftQuantity, right, rightQuantity) {
|
|
630
|
+
const pair = DISJOINT_HALVES.find(([a, b]) => a === leftQuantity && b === rightQuantity);
|
|
631
|
+
if (!pair) {
|
|
632
|
+
throw new Error(`'combine-disjoint' combines active-time quantities '${leftQuantity}' and '${rightQuantity}', which do not partition a common whole.`);
|
|
633
|
+
}
|
|
634
|
+
return { total: left + right, quantity: pair[2] };
|
|
635
|
+
}
|
|
636
|
+
function requireComparableQuantities(left, right, operation) {
|
|
637
|
+
if (left !== right) {
|
|
638
|
+
throw new Error(`'${operation}' combines active-time quantities '${left}' and '${right}', which measure different things. See docs/ACTIVE_TIME.md, 'The quantity is the label, not the gap'.`);
|
|
639
|
+
}
|
|
640
|
+
}
|
|
587
641
|
exports.SEMANTIC_WORK_SIGNAL_EVENT_TYPES = [
|
|
588
642
|
"approach_churn_detected",
|
|
589
643
|
"goal_drift_detected",
|
|
@@ -723,9 +777,9 @@ var require_payload = __commonJS({
|
|
|
723
777
|
}
|
|
724
778
|
return void 0;
|
|
725
779
|
}
|
|
726
|
-
function getNested2(input,
|
|
780
|
+
function getNested2(input, path2) {
|
|
727
781
|
let current = input;
|
|
728
|
-
for (const segment of
|
|
782
|
+
for (const segment of path2) {
|
|
729
783
|
if (!current || typeof current !== "object")
|
|
730
784
|
return void 0;
|
|
731
785
|
current = current[segment];
|
|
@@ -733,16 +787,16 @@ var require_payload = __commonJS({
|
|
|
733
787
|
return current;
|
|
734
788
|
}
|
|
735
789
|
function getNestedString2(input, paths) {
|
|
736
|
-
for (const
|
|
737
|
-
const value = getNested2(input,
|
|
790
|
+
for (const path2 of paths) {
|
|
791
|
+
const value = getNested2(input, path2);
|
|
738
792
|
if (typeof value === "string" && value.trim())
|
|
739
793
|
return value;
|
|
740
794
|
}
|
|
741
795
|
return void 0;
|
|
742
796
|
}
|
|
743
797
|
function getNestedNumber(input, paths) {
|
|
744
|
-
for (const
|
|
745
|
-
const value = getNested2(input,
|
|
798
|
+
for (const path2 of paths) {
|
|
799
|
+
const value = getNested2(input, path2);
|
|
746
800
|
if (typeof value === "number" && Number.isFinite(value))
|
|
747
801
|
return value;
|
|
748
802
|
}
|
|
@@ -824,8 +878,8 @@ var require_eventLog = __commonJS({
|
|
|
824
878
|
exports.resolveEventLogPath = resolveEventLogPath;
|
|
825
879
|
exports.appendEventLog = appendEventLog;
|
|
826
880
|
var fs = __importStar(__require("fs"));
|
|
827
|
-
var
|
|
828
|
-
var
|
|
881
|
+
var os2 = __importStar(__require("os"));
|
|
882
|
+
var path2 = __importStar(__require("path"));
|
|
829
883
|
exports.EVENT_LOG_ENV_VAR = "ASCENDA_EVENT_LOG_FILE";
|
|
830
884
|
var MAX_BYTES = 5 * 1024 * 1024;
|
|
831
885
|
function expandUserPath(configured) {
|
|
@@ -833,10 +887,10 @@ var require_eventLog = __commonJS({
|
|
|
833
887
|
if (!value)
|
|
834
888
|
return void 0;
|
|
835
889
|
if (value === "~")
|
|
836
|
-
return
|
|
890
|
+
return os2.homedir();
|
|
837
891
|
if (value.startsWith("~/"))
|
|
838
|
-
return
|
|
839
|
-
return
|
|
892
|
+
return path2.join(os2.homedir(), value.slice(2));
|
|
893
|
+
return path2.resolve(value);
|
|
840
894
|
}
|
|
841
895
|
function resolveEventLogPath() {
|
|
842
896
|
return expandUserPath(process.env[exports.EVENT_LOG_ENV_VAR]);
|
|
@@ -844,7 +898,7 @@ var require_eventLog = __commonJS({
|
|
|
844
898
|
function appendEventLog(logFilePath, entry) {
|
|
845
899
|
try {
|
|
846
900
|
rotateIfLarge(logFilePath);
|
|
847
|
-
const dir =
|
|
901
|
+
const dir = path2.dirname(logFilePath);
|
|
848
902
|
fs.mkdirSync(dir, { recursive: true, mode: 448 });
|
|
849
903
|
fs.appendFileSync(logFilePath, `${JSON.stringify(entry)}
|
|
850
904
|
`, { encoding: "utf8", mode: 384 });
|
|
@@ -1057,16 +1111,16 @@ var require_tokenStore = __commonJS({
|
|
|
1057
1111
|
exports.readTokenFile = readTokenFile;
|
|
1058
1112
|
exports.sanitizeFilePart = sanitizeFilePart;
|
|
1059
1113
|
var fs = __importStar(__require("fs"));
|
|
1060
|
-
var
|
|
1061
|
-
var
|
|
1114
|
+
var os2 = __importStar(__require("os"));
|
|
1115
|
+
var path2 = __importStar(__require("path"));
|
|
1062
1116
|
function ascendaHome() {
|
|
1063
|
-
return process.env.ASCENDA_HOME ??
|
|
1117
|
+
return process.env.ASCENDA_HOME ?? path2.join(os2.homedir(), ".ascenda");
|
|
1064
1118
|
}
|
|
1065
1119
|
function defaultTokenFilePath(toolInstallationId) {
|
|
1066
|
-
return
|
|
1120
|
+
return path2.join(ascendaHome(), "tokens", sanitizeFilePart(toolInstallationId));
|
|
1067
1121
|
}
|
|
1068
1122
|
function persistEventWriteToken(tokenFilePath, token) {
|
|
1069
|
-
const dir =
|
|
1123
|
+
const dir = path2.dirname(tokenFilePath);
|
|
1070
1124
|
fs.mkdirSync(dir, { recursive: true, mode: 448 });
|
|
1071
1125
|
fs.writeFileSync(tokenFilePath, token, { encoding: "utf8", mode: 384 });
|
|
1072
1126
|
if (process.platform !== "win32") {
|
|
@@ -1076,7 +1130,7 @@ var require_tokenStore = __commonJS({
|
|
|
1076
1130
|
}
|
|
1077
1131
|
function listPersistedToolInstallationIds(toolType) {
|
|
1078
1132
|
const prefix = `${sanitizeFilePart(toolType)}_`;
|
|
1079
|
-
const dir =
|
|
1133
|
+
const dir = path2.join(ascendaHome(), "tokens");
|
|
1080
1134
|
let names;
|
|
1081
1135
|
try {
|
|
1082
1136
|
names = fs.readdirSync(dir);
|
|
@@ -1087,7 +1141,7 @@ var require_tokenStore = __commonJS({
|
|
|
1087
1141
|
for (const name of names.sort()) {
|
|
1088
1142
|
if (!name.startsWith(prefix) || name.length === prefix.length)
|
|
1089
1143
|
continue;
|
|
1090
|
-
const file =
|
|
1144
|
+
const file = path2.join(dir, name);
|
|
1091
1145
|
try {
|
|
1092
1146
|
if (!fs.statSync(file).isFile())
|
|
1093
1147
|
continue;
|
|
@@ -1167,13 +1221,12 @@ var require_stateStore = __commonJS({
|
|
|
1167
1221
|
exports.shouldAnnounceFailure = shouldAnnounceFailure;
|
|
1168
1222
|
exports.markFailureNotified = markFailureNotified;
|
|
1169
1223
|
var fs = __importStar(__require("fs"));
|
|
1170
|
-
var
|
|
1171
|
-
var path = __importStar(__require("path"));
|
|
1224
|
+
var path2 = __importStar(__require("path"));
|
|
1172
1225
|
var tokenStore_1 = require_tokenStore();
|
|
1173
1226
|
function defaultStateFilePath(toolInstallationId) {
|
|
1174
1227
|
const dir = process.env.ASCENDA_STATE_DIR?.trim();
|
|
1175
|
-
const base = dir ? dir :
|
|
1176
|
-
return
|
|
1228
|
+
const base = dir ? dir : path2.join((0, tokenStore_1.ascendaHome)(), "state");
|
|
1229
|
+
return path2.join(base, `${(0, tokenStore_1.sanitizeFilePart)(toolInstallationId)}.json`);
|
|
1177
1230
|
}
|
|
1178
1231
|
function unresolvedToolInstallationId(toolType) {
|
|
1179
1232
|
return `${toolType}:unresolved`;
|
|
@@ -1252,7 +1305,7 @@ var require_stateStore = __commonJS({
|
|
|
1252
1305
|
function writeStateFile(stateFilePath, state) {
|
|
1253
1306
|
const temporaryPath = `${stateFilePath}.${process.pid}.tmp`;
|
|
1254
1307
|
try {
|
|
1255
|
-
const dir =
|
|
1308
|
+
const dir = path2.dirname(stateFilePath);
|
|
1256
1309
|
fs.mkdirSync(dir, { recursive: true, mode: 448 });
|
|
1257
1310
|
fs.writeFileSync(temporaryPath, `${JSON.stringify(state, null, 2)}
|
|
1258
1311
|
`, { encoding: "utf8", mode: 384 });
|
|
@@ -1324,7 +1377,7 @@ var require_outbox = __commonJS({
|
|
|
1324
1377
|
exports.claimOutbox = claimOutbox;
|
|
1325
1378
|
exports.enforceOutboxBounds = enforceOutboxBounds;
|
|
1326
1379
|
var fs = __importStar(__require("fs"));
|
|
1327
|
-
var
|
|
1380
|
+
var path2 = __importStar(__require("path"));
|
|
1328
1381
|
var stateStore_1 = require_stateStore();
|
|
1329
1382
|
var tokenStore_1 = require_tokenStore();
|
|
1330
1383
|
exports.OUTBOX_DRAIN_ENV_VAR = "ASCENDA_OUTBOX_DRAIN";
|
|
@@ -1338,12 +1391,12 @@ var require_outbox = __commonJS({
|
|
|
1338
1391
|
return value === "1" || value === "true" || value === "yes" || value === "on";
|
|
1339
1392
|
}
|
|
1340
1393
|
function defaultOutboxFilePath(toolInstallationId) {
|
|
1341
|
-
const dir =
|
|
1342
|
-
return
|
|
1394
|
+
const dir = path2.dirname((0, stateStore_1.defaultStateFilePath)(toolInstallationId));
|
|
1395
|
+
return path2.join(dir, `${(0, tokenStore_1.sanitizeFilePart)(toolInstallationId)}.outbox.jsonl`);
|
|
1343
1396
|
}
|
|
1344
1397
|
function appendToOutbox(outboxFilePath, payload, now = /* @__PURE__ */ new Date()) {
|
|
1345
1398
|
try {
|
|
1346
|
-
const dir =
|
|
1399
|
+
const dir = path2.dirname(outboxFilePath);
|
|
1347
1400
|
fs.mkdirSync(dir, { recursive: true, mode: 448 });
|
|
1348
1401
|
const entry = { queuedAt: now.toISOString(), payload };
|
|
1349
1402
|
fs.appendFileSync(outboxFilePath, `${JSON.stringify(entry)}
|
|
@@ -1414,7 +1467,7 @@ var require_outbox = __commonJS({
|
|
|
1414
1467
|
released = true;
|
|
1415
1468
|
if (remainder.length > 0) {
|
|
1416
1469
|
try {
|
|
1417
|
-
fs.mkdirSync(
|
|
1470
|
+
fs.mkdirSync(path2.dirname(outboxFilePath), { recursive: true, mode: 448 });
|
|
1418
1471
|
fs.appendFileSync(outboxFilePath, remainder.map((entry) => `${JSON.stringify(entry)}
|
|
1419
1472
|
`).join(""), { encoding: "utf8", mode: 384 });
|
|
1420
1473
|
if (process.platform !== "win32")
|
|
@@ -1458,10 +1511,10 @@ var require_outbox = __commonJS({
|
|
|
1458
1511
|
return { kept, discarded: { count, reasons, ...oldestQueuedAt !== void 0 ? { oldestQueuedAt } : {} } };
|
|
1459
1512
|
}
|
|
1460
1513
|
function listClaimFiles(outboxFilePath) {
|
|
1461
|
-
const dir =
|
|
1462
|
-
const prefix = `${
|
|
1514
|
+
const dir = path2.dirname(outboxFilePath);
|
|
1515
|
+
const prefix = `${path2.basename(outboxFilePath)}.`;
|
|
1463
1516
|
try {
|
|
1464
|
-
return fs.readdirSync(dir).filter((name) => name.startsWith(prefix) && name.includes(CLAIM_SUFFIX)).map((name) =>
|
|
1517
|
+
return fs.readdirSync(dir).filter((name) => name.startsWith(prefix) && name.includes(CLAIM_SUFFIX)).map((name) => path2.join(dir, name)).sort();
|
|
1465
1518
|
} catch {
|
|
1466
1519
|
return [];
|
|
1467
1520
|
}
|
|
@@ -1494,6 +1547,25 @@ var require_outbox = __commonJS({
|
|
|
1494
1547
|
}
|
|
1495
1548
|
});
|
|
1496
1549
|
|
|
1550
|
+
// ../packages/tool-kit/out/timeProvider.js
|
|
1551
|
+
var require_timeProvider = __commonJS({
|
|
1552
|
+
"../packages/tool-kit/out/timeProvider.js"(exports) {
|
|
1553
|
+
"use strict";
|
|
1554
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
1555
|
+
exports.systemTimeProvider = void 0;
|
|
1556
|
+
exports.fixedTimeProvider = fixedTimeProvider;
|
|
1557
|
+
exports.systemTimeProvider = {
|
|
1558
|
+
now: () => Date.now()
|
|
1559
|
+
};
|
|
1560
|
+
function fixedTimeProvider(instant) {
|
|
1561
|
+
const ms = typeof instant === "number" ? instant : new Date(instant).valueOf();
|
|
1562
|
+
if (!Number.isFinite(ms))
|
|
1563
|
+
throw new TypeError(`fixedTimeProvider: not a usable instant: ${String(instant)}`);
|
|
1564
|
+
return { now: () => ms };
|
|
1565
|
+
}
|
|
1566
|
+
}
|
|
1567
|
+
});
|
|
1568
|
+
|
|
1497
1569
|
// ../packages/tool-kit/out/eventSender.js
|
|
1498
1570
|
var require_eventSender = __commonJS({
|
|
1499
1571
|
"../packages/tool-kit/out/eventSender.js"(exports) {
|
|
@@ -1506,6 +1578,7 @@ var require_eventSender = __commonJS({
|
|
|
1506
1578
|
var eventLog_1 = require_eventLog();
|
|
1507
1579
|
var http_1 = require_http();
|
|
1508
1580
|
var outbox_1 = require_outbox();
|
|
1581
|
+
var timeProvider_1 = require_timeProvider();
|
|
1509
1582
|
var tokenStore_1 = require_tokenStore();
|
|
1510
1583
|
var stateStore_1 = require_stateStore();
|
|
1511
1584
|
var payload_1 = require_payload();
|
|
@@ -1542,9 +1615,12 @@ var require_eventSender = __commonJS({
|
|
|
1542
1615
|
lastDrain;
|
|
1543
1616
|
/** One outbox pass per sender, i.e. per hook process. The hook is on the user's critical path. */
|
|
1544
1617
|
outboxServiced = false;
|
|
1618
|
+
/** Resolved once, so every clock read in one pass sees the same instant. */
|
|
1619
|
+
time;
|
|
1545
1620
|
constructor(config) {
|
|
1546
1621
|
this.config = config;
|
|
1547
1622
|
this.eventWriteToken = config.eventWriteToken;
|
|
1623
|
+
this.time = config.timeProvider ?? timeProvider_1.systemTimeProvider;
|
|
1548
1624
|
}
|
|
1549
1625
|
async send(mapped) {
|
|
1550
1626
|
return this.post(buildEventPayload(this.config, mapped));
|
|
@@ -1695,7 +1771,7 @@ var require_eventSender = __commonJS({
|
|
|
1695
1771
|
* journal's detail says so instead of implying it was kept.
|
|
1696
1772
|
*/
|
|
1697
1773
|
enqueue(payload) {
|
|
1698
|
-
return (0, outbox_1.appendToOutbox)(this.outboxFilePath(), payload);
|
|
1774
|
+
return (0, outbox_1.appendToOutbox)(this.outboxFilePath(), payload, new Date(this.time.now()));
|
|
1699
1775
|
}
|
|
1700
1776
|
/**
|
|
1701
1777
|
* One pass over the outbox: claim it, apply the bounds, and — when sending
|
|
@@ -1718,7 +1794,7 @@ var require_eventSender = __commonJS({
|
|
|
1718
1794
|
return void 0;
|
|
1719
1795
|
this.outboxServiced = true;
|
|
1720
1796
|
const sendEnabled = this.config.outboxDrain ?? (0, outbox_1.outboxDrainEnabled)();
|
|
1721
|
-
const claimed = (0, outbox_1.claimOutbox)(this.outboxFilePath());
|
|
1797
|
+
const claimed = (0, outbox_1.claimOutbox)(this.outboxFilePath(), this.time.now());
|
|
1722
1798
|
if (!claimed) {
|
|
1723
1799
|
this.lastDrain = { found: 0, discarded: 0, delivered: 0, remaining: 0, sendEnabled };
|
|
1724
1800
|
return void 0;
|
|
@@ -1727,7 +1803,7 @@ var require_eventSender = __commonJS({
|
|
|
1727
1803
|
const { kept, discarded } = (0, outbox_1.enforceOutboxBounds)(claimed.entries, {
|
|
1728
1804
|
maxEntries: this.config.outboxMaxEntries ?? outbox_1.DEFAULT_OUTBOX_MAX_ENTRIES,
|
|
1729
1805
|
maxAgeMs: this.config.outboxMaxAgeMs ?? outbox_1.DEFAULT_OUTBOX_MAX_AGE_MS
|
|
1730
|
-
});
|
|
1806
|
+
}, this.time.now());
|
|
1731
1807
|
if (claimed.unreadable > 0) {
|
|
1732
1808
|
discarded.count += claimed.unreadable;
|
|
1733
1809
|
discarded.reasons.unreadable = claimed.unreadable;
|
|
@@ -1914,11 +1990,11 @@ var require_contextRegistry = __commonJS({
|
|
|
1914
1990
|
exports.recordWorkContext = recordWorkContext;
|
|
1915
1991
|
exports.recordWorkContextAlias = recordWorkContextAlias;
|
|
1916
1992
|
var fs = __importStar(__require("fs"));
|
|
1917
|
-
var
|
|
1918
|
-
var
|
|
1993
|
+
var os2 = __importStar(__require("os"));
|
|
1994
|
+
var path2 = __importStar(__require("path"));
|
|
1919
1995
|
var MAX_PATHS_PER_ENTRY = 8;
|
|
1920
1996
|
function workContextRegistryFilePath() {
|
|
1921
|
-
return
|
|
1997
|
+
return path2.join(os2.homedir(), ".ascenda", "work-contexts.json");
|
|
1922
1998
|
}
|
|
1923
1999
|
function readWorkContextRegistry(registryFilePath = workContextRegistryFilePath()) {
|
|
1924
2000
|
try {
|
|
@@ -1998,7 +2074,7 @@ var require_contextRegistry = __commonJS({
|
|
|
1998
2074
|
return iso.slice(0, 10);
|
|
1999
2075
|
}
|
|
2000
2076
|
function writeRegistry(registryFilePath, registry) {
|
|
2001
|
-
const dir =
|
|
2077
|
+
const dir = path2.dirname(registryFilePath);
|
|
2002
2078
|
fs.mkdirSync(dir, { recursive: true, mode: 448 });
|
|
2003
2079
|
const tmp = `${registryFilePath}.${process.pid}.tmp`;
|
|
2004
2080
|
fs.writeFileSync(tmp, `${JSON.stringify(registry, null, 2)}
|
|
@@ -2061,10 +2137,10 @@ var require_credentials = __commonJS({
|
|
|
2061
2137
|
exports.writeHostCredentials = writeHostCredentials;
|
|
2062
2138
|
exports.removeHostCredentials = removeHostCredentials;
|
|
2063
2139
|
var fs = __importStar(__require("fs"));
|
|
2064
|
-
var
|
|
2140
|
+
var path2 = __importStar(__require("path"));
|
|
2065
2141
|
var tokenStore_1 = require_tokenStore();
|
|
2066
2142
|
function credentialsFilePath() {
|
|
2067
|
-
return
|
|
2143
|
+
return path2.join((0, tokenStore_1.ascendaHome)(), "credentials.json");
|
|
2068
2144
|
}
|
|
2069
2145
|
function readMachineCredentials() {
|
|
2070
2146
|
try {
|
|
@@ -2081,11 +2157,11 @@ var require_credentials = __commonJS({
|
|
|
2081
2157
|
}
|
|
2082
2158
|
function writeMachineCredentials(credentials) {
|
|
2083
2159
|
const file = credentialsFilePath();
|
|
2084
|
-
fs.mkdirSync(
|
|
2160
|
+
fs.mkdirSync(path2.dirname(file), { recursive: true, mode: 448 });
|
|
2085
2161
|
fs.writeFileSync(file, `${JSON.stringify(credentials, null, 2)}
|
|
2086
2162
|
`, { encoding: "utf8", mode: 384 });
|
|
2087
2163
|
if (process.platform !== "win32") {
|
|
2088
|
-
fs.chmodSync(
|
|
2164
|
+
fs.chmodSync(path2.dirname(file), 448);
|
|
2089
2165
|
fs.chmodSync(file, 384);
|
|
2090
2166
|
}
|
|
2091
2167
|
}
|
|
@@ -2167,7 +2243,7 @@ var require_forgeProject = __commonJS({
|
|
|
2167
2243
|
exports.forgeFullNameFromConfig = forgeFullNameFromConfig;
|
|
2168
2244
|
exports.recordForgeProjectAlias = recordForgeProjectAlias;
|
|
2169
2245
|
var fs = __importStar(__require("fs"));
|
|
2170
|
-
var
|
|
2246
|
+
var path2 = __importStar(__require("path"));
|
|
2171
2247
|
var contextRegistry_1 = require_contextRegistry();
|
|
2172
2248
|
function forgeProjectHash(value) {
|
|
2173
2249
|
let h = 2166136261;
|
|
@@ -2213,7 +2289,7 @@ var require_forgeProject = __commonJS({
|
|
|
2213
2289
|
return null;
|
|
2214
2290
|
let config;
|
|
2215
2291
|
try {
|
|
2216
|
-
config = fs.readFileSync(
|
|
2292
|
+
config = fs.readFileSync(path2.join(repositoryRoot, ".git", "config"), "utf8");
|
|
2217
2293
|
} catch {
|
|
2218
2294
|
return null;
|
|
2219
2295
|
}
|
|
@@ -2321,17 +2397,17 @@ var require_salt = __commonJS({
|
|
|
2321
2397
|
exports.hashWithMachineSalt = hashWithMachineSalt;
|
|
2322
2398
|
var crypto = __importStar(__require("crypto"));
|
|
2323
2399
|
var fs = __importStar(__require("fs"));
|
|
2324
|
-
var
|
|
2325
|
-
var
|
|
2400
|
+
var os2 = __importStar(__require("os"));
|
|
2401
|
+
var path2 = __importStar(__require("path"));
|
|
2326
2402
|
function machineSaltFilePath() {
|
|
2327
|
-
return
|
|
2403
|
+
return path2.join(os2.homedir(), ".ascenda", "salt");
|
|
2328
2404
|
}
|
|
2329
2405
|
var cache = /* @__PURE__ */ new Map();
|
|
2330
2406
|
function readOrCreateMachineSalt(saltFilePath = machineSaltFilePath()) {
|
|
2331
2407
|
const hit = cache.get(saltFilePath);
|
|
2332
2408
|
if (hit)
|
|
2333
2409
|
return hit;
|
|
2334
|
-
const dir =
|
|
2410
|
+
const dir = path2.dirname(saltFilePath);
|
|
2335
2411
|
fs.mkdirSync(dir, { recursive: true, mode: 448 });
|
|
2336
2412
|
let salt;
|
|
2337
2413
|
try {
|
|
@@ -2405,7 +2481,7 @@ var require_workContext = __commonJS({
|
|
|
2405
2481
|
exports.readBranchName = readBranchName;
|
|
2406
2482
|
exports.deriveBranchHashForCwd = deriveBranchHashForCwd2;
|
|
2407
2483
|
var fs = __importStar(__require("fs"));
|
|
2408
|
-
var
|
|
2484
|
+
var path2 = __importStar(__require("path"));
|
|
2409
2485
|
var salt_1 = require_salt();
|
|
2410
2486
|
var MAX_WALK_DEPTH = 64;
|
|
2411
2487
|
function deriveWorkContext(cwd, saltFilePath) {
|
|
@@ -2440,7 +2516,7 @@ var require_workContext = __commonJS({
|
|
|
2440
2516
|
return null;
|
|
2441
2517
|
let dir = startDir;
|
|
2442
2518
|
for (let depth = 0; depth < MAX_WALK_DEPTH; depth++) {
|
|
2443
|
-
const dotGit =
|
|
2519
|
+
const dotGit = path2.join(dir, ".git");
|
|
2444
2520
|
let stat = null;
|
|
2445
2521
|
try {
|
|
2446
2522
|
stat = fs.statSync(dotGit);
|
|
@@ -2454,7 +2530,7 @@ var require_workContext = __commonJS({
|
|
|
2454
2530
|
const canonicalRoot = (gitDir ? worktreeParentRoot(gitDir) : null) ?? dir;
|
|
2455
2531
|
return { checkoutRoot: dir, canonicalRoot, gitDir };
|
|
2456
2532
|
}
|
|
2457
|
-
const parent =
|
|
2533
|
+
const parent = path2.dirname(dir);
|
|
2458
2534
|
if (parent === dir)
|
|
2459
2535
|
return null;
|
|
2460
2536
|
dir = parent;
|
|
@@ -2466,13 +2542,13 @@ var require_workContext = __commonJS({
|
|
|
2466
2542
|
const match = /^gitdir:\s*(.+)\s*$/m.exec(fs.readFileSync(dotGitFile, "utf8"));
|
|
2467
2543
|
if (!match)
|
|
2468
2544
|
return null;
|
|
2469
|
-
return
|
|
2545
|
+
return path2.resolve(containingDir, match[1].trim());
|
|
2470
2546
|
} catch {
|
|
2471
2547
|
return null;
|
|
2472
2548
|
}
|
|
2473
2549
|
}
|
|
2474
2550
|
function worktreeParentRoot(resolvedGitDir) {
|
|
2475
|
-
const marker = `${
|
|
2551
|
+
const marker = `${path2.sep}.git${path2.sep}worktrees${path2.sep}`;
|
|
2476
2552
|
const idx = resolvedGitDir.indexOf(marker);
|
|
2477
2553
|
if (idx === -1)
|
|
2478
2554
|
return null;
|
|
@@ -2482,12 +2558,12 @@ var require_workContext = __commonJS({
|
|
|
2482
2558
|
const sep = startPath.includes("\\") && !startPath.includes("/") ? "\\" : "/";
|
|
2483
2559
|
const leading = /^[\\/]/.test(startPath) ? sep : "";
|
|
2484
2560
|
const segments = startPath.split(/[\\/]/).filter(Boolean);
|
|
2485
|
-
const
|
|
2561
|
+
const join2 = (count) => leading + segments.slice(0, count).join(sep);
|
|
2486
2562
|
for (let i = 0; i + 2 < segments.length; i++) {
|
|
2487
2563
|
if (segments[i] === ".claude" && segments[i + 1] === "worktrees") {
|
|
2488
2564
|
if (i === 0)
|
|
2489
2565
|
return null;
|
|
2490
|
-
return { checkoutRoot:
|
|
2566
|
+
return { checkoutRoot: join2(i + 3), canonicalRoot: join2(i), gitDir: null };
|
|
2491
2567
|
}
|
|
2492
2568
|
}
|
|
2493
2569
|
for (let i = 0; i + 1 < segments.length; i++) {
|
|
@@ -2497,7 +2573,7 @@ var require_workContext = __commonJS({
|
|
|
2497
2573
|
continue;
|
|
2498
2574
|
const repoName = folder.slice(0, -suffix.length);
|
|
2499
2575
|
const canonicalRoot = leading + [...segments.slice(0, i), repoName].join(sep);
|
|
2500
|
-
return { checkoutRoot:
|
|
2576
|
+
return { checkoutRoot: join2(i + 2), canonicalRoot, gitDir: null };
|
|
2501
2577
|
}
|
|
2502
2578
|
return null;
|
|
2503
2579
|
}
|
|
@@ -2545,7 +2621,7 @@ var require_workContext = __commonJS({
|
|
|
2545
2621
|
return null;
|
|
2546
2622
|
let head;
|
|
2547
2623
|
try {
|
|
2548
|
-
head = fs.readFileSync(
|
|
2624
|
+
head = fs.readFileSync(path2.join(gitDir, "HEAD"), "utf8").trim();
|
|
2549
2625
|
} catch {
|
|
2550
2626
|
return null;
|
|
2551
2627
|
}
|
|
@@ -2765,25 +2841,25 @@ var require_cliAgentSetup = __commonJS({
|
|
|
2765
2841
|
};
|
|
2766
2842
|
}();
|
|
2767
2843
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
2768
|
-
exports.isCliAgentManagementCommand =
|
|
2844
|
+
exports.isCliAgentManagementCommand = isCliAgentManagementCommand2;
|
|
2769
2845
|
exports.cliAgentHookBinPath = cliAgentHookBinPath;
|
|
2770
|
-
exports.runCliAgentSetup =
|
|
2846
|
+
exports.runCliAgentSetup = runCliAgentSetup2;
|
|
2771
2847
|
exports.writeHookSettings = writeHookSettings;
|
|
2772
2848
|
exports.findStaleHookCommands = findStaleHookCommands;
|
|
2773
2849
|
var crypto = __importStar(__require("crypto"));
|
|
2774
2850
|
var fs = __importStar(__require("fs"));
|
|
2775
|
-
var
|
|
2776
|
-
var
|
|
2851
|
+
var os2 = __importStar(__require("os"));
|
|
2852
|
+
var path2 = __importStar(__require("path"));
|
|
2777
2853
|
var credentials_1 = require_credentials();
|
|
2778
2854
|
var hookAdapter_1 = require_hookAdapter();
|
|
2779
2855
|
var http_1 = require_http();
|
|
2780
2856
|
var tokenStore_1 = require_tokenStore();
|
|
2781
2857
|
var MANAGEMENT_COMMANDS = /* @__PURE__ */ new Set(["setup", "install", "status", "uninstall", "-h", "--help"]);
|
|
2782
|
-
function
|
|
2858
|
+
function isCliAgentManagementCommand2(argument) {
|
|
2783
2859
|
return argument !== void 0 && MANAGEMENT_COMMANDS.has(argument);
|
|
2784
2860
|
}
|
|
2785
2861
|
function cliAgentHookBinPath(binaryName) {
|
|
2786
|
-
return
|
|
2862
|
+
return path2.join((0, tokenStore_1.ascendaHome)(), "bin", binaryName);
|
|
2787
2863
|
}
|
|
2788
2864
|
function usage(spec) {
|
|
2789
2865
|
return `${spec.binaryName} setup \u2014 wire ${spec.displayName} to Ascenda telemetry
|
|
@@ -2803,7 +2879,7 @@ Options
|
|
|
2803
2879
|
-h, --help
|
|
2804
2880
|
`;
|
|
2805
2881
|
}
|
|
2806
|
-
async function
|
|
2882
|
+
async function runCliAgentSetup2(argv, spec) {
|
|
2807
2883
|
let options;
|
|
2808
2884
|
try {
|
|
2809
2885
|
options = parseArgs(argv, spec);
|
|
@@ -2894,7 +2970,7 @@ Done. ${spec.restartHint}`);
|
|
|
2894
2970
|
break;
|
|
2895
2971
|
}
|
|
2896
2972
|
case "--project-dir":
|
|
2897
|
-
options.projectDir =
|
|
2973
|
+
options.projectDir = path2.resolve(next());
|
|
2898
2974
|
break;
|
|
2899
2975
|
case "--dry-run":
|
|
2900
2976
|
options.dryRun = true;
|
|
@@ -2927,7 +3003,7 @@ ${usage(spec)}`);
|
|
|
2927
3003
|
const toolInstallationId = existingId ?? `${spec.toolType}:${crypto.randomUUID()}`;
|
|
2928
3004
|
let session;
|
|
2929
3005
|
try {
|
|
2930
|
-
session = await (0, http_1.createPairingSession)(apiBaseUrl, toolInstallationId, spec.toolType, `${spec.displayName} on ${
|
|
3006
|
+
session = await (0, http_1.createPairingSession)(apiBaseUrl, toolInstallationId, spec.toolType, `${spec.displayName} on ${os2.hostname()}`);
|
|
2931
3007
|
} catch (error) {
|
|
2932
3008
|
console.error(`
|
|
2933
3009
|
Could not reach ${apiBaseUrl} to pair: ${error instanceof Error ? error.message : String(error)}`);
|
|
@@ -2968,8 +3044,8 @@ Pairing ${status.status}. Run setup again.`);
|
|
|
2968
3044
|
if (dryRun)
|
|
2969
3045
|
return target;
|
|
2970
3046
|
const source = process.argv[1];
|
|
2971
|
-
fs.mkdirSync(
|
|
2972
|
-
if (
|
|
3047
|
+
fs.mkdirSync(path2.dirname(target), { recursive: true });
|
|
3048
|
+
if (path2.resolve(source) !== path2.resolve(target)) {
|
|
2973
3049
|
fs.copyFileSync(source, target);
|
|
2974
3050
|
}
|
|
2975
3051
|
if (process.platform !== "win32")
|
|
@@ -3010,7 +3086,7 @@ ${serialised}`);
|
|
|
3010
3086
|
}
|
|
3011
3087
|
if (exists)
|
|
3012
3088
|
fs.copyFileSync(settingsFile, `${settingsFile}.ascenda-backup`);
|
|
3013
|
-
fs.mkdirSync(
|
|
3089
|
+
fs.mkdirSync(path2.dirname(settingsFile), { recursive: true });
|
|
3014
3090
|
fs.writeFileSync(settingsFile, serialised, "utf8");
|
|
3015
3091
|
return true;
|
|
3016
3092
|
}
|
|
@@ -3098,7 +3174,7 @@ ${serialised}`);
|
|
|
3098
3174
|
(0, credentials_1.removeHostCredentials)(spec.host);
|
|
3099
3175
|
console.log(`removed tools.${spec.host} from ${(0, credentials_1.credentialsFilePath)()}`);
|
|
3100
3176
|
}
|
|
3101
|
-
console.log(`tokens left in ${
|
|
3177
|
+
console.log(`tokens left in ${path2.join((0, tokenStore_1.ascendaHome)(), "tokens")} \u2014 revoke in the Ascenda app to invalidate them`);
|
|
3102
3178
|
return 0;
|
|
3103
3179
|
}
|
|
3104
3180
|
}
|
|
@@ -3149,11 +3225,11 @@ var require_turnState = __commonJS({
|
|
|
3149
3225
|
exports.recordTurnStart = recordTurnStart2;
|
|
3150
3226
|
exports.consumeTurnDurationMs = consumeTurnDurationMs2;
|
|
3151
3227
|
var fs = __importStar(__require("fs"));
|
|
3152
|
-
var
|
|
3153
|
-
var
|
|
3154
|
-
var stateDir = () => process.env.ASCENDA_STATE_DIR ??
|
|
3228
|
+
var path2 = __importStar(__require("path"));
|
|
3229
|
+
var tokenStore_1 = require_tokenStore();
|
|
3230
|
+
var stateDir = () => process.env.ASCENDA_STATE_DIR ?? path2.join((0, tokenStore_1.ascendaHome)(), "state");
|
|
3155
3231
|
function turnFile(agent, sessionId) {
|
|
3156
|
-
return
|
|
3232
|
+
return path2.join(stateDir(), `${sanitize(agent)}-turn-${sanitize(sessionId)}`);
|
|
3157
3233
|
}
|
|
3158
3234
|
function sanitize(value) {
|
|
3159
3235
|
return value.replace(/[^a-zA-Z0-9._-]/g, "_");
|
|
@@ -3232,8 +3308,8 @@ var require_liveBus = __commonJS({
|
|
|
3232
3308
|
exports.emitLiveSignal = emitLiveSignal;
|
|
3233
3309
|
var fs = __importStar(__require("fs"));
|
|
3234
3310
|
var net = __importStar(__require("net"));
|
|
3235
|
-
var
|
|
3236
|
-
var
|
|
3311
|
+
var os2 = __importStar(__require("os"));
|
|
3312
|
+
var path2 = __importStar(__require("path"));
|
|
3237
3313
|
var WRITE_TIMEOUT_MS = 50;
|
|
3238
3314
|
var APP_BUNDLE_ID = "one.ascenda.ascendaMissionControl";
|
|
3239
3315
|
var SAVER_HOST_BUNDLE_ID = "com.apple.ScreenSaver.Engine.legacyScreenSaver";
|
|
@@ -3241,11 +3317,11 @@ var require_liveBus = __commonJS({
|
|
|
3241
3317
|
const override = process.env.ASCENDA_LIVE_BUS_SOCKET;
|
|
3242
3318
|
if (override)
|
|
3243
3319
|
return [override];
|
|
3244
|
-
const home =
|
|
3320
|
+
const home = os2.homedir();
|
|
3245
3321
|
return [
|
|
3246
|
-
|
|
3247
|
-
|
|
3248
|
-
|
|
3322
|
+
path2.join(home, ".ascenda", "live.sock"),
|
|
3323
|
+
path2.join(home, "Library", "Containers", APP_BUNDLE_ID, "Data", ".ascenda", "live.sock"),
|
|
3324
|
+
path2.join(home, "Library", "Containers", SAVER_HOST_BUNDLE_ID, "Data", "l.sock")
|
|
3249
3325
|
];
|
|
3250
3326
|
}
|
|
3251
3327
|
function liveBusSocketPath() {
|
|
@@ -3318,8 +3394,8 @@ var require_out2 = __commonJS({
|
|
|
3318
3394
|
"use strict";
|
|
3319
3395
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3320
3396
|
exports.consumeTurnDurationMs = exports.writeTopLevelCredentials = exports.writeMachineCredentials = exports.writeHostCredentials = exports.removeHostCredentials = exports.readMachineCredentials = exports.readHostCredentials = exports.credentialsFilePath = exports.writeHookSettings = exports.runCliAgentSetup = exports.isCliAgentManagementCommand = exports.findStaleHookCommands = exports.cliAgentHookBinPath = exports.resolveContextHashes = exports.resolveCliAgentInstallationId = exports.loadCliAgentConfig = exports.deliverHookEvents = exports.MissingInstallationIdError = exports.DEFAULT_API_BASE_URL = exports.resolveEventLogPath = exports.expandUserPath = exports.appendEventLog = exports.EVENT_LOG_ENV_VAR = exports.buildEventPayload = exports.AscendaSemanticEventError = exports.AscendaEventSender = exports.mintIdempotencyKey = 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.classifyModelClass = exports.autonomyBand = exports.invitesDebrief = exports.classifyWorkMilestone = exports.isReworkGitAction = exports.classifyGitAction = exports.isVerificationCommand = exports.classifyCommand = void 0;
|
|
3321
|
-
exports.
|
|
3322
|
-
exports.isRetryableStatus = exports.parseIngestResponse = exports.postToolEventsBatch = void 0;
|
|
3397
|
+
exports.getPairingStatus = exports.createPairingSession = exports.AscendaApiError = exports.liveBusSocketCandidates = exports.liveBusSocketPath = exports.bucketPromptSize = exports.emitLiveSignal = exports.recordForgeProjectAlias = exports.forgeFullNameFromConfig = exports.readForgeFullName = exports.parseForgeFullName = exports.forgeProjectHash = exports.workContextRegistryFilePath = exports.readWorkContextRegistry = exports.recordWorkContextAlias = exports.recordWorkContext = exports.readBranchName = exports.normalizeBranchName = exports.deriveBranchHashForCwd = exports.deriveBranchHash = exports.deriveWorkContext = exports.hashWithMachineSalt = exports.readOrCreateMachineSalt = exports.machineSaltFilePath = exports.fixedTimeProvider = exports.systemTimeProvider = exports.enforceOutboxBounds = exports.claimOutbox = exports.readOutboxSummary = exports.appendToOutbox = exports.defaultOutboxFilePath = exports.outboxDrainEnabled = exports.DEFAULT_OUTBOX_DRAIN_BATCH_SIZE = exports.DEFAULT_OUTBOX_MAX_AGE_MS = exports.DEFAULT_OUTBOX_MAX_ENTRIES = exports.OUTBOX_DRAIN_ENV_VAR = exports.recordOutboxDiscard = exports.unresolvedToolInstallationId = exports.unresolvedStateFilePath = exports.markFailureNotified = exports.shouldAnnounceFailure = exports.recordSendOutcome = exports.readCollectorState = exports.defaultStateFilePath = exports.readTokenFile = exports.persistEventWriteToken = exports.listPersistedToolInstallationIds = exports.defaultTokenFilePath = exports.ascendaHome = exports.recordTurnStart = void 0;
|
|
3398
|
+
exports.isRetryableStatus = exports.parseIngestResponse = exports.postToolEventsBatch = exports.postToolEvent = exports.renewToolToken = void 0;
|
|
3323
3399
|
var commandClassifier_1 = require_commandClassifier();
|
|
3324
3400
|
Object.defineProperty(exports, "classifyCommand", { enumerable: true, get: function() {
|
|
3325
3401
|
return commandClassifier_1.classifyCommand;
|
|
@@ -3559,6 +3635,13 @@ var require_out2 = __commonJS({
|
|
|
3559
3635
|
Object.defineProperty(exports, "enforceOutboxBounds", { enumerable: true, get: function() {
|
|
3560
3636
|
return outbox_1.enforceOutboxBounds;
|
|
3561
3637
|
} });
|
|
3638
|
+
var timeProvider_1 = require_timeProvider();
|
|
3639
|
+
Object.defineProperty(exports, "systemTimeProvider", { enumerable: true, get: function() {
|
|
3640
|
+
return timeProvider_1.systemTimeProvider;
|
|
3641
|
+
} });
|
|
3642
|
+
Object.defineProperty(exports, "fixedTimeProvider", { enumerable: true, get: function() {
|
|
3643
|
+
return timeProvider_1.fixedTimeProvider;
|
|
3644
|
+
} });
|
|
3562
3645
|
var salt_1 = require_salt();
|
|
3563
3646
|
Object.defineProperty(exports, "machineSaltFilePath", { enumerable: true, get: function() {
|
|
3564
3647
|
return salt_1.machineSaltFilePath;
|
|
@@ -3790,11 +3873,51 @@ function withHost(metadata) {
|
|
|
3790
3873
|
return { host: CODEX_HOST, ...metadata };
|
|
3791
3874
|
}
|
|
3792
3875
|
|
|
3876
|
+
// src/setup.ts
|
|
3877
|
+
import * as os from "os";
|
|
3878
|
+
import * as path from "path";
|
|
3879
|
+
var HOOK_EVENTS = [
|
|
3880
|
+
"SessionStart",
|
|
3881
|
+
"UserPromptSubmit",
|
|
3882
|
+
"PreToolUse",
|
|
3883
|
+
"PostToolUse",
|
|
3884
|
+
"PreCompact",
|
|
3885
|
+
"PostCompact",
|
|
3886
|
+
"Stop"
|
|
3887
|
+
];
|
|
3888
|
+
var HOOK_TIMEOUT_SECONDS = 10;
|
|
3889
|
+
var SETUP = {
|
|
3890
|
+
host: CODEX_HOST,
|
|
3891
|
+
displayName: "Codex CLI",
|
|
3892
|
+
toolType: ASCENDA_TOOL_TYPE,
|
|
3893
|
+
packageName: "@ascenda-one/codex-hooks",
|
|
3894
|
+
binaryName: "ascenda-codex-hook",
|
|
3895
|
+
hookEvents: HOOK_EVENTS,
|
|
3896
|
+
restartHint: "Restart Codex to load the hooks.",
|
|
3897
|
+
settings: {
|
|
3898
|
+
settingsPath: (scope, projectDir) => scope === "user" ? path.join(os.homedir(), ".codex", "hooks.json") : path.join(projectDir, ".codex", "hooks.json"),
|
|
3899
|
+
// Codex nests as Gemini does — each event maps to an array of
|
|
3900
|
+
// { hooks: [{ type, command }] } — but reads the event from argv rather
|
|
3901
|
+
// than stdin, so unlike Gemini the name has to be on the command line.
|
|
3902
|
+
entry: (command, event) => ({ hooks: [{ type: "command", command: `${command} ${event}`, timeout: HOOK_TIMEOUT_SECONDS }] }),
|
|
3903
|
+
commandOf: (entry) => {
|
|
3904
|
+
const group = entry;
|
|
3905
|
+
const command = group?.hooks?.find((hook) => typeof hook?.command === "string")?.command;
|
|
3906
|
+
return typeof command === "string" ? command : void 0;
|
|
3907
|
+
}
|
|
3908
|
+
}
|
|
3909
|
+
};
|
|
3910
|
+
|
|
3793
3911
|
// src/cli.ts
|
|
3794
3912
|
async function main() {
|
|
3795
|
-
const
|
|
3913
|
+
const command = process.argv[2];
|
|
3914
|
+
if ((0, import_tool_kit2.isCliAgentManagementCommand)(command)) {
|
|
3915
|
+
managementExitCode = await (0, import_tool_kit2.runCliAgentSetup)(process.argv.slice(2), SETUP);
|
|
3916
|
+
return;
|
|
3917
|
+
}
|
|
3918
|
+
const hookName = command;
|
|
3796
3919
|
if (!hookName) {
|
|
3797
|
-
console.error("Usage: ascenda-codex-hook <CodexHookEventName>");
|
|
3920
|
+
console.error("Usage: ascenda-codex-hook <CodexHookEventName> | setup | status | uninstall");
|
|
3798
3921
|
return;
|
|
3799
3922
|
}
|
|
3800
3923
|
const input = await readJsonFromStdin();
|
|
@@ -3805,11 +3928,13 @@ async function main() {
|
|
|
3805
3928
|
await (0, import_tool_kit2.deliverHookEvents)(mapCodexEvent(hookName, input, turnDurationMs), {
|
|
3806
3929
|
toolType: ASCENDA_TOOL_TYPE,
|
|
3807
3930
|
host: CODEX_HOST,
|
|
3931
|
+
setupCommand: `npx ${SETUP.packageName} setup`,
|
|
3808
3932
|
source: "cli_agent",
|
|
3809
3933
|
sessionId,
|
|
3810
3934
|
onNotice: emitSystemMessage
|
|
3811
3935
|
});
|
|
3812
3936
|
}
|
|
3937
|
+
var managementExitCode;
|
|
3813
3938
|
function emitSystemMessage(message) {
|
|
3814
3939
|
console.log(JSON.stringify({ continue: true, systemMessage: message, suppressOutput: true }));
|
|
3815
3940
|
}
|
|
@@ -3830,4 +3955,4 @@ async function readJsonFromStdin() {
|
|
|
3830
3955
|
}
|
|
3831
3956
|
main().catch((error) => {
|
|
3832
3957
|
console.error(error instanceof Error ? error.message : String(error));
|
|
3833
|
-
}).finally(() => process.exit(0));
|
|
3958
|
+
}).finally(() => process.exit(managementExitCode ?? 0));
|
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
|
package/dist/setup.js
ADDED
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import * as os from "os";
|
|
2
|
+
import * as path from "path";
|
|
3
|
+
import { ASCENDA_TOOL_TYPE, CODEX_HOST } from "./types.js";
|
|
4
|
+
/**
|
|
5
|
+
* Only the hooks that map to a catalog event. `PermissionRequest` and the
|
|
6
|
+
* subagent lifecycle pair map to nothing, so registering them would spend a
|
|
7
|
+
* process per approval to send an empty list.
|
|
8
|
+
*/
|
|
9
|
+
export const HOOK_EVENTS = [
|
|
10
|
+
"SessionStart",
|
|
11
|
+
"UserPromptSubmit",
|
|
12
|
+
"PreToolUse", "PostToolUse",
|
|
13
|
+
"PreCompact", "PostCompact",
|
|
14
|
+
"Stop"
|
|
15
|
+
];
|
|
16
|
+
/**
|
|
17
|
+
* Matches the timeout in `examples/hooks.json`, so a hand-merged file and a
|
|
18
|
+
* `setup`-written one do not disagree. Generous on purpose: the adapter caps
|
|
19
|
+
* its own HTTP at 3 s (ASCENDA_HTTP_TIMEOUT_MS), so this ceiling is only ever
|
|
20
|
+
* reached by a wedged process, and Codex awaits command hooks.
|
|
21
|
+
*/
|
|
22
|
+
const HOOK_TIMEOUT_SECONDS = 10;
|
|
23
|
+
export const SETUP = {
|
|
24
|
+
host: CODEX_HOST,
|
|
25
|
+
displayName: "Codex CLI",
|
|
26
|
+
toolType: ASCENDA_TOOL_TYPE,
|
|
27
|
+
packageName: "@ascenda-one/codex-hooks",
|
|
28
|
+
binaryName: "ascenda-codex-hook",
|
|
29
|
+
hookEvents: HOOK_EVENTS,
|
|
30
|
+
restartHint: "Restart Codex to load the hooks.",
|
|
31
|
+
settings: {
|
|
32
|
+
settingsPath: (scope, projectDir) => scope === "user" ? path.join(os.homedir(), ".codex", "hooks.json") : path.join(projectDir, ".codex", "hooks.json"),
|
|
33
|
+
// Codex nests as Gemini does — each event maps to an array of
|
|
34
|
+
// { hooks: [{ type, command }] } — but reads the event from argv rather
|
|
35
|
+
// than stdin, so unlike Gemini the name has to be on the command line.
|
|
36
|
+
entry: (command, event) => ({ hooks: [{ type: "command", command: `${command} ${event}`, timeout: HOOK_TIMEOUT_SECONDS }] }),
|
|
37
|
+
commandOf: (entry) => {
|
|
38
|
+
const group = entry;
|
|
39
|
+
const command = group?.hooks?.find((hook) => typeof hook?.command === "string")?.command;
|
|
40
|
+
return typeof command === "string" ? command : undefined;
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
};
|
|
44
|
+
//# sourceMappingURL=setup.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,cAAc;IACd,kBAAkB;IAClB,YAAY,EAAE,aAAa;IAC3B,YAAY,EAAE,aAAa;IAC3B,MAAM;CACE,CAAC;AAEX;;;;;GAKG;AACH,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAIhC,MAAM,CAAC,MAAM,KAAK,GAAsB;IACtC,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,WAAW;IACxB,QAAQ,EAAE,iBAAiB;IAC3B,WAAW,EAAE,0BAA0B;IACvC,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE,WAAW;IACvB,WAAW,EAAE,kCAAkC;IAC/C,QAAQ,EAAE;QACR,YAAY,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,CAClC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAC;QACpH,8DAA8D;QAC9D,wEAAwE;QACxE,uEAAuE;QACvE,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,OAAO,IAAI,KAAK,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,EAAE,CAAC;QAC5H,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YACnB,MAAM,KAAK,GAAG,KAAmC,CAAC;YAClD,MAAM,OAAO,GAAG,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE,OAAO,KAAK,QAAQ,CAAC,EAAE,OAAO,CAAC;YACzF,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3D,CAAC;KACF;CACF,CAAC"}
|
package/package.json
CHANGED