airband 0.0.4 → 0.0.5

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/airband-hook.js CHANGED
@@ -982,8 +982,149 @@ function toolNotice(toolName, toolInput, toolResponse, cwd) {
982
982
  return `\u21AA Airband${where}: ${what}${tail}`;
983
983
  }
984
984
 
985
- // src/core/writing.ts
985
+ // src/station/client.ts
986
986
  var fs8 = __toESM(require("node:fs"));
987
+ var http = __toESM(require("node:http"));
988
+ var stationFile = () => airbandFile("station.json");
989
+ var DECISION_MS = 11e4;
990
+ var CONNECT_MS = 400;
991
+ function readStationInfo() {
992
+ try {
993
+ const info = JSON.parse(fs8.readFileSync(stationFile(), "utf8"));
994
+ if (!info.port || !info.token) return void 0;
995
+ try {
996
+ process.kill(info.pid, 0);
997
+ } catch (e) {
998
+ if (e.code === "ESRCH") return void 0;
999
+ }
1000
+ return info;
1001
+ } catch {
1002
+ return void 0;
1003
+ }
1004
+ }
1005
+ function stationPost(info, route, body, budgetMs) {
1006
+ return new Promise((resolve6) => {
1007
+ const data = Buffer.from(JSON.stringify(body));
1008
+ let done = false;
1009
+ const finish = (v) => {
1010
+ if (done) return;
1011
+ done = true;
1012
+ clearTimeout(timer);
1013
+ resolve6(v);
1014
+ };
1015
+ const req = http.request(
1016
+ { host: "127.0.0.1", port: info.port, path: route, method: "POST", headers: { "content-type": "application/json", "content-length": data.length, "x-airband-token": info.token } },
1017
+ (res) => {
1018
+ let text = "";
1019
+ res.setEncoding("utf8");
1020
+ res.on("data", (c) => text += c);
1021
+ res.on("end", () => {
1022
+ try {
1023
+ finish(res.statusCode === 200 ? JSON.parse(text) : void 0);
1024
+ } catch {
1025
+ finish(void 0);
1026
+ }
1027
+ });
1028
+ res.on("error", () => finish(void 0));
1029
+ }
1030
+ );
1031
+ const timer = setTimeout(() => {
1032
+ req.destroy();
1033
+ finish(void 0);
1034
+ }, budgetMs);
1035
+ req.setTimeout(CONNECT_MS, () => {
1036
+ if (!req.socket || req.socket.connecting) {
1037
+ req.destroy();
1038
+ finish(void 0);
1039
+ }
1040
+ });
1041
+ req.on("socket", (s) => s.once("connect", () => req.setTimeout(0)));
1042
+ req.on("error", () => finish(void 0));
1043
+ req.end(data);
1044
+ });
1045
+ }
1046
+ async function askStation(ask, info = readStationInfo()) {
1047
+ if (!info || info.approvals === false || process.env.AIRBAND_NO_STATION) return void 0;
1048
+ const wait = Math.min(info.waitMs ?? DECISION_MS, DECISION_MS);
1049
+ const res = await stationPost(info, "/api/hook/permission", { ...ask, waitMs: wait }, wait + 2e3);
1050
+ return res?.answer;
1051
+ }
1052
+
1053
+ // src/station/reply.ts
1054
+ var TAKES_DECISIONS = ["claude", "codex"];
1055
+ function questionsOf(toolName, input) {
1056
+ if (toolName !== "AskUserQuestion" || !input || typeof input !== "object") return void 0;
1057
+ const qs = input.questions;
1058
+ if (!Array.isArray(qs) || !qs.length) return void 0;
1059
+ const out2 = [];
1060
+ for (const q of qs) {
1061
+ if (!q || typeof q !== "object") return void 0;
1062
+ const { question, header, options, multiSelect } = q;
1063
+ if (typeof question !== "string" || !Array.isArray(options)) return void 0;
1064
+ const opts = options.map((o) => o && typeof o === "object" ? o : {}).filter((o) => typeof o.label === "string").map((o) => ({ label: o.label, ...typeof o.description === "string" ? { description: o.description } : {} }));
1065
+ out2.push({ question, ...typeof header === "string" ? { header } : {}, options: opts, ...multiSelect === true ? { multiSelect: true } : {} });
1066
+ }
1067
+ return out2;
1068
+ }
1069
+ function answersFit(questions, answers) {
1070
+ if (!questions.length || Object.keys(answers).length !== questions.length) return false;
1071
+ return questions.every((q) => {
1072
+ const labels = q.options.map((o) => o.label);
1073
+ const pick = answers[q.question];
1074
+ if (q.multiSelect) {
1075
+ if (!Array.isArray(pick) || !pick.length || new Set(pick).size !== pick.length) return false;
1076
+ return pick.every((p) => labels.includes(p));
1077
+ }
1078
+ return typeof pick === "string" && labels.includes(pick);
1079
+ });
1080
+ }
1081
+ function permissionReply(agent, toolName, input, answer) {
1082
+ if (!answer || !TAKES_DECISIONS.includes(agent)) return void 0;
1083
+ const wrap = (decision) => JSON.stringify({ hookSpecificOutput: { hookEventName: "PermissionRequest", decision } });
1084
+ switch (answer.decision) {
1085
+ case "allow":
1086
+ case "always": {
1087
+ const questions = agent === "claude" ? questionsOf(toolName, input) : void 0;
1088
+ if (questions) {
1089
+ if (!answer.answers || !answersFit(questions, answer.answers)) return void 0;
1090
+ return wrap({ behavior: "allow", updatedInput: { ...input, answers: answer.answers } });
1091
+ }
1092
+ return wrap({ behavior: "allow" });
1093
+ }
1094
+ case "deny":
1095
+ return wrap({ behavior: "deny", message: (answer.message ?? "").trim() || "The person said no from Airband." });
1096
+ default:
1097
+ return void 0;
1098
+ }
1099
+ }
1100
+ function describeRequest(toolName, input) {
1101
+ const i = input && typeof input === "object" ? input : {};
1102
+ const str = (v) => typeof v === "string" ? v : void 0;
1103
+ const name = toolName ?? "a tool";
1104
+ if (toolName === "Bash" || toolName === "shell" || toolName === "exec_command" || toolName === "local_shell") {
1105
+ const cmd = str(i.command) ?? (Array.isArray(i.command) ? i.command.join(" ") : void 0) ?? str(i.cmd);
1106
+ return { title: "Wants to run a command", ...cmd ? { detail: cmd } : {} };
1107
+ }
1108
+ if (toolName === "Write" || toolName === "Edit" || toolName === "MultiEdit" || toolName === "NotebookEdit") {
1109
+ const file = str(i.file_path) ?? str(i.notebook_path);
1110
+ return { title: toolName === "Write" ? "Wants to write a file" : "Wants to edit a file", ...file ? { detail: file } : {} };
1111
+ }
1112
+ if (toolName === "WebFetch") return { title: "Wants to open a web page", ...str(i.url) ? { detail: str(i.url) } : {} };
1113
+ if (toolName === "WebSearch") return { title: "Wants to search the web", ...str(i.query) ? { detail: str(i.query) } : {} };
1114
+ if (toolName === "AskUserQuestion") {
1115
+ const first = questionsOf(toolName, input)?.[0]?.question;
1116
+ return { title: "Has a question for you", ...first ? { detail: first } : {} };
1117
+ }
1118
+ if (toolName === "ExitPlanMode") return { title: "Has a plan ready for you to approve", ...str(i.plan) ? { detail: str(i.plan).slice(0, 400) } : {} };
1119
+ if (toolName?.startsWith("mcp__")) {
1120
+ const [, server, tool] = toolName.split("__");
1121
+ return { title: `Wants to use ${tool ?? "a tool"} (${server ?? "MCP"})` };
1122
+ }
1123
+ return { title: `Wants to use ${name}` };
1124
+ }
1125
+
1126
+ // src/core/writing.ts
1127
+ var fs9 = __toESM(require("node:fs"));
987
1128
  var path7 = __toESM(require("node:path"));
