@xn-intenton-z2a/agentic-lib 7.1.63 → 7.1.65

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xn-intenton-z2a/agentic-lib",
-  "version": "7.1.63",
+  "version": "7.1.65",
   "description": "Agentic-lib Agentic Coding Systems SDK powering automated GitHub workflows.",
   "type": "module",
   "scripts": {

package/src/actions/agentic-step/copilot.js

@@ -209,9 +209,44 @@ export function supportsReasoningEffort(model) {
   return MODELS_SUPPORTING_REASONING_EFFORT.has(model);
 }
 
+/**
+ * Detect whether an error is an HTTP 429 Too Many Requests (rate limit) response.
+ * The Copilot SDK may surface this as an Error with a status, statusCode, or message.
+ *
+ * @param {unknown} err - The error to test
+ * @returns {boolean}
+ */
+export function isRateLimitError(err) {
+  if (!err || typeof err !== "object") return false;
+  const status = err.status ?? err.statusCode ?? err.code;
+  if (status === 429 || status === "429") return true;
+  const msg = (err.message || "").toLowerCase();
+  return msg.includes("429") || msg.includes("too many requests") || msg.includes("rate limit");
+}
+
+/**
+ * Extract the retry delay in milliseconds from a rate-limit error.
+ * Tries the Retry-After header (seconds) first, then falls back to exponential backoff.
+ *
+ * @param {unknown} err - The error (may have headers or retryAfter)
+ * @param {number} attempt - Zero-based attempt number (0 = first retry)
+ * @param {number} [baseDelayMs=60000] - Base delay for exponential backoff (ms)
+ * @returns {number} Milliseconds to wait before retrying
+ */
+export function retryDelayMs(err, attempt, baseDelayMs = 60000) {
+  const retryAfterHeader =
+    err?.headers?.["retry-after"] ?? err?.retryAfter ?? err?.response?.headers?.["retry-after"];
+  if (retryAfterHeader != null) {
+    const parsed = Number(retryAfterHeader);
+    if (!isNaN(parsed) && parsed > 0) return parsed * 1000;
+  }
+  return baseDelayMs * Math.pow(2, attempt);
+}
+
 /**
  * Run a Copilot SDK session and return the response.
  * Handles the full lifecycle: create client → create session → send → stop.
+ * Retries automatically on HTTP 429 rate-limit responses (up to maxRetries times).
  *
  * @param {Object} options
  * @param {string} options.model - Copilot SDK model name
@@ -221,6 +256,7 @@ export function supportsReasoningEffort(model) {
  * @param {string} [options.githubToken] - Optional token; falls back to COPILOT_GITHUB_TOKEN env var.
  * @param {Object} [options.tuning] - Tuning config (reasoningEffort, infiniteSessions)
  * @param {string} [options.profileName] - Profile name for logging
+ * @param {number} [options.maxRetries=3] - Maximum number of retry attempts on rate-limit errors
  * @returns {Promise<{content: string, tokensUsed: number}>}
  */
 export async function runCopilotTask({
@@ -231,6 +267,38 @@ export async function runCopilotTask({
   githubToken,
   tuning,
   profileName,
+  maxRetries = 3,
+}) {
+  const profile = profileName || "unknown";
+
+  // Attempt 0 is the initial call; attempts 1..maxRetries are retries after 429s.
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      return await _runCopilotTaskOnce({ model, systemMessage, prompt, writablePaths, githubToken, tuning, profileName: profile });
+    } catch (err) {
+      if (isRateLimitError(err) && attempt < maxRetries) {
+        const delayMs = retryDelayMs(err, attempt);
+        core.warning(
+          `[copilot] Rate limit (429) hit — waiting ${Math.round(delayMs / 1000)}s before retry ${attempt + 1}/${maxRetries}`,
+        );
+        await new Promise((resolve) => setTimeout(resolve, delayMs));
+      } else {
+        throw err;
+      }
+    }
+  }
+  // Unreachable: loop always returns or throws, but satisfies static analysis.
+  throw new Error("[copilot] runCopilotTask: all retry attempts exhausted");
+}
+
+async function _runCopilotTaskOnce({
+  model,
+  systemMessage,
+  prompt,
+  writablePaths,
+  githubToken,
+  tuning,
+  profileName,
 }) {
   const profile = profileName || "unknown";
   core.info(

package/src/actions/agentic-step/tasks/maintain-library.js

@@ -25,11 +25,10 @@ export async function maintainLibrary(context) {
     return { outcome: "nop", details: "Mission already complete (MISSION_COMPLETE.md signal)" };
   }
 
-  const sources = readOptionalFile(config.paths.librarySources.path);
-  if (!sources.trim()) {
-    core.info("No sources found. Returning nop.");
-    return { outcome: "nop", details: "No SOURCES.md or empty" };
-  }
+  const sourcesPath = config.paths.librarySources.path;
+  const sources = readOptionalFile(sourcesPath);
+  const mission = readOptionalFile(config.paths.mission.path);
+  const hasUrls = /https?:\/\//.test(sources);
 
   const libraryPath = config.paths.library.path;
   const libraryLimit = config.paths.library.limit;
@@ -37,26 +36,50 @@ export async function maintainLibrary(context) {
 
   const agentInstructions = instructions || "Maintain the library by updating documents from sources.";
 
-  const prompt = [
-    "## Instructions",
-    agentInstructions,
-    "",
-    "## Sources",
-    sources,
-    "",
-    `## Current Library Documents (${libraryDocs.length}/${libraryLimit} max)`,
-    ...libraryDocs.map((d) => `### ${d.name}\n${d.content}`),
-    "",
-    "## Your Task",
-    "1. Read each URL in SOURCES.md and extract technical content.",
-    "2. Create or update library documents based on the source content.",
-    "3. Remove library documents that no longer have corresponding sources.",
-    "",
-    formatPathsSection(writablePaths, config.readOnlyPaths, config),
-    "",
-    "## Constraints",
-    `- Maximum ${libraryLimit} library documents`,
-  ].join("\n");
+  let prompt;
+  if (!hasUrls) {
+    // SOURCES.md has no URLs — ask the LLM to find relevant sources based on the mission
+    core.info("SOURCES.md has no URLs — asking LLM to discover relevant sources from the mission.");
+    prompt = [
+      "## Instructions",
+      agentInstructions,
+      "",
+      "## Mission",
+      mission || "(no mission file found)",
+      "",
+      "## Current SOURCES.md",
+      sources || "(empty)",
+      "",
+      "## Your Task",
+      `SOURCES.md has no URLs yet. Research the mission above and populate ${sourcesPath} with 3-8 relevant reference URLs.`,
+      "Find documentation, tutorials, API references, Wikipedia articles, or npm packages related to the mission's core topic.",
+      "Use web search to discover high-quality, stable URLs (prefer official docs, Wikipedia, MDN, npm).",
+      `Write the URLs as a markdown list in ${sourcesPath}, keeping the existing header text.`,
+      "",
+      formatPathsSection(writablePaths, config.readOnlyPaths, config),
+    ].join("\n");
+  } else {
+    prompt = [
+      "## Instructions",
+      agentInstructions,
+      "",
+      "## Sources",
+      sources,
+      "",
+      `## Current Library Documents (${libraryDocs.length}/${libraryLimit} max)`,
+      ...libraryDocs.map((d) => `### ${d.name}\n${d.content}`),
+      "",
+      "## Your Task",
+      "1. Read each URL in SOURCES.md and extract technical content.",
+      "2. Create or update library documents based on the source content.",
+      "3. Remove library documents that no longer have corresponding sources.",
+      "",
+      formatPathsSection(writablePaths, config.readOnlyPaths, config),
+      "",
+      "## Constraints",
+      `- Maximum ${libraryLimit} library documents`,
+    ].join("\n");
+  }
 
   const { tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
     model,
@@ -67,13 +90,18 @@ export async function maintainLibrary(context) {
     tuning: t,
   });
 
+  const outcomeLabel = hasUrls ? "library-maintained" : "sources-discovered";
+  const detailsMsg = hasUrls
+    ? `Maintained library (${libraryDocs.length} docs, limit ${libraryLimit})`
+    : `Discovered sources for SOURCES.md from mission`;
+
   return {
-    outcome: "library-maintained",
+    outcome: outcomeLabel,
     tokensUsed,
     inputTokens,
     outputTokens,
     cost,
     model,
-    details: `Maintained library (${libraryDocs.length} docs, limit ${libraryLimit})`,
+    details: detailsMsg,
   };
 }

package/src/seeds/zero-SOURCES.md

@@ -4,5 +4,3 @@ Reference material and documentation sources for this project.
 
 Add URLs, papers, API docs, or other reference material here.
 The maintain-library workflow will process these into `library/` documents.
-
-- https://github.com/xn-intenton-z2a/repository0

package/src/seeds/zero-package.json

@@ -16,7 +16,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@xn-intenton-z2a/agentic-lib": "^7.1.63"
+    "@xn-intenton-z2a/agentic-lib": "^7.1.65"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",