@agentv/core 2.11.1 → 2.11.4

package/dist/index.d.cts

@@ -2305,7 +2305,7 @@ declare class RepoManager {
      * Creates on first access, fetches updates on subsequent calls.
      * Returns the absolute path to the cache directory.
      */
-    ensureCache(source: RepoSource, depth?: number): Promise<string>;
+    ensureCache(source: RepoSource, depth?: number, resolve?: 'remote' | 'local'): Promise<string>;
     /**
      * Clone a repo from cache into the workspace at the configured path.
      * Handles checkout, ref resolution, ancestor walking, shallow clone, sparse checkout.
@@ -2628,14 +2628,30 @@ declare const AgentVConfigSchema: z.ZodObject<{
         maxRetries: z.ZodOptional<z.ZodNumber>;
         /** Agent timeout in milliseconds (default: 120000) */
         agentTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        /** Enable verbose logging */
+        verbose: z.ZodOptional<z.ZodBoolean>;
+        /** Write human-readable trace JSONL to this path (supports {timestamp} placeholder) */
+        traceFile: z.ZodOptional<z.ZodString>;
+        /** Always keep temp workspaces after eval */
+        keepWorkspaces: z.ZodOptional<z.ZodBoolean>;
+        /** Write OTLP JSON trace to this path (supports {timestamp} placeholder) */
+        otelFile: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        verbose?: boolean | undefined;
         workers?: number | undefined;
         maxRetries?: number | undefined;
         agentTimeoutMs?: number | undefined;
+        keepWorkspaces?: boolean | undefined;
+        traceFile?: string | undefined;
+        otelFile?: string | undefined;
     }, {
+        verbose?: boolean | undefined;
         workers?: number | undefined;
         maxRetries?: number | undefined;
         agentTimeoutMs?: number | undefined;
+        keepWorkspaces?: boolean | undefined;
+        traceFile?: string | undefined;
+        otelFile?: string | undefined;
     }>>;
     /** Output settings */
     output: z.ZodOptional<z.ZodObject<{
@@ -2682,9 +2698,13 @@ declare const AgentVConfigSchema: z.ZodObject<{
         format?: "yaml" | "jsonl" | "json" | "xml" | undefined;
     } | undefined;
     execution?: {
+        verbose?: boolean | undefined;
         workers?: number | undefined;
         maxRetries?: number | undefined;
         agentTimeoutMs?: number | undefined;
+        keepWorkspaces?: boolean | undefined;
+        traceFile?: string | undefined;
+        otelFile?: string | undefined;
     } | undefined;
     cache?: {
         enabled?: boolean | undefined;
@@ -2700,9 +2720,13 @@ declare const AgentVConfigSchema: z.ZodObject<{
         format?: "yaml" | "jsonl" | "json" | "xml" | undefined;
     } | undefined;
     execution?: {
+        verbose?: boolean | undefined;
         workers?: number | undefined;
         maxRetries?: number | undefined;
         agentTimeoutMs?: number | undefined;
+        keepWorkspaces?: boolean | undefined;
+        traceFile?: string | undefined;
+        otelFile?: string | undefined;
     } | undefined;
     cache?: {
         enabled?: boolean | undefined;

package/dist/index.d.ts

@@ -2305,7 +2305,7 @@ declare class RepoManager {
      * Creates on first access, fetches updates on subsequent calls.
      * Returns the absolute path to the cache directory.
      */
-    ensureCache(source: RepoSource, depth?: number): Promise<string>;
+    ensureCache(source: RepoSource, depth?: number, resolve?: 'remote' | 'local'): Promise<string>;
     /**
      * Clone a repo from cache into the workspace at the configured path.
      * Handles checkout, ref resolution, ancestor walking, shallow clone, sparse checkout.
@@ -2628,14 +2628,30 @@ declare const AgentVConfigSchema: z.ZodObject<{
         maxRetries: z.ZodOptional<z.ZodNumber>;
         /** Agent timeout in milliseconds (default: 120000) */
         agentTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        /** Enable verbose logging */
+        verbose: z.ZodOptional<z.ZodBoolean>;
+        /** Write human-readable trace JSONL to this path (supports {timestamp} placeholder) */
+        traceFile: z.ZodOptional<z.ZodString>;
+        /** Always keep temp workspaces after eval */
+        keepWorkspaces: z.ZodOptional<z.ZodBoolean>;
+        /** Write OTLP JSON trace to this path (supports {timestamp} placeholder) */
+        otelFile: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        verbose?: boolean | undefined;
         workers?: number | undefined;
         maxRetries?: number | undefined;
         agentTimeoutMs?: number | undefined;
+        keepWorkspaces?: boolean | undefined;
+        traceFile?: string | undefined;
+        otelFile?: string | undefined;
     }, {
+        verbose?: boolean | undefined;
         workers?: number | undefined;
         maxRetries?: number | undefined;
         agentTimeoutMs?: number | undefined;
+        keepWorkspaces?: boolean | undefined;
+        traceFile?: string | undefined;
+        otelFile?: string | undefined;
     }>>;
     /** Output settings */
     output: z.ZodOptional<z.ZodObject<{
@@ -2682,9 +2698,13 @@ declare const AgentVConfigSchema: z.ZodObject<{
         format?: "yaml" | "jsonl" | "json" | "xml" | undefined;
     } | undefined;
     execution?: {
+        verbose?: boolean | undefined;
         workers?: number | undefined;
         maxRetries?: number | undefined;
         agentTimeoutMs?: number | undefined;
+        keepWorkspaces?: boolean | undefined;
+        traceFile?: string | undefined;
+        otelFile?: string | undefined;
     } | undefined;
     cache?: {
         enabled?: boolean | undefined;
@@ -2700,9 +2720,13 @@ declare const AgentVConfigSchema: z.ZodObject<{
         format?: "yaml" | "jsonl" | "json" | "xml" | undefined;
     } | undefined;
     execution?: {
+        verbose?: boolean | undefined;
         workers?: number | undefined;
         maxRetries?: number | undefined;
         agentTimeoutMs?: number | undefined;
+        keepWorkspaces?: boolean | undefined;
+        traceFile?: string | undefined;
+        otelFile?: string | undefined;
     } | undefined;
     cache?: {
         enabled?: boolean | undefined;

package/dist/index.js

@@ -12653,14 +12653,24 @@ var RepoManager = class {
    * Creates on first access, fetches updates on subsequent calls.
    * Returns the absolute path to the cache directory.
    */
-  async ensureCache(source, depth) {
+  async ensureCache(source, depth, resolve) {
     const key = cacheKey(source);
     const cachePath = path35.join(this.cacheDir, key);
     const lockPath = `${cachePath}.lock`;
+    const cacheExists = existsSync2(path35.join(cachePath, "HEAD"));
+    if (resolve === "local") {
+      if (cacheExists) {
+        return cachePath;
+      }
+      const url = getSourceUrl(source);
+      throw new Error(
+        `No cache found for \`${url}\`. Run \`agentv cache add --url ${url} --from <local-path>\` to seed it.`
+      );
+    }
     await mkdir11(this.cacheDir, { recursive: true });
     await acquireLock(lockPath);
     try {
-      if (existsSync2(path35.join(cachePath, "HEAD"))) {
+      if (cacheExists) {
         const fetchArgs = ["fetch", "--prune"];
         if (depth) {
           fetchArgs.push("--depth", String(depth));
@@ -12687,7 +12697,11 @@ var RepoManager = class {
    */
   async materialize(repo, workspacePath) {
     const targetDir = path35.join(workspacePath, repo.path);
-    const cachePath = await this.ensureCache(repo.source, repo.clone?.depth);
+    const cachePath = await this.ensureCache(
+      repo.source,
+      repo.clone?.depth,
+      repo.checkout?.resolve
+    );
     const cloneArgs = ["clone"];
     if (repo.clone?.depth) {
       cloneArgs.push("--depth", String(repo.clone.depth));
@@ -14482,7 +14496,15 @@ var AgentVConfigSchema = z5.object({
     /** Maximum retries on failure (default: 2) */
     maxRetries: z5.number().int().min(0).optional(),
     /** Agent timeout in milliseconds (default: 120000) */
-    agentTimeoutMs: z5.number().int().min(0).optional()
+    agentTimeoutMs: z5.number().int().min(0).optional(),
+    /** Enable verbose logging */
+    verbose: z5.boolean().optional(),
+    /** Write human-readable trace JSONL to this path (supports {timestamp} placeholder) */
+    traceFile: z5.string().optional(),
+    /** Always keep temp workspaces after eval */
+    keepWorkspaces: z5.boolean().optional(),
+    /** Write OTLP JSON trace to this path (supports {timestamp} placeholder) */
+    otelFile: z5.string().optional()
   }).optional(),
   /** Output settings */
   output: z5.object({