@runtypelabs/sdk 1.9.0 → 1.9.2

package/dist/index.cjs

@@ -2856,6 +2856,57 @@ var executionPhase = {
 };
 function classifyVariant(message) {
   const lower = message.toLowerCase();
+  const modificationVerbs = [
+    "fix",
+    "update",
+    "change",
+    "modify",
+    "edit",
+    "refactor",
+    "improve",
+    "add to",
+    "remove",
+    "delete",
+    "rename",
+    "migrate"
+  ];
+  const hasModificationVerb = modificationVerbs.some(
+    (v) => lower.startsWith(v) || new RegExp(`\\b${v}\\b`).test(lower)
+  );
+  const creationPatterns = [
+    /^create\b/,
+    /^build\b/,
+    /^make\b/,
+    /^generate\b/,
+    /^scaffold\b/,
+    /^set up\b/,
+    /^setup\b/,
+    /^bootstrap\b/,
+    /^initialize\b/,
+    /^init\b/,
+    /^write a\b/,
+    /^write an\b/,
+    /^implement a\b/,
+    /^implement an\b/,
+    /^start a\b/,
+    /^start an\b/,
+    /^new\b/
+  ];
+  const hasCreationStart = creationPatterns.some((p) => p.test(lower));
+  const creationVerbs = [
+    "build",
+    "create",
+    "make",
+    "generate",
+    "scaffold",
+    "implement"
+  ];
+  const hasCreationVerb = creationVerbs.some(
+    (v) => new RegExp(`\\b${v}\\b`).test(lower)
+  );
+  if ((hasCreationStart || hasCreationVerb) && !hasModificationVerb) {
+    return "create";
+  }
   const externalVerbs = [
     "fetch",
     "browse",
@@ -2895,49 +2946,9 @@ function classifyVariant(message) {
   ];
   const hasExternalVerb = externalVerbs.some((v) => lower.includes(v));
   const hasExternalTarget = externalTargets.some((t) => lower.includes(t));
-  const modificationVerbs = [
-    "fix",
-    "update",
-    "change",
-    "modify",
-    "edit",
-    "refactor",
-    "improve",
-    "add to",
-    "remove",
-    "delete",
-    "rename",
-    "migrate"
-  ];
-  const hasModificationVerb = modificationVerbs.some(
-    (v) => lower.startsWith(v) || new RegExp(`\\b${v}\\b`).test(lower)
-  );
   if (hasExternalVerb && hasExternalTarget && !hasModificationVerb) {
     return "external";
   }
-  const creationPatterns = [
-    /^create\b/,
-    /^build\b/,
-    /^make\b/,
-    /^generate\b/,
-    /^scaffold\b/,
-    /^set up\b/,
-    /^setup\b/,
-    /^bootstrap\b/,
-    /^initialize\b/,
-    /^init\b/,
-    /^write a\b/,
-    /^write an\b/,
-    /^implement a\b/,
-    /^implement an\b/,
-    /^start a\b/,
-    /^start an\b/,
-    /^new\b/
-  ];
-  const hasCreationStart = creationPatterns.some((p) => p.test(lower));
-  if (hasCreationStart && !hasModificationVerb) {
-    return "create";
-  }
   return "modify";
 }
 async function generateBootstrapContext(message, localTools, variant) {
@@ -3084,7 +3095,9 @@ var deployPhase = {
       "  4. If the deploy fails, read the error output, fix the code, and call deploy_sandbox again.",
       "  5. The sandbox is persistent \u2014 subsequent calls reuse the same sandbox.",
       "  6. When the deploy succeeds and the preview URL is live, tell the user and end with TASK_COMPLETE.",
-      "  7. For apps with HTML frontends, use the `files` parameter to write HTML/CSS/JS to separate files and serve them with express.static, rather than embedding HTML in template literals."
+      "  7. For apps with HTML frontends, use the `files` parameter to write HTML/CSS/JS to separate files and serve them with express.static, rather than embedding HTML in template literals.",
+      "  8. If the prompt asks for a multi-route app or names concrete output paths (for example `public/v1/index.html`), mirror that structure in the `files` payload.",
+      "  9. If the prompt asks you to verify specific routes after deploy, check those paths against the preview URL before TASK_COMPLETE and iterate until they work."
     ].join("\n");
   },
   buildToolGuidance(_state) {
@@ -3092,6 +3105,7 @@ var deployPhase = {
       "Your primary tool is deploy_sandbox. Call it with code, packageJson, language, and port.",
       "Do NOT use write_file, read_file, search_repo, glob_files, tree_directory, or list_directory \u2014 you are deploying to a sandbox, not editing local files.",
       "You may use run_sandbox_code for quick one-off script execution if needed.",
+      "For static or multi-page sites, use `files` to create the requested folder structure and have the server expose those routes.",
       "When deploy_sandbox returns successfully with a previewUrl, tell the user the URL and end with TASK_COMPLETE."
     ];
   },
@@ -3141,34 +3155,7 @@ var deployPhase = {
     return void 0;
   }
 };
