awb-agent-manager 1.6.171 → 1.6.172

package/dist/lib/agent-context-contract.d.ts

@@ -0,0 +1,21 @@
+import type { HarnessSpec, RuntimeProfileSpec } from './cli-adapters/base.js';
+import type { TicketRepositoryContext } from './worktree-manager.js';
+export declare const AGENT_CONTEXT_VERSION = "1.2";
+export declare const AGENT_CONTEXT_MAX_CHARS = 16000;
+export interface AgentContextContractInput {
+    ticket: any;
+    role: string;
+    repository?: TicketRepositoryContext;
+    harness?: HarnessSpec | null;
+    runtimeProfile?: RuntimeProfileSpec | null;
+    sessionMode?: 'persistent' | 'stateless' | 'hermes';
+    mcpAvailable?: boolean;
+    effort?: string | null;
+}
+export declare class AgentContextPreflightError extends Error {
+    readonly category: 'ticket' | 'column' | 'repository';
+    constructor(category: 'ticket' | 'column' | 'repository', message: string);
+}
+export declare function redactAgentContextText(value: string): string;
+export declare function buildAgentContextContract(input: AgentContextContractInput): any;
+export declare function renderAgentContextContract(contract: ReturnType<typeof buildAgentContextContract>): string;

package/dist/lib/agent-context-contract.js

@@ -0,0 +1,169 @@
+export const AGENT_CONTEXT_VERSION = '1.2';
+export const AGENT_CONTEXT_MAX_CHARS = 16_000;
+const CONTRACT_JSON_MAX_CHARS = 15_900;
+const COLLECTION_MAX_ITEMS = 20;
+const COLLECTION_ITEM_MAX_CHARS = 800;
+const REDACTED = '[REDACTED]';
+const SENSITIVE_KEY_NAMES = new Set([
+    'authorization',
+    'password',
+    'passwd',
+    'pwd',
+    'token',
+    'accesstoken',
+    'refreshtoken',
+    'apikey',
+    'secret',
+    'clientsecret',
+    'credential',
+    'credentialref',
+    'privatekey',
+]);
+export class AgentContextPreflightError extends Error {
+    category;
+    constructor(category, message) {
+        super(message);
+        this.category = category;
+        this.name = 'AgentContextPreflightError';
+    }
+}
+function compact(value, limit) {
+    return redactAgentContextText(String(value ?? '').replace(/\s+/g, ' ').trim()).slice(0, limit);
+}
+export function redactAgentContextText(value) {
+    return value
+        .replace(/\b(Bearer\s+)[A-Za-z0-9._~+\/-]+=*/gi, `$1${REDACTED}`)
+        .replace(/(["']?(?:authorization|password|passwd|pwd|token|access[_-]?token|refresh[_-]?token|api[_-]?key|secret|client[_-]?secret|credential(?:_ref)?|private[_-]?key)["']?\s*[:=]\s*)(["'])(.*?)(\2)/gi, `$1$2${REDACTED}$4`)
+        .replace(/\b((?:authorization|password|passwd|pwd|token|access[_-]?token|refresh[_-]?token|api[_-]?key|secret|client[_-]?secret|credential(?:_ref)?|private[_-]?key)\s*[:=]\s*)[^\s,;]+/gi, `$1${REDACTED}`)
+        .replace(/\b(?:gh[pousr]_[A-Za-z0-9]{20,}|sk-[A-Za-z0-9_-]{16,})\b/g, REDACTED);
+}
+function isSensitiveKey(key) {
+    return SENSITIVE_KEY_NAMES.has(key.replace(/[^a-z0-9]/gi, '').toLowerCase());
+}
+function boundedCollection(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.slice(-COLLECTION_MAX_ITEMS).map((item) => compact(typeof item === 'string' ? item : JSON.stringify(redactContractValue(item)), COLLECTION_ITEM_MAX_CHARS));
+}
+function redactContractValue(value) {
+    if (typeof value === 'string')
+        return redactAgentContextText(value).slice(0, 2048);
+    if (Array.isArray(value))
+        return value.map(redactContractValue);
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [
+            key,
+            isSensitiveKey(key) ? REDACTED : redactContractValue(item),
+        ]));
+    }
+    return value;
+}
+function enforceContextBudget(contract) {
+    contract = redactContractValue(contract);
+    const order = ['priorProgress', 'relatedTickets', 'recentDecisions', 'unresolvedQuestions', 'verificationCommands'];
+    for (const field of order) {
+        while (JSON.stringify(contract, null, 2).length > CONTRACT_JSON_MAX_CHARS && contract[field].length > 0) {
+            contract[field].shift();
+        }
+    }
+    if (JSON.stringify(contract, null, 2).length > CONTRACT_JSON_MAX_CHARS) {
+        throw new AgentContextPreflightError('ticket', '필수 Agent Context가 전체 크기 제한을 초과했습니다');
+    }
+    return contract;
+}
+function redactRemoteUrl(value) {
+    const raw = compact(value, 2048);
+    if (!raw)
+        return null;
+    try {
+        const parsed = new URL(raw);
+        parsed.username = '';
+        parsed.password = '';
+        parsed.search = '';
+        parsed.hash = '';
+        return parsed.toString();
+    }
+    catch {
+        return raw.replace(/:\/\/[^/@]+@/, '://').replace(/[?#].*$/, '');
+    }
+}
+export function buildAgentContextContract(input) {
+    const ticket = input.ticket;
+    if (!ticket?.id)
+        throw new AgentContextPreflightError('ticket', 'ticket.id가 없습니다');
+    if (!ticket.current_column_id || !ticket.current_column_name) {
+        throw new AgentContextPreflightError('column', '현재 column 확정값이 없습니다');
+    }
+    const repositoryComplete = Boolean(input.repository?.resourceId
+        && input.repository.cwd
+        && input.repository.baseBranch
+        && input.repository.baseSha);
+    if (ticket.__awb_require_repository_context && !repositoryComplete) {
+        throw new AgentContextPreflightError('repository', '연결된 저장소의 준비 결과가 없습니다');
+    }
+    const comments = Array.isArray(ticket.comments) ? ticket.comments.slice(-5) : [];
+    const metadata = ticket.__awb_context_metadata || {};
+    return enforceContextBudget({
+        version: AGENT_CONTEXT_VERSION,
+        authority: ['system_policy', 'role_instructions', 'project_instructions', 'task', 'prior_progress'],
+        assignment: {
+            workspaceId: compact(ticket.workspace_id, 256),
+            boardId: compact(ticket.board_id || ticket.board?.id, 256),
+            ticketId: compact(ticket.id, 256),
+            role: compact(input.role, 120),
+            column: {
+                id: ticket.current_column_id,
+                name: ticket.current_column_name,
+                kind: ticket.current_column_kind || '',
+            },
+        },
+        repository: input.repository ? {
+            resourceId: input.repository.resourceId,
+            cwd: input.repository.cwd,
+            remoteUrl: redactRemoteUrl(input.repository.remoteUrl ?? metadata.remoteUrl),
+            defaultBranch: input.repository.defaultBranch ?? metadata.defaultBranch ?? null,
+            baseBranch: input.repository.baseBranch,
+            baseSha: input.repository.baseSha,
+            fetchedSha: input.repository.fetchedSha ?? input.repository.baseSha,
+            currentSha: input.repository.currentSha || null,
+            currentShaFailure: input.repository.currentShaFailure ?? null,
+            workingBranch: input.repository.workingBranch,
+            dirty: input.repository.dirty,
+            ahead: input.repository.ahead,
+            behind: input.repository.behind,
+            resumed: input.repository.resumed,
+        } : null,
+        execution: {
+            model: input.harness?.model || input.runtimeProfile?.model || '',
+            effort: input.effort ?? metadata.effort ?? null,
+            permissionMode: input.harness?.permission_mode || 'managed-default',
+            sandbox: metadata.sandbox ?? input.harness?.permission_mode ?? 'managed-default',
+            mcpAvailable: input.mcpAvailable !== false,
+            mcpServers: Array.isArray(metadata.mcpServers) ? metadata.mcpServers : [],
+            sessionMode: input.sessionMode || 'stateless',
+            credentialAvailable: metadata.credentialAvailable ?? input.repository?.credentialAvailable ?? null,
+            credentialFailure: metadata.credentialFailure ?? input.repository?.credentialFailure ?? null,
+            requestedGitOperation: metadata.requestedGitOperation ?? null,
+        },
+        relatedTickets: boundedCollection(metadata.relatedTickets),
+        recentDecisions: boundedCollection(metadata.recentDecisions),
+        unresolvedQuestions: boundedCollection(metadata.unresolvedQuestions),
+        verificationCommands: boundedCollection(metadata.verificationCommands),
+        priorProgress: comments.map((comment) => ({
+            at: comment.created_at || '',
+            author: compact(comment.author_name || comment.agent_name || comment.author || 'unknown', 120),
+            content: compact(comment.body || comment.content, 1200),
+        })),
+    });
+}
+export function renderAgentContextContract(contract) {
+    const rendered = [
+        `AWB Agent Context Contract v${contract.version} (provider-neutral, redacted):`,
+        JSON.stringify(contract, null, 2),
+    ].join('\n');
+    if (rendered.length > AGENT_CONTEXT_MAX_CHARS) {
+        throw new AgentContextPreflightError('ticket', '직렬화된 Agent Context가 전체 크기 제한을 초과했습니다');
+    }
+    return rendered;
+}
+//# sourceMappingURL=agent-context-contract.js.map

package/dist/lib/agent-context-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context-contract.js","sourceRoot":"","sources":["../../src/lib/agent-context-contract.ts"],"names":[],"mappings":"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"}

package/dist/lib/event-dispatcher.d.ts

@@ -35,6 +35,7 @@ export declare function resolveBootstrapRepository(baseRepo: unknown, baseBranch
     resourceId: string;
     url: string;
     branch: string;
+    defaultBranch: string | null;
 } | null;
 export declare function parseWorktreeMode(raw: unknown): WorktreeMode | undefined;
 export declare function buildDispatchEnvVars(boardEnv: Record<string, string> | null | undefined, cwd: string | undefined, worktreeMode: WorktreeMode | undefined, ticketId: unknown): Record<string, string>;

package/dist/lib/event-dispatcher.js

@@ -2,11 +2,12 @@ var _a;
 import { log } from './logging.js';
 import { loadAgentInfo } from './config.js';
 import { spawnFailureTracker } from './spawn-failure-tracker.js';
-import { fetchTicketContext, fetchChatRoomHistory, fetchOrdinaryWorkBoardCandidates, fetchAgentRecord, fetchRepositoryCredential, hasNewAgentComment, postFsResponse, postChatRoomMessage, postDispatchAck, provisionManagedAgentApiKey, } from './rest.js';
-import { readApiKey, writeApiKey, writeMcpConfig } from './managed-agent-store.js';
+import { fetchTicketContext, fetchChatRoomHistory, fetchOrdinaryWorkBoardCandidates, fetchAgentRecord, fetchRepositoryCredentialStatus, hasNewAgentComment, postFsResponse, postChatRoomMessage, postDispatchAck, provisionManagedAgentApiKey, } from './rest.js';
+import { readApiKey, readMcpConfigServerNames, writeApiKey, writeMcpConfig } from './managed-agent-store.js';
 import { recordEvent } from './event-log-recorder.js';
 import { prepareChatAttachments } from './chat-attachment-prep.js';
 import { injectWorkFolder, repositoryContextInstructions, worktreeInstructionsFor } from './prompts.js';
+import { AGENT_CONTEXT_VERSION, AgentContextPreflightError } from './agent-context-contract.js';
 import { DispatchBlockerTracker, DispatchBlockTracker, InflightDispatchTracker, PendingDispatchRetry, RoleSpawnSuppressor, classifyWorktreeOutcome, decideCliAuthReadiness, decideCliTrustReadiness, isSafeTicketProvisioningFallback, managedWorktreePath, provisioningPendReason } from './dispatch-preflight.js';
 import { SessionLimitDeferStore } from './session-limit-defer.js';
 import { createAdapter, ADAPTER_CAPABILITIES } from './cli-adapters/index.js';
@@ -207,10 +208,13 @@ export function resolveBootstrapRepository(baseRepo, baseBranch, environment) {
     if (ticketUrl) {
         const branch = (typeof baseBranch === 'string' ? baseBranch.trim() : '')
             || (typeof repo?.default_branch === 'string' ? repo.default_branch.trim() : '');
-        return { resourceId: typeof repo?.id === 'string' ? repo.id : '', url: ticketUrl, branch };
+        const defaultBranch = typeof repo?.default_branch === 'string' && repo.default_branch.trim()
+            ? repo.default_branch.trim()
+            : null;
+        return { resourceId: typeof repo?.id === 'string' ? repo.id : '', url: ticketUrl, branch, defaultBranch };
     }
     const boardRepo = environment?.repositories[0];
-    return boardRepo ? { resourceId: boardRepo.resource_id || '', url: boardRepo.url, branch: boardRepo.branch } : null;
+    return boardRepo ? { resourceId: boardRepo.resource_id || '', url: boardRepo.url, branch: boardRepo.branch, defaultBranch: null } : null;
 }
 export function parseWorktreeMode(raw) {
     return raw === 'per_ticket' || raw === 'shared' ? raw : undefined;
@@ -1035,13 +1039,20 @@ export class EventDispatcher {
             return;
         }
         const selectedRepo = resolveBootstrapRepository(ev.base_repo, ev.base_branch, envConfig);
-        const repoCredential = selectedRepo?.resourceId && agentContext?.agent_id
-            ? await fetchRepositoryCredential(this.#config, selectedRepo.resourceId, agentContext.agent_id, ev.workspace_id)
-            : null;
+        const repositoryContextRequired = Boolean(selectedRepo || ev.base_repo || ev.repository_context_required === true || envConfig?.repositories.length);
+        const repoCredentialStatus = selectedRepo?.resourceId && agentContext?.agent_id
+            ? await fetchRepositoryCredentialStatus(this.#config, selectedRepo.resourceId, agentContext.agent_id, ev.workspace_id)
+            : { credential: null, failure: selectedRepo ? 'credential_lookup_not_applicable' : null };
+        const repoCredential = repoCredentialStatus.credential;
         const worktreeMode = parseWorktreeMode(ev.worktree_mode);
         const applyWorktree = () => this.#applyWorktreeCwd(agentContext, ev.ticket_id, ev.action, worktreeMode, typeof ev.max_concurrent_tickets_per_agent === 'number'
             ? ev.max_concurrent_tickets_per_agent
-            : undefined, selectedRepo ? { ...selectedRepo, credential: repoCredential } : null);
+            : undefined, selectedRepo ? {
+            resourceId: selectedRepo.resourceId,
+            url: selectedRepo.url,
+            branch: selectedRepo.branch,
+            credential: repoCredential,
+        } : null);
         let worktreeProvision = await applyWorktree();
         if (!worktreeProvision.ok && worktreeProvision.reason === 'pool_exhausted') {
             this.#dispatchBlockTracker.record(worktreeProvision.blockerKind || 'worktree:pool_exhausted');
@@ -1224,9 +1235,67 @@ export class EventDispatcher {
             repositoryContextInstructions(worktreeProvision.repositoryContext),
             worktreeProvision.recoveryInstructions || '',
         ].filter(Boolean).join('\n\n');
+        const activeMcpServers = agentContext?.cli === 'hermes'
+            ? ['awb']
+            : await readMcpConfigServerNames(agentContext?.mcp_config_path || '');
+        const attachContextContract = (ticket, sessionMode) => {
+            if (!ticket) {
+                throw new AgentContextPreflightError('ticket', 'ticket context 조회 결과가 없습니다');
+            }
+            ticket.id = ticket.id || ev.ticket_id || '';
+            ticket.current_column_id = ev.current_column_id || ticket.current_column_id || '';
+            ticket.current_column_name = ev.current_column_name || ticket.current_column_name || '';
+            ticket.current_column_kind = ev.current_column_kind || ticket.current_column_kind || '';
+            ticket.__awb_role = ev.action || '';
+            ticket.__awb_enforce_context_contract = true;
+            ticket.__awb_repository_context = worktreeProvision.repositoryContext;
+            const requirePreparedRepository = repositoryContextRequired && !worktreeProvision.recoveryInstructions;
+            ticket.__awb_require_repository_context = requirePreparedRepository;
+            if (requirePreparedRepository && !worktreeProvision.repositoryContext) {
+                throw new AgentContextPreflightError('repository', '연결된 저장소의 준비 결과가 없습니다');
+            }
+            ticket.__awb_harness = harness;
+            ticket.__awb_runtime_profile = runtimeProfile;
+            ticket.__awb_session_mode = sessionMode;
+            ticket.__awb_effort = effortPreset?.id ?? null;
+            ticket.__awb_context_metadata = {
+                remoteUrl: selectedRepo?.url ?? null,
+                defaultBranch: selectedRepo?.defaultBranch ?? worktreeProvision.repositoryContext?.defaultBranch ?? null,
+                credentialAvailable: selectedRepo ? Boolean(repoCredential) : null,
+                credentialFailure: selectedRepo ? repoCredentialStatus.failure : null,
+                sandbox: harness?.permission_mode ?? 'managed-default',
+                requestedGitOperation: ev.action === 'assignee' ? 'commit_and_push' : 'read_only',
+                mcpServers: activeMcpServers,
+                relatedTickets: ticket.related_tickets ?? [],
+                recentDecisions: ticket.recent_decisions ?? [],
+                unresolvedQuestions: ticket.unresolved_questions ?? [],
+                verificationCommands: ticket.verification_commands ?? [],
+            };
+            if (ticket.__awb_repository_context) {
+                Object.assign(ticket.__awb_repository_context, {
+                    remoteUrl: selectedRepo?.url,
+                    defaultBranch: selectedRepo?.defaultBranch ?? ticket.__awb_repository_context.defaultBranch,
+                    fetchedSha: ticket.__awb_repository_context.baseSha,
+                    credentialAvailable: selectedRepo ? Boolean(repoCredential) : null,
+                    credentialFailure: selectedRepo ? repoCredentialStatus.failure : null,
+                });
+            }
+            log(`Agent context v${AGENT_CONTEXT_VERSION}: ticket=${ev.ticket_id} role=${ev.action || ''} ` +
+                `cwd=${worktreeProvision.repositoryContext?.cwd || agentContext?.cwd || ''} ` +
+                `resource=${worktreeProvision.repositoryContext?.resourceId || ''} ` +
+                `branch=${worktreeProvision.repositoryContext?.workingBranch || ''} ` +
+                `base=${worktreeProvision.repositoryContext?.baseSha || ''} ` +
+                `head=${worktreeProvision.repositoryContext?.currentSha || ''} ` +
+                `dirty=${worktreeProvision.repositoryContext?.dirty ?? false} ` +
+                `repositoryRequired=${repositoryContextRequired} ` +
+                `model=${harness?.model || runtimeProfile?.model || agentContext?.model || ''} ` +
+                `permission=${harness?.permission_mode || 'managed-default'} ` +
+                `mcp=${activeMcpServers.join(',') || 'none'} session=${sessionMode}`);
+            return ticket;
+        };
         if (agentContext?.cli === 'hermes') {
             try {
-                const ticket = await fetchTicketContext(this.#config, ev.ticket_id);
+                const ticket = attachContextContract(await fetchTicketContext(this.#config, ev.ticket_id), 'hermes');
                 if (ticket) {
                     ticket.current_column_id = ev.current_column_id || ticket.current_column_id || '';
                     ticket.current_column_name = ev.current_column_name || ticket.current_column_name || '';
@@ -1267,6 +1336,11 @@ export class EventDispatcher {
                 }
             }
             catch (err) {
+                if (err instanceof AgentContextPreflightError) {
+                    log(`Agent context preflight failed: category=${err.category} ticket=${ev.ticket_id} ${err.message}`);
+                    this.#ackDispatch(ev, 'nack', `agent_context_${err.category}_missing`);
+                    return;
+                }
                 log(`Hermes trigger dispatch failed closed: ${err?.code || ''} ${err?.message ?? err}`);
                 this.#ackDispatch(ev, 'nack', err?.code || 'runtime_protocol_error');
             }
@@ -1279,7 +1353,7 @@ export class EventDispatcher {
         let dispatchTriggerInvoked = false;
         if (delegationEnabled && persistentTicket && this.#ticketSessionManager) {
             try {
-                const ticket = await fetchTicketContext(this.#config, ev.ticket_id);
+                const ticket = attachContextContract(await fetchTicketContext(this.#config, ev.ticket_id), 'persistent');
                 if (ticket) {
                     ticket.current_column_id = ev.current_column_id || ticket.current_column_id || '';
                     ticket.current_column_name = ev.current_column_name || ticket.current_column_name || '';
@@ -1333,6 +1407,11 @@ export class EventDispatcher {
                 log(`Ticket session dispatch declined (${result.reason}), falling back to one-shot subagent`);
             }
             catch (err) {
+                if (err instanceof AgentContextPreflightError) {
+                    log(`Agent context preflight failed: category=${err.category} ticket=${ev.ticket_id} ${err.message}`);
+                    this.#ackDispatch(ev, 'nack', `agent_context_${err.category}_missing`);
+                    return;
+                }
                 circuitBreakerClearedByDispatchTrigger = dispatchTriggerInvoked;
                 log(`Ticket session path failed: ${err?.message ?? err}, falling back to one-shot subagent`);
             }
@@ -1340,7 +1419,7 @@ export class EventDispatcher {
         const canDelegate = delegationEnabled && this.#subagentManager && this.#subagentManager.canSpawn();
         if (canDelegate && this.#subagentManager) {
             try {
-                const ticket = await fetchTicketContext(this.#config, ev.ticket_id);
+                const ticket = attachContextContract(await fetchTicketContext(this.#config, ev.ticket_id), 'stateless');
                 if (ticket && selectedRepo) {
                     ticket.base_repo = { id: selectedRepo.resourceId, name: '', url: selectedRepo.url, default_branch: selectedRepo.branch };
                     ticket.base_branch = selectedRepo.branch;
@@ -1417,6 +1496,11 @@ export class EventDispatcher {
                 log(`Subagent spawn declined (${result.reason}); no further fallback in standalone mode`);
             }
             catch (err) {
+                if (err instanceof AgentContextPreflightError) {
+                    log(`Agent context preflight failed: category=${err.category} ticket=${ev.ticket_id} ${err.message}`);
+                    this.#ackDispatch(ev, 'nack', `agent_context_${err.category}_missing`);
+                    return;
+                }
                 log(`Delegation path failed: ${err?.message ?? err}; dropping`);
             }
         }