@ascenda-one/codex-hooks 0.1.3

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.
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
package/dist/config.js ADDED
@@ -0,0 +1,39 @@
1
+ import { defaultTokenFilePath, persistEventWriteToken, readTokenFile } from "@ascenda-one/tool-kit";
2
+ import { ASCENDA_TOOL_TYPE } from "./types.js";
3
+ export function loadConfigFromEnv(sessionIdFromHook) {
4
+ const apiBaseUrl = (process.env.ASCENDA_API_BASE_URL ?? "https://api.ascenda.one").replace(/\/$/, "");
5
+ const toolInstallationIdRaw = process.env.ASCENDA_TOOL_INSTALLATION_ID;
6
+ if (!toolInstallationIdRaw)
7
+ throw new Error("Missing ASCENDA_TOOL_INSTALLATION_ID");
8
+ const toolInstallationId = normalizeToolInstallationId(toolInstallationIdRaw);
9
+ const tokenFilePath = process.env.ASCENDA_EVENT_WRITE_TOKEN_FILE
10
+ ?? defaultTokenFilePath(toolInstallationId);
11
+ const fileToken = readTokenFile(tokenFilePath);
12
+ const eventWriteToken = fileToken ?? process.env.ASCENDA_EVENT_WRITE_TOKEN;
13
+ if (!eventWriteToken)
14
+ throw new Error("Missing ASCENDA_EVENT_WRITE_TOKEN (or token file)");
15
+ // Seed token file so tool-scoped renew can persist rotations unattended.
16
+ if (!fileToken)
17
+ persistEventWriteToken(tokenFilePath, eventWriteToken);
18
+ return {
19
+ apiBaseUrl,
20
+ toolInstallationId,
21
+ eventWriteToken,
22
+ tokenFilePath,
23
+ sessionId: process.env.ASCENDA_SESSION_ID ?? sessionIdFromHook ?? null,
24
+ workspaceHash: process.env.ASCENDA_WORKSPACE_HASH ?? null,
25
+ // Codex awaits command hooks; fail fast rather than stall the agent's turn.
26
+ timeoutMs: parsePositiveInt(process.env.ASCENDA_HTTP_TIMEOUT_MS) ?? 3000
27
+ };
28
+ }
29
+ function normalizeToolInstallationId(value) {
30
+ const trimmed = value.trim();
31
+ if (trimmed.includes(":"))
32
+ return trimmed;
33
+ return `${ASCENDA_TOOL_TYPE}:${trimmed}`;
34
+ }
35
+ function parsePositiveInt(value) {
36
+ const n = Number(value);
37
+ return Number.isInteger(n) && n > 0 ? n : undefined;
38
+ }
39
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
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,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAY/C,MAAM,UAAU,iBAAiB,CAAC,iBAA0B;IAC1D,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,yBAAyB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACtG,MAAM,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC;IACvE,IAAI,CAAC,qBAAqB;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAEpF,MAAM,kBAAkB,GAAG,2BAA2B,CAAC,qBAAqB,CAAC,CAAC;IAC9E,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B;WAC3D,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;IAE9C,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;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IAE3F,yEAAyE;IACzE,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,iBAAiB,IAAI,IAAI;QACtE,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,IAAI;QACzD,4EAA4E;QAC5E,SAAS,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,IAAI;KACzE,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAa;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAC1C,OAAO,GAAG,iBAAiB,IAAI,OAAO,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAyB;IACjD,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC"}
@@ -0,0 +1,86 @@
1
+ import { bucketDurationMs, classifyCommand, getNestedString, getString, inferOutcome, isVerificationCommand, looksLikeCorrection } from "@ascenda-one/tool-kit";
2
+ import { CODEX_HOST } from "./types.js";
3
+ /**
4
+ * Maps Codex lifecycle hooks to the canonical Ascenda event catalog.
5
+ * Catalog values only; hooks without a catalog counterpart map to nothing.
6
+ * See docs/CODEX_MAPPING.md.
7
+ */
8
+ export function mapCodexEvent(hookName, input, turnDurationMs) {
9
+ switch (hookName) {
10
+ case "SessionStart": return mapSessionStart(input);
11
+ case "UserPromptSubmit": return mapUserPromptSubmit(input);
12
+ case "PreToolUse": return [{ eventType: "ai_tool_call_started", severity: "low", metadata: withHost({ toolName: sanitiseToolName(getToolName(input)) }) }];
13
+ case "PostToolUse": return mapPostToolUse(input);
14
+ case "PreCompact": return mapPreCompact(input);
15
+ case "PostCompact": return [{ eventType: "context_pressure_high", severity: "medium", metadata: withHost({ trigger: "inferred", reason: "context_limit" }) }];
16
+ case "Stop": return mapStop(turnDurationMs);
17
+ // No catalog events for approvals or subagent lifecycle; skip to avoid unclassified noise.
18
+ case "PermissionRequest":
19
+ case "SubagentStart":
20
+ case "SubagentStop":
21
+ return [];
22
+ default: return [];
23
+ }
24
+ }
25
+ function mapSessionStart(input) {
26
+ const source = getString(input, ["source"]);
27
+ // "clear" and "compact" restarts are not new working sessions.
28
+ if (source && source !== "startup" && source !== "resume")
29
+ return [];
30
+ return [{ eventType: "create_focus_session", severity: "low", metadata: withHost({ activity: "session_started" }) }];
31
+ }
32
+ function mapUserPromptSubmit(input) {
33
+ const prompt = getString(input, ["prompt", "userPrompt", "message"]) ?? getNestedString(input, [["payload", "prompt"]]);
34
+ const events = [{ eventType: "ai_prompt_submitted", severity: "low", metadata: withHost({ promptClass: "unknown" }) }];
35
+ if (looksLikeCorrection(prompt)) {
36
+ events.push({ eventType: "ai_correction_prompt", severity: "medium", metadata: withHost({ reason: "repeated_reprompting", trigger: "inferred" }) });
37
+ }
38
+ return events;
39
+ }
40
+ function mapPostToolUse(input) {
41
+ const toolName = getToolName(input);
42
+ const safeToolName = sanitiseToolName(toolName);
43
+ const outcome = inferOutcome(input);
44
+ const command = getString(input, ["command"]) ?? getNestedString(input, [["tool_input", "command"], ["input", "command"]]);
45
+ const commandClass = classifyCommand(command);
46
+ const lowered = toolName?.toLowerCase();
47
+ const isShell = lowered === "bash" || lowered === "shell" || lowered === "local_shell";
48
+ if (outcome === "failure") {
49
+ if (isShell && isVerificationCommand(commandClass)) {
50
+ return [{ eventType: "compile_error", severity: "medium", metadata: withHost({ toolName: safeToolName, commandClass, outcome, reason: "test_failure" }) }];
51
+ }
52
+ return [{ eventType: "ai_tool_call_failed", severity: "medium", metadata: withHost({ toolName: safeToolName, commandClass, outcome, reason: "tool_failure" }) }];
53
+ }
54
+ // apply_patch is Codex's file-modification tool.
55
+ if (lowered === "apply_patch") {
56
+ return [{ eventType: "ai_file_edit", severity: "low", metadata: withHost({ toolName: safeToolName, outcome }) }];
57
+ }
58
+ if (isShell && isVerificationCommand(commandClass)) {
59
+ return [{ eventType: "editor_verification_activity", severity: "low", metadata: withHost({ toolName: safeToolName, commandClass, outcome, activity: "ai_test_or_build_run" }) }];
60
+ }
61
+ return [{ eventType: "ai_tool_call_completed", severity: "low", metadata: withHost({ toolName: safeToolName, commandClass, outcome }) }];
62
+ }
63
+ function mapPreCompact(input) {
64
+ const trigger = getString(input, ["trigger", "reason"]);
65
+ const isManual = trigger?.toLowerCase().includes("manual") ?? false;
66
+ return [{ eventType: isManual ? "context_compression_manual" : "context_compression_auto", severity: isManual ? "medium" : "high", metadata: withHost({ trigger: isManual ? "manual" : "auto", reason: "context_limit" }) }];
67
+ }
68
+ function mapStop(turnDurationMs) {
69
+ const durationBucket = bucketDurationMs(turnDurationMs);
70
+ if (durationBucket === "30-60m" || durationBucket === "60m+") {
71
+ return [{ eventType: "agent_loop_long", severity: durationBucket === "60m+" ? "high" : "medium", metadata: withHost({ durationBucket, reason: "long_session", trigger: "inferred" }) }];
72
+ }
73
+ return [];
74
+ }
75
+ function getToolName(input) {
76
+ return getString(input, ["tool_name", "toolName", "name"]);
77
+ }
78
+ function sanitiseToolName(toolName) {
79
+ if (!toolName)
80
+ return "unknown";
81
+ return toolName.replace(/[^a-zA-Z0-9_-]/g, "").slice(0, 40) || "unknown";
82
+ }
83
+ function withHost(metadata) {
84
+ return { host: CODEX_HOST, ...metadata };
85
+ }
86
+ //# sourceMappingURL=mapCodexEvent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mapCodexEvent.js","sourceRoot":"","sources":["../src/mapCodexEvent.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,41 @@
1
+ import * as fs from "fs";
2
+ import * as os from "os";
3
+ import * as path from "path";
4
+ /**
5
+ * Codex's Stop hook carries no duration, so agent-loop length is measured
6
+ * here: UserPromptSubmit records a turn-start timestamp per session, Stop
7
+ * consumes it. State lives in small files so each one-shot hook invocation
8
+ * can see the previous one. All failures degrade to "no duration" silently -
9
+ * telemetry must never break the agent.
10
+ */
11
+ const STATE_DIR = () => process.env.ASCENDA_STATE_DIR ?? path.join(os.homedir(), ".ascenda", "state");
12
+ function turnFile(sessionId) {
13
+ return path.join(STATE_DIR(), `codex-turn-${sessionId.replace(/[^a-zA-Z0-9._-]/g, "_")}`);
14
+ }
15
+ export function recordTurnStart(sessionId, now = Date.now()) {
16
+ if (!sessionId)
17
+ return;
18
+ try {
19
+ fs.mkdirSync(STATE_DIR(), { recursive: true });
20
+ fs.writeFileSync(turnFile(sessionId), String(now), { encoding: "utf8", mode: 0o600 });
21
+ }
22
+ catch {
23
+ // best effort only
24
+ }
25
+ }
26
+ export function consumeTurnDurationMs(sessionId, now = Date.now()) {
27
+ if (!sessionId)
28
+ return undefined;
29
+ const file = turnFile(sessionId);
30
+ try {
31
+ const started = Number(fs.readFileSync(file, "utf8").trim());
32
+ fs.rmSync(file, { force: true });
33
+ if (!Number.isFinite(started) || started <= 0 || started > now)
34
+ return undefined;
35
+ return now - started;
36
+ }
37
+ catch {
38
+ return undefined;
39
+ }
40
+ }
41
+ //# sourceMappingURL=turnState.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"turnState.js","sourceRoot":"","sources":["../src/turnState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAEtG,SAAS,QAAQ,CAAC,SAAiB;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,cAAc,SAAS,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAA6B,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAC7E,IAAI,CAAC,SAAS;QAAE,OAAO;IACvB,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,SAA6B,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IACnF,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7D,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,OAAO,GAAG,GAAG;YAAE,OAAO,SAAS,CAAC;QACjF,OAAO,GAAG,GAAG,OAAO,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}
package/dist/types.js ADDED
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Backend toolType/source registry has no codex-specific value yet; Codex
3
+ * rides the canonical cli_agent identity, with metadata.host distinguishing
4
+ * it for later disaggregation.
5
+ */
6
+ export const ASCENDA_TOOL_TYPE = "cli_agent";
7
+ export const CODEX_HOST = "codex";
8
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAC7C,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC"}
@@ -0,0 +1,11 @@
1
+ {
2
+ "hooks": {
3
+ "SessionStart": [{ "hooks": [{ "type": "command", "command": "ascenda-codex-hook SessionStart", "timeout": 10 }] }],
4
+ "UserPromptSubmit": [{ "hooks": [{ "type": "command", "command": "ascenda-codex-hook UserPromptSubmit", "timeout": 10 }] }],
5
+ "PreToolUse": [{ "hooks": [{ "type": "command", "command": "ascenda-codex-hook PreToolUse", "timeout": 10 }] }],
6
+ "PostToolUse": [{ "hooks": [{ "type": "command", "command": "ascenda-codex-hook PostToolUse", "timeout": 10 }] }],
7
+ "PreCompact": [{ "hooks": [{ "type": "command", "command": "ascenda-codex-hook PreCompact", "timeout": 10 }] }],
8
+ "PostCompact": [{ "hooks": [{ "type": "command", "command": "ascenda-codex-hook PostCompact", "timeout": 10 }] }],
9
+ "Stop": [{ "hooks": [{ "type": "command", "command": "ascenda-codex-hook Stop", "timeout": 10 }] }]
10
+ }
11
+ }
@@ -0,0 +1,9 @@
1
+ {
2
+ "session_id": "sess-sample",
3
+ "hook_event_name": "PostToolUse",
4
+ "turn_id": "turn-1",
5
+ "tool_name": "Bash",
6
+ "tool_use_id": "tu-1",
7
+ "tool_input": { "command": "npm test" },
8
+ "tool_response": { "exitCode": 0 }
9
+ }
package/package.json ADDED
@@ -0,0 +1,33 @@
1
+ {
2
+ "publishConfig": { "access": "public" },
3
+ "name": "@ascenda-one/codex-hooks",
4
+ "version": "0.1.3",
5
+ "description": "OpenAI Codex hooks adapter for Ascenda AI workload telemetry",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "https://github.com/ascendaone-com/ai-engineer-tools.git",
9
+ "directory": "ascenda-codex-hooks"
10
+ },
11
+ "type": "module",
12
+ "files": ["dist", "examples"],
13
+ "license": "Apache-2.0",
14
+ "bin": {
15
+ "ascenda-codex-hook": "./dist/cli.js"
16
+ },
17
+ "scripts": {
18
+ "build": "tsc -p ./ && npm run bundle",
19
+ "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",
20
+ "watch": "tsc -w -p ./",
21
+ "test": "node --test",
22
+ "test:sample": "npm run build && cat examples/sample-post-tool-use-bash.json | node dist/cli.js PostToolUse"
23
+ },
24
+ "engines": {
25
+ "node": ">=20"
26
+ },
27
+ "devDependencies": {
28
+ "@ascenda-one/tool-contract": "*",
29
+ "@ascenda-one/tool-kit": "*",
30
+ "@types/node": "^20.14.10",
31
+ "typescript": "^5.5.0"
32
+ }
33
+ }