988
1129
  var PROJECT_FILE = ".airband.json";
989
1130
  function projectFile(cwd) {
@@ -991,8 +1132,8 @@ function projectFile(cwd) {
991
1132
  let dir2 = path7.resolve(cwd);
992
1133
  for (let i = 0; i < 12; i++) {
993
1134
  const f = path7.join(dir2, PROJECT_FILE);
994
- if (fs8.existsSync(f)) return f;
995
- if (fs8.existsSync(path7.join(dir2, ".git"))) return void 0;
1135
+ if (fs9.existsSync(f)) return f;
1136
+ if (fs9.existsSync(path7.join(dir2, ".git"))) return void 0;
996
1137
  const up = path7.dirname(dir2);
997
1138
  if (up === dir2) return void 0;
998
1139
  dir2 = up;
@@ -1260,7 +1401,7 @@ function checkWrittenDoc(doc) {
1260
1401
  if (!found.length) return found;
1261
1402
  let offset = 0;
1262
1403
  try {
1263
- const whole = fs8.readFileSync(doc.file, "utf8");
1404
+ const whole = fs9.readFileSync(doc.file, "utf8");
1264
1405
  const at = whole.indexOf(doc.text.split("\n").find((l) => l.trim().length > 8) ?? doc.text);
1265
1406
  const firstLong = doc.text.split("\n").findIndex((l) => l.trim().length > 8);
1266
1407
  if (at >= 0) offset = whole.slice(0, at).split("\n").length - 1 - Math.max(0, firstLong);
@@ -1288,7 +1429,7 @@ function shellValues(command, flags, cwd) {
1288
1429
  const name = file && (file[2] ?? file[3] ?? file[4]);
1289
1430
  if (name && name !== "-") {
1290
1431
  try {
1291
- out2.push(fs8.readFileSync(path7.resolve(cwd ?? ".", name), "utf8").slice(0, 64e3));
1432
+ out2.push(fs9.readFileSync(path7.resolve(cwd ?? ".", name), "utf8").slice(0, 64e3));
1292
1433
  } catch {
1293
1434
  }
1294
1435
  }
@@ -1354,7 +1495,7 @@ function holdOnce(sessionId, text, now = Date.now()) {
1354
1495
 
1355
1496
  // src/hook/airband-hook.ts
1356
1497
  var EVENT_ALIASES = {
1357
- claude: {},
1498
+ claude: { PermissionRequest: "Notification" },
1358
1499
  codex: { PermissionRequest: "Notification" },
1359
1500
  gemini: { BeforeAgent: "UserPromptSubmit", AfterAgent: "Stop", AfterTool: "PostToolUse", BeforeTool: "PreToolUse" }
1360
1501
  };
@@ -1384,6 +1525,10 @@ function record(input, now = Date.now()) {
1384
1525
  if (!id || !status || !safeId(id)) return;
1385
1526
  const entry = { status, at: now, event: input.hook_event_name, cwd: input.cwd };
1386
1527
  if (status === "waiting" && input.message) entry.message = input.message.slice(0, 200);
1528
+ else if (status === "waiting" && input.tool_name) {
1529
+ const d = describeRequest(input.tool_name, input.tool_input);
1530
+ entry.message = (d.detail ? `${d.title}: ${d.detail}` : d.title).slice(0, 200);
1531
+ }
1387
1532
  writeFileAtomic(path8.join(statusDir(), `${id}.json`), JSON.stringify(entry));
1388
1533
  }
1389
1534
  function readSince(tool, file, cursor) {
@@ -1496,6 +1641,7 @@ function out(tool, event, context, notice) {
1496
1641
  return Object.keys(o).length ? JSON.stringify(o) : void 0;
1497
1642
  }
1498
1643
  function handle(raw, now = Date.now(), tool = "claude") {
1644
+ if (process.env.AIRBAND_COMPANION) return void 0;
1499
1645
  const input = normalise2(raw, tool);
1500
1646
  record(input, now);
1501
1647
  switch (input.hook_event_name) {
@@ -1600,6 +1746,21 @@ function sendCheck(input, tool) {
1600
1746
  return void 0;
1601
1747
  }
1602
1748
  }
1749
+ async function permission(raw, tool, now = Date.now()) {
1750
+ try {
1751
+ handle(raw, now, tool);
1752
+ } catch {
1753
+ }
1754
+ if (process.env.AIRBAND_COMPANION || tool !== "claude" && tool !== "codex") return void 0;
1755
+ const answer = await askStation({ agent: tool, session_id: raw.session_id, cwd: raw.cwd, transcript_path: raw.transcript_path, tool_name: raw.tool_name, tool_input: raw.tool_input });
1756
+ if (answer && raw.session_id && safeId(raw.session_id)) {
1757
+ try {
1758
+ writeFileAtomic(path8.join(statusDir(), `${raw.session_id}.json`), JSON.stringify({ status: "working", at: Date.now(), event: "PermissionAnswered", cwd: raw.cwd }));
1759
+ } catch {
1760
+ }
1761
+ }
1762
+ return permissionReply(tool, raw.tool_name, raw.tool_input, answer);
1763
+ }
1603
1764
  function main() {
1604
1765
  const arg = (process.argv[2] ?? "claude").toLowerCase();
1605
1766
  const tool = arg === "codex" || arg === "gemini" ? arg : "claude";
@@ -1607,14 +1768,33 @@ function main() {
1607
1768
  process.stdin.setEncoding("utf8");
1608
1769
  process.stdin.on("data", (chunk) => raw += chunk);
1609
1770
  process.stdin.on("end", () => {
1771
+ let input;
1772
+ try {
1773
+ input = JSON.parse(raw);
1774
+ } catch {
1775
+ process.exit(0);
1776
+ }
1777
+ if (input.hook_event_name === "PermissionRequest") {
1778
+ clearTimeout(limit);
1779
+ setTimeout(() => process.exit(0), 115e3).unref();
1780
+ void permission(input, tool).then(
1781
+ (out2) => {
1782
+ if (out2) process.stdout.write(out2);
1783
+ process.exit(0);
1784
+ },
1785
+ () => process.exit(0)
1786
+ );
1787
+ return;
1788
+ }
1610
1789
  try {
1611
- const out2 = handle(JSON.parse(raw), Date.now(), tool);
1790
+ const out2 = handle(input, Date.now(), tool);
1612
1791
  if (out2) process.stdout.write(out2);
1613
1792
  } catch {
1614
1793
  }
1615
1794
  process.exit(0);
1616
1795
  });
1617
- setTimeout(() => process.exit(0), 4e3).unref();
1796
+ const limit = setTimeout(() => process.exit(0), 4e3);
1797
+ limit.unref();
1618
1798
  }
1619
1799
 
1620
1800
  // src/hook/bin.ts
package/airband-mcp.js CHANGED
@@ -44998,7 +44998,7 @@ var INSTRUCTIONS = [
44998
44998
  "- When the person refers to earlier work or another chat (what was done, which chat changed something, what happened while they were away, a ticket like ENG-142, a PR like #128), call airband_flightlog: with query to search every chat, or with chat to read one.",
44999
44999
  "- airband_notes holds notes chats left for this project; read them before working in an unfamiliar area, and save one when you learn something the next chat should know."
45000
45000
  ].join("\n");
45001
- var server = new McpServer({ name: "airband", version: "0.0.4" }, { instructions: INSTRUCTIONS });
45001
+ var server = new McpServer({ name: "airband", version: "0.0.5" }, { instructions: INSTRUCTIONS });
45002
45002
  var text = (t, isError = false) => ({ content: [{ type: "text", text: t }], ...isError ? { isError } : {} });
45003
45003
  var maps = /* @__PURE__ */ new Map();
45004
45004
  async function freshMap(folder = root) {