@voybio/ace-swarm 2.4.4 → 2.4.6

package/dist/public-surface.js

@@ -1,7 +1,7 @@
-import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, writeFileSync } from "node:fs";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { dirname, extname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { PACKAGE_ROOT, resolveWorkspaceRoot } from "./helpers.js";
+import { PACKAGE_ROOT, resolveWorkspaceRoot, safeWrite } from "./helpers.js";
 import { EVENT_TYPE } from "./shared.js";
 export const PUBLIC_SURFACE_REPORT_REL_PATH = "agent-state/PUBLIC_SURFACE_REPORT.md";
 const SCHEMA_REQUIREMENTS = {
@@ -116,13 +116,6 @@ function workspaceRoot() {
 function reportPath(relPath = PUBLIC_SURFACE_REPORT_REL_PATH) {
     return resolve(workspaceRoot(), relPath);
 }
-function safeWriteReport(filePath, content) {
-    mkdirSync(dirname(filePath), { recursive: true });
-    const tmpPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
-    writeFileSync(tmpPath, content, "utf-8");
-    renameSync(tmpPath, filePath);
-    return filePath;
-}
 async function collectSurfaceEntries() {
     const entries = [];
     const [{ registerTools }, { registerResources }, { registerPrompts }] = await Promise.all([
@@ -162,7 +155,7 @@ async function collectSurfaceEntries() {
     registerPrompts(stub);
     return entries.sort((left, right) => left.id.localeCompare(right.id));
 }
-function walkTypescriptFiles(root) {
+function walkRuntimeSourceFiles(root) {
     const files = [];
     const visit = (dirPath) => {
         const entries = readdirSync(dirPath, { withFileTypes: true });
@@ -176,8 +169,9 @@ function walkTypescriptFiles(root) {
                 visit(absolutePath);
                 continue;
             }
-            if (extname(entry.name) === ".ts")
+            if ([".ts", ".js"].includes(extname(entry.name)) && !entry.name.endsWith(".d.ts")) {
                 files.push(absolutePath);
+            }
         }
     };
     visit(root);
@@ -185,7 +179,7 @@ function walkTypescriptFiles(root) {
 }
 function collectEmittedEventTypes() {
     const srcRoot = dirname(fileURLToPath(import.meta.url));
-    const files = walkTypescriptFiles(srcRoot);
+    const files = walkRuntimeSourceFiles(srcRoot);
     const discovered = new Set();
     const patterns = [
         /event_type:\s*"([A-Z][A-Z0-9_]+)"/g,
@@ -272,10 +266,24 @@ export function auditPublicSurface(options) {
                 const packageAbs = resolve(PACKAGE_ROOT, "assets", relPath);
                 if (!existsSync(abs) && !existsSync(packageAbs)) {
                     failures.push(`schema file missing for ${surfaceId}: ${relPath}`);
+                    continue;
+                }
+                const schemaPath = existsSync(abs) ? abs : packageAbs;
+                try {
+                    const schema = JSON.parse(readFileSync(schemaPath, "utf-8"));
+                    if (!schema || typeof schema !== "object" || Array.isArray(schema)) {
+                        failures.push(`schema file is not a JSON object for ${surfaceId}: ${relPath}`);
+                    }
+                }
+                catch (error) {
+                    failures.push(`schema file is invalid JSON for ${surfaceId}: ${relPath} (${error instanceof Error ? error.message : String(error)})`);
                 }
             }
         }
         const eventRegistry = new Set(Object.values(EVENT_TYPE));
+        if (emittedEvents.length === 0) {
+            failures.push("no emitted event types discovered in the production runtime sources");
+        }
         for (const eventType of emittedEvents) {
             if (!eventRegistry.has(eventType)) {
                 failures.push(`event type emitted without shared registry entry: ${eventType}`);
@@ -292,7 +300,8 @@ export function auditPublicSurface(options) {
             emitted_events: emittedEvents.length,
             schema_bound_surfaces: Object.keys(SCHEMA_REQUIREMENTS).length,
         };
-        const report_path = reportPath(options?.artifact_path || PUBLIC_SURFACE_REPORT_REL_PATH);
+        const artifactRelPath = options?.artifact_path || PUBLIC_SURFACE_REPORT_REL_PATH;
+        const report_path = reportPath(artifactRelPath);
         const result = {
             ok: failures.length === 0,
             summary,
@@ -301,8 +310,9 @@ export function auditPublicSurface(options) {
             surfaces,
             emitted_events: emittedEvents,
         };
+        let written_path;
         if (options?.write_artifact !== false) {
-            safeWriteReport(report_path, renderReport(result));
+            written_path = safeWrite(artifactRelPath, renderReport(result));
         }
         else if (!existsSync(report_path)) {
             warnings.push(`public surface report missing: ${report_path}`);
@@ -310,6 +320,8 @@ export function auditPublicSurface(options) {
         return {
             ...result,
             report_path,
+            artifact_path: artifactRelPath,
+            written_path,
         };
     });
 }

package/dist/safe-edit.d.ts

@@ -7,6 +7,8 @@ export interface SafeEditInput {
     path: string;
     /** New file content. */
     content: string;
+    /** Optional full sha256:<hex> source precondition checked immediately before promotion. */
+    expected_base_hash?: string;
     /** Shell command to validate the change (e.g., "npx tsc --noEmit"). */
     validation_command?: string;
     /** Shell command to run tests (e.g., "npm test"). */
@@ -26,6 +28,11 @@ export interface SafeEditResult {
     test_passed?: boolean;
     test_output?: string;
     error?: string;
+    reason_code?: string;
+    expected_hash?: string;
+    observed_hash?: string;
+    lease_lock_path?: string;
+    lease_waited_ms?: number;
     restored?: boolean;
 }
 export interface TestSuiteResult {
@@ -43,6 +50,18 @@ export interface DiffResult {
     removed: number;
     diff_summary: string;
 }
+export interface GcStagingInput {
+    max_age_hours?: number;
+    max_entries?: number;
+}
+export interface GcStagingResult {
+    ok: boolean;
+    staging_path: string;
+    removed_entries: number;
+    kept_entries: number;
+    errors: string[];
+}
+export declare function gcStaging(input?: GcStagingInput): GcStagingResult;
 export declare function safeEditFile(input: SafeEditInput): SafeEditResult;
 export declare function runTestSuite(command?: string): TestSuiteResult;
 export declare function diffContents(original: string, updated: string): DiffResult;
@@ -52,6 +71,7 @@ export declare function diffFiles(pathA: string, pathB: string): DiffResult & {
 export interface ApplyPatchInput {
     path: string;
     patch: string;
+    expected_base_hash?: string;
     validation_command?: string;
     test_command?: string;
 }