@narumitw/pi-files 0.0.0-stage → 0.1.0

package/dist/chunks/chunk-NFNGJETD.ts

@@ -0,0 +1,77 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
+
+// src/scope/state.ts
+import { isAbsolute, resolve } from "node:path";
+var STATE_TYPE = "scope-state";
+var MAX_TARGETS = 100;
+var MAX_STATE_BYTES = 24e3;
+function absolutePath(value) {
+  return typeof value === "string" && !value.includes("\0") && isAbsolute(value) && resolve(value) === value;
+}
+function createSnapshot(cwd, targets) {
+  if (!absolutePath(cwd)) throw new Error("Scope workspace must be an absolute normalized path");
+  if (targets !== null && (targets.length === 0 || targets.length > MAX_TARGETS)) {
+    throw new Error(`Select between 1 and ${MAX_TARGETS} files; use /scope off to end the restriction`);
+  }
+  const unique = /* @__PURE__ */ new Map();
+  for (const target of targets ?? []) {
+    if (!absolutePath(target?.path) || !absolutePath(target?.canonical)) {
+      throw new Error("Scope targets must contain absolute normalized paths");
+    }
+    if (!unique.has(target.canonical)) unique.set(target.canonical, { path: target.path, canonical: target.canonical });
+  }
+  const snapshot = {
+    version: 1,
+    cwd,
+    targets: targets === null ? null : [...unique.values()].sort((a, b) => a.canonical < b.canonical ? -1 : a.canonical > b.canonical ? 1 : 0)
+  };
+  if (Buffer.byteLength(JSON.stringify(snapshot)) > MAX_STATE_BYTES) {
+    throw new Error(`Scope selection exceeds the ${MAX_STATE_BYTES}-byte notice limit; select fewer files`);
+  }
+  return snapshot;
+}
+function parseSnapshot(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) throw new Error("Invalid scope snapshot");
+  const data = value;
+  if (data.version !== 1 || typeof data.cwd !== "string" || data.targets !== null && !Array.isArray(data.targets)) {
+    throw new Error("Invalid or unsupported scope snapshot");
+  }
+  return createSnapshot(data.cwd, data.targets);
+}
+function restoreScope(branch, cwd) {
+  for (let index = branch.length - 1; index >= 0; index -= 1) {
+    const entry = branch[index];
+    if (entry.type !== "custom" || entry.customType !== STATE_TYPE) continue;
+    try {
+      const snapshot = parseSnapshot(entry.data);
+      if (snapshot.cwd !== resolve(cwd)) throw new Error("Saved scope belongs to another workspace");
+      return { state: snapshot.targets === null ? "inactive" : "active", snapshot, entryId: entry.id };
+    } catch (error) {
+      return {
+        state: "blocked",
+        entryId: entry.id,
+        error: `${error instanceof Error ? error.message : "Scope restoration failed"}. Edits remain blocked; repair with /scope or exit with /scope off.`
+      };
+    }
+  }
+  return { state: "inactive" };
+}
+function sameScope(left, right) {
+  if (!left || left.cwd !== right.cwd || left.targets === null !== (right.targets === null)) return false;
+  if (left.targets === null || right.targets === null) return left.targets === right.targets;
+  return left.targets.length === right.targets.length && left.targets.every((target, index) => {
+    const other = right.targets?.[index];
+    return target.canonical === other?.canonical && target.path === other.path;
+  });
+}
+
+export {
+  STATE_TYPE,
+  MAX_TARGETS,
+  createSnapshot,
+  parseSnapshot,
+  restoreScope,
+  sameScope
+};
+//# sourceMappingURL=chunk-NFNGJETD.ts.map

package/dist/chunks/chunk-NFNGJETD.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/scope/state.ts"],
+  "sourcesContent": ["import { isAbsolute, resolve } from \"node:path\";\nimport type { SessionEntry } from \"@earendil-works/pi-coding-agent\";\nimport type { ScopeTarget } from \"./paths.js\";\n\n// Persisted session identity must survive package renames or active guards would be lost.\nexport const STATE_TYPE = \"scope-state\";\nexport const MAX_TARGETS = 100;\nexport const MAX_STATE_BYTES = 24_000;\n\nexport interface ScopeSnapshot {\n  version: 1;\n  cwd: string;\n  targets: ScopeTarget[] | null;\n}\n\nexport interface ScopeState {\n  state: \"inactive\" | \"active\" | \"blocked\";\n  entryId?: string;\n  snapshot?: ScopeSnapshot;\n  error?: string;\n}\n\nfunction absolutePath(value: unknown): value is string {\n  return typeof value === \"string\" && !value.includes(\"\\0\") && isAbsolute(value) && resolve(value) === value;\n}\n\nexport function createSnapshot(cwd: string, targets: readonly ScopeTarget[] | null): ScopeSnapshot {\n  if (!absolutePath(cwd)) throw new Error(\"Scope workspace must be an absolute normalized path\");\n  if (targets !== null && (targets.length === 0 || targets.length > MAX_TARGETS)) {\n    throw new Error(`Select between 1 and ${MAX_TARGETS} files; use /scope off to end the restriction`);\n  }\n  const unique = new Map<string, ScopeTarget>();\n  for (const target of targets ?? []) {\n    if (!absolutePath(target?.path) || !absolutePath(target?.canonical)) {\n      throw new Error(\"Scope targets must contain absolute normalized paths\");\n    }\n    if (!unique.has(target.canonical)) unique.set(target.canonical, { path: target.path, canonical: target.canonical });\n  }\n  const snapshot: ScopeSnapshot = {\n    version: 1,\n    cwd,\n    targets:\n      targets === null\n        ? null\n        : [...unique.values()].sort((a, b) => (a.canonical < b.canonical ? -1 : a.canonical > b.canonical ? 1 : 0)),\n  };\n  if (Buffer.byteLength(JSON.stringify(snapshot)) > MAX_STATE_BYTES) {\n    throw new Error(`Scope selection exceeds the ${MAX_STATE_BYTES}-byte notice limit; select fewer files`);\n  }\n  return snapshot;\n}\n\nexport function parseSnapshot(value: unknown): ScopeSnapshot {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) throw new Error(\"Invalid scope snapshot\");\n  const data = value as Record<string, unknown>;\n  if (data.version !== 1 || typeof data.cwd !== \"string\" || (data.targets !== null && !Array.isArray(data.targets))) {\n    throw new Error(\"Invalid or unsupported scope snapshot\");\n  }\n  return createSnapshot(data.cwd, data.targets as ScopeTarget[] | null);\n}\n\nexport function restoreScope(branch: readonly SessionEntry[], cwd: string): ScopeState {\n  for (let index = branch.length - 1; index >= 0; index -= 1) {\n    const entry = branch[index];\n    if (entry.type !== \"custom\" || entry.customType !== STATE_TYPE) continue;\n    try {\n      const snapshot = parseSnapshot(entry.data);\n      if (snapshot.cwd !== resolve(cwd)) throw new Error(\"Saved scope belongs to another workspace\");\n      return { state: snapshot.targets === null ? \"inactive\" : \"active\", snapshot, entryId: entry.id };\n    } catch (error) {\n      return {\n        state: \"blocked\",\n        entryId: entry.id,\n        error: `${error instanceof Error ? error.message : \"Scope restoration failed\"}. Edits remain blocked; repair with /scope or exit with /scope off.`,\n      };\n    }\n  }\n  return { state: \"inactive\" };\n}\n\nexport function sameScope(left: ScopeSnapshot | undefined, right: ScopeSnapshot): boolean {\n  if (!left || left.cwd !== right.cwd || (left.targets === null) !== (right.targets === null)) return false;\n  if (left.targets === null || right.targets === null) return left.targets === right.targets;\n  return (\n    left.targets.length === right.targets.length &&\n    left.targets.every((target, index) => {\n      const other = right.targets?.[index];\n      return target.canonical === other?.canonical && target.path === other.path;\n    })\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/chunks/chunk-OPGTWNJI.ts

@@ -0,0 +1,258 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
+
+// src/file-context-settings.ts
+import { randomUUID } from "node:crypto";
+import { constants } from "node:fs";
+import { mkdir, open, rename, rm, writeFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+var FILE_CONTEXT_SETTINGS_FILE = "pi-file-context.json";
+var MAX_SETTINGS_BYTES = 64 * 1024;
+var DEFAULT_FILE_CONTEXT_SETTINGS = {
+  openShortcut: "ctrl+shift+x"
+};
+var MODIFIERS = /* @__PURE__ */ new Set(["ctrl", "shift", "alt", "super"]);
+var BASE_KEYS = /* @__PURE__ */ new Set([
+  ..."abcdefghijklmnopqrstuvwxyz0123456789",
+  "`",
+  "-",
+  "=",
+  "[",
+  "]",
+  "\\",
+  ";",
+  "'",
+  ",",
+  ".",
+  "/",
+  "!",
+  "@",
+  "#",
+  "$",
+  "%",
+  "^",
+  "&",
+  "*",
+  "(",
+  ")",
+  "_",
+  "+",
+  "|",
+  "~",
+  "{",
+  "}",
+  ":",
+  "<",
+  ">",
+  "?",
+  "escape",
+  "esc",
+  "enter",
+  "return",
+  "tab",
+  "space",
+  "backspace",
+  "delete",
+  "insert",
+  "clear",
+  "home",
+  "end",
+  "pageup",
+  "pagedown",
+  "up",
+  "down",
+  "left",
+  "right",
+  ...Array.from({ length: 12 }, (_unused, index) => `f${index + 1}`)
+]);
+var mutationQueues = /* @__PURE__ */ new Map();
+function fileContextSettingsPath() {
+  return join(getAgentDir(), FILE_CONTEXT_SETTINGS_FILE);
+}
+async function loadFileContextSettings(settingsPath = fileContextSettingsPath()) {
+  await awaitFileContextSettingsWrites(settingsPath);
+  const snapshot = await readSettingsSnapshot(settingsPath);
+  if (snapshot.kind === "loaded") return { settings: snapshot.settings };
+  if (snapshot.kind === "missing") {
+    return { settings: { ...DEFAULT_FILE_CONTEXT_SETTINGS } };
+  }
+  return {
+    settings: { ...DEFAULT_FILE_CONTEXT_SETTINGS },
+    warning: snapshot.warning,
+    invalidReason: snapshot.reason
+  };
+}
+function updateFileContextSettings(openShortcut, options = {}) {
+  const settingsPath = options.settingsPath ?? fileContextSettingsPath();
+  return enqueueMutation(settingsPath, async () => {
+    options.signal?.throwIfAborted();
+    const snapshot = await readSettingsSnapshot(settingsPath);
+    if (snapshot.kind === "invalid") {
+      throw new Error(`File Context settings are invalid: ${snapshot.reason}`);
+    }
+    const updated = {
+      ...snapshot.kind === "loaded" ? snapshot.document : {},
+      openShortcut
+    };
+    const settings = normalizeFileContextSettings(updated);
+    if (!settings) throw new Error("File Context settings update is invalid");
+    await publishSettings(settingsPath, updated, options);
+    return settings;
+  });
+}
+async function awaitFileContextSettingsWrites(settingsPath = fileContextSettingsPath()) {
+  await mutationQueues.get(settingsPath);
+}
+function normalizeKeyId(value) {
+  if (typeof value !== "string") return void 0;
+  const normalized = value.trim().toLowerCase();
+  const base = [...BASE_KEYS].sort((left, right) => right.length - left.length).find((candidate) => normalized === candidate || normalized.endsWith(`+${candidate}`));
+  if (!base) return void 0;
+  const prefix = normalized.slice(0, normalized.length - base.length);
+  if (!prefix) return base;
+  if (/^f(?:[1-9]|1[0-2])$/.test(base) || !prefix.endsWith("+")) return void 0;
+  const modifiers = prefix.slice(0, -1).split("+");
+  if (modifiers.length === 0 || modifiers.some((modifier) => !MODIFIERS.has(modifier)) || new Set(modifiers).size !== modifiers.length) {
+    return void 0;
+  }
+  return normalized;
+}
+function normalizeFileContextSettings(value) {
+  if (!isSettingsDocument(value)) return void 0;
+  if (!Object.hasOwn(value, "openShortcut")) {
+    return { ...DEFAULT_FILE_CONTEXT_SETTINGS };
+  }
+  const openShortcut = Reflect.get(value, "openShortcut");
+  if (openShortcut === null) return { openShortcut: null };
+  const normalized = normalizeKeyId(openShortcut);
+  return normalized ? { openShortcut: normalized } : void 0;
+}
+function enqueueMutation(settingsPath, mutation) {
+  const previous = mutationQueues.get(settingsPath) ?? Promise.resolve();
+  const result = previous.then(mutation, mutation);
+  const settled = result.then(
+    () => void 0,
+    () => void 0
+  );
+  mutationQueues.set(settingsPath, settled);
+  void settled.finally(() => {
+    if (mutationQueues.get(settingsPath) === settled) mutationQueues.delete(settingsPath);
+  });
+  return result;
+}
+async function readSettingsSnapshot(settingsPath) {
+  let source;
+  try {
+    source = await readSettingsContents(settingsPath);
+  } catch (error) {
+    if (isNodeError(error) && error.code === "ENOENT") return { kind: "missing" };
+    const reason = safeReadError(error);
+    return {
+      kind: "invalid",
+      reason,
+      warning: `Cannot read File Context settings: ${reason}`
+    };
+  }
+  let document;
+  try {
+    document = JSON.parse(source);
+  } catch (error) {
+    return {
+      kind: "invalid",
+      reason: "invalid JSON",
+      warning: `Cannot parse File Context settings: ${formatError(error)}`
+    };
+  }
+  if (!isSettingsDocument(document)) {
+    return {
+      kind: "invalid",
+      reason: "settings must contain a JSON object",
+      warning: "File Context settings must contain a JSON object."
+    };
+  }
+  const settings = normalizeFileContextSettings(document);
+  if (!settings) {
+    return {
+      kind: "invalid",
+      reason: 'setting "openShortcut" must be a valid Pi key string or null',
+      warning: 'File Context setting "openShortcut" must be a valid Pi key string or null.'
+    };
+  }
+  return { kind: "loaded", document, settings };
+}
+async function readSettingsContents(settingsPath) {
+  const flags = constants.O_RDONLY | (constants.O_NONBLOCK ?? 0) | (constants.O_NOFOLLOW ?? 0);
+  const handle = await open(settingsPath, flags);
+  try {
+    const stats = await handle.stat();
+    if (!stats.isFile()) throw new Error("settings path is not a regular file");
+    if (stats.size > MAX_SETTINGS_BYTES) {
+      throw new Error(`settings file exceeds ${MAX_SETTINGS_BYTES} bytes`);
+    }
+    const buffer = Buffer.alloc(MAX_SETTINGS_BYTES + 1);
+    let offset = 0;
+    while (offset < buffer.byteLength) {
+      const { bytesRead } = await handle.read(buffer, offset, buffer.byteLength - offset, offset);
+      if (bytesRead === 0) break;
+      offset += bytesRead;
+    }
+    if (offset > MAX_SETTINGS_BYTES) {
+      throw new Error(`settings file exceeds ${MAX_SETTINGS_BYTES} bytes`);
+    }
+    try {
+      return new TextDecoder("utf-8", { fatal: true }).decode(buffer.subarray(0, offset));
+    } catch {
+      throw new Error("settings file is not valid UTF-8");
+    }
+  } finally {
+    await handle.close();
+  }
+}
+async function publishSettings(settingsPath, document, options) {
+  options.signal?.throwIfAborted();
+  const contents = `${JSON.stringify(document, null, 2)}
+`;
+  if (Buffer.byteLength(contents, "utf8") > MAX_SETTINGS_BYTES) {
+    throw new Error(`settings document exceeds ${MAX_SETTINGS_BYTES} bytes`);
+  }
+  const directory = dirname(settingsPath);
+  await mkdir(directory, { recursive: true });
+  options.signal?.throwIfAborted();
+  const temporaryPath = join(directory, `.${basename(settingsPath)}.${process.pid}.${randomUUID()}.tmp`);
+  try {
+    await writeFile(temporaryPath, contents, {
+      encoding: "utf8",
+      flag: "wx",
+      mode: 384,
+      signal: options.signal
+    });
+    await options.beforeRename?.(temporaryPath, settingsPath);
+    options.signal?.throwIfAborted();
+    await rename(temporaryPath, settingsPath);
+  } finally {
+    await rm(temporaryPath, { force: true }).catch(() => void 0);
+  }
+}
+function isSettingsDocument(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNodeError(error) {
+  return error instanceof Error && "code" in error;
+}
+function safeReadError(error) {
+  if (isNodeError(error) && error.code === "ELOOP") return "settings path is not a regular file";
+  return formatError(error);
+}
+function formatError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+export {
+  fileContextSettingsPath,
+  loadFileContextSettings,
+  updateFileContextSettings,
+  awaitFileContextSettingsWrites,
+  normalizeKeyId
+};
+//# sourceMappingURL=chunk-OPGTWNJI.ts.map

package/dist/chunks/chunk-OPGTWNJI.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/file-context-settings.ts"],
+  "sourcesContent": ["import { randomUUID } from \"node:crypto\";\nimport { constants } from \"node:fs\";\nimport { mkdir, open, rename, rm, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, join } from \"node:path\";\nimport { getAgentDir } from \"@earendil-works/pi-coding-agent\";\nimport type { KeyId } from \"@earendil-works/pi-tui\";\n\nexport const FILE_CONTEXT_SETTINGS_FILE = \"pi-file-context.json\";\nconst MAX_SETTINGS_BYTES = 64 * 1024;\n\nexport interface FileContextSettings {\n  openShortcut: KeyId | null;\n}\n\nexport interface LoadedFileContextSettings {\n  settings: FileContextSettings;\n  warning?: string;\n  invalidReason?: string;\n}\n\nexport interface UpdateFileContextSettingsOptions {\n  settingsPath?: string;\n  signal?: AbortSignal;\n  beforeRename?: (temporaryPath: string, settingsPath: string) => Promise<void>;\n}\n\nexport const DEFAULT_FILE_CONTEXT_SETTINGS: FileContextSettings = {\n  openShortcut: \"ctrl+shift+x\",\n};\n\nconst MODIFIERS = new Set([\"ctrl\", \"shift\", \"alt\", \"super\"]);\nconst BASE_KEYS = new Set([\n  ...\"abcdefghijklmnopqrstuvwxyz0123456789\",\n  \"`\",\n  \"-\",\n  \"=\",\n  \"[\",\n  \"]\",\n  \"\\\\\",\n  \";\",\n  \"'\",\n  \",\",\n  \".\",\n  \"/\",\n  \"!\",\n  \"@\",\n  \"#\",\n  \"$\",\n  \"%\",\n  \"^\",\n  \"&\",\n  \"*\",\n  \"(\",\n  \")\",\n  \"_\",\n  \"+\",\n  \"|\",\n  \"~\",\n  \"{\",\n  \"}\",\n  \":\",\n  \"<\",\n  \">\",\n  \"?\",\n  \"escape\",\n  \"esc\",\n  \"enter\",\n  \"return\",\n  \"tab\",\n  \"space\",\n  \"backspace\",\n  \"delete\",\n  \"insert\",\n  \"clear\",\n  \"home\",\n  \"end\",\n  \"pageup\",\n  \"pagedown\",\n  \"up\",\n  \"down\",\n  \"left\",\n  \"right\",\n  ...Array.from({ length: 12 }, (_unused, index) => `f${index + 1}`),\n]);\n\ntype SettingsDocument = Record<string, unknown>;\ntype SettingsSnapshot =\n  | { kind: \"missing\" }\n  | { kind: \"invalid\"; reason: string; warning: string }\n  | { kind: \"loaded\"; document: SettingsDocument; settings: FileContextSettings };\n\nconst mutationQueues = new Map<string, Promise<void>>();\n\nexport function fileContextSettingsPath(): string {\n  return join(getAgentDir(), FILE_CONTEXT_SETTINGS_FILE);\n}\n\nexport async function loadFileContextSettings(\n  settingsPath = fileContextSettingsPath(),\n): Promise<LoadedFileContextSettings> {\n  await awaitFileContextSettingsWrites(settingsPath);\n  const snapshot = await readSettingsSnapshot(settingsPath);\n  if (snapshot.kind === \"loaded\") return { settings: snapshot.settings };\n  if (snapshot.kind === \"missing\") {\n    return { settings: { ...DEFAULT_FILE_CONTEXT_SETTINGS } };\n  }\n  return {\n    settings: { ...DEFAULT_FILE_CONTEXT_SETTINGS },\n    warning: snapshot.warning,\n    invalidReason: snapshot.reason,\n  };\n}\n\nexport function updateFileContextSettings(\n  openShortcut: KeyId | null,\n  options: UpdateFileContextSettingsOptions = {},\n): Promise<FileContextSettings> {\n  const settingsPath = options.settingsPath ?? fileContextSettingsPath();\n  return enqueueMutation(settingsPath, async () => {\n    options.signal?.throwIfAborted();\n    const snapshot = await readSettingsSnapshot(settingsPath);\n    if (snapshot.kind === \"invalid\") {\n      throw new Error(`File Context settings are invalid: ${snapshot.reason}`);\n    }\n    const updated: SettingsDocument = {\n      ...(snapshot.kind === \"loaded\" ? snapshot.document : {}),\n      openShortcut,\n    };\n    const settings = normalizeFileContextSettings(updated);\n    if (!settings) throw new Error(\"File Context settings update is invalid\");\n    await publishSettings(settingsPath, updated, options);\n    return settings;\n  });\n}\n\nexport async function awaitFileContextSettingsWrites(settingsPath = fileContextSettingsPath()): Promise<void> {\n  await mutationQueues.get(settingsPath);\n}\n\nexport function normalizeKeyId(value: unknown): KeyId | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const normalized = value.trim().toLowerCase();\n  const base = [...BASE_KEYS]\n    .sort((left, right) => right.length - left.length)\n    .find((candidate) => normalized === candidate || normalized.endsWith(`+${candidate}`));\n  if (!base) return undefined;\n  const prefix = normalized.slice(0, normalized.length - base.length);\n  if (!prefix) return base as KeyId;\n  if (/^f(?:[1-9]|1[0-2])$/.test(base) || !prefix.endsWith(\"+\")) return undefined;\n  const modifiers = prefix.slice(0, -1).split(\"+\");\n  if (\n    modifiers.length === 0 ||\n    modifiers.some((modifier) => !MODIFIERS.has(modifier)) ||\n    new Set(modifiers).size !== modifiers.length\n  ) {\n    return undefined;\n  }\n  return normalized as KeyId;\n}\n\nfunction normalizeFileContextSettings(value: unknown): FileContextSettings | undefined {\n  if (!isSettingsDocument(value)) return undefined;\n  if (!Object.hasOwn(value, \"openShortcut\")) {\n    return { ...DEFAULT_FILE_CONTEXT_SETTINGS };\n  }\n  const openShortcut = Reflect.get(value, \"openShortcut\");\n  if (openShortcut === null) return { openShortcut: null };\n  const normalized = normalizeKeyId(openShortcut);\n  return normalized ? { openShortcut: normalized } : undefined;\n}\n\nfunction enqueueMutation<T>(settingsPath: string, mutation: () => Promise<T>): Promise<T> {\n  const previous = mutationQueues.get(settingsPath) ?? Promise.resolve();\n  const result = previous.then(mutation, mutation);\n  const settled = result.then(\n    () => undefined,\n    () => undefined,\n  );\n  mutationQueues.set(settingsPath, settled);\n  void settled.finally(() => {\n    if (mutationQueues.get(settingsPath) === settled) mutationQueues.delete(settingsPath);\n  });\n  return result;\n}\n\nasync function readSettingsSnapshot(settingsPath: string): Promise<SettingsSnapshot> {\n  let source: string;\n  try {\n    source = await readSettingsContents(settingsPath);\n  } catch (error: unknown) {\n    if (isNodeError(error) && error.code === \"ENOENT\") return { kind: \"missing\" };\n    const reason = safeReadError(error);\n    return {\n      kind: \"invalid\",\n      reason,\n      warning: `Cannot read File Context settings: ${reason}`,\n    };\n  }\n\n  let document: unknown;\n  try {\n    document = JSON.parse(source) as unknown;\n  } catch (error: unknown) {\n    return {\n      kind: \"invalid\",\n      reason: \"invalid JSON\",\n      warning: `Cannot parse File Context settings: ${formatError(error)}`,\n    };\n  }\n  if (!isSettingsDocument(document)) {\n    return {\n      kind: \"invalid\",\n      reason: \"settings must contain a JSON object\",\n      warning: \"File Context settings must contain a JSON object.\",\n    };\n  }\n  const settings = normalizeFileContextSettings(document);\n  if (!settings) {\n    return {\n      kind: \"invalid\",\n      reason: 'setting \"openShortcut\" must be a valid Pi key string or null',\n      warning: 'File Context setting \"openShortcut\" must be a valid Pi key string or null.',\n    };\n  }\n  return { kind: \"loaded\", document, settings };\n}\n\nasync function readSettingsContents(settingsPath: string): Promise<string> {\n  const flags = constants.O_RDONLY | (constants.O_NONBLOCK ?? 0) | (constants.O_NOFOLLOW ?? 0);\n  const handle = await open(settingsPath, flags);\n  try {\n    const stats = await handle.stat();\n    if (!stats.isFile()) throw new Error(\"settings path is not a regular file\");\n    if (stats.size > MAX_SETTINGS_BYTES) {\n      throw new Error(`settings file exceeds ${MAX_SETTINGS_BYTES} bytes`);\n    }\n    const buffer = Buffer.alloc(MAX_SETTINGS_BYTES + 1);\n    let offset = 0;\n    while (offset < buffer.byteLength) {\n      const { bytesRead } = await handle.read(buffer, offset, buffer.byteLength - offset, offset);\n      if (bytesRead === 0) break;\n      offset += bytesRead;\n    }\n    if (offset > MAX_SETTINGS_BYTES) {\n      throw new Error(`settings file exceeds ${MAX_SETTINGS_BYTES} bytes`);\n    }\n    try {\n      return new TextDecoder(\"utf-8\", { fatal: true }).decode(buffer.subarray(0, offset));\n    } catch {\n      throw new Error(\"settings file is not valid UTF-8\");\n    }\n  } finally {\n    await handle.close();\n  }\n}\n\nasync function publishSettings(\n  settingsPath: string,\n  document: SettingsDocument,\n  options: UpdateFileContextSettingsOptions,\n): Promise<void> {\n  options.signal?.throwIfAborted();\n  const contents = `${JSON.stringify(document, null, 2)}\\n`;\n  if (Buffer.byteLength(contents, \"utf8\") > MAX_SETTINGS_BYTES) {\n    throw new Error(`settings document exceeds ${MAX_SETTINGS_BYTES} bytes`);\n  }\n  const directory = dirname(settingsPath);\n  await mkdir(directory, { recursive: true });\n  options.signal?.throwIfAborted();\n  const temporaryPath = join(directory, `.${basename(settingsPath)}.${process.pid}.${randomUUID()}.tmp`);\n  try {\n    await writeFile(temporaryPath, contents, {\n      encoding: \"utf8\",\n      flag: \"wx\",\n      mode: 0o600,\n      signal: options.signal,\n    });\n    await options.beforeRename?.(temporaryPath, settingsPath);\n    options.signal?.throwIfAborted();\n    await rename(temporaryPath, settingsPath);\n  } finally {\n    await rm(temporaryPath, { force: true }).catch(() => undefined);\n  }\n}\n\nfunction isSettingsDocument(value: unknown): value is SettingsDocument {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isNodeError(error: unknown): error is NodeJS.ErrnoException {\n  return error instanceof Error && \"code\" in error;\n}\n\nfunction safeReadError(error: unknown): string {\n  if (isNodeError(error) && error.code === \"ELOOP\") return \"settings path is not a regular file\";\n  return formatError(error);\n}\n\nfunction formatError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/chunks/chunk-WOTDNRTG.ts

@@ -0,0 +1,242 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
+
+// src/file-context.ts
+import { createHash } from "node:crypto";
+import { constants } from "node:fs";
+import { lstat, open, readdir, realpath } from "node:fs/promises";
+import { isAbsolute, relative, resolve, sep } from "node:path";
+var DEFAULT_MAX_FILES = 5e3;
+var DEFAULT_MAX_BYTES = 1e6;
+var MAX_QUOTE_BYTES = 5e4;
+var MAX_QUOTE_LINES = 500;
+var MAX_PENDING_QUOTES = 8;
+var MAX_PENDING_QUOTE_BYTES = 1e5;
+var IGNORED_DIRECTORIES = /* @__PURE__ */ new Set([
+  ".git",
+  ".hg",
+  ".svn",
+  ".next",
+  "build",
+  "coverage",
+  "dist",
+  "node_modules",
+  "target"
+]);
+async function discoverProjectFiles(root, options = {}) {
+  const maxFiles = Math.max(1, options.maxFiles ?? DEFAULT_MAX_FILES);
+  const files = [];
+  options.signal?.throwIfAborted();
+  const canonicalRoot = await realpath(root);
+  const directories = [{ directory: canonicalRoot, prefix: "" }];
+  options.signal?.throwIfAborted();
+  for (let index = 0; index < directories.length && files.length < maxFiles; index += 1) {
+    options.signal?.throwIfAborted();
+    const current = directories[index];
+    if (!current) break;
+    const { directory, prefix } = current;
+    const entries = (await readdir(directory, { withFileTypes: true })).sort(
+      (left, right) => compareStrings(left.name, right.name)
+    );
+    options.signal?.throwIfAborted();
+    for (const entry of entries) {
+      options.signal?.throwIfAborted();
+      if (IGNORED_DIRECTORIES.has(entry.name) || entry.isSymbolicLink()) continue;
+      const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
+      const absolutePath = resolve(directory, entry.name);
+      if (entry.isDirectory()) {
+        directories.push({ directory: absolutePath, prefix: relativePath });
+      } else if (entry.isFile()) {
+        files.push(relativePath);
+        if (files.length >= maxFiles) break;
+      }
+    }
+  }
+  options.signal?.throwIfAborted();
+  return files.sort(compareStrings);
+}
+async function loadProjectTextFile(root, projectPath, options = {}) {
+  options.signal?.throwIfAborted();
+  if (!projectPath || isAbsolute(projectPath)) throw new Error("File path is outside the project");
+  const canonicalRoot = await realpath(root);
+  options.signal?.throwIfAborted();
+  const candidate = resolve(canonicalRoot, projectPath);
+  if (!isInside(canonicalRoot, candidate)) throw new Error("File path is outside the project");
+  let canonicalFile;
+  try {
+    canonicalFile = await realpath(candidate);
+  } catch (error) {
+    throw new Error(`Cannot open ${projectPath}: ${formatError(error)}`);
+  }
+  options.signal?.throwIfAborted();
+  if (!isInside(canonicalRoot, canonicalFile)) throw new Error("File path is outside the project");
+  const info = await lstat(canonicalFile);
+  options.signal?.throwIfAborted();
+  if (!info.isFile()) throw new Error(`${projectPath} is not a regular file`);
+  const maxBytes = Math.max(1, options.maxBytes ?? DEFAULT_MAX_BYTES);
+  if (info.size > maxBytes) throw new Error(`${projectPath} exceeds ${maxBytes} bytes`);
+  await options.beforeOpen?.();
+  options.signal?.throwIfAborted();
+  let file;
+  try {
+    file = await open(canonicalFile, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0));
+  } catch (error) {
+    throw new Error(`Cannot safely open ${projectPath}: ${formatError(error)}`);
+  }
+  try {
+    options.signal?.throwIfAborted();
+    const openedInfo = await file.stat();
+    options.signal?.throwIfAborted();
+    if (!openedInfo.isFile()) throw new Error(`${projectPath} is not a regular file`);
+    if (openedInfo.dev !== info.dev || openedInfo.ino !== info.ino) {
+      throw new Error(`${projectPath} changed while it was being opened safely`);
+    }
+    if (openedInfo.size > maxBytes) throw new Error(`${projectPath} exceeds ${maxBytes} bytes`);
+    const buffer = Buffer.alloc(maxBytes + 1);
+    let offset = 0;
+    while (offset < buffer.length) {
+      options.signal?.throwIfAborted();
+      const { bytesRead } = await file.read(buffer, offset, buffer.length - offset, offset);
+      options.signal?.throwIfAborted();
+      if (bytesRead === 0) break;
+      offset += bytesRead;
+    }
+    if (offset > maxBytes) throw new Error(`${projectPath} exceeds ${maxBytes} bytes`);
+    const contents = buffer.subarray(0, offset);
+    if (contents.includes(0)) throw new Error(`${projectPath} appears to be binary`);
+    return {
+      path: projectPath.replaceAll("\\", "/"),
+      lines: normalizeTextLines(contents.toString("utf8"))
+    };
+  } finally {
+    await file.close();
+  }
+}
+function createFileQuote(path, lines, anchorIndex, cursorIndex, git) {
+  if (lines.length === 0) throw new Error("Cannot quote an empty file");
+  const startIndex = Math.max(0, Math.min(anchorIndex, cursorIndex, lines.length - 1));
+  const endIndex = Math.max(0, Math.min(Math.max(anchorIndex, cursorIndex), lines.length - 1));
+  const text = lines.slice(startIndex, endIndex + 1).join("\n");
+  return createFileQuoteSnapshot(path, startIndex + 1, endIndex + 1, text, git);
+}
+function createFileQuoteSnapshot(path, startLine, endLine, text, git) {
+  if (!Number.isSafeInteger(startLine) || !Number.isSafeInteger(endLine) || startLine < 1) {
+    throw new Error("Quote lines must be positive integers");
+  }
+  if (endLine < startLine) throw new Error("Quote end line precedes its start line");
+  if (text.split("\n").length > MAX_QUOTE_LINES) {
+    throw new Error(`Quote exceeds ${MAX_QUOTE_LINES} lines`);
+  }
+  if (Buffer.byteLength(text, "utf8") > MAX_QUOTE_BYTES) {
+    throw new Error(`Quote exceeds ${MAX_QUOTE_BYTES} bytes`);
+  }
+  return {
+    path,
+    startLine,
+    endLine,
+    text,
+    ...git ? {
+      git: {
+        head: git.head,
+        ...git.branch !== void 0 ? { branch: git.branch } : {},
+        ...git.status !== void 0 ? { status: git.status } : {},
+        ...git.revision !== void 0 ? { revision: git.revision } : {},
+        ...git.blob !== void 0 ? { blob: git.blob } : {},
+        contentSha256: createHash("sha256").update(text, "utf8").digest("hex"),
+        ...git.source !== void 0 ? { source: git.source } : {},
+        ...git.base !== void 0 ? { base: git.base } : {}
+      }
+    } : {}
+  };
+}
+function createPreviewQuote(file, anchor, cursor, project, git, revision) {
+  return createFileQuote(
+    file.path,
+    file.lines,
+    anchor,
+    cursor,
+    project ? {
+      head: project.head,
+      branch: project.branch,
+      status: revision ? "historical" : git?.status?.label ?? "clean",
+      revision: revision?.revision,
+      blob: revision?.blob ?? git?.blob,
+      source: revision ? "revision" : "worktree",
+      base: revision ? void 0 : "HEAD"
+    } : void 0
+  );
+}
+function appendPendingQuote(current, quote) {
+  if (current.length >= MAX_PENDING_QUOTES) {
+    throw new Error(`File Context supports at most ${MAX_PENDING_QUOTES} pending quotes`);
+  }
+  const totalBytes = [...current, quote].reduce((total, item) => total + Buffer.byteLength(item.text, "utf8"), 0);
+  if (totalBytes > MAX_PENDING_QUOTE_BYTES) {
+    throw new Error(`Pending quotes exceed ${MAX_PENDING_QUOTE_BYTES} bytes`);
+  }
+  return [...current, quote];
+}
+function formatQuoteContext(quotes) {
+  const blocks = quotes.map((quote) => {
+    const path = escapeXml(quote.path);
+    const text = escapeXml(quote.text);
+    const attributes = [
+      `path="${path}"`,
+      `lines="${quote.startLine}-${quote.endLine}"`,
+      ...formatGitAttributes(quote.git)
+    ].join(" ");
+    return `<user_file_quote ${attributes}>
+${text}
+</user_file_quote>`;
+  });
+  const description = quotes.length === 1 ? "The user intentionally selected the file excerpt above." : "The user intentionally selected the file excerpts above.";
+  return `${blocks.join("\n\n")}
+
+${description}`;
+}
+function normalizeTextLines(contents) {
+  if (contents === "") return [];
+  const lines = contents.replaceAll("\r\n", "\n").replaceAll("\r", "\n").split("\n");
+  if (lines.at(-1) === "") lines.pop();
+  return lines;
+}
+function compareStrings(left, right) {
+  return left < right ? -1 : left > right ? 1 : 0;
+}
+function isInside(root, candidate) {
+  const result = relative(root, candidate);
+  return result === "" || !result.startsWith(`..${sep}`) && result !== ".." && !isAbsolute(result);
+}
+function formatGitAttributes(git) {
+  if (!git) return [];
+  return [
+    ["git_head", git.head],
+    ["git_branch", git.branch],
+    ["git_status", git.status],
+    ["git_revision", git.revision],
+    ["git_blob", git.blob],
+    ["content_sha256", git.contentSha256],
+    ["source", git.source],
+    ["git_base", git.base]
+  ].flatMap(([name, value]) => value ? [`${name}="${escapeXml(value)}"`] : []);
+}
+function escapeXml(value) {
+  return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&apos;");
+}
+function formatError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+export {
+  MAX_QUOTE_BYTES,
+  MAX_QUOTE_LINES,
+  MAX_PENDING_QUOTES,
+  MAX_PENDING_QUOTE_BYTES,
+  discoverProjectFiles,
+  loadProjectTextFile,
+  createFileQuoteSnapshot,
+  createPreviewQuote,
+  appendPendingQuote,
+  formatQuoteContext
+};
+//# sourceMappingURL=chunk-WOTDNRTG.ts.map