-function classifyVariant2(message) {
-  const lower = message.toLowerCase();
-  const deployPatterns = [
-    /\bdeploy\b/,
-    /\bsandbox\b/,
-    /\bpreview\s*url\b/,
-    /\blive\s*preview\b/,
-    /\bhost\b.*\b(?:app|server|api|site)\b/,
-    /\b(?:app|server|api|site)\b.*\bhost\b/,
-    /\brun\b.*\b(?:server|web\s*app)\b/,
-    /\blaunch\b.*\b(?:app|server|api|site)\b/,
-    /\bstart\b.*\b(?:server|web\s*app)\b/
-  ];
-  if (deployPatterns.some((p) => p.test(lower))) {
-    return "deploy";
-  }
-  const webAppPatterns = [
-    /\bbuild\b.*\b(?:web\s*app|website|api|server|express|hono|fastify)\b/,
-    /\bcreate\b.*\b(?:web\s*app|website|api|server|express|hono|fastify)\b/,
-    /\bmake\b.*\b(?:web\s*app|website|api|server|express|hono|fastify)\b/
-  ];
-  const repoPatterns = [
-    /\b(?:file|repo|repository|codebase|project|directory|folder)\b/,
-    /\b(?:edit|modify|update|fix|refactor|change)\b/
-  ];
-  if (webAppPatterns.some((p) => p.test(lower)) && !repoPatterns.some((p) => p.test(lower))) {
-    return "deploy";
-  }
+function classifyVariant2(_message) {
   return "deploy";
 }
 var deployWorkflow = {
@@ -4280,6 +4267,12 @@ function dispatchAgentEvent(event, callbacks) {
     case "agent_tool_delta":
       callbacks.onToolDelta?.(typedData);
       break;
+    case "agent_tool_input_delta":
+      callbacks.onToolInputDelta?.(typedData);
+      break;
+    case "agent_tool_input_complete":
+      callbacks.onToolInputComplete?.(typedData);
+      break;
     case "agent_tool_complete":
       callbacks.onToolComplete?.(typedData);
       break;
@@ -4663,6 +4656,15 @@ var _AgentsEndpoint = class _AgentsEndpoint {
             String(current).slice(0, 200)
           );
         }
+        const localExecutionStartedAt = (/* @__PURE__ */ new Date()).toISOString();
+        const localExecutionStartedAtMs = Date.now();
+        callbacks?.onLocalToolExecutionStart?.({
+          executionId,
+          toolCallId: toolId,
+          toolName,
+          parameters: parsedParams,
+          startedAt: localExecutionStartedAt
+        });
         let toolResult;
         try {
           toolResult = await toolDef.execute(parsedParams);
@@ -4672,20 +4674,24 @@ var _AgentsEndpoint = class _AgentsEndpoint {
         toolMessages.push({
           role: "assistant",
           content: "",
-          toolCalls: [{
-            toolCallId: toolId,
-            toolName,
-            args: parsedParams
-          }]
+          toolCalls: [
+            {
+              toolCallId: toolId,
+              toolName,
+              args: parsedParams
+            }
+          ]
         });
         toolMessages.push({
           role: "tool",
           content: "",
-          toolResults: [{
-            toolCallId: toolId,
-            toolName,
-            result: toolResult
-          }]
+          toolResults: [
+            {
+              toolCallId: toolId,
+              toolName,
+              result: toolResult
+            }
+          ]
         });
         pauseCount += 1;
         const toolNameCount = (toolNameCounts[toolName] || 0) + 1;
@@ -4717,6 +4723,16 @@ var _AgentsEndpoint = class _AgentsEndpoint {
           recentActionKeys
         });
         if (forcedCompleteEvent) {
+          callbacks?.onLocalToolExecutionComplete?.({
+            executionId,
+            toolCallId: toolId,
+            toolName,
+            parameters: parsedParams,
+            result: toolResult,
+            success: true,
+            completedAt: (/* @__PURE__ */ new Date()).toISOString(),
+            durationMs: Date.now() - localExecutionStartedAtMs
+          });
           if (!forcedCompleteEvent.finalOutput && accumulatedOutput) {
             forcedCompleteEvent.finalOutput = accumulatedOutput;
           }
@@ -4736,6 +4752,16 @@ var _AgentsEndpoint = class _AgentsEndpoint {
           const error = await resumeResponse.json().catch(() => ({ error: "Unknown error" }));
           throw new Error(error.error || `HTTP ${resumeResponse.status}`);
         }
+        callbacks?.onLocalToolExecutionComplete?.({
+          executionId,
+          toolCallId: toolId,
+          toolName,
+          parameters: parsedParams,
+          result: toolResult,
+          success: true,
+          completedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          durationMs: Date.now() - localExecutionStartedAtMs
+        });
         currentBody = resumeResponse.body;
         continue;
       }
@@ -4958,7 +4984,10 @@ var _AgentsEndpoint = class _AgentsEndpoint {
     }
     const currentPhase = workflow.phases.find((p) => p.name === state.workflowPhase);
     if (currentPhase?.canAcceptCompletion) {
-      return currentPhase.canAcceptCompletion(state, sessionTrace);
+      return currentPhase.canAcceptCompletion(
+        state,
+        sessionTrace
+      );
     }
     return true;
   }
@@ -5030,7 +5059,10 @@ var _AgentsEndpoint = class _AgentsEndpoint {
   compactOneResult(tr, taskName, mode) {
     if (typeof tr.result === "string" && tr.result.startsWith("[")) return tr;
     if (mode === "hot-tail") {
-      return { ...tr, result: this.offloadToolResult(taskName, tr.toolCallId, tr.toolName, tr.result) };
+      return {
+        ...tr,
+        result: this.offloadToolResult(taskName, tr.toolCallId, tr.toolName, tr.result)
+      };
     }
     return { ...tr, result: `[Output from ${tr.toolName} masked \u2014 re-run the tool if needed]` };
   }
@@ -5129,7 +5161,9 @@ var _AgentsEndpoint = class _AgentsEndpoint {
       }
     };
     const baseDir = sourcePath ? this.dirnameOfCandidatePath(sourcePath) : "";
-    for (const match of text.matchAll(/(?:href|src)=["']([^"']+\.(?:html|tsx|ts|jsx|js|md|json))["']/gi)) {
+    for (const match of text.matchAll(
+      /(?:href|src)=["']([^"']+\.(?:html|tsx|ts|jsx|js|md|json))["']/gi
+    )) {
       const target = match[1] || "";
       const resolved = baseDir ? this.joinCandidatePath(baseDir, target) : target;
       add(resolved, `linked from ${sourcePath || "discovery result"} via ${target}`);
@@ -5169,7 +5203,9 @@ var _AgentsEndpoint = class _AgentsEndpoint {
     if (!bootstrapContext) return void 0;
     const candidates = this.parseSearchRepoResultForCandidates(bootstrapContext);
     if (candidates.length === 0) return void 0;
-    return candidates.sort((a, b) => this.scoreCandidatePath(b.path) - this.scoreCandidatePath(a.path))[0];
+    return candidates.sort(
+      (a, b) => this.scoreCandidatePath(b.path) - this.scoreCandidatePath(a.path)
+    )[0];
   }
   sanitizeResumeState(resumeState, taskName) {
     if (!resumeState) return void 0;
@@ -5276,10 +5312,17 @@ var _AgentsEndpoint = class _AgentsEndpoint {
               isArtifactPath: this.isMarathonArtifactPath.bind(this),
               isDiscoveryTool: this.isDiscoveryToolName.bind(this)
             };
-            const blockedMessage = currentPhase.interceptToolCall(toolName, args, ctx);
+            const blockedMessage = currentPhase.interceptToolCall(
+              toolName,
+              args,
+              ctx
+            );
             if (blockedMessage) {
               if (isWriteLikeTool) trace.attemptedWrite = true;
-              this.pushToolTraceEntry(trace, `${toolName}${pathArg}${queryArg}${patternArg} -> ${blockedMessage}`);
+              this.pushToolTraceEntry(
+                trace,
+                `${toolName}${pathArg}${queryArg}${patternArg} -> ${blockedMessage}`
+              );
               return blockedMessage;
             }
           }
@@ -5336,7 +5379,10 @@ var _AgentsEndpoint = class _AgentsEndpoint {
             verificationResult.error || verificationResult.output
           ].filter(Boolean).join(" | ").slice(0, 240) : this.summarizeTextBlockForTrace(result);
           const resultSuffix = summarizedResult ? ` -> ${summarizedResult}` : "";
-          this.pushToolTraceEntry(trace, `${toolName}${pathArg}${queryArg}${patternArg}${resultSuffix}`);
+          this.pushToolTraceEntry(
+            trace,
+            `${toolName}${pathArg}${queryArg}${patternArg}${resultSuffix}`
+          );
           const textResult = typeof result === "string" ? result : "";
           if (toolName === "read_file" && normalizedPathArg && normalizedBestCandidatePath && normalizedPathArg === normalizedBestCandidatePath && (trace.bestCandidateWritten || state.bestCandidateNeedsVerification)) {
             trace.bestCandidateVerified = true;
@@ -5427,7 +5473,9 @@ var _AgentsEndpoint = class _AgentsEndpoint {
     return [
       "Session working memory:",
       ...flags.length > 0 ? [`- ${flags.join("; ")}`] : [],
-      ...trace.bestCandidatePath ? [`- best candidate: ${trace.bestCandidatePath}${trace.bestCandidateReason ? ` (${trace.bestCandidateReason})` : ""}`] : [],
+      ...trace.bestCandidatePath ? [
+        `- best candidate: ${trace.bestCandidatePath}${trace.bestCandidateReason ? ` (${trace.bestCandidateReason})` : ""}`
+      ] : [],
       ...lines
     ].join("\n").slice(0, 1200);
   }
@@ -5501,12 +5549,7 @@ var _AgentsEndpoint = class _AgentsEndpoint {
       }
     };
     const lowerMessage = message.toLowerCase();
-    const phraseHints = [
-      "agent editor",
-      "theme.html",
-      "/theme.html",
-      "style it visually"
-    ];
+    const phraseHints = ["agent editor", "theme.html", "/theme.html", "style it visually"];
     for (const hint of phraseHints) {
       if (lowerMessage.includes(hint.toLowerCase())) push(hint);
     }
@@ -5533,7 +5576,9 @@ var _AgentsEndpoint = class _AgentsEndpoint {
     for (const match of message.matchAll(/\b([a-z0-9]+(?:\s+[a-z0-9]+){1,2})\b/gi)) {
       const phrase = (match[1] || "").toLowerCase();
       const words = phrase.split(" ");
-      if (words.some((word) => ["editor", "page", "screen", "view", "route", "component"].includes(word))) {
+      if (words.some(
+        (word) => ["editor", "page", "screen", "view", "route", "component"].includes(word)
+      )) {
         push(match[1] || "");
       }
     }
@@ -5563,7 +5608,11 @@ var _AgentsEndpoint = class _AgentsEndpoint {
       }
       if (globTool && /\./.test(query)) {
         try {
-          const result = await globTool.execute({ pattern: `**/${query}`, path: ".", maxResults: 5 });
+          const result = await globTool.execute({
+            pattern: `**/${query}`,
+            path: ".",
+            maxResults: 5
+          });
           const summary = this.summarizeTextBlockForTrace(result, 3);
           if (summary && !summary.startsWith("No files matched")) {
             lines.push(`glob_files "**/${query}": ${summary}`);
@@ -5664,7 +5713,9 @@ var _AgentsEndpoint = class _AgentsEndpoint {
           state.isCreationTask || state.workflowVariant === "external"
         );
       }
-      const bootstrapCandidate = this.extractBestCandidateFromBootstrapContext(state.bootstrapContext);
+      const bootstrapCandidate = this.extractBestCandidateFromBootstrapContext(
+        state.bootstrapContext
+      );
       if (bootstrapCandidate) {
         state.bestCandidatePath = bootstrapCandidate.path;
         state.bestCandidateReason = bootstrapCandidate.reason;
@@ -5673,7 +5724,12 @@ var _AgentsEndpoint = class _AgentsEndpoint {
     }
     for (let session = 0; session < maxSessions; session++) {
       const sessionTrace = this.createEmptyToolTrace();
-      const sessionLocalTools = this.wrapLocalToolsForTrace(options.localTools, sessionTrace, state, workflow);
+      const sessionLocalTools = this.wrapLocalToolsForTrace(
+        options.localTools,
+        sessionTrace,
+        state,
+        workflow
+      );
       const sessionCallbacks = this.createTraceCallbacks(options.streamCallbacks, sessionTrace);
       const continuationContext = session === 0 && options.previousMessages ? {
         previousMessages: options.previousMessages,
@@ -5704,16 +5760,13 @@ var _AgentsEndpoint = class _AgentsEndpoint {
           onContextNotice: options.onContextNotice
         }
       );
-      const {
-        messages,
-        requestContextManagement,
-        pendingNativeCompactionEvent
-      } = preparedSession;
+      const { messages, requestContextManagement, pendingNativeCompactionEvent } = preparedSession;
       let sessionResult;
       const sessionData = {
         messages,
         debugMode: options.debugMode,
         model: options.model,
+        ...options.reasoning !== void 0 ? { reasoning: options.reasoning } : {},
         ...options.toolIds?.length ? { tools: { toolIds: options.toolIds } } : {},
         ...requestContextManagement ? { contextManagement: requestContextManagement } : {}
       };
@@ -5831,7 +5884,10 @@ var _AgentsEndpoint = class _AgentsEndpoint {
         ).slice(-20);
       }
       if (sessionTrace.actionKeys.length > 0) {
-        state.recentActionKeys = [...state.recentActionKeys || [], ...sessionTrace.actionKeys].slice(-20);
+        state.recentActionKeys = [
+          ...state.recentActionKeys || [],
+          ...sessionTrace.actionKeys
+        ].slice(-20);
       }
       if (sessionTrace.planWritten) {
         state.planWritten = true;
@@ -5860,7 +5916,11 @@ var _AgentsEndpoint = class _AgentsEndpoint {
         const latestSession = state.sessions[state.sessions.length - 1];
         if (latestSession) {
           latestSession.outputPreview = [phaseTransitionSummary, "", latestSession.outputPreview].join("\n").slice(0, 300);
-          latestSession.toolTraceSummary = [phaseTransitionSummary, "", latestSession.toolTraceSummary || ""].join("\n").trim().slice(0, 1200);
+          latestSession.toolTraceSummary = [
+            phaseTransitionSummary,
+            "",
+            latestSession.toolTraceSummary || ""
+          ].join("\n").trim().slice(0, 1200);
         }
       }
       if (!state.messages) state.messages = [];
@@ -6097,7 +6157,9 @@ var _AgentsEndpoint = class _AgentsEndpoint {
       details.builtinToolSchemas
     );
     const reservedOutputTokens = this.resolveReservedOutputTokens(details.contextLimitTokens);
-    const effectiveInputBudgetTokens = this.resolveEffectiveInputBudgetTokens(details.contextLimitTokens);
+    const effectiveInputBudgetTokens = this.resolveEffectiveInputBudgetTokens(
+      details.contextLimitTokens
+    );
     const summaryTokens = details.summaryText ? this.estimateTextTokens(
       `${_AgentsEndpoint.AUTO_COMPACT_SUMMARY_PREFIX}
 
@@ -6218,7 +6280,9 @@ Do NOT redo any of the above work.`
       "",
       "Changed Files / Candidate Paths",
       ...candidatePaths.length > 0 ? candidatePaths.map((candidatePath) => `- ${candidatePath}`) : ["- No candidate paths recorded yet."],
-      ...state.planPath ? [`- ${state.workflowVariant === "external" ? "Report path" : "Plan path"}: ${state.planPath}`] : [],
+      ...state.planPath ? [
+        `- ${state.workflowVariant === "external" ? "Report path" : "Plan path"}: ${state.planPath}`
+      ] : [],
       ...state.planWritten ? ["- Planning artifact has been written."] : [],
       ...state.bestCandidateReason ? [`- Best candidate rationale: ${state.bestCandidateReason}`] : [],
       "",
@@ -6240,10 +6304,14 @@ Do NOT redo any of the above work.`
     ].join("\n");
   }
   isAssistantToolCallMessage(message) {
-    return Boolean(message?.role === "assistant" && message.toolCalls && message.toolCalls.length > 0);
+    return Boolean(
+      message?.role === "assistant" && message.toolCalls && message.toolCalls.length > 0
+    );
   }
   isToolResultMessage(message) {
-    return Boolean(message?.role === "tool" && message.toolResults && message.toolResults.length > 0);
+    return Boolean(
+      message?.role === "tool" && message.toolResults && message.toolResults.length > 0
+    );
   }
   /**
    * Replay only complete adjacent tool-call/result pairs so provider validation
@@ -6391,7 +6459,9 @@ Do NOT redo any of the above work.`
         "Use these tools to inspect the existing repository and make real file edits \u2014 not just code in your response."
       ],
       ...toolGuidanceLines,
-      ...isDeployWorkflow ? [] : isExternalTask2 ? ["Use write_file only if you want to save the final deliverable into the workspace."] : ["Always use write_file to save your output so the user can run it immediately."]
+      ...isDeployWorkflow ? [] : isExternalTask2 ? [
+        "Use write_file only if you want to save the final deliverable into the workspace."
+      ] : ["Always use write_file to save your output so the user can run it immediately."]
     ].join("\n") : "";
     const builtinToolNames = builtinToolIds?.map((id) => id.replace(/^builtin:/, ""));
     const builtinToolsBlock = builtinToolNames?.length ? [
@@ -6413,9 +6483,12 @@ 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 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 = [
+        continuationGuardrail,
+        "",
         userMessage,
         phaseBlock,
         toolsBlock,
@@ -6426,10 +6499,6 @@ Do NOT redo any of the above work.`
       ].join("\n");
       const fullHistoryMessages = [
         ...replayHistoryMessages,
-        {
-          role: "system",
-          content: "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."
-        },
         {
           role: "user",
           content: userContent
@@ -6500,7 +6569,15 @@ Do NOT redo any of the above work.`
       };
     }
     if (sessionIndex === 0) {
-      const content2 = [originalMessage, phaseBlock, toolsBlock, bootstrapBlock, candidateBlock, "", multiSessionInstruction].join("\n");
+      const content2 = [
+        originalMessage,
+        phaseBlock,
+        toolsBlock,
+        bootstrapBlock,
+        candidateBlock,
+        "",
+        multiSessionInstruction
+      ].join("\n");
       return {
         messages: [{ role: "user", content: content2 }],
         requestContextManagement
@@ -6551,10 +6628,7 @@ Do NOT redo any of the above work.`
         contextLimitTokens: compactionOptions?.contextLimitTokens
       });
       await maybeEmitToolDefinitionWarning(breakdown);
-      const messages = [
-        ...historyMessages,
-        { role: "user", content: continuationContent }
-      ];
+      const messages = [...historyMessages, { role: "user", content: continuationContent }];
       if (resolvedStrategy === "summary_fallback" && typeof compactionOptions?.autoCompactTokenThreshold === "number" && compactionOptions.autoCompactTokenThreshold > 0 && breakdown.estimatedInputTokens >= compactionOptions.autoCompactTokenThreshold) {
         return {
           messages: await this.buildCompactHistoryMessagesWithLifecycle(