@voybio/ace-swarm 2.4.8 → 2.4.10

package/dist/runtime-profile-syntax.js

@@ -0,0 +1,121 @@
+// Shared ACE_WORKFLOW frontmatter parser; kept independent of runtime/event owners.
+function stripInlineComment(value) {
+    let inSingle = false;
+    let inDouble = false;
+    for (let idx = 0; idx < value.length; idx += 1) {
+        const char = value[idx];
+        const prev = idx > 0 ? value[idx - 1] : "";
+        if (char === "'" && !inDouble)
+            inSingle = !inSingle;
+        if (char === '"' && !inSingle && prev !== "\\")
+            inDouble = !inDouble;
+        if (char === "#" && !inSingle && !inDouble) {
+            const before = idx > 0 ? value[idx - 1] : "";
+            if (!before || /\s/.test(before)) {
+                return value.slice(0, idx).trimEnd();
+            }
+        }
+    }
+    return value.trimEnd();
+}
+function parseYamlScalar(rawValue, lineNumber) {
+    const value = stripInlineComment(rawValue.trim());
+    if (value === "null" || value === "~")
+        return null;
+    if (value === "true")
+        return true;
+    if (value === "false")
+        return false;
+    if (value === "{}")
+        return {};
+    if (value === "[]")
+        return [];
+    if (/^-?\d+$/.test(value))
+        return Number(value);
+    if ((value.startsWith("[") && value.endsWith("]")) ||
+        (value.startsWith("{") && value.endsWith("}"))) {
+        try {
+            return JSON.parse(value);
+        }
+        catch (error) {
+            throw new Error(`line ${lineNumber}: invalid JSON-style scalar (${error instanceof Error ? error.message : String(error)})`);
+        }
+    }
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+        const quote = value[0];
+        const inner = value.slice(1, -1);
+        if (quote === '"') {
+            return inner
+                .replace(/\\"/g, '"')
+                .replace(/\\n/g, "\n")
+                .replace(/\\r/g, "\r")
+                .replace(/\\t/g, "\t")
+                .replace(/\\\\/g, "\\");
+        }
+        return inner.replace(/''/g, "'");
+    }
+    return value;
+}
+export function parseYamlFrontMatter(raw) {
+    const root = {};
+    const stack = [
+        { indent: -1, value: root },
+    ];
+    const lines = raw.split(/\r?\n/);
+    lines.forEach((line, index) => {
+        const lineNumber = index + 1;
+        if (!line.trim() || line.trimStart().startsWith("#"))
+            return;
+        if (line.includes("\t")) {
+            throw new Error(`line ${lineNumber}: tabs are not allowed in ACE runtime front matter`);
+        }
+        const indentMatch = line.match(/^ */);
+        const indent = indentMatch ? indentMatch[0].length : 0;
+        if (indent % 2 !== 0) {
+            throw new Error(`line ${lineNumber}: indentation must use multiples of two spaces`);
+        }
+        const trimmed = line.trim();
+        if (trimmed.startsWith("- ")) {
+            throw new Error(`line ${lineNumber}: arrays are not supported in ACE runtime front matter`);
+        }
+        const colonIndex = trimmed.indexOf(":");
+        if (colonIndex <= 0) {
+            throw new Error(`line ${lineNumber}: expected "key: value" mapping`);
+        }
+        const key = trimmed.slice(0, colonIndex).trim();
+        const valuePart = trimmed.slice(colonIndex + 1).trim();
+        if (!/^[A-Za-z0-9_-]+$/.test(key)) {
+            throw new Error(`line ${lineNumber}: invalid key "${key}"`);
+        }
+        while (stack.length > 1 && indent <= stack[stack.length - 1].indent) {
+            stack.pop();
+        }
+        const parent = stack[stack.length - 1];
+        const expectedIndent = parent.indent < 0 ? 0 : parent.indent + 2;
+        if (indent > expectedIndent) {
+            throw new Error(`line ${lineNumber}: indentation jumps from ${parent.indent} to ${indent}`);
+        }
+        if (Object.prototype.hasOwnProperty.call(parent.value, key)) {
+            throw new Error(`line ${lineNumber}: duplicate key "${key}"`);
+        }
+        if (!valuePart) {
+            const child = {};
+            parent.value[key] = child;
+            stack.push({ indent, value: child });
+            return;
+        }
+        parent.value[key] = parseYamlScalar(valuePart, lineNumber);
+    });
+    return root;
+}
+export function extractFrontMatter(raw) {
+    const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/);
+    if (!match) {
+        throw new Error("ACE_WORKFLOW.md must start with YAML front matter delimited by leading and trailing --- lines");
+    }
+    const frontMatter = match[1];
+    const body = raw.slice(match[0].length);
+    return { front_matter: frontMatter, body };
+}
+//# sourceMappingURL=runtime-profile-syntax.js.map

package/dist/runtime-profile.d.ts

@@ -5,18 +5,20 @@ export declare const RUNTIME_PROFILE_REL_PATH = "agent-state/ACE_WORKFLOW.md";
 export declare const RUNTIME_PROFILE_SCHEMA_REL_PATH = "agent-state/MODULES/schemas/ACE_RUNTIME_PROFILE.schema.json";
 export declare const RUNTIME_PROFILE_SCHEMA_NAME = "ace-runtime-profile@1.0.0";
 export declare const DEFAULT_RUNTIME_TOOL_REGISTRY_REL_PATH = "agent-state/runtime-tool-specs.json";
-export declare const DEFAULT_EXECUTOR_MAX_TURNS = 6;
-export declare const DEFAULT_EXECUTOR_TURN_TIMEOUT_MS = 300000;
+export declare const DEFAULT_EXECUTOR_MAX_TURNS = 0;
+export declare const DEFAULT_EXECUTOR_TURN_TIMEOUT_MS = 0;
 export declare const DEFAULT_VERICIFY_BRIDGE_REL_PATH = "agent-state/vericify/ace-bridge.json";
 export type RuntimeModelClass = "frontier" | "mid" | "small_local";
-export declare const DEFAULT_STALL_WINDOW_MS = 300000;
-export declare const DEFAULT_TURN_BUDGET_MS = 1800000;
+export declare const DEFAULT_STALL_WINDOW_MS = 3600000;
+export declare const DEFAULT_STALL_WARNING_MS = 600000;
+export declare const DEFAULT_TURN_BUDGET_MS = 0;
 export declare const DEFAULT_MAX_STALL_RESTARTS = 3;
 export declare const DEFAULT_INITIAL_BACKOFF_MS = 5000;
 export declare const DEFAULT_MAX_RETRY_BACKOFF_MS = 300000;
 export interface ModelClassLivenessDefaults {
     turn_budget_ms: number;
     stall_window_ms: number;
+    stall_warning_ms: number;
     max_stall_restarts: number;
     initial_backoff_ms: number;
     max_retry_backoff_ms: number;
@@ -36,6 +38,19 @@ export declare function resolveEffectiveSurgicalReadBudget(profile: RuntimeProfi
 export declare const DEFAULT_VERICIFY_PROCESS_POST_LOG_REL_PATH = "agent-state/vericify/process-posts.json";
 declare const runtimeProfileSchema: z.ZodObject<{
     ace_runtime_version: z.ZodLiteral<"1.0.0">;
+    learning: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        distill_min_items: z.ZodDefault<z.ZodNumber>;
+        distill_min_goals: z.ZodDefault<z.ZodNumber>;
+        max_open_learning_steps: z.ZodDefault<z.ZodLiteral<1>>;
+        distill_cooldown_days: z.ZodDefault<z.ZodNumber>;
+        max_learned_skills: z.ZodDefault<z.ZodNumber>;
+        serve_max_lessons: z.ZodDefault<z.ZodNumber>;
+        serve_max_skills: z.ZodDefault<z.ZodNumber>;
+        serve_max_tokens: z.ZodDefault<z.ZodNumber>;
+        retire_unhelpful_after_serves: z.ZodDefault<z.ZodNumber>;
+        instructions_require_approval: z.ZodDefault<z.ZodLiteral<true>>;
+    }, z.core.$strict>>>;
     runtime: z.ZodObject<{
         mode: z.ZodEnum<{
             interactive: "interactive";
@@ -63,6 +78,8 @@ declare const runtimeProfileSchema: z.ZodObject<{
         turn_sandbox_policy: z.ZodNullable<z.ZodObject<{}, z.core.$catchall<z.ZodUnknown>>>;
         max_turns: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         turn_timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        stall_window_ms: z.ZodOptional<z.ZodNumber>;
+        stall_warning_ms: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>;
     tools: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         registry_path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -93,8 +110,8 @@ declare const runtimeProfileSchema: z.ZodObject<{
     tracker: z.ZodObject<{
         kind: z.ZodEnum<{
             memory: "memory";
-            none: "none";
             external: "external";
+            none: "none";
         }>;
         config: z.ZodObject<{}, z.core.$catchall<z.ZodUnknown>>;
     }, z.core.$strict>;
@@ -103,6 +120,21 @@ declare const runtimeProfileSchema: z.ZodObject<{
         http_port: z.ZodNullable<z.ZodNumber>;
         vericify_bridge: z.ZodDefault<z.ZodOptional<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            legacy_auto_posts: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            api_path: z.ZodOptional<z.ZodString>;
+            native: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                executable: z.ZodOptional<z.ZodString>;
+                data_dir: z.ZodOptional<z.ZodString>;
+                workspace_root: z.ZodOptional<z.ZodString>;
+                workspace_id: z.ZodOptional<z.ZodString>;
+                incarnation: z.ZodOptional<z.ZodString>;
+                query_timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                max_pages: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                max_bytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                retries: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                acceptance_wait_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            }, z.core.$strict>>;
             bridge_path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             process_post_path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         }, z.core.$strict>>>;

package/dist/runtime-profile.js

@@ -1,3 +1,5 @@
+import { parseYamlFrontMatter, extractFrontMatter } from './runtime-profile-syntax.js';
+import { learningPolicySchema, DEFAULT_LEARNING_POLICY } from './learning-policy.js';
 import { createHash } from "node:crypto";
 import { existsSync, readFileSync, statSync } from "node:fs";
 import { resolve } from "node:path";
@@ -10,12 +12,13 @@ export const RUNTIME_PROFILE_REL_PATH = "agent-state/ACE_WORKFLOW.md";
 export const RUNTIME_PROFILE_SCHEMA_REL_PATH = "agent-state/MODULES/schemas/ACE_RUNTIME_PROFILE.schema.json";
 export const RUNTIME_PROFILE_SCHEMA_NAME = "ace-runtime-profile@1.0.0";
 export const DEFAULT_RUNTIME_TOOL_REGISTRY_REL_PATH = "agent-state/runtime-tool-specs.json";
-export const DEFAULT_EXECUTOR_MAX_TURNS = 6;
-export const DEFAULT_EXECUTOR_TURN_TIMEOUT_MS = 300_000;
+export const DEFAULT_EXECUTOR_MAX_TURNS = 0;
+export const DEFAULT_EXECUTOR_TURN_TIMEOUT_MS = 0;
 export const DEFAULT_VERICIFY_BRIDGE_REL_PATH = "agent-state/vericify/ace-bridge.json";
 // Liveness defaults per model class
-export const DEFAULT_STALL_WINDOW_MS = 300_000; // 5 min — inter-progress cap
-export const DEFAULT_TURN_BUDGET_MS = 1_800_000; // 30 min — per-turn soft cap
+export const DEFAULT_STALL_WINDOW_MS = 3_600_000; // 60 minutes of silence before termination
+export const DEFAULT_STALL_WARNING_MS = 600_000; // Warn after 10 minutes of silence
+export const DEFAULT_TURN_BUDGET_MS = 0; // No implicit total turn deadline
 export const DEFAULT_MAX_STALL_RESTARTS = 3;
 export const DEFAULT_INITIAL_BACKOFF_MS = 5_000;
 export const DEFAULT_MAX_RETRY_BACKOFF_MS = 300_000;
@@ -28,16 +31,18 @@ export function getLivenessDefaults(modelClass) {
     switch (modelClass) {
         case "small_local":
             return {
-                turn_budget_ms: 3_600_000, // 60 min — slow models need generous cap
-                stall_window_ms: 180_000, // 3 min stall window
+                turn_budget_ms: DEFAULT_TURN_BUDGET_MS,
+                stall_window_ms: DEFAULT_STALL_WINDOW_MS,
+                stall_warning_ms: DEFAULT_STALL_WARNING_MS,
                 max_stall_restarts: 3,
                 initial_backoff_ms: 10_000,
                 max_retry_backoff_ms: 300_000,
             };
         case "mid":
             return {
-                turn_budget_ms: 1_800_000, // 30 min
-                stall_window_ms: 300_000, // 5 min
+                turn_budget_ms: DEFAULT_TURN_BUDGET_MS,
+                stall_window_ms: DEFAULT_STALL_WINDOW_MS,
+                stall_warning_ms: DEFAULT_STALL_WARNING_MS,
                 max_stall_restarts: 3,
                 initial_backoff_ms: 5_000,
                 max_retry_backoff_ms: 180_000,
@@ -47,6 +52,7 @@ export function getLivenessDefaults(modelClass) {
             return {
                 turn_budget_ms: DEFAULT_TURN_BUDGET_MS,
                 stall_window_ms: DEFAULT_STALL_WINDOW_MS,
+                stall_warning_ms: DEFAULT_STALL_WARNING_MS,
                 max_stall_restarts: DEFAULT_MAX_STALL_RESTARTS,
                 initial_backoff_ms: DEFAULT_INITIAL_BACKOFF_MS,
                 max_retry_backoff_ms: DEFAULT_MAX_RETRY_BACKOFF_MS,
@@ -72,6 +78,7 @@ const STRING_LIST = z.array(z.string().min(1));
 const runtimeProfileSchema = z
     .object({
     ace_runtime_version: z.literal("1.0.0"),
+    learning: learningPolicySchema.optional().default(DEFAULT_LEARNING_POLICY),
     runtime: z
         .object({
         mode: z.enum(["interactive", "unattended"]),
@@ -98,13 +105,15 @@ const runtimeProfileSchema = z
         approval_policy: z.union([z.string(), ANY_OBJECT]),
         thread_sandbox: z.string().min(1),
         turn_sandbox_policy: ANY_OBJECT.nullable(),
-        max_turns: z.number().int().positive().optional().default(DEFAULT_EXECUTOR_MAX_TURNS),
+        max_turns: z.number().int().nonnegative().optional().default(DEFAULT_EXECUTOR_MAX_TURNS),
         turn_timeout_ms: z
             .number()
             .int()
-            .positive()
+            .nonnegative()
             .optional()
             .default(DEFAULT_EXECUTOR_TURN_TIMEOUT_MS),
+        stall_window_ms: z.number().int().nonnegative().optional(),
+        stall_warning_ms: z.number().int().nonnegative().optional(),
     })
         .strict(),
     tools: z
@@ -169,6 +178,22 @@ const runtimeProfileSchema = z
         vericify_bridge: z
             .object({
             enabled: z.boolean().optional().default(false),
+            // Additive opt-ins: old profiles retain their paths and require no migration.
+            legacy_auto_posts: z.boolean().optional().default(false),
+            api_path: z.string().min(1).optional(),
+            native: z.object({
+                enabled: z.boolean().optional().default(false),
+                executable: z.string().min(1).optional(),
+                data_dir: z.string().min(1).optional(),
+                workspace_root: z.string().min(1).optional(),
+                workspace_id: z.string().min(1).optional(),
+                incarnation: z.string().min(1).optional(),
+                query_timeout_ms: z.number().int().min(1000).max(60000).optional().default(15000),
+                max_pages: z.number().int().min(1).max(64).optional().default(8),
+                max_bytes: z.number().int().min(4096).max(1048576).optional().default(262144),
+                retries: z.number().int().min(0).max(3).optional().default(1),
+                acceptance_wait_ms: z.number().int().min(0).max(120000).optional().default(15000),
+            }).strict().optional(),
             bridge_path: z
                 .string()
                 .min(1)
@@ -184,6 +209,7 @@ const runtimeProfileSchema = z
             .optional()
             .default({
             enabled: false,
+            legacy_auto_posts: false,
             bridge_path: DEFAULT_VERICIFY_BRIDGE_REL_PATH,
             process_post_path: DEFAULT_VERICIFY_PROCESS_POST_LOG_REL_PATH,
         }),
@@ -263,125 +289,6 @@ function computeSignature(path, content) {
         content_sha256: hashContent(content),
     };
 }
-function stripInlineComment(value) {
-    let inSingle = false;
-    let inDouble = false;
-    for (let idx = 0; idx < value.length; idx += 1) {
-        const char = value[idx];
-        const prev = idx > 0 ? value[idx - 1] : "";
-        if (char === "'" && !inDouble)
-            inSingle = !inSingle;
-        if (char === '"' && !inSingle && prev !== "\\")
-            inDouble = !inDouble;
-        if (char === "#" && !inSingle && !inDouble) {
-            const before = idx > 0 ? value[idx - 1] : "";
-            if (!before || /\s/.test(before)) {
-                return value.slice(0, idx).trimEnd();
-            }
-        }
-    }
-    return value.trimEnd();
-}
-function parseYamlScalar(rawValue, lineNumber) {
-    const value = stripInlineComment(rawValue.trim());
-    if (value === "null" || value === "~")
-        return null;
-    if (value === "true")
-        return true;
-    if (value === "false")
-        return false;
-    if (value === "{}")
-        return {};
-    if (value === "[]")
-        return [];
-    if (/^-?\d+$/.test(value))
-        return Number(value);
-    if ((value.startsWith("[") && value.endsWith("]")) ||
-        (value.startsWith("{") && value.endsWith("}"))) {
-        try {
-            return JSON.parse(value);
-        }
-        catch (error) {
-            throw new Error(`line ${lineNumber}: invalid JSON-style scalar (${error instanceof Error ? error.message : String(error)})`);
-        }
-    }
-    if ((value.startsWith('"') && value.endsWith('"')) ||
-        (value.startsWith("'") && value.endsWith("'"))) {
-        const quote = value[0];
-        const inner = value.slice(1, -1);
-        if (quote === '"') {
-            return inner
-                .replace(/\\"/g, '"')
-                .replace(/\\n/g, "\n")
-                .replace(/\\r/g, "\r")
-                .replace(/\\t/g, "\t")
-                .replace(/\\\\/g, "\\");
-        }
-        return inner.replace(/''/g, "'");
-    }
-    return value;
-}
-function parseYamlFrontMatter(raw) {
-    const root = {};
-    const stack = [
-        { indent: -1, value: root },
-    ];
-    const lines = raw.split(/\r?\n/);
-    lines.forEach((line, index) => {
-        const lineNumber = index + 1;
-        if (!line.trim() || line.trimStart().startsWith("#"))
-            return;
-        if (line.includes("\t")) {
-            throw new Error(`line ${lineNumber}: tabs are not allowed in ACE runtime front matter`);
-        }
-        const indentMatch = line.match(/^ */);
-        const indent = indentMatch ? indentMatch[0].length : 0;
-        if (indent % 2 !== 0) {
-            throw new Error(`line ${lineNumber}: indentation must use multiples of two spaces`);
-        }
-        const trimmed = line.trim();
-        if (trimmed.startsWith("- ")) {
-            throw new Error(`line ${lineNumber}: arrays are not supported in ACE runtime front matter`);
-        }
-        const colonIndex = trimmed.indexOf(":");
-        if (colonIndex <= 0) {
-            throw new Error(`line ${lineNumber}: expected "key: value" mapping`);
-        }
-        const key = trimmed.slice(0, colonIndex).trim();
-        const valuePart = trimmed.slice(colonIndex + 1).trim();
-        if (!/^[A-Za-z0-9_-]+$/.test(key)) {
-            throw new Error(`line ${lineNumber}: invalid key "${key}"`);
-        }
-        while (stack.length > 1 && indent <= stack[stack.length - 1].indent) {
-            stack.pop();
-        }
-        const parent = stack[stack.length - 1];
-        const expectedIndent = parent.indent < 0 ? 0 : parent.indent + 2;
-        if (indent > expectedIndent) {
-            throw new Error(`line ${lineNumber}: indentation jumps from ${parent.indent} to ${indent}`);
-        }
-        if (Object.prototype.hasOwnProperty.call(parent.value, key)) {
-            throw new Error(`line ${lineNumber}: duplicate key "${key}"`);
-        }
-        if (!valuePart) {
-            const child = {};
-            parent.value[key] = child;
-            stack.push({ indent, value: child });
-            return;
-        }
-        parent.value[key] = parseYamlScalar(valuePart, lineNumber);
-    });
-    return root;
-}
-function extractFrontMatter(raw) {
-    const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/);
-    if (!match) {
-        throw new Error("ACE_WORKFLOW.md must start with YAML front matter delimited by leading and trailing --- lines");
-    }
-    const frontMatter = match[1];
-    const body = raw.slice(match[0].length);
-    return { front_matter: frontMatter, body };
-}
 function parseRuntimeProfileContent(raw) {
     const { front_matter, body } = extractFrontMatter(raw);
     if (body.length === 0) {

package/dist/runtime-tool-specs.js

@@ -416,7 +416,7 @@ export async function executeRuntimeTool(name, input, context = {}) {
                 ACE_RUNTIME_WORKSPACE_PATH: workspacePath,
             },
         }),
-        timeout_ms: spec.executor.timeout_ms ?? 60_000,
+        timeout_ms: spec.executor.timeout_ms,
     });
     let responseRaw;
     if (existsSync(tempPaths.responsePath)) {

package/dist/safe-edit.d.ts

@@ -2,7 +2,9 @@
  * Safe-edit module: copy → modify → validate → swap pattern.
  * Prevents bricking by never leaving core files in a broken state.
  */
+import { type CommandOptions } from "./progress-command.js";
 export interface SafeEditInput {
+    command_policy?: CommandOptions;
     /** Workspace-relative path to edit. */
     path: string;
     /** New file content. */
@@ -41,6 +43,7 @@ export interface TestSuiteResult {
     output: string;
     command: string;
     duration_ms: number;
+    reason_code?: string;
 }
 export interface DiffResult {
     has_diff: boolean;
@@ -62,18 +65,19 @@ export interface GcStagingResult {
     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 safeEditFile(input: SafeEditInput): Promise<SafeEditResult>;
+export declare function runTestSuite(command?: string, options?: CommandOptions): Promise<TestSuiteResult>;
 export declare function diffContents(original: string, updated: string): DiffResult;
 export declare function diffFiles(pathA: string, pathB: string): DiffResult & {
     error?: string;
 };
 export interface ApplyPatchInput {
+    command_policy?: CommandOptions;
     path: string;
     patch: string;
     expected_base_hash?: string;
     validation_command?: string;
     test_command?: string;
 }
-export declare function applyPatch(input: ApplyPatchInput): SafeEditResult;
+export declare function applyPatch(input: ApplyPatchInput): Promise<SafeEditResult>;
 //# sourceMappingURL=safe-edit.d.ts.map