@the-open-engine/zeroshot 6.38.1 → 6.39.1

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,
+};

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

@@ -0,0 +1,165 @@
+"use strict";
+const contextSections = require("./agent-context-sections");
+const contextSources = require("./agent-context-sources");
+const qualityGatesContext = require("./agent-quality-gates-context");
+const commandProofsContext = require("./agent-command-proofs-context");
+const { buildHeaderContext, buildInstructionsSection, buildJsonSchemaSection, buildLegacyOutputSchemaSection, buildRepoToolingSection, buildTriggeringMessageSection, buildValidatorSkipSection, } = contextSections;
+const { buildSourcePack } = contextSources;
+const { buildRequiredQualityGatesSection } = qualityGatesContext;
+const { buildCommandProofsSection } = commandProofsContext;
+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\n` +
+            'Apply only the new material below while retaining the existing session instructions.\n\n',
+        order,
+    });
+    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;
+}
+function buildAgentContextPacks(params, strategy, continuation) {
+    const contextPacksParams = { ...params, strategy };
+    return continuation ? buildContinuationPacks(contextPacksParams) : buildPacks(contextPacksParams);
+}
+module.exports = {
+    buildAgentContextPacks,
+};

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

@@ -0,0 +1,296 @@
+import contextSections = require('./agent-context-sections');
+import contextSources = require('./agent-context-sources');
+import qualityGatesContext = require('./agent-quality-gates-context');
+import commandProofsContext = require('./agent-command-proofs-context');
+
+import type {
+  BuildContextParams,
+  ContextMessageBus,
+  ContextCluster,
+  ContextStrategy,
+} from './agent-context-types';
+import type { ContextPack } from './context-pack-types';
+
+interface StaticPackOptions {
+  preserve?: boolean;
+}
+
+interface StaticPackParams {
+  packs: ContextPack[];
+  packId: string;
+  section: string;
+  text: string | null | undefined;
+  order: number;
+  options?: StaticPackOptions;
+}
+
+interface SourcePackContext {
+  messageBus: ContextMessageBus;
+  cluster: ContextCluster;
+  lastTaskEndTime?: number | null | undefined;
+  lastAgentStartTime?: number | null | undefined;
+  afterId?: unknown;
+  throughId?: unknown;
+  triggeringMessageId?: unknown;
+}
+
+interface ContextPacksParams extends BuildContextParams {
+  strategy: ContextStrategy;
+}
+
+interface StaticSections {
+  header: string;
+  instructions: string;
+  repoTooling: string;
+  commandProofs: string;
+  legacyOutputSchema: string;
+  queuedGuidance: string;
+  requiredQualityGates: string;
+  jsonSchema: string;
+  validatorSkip: string;
+  triggeringMessage: string;
+}
+
+const {
+  buildHeaderContext,
+  buildInstructionsSection,
+  buildJsonSchemaSection,
+  buildLegacyOutputSchemaSection,
+  buildRepoToolingSection,
+  buildTriggeringMessageSection,
+  buildValidatorSkipSection,
+} = contextSections;
+const { buildSourcePack } = contextSources;
+const { buildRequiredQualityGatesSection } = qualityGatesContext;
+const { buildCommandProofsSection } = commandProofsContext;
+
+function pushStaticPack({
+  packs,
+  packId,
+  section,
+  text,
+  order,
+  options = {},
+}: StaticPackParams): number {
+  if (!text) {
+    return order;
+  }
+
+  packs.push({
+    id: packId,
+    section,
+    priority: 'required',
+    order,
+    preserve: options.preserve || false,
+    render: () => text,
+  });
+
+  return order + 1;
+}
+
+function appendSourcePacks(
+  packs: ContextPack[],
+  strategy: ContextStrategy,
+  params: SourcePackContext,
+  startingOrder: number
+): number {
+  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: BuildContextParams): StaticSections {
+  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: ContextPacksParams): ContextPack[] {
+  const { strategy, messageBus, cluster, lastTaskEndTime, lastAgentStartTime, triggeringMessage } =
+    params;
+  const sections = buildStaticSections(params);
+  const packs: ContextPack[] = [];
+  let order = 0;
+  const staticPackIds: (keyof StaticSections)[] = [
+    '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: ContextPacksParams): ContextPack[] {
+  const {
+    id,
+    iteration,
+    config,
+    selectedPrompt,
+    queuedGuidance,
+    triggeringMessage,
+    strategy,
+    messageBus,
+    cluster,
+    lastTaskEndTime,
+    lastAgentStartTime,
+    continuationSequence,
+    contextThroughId,
+    previousPromptIdentity,
+    currentPromptIdentity,
+  } = params;
+  const packs: ContextPack[] = [];
+  let order = 0;
+
+  order = pushStaticPack({
+    packs,
+    packId: 'continuationHeader',
+    section: 'continuationHeader',
+    text:
+      `## Continuation Turn\n\nAgent: ${id}\nIteration: ${iteration}\n\n` +
+      'Apply only the new material below while retaining the existing session instructions.\n\n',
+    order,
+  });
+
+  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;
+}
+
+function buildAgentContextPacks(
+  params: BuildContextParams,
+  strategy: ContextStrategy,
+  continuation: boolean
+): ContextPack[] {
+  const contextPacksParams = { ...params, strategy };
+  return continuation ? buildContinuationPacks(contextPacksParams) : buildPacks(contextPacksParams);
+}
+
+export = {
+  buildAgentContextPacks,
+};