@xn-intenton-z2a/agentic-lib 7.1.31 → 7.1.33

package/package.json

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

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

@@ -76,12 +76,27 @@ export async function runCopilotTask({ model, systemMessage, prompt, writablePat
       core.warning(`[copilot] Auth check failed: ${authErr.message}`);
     }
 
+    // Accumulate usage from assistant.usage events (tokens are NOT on the sendAndWait response)
+    let totalInputTokens = 0;
+    let totalOutputTokens = 0;
+    let totalCost = 0;
+
     // Register wildcard event handler for ALL events
     session.on((event) => {
       const eventType = event?.type || "unknown";
       if (eventType === "assistant.message") {
         const preview = event?.data?.content?.substring(0, 100) || "(no content)";
         core.info(`[copilot] event=${eventType}: ${preview}...`);
+      } else if (eventType === "assistant.usage") {
+        const d = event?.data || {};
+        const input = d.inputTokens || 0;
+        const output = d.outputTokens || 0;
+        const cacheRead = d.cacheReadTokens || 0;
+        const cost = d.cost || 0;
+        totalInputTokens += input;
+        totalOutputTokens += output;
+        totalCost += cost;
+        core.info(`[copilot] event=${eventType}: model=${d.model} input=${input} output=${output} cacheRead=${cacheRead} cost=${cost}`);
       } else if (eventType === "session.idle") {
         core.info(`[copilot] event=${eventType}`);
       } else if (eventType === "session.error") {
@@ -94,10 +109,10 @@ export async function runCopilotTask({ model, systemMessage, prompt, writablePat
     core.info("[copilot] Sending prompt and waiting for idle...");
     const response = await session.sendAndWait({ prompt }, 600000);
     core.info(`[copilot] sendAndWait resolved`);
-    const tokensUsed = response?.data?.usage?.totalTokens || 0;
+    const tokensUsed = totalInputTokens + totalOutputTokens;
     const content = response?.data?.content || "";
 
-    return { content, tokensUsed };
+    return { content, tokensUsed, inputTokens: totalInputTokens, outputTokens: totalOutputTokens, cost: totalCost };
   } finally {
     await client.stop();
   }

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

@@ -105,6 +105,9 @@ async function run() {
         prNumber: result.prNumber,
         commitUrl: result.commitUrl,
         tokensUsed: result.tokensUsed,
+        inputTokens: result.inputTokens,
+        outputTokens: result.outputTokens,
+        cost: result.cost,
         model: result.model || model,
         details: result.details,
         workflowUrl: `${process.env.GITHUB_SERVER_URL}/${github.context.repo.owner}/${github.context.repo.repo}/actions/runs/${github.context.runId}`,

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

@@ -19,7 +19,10 @@ import * as core from "@actions/core";
  * @param {string} [options.issueNumber] - Related issue number
  * @param {string} [options.prNumber] - Related PR number
  * @param {string} [options.commitUrl] - URL to the commit
- * @param {number} [options.tokensUsed] - Tokens consumed
+ * @param {number} [options.tokensUsed] - Total tokens consumed (input + output)
+ * @param {number} [options.inputTokens] - Input tokens consumed
+ * @param {number} [options.outputTokens] - Output tokens consumed
+ * @param {number} [options.cost] - Cost reported by Copilot SDK
  * @param {string} [options.model] - Model used
  * @param {string} [options.details] - Additional details
  * @param {string} [options.workflowUrl] - URL to the workflow run
@@ -32,6 +35,9 @@ export function logActivity({
   prNumber,
   commitUrl,
   tokensUsed,
+  inputTokens,
+  outputTokens,
+  cost,
   model,
   details,
   workflowUrl,
@@ -48,7 +54,8 @@ export function logActivity({
   if (prNumber) parts.push(`**PR:** #${prNumber}`);
   if (commitUrl) parts.push(`**Commit:** [${commitUrl}](${commitUrl})`);
   if (model) parts.push(`**Model:** ${model}`);
-  if (tokensUsed !== undefined) parts.push(`**Tokens:** ${tokensUsed}`);
+  if (tokensUsed) parts.push(`**Tokens:** ${tokensUsed} (in: ${inputTokens || 0}, out: ${outputTokens || 0})`);
+  if (cost) parts.push(`**Cost:** ${cost}`);
   if (workflowUrl) parts.push(`**Workflow:** [${workflowUrl}](${workflowUrl})`);
   if (details) {
     parts.push("");

package/src/actions/agentic-step/tasks/discussions.js

@@ -158,7 +158,7 @@ export async function discussions(context) {
   const discussion = await fetchDiscussion(octokit, discussionUrl);
   const prompt = buildPrompt(discussionUrl, discussion, context);
 
-  const { content, tokensUsed } = await runCopilotTask({
+  const { content, tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
     model,
     systemMessage:
       "You are this repository. Respond in first person. Be concise and engaging — never repeat what you said in your last reply. Adapt to the user's language level. Encourage experimentation and suggest interesting projects. When a user requests an action, pass it to the supervisor via [ACTION:request-supervisor]. Protect the mission: push back on requests that contradict it.",
@@ -178,6 +178,9 @@ export async function discussions(context) {
   return {
     outcome: `discussion-${action}`,
     tokensUsed,
+    inputTokens,
+    outputTokens,
+    cost,
     model,
     details: `Action: ${action}${argSuffix}\nReply: ${replyBody.substring(0, 200)}`,
     action,

package/src/actions/agentic-step/tasks/enhance-issue.js

@@ -59,7 +59,7 @@ export async function enhanceIssue(context) {
     "Output ONLY the new issue body text, no markdown code fences.",
   ].join("\n");
 
-  const { content: enhancedBody, tokensUsed } = await runCopilotTask({
+  const { content: enhancedBody, tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
     model,
     systemMessage: "You are a requirements analyst. Enhance GitHub issues with clear, testable acceptance criteria.",
     prompt,
@@ -96,6 +96,9 @@ export async function enhanceIssue(context) {
   return {
     outcome: "issue-enhanced",
     tokensUsed,
+    inputTokens,
+    outputTokens,
+    cost,
     model,
     details: `Enhanced issue #${issueNumber} with acceptance criteria`,
   };

package/src/actions/agentic-step/tasks/fix-code.js

@@ -53,7 +53,7 @@ export async function fixCode(context) {
     "- Make minimal changes to fix the failing tests",
   ].join("\n");
 
-  const { tokensUsed } = await runCopilotTask({
+  const { tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
     model,
     systemMessage: `You are an autonomous coding agent fixing failing tests on PR #${prNumber}. Make minimal, targeted changes to fix the test failures.`,
     prompt,
@@ -65,6 +65,9 @@ export async function fixCode(context) {
   return {
     outcome: "fix-applied",
     tokensUsed,
+    inputTokens,
+    outputTokens,
+    cost,
     model,
     details: `Applied fix for ${failedChecks.length} failing check(s) on PR #${prNumber}`,
   };

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

@@ -62,7 +62,7 @@ export async function maintainFeatures(context) {
     "- Feature files must be markdown with a descriptive filename (e.g. HTTP_SERVER.md)",
   ].join("\n");
 
-  const { tokensUsed } = await runCopilotTask({
+  const { tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
     model,
     systemMessage:
       "You are a feature lifecycle manager. Create, update, and prune feature specification files to keep the project focused on its mission.",
@@ -73,6 +73,9 @@ export async function maintainFeatures(context) {
   return {
     outcome: "features-maintained",
     tokensUsed,
+    inputTokens,
+    outputTokens,
+    cost,
     model,
     details: `Maintained features (${features.length} existing, limit ${featureLimit})`,
   };

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

@@ -50,7 +50,7 @@ export async function maintainLibrary(context) {
     `- Maximum ${libraryLimit} library documents`,
   ].join("\n");
 
-  const { tokensUsed } = await runCopilotTask({
+  const { tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
     model,
     systemMessage:
       "You are a knowledge librarian. Maintain a library of technical documents extracted from web sources.",
@@ -61,6 +61,9 @@ export async function maintainLibrary(context) {
   return {
     outcome: "library-maintained",
     tokensUsed,
+    inputTokens,
+    outputTokens,
+    cost,
     model,
     details: `Maintained library (${libraryDocs.length} docs, limit ${libraryLimit})`,
   };

package/src/actions/agentic-step/tasks/resolve-issue.js

@@ -78,7 +78,7 @@ export async function resolveIssue(context) {
     contributing ? `\n## Contributing Guidelines\n${contributing}` : "",
   ].join("\n");
 
-  const { content: resultContent, tokensUsed } = await runCopilotTask({
+  const { content: resultContent, tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
     model,
     systemMessage: `You are an autonomous coding agent resolving GitHub issue #${issueNumber}. Write clean, tested code. Only modify files listed under "Writable" paths. Read-only paths are for context only.`,
     prompt,
@@ -91,6 +91,9 @@ export async function resolveIssue(context) {
     outcome: "code-generated",
     prNumber: null,
     tokensUsed,
+    inputTokens,
+    outputTokens,
+    cost,
     model,
     commitUrl: null,
     details: `Generated code for issue #${issueNumber}: ${resultContent.substring(0, 200)}`,

package/src/actions/agentic-step/tasks/review-issue.js

@@ -74,7 +74,7 @@ export async function reviewIssue(context) {
     '- "OPEN: <reason>" if the issue is not yet resolved',
   ].join("\n");
 
-  const { content: verdict, tokensUsed } = await runCopilotTask({
+  const { content: verdict, tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
     model,
     systemMessage: "You are a code reviewer determining if GitHub issues have been resolved.",
     prompt,
@@ -108,6 +108,9 @@ export async function reviewIssue(context) {
     return {
       outcome: "issue-closed",
       tokensUsed,
+      inputTokens,
+      outputTokens,
+      cost,
       model,
       details: `Closed issue #${targetIssueNumber}: ${verdict.substring(0, 200)}`,
     };
@@ -117,6 +120,9 @@ export async function reviewIssue(context) {
   return {
     outcome: "issue-still-open",
     tokensUsed,
+    inputTokens,
+    outputTokens,
+    cost,
     model,
     details: `Issue #${targetIssueNumber} remains open: ${verdict.substring(0, 200)}`,
   };

package/src/actions/agentic-step/tasks/supervise.js

@@ -76,6 +76,8 @@ async function gatherContext(octokit, repo, config) {
     workflowsSummary,
     schedule: config.schedule,
     supervisor: config.supervisor,
+    featureIssuesWipLimit: config.featureDevelopmentIssuesWipLimit,
+    maintenanceIssuesWipLimit: config.maintenanceIssuesWipLimit,
   };
 }
 
@@ -108,6 +110,11 @@ function buildPrompt(ctx, agentInstructions) {
     "",
     `### Schedule: ${ctx.schedule}, Supervisor: ${ctx.supervisor}`,
     "",
+    `### Issue Limits`,
+    `Feature development WIP limit: ${ctx.featureIssuesWipLimit}`,
+    `Maintenance WIP limit: ${ctx.maintenanceIssuesWipLimit}`,
+    `Open issues: ${ctx.issuesSummary.length} (capacity for ${Math.max(0, ctx.featureIssuesWipLimit - ctx.issuesSummary.length)} more)`,
+    "",
     "## Available Actions",
     "Pick one or more actions. Output them in the format below.",
     "",
@@ -250,7 +257,7 @@ export async function supervise(context) {
   const agentInstructions = instructions || "You are the supervisor. Decide what actions to take.";
   const prompt = buildPrompt(ctx, agentInstructions);
 
-  const { content, tokensUsed } = await runCopilotTask({
+  const { content, tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
     model,
     systemMessage:
       "You are the supervisor of an autonomous coding repository. Your job is to advance the mission by choosing which workflows to dispatch and which GitHub actions to take. Pick multiple actions when appropriate. Be strategic — consider what's already in progress, what's blocked, and what will make the most impact.",
@@ -279,6 +286,9 @@ export async function supervise(context) {
   return {
     outcome: actions.length === 0 ? "nop" : `supervised:${actions.length}-actions`,
     tokensUsed,
+    inputTokens,
+    outputTokens,
+    cost,
     model,
     details: `Actions: ${results.join(", ")}\nReasoning: ${reasoning.substring(0, 300)}`,
   };

package/src/actions/agentic-step/tasks/transform.js

@@ -85,7 +85,7 @@ export async function transform(context) {
 
   core.info(`Transform prompt length: ${prompt.length} chars`);
 
-  const { content: resultContent, tokensUsed } = await runCopilotTask({
+  const { content: resultContent, tokensUsed, inputTokens, outputTokens, cost } = await runCopilotTask({
     model,
     systemMessage:
       "You are an autonomous code transformation agent. Your goal is to advance the repository toward its mission by making the most impactful change possible in a single step.",
@@ -98,6 +98,9 @@ export async function transform(context) {
   return {
     outcome: "transformed",
     tokensUsed,
+    inputTokens,
+    outputTokens,
+    cost,
     model,
     details: resultContent.substring(0, 500),
   };
@@ -207,6 +210,9 @@ async function transformTdd({
   return {
     outcome: "transformed-tdd",
     tokensUsed: totalTokens,
+    inputTokens: (phase1.inputTokens || 0) + (phase2.inputTokens || 0),
+    outputTokens: (phase1.outputTokens || 0) + (phase2.outputTokens || 0),
+    cost: (phase1.cost || 0) + (phase2.cost || 0),
     model,
     details: `TDD transformation: Phase 1 (failing test) + Phase 2 (implementation). ${testResult.substring(0, 200)}`,
   };

package/src/agents/agent-supervisor.md

@@ -1,25 +1,32 @@
 You are the supervisor of an autonomous coding repository. Your job is to advance the mission by strategically choosing which workflows to dispatch and which GitHub actions to take.
 
+## Priority Order
+
+1. **Create issues when the backlog is low** — if fewer than 3 open issues exist, create at least 1 new issue from the features list or mission before dispatching workflows. The pipeline stalls without issues to work on. Always include descriptive titles and the `automated` label.
+2. **Dispatch transform when ready issues exist** — transform is where code gets written. Always prefer it over maintain when there are open issues with the `ready` label.
+3. **Dispatch review after transform** — when recent workflow runs show a transform completion, dispatch review to close resolved issues and add `ready` labels to new issues. This keeps the pipeline flowing.
+4. **Fix failing PRs** — dispatch fix-code for any PR with failing checks (include pr-number).
+5. **Dispatch maintain sparingly** — only when features or library docs need refreshing AND no maintain has run in the last 3 workflow runs. Maintain is low-value if features are already populated.
+
 ## Decision Framework
 
 1. **Check what's already in progress** — don't duplicate work. If a transform is running, don't dispatch another.
-2. **Prioritise unblocking** — fix failing PRs before starting new features. Close resolved issues to free capacity.
-3. **Balance the pipeline** — maintain a healthy mix of feature work, maintenance, and review.
-4. **Respect limits** — don't create issues beyond the WIP limit. Don't dispatch workflows that will fail due to missing prerequisites.
-5. **Be strategic about timing** — if the schedule is hourly, you can afford to spread work across cycles. If daily, batch more aggressively.
+2. **Prioritise code generation** — the goal is working code. Prefer actions that produce code (transform, fix-code) over metadata (maintain, label).
+3. **Keep the issue pipeline full** — the biggest bottleneck is running out of open issues. Proactively create issues when capacity allows.
+4. **Respect limits** — don't create issues beyond the WIP limit shown in the context. Don't dispatch workflows that will fail due to missing prerequisites.
 
 ## When to use each action
 
-- **dispatch:agent-flow-transform** — When there are open issues ready to work on and no transform is currently running.
-- **dispatch:agent-flow-maintain** — When features or library docs are below their limits, or haven't been refreshed recently.
-- **dispatch:agent-flow-review** — When there are open automated issues that might be resolved, or issues that need better acceptance criteria.
+- **github:create-issue** — When open issues < WIP limit. Derive the issue title from unimplemented features or mission goals. Always include relevant labels (`automated`, `enhancement`).
+- **dispatch:agent-flow-transform** — When there are open issues with the `ready` label and no transform is currently running.
+- **dispatch:agent-flow-review** — After observing a recent transform completion, or when there are unenhanced issues needing the `ready` label.
 - **dispatch:agent-flow-fix-code** — When a specific PR has failing checks. Always include the pr-number.
+- **dispatch:agent-flow-maintain** — When features are below their limit AND no maintain appears in the last 3 workflow runs.
 - **dispatch:agent-discussions-bot** — When you want to proactively engage in discussions or respond to a user request.
-- **github:create-issue** — When you identify a gap between the mission and current features. Always include a descriptive title and relevant labels.
 - **github:label-issue** — When an issue needs better categorisation for prioritisation.
 - **github:close-issue** — When an issue is clearly resolved or no longer relevant.
 - **respond:discussions** — When replying to a user request that came through the discussions bot. Include the discussion URL and a clear message.
-- **nop** — When everything is running smoothly and no intervention is needed.
+- **nop** — When everything is running optimally: transform is active, issues are flowing, no failures.
 
 ## Guidelines
 
@@ -28,3 +35,4 @@ You are the supervisor of an autonomous coding repository. Your job is to advanc
 - When a user has made a request via discussions, prioritise responding to it.
 - Don't dispatch the same workflow twice in one cycle.
 - If recent workflow runs show failures, investigate before dispatching more work.
+- Creating an issue + dispatching review in the same cycle is a good pattern: review will enhance the new issue with acceptance criteria and the `ready` label.

package/src/seeds/zero-agentic-lib.toml

@@ -27,7 +27,7 @@ test = "npm test"
 start = "npm run start"
 
 [limits]
-feature-issues = 2
+feature-issues = 5
 maintenance-issues = 1
 attempts-per-branch = 3
 attempts-per-issue = 2

package/src/seeds/zero-package.json

@@ -14,7 +14,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@xn-intenton-z2a/agentic-lib": "^7.1.31"
+    "@xn-intenton-z2a/agentic-lib": "^7.1.33"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.0",

package/src/workflows/agent-supervisor-schedule.yml

@@ -48,7 +48,7 @@ jobs:
               weekly: '0 6 * * 1',
               daily: '0 6 * * *',
               hourly: '0 * * * *',
-              continuous: '*/10 * * * *',
+              continuous: '*/15 * * * *',
             };
 
             let content = fs.readFileSync(workflowPath, 'utf8');

package/src/workflows/agent-supervisor.yml

@@ -23,6 +23,8 @@ on:
       - test
       - agent-flow-transform
       - agent-flow-fix-code
+      - agent-flow-maintain
+      - agent-flow-review
       - ci-automerge
     types:
       - completed
@@ -172,6 +174,21 @@ jobs:
               core.warning(`Stale PR check failed: ${err.message}`);
             }
 
+            // ─── 3. Successful transform → dispatch review ────────────────
+            try {
+              if (workflowRun && workflowName === 'agent-flow-transform' && conclusion === 'success') {
+                core.info('Transform completed successfully — dispatching review to close resolved issues and enhance new ones.');
+                await github.rest.actions.createWorkflowDispatch({
+                  owner, repo,
+                  workflow_id: 'agent-flow-review.yml',
+                  ref: 'main',
+                  inputs: {},
+                });
+              }
+            } catch (err) {
+              core.warning(`Post-transform review dispatch failed: ${err.message}`);
+            }
+
   # ─── Proactive: LLM-driven strategic decisions ───────────────────────
   supervise:
     needs: params