@the-open-engine/zeroshot 6.38.1 → 6.39.0

package/src/agent/agent-context-builder.js

@@ -1,278 +1,43 @@
-/**
- * AgentContextBuilder - Build agent execution context from ledger
- *
- * Provides:
- * - Context assembly from multiple message sources
- * - Context strategy evaluation (topics, limits, since timestamps)
- * - Prompt injection and formatting
- * - Token-budgeted context packs
- * - Defensive context overflow prevention
- */
-
-// Defensive limit: 500,000 chars ≈ 125k tokens (safe buffer below 200k limit)
-// Prevents "Prompt is too long" errors that kill tasks
+"use strict";
+const contextMetrics = require("./context-metrics");
+const contextPackBuilder = require("./context-pack-builder");
+const agentContextPacks = require("./agent-context-packs");
 const MAX_CONTEXT_CHARS = 500000;
-const {
-  buildContextMetrics,
-  emitContextMetrics,
-  resolveLegacyMaxTokens,
-  updateTotalMetrics,
-} = require('./context-metrics');
-const { buildContextPacks } = require('./context-pack-builder');
-const { buildSourcePack } = require('./agent-context-sources');
-const {
-  buildHeaderContext,
-  buildInstructionsSection,
-  buildJsonSchemaSection,
-  buildLegacyOutputSchemaSection,
-  buildRepoToolingSection,
-  buildTriggeringMessageSection,
-  buildValidatorSkipSection,
-} = require('./agent-context-sections');
-const { buildRequiredQualityGatesSection } = require('./agent-quality-gates-context');
-const { buildCommandProofsSection } = require('./agent-command-proofs-context');
-
-function pushStaticPack({ packs, packId, section, text, order, options = {} }) {
-  if (!text) {
-    return order;
-  }
-
-  packs.push({
-    id: packId,
-    section,
-    priority: 'required',
-    order,
-    preserve: options.preserve || false,
-    render: () => text,
-  });
-
-  return order + 1;
-}
-
-function appendSourcePacks(packs, strategy, params, startingOrder) {
-  if (!Array.isArray(strategy.sources)) {
-    return startingOrder;
-  }
-
-  let order = startingOrder;
-  strategy.sources.forEach((source, index) => {
-    packs.push({ ...buildSourcePack({ source, index, ...params }), order });
-    order += 1;
-  });
-
-  return order;
-}
-
-function buildStaticSections(params) {
-  const {
-    id,
-    role,
-    iteration,
-    config,
-    selectedPrompt,
-    queuedGuidance,
-    messageBus,
-    cluster,
-    triggeringMessage,
-    worktree,
-    isolation,
-  } = params;
-  const isIsolated = !!(worktree?.enabled || isolation?.enabled);
-
-  return {
-    header: buildHeaderContext({ id, role, iteration, isIsolated }),
-    instructions: buildInstructionsSection({ config, selectedPrompt, id }),
-    repoTooling: buildRepoToolingSection({ config, worktree }),
-    commandProofs: buildCommandProofsSection(config),
-    legacyOutputSchema: buildLegacyOutputSchemaSection(config),
-    queuedGuidance: queuedGuidance || '',
-    requiredQualityGates: buildRequiredQualityGatesSection(config),
-    jsonSchema: buildJsonSchemaSection(config),
-    validatorSkip: buildValidatorSkipSection({ role, messageBus, cluster, isolation }),
-    triggeringMessage: buildTriggeringMessageSection(triggeringMessage),
-  };
-}
-
-function buildPacks(params) {
-  const { strategy, messageBus, cluster, lastTaskEndTime, lastAgentStartTime, triggeringMessage } =
-    params;
-  const sections = buildStaticSections(params);
-  const packs = [];
-  let order = 0;
-  const staticPackIds = [
-    'header',
-    'instructions',
-    'repoTooling',
-    'commandProofs',
-    'queuedGuidance',
-    'legacyOutputSchema',
-    'requiredQualityGates',
-    'jsonSchema',
-  ];
-
-  for (const packId of staticPackIds) {
-    order = pushStaticPack({ packs, packId, section: packId, text: sections[packId], order });
-  }
-
-  order = appendSourcePacks(
-    packs,
-    strategy,
-    {
-      messageBus,
-      cluster,
-      lastTaskEndTime,
-      lastAgentStartTime,
-      throughId: params.contextThroughId,
-      triggeringMessageId: triggeringMessage?.id,
-    },
-    order
-  );
-  order = pushStaticPack({
-    packs,
-    packId: 'validatorSkip',
-    section: 'validatorSkip',
-    text: sections.validatorSkip,
-    order,
-  });
-  pushStaticPack({
-    packs,
-    packId: 'triggeringMessage',
-    section: 'triggeringMessage',
-    text: sections.triggeringMessage,
-    order,
-    options: { preserve: true },
-  });
-
-  return packs;
-}
-
-function buildContinuationPacks(params) {
-  const {
-    id,
-    iteration,
-    config,
-    selectedPrompt,
-    queuedGuidance,
-    triggeringMessage,
-    strategy,
-    messageBus,
-    cluster,
-    lastTaskEndTime,
-    lastAgentStartTime,
-    continuationSequence,
-    contextThroughId,
-    previousPromptIdentity,
-    currentPromptIdentity,
-  } = params;
-  const packs = [];
-  let order = 0;
-
-  order = pushStaticPack({
-    packs,
-    packId: 'continuationHeader',
-    section: 'continuationHeader',
-    text: `## Continuation Turn\n\nAgent: ${id}\nIteration: ${iteration}\n\nApply only the new material below while retaining the existing session instructions.\n\n`,
-    order,
-  });
-
-  // Iteration-rule prompts may intentionally change between turns. Static prompts,
-  // repository tooling, ISSUE_OPENED/PLAN_READY sources, and output contracts are
-  // already present in the provider session and must not be replayed.
-  if (config.promptConfig?.type === 'rules' && currentPromptIdentity !== previousPromptIdentity) {
-    order = pushStaticPack({
-      packs,
-      packId: 'iterationInstructions',
-      section: 'iterationInstructions',
-      text: buildInstructionsSection({ config, selectedPrompt, id }),
-      order,
-    });
-  }
-
-  order = pushStaticPack({
-    packs,
-    packId: 'queuedGuidance',
-    section: 'queuedGuidance',
-    text: queuedGuidance || '',
-    order,
-  });
-  order = appendSourcePacks(
-    packs,
-    strategy,
-    {
-      messageBus,
-      cluster,
-      lastTaskEndTime,
-      lastAgentStartTime,
-      afterId: continuationSequence,
-      throughId: contextThroughId,
-      triggeringMessageId: triggeringMessage?.id,
-    },
-    order
-  );
-  pushStaticPack({
-    packs,
-    packId: 'triggeringMessage',
-    section: 'triggeringMessage',
-    text: buildTriggeringMessageSection(triggeringMessage),
-    order,
-    options: { preserve: true },
-  });
-
-  return packs;
-}
-
-/**
- * Build execution context for an agent
- * @param {object} params - Context building parameters
- * @param {string} params.id - Agent ID
- * @param {string} params.role - Agent role
- * @param {number} params.iteration - Current iteration number
- * @param {any} params.config - Agent configuration
- * @param {any} params.messageBus - Message bus for querying ledger
- * @param {any} params.cluster - Cluster object
- * @param {number} [params.lastTaskEndTime] - Timestamp of last task completion
- * @param {number} [params.lastAgentStartTime] - Timestamp when this agent last started work
- * @param {any} params.triggeringMessage - Message that triggered this execution
- * @param {string} [params.selectedPrompt] - Pre-selected prompt from _selectPrompt() (iteration-based)
- * @param {object} [params.worktree] - Worktree isolation state (if running in worktree mode)
- * @param {object} [params.isolation] - Docker isolation state (if running in Docker mode)
- * @returns {string} Assembled context string
- */
+const { buildContextMetrics, emitContextMetrics, resolveLegacyMaxTokens, updateTotalMetrics } = contextMetrics;
+const { buildContextPacks } = contextPackBuilder;
+const { buildAgentContextPacks } = agentContextPacks;
 function buildContext(params) {
-  const strategy = params.config.contextStrategy || { sources: [] };
-  const continuation = params.mode === 'continuation';
-  const packs = continuation
-    ? buildContinuationPacks({ ...params, strategy })
-    : buildPacks({ ...params, strategy });
-  const maxTokens = resolveLegacyMaxTokens(strategy);
-  const packResult = buildContextPacks({
-    packs,
-    maxTokens,
-    maxChars: MAX_CONTEXT_CHARS,
-  });
-
-  const metrics = buildContextMetrics({
-    clusterId: params.cluster.id,
-    agentId: params.id,
-    role: params.role,
-    iteration: params.iteration,
-    triggeringMessage: params.triggeringMessage,
-    strategy: { ...strategy, contextMode: continuation ? 'continuation' : 'full' },
-    packs: packResult.packDecisions,
-    budget: packResult.budget,
-    truncation: packResult.truncation,
-  });
-
-  updateTotalMetrics(metrics, packResult.context.length);
-  emitContextMetrics(metrics, {
-    messageBus: params.messageBus,
-    clusterId: params.cluster.id,
-    agentId: params.id,
-  });
-
-  return packResult.context;
+    const strategy = params.config.contextStrategy || { sources: [] };
+    const continuation = params.mode === 'continuation';
+    const packs = buildAgentContextPacks(params, strategy, continuation);
+    const maxTokens = resolveLegacyMaxTokens(strategy);
+    const packResult = buildContextPacks({
+        packs,
+        maxTokens,
+        maxChars: MAX_CONTEXT_CHARS,
+    });
+    const metrics = buildContextMetrics({
+        clusterId: params.cluster.id,
+        agentId: params.id,
+        role: params.role,
+        iteration: params.iteration,
+        triggeringMessage: params.triggeringMessage,
+        strategy: {
+            ...strategy,
+            contextMode: continuation ? 'continuation' : 'full',
+        },
+        packs: packResult.packDecisions,
+        budget: packResult.budget,
+        truncation: packResult.truncation,
+    });
+    updateTotalMetrics(metrics, packResult.context.length);
+    emitContextMetrics(metrics, {
+        messageBus: params.messageBus,
+        clusterId: params.cluster.id,
+        agentId: params.id,
+    });
+    return packResult.context;
 }
-
 module.exports = {
-  buildContext,
+    buildContext,
 };

package/src/agent/agent-context-builder.ts

@@ -0,0 +1,51 @@
+import contextMetrics = require('./context-metrics');
+import contextPackBuilder = require('./context-pack-builder');
+import agentContextPacks = require('./agent-context-packs');
+
+import type { BuildContextParams, ContextStrategy } from './agent-context-types';
+
+const MAX_CONTEXT_CHARS = 500000;
+const { buildContextMetrics, emitContextMetrics, resolveLegacyMaxTokens, updateTotalMetrics } =
+  contextMetrics;
+const { buildContextPacks } = contextPackBuilder;
+const { buildAgentContextPacks } = agentContextPacks;
+
+function buildContext(params: BuildContextParams): string {
+  const strategy: ContextStrategy = params.config.contextStrategy || { sources: [] };
+  const continuation = params.mode === 'continuation';
+  const packs = buildAgentContextPacks(params, strategy, continuation);
+  const maxTokens = resolveLegacyMaxTokens(strategy);
+  const packResult = buildContextPacks({
+    packs,
+    maxTokens,
+    maxChars: MAX_CONTEXT_CHARS,
+  });
+
+  const metrics = buildContextMetrics({
+    clusterId: params.cluster.id,
+    agentId: params.id,
+    role: params.role,
+    iteration: params.iteration,
+    triggeringMessage: params.triggeringMessage,
+    strategy: {
+      ...strategy,
+      contextMode: continuation ? 'continuation' : 'full',
+    },
+    packs: packResult.packDecisions,
+    budget: packResult.budget,
+    truncation: packResult.truncation,
+  });
+
+  updateTotalMetrics(metrics, packResult.context.length);
+  emitContextMetrics(metrics, {
+    messageBus: params.messageBus,
+    clusterId: params.cluster.id,
+    agentId: params.id,
+  });
+
+  return packResult.context;
+}
+
+export = {
+  buildContext,
+};

package/src/agent/agent-context-environment-sections.js

@@ -0,0 +1,105 @@
+"use strict";
+const fs = require("fs");
+const path = require("path");
+const { readFileSync } = fs;
+const { join, resolve } = path;
+function buildAutonomousSection() {
+    return [
+        '## 🔴 CRITICAL: AUTONOMOUS EXECUTION REQUIRED',
+        '',
+        'You are running in a NON-INTERACTIVE cluster environment.',
+        '',
+        '**NEVER** use AskUserQuestion or ask for user input - there is NO user to respond.',
+        '**NEVER** ask "Would you like me to..." or "Should I..." - JUST DO IT.',
+        '**NEVER** wait for approval or confirmation - MAKE DECISIONS AUTONOMOUSLY.',
+        '',
+        'When facing choices:',
+        '- Choose the option that maintains code quality and correctness',
+        '- If unsure between "fix the code" vs "relax the rules" → ALWAYS fix the code',
+        '- If unsure between "do more" vs "do less" → ALWAYS do what\'s required, nothing more',
+        '',
+    ].join('\n');
+}
+function buildOutputStyleSection() {
+    return [
+        '## 🔴 OUTPUT STYLE - NON-NEGOTIABLE',
+        '',
+        '**ALL OUTPUT: Maximum informativeness, minimum verbosity. NO EXCEPTIONS.**',
+        '',
+        'This applies to EVERYTHING you output:',
+        '- Text responses',
+        '- JSON schema values',
+        '- Reasoning fields',
+        '- Summary fields',
+        '- ALL string values in structured output',
+        '',
+        'Rules:',
+        '- Progress: "Reading auth.ts" NOT "I will now read the auth.ts file..."',
+        '- Tool calls: NO preamble. Call immediately.',
+        '- Schema strings: Dense facts. No filler. No fluff.',
+        '- Errors: DETAILED (stack traces, repro). NEVER compress errors.',
+        '- FORBIDDEN: "I\'ll help...", "Let me...", "I\'m going to...", "Sure!", "Great!", "Certainly!"',
+        '',
+        'Every token costs money. Waste nothing.',
+        '',
+    ].join('\n');
+}
+function buildGitOperationsSection() {
+    return [
+        '## 🚫 GIT OPERATIONS - FORBIDDEN',
+        '',
+        'NEVER commit, push, or create PRs. You only modify files.',
+        'The git-pusher agent handles ALL git operations AFTER validators approve.',
+        '',
+        '- ❌ NEVER run: git add, git commit, git push, gh pr create',
+        '- ❌ NEVER suggest committing changes',
+        '- ✅ Only modify files and publish your completion message when done',
+        '',
+    ].join('\n');
+}
+function buildHeaderContext({ id, role, iteration, isIsolated }) {
+    return [
+        `You are agent "${id}" with role "${role}".`,
+        '',
+        `Iteration: ${iteration}`,
+        '',
+        buildAutonomousSection(),
+        buildOutputStyleSection(),
+        isIsolated ? '' : buildGitOperationsSection(),
+    ]
+        .filter(Boolean)
+        .join('\n');
+}
+function hasIgnoredRepoToolingError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        typeof error.code === 'string' &&
+        ['ENOENT', 'ENOTDIR', 'EACCES', 'EPERM'].includes(error.code));
+}
+function resolveRepoToolingRoots({ config, worktree }) {
+    return Array.from(new Set([worktree?.path, config?.cwd, process.cwd()]
+        .filter((value) => typeof value === 'string' && value.trim() !== '')
+        .map((value) => resolve(value))));
+}
+function buildRepoToolingSection({ config, worktree }) {
+    for (const root of resolveRepoToolingRoots({ config, worktree })) {
+        const skillPath = join(root, '.claude', 'skills', 'repo-tooling', 'SKILL.md');
+        try {
+            const content = readFileSync(skillPath, 'utf8').trim();
+            if (content !== '') {
+                return `${content}\n\n`;
+            }
+        }
+        catch (error) {
+            if (!hasIgnoredRepoToolingError(error)) {
+                throw error;
+            }
+        }
+    }
+    return '';
+}
+module.exports = {
+    buildHeaderContext,
+    buildRepoToolingSection,
+};

package/src/agent/agent-context-environment-sections.ts

@@ -0,0 +1,134 @@
+import fs = require('fs');
+import path = require('path');
+
+import type { AgentContextConfig, WorktreeContext } from './agent-context-types';
+
+interface HeaderContextParams {
+  id: string;
+  role: string;
+  iteration: number;
+  isIsolated: boolean;
+}
+
+interface RepoToolingParams {
+  config?: AgentContextConfig | null | undefined;
+  worktree?: WorktreeContext | null | undefined;
+}
+
+const { readFileSync } = fs;
+const { join, resolve } = path;
+
+function buildAutonomousSection(): string {
+  return [
+    '## 🔴 CRITICAL: AUTONOMOUS EXECUTION REQUIRED',
+    '',
+    'You are running in a NON-INTERACTIVE cluster environment.',
+    '',
+    '**NEVER** use AskUserQuestion or ask for user input - there is NO user to respond.',
+    '**NEVER** ask "Would you like me to..." or "Should I..." - JUST DO IT.',
+    '**NEVER** wait for approval or confirmation - MAKE DECISIONS AUTONOMOUSLY.',
+    '',
+    'When facing choices:',
+    '- Choose the option that maintains code quality and correctness',
+    '- If unsure between "fix the code" vs "relax the rules" → ALWAYS fix the code',
+    '- If unsure between "do more" vs "do less" → ALWAYS do what\'s required, nothing more',
+    '',
+  ].join('\n');
+}
+
+function buildOutputStyleSection(): string {
+  return [
+    '## 🔴 OUTPUT STYLE - NON-NEGOTIABLE',
+    '',
+    '**ALL OUTPUT: Maximum informativeness, minimum verbosity. NO EXCEPTIONS.**',
+    '',
+    'This applies to EVERYTHING you output:',
+    '- Text responses',
+    '- JSON schema values',
+    '- Reasoning fields',
+    '- Summary fields',
+    '- ALL string values in structured output',
+    '',
+    'Rules:',
+    '- Progress: "Reading auth.ts" NOT "I will now read the auth.ts file..."',
+    '- Tool calls: NO preamble. Call immediately.',
+    '- Schema strings: Dense facts. No filler. No fluff.',
+    '- Errors: DETAILED (stack traces, repro). NEVER compress errors.',
+    '- FORBIDDEN: "I\'ll help...", "Let me...", "I\'m going to...", "Sure!", "Great!", "Certainly!"',
+    '',
+    'Every token costs money. Waste nothing.',
+    '',
+  ].join('\n');
+}
+
+function buildGitOperationsSection(): string {
+  return [
+    '## 🚫 GIT OPERATIONS - FORBIDDEN',
+    '',
+    'NEVER commit, push, or create PRs. You only modify files.',
+    'The git-pusher agent handles ALL git operations AFTER validators approve.',
+    '',
+    '- ❌ NEVER run: git add, git commit, git push, gh pr create',
+    '- ❌ NEVER suggest committing changes',
+    '- ✅ Only modify files and publish your completion message when done',
+    '',
+  ].join('\n');
+}
+
+function buildHeaderContext({ id, role, iteration, isIsolated }: HeaderContextParams): string {
+  return [
+    `You are agent "${id}" with role "${role}".`,
+    '',
+    `Iteration: ${iteration}`,
+    '',
+    buildAutonomousSection(),
+    buildOutputStyleSection(),
+    isIsolated ? '' : buildGitOperationsSection(),
+  ]
+    .filter(Boolean)
+    .join('\n');
+}
+
+function hasIgnoredRepoToolingError(error: unknown): boolean {
+  return (
+    typeof error === 'object' &&
+    error !== null &&
+    'code' in error &&
+    typeof error.code === 'string' &&
+    ['ENOENT', 'ENOTDIR', 'EACCES', 'EPERM'].includes(error.code)
+  );
+}
+
+function resolveRepoToolingRoots({ config, worktree }: RepoToolingParams): string[] {
+  return Array.from(
+    new Set(
+      [worktree?.path, config?.cwd, process.cwd()]
+        .filter((value): value is string => typeof value === 'string' && value.trim() !== '')
+        .map((value) => resolve(value))
+    )
+  );
+}
+
+function buildRepoToolingSection({ config, worktree }: RepoToolingParams): string {
+  for (const root of resolveRepoToolingRoots({ config, worktree })) {
+    const skillPath = join(root, '.claude', 'skills', 'repo-tooling', 'SKILL.md');
+
+    try {
+      const content = readFileSync(skillPath, 'utf8').trim();
+      if (content !== '') {
+        return `${content}\n\n`;
+      }
+    } catch (error) {
+      if (!hasIgnoredRepoToolingError(error)) {
+        throw error;
+      }
+    }
+  }
+
+  return '';
+}
+
+export = {
+  buildHeaderContext,
+  buildRepoToolingSection,
+};