@runtypelabs/sdk 1.13.0 → 1.13.3

package/dist/index.cjs

@@ -5085,6 +5085,35 @@ var _AgentsEndpoint = class _AgentsEndpoint {
     }
     return true;
   }
+  getForcedCompactionSummaryPrefix(state) {
+    return state.status === "complete" ? _AgentsEndpoint.COMPLETED_COMPACT_SUMMARY_PREFIX : _AgentsEndpoint.RESUMED_COMPACT_SUMMARY_PREFIX;
+  }
+  buildContinuationGuardrail(state) {
+    if (state.status === "complete") {
+      return "IMPORTANT: You are continuing a previously completed task. The conversation above shows your prior work. Do NOT redo any of it. Build on what was already accomplished. If there is nothing new to do, respond with TASK_COMPLETE.";
+    }
+    return "IMPORTANT: You are continuing a previously saved task. The conversation above shows your prior work. Do NOT redo any of it. Build on what was already accomplished.";
+  }
+  isExecutionLikePhase(phaseName, workflow, state) {
+    if (!phaseName) return false;
+    const normalizedPhase = phaseName.trim().toLowerCase();
+    if (!normalizedPhase || normalizedPhase === "complete") {
+      return false;
+    }
+    if (normalizedPhase === "execution") {
+      return true;
+    }
+    const currentIndex = workflow.phases.findIndex((phase) => phase.name === phaseName);
+    const executionIndex = workflow.phases.findIndex(
+      (phase) => phase.name.trim().toLowerCase() === "execution"
+    );
+    if (currentIndex >= 0 && executionIndex >= 0 && currentIndex >= executionIndex) {
+      return true;
+    }
+    return Boolean(
+      state.planWritten && normalizedPhase !== "research" && normalizedPhase !== "planning"
+    );
+  }
   computeCompletionRejectionReason(state, trace) {
     const reasons = [];
     if (!state.planWritten) {
@@ -5472,7 +5501,7 @@ var _AgentsEndpoint = class _AgentsEndpoint {
             trace.writeCountByPath[normalizedPathArg] = (trace.writeCountByPath[normalizedPathArg] || 0) + 1;
             if (normalizedPlanPath && normalizedPathArg === normalizedPlanPath) {
               trace.planWritten = true;
-            } else if (state.workflowPhase === "execution") {
+            } else if (this.isExecutionLikePhase(state.workflowPhase, workflow, state)) {
               trace.executionFileWritten = true;
               trace.verificationPassed = false;
               if (!this.isMarathonArtifactPath(normalizedPathArg)) {
@@ -5845,6 +5874,7 @@ var _AgentsEndpoint = class _AgentsEndpoint {
       }
     }
     for (let session = 0; session < maxSessions; session++) {
+      const phaseAtSessionStart = state.workflowPhase;
       const sessionTrace = this.createEmptyToolTrace();
       const sessionLocalTools = this.wrapLocalToolsForTrace(
         options.localTools,
@@ -6037,12 +6067,6 @@ var _AgentsEndpoint = class _AgentsEndpoint {
       if ((state.consecutiveBlockedVerificationSessions || 0) >= 2 && state.verificationRequired) {
         state.verificationRequired = false;
         state.lastVerificationPassed = true;
-        if (!state.planWritten) {
-          state.planWritten = true;
-        }
-        if (!state.bestCandidateVerified) {
-          state.bestCandidateVerified = true;
-        }
       }
       const modelKey = options.model || "default";
       if (!state.costByModel) state.costByModel = {};
@@ -6089,7 +6113,13 @@ var _AgentsEndpoint = class _AgentsEndpoint {
         consecutiveServerNetworkErrors = 0;
       }
       const detectedTaskCompletion = this.detectTaskCompletion(sessionResult.result);
-      const acceptedTaskCompletion = detectedTaskCompletion && this.canAcceptTaskCompletion(sessionResult.result, state, sessionTrace, workflow);
+      const completionCheckState = phaseAtSessionStart && phaseAtSessionStart !== state.workflowPhase ? { ...state, workflowPhase: phaseAtSessionStart } : state;
+      const acceptedTaskCompletion = detectedTaskCompletion && this.canAcceptTaskCompletion(
+        sessionResult.result,
+        completionCheckState,
+        sessionTrace,
+        workflow
+      );
       if (detectedTaskCompletion && !acceptedTaskCompletion) {
         state.lastCompletionRejectionReason = this.computeCompletionRejectionReason(state, sessionTrace);
         if (state.verificationRequired && !state.lastVerificationPassed && !sessionTrace.verificationPassed && !sessionTrace.verificationAttempted) {
@@ -6097,12 +6127,6 @@ var _AgentsEndpoint = class _AgentsEndpoint {
           if ((state.consecutiveBlockedVerificationSessions || 0) >= 2) {
             state.verificationRequired = false;
             state.lastVerificationPassed = true;
-            if (!state.planWritten) {
-              state.planWritten = true;
-            }
-            if (!state.bestCandidateVerified) {
-              state.bestCandidateVerified = true;
-            }
           }
         }
       } else {
@@ -6115,7 +6139,11 @@ var _AgentsEndpoint = class _AgentsEndpoint {
         state.consecutiveEmptySessions = (state.consecutiveEmptySessions || 0) + 1;
       }
       if (sessionResult.stopReason === "complete" && !detectedTaskCompletion) {
-        state.status = "complete";
+        const currentPhase = workflow.phases.find((p) => p.name === state.workflowPhase);
+        const gatesSatisfied = currentPhase?.canAcceptCompletion ? currentPhase.canAcceptCompletion(state, sessionTrace) : true;
+        if (gatesSatisfied) {
+          state.status = "complete";
+        }
       } else if (sessionResult.stopReason === "error") {
         if (_AgentsEndpoint.isRetryableSessionError(sessionResult.error) && consecutiveServerNetworkErrors < maxServerNetworkRetries) {
           consecutiveServerNetworkErrors++;
@@ -6416,7 +6444,7 @@ Do NOT redo any of the above work.`
   }
   buildCompactHistoryMessages(state, userContent, compactInstructions, mode = "auto") {
     const summary = this.generateCompactSummary(state, compactInstructions);
-    const prefix = mode === "forced" ? _AgentsEndpoint.FORCED_COMPACT_SUMMARY_PREFIX : _AgentsEndpoint.AUTO_COMPACT_SUMMARY_PREFIX;
+    const prefix = mode === "forced" ? this.getForcedCompactionSummaryPrefix(state) : _AgentsEndpoint.AUTO_COMPACT_SUMMARY_PREFIX;
     return [
       {
         role: "system",
@@ -6435,7 +6463,7 @@ Do NOT redo any of the above work.`
   isCompactHistoryMessageSet(messages) {
     if (messages.length === 0) return false;
     const firstMessage = messages[0];
-    return firstMessage?.role === "system" && typeof firstMessage.content === "string" && (firstMessage.content.startsWith(_AgentsEndpoint.AUTO_COMPACT_SUMMARY_PREFIX) || firstMessage.content.startsWith(_AgentsEndpoint.FORCED_COMPACT_SUMMARY_PREFIX));
+    return firstMessage?.role === "system" && typeof firstMessage.content === "string" && (firstMessage.content.startsWith(_AgentsEndpoint.AUTO_COMPACT_SUMMARY_PREFIX) || firstMessage.content.startsWith(_AgentsEndpoint.RESUMED_COMPACT_SUMMARY_PREFIX) || firstMessage.content.startsWith(_AgentsEndpoint.COMPLETED_COMPACT_SUMMARY_PREFIX));
   }
   /**
    * Generate a compact summary of prior work for continuation context.
@@ -6674,7 +6702,7 @@ Do NOT redo any of the above work.`
       const replayHistoryMessages = this.sanitizeReplayHistoryMessages(
         continuationContext.previousMessages
       );
-      const continuationGuardrail = "IMPORTANT: You are continuing a previously completed task. The conversation above shows your prior work. Do NOT redo any of it. Build on what was already accomplished. If there is nothing new to do, respond with TASK_COMPLETE.";
+      const continuationGuardrail = this.buildContinuationGuardrail(state);
       const defaultContinueMessage = "Continue the task. Review your prior work above and proceed with any remaining work. If everything is already complete, respond with TASK_COMPLETE.";
       const userMessage = continuationContext.newUserMessage || defaultContinueMessage;
       const userContent = [
@@ -6926,7 +6954,8 @@ Do NOT redo any of the above work.`
   }
 };
 _AgentsEndpoint.AUTO_COMPACT_SUMMARY_PREFIX = "You are continuing a long-running task. Here is a compact summary of prior work:";
-_AgentsEndpoint.FORCED_COMPACT_SUMMARY_PREFIX = "You are continuing a previously completed task. Here is a summary of prior work:";
+_AgentsEndpoint.RESUMED_COMPACT_SUMMARY_PREFIX = "You are continuing a previously saved task. Here is a summary of prior work:";
+_AgentsEndpoint.COMPLETED_COMPACT_SUMMARY_PREFIX = "You are continuing a previously completed task. Here is a summary of prior work:";
 /** Error message patterns from server-side sessions that indicate a transient network failure
  *  (e.g. AI provider connection dropped). These are retried automatically. */
 _AgentsEndpoint.RETRYABLE_SESSION_ERROR_PATTERNS = [
@@ -8303,4 +8332,3 @@ var ClientEvalBuilder = class extends EvalBuilder {
   sanitizeTaskSlug,
   streamEvents
 });
-//# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -118,6 +118,10 @@ interface RuntypeRecord {
         keyCount: number;
         updatedAt: string;
     };
+    messages?: Array<{
+        role: 'user' | 'assistant';
+        content: string | unknown[];
+    }> | null;
     availableFields?: string[];
     userId: string;
     createdAt: string;
@@ -394,7 +398,7 @@ interface BuiltInTool {
     id: string;
     name: string;
     description: string;
-    category: 'image_generation' | 'web_search' | 'web_scraping' | 'code_execution' | 'file_operations' | 'data_analysis' | 'knowledge_retrieval' | 'text_to_speech' | 'voice_processing' | 'third_party_api';
+    category: 'image_generation' | 'web_search' | 'web_scraping' | 'code_execution' | 'file_operations' | 'data_analysis' | 'knowledge_retrieval' | 'text_to_speech' | 'voice_processing' | 'third_party_api' | 'data_management';
     providers: string[];
     parametersSchema: JSONSchema;
     defaultConfig?: JsonObject;
@@ -4570,7 +4574,8 @@ interface Agent {
 declare class AgentsEndpoint {
     private client;
     private static readonly AUTO_COMPACT_SUMMARY_PREFIX;
-    private static readonly FORCED_COMPACT_SUMMARY_PREFIX;
+    private static readonly RESUMED_COMPACT_SUMMARY_PREFIX;
+    private static readonly COMPLETED_COMPACT_SUMMARY_PREFIX;
     constructor(client: ApiClient);
     /**
      * List all agents for the authenticated user
@@ -4719,6 +4724,9 @@ declare class AgentsEndpoint {
     private hasSufficientResearchEvidence;
     private buildEffectiveSessionOutput;
     private canAcceptTaskCompletion;
+    private getForcedCompactionSummaryPrefix;
+    private buildContinuationGuardrail;
+    private isExecutionLikePhase;
     private computeCompletionRejectionReason;
     private summarizeUnknownForTrace;
     private summarizeTextBlockForTrace;

package/dist/index.d.ts

@@ -118,6 +118,10 @@ interface RuntypeRecord {
         keyCount: number;
         updatedAt: string;
     };
+    messages?: Array<{
+        role: 'user' | 'assistant';
+        content: string | unknown[];
+    }> | null;
     availableFields?: string[];
     userId: string;
     createdAt: string;
@@ -394,7 +398,7 @@ interface BuiltInTool {
     id: string;
     name: string;
     description: string;
-    category: 'image_generation' | 'web_search' | 'web_scraping' | 'code_execution' | 'file_operations' | 'data_analysis' | 'knowledge_retrieval' | 'text_to_speech' | 'voice_processing' | 'third_party_api';
+    category: 'image_generation' | 'web_search' | 'web_scraping' | 'code_execution' | 'file_operations' | 'data_analysis' | 'knowledge_retrieval' | 'text_to_speech' | 'voice_processing' | 'third_party_api' | 'data_management';
     providers: string[];
     parametersSchema: JSONSchema;
     defaultConfig?: JsonObject;
@@ -4570,7 +4574,8 @@ interface Agent {
 declare class AgentsEndpoint {
     private client;
     private static readonly AUTO_COMPACT_SUMMARY_PREFIX;
-    private static readonly FORCED_COMPACT_SUMMARY_PREFIX;
+    private static readonly RESUMED_COMPACT_SUMMARY_PREFIX;
+    private static readonly COMPLETED_COMPACT_SUMMARY_PREFIX;
     constructor(client: ApiClient);
     /**
      * List all agents for the authenticated user
@@ -4719,6 +4724,9 @@ declare class AgentsEndpoint {
     private hasSufficientResearchEvidence;
     private buildEffectiveSessionOutput;
     private canAcceptTaskCompletion;
+    private getForcedCompactionSummaryPrefix;
+    private buildContinuationGuardrail;
+    private isExecutionLikePhase;
     private computeCompletionRejectionReason;
     private summarizeUnknownForTrace;
     private summarizeTextBlockForTrace;

package/dist/index.mjs

@@ -5015,6 +5015,35 @@ var _AgentsEndpoint = class _AgentsEndpoint {
     }
     return true;
   }
+  getForcedCompactionSummaryPrefix(state) {
+    return state.status === "complete" ? _AgentsEndpoint.COMPLETED_COMPACT_SUMMARY_PREFIX : _AgentsEndpoint.RESUMED_COMPACT_SUMMARY_PREFIX;
+  }
+  buildContinuationGuardrail(state) {
+    if (state.status === "complete") {
+      return "IMPORTANT: You are continuing a previously completed task. The conversation above shows your prior work. Do NOT redo any of it. Build on what was already accomplished. If there is nothing new to do, respond with TASK_COMPLETE.";
+    }
+    return "IMPORTANT: You are continuing a previously saved task. The conversation above shows your prior work. Do NOT redo any of it. Build on what was already accomplished.";
+  }
+  isExecutionLikePhase(phaseName, workflow, state) {
+    if (!phaseName) return false;
+    const normalizedPhase = phaseName.trim().toLowerCase();
+    if (!normalizedPhase || normalizedPhase === "complete") {
+      return false;
+    }
+    if (normalizedPhase === "execution") {
+      return true;
+    }
+    const currentIndex = workflow.phases.findIndex((phase) => phase.name === phaseName);
+    const executionIndex = workflow.phases.findIndex(
+      (phase) => phase.name.trim().toLowerCase() === "execution"
+    );
+    if (currentIndex >= 0 && executionIndex >= 0 && currentIndex >= executionIndex) {
+      return true;
+    }
+    return Boolean(
+      state.planWritten && normalizedPhase !== "research" && normalizedPhase !== "planning"
+    );
+  }
   computeCompletionRejectionReason(state, trace) {
     const reasons = [];
     if (!state.planWritten) {
@@ -5402,7 +5431,7 @@ var _AgentsEndpoint = class _AgentsEndpoint {
             trace.writeCountByPath[normalizedPathArg] = (trace.writeCountByPath[normalizedPathArg] || 0) + 1;
             if (normalizedPlanPath && normalizedPathArg === normalizedPlanPath) {
               trace.planWritten = true;
-            } else if (state.workflowPhase === "execution") {
+            } else if (this.isExecutionLikePhase(state.workflowPhase, workflow, state)) {
               trace.executionFileWritten = true;
               trace.verificationPassed = false;
               if (!this.isMarathonArtifactPath(normalizedPathArg)) {
@@ -5775,6 +5804,7 @@ var _AgentsEndpoint = class _AgentsEndpoint {
       }
     }
     for (let session = 0; session < maxSessions; session++) {
+      const phaseAtSessionStart = state.workflowPhase;
       const sessionTrace = this.createEmptyToolTrace();
       const sessionLocalTools = this.wrapLocalToolsForTrace(
         options.localTools,
@@ -5967,12 +5997,6 @@ var _AgentsEndpoint = class _AgentsEndpoint {
       if ((state.consecutiveBlockedVerificationSessions || 0) >= 2 && state.verificationRequired) {
         state.verificationRequired = false;
         state.lastVerificationPassed = true;
-        if (!state.planWritten) {
-          state.planWritten = true;
-        }
-        if (!state.bestCandidateVerified) {
-          state.bestCandidateVerified = true;
-        }
       }
       const modelKey = options.model || "default";
       if (!state.costByModel) state.costByModel = {};
@@ -6019,7 +6043,13 @@ var _AgentsEndpoint = class _AgentsEndpoint {
         consecutiveServerNetworkErrors = 0;
       }
       const detectedTaskCompletion = this.detectTaskCompletion(sessionResult.result);
-      const acceptedTaskCompletion = detectedTaskCompletion && this.canAcceptTaskCompletion(sessionResult.result, state, sessionTrace, workflow);
+      const completionCheckState = phaseAtSessionStart && phaseAtSessionStart !== state.workflowPhase ? { ...state, workflowPhase: phaseAtSessionStart } : state;
+      const acceptedTaskCompletion = detectedTaskCompletion && this.canAcceptTaskCompletion(
+        sessionResult.result,
+        completionCheckState,
+        sessionTrace,
+        workflow
+      );
       if (detectedTaskCompletion && !acceptedTaskCompletion) {
         state.lastCompletionRejectionReason = this.computeCompletionRejectionReason(state, sessionTrace);
         if (state.verificationRequired && !state.lastVerificationPassed && !sessionTrace.verificationPassed && !sessionTrace.verificationAttempted) {
@@ -6027,12 +6057,6 @@ var _AgentsEndpoint = class _AgentsEndpoint {
           if ((state.consecutiveBlockedVerificationSessions || 0) >= 2) {
             state.verificationRequired = false;
             state.lastVerificationPassed = true;
-            if (!state.planWritten) {
-              state.planWritten = true;
-            }
-            if (!state.bestCandidateVerified) {
-              state.bestCandidateVerified = true;
-            }
           }
         }
       } else {
@@ -6045,7 +6069,11 @@ var _AgentsEndpoint = class _AgentsEndpoint {
         state.consecutiveEmptySessions = (state.consecutiveEmptySessions || 0) + 1;
       }
       if (sessionResult.stopReason === "complete" && !detectedTaskCompletion) {
-        state.status = "complete";
+        const currentPhase = workflow.phases.find((p) => p.name === state.workflowPhase);
+        const gatesSatisfied = currentPhase?.canAcceptCompletion ? currentPhase.canAcceptCompletion(state, sessionTrace) : true;
+        if (gatesSatisfied) {
+          state.status = "complete";
+        }
       } else if (sessionResult.stopReason === "error") {
         if (_AgentsEndpoint.isRetryableSessionError(sessionResult.error) && consecutiveServerNetworkErrors < maxServerNetworkRetries) {
           consecutiveServerNetworkErrors++;
@@ -6346,7 +6374,7 @@ Do NOT redo any of the above work.`
   }
   buildCompactHistoryMessages(state, userContent, compactInstructions, mode = "auto") {
     const summary = this.generateCompactSummary(state, compactInstructions);
-    const prefix = mode === "forced" ? _AgentsEndpoint.FORCED_COMPACT_SUMMARY_PREFIX : _AgentsEndpoint.AUTO_COMPACT_SUMMARY_PREFIX;
+    const prefix = mode === "forced" ? this.getForcedCompactionSummaryPrefix(state) : _AgentsEndpoint.AUTO_COMPACT_SUMMARY_PREFIX;
     return [
       {
         role: "system",
@@ -6365,7 +6393,7 @@ Do NOT redo any of the above work.`
   isCompactHistoryMessageSet(messages) {
     if (messages.length === 0) return false;
     const firstMessage = messages[0];
-    return firstMessage?.role === "system" && typeof firstMessage.content === "string" && (firstMessage.content.startsWith(_AgentsEndpoint.AUTO_COMPACT_SUMMARY_PREFIX) || firstMessage.content.startsWith(_AgentsEndpoint.FORCED_COMPACT_SUMMARY_PREFIX));
+    return firstMessage?.role === "system" && typeof firstMessage.content === "string" && (firstMessage.content.startsWith(_AgentsEndpoint.AUTO_COMPACT_SUMMARY_PREFIX) || firstMessage.content.startsWith(_AgentsEndpoint.RESUMED_COMPACT_SUMMARY_PREFIX) || firstMessage.content.startsWith(_AgentsEndpoint.COMPLETED_COMPACT_SUMMARY_PREFIX));
   }
   /**
    * Generate a compact summary of prior work for continuation context.
@@ -6604,7 +6632,7 @@ Do NOT redo any of the above work.`
       const replayHistoryMessages = this.sanitizeReplayHistoryMessages(
         continuationContext.previousMessages
       );
-      const continuationGuardrail = "IMPORTANT: You are continuing a previously completed task. The conversation above shows your prior work. Do NOT redo any of it. Build on what was already accomplished. If there is nothing new to do, respond with TASK_COMPLETE.";
+      const continuationGuardrail = this.buildContinuationGuardrail(state);
       const defaultContinueMessage = "Continue the task. Review your prior work above and proceed with any remaining work. If everything is already complete, respond with TASK_COMPLETE.";
       const userMessage = continuationContext.newUserMessage || defaultContinueMessage;
       const userContent = [
@@ -6856,7 +6884,8 @@ Do NOT redo any of the above work.`
   }
 };
 _AgentsEndpoint.AUTO_COMPACT_SUMMARY_PREFIX = "You are continuing a long-running task. Here is a compact summary of prior work:";
-_AgentsEndpoint.FORCED_COMPACT_SUMMARY_PREFIX = "You are continuing a previously completed task. Here is a summary of prior work:";
+_AgentsEndpoint.RESUMED_COMPACT_SUMMARY_PREFIX = "You are continuing a previously saved task. Here is a summary of prior work:";
+_AgentsEndpoint.COMPLETED_COMPACT_SUMMARY_PREFIX = "You are continuing a previously completed task. Here is a summary of prior work:";
 /** Error message patterns from server-side sessions that indicate a transient network failure
  *  (e.g. AI provider connection dropped). These are retried automatically. */
 _AgentsEndpoint.RETRYABLE_SESSION_ERROR_PATTERNS = [
@@ -8232,4 +8261,3 @@ export {
   sanitizeTaskSlug,
   streamEvents
 };
-//# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "1.13.0",
+  "version": "1.13.3",
   "type": "module",
   "description": "TypeScript SDK for the Runtype API with fluent methods. Use it to quickly realize AI products, agents, and workflows.",
   "main": "dist/index.cjs",