pi-fabric 0.78.0 → 0.79.1

package/README.md

@@ -133,6 +133,7 @@ See the [interface & commands reference](docs/interface.md) for every view, keyb
 - [External providers](docs/providers.md): the versioned provider protocol for extensions.
 - [Architecture & security](docs/architecture.md): the host bridge, sandboxing, tool-call robustness, and limits.
 - [Catalog repairs](docs/repairs.md): unique extra keys and unknown actions promoted into silent schema maps.
+- [Tool entropy](docs/entropy.md): the deterministic entropy meter, on-demand session measurement, reduction proposals, the autonomous compile loop with its ratchet gate, and `certify:entropy`.
 - [Speculative PTC](docs/speculation.md): pre-launching literal read calls while the program streams, with epoch + freshness guarantees.
 - [Skills](docs/skills.md): the core-first invocation policy and user-invoked advanced patterns.
 

package/dist/chunks/{chunk-DYEOFQ64.js → chunk-5OVYFN4A.js}

@@ -15,7 +15,7 @@ import {
   enumerateAllSessions,
   resolveScope,
   resolveSessionTarget
-} from "./chunk-E3V22XGU.js";
+} from "./chunk-6GRNSFDJ.js";
 import {
   expandSessionEntriesChecked,
   normalizeSession
@@ -865,4 +865,4 @@ export {
   normalizeMemoryArgs,
   MemoryProvider
 };
-//# sourceMappingURL=chunk-DYEOFQ64.js.map
+//# sourceMappingURL=chunk-5OVYFN4A.js.map

package/dist/chunks/{chunk-E3V22XGU.js → chunk-6GRNSFDJ.js}

@@ -102,9 +102,10 @@ var resolveScope = (input) => {
 
 export {
   encodeCwdDir,
+  sessionDirForCwd,
   enumerateAllSessions,
   AmbiguousSessionError,
   resolveSessionTarget,
   resolveScope
 };
-//# sourceMappingURL=chunk-E3V22XGU.js.map
+//# sourceMappingURL=chunk-6GRNSFDJ.js.map

package/dist/chunks/chunk-6GRNSFDJ.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/memory/discovery.ts"],
+  "sourcesContent": ["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { readSessionHeader } from \"./normalize.js\";\n\nexport interface SessionRef {\n  id: string;\n  file: string;\n  cwd: string;\n  mtime: number;\n}\n\nexport interface ResolveScopeInput {\n  agentDir: string;\n  cwd: string;\n  scope: string;\n  sessionId?: string;\n  sessionFile?: string;\n  maxSessions: number;\n}\n\nconst SESSIONS_SUBDIR = \"sessions\";\n\nconst isJsonlFile = (name: string): boolean => name.endsWith(\".jsonl\");\n\n/** Encode a cwd into the safe directory name pi stores session files under. */\nexport const encodeCwdDir = (cwd: string): string =>\n  `--${path.resolve(cwd).replace(/^[/\\\\]/, \"\").replace(/[/\\\\:]/g, \"-\")}--`;\n\n/** Directory pi stores this project's session JSONL files under. */\nexport const sessionDirForCwd = (cwd: string, agentDir: string): string =>\n  path.join(agentDir, SESSIONS_SUBDIR, encodeCwdDir(cwd));\n\nconst listJsonlInDir = (dir: string): string[] => {\n  try {\n    return fs\n      .readdirSync(dir, { withFileTypes: true })\n      .filter((entry) => entry.isFile() && isJsonlFile(entry.name))\n      .map((entry) => path.join(dir, entry.name));\n  } catch {\n    return [];\n  }\n};\n\nconst statMtime = (file: string): number => {\n  try {\n    return fs.statSync(file).mtimeMs;\n  } catch {\n    return 0;\n  }\n};\n\nconst refFromFile = (file: string): SessionRef => {\n  const header = readSessionHeader(file);\n  return {\n    id: header?.sessionId ?? path.basename(file, \".jsonl\"),\n    file,\n    cwd: header?.cwd ?? \"\",\n    mtime: statMtime(file),\n  };\n};\n\nconst sessionsDirRoot = (agentDir: string): string => path.join(agentDir, SESSIONS_SUBDIR);\n\nconst compareRefsByRecency = (left: SessionRef, right: SessionRef): number => {\n  if (right.mtime !== left.mtime) return right.mtime - left.mtime;\n  return left.file < right.file ? -1 : left.file > right.file ? 1 : 0;\n};\n\n/**\n * Enumerate every session JSONL file under the agent dir, newest first by\n * file mtime. Bounded by `maxSessions`. Returns refs with resolved cwd and\n * sessionId from each file header (falling back to the file stem).\n */\nexport const enumerateAllSessions = (agentDir: string, maxSessions: number): SessionRef[] => {\n  const root = sessionsDirRoot(agentDir);\n  let projectDirs: string[] = [];\n  try {\n    projectDirs = fs\n      .readdirSync(root, { withFileTypes: true })\n      .filter((entry) => entry.isDirectory())\n      .map((entry) => path.join(root, entry.name));\n  } catch {\n    return [];\n  }\n  const files: string[] = [];\n  for (const dir of projectDirs) {\n    for (const file of listJsonlInDir(dir)) files.push(file);\n  }\n  return files\n    .map(refFromFile)\n    .sort(compareRefsByRecency)\n    .slice(0, Math.max(1, maxSessions));\n};\n\nconst newestSessionInDir = (dir: string): SessionRef | null => {\n  const files = listJsonlInDir(dir);\n  if (files.length === 0) return null;\n  return files\n    .map(refFromFile)\n    .sort(compareRefsByRecency)[0]!;\n};\n\nexport class AmbiguousSessionError extends Error {\n  readonly code = \"ambiguous_session\";\n\n  constructor(\n    readonly session: string,\n    readonly candidates: string[],\n  ) {\n    super(`Session id ${JSON.stringify(session)} is ambiguous; use an exact session file path.`);\n    this.name = \"AmbiguousSessionError\";\n  }\n}\n\nexport const resolveSessionTarget = (\n  agentDir: string,\n  target: string,\n): SessionRef | null => {\n  if (target.endsWith(\".jsonl\") && fs.existsSync(target)) {\n    return refFromFile(path.resolve(target));\n  }\n  const all = enumerateAllSessions(agentDir, Number.MAX_SAFE_INTEGER);\n  const byId = all.filter((ref) => ref.id === target);\n  if (byId.length > 1) throw new AmbiguousSessionError(target, byId.map((ref) => ref.file));\n  if (byId.length === 1) return byId[0]!;\n  const byStem = all.filter((ref) => path.basename(ref.file, \".jsonl\") === target);\n  if (byStem.length > 1) throw new AmbiguousSessionError(target, byStem.map((ref) => ref.file));\n  return byStem[0] ?? null;\n};\n\n/**\n * Resolve a scope string into the concrete set of session files to search.\n *\n * - `session` (default): the current session file (from invocation context\n *   if available, else the newest session for the current cwd).\n * - `project`: all sessions stored under the current cwd's default session dir.\n * - `global`: all sessions under the agent dir, bounded by `maxSessions`.\n * - `session:<id-or-path>`: one specific session by id or file path.\n */\nexport const resolveScope = (input: ResolveScopeInput): SessionRef[] => {\n  const scope = input.scope?.trim();\n  if (scope.startsWith(\"session:\")) {\n    const target = scope.slice(\"session:\".length).trim();\n    const ref = resolveSessionTarget(input.agentDir, target);\n    return ref ? [ref] : [];\n  }\n  if (scope === \"global\") {\n    return enumerateAllSessions(input.agentDir, input.maxSessions);\n  }\n  if (scope === \"project\") {\n    const dir = sessionDirForCwd(input.cwd, input.agentDir);\n    return listJsonlInDir(dir)\n      .map(refFromFile)\n      .sort(compareRefsByRecency)\n      .slice(0, Math.max(1, input.maxSessions));\n  }\n  // default: session\n  if (input.sessionFile) {\n    const ref = refFromFile(input.sessionFile);\n    return [ref];\n  }\n  const dir = sessionDirForCwd(input.cwd, input.agentDir);\n  const newest = newestSessionInDir(dir);\n  return newest ? [newest] : [];\n};\n"],
+  "mappings": "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",
+  "names": ["dir"]
+}