@llblab/pi-actors 0.41.1 → 0.42.0

package/dist/lib/observability.js

@@ -311,6 +311,9 @@ function observeRun(stateDir) {
                 !Array.isArray(status.model_policy)
                 ? { modelPolicy: status.model_policy }
                 : {}),
+            ...(status.notification_policy === "silent"
+                ? { notificationPolicy: "silent" }
+                : {}),
             ...(typeof status.recipe_file === "string"
                 ? { recipeFile: status.recipe_file }
                 : {}),
@@ -615,7 +618,9 @@ export function detectRunTransitions(previous, summary) {
     for (const run of summary.runs) {
         const key = runObservationKey(run);
         const old = previous.get(key);
-        if (!run.terminalHandled && TERMINAL.has(run.status)) {
+        if (run.notificationPolicy !== "silent" &&
+            !run.terminalHandled &&
+            TERMINAL.has(run.status)) {
             transitions.push({
                 from: old ?? "running",
                 run: run.run,
@@ -707,6 +712,11 @@ export function detectRunOutboxEvents(previousLineCounts, summary, seenEventIds
         const key = run.stateDir ?? run.run;
         const records = readOutboxRecords(run);
         const previousCount = previousLineCounts.get(key) ?? 0;
+        if (run.notificationPolicy === "silent") {
+            previousLineCounts.set(key, records.length);
+            seenEventIds.set(key, seenEventIds.get(key) ?? new Set());
+            continue;
+        }
         const start = Math.min(previousCount, records.length);
         const seen = seenEventIds.get(key) ?? new Set();
         for (let index = start; index < records.length; index += 1) {

package/dist/lib/paths.d.ts

@@ -4,6 +4,7 @@
  * Owns agent directory, tools config, recipe root, and actor run state root resolution
  */
 export declare function getAgentDir(env?: Record<string, string | undefined>): string;
+export declare function isAutomaticRecipeReviewEnabled(env?: Record<string, string | undefined>): boolean;
 export interface ExtensionRuntimePaths {
     configPath: string;
     runStateRoot: string;
@@ -12,6 +13,12 @@ export interface ExtensionRuntimePaths {
 export declare function getConfigPath(agentDir?: string): string;
 export declare function getExtensionTmpDir(agentDir?: string, extensionName?: string): string;
 export declare function getRunStateRoot(agentDir?: string): string;
+export declare function getDraftSleepRoot(agentDir?: string): string;
+export declare function getDraftSleepStatePath(agentDir?: string): string;
+export declare function getDraftSleepBatchDir(batchId: string, agentDir?: string): string;
+export declare function getToolReviewRoot(agentDir?: string): string;
+export declare function getToolReviewStatePath(agentDir?: string): string;
+export declare function getToolReviewBatchDir(reviewId: string, agentDir?: string): string;
 export declare function getExtensionRuntimePaths(agentDir?: string): ExtensionRuntimePaths;
 export declare const EXTENSION_RUNTIME_PATHS: ExtensionRuntimePaths;
 export declare function getExtensionSkillsDir(extensionUrl: string): string;

package/dist/lib/paths.js

@@ -12,6 +12,10 @@ export function getAgentDir(env = process.env) {
         ? resolve(env.PI_CODING_AGENT_DIR)
         : join(homedir(), ".pi", "agent");
 }
+export function isAutomaticRecipeReviewEnabled(env = process.env) {
+    const value = env.PI_ACTORS_AUTOMATIC_REVIEW?.trim().toLowerCase();
+    return value === undefined || !["0", "false", "off"].includes(value);
+}
 export function getConfigPath(agentDir = getAgentDir()) {
     return join(agentDir, "tool-registry.json");
 }
@@ -21,6 +25,30 @@ export function getExtensionTmpDir(agentDir = getAgentDir(), extensionName = "pi
 export function getRunStateRoot(agentDir = getAgentDir()) {
     return join(getExtensionTmpDir(agentDir), "runs");
 }
+export function getDraftSleepRoot(agentDir = getAgentDir()) {
+    return join(getExtensionTmpDir(agentDir), "draft-sleep");
+}
+export function getDraftSleepStatePath(agentDir = getAgentDir()) {
+    return join(getDraftSleepRoot(agentDir), "state.json");
+}
+export function getDraftSleepBatchDir(batchId, agentDir = getAgentDir()) {
+    if (!/^[a-f0-9-]{36}$/u.test(batchId)) {
+        throw new Error("Invalid draft sleep batch id.");
+    }
+    return join(getDraftSleepRoot(agentDir), "batches", batchId);
+}
+export function getToolReviewRoot(agentDir = getAgentDir()) {
+    return join(getExtensionTmpDir(agentDir), "tool-review");
+}
+export function getToolReviewStatePath(agentDir = getAgentDir()) {
+    return join(getToolReviewRoot(agentDir), "state.json");
+}
+export function getToolReviewBatchDir(reviewId, agentDir = getAgentDir()) {
+    if (!/^[a-f0-9-]{36}$/u.test(reviewId)) {
+        throw new Error("Invalid tool review id.");
+    }
+    return join(getToolReviewRoot(agentDir), "batches", reviewId);
+}
 export function getExtensionRuntimePaths(agentDir = getAgentDir()) {
     return {
         configPath: getConfigPath(agentDir),

package/dist/lib/recipes-discovery.js

@@ -528,30 +528,38 @@ function templatePreview(value) {
 }
 export function listDraftRecipes(root) {
     return listRecipeFiles(root).map((path) => {
-        const id = RecipesReferences.getRecipeIdFromPath(path);
-        const bytes = readFileSync(path);
-        const stat = statSync(path);
-        const config = RecipesReferences.readRawRecipeConfig(path);
-        const resolved = RecipesReferences.readResolvedRecipeConfig(path);
-        const diagnostics = getRecipeConfigDiagnostics(path, resolved);
-        const sourceRun = String(config?.description ?? "").match(/spawn run ([^\s]+)/)?.[1];
-        const preview = templatePreview(config?.template);
-        const riskLabels = getRecipeRiskLabels(resolved);
-        return {
-            id,
-            path,
-            sha256: createHash("sha256").update(bytes).digest("hex"),
-            size: bytes.byteLength,
-            created_at: stat.birthtime.toISOString(),
-            modified_at: stat.mtime.toISOString(),
-            valid: Boolean(resolved),
-            diagnostics,
-            ...(riskLabels.length ? { risk_labels: riskLabels } : {}),
-            ...(config?.description ? { description: config.description } : {}),
-            ...(sourceRun ? { source_run: sourceRun } : {}),
-            ...(config?.async !== undefined ? { async: config.async } : {}),
-            ...(preview ? { template_preview: preview } : {}),
-        };
+        for (let attempt = 0; attempt < 3; attempt += 1) {
+            const id = RecipesReferences.getRecipeIdFromPath(path);
+            const bytes = readFileSync(path);
+            const fingerprint = createHash("sha256").update(bytes).digest("hex");
+            const stat = statSync(path);
+            const config = RecipesReferences.readRawRecipeConfig(path);
+            const resolved = RecipesReferences.readResolvedRecipeConfig(path);
+            const diagnostics = getRecipeConfigDiagnostics(path, resolved);
+            const after = readFileSync(path);
+            if (createHash("sha256").update(after).digest("hex") !== fingerprint) {
+                continue;
+            }
+            const sourceRun = String(config?.description ?? "").match(/spawn run ([^\s]+)/)?.[1];
+            const preview = templatePreview(config?.template);
+            const riskLabels = getRecipeRiskLabels(resolved);
+            return {
+                id,
+                path,
+                sha256: fingerprint,
+                size: bytes.byteLength,
+                created_at: stat.birthtime.toISOString(),
+                modified_at: stat.mtime.toISOString(),
+                valid: Boolean(resolved),
+                diagnostics,
+                ...(riskLabels.length ? { risk_labels: riskLabels } : {}),
+                ...(config?.description ? { description: config.description } : {}),
+                ...(sourceRun ? { source_run: sourceRun } : {}),
+                ...(config?.async !== undefined ? { async: config.async } : {}),
+                ...(preview ? { template_preview: preview } : {}),
+            };
+        }
+        throw new Error(`Draft changed repeatedly during inventory: ${path}`);
     });
 }
 export function summarizeDiscovery(result) {

package/dist/lib/recipes-usage.d.ts

@@ -1,9 +1,21 @@
 /**
- * Recipe usage metadata helpers
- * Zones: recipe telemetry, muscle-memory cleanup evidence
- * Owns lightweight launch counters for user-owned recipe files
+ * Recipe usage and name-based lineage metadata.
+ * Zones: recipe lineage, launch telemetry, revision history, migration
+ * Owns priority-compatible recipe names and lifetime/revision counters for user recipes.
  */
 export type RecipeLaunchKind = "direct" | "spawn" | "tool";
-export declare function getRecipeUsagePath(path: string): string;
-export declare function readRecipeUsage(path: string): Record<string, unknown> | undefined;
-export declare function recordRecipeLaunch(path: string, now?: Date, kind?: RecipeLaunchKind): boolean;
+export declare function getRecipeUsageIndexPath(recipeRoot: string): string;
+export declare function getRecipeUsageLedgerPath(lineageName: string, recipeRoot: string): string;
+export declare const RECIPE_REVISION_SNAPSHOT_LIMIT = 32;
+export declare function getRecipeRevisionSnapshotPath(lineageName: string, revision: number, recipeRoot: string): string;
+export declare function readRecipeUsage(path: string, recipeRoot?: string): Record<string, unknown> | undefined;
+export declare function ensureRecipeLineage(path: string, now?: Date, recipeRoot?: string): boolean;
+export declare function isCurrentRecipeRevisionReviewed(path: string, recipeRoot?: string): boolean;
+export interface RecipeLaunchRecordOptions {
+    onMutationLockContention?(): void;
+}
+export declare function recordRecipeLaunch(path: string, now?: Date, kind?: RecipeLaunchKind, recipeRoot?: string, options?: RecipeLaunchRecordOptions): boolean;
+export declare function recordRecipeReview(path: string, reviewEpoch: string, now?: Date, recipeRoot?: string): boolean;
+export declare function recordRecipeRollback(path: string, rollbackRevision: number, now?: Date, recipeRoot?: string): boolean;
+export declare function retireRecipeUsage(path: string, recipeRoot?: string): boolean;
+export declare function moveRecipeUsage(fromPath: string, toPath: string, recipeRoot?: string): boolean;