sdd-agent-platform 0.3.0 → 0.4.1

package/node_modules/@sdd-agent-platform/core/dist/execution/agent-execution-records.js

@@ -0,0 +1,170 @@
+import { createHash } from 'node:crypto';
+import { readdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { AGENT_EXECUTION_RECORD_CONTRACT_VERSION, TEAM_SESSION_RECORD_CONTRACT_VERSION } from '../contracts.js';
+import { getLegacyAgentExecutionsDir, getLegacyTeamSessionsDir } from '../runtime-paths.js';
+import { exists } from '../storage/json-io.js';
+import { listRuntimeAgentExecutions, listRuntimeTeamSessions, recordRuntimeAgentExecution, recordRuntimeTeamSession } from '../storage/runtime-store.js';
+import { BUILT_IN_SKILL_CAPABILITIES } from '../registries/skill-capabilities.js';
+export async function writeAgentExecutionRecord(projectRoot, record) {
+    await recordRuntimeAgentExecution(projectRoot, record);
+    return record;
+}
+export async function writeTeamSessionRecord(projectRoot, record) {
+    await recordRuntimeTeamSession(projectRoot, record);
+    return record;
+}
+export async function listAgentExecutionRecords(projectRoot, runId) {
+    const runtimeRecords = await listRuntimeAgentExecutions(projectRoot, runId);
+    if (runtimeRecords.length > 0) {
+        return runtimeRecords;
+    }
+    const recordsDir = getLegacyAgentExecutionsDir(projectRoot, runId);
+    if (!await exists(recordsDir)) {
+        return [];
+    }
+    const entries = await readdir(recordsDir, { withFileTypes: true });
+    const records = [];
+    for (const entry of entries.filter((candidate) => candidate.isFile() && candidate.name.endsWith('.json'))) {
+        try {
+            const raw = await readFile(path.join(recordsDir, entry.name), 'utf8');
+            records.push(JSON.parse(raw));
+        }
+        catch {
+            continue;
+        }
+    }
+    return records.sort((left, right) => left.createdAt.localeCompare(right.createdAt) || left.executionId.localeCompare(right.executionId));
+}
+export async function listTeamSessionRecords(projectRoot, runId) {
+    const runtimeRecords = await listRuntimeTeamSessions(projectRoot, runId);
+    if (runtimeRecords.length > 0) {
+        return runtimeRecords;
+    }
+    const recordsDir = getLegacyTeamSessionsDir(projectRoot, runId);
+    if (!await exists(recordsDir)) {
+        return [];
+    }
+    const entries = await readdir(recordsDir, { withFileTypes: true });
+    const records = [];
+    for (const entry of entries.filter((candidate) => candidate.isFile() && candidate.name.endsWith('.json'))) {
+        try {
+            const raw = await readFile(path.join(recordsDir, entry.name), 'utf8');
+            records.push(JSON.parse(raw));
+        }
+        catch {
+            continue;
+        }
+    }
+    return records.sort((left, right) => left.createdAt.localeCompare(right.createdAt) || left.teamId.localeCompare(right.teamId));
+}
+export function routeRecordSnapshot(route) {
+    return {
+        version: route.version,
+        category: route.category,
+        recommendedProfile: route.recommendedProfile,
+        autonomyCeiling: route.autonomyCeiling,
+        requiredCapabilities: route.requiredCapabilities,
+        blockedReason: route.blockedReason
+    };
+}
+export function routeRecordId(route, profile) {
+    const content = JSON.stringify({
+        version: route.version,
+        taskId: route.taskId,
+        branch: route.branch,
+        category: route.category,
+        profile,
+        recommendedProfile: route.recommendedProfile,
+        autonomyCeiling: route.autonomyCeiling,
+        requiredCapabilities: route.requiredCapabilities,
+        toolPermissionProfile: route.toolPermission?.profile ?? null,
+        toolPermissionPolicy: route.toolPermission?.policy ?? null,
+        blockedReason: route.blockedReason
+    });
+    return createHash('sha256').update(content).digest('hex').slice(0, 16);
+}
+export function sourceAttributionForCapabilities(capabilityIds, route) {
+    return capabilityIds.map((capabilityId) => {
+        const routeSource = route?.registrySources?.find((source) => source.kind === 'skill_capability' && source.id === capabilityId);
+        if (routeSource) {
+            return `${capabilityId}:${routeSource.sourceId ?? routeSource.origin}`;
+        }
+        const capability = BUILT_IN_SKILL_CAPABILITIES.find((candidate) => candidate.id === capabilityId);
+        return capability ? `${capability.id}:${capability.sourceRef}` : capabilityId;
+    });
+}
+export function executionProfile(agent, route) {
+    const normalized = normalizeAgentToken(agent);
+    return route.allowedProfiles.find((profile) => normalizeAgentToken(profile) === normalized) ?? toAgentProfileId(agent) ?? route.recommendedProfile ?? 'implementer';
+}
+export function buildAgentExecutionRecord(input) {
+    const now = new Date().toISOString();
+    const profile = executionProfile(input.agent, input.route);
+    return {
+        version: AGENT_EXECUTION_RECORD_CONTRACT_VERSION,
+        executionId: toSafeRecordId(input.delegationId ?? `${input.taskId}-${input.agent}`),
+        runId: input.runId,
+        taskId: input.taskId,
+        profile,
+        category: input.route.category,
+        host: 'sdd-cli',
+        hostSessionId: input.runId,
+        hostTaskId: input.delegationId ?? null,
+        modelPolicy: input.route.modelPolicy,
+        toolPermission: input.route.toolPermission,
+        capabilitiesUsed: input.route.requiredCapabilities,
+        sourceAttribution: sourceAttributionForCapabilities(input.route.requiredCapabilities, input.route),
+        artifacts: input.artifactPath ? [input.artifactPath] : input.ingestion?.artifactPath ? [input.ingestion.artifactPath] : [],
+        status: input.status,
+        delegationId: input.delegationId ?? null,
+        queueItemId: input.queueItemId ?? null,
+        ingestionStatus: input.ingestion?.status ?? null,
+        resultStatus: input.ingestion?.resultStatus ?? null,
+        routeId: routeRecordId(input.route, profile),
+        routeDecision: routeRecordSnapshot(input.route),
+        evidenceSummary: input.evidenceSummary,
+        createdAt: now,
+        updatedAt: now
+    };
+}
+export function buildTeamSessionRecord(input) {
+    const now = new Date().toISOString();
+    return {
+        version: TEAM_SESSION_RECORD_CONTRACT_VERSION,
+        teamId: toSafeRecordId(`team-${input.runId}-${input.taskId ?? 'branch'}`),
+        runId: input.runId,
+        taskId: input.taskId,
+        status: input.status,
+        chiefProfile: input.route.teamMode.chiefProfile,
+        memberProfiles: input.route.teamMode.memberProfiles,
+        hostLayout: null,
+        teamMode: input.route.teamMode,
+        waves: input.route.teamMode.allowedWaves,
+        messages: [{
+                sender: 'runtime',
+                receiver: 'team',
+                taskRef: input.taskId,
+                artifactRefs: input.artifacts,
+                blocker: input.route.teamMode.blockedReason,
+                evidenceSummary: input.evidenceSummary,
+                createdAt: now
+            }],
+        artifacts: input.artifacts,
+        evidenceSummary: input.evidenceSummary,
+        createdAt: now,
+        updatedAt: now
+    };
+}
+export function toSafeRecordId(value) {
+    const sanitized = value.replace(/[^A-Za-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '');
+    return sanitized || 'record';
+}
+function normalizeAgentToken(value) {
+    return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '');
+}
+function toAgentProfileId(agent) {
+    const normalized = normalizeAgentToken(agent);
+    return normalized.length > 0 ? normalized : null;
+}
+//# sourceMappingURL=agent-execution-records.js.map

package/node_modules/@sdd-agent-platform/core/dist/execution/agent-execution-records.js.map

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

package/node_modules/@sdd-agent-platform/core/dist/execution/background-executor.d.ts

@@ -0,0 +1,44 @@
+import { BACKGROUND_EXECUTOR_CONTRACT_VERSION } from '../contracts.js';
+import { type ContractValidationIssue } from '../contracts/issues.js';
+import type { ArtifactResultIngestionRecord } from '../artifacts/ingestion.js';
+import type { DelegationQueueItem } from '../run-state/run-index.js';
+import { type HostInvocationCommandOptions, type HostInvocationResult } from './host-invocation.js';
+export type BackgroundExecutorStatus = 'claimed' | 'completed' | 'failed' | 'blocked';
+export interface BackgroundExecutorRunOptions {
+    branch?: string;
+    runId?: string;
+    taskId: string;
+    agent?: string;
+    workerAdapterId?: string;
+    artifactPath?: string;
+    delegationId?: string;
+    timeoutSeconds?: number;
+    hostInvocation?: HostInvocationCommandOptions;
+    approved?: boolean;
+}
+export interface BackgroundExecutorResult {
+    version: typeof BACKGROUND_EXECUTOR_CONTRACT_VERSION;
+    runId: string;
+    taskId: string;
+    delegationId: string | null;
+    queueItemId: string | null;
+    workerAdapterId: string;
+    status: BackgroundExecutorStatus;
+    artifactPath: string | null;
+    ingestion: ArtifactResultIngestionRecord | null;
+    hostInvocation: HostInvocationResult | null;
+    issues: ContractValidationIssue[];
+    message: string;
+}
+export interface BackgroundExecutorInspection {
+    version: typeof BACKGROUND_EXECUTOR_CONTRACT_VERSION;
+    runId: string;
+    delegations: DelegationQueueItem[];
+    artifactIngestions: ArtifactResultIngestionRecord[];
+    runningDelegations: number;
+    terminalDelegations: number;
+    valid: boolean;
+    issues: ContractValidationIssue[];
+}
+export declare function inspectBackgroundExecutor(projectRoot: string, runId: string): Promise<BackgroundExecutorInspection>;
+export declare function runBackgroundExecutor(projectRoot: string, options: BackgroundExecutorRunOptions): Promise<BackgroundExecutorResult>;

package/node_modules/@sdd-agent-platform/core/dist/execution/background-executor.js

@@ -0,0 +1,249 @@
+import { BACKGROUND_EXECUTOR_CONTRACT_VERSION } from '../contracts.js';
+import { contractIssue } from '../contracts/issues.js';
+import { ingestArtifactResult, inspectArtifactResultIngestions } from '../artifacts/ingestion.js';
+import { createDelegationRecord, isDelegationTerminal } from '../delegation/validation.js';
+import { listDelegationQueueItems } from '../delegation/queue.js';
+import { persistDelegation } from '../delegation/run-state.js';
+import { evaluateGovernancePolicy } from '../governance/policy.js';
+import { getRunRelativeArtifactPath, toArtifactRootRelativePath } from '../runtime-paths.js';
+import { appendEvent } from '../run-state/events.js';
+import { createRun, readRunState, writeRunState } from '../run-state/run-state.js';
+import { inspectWorkerAdapterContract } from '../registries/worker-adapters.js';
+import { resolveSddContext } from '../sdd-docs/context.js';
+import { bindRunStateToTaskContext } from '../sdd-docs/run-binding.js';
+import { inspectSddTask } from '../sdd-docs/task-inspection.js';
+import { parseSddBranch } from '../sdd-docs/task-parser.js';
+import { routeSddTask } from '../router/route-sdd-task.js';
+import { ensureExecutionOrchestration, completeExecutionOrchestration } from '../orchestration/runtime.js';
+import { inspectWorktreeIsolation } from '../worktree/isolation.js';
+import { buildAgentExecutionRecord, writeAgentExecutionRecord } from './agent-execution-records.js';
+import { invokeClaudeCodeSubagentHost } from './host-invocation.js';
+export async function inspectBackgroundExecutor(projectRoot, runId) {
+    const [snapshot, ingestionInspection] = await Promise.all([
+        listDelegationQueueItems(projectRoot, { runId }),
+        inspectArtifactResultIngestions(projectRoot, runId)
+    ]);
+    const issues = [...ingestionInspection.issues];
+    return {
+        version: BACKGROUND_EXECUTOR_CONTRACT_VERSION,
+        runId,
+        delegations: snapshot.items,
+        artifactIngestions: ingestionInspection.records,
+        runningDelegations: snapshot.items.filter((item) => item.status === 'RUNNING').length,
+        terminalDelegations: snapshot.items.filter((item) => isDelegationTerminal(item.status)).length,
+        valid: issues.length === 0,
+        issues
+    };
+}
+export async function runBackgroundExecutor(projectRoot, options) {
+    const context = await resolveSddContext(projectRoot, options.branch ? { branch: options.branch, branchSource: 'cli_option' } : {});
+    const branch = context.partition;
+    const agent = options.agent ?? 'implementer';
+    const workerAdapterId = options.workerAdapterId ?? 'sdd-cli-task-worker';
+    const model = await parseSddBranch(projectRoot, branch);
+    const inspected = inspectSddTask(model, options.taskId);
+    const runState = options.runId ? await readRunState(projectRoot, options.runId) : await createRun(projectRoot);
+    const boundRunState = await bindRunStateToTaskContext(projectRoot, runState, context, model, inspected.task ?? null, options.taskId);
+    const runId = boundRunState.runId;
+    const worker = await inspectWorkerAdapterContract(projectRoot, workerAdapterId);
+    const issues = [];
+    if (!worker) {
+        issues.push(contractIssue('workerAdapterId', `Worker adapter ${workerAdapterId} is not declared.`, 'Use a worker adapter declared by the Phase 3.5 worker adapter contract.'));
+    }
+    if (worker?.kind === 'manual_handoff') {
+        issues.push(contractIssue('workerAdapterId', `Worker adapter ${workerAdapterId} is manual handoff only.`, 'Use a runnable worker adapter for background executor claim/run/ingest.'));
+    }
+    const route = await routeSddTask(projectRoot, { taskId: options.taskId, branch, agent, approved: options.approved });
+    if (!inspected.task || inspected.gaps.some((gap) => gap.severity === 'blocking')) {
+        issues.push(...inspected.gaps.map((gap) => contractIssue(gap.field, gap.message, gap.recommendation)));
+    }
+    if (route.blockedReason) {
+        issues.push(contractIssue('agent_router', route.blockedReason, route.nextAction));
+    }
+    if (route.toolPermission?.policy === 'deny') {
+        issues.push(contractIssue('tool_permission', 'Agent router denied required tool permission for this task.', 'Change task scope, tool policy, or route through a permitted profile before execution.'));
+    }
+    const decision = await inspectWorktreeIsolation(projectRoot, { branch, taskId: options.taskId, capabilityId: worker?.capabilityId ?? 'sdd-cli' });
+    if (decision.mode === 'blocked' || decision.mode === 'manual' && options.approved !== true) {
+        for (const reason of decision.reasons) {
+            issues.push(contractIssue('isolation', reason, 'Resolve isolation gates or pass --approved after explicit user approval before running the background executor.'));
+        }
+    }
+    const delegationId = options.delegationId ?? `B-${options.taskId}-${agent}-001`;
+    const expectedArtifact = options.artifactPath ? getRunRelativeArtifactPath(toArtifactRootRelativePath(options.artifactPath)) : `artifacts/${agent}-${options.taskId}.md`;
+    const existingDelegation = boundRunState.delegations[delegationId];
+    if (existingDelegation && isDelegationTerminal(existingDelegation.status)) {
+        issues.push(contractIssue('delegationId', `Delegation ${delegationId} is already terminal.`, 'Create a new delegation id for retry instead of reopening a terminal delegation.'));
+    }
+    const governance = await evaluateGovernancePolicy(projectRoot, {
+        operation: 'background_executor',
+        runId,
+        taskId: options.taskId,
+        workerAdapterId,
+        riskTags: inspected.task?.risk ?? [],
+        approved: options.approved,
+        excludeQueueItemId: `${runId}:${delegationId}`
+    });
+    if (!governance.allowed) {
+        issues.push(...governance.issues);
+        await appendEvent(projectRoot, runId, { event: 'governance_policy_blocked', runId, summary: `Governance policy blocked background executor for ${options.taskId}`, data: { taskId: options.taskId, delegationId, decision: governance } });
+    }
+    if (issues.length > 0) {
+        await writeAgentExecutionRecord(projectRoot, buildAgentExecutionRecord({
+            runId,
+            taskId: options.taskId,
+            agent,
+            route,
+            status: 'blocked',
+            delegationId,
+            queueItemId: null,
+            artifactPath: options.artifactPath ?? null,
+            evidenceSummary: `Background executor blocked before delegation claim with ${issues.length} issue(s).`
+        }));
+        await appendEvent(projectRoot, runId, { event: 'background_executor_blocked', runId, summary: `Background executor blocked for ${options.taskId}`, data: { taskId: options.taskId, delegationId, issues } });
+        return {
+            version: BACKGROUND_EXECUTOR_CONTRACT_VERSION,
+            runId,
+            taskId: options.taskId,
+            delegationId: null,
+            queueItemId: null,
+            workerAdapterId,
+            status: 'blocked',
+            artifactPath: options.artifactPath ?? null,
+            ingestion: null,
+            issues,
+            hostInvocation: null,
+            message: 'Background executor blocked before delegation claim.'
+        };
+    }
+    await ensureExecutionOrchestration(projectRoot, model, inspected.task ?? null, {
+        branch,
+        runId,
+        taskId: options.taskId,
+        agent,
+        workerKind: worker?.kind ?? null,
+        delegationId,
+        expectedArtifact,
+        dispatchBlocking: worker?.kind === 'claude_code_subagent'
+    });
+    const delegation = existingDelegation ?? createDelegationRecord({
+        delegationId,
+        task: options.taskId,
+        agent,
+        runMode: 'background',
+        blocking: true,
+        requiredForPhaseExit: true,
+        expectedArtifact,
+        timeoutSeconds: options.timeoutSeconds
+    });
+    await persistDelegation(projectRoot, runId, delegation);
+    const claimedState = await readRunState(projectRoot, runId);
+    await writeRunState(projectRoot, {
+        ...claimedState,
+        status: 'running',
+        phase: 'background',
+        currentTask: options.taskId
+    });
+    await appendEvent(projectRoot, runId, {
+        event: existingDelegation ? 'background_executor_resumed' : 'delegation_started',
+        runId,
+        summary: `Background executor claimed ${delegationId} for ${options.taskId}`,
+        data: { delegationId, taskId: options.taskId, agent, workerAdapterId, expectedArtifact, queueItemId: `${runId}:${delegationId}` }
+    });
+    await writeAgentExecutionRecord(projectRoot, buildAgentExecutionRecord({
+        runId,
+        taskId: options.taskId,
+        agent,
+        route,
+        status: 'claimed',
+        delegationId,
+        queueItemId: `${runId}:${delegationId}`,
+        evidenceSummary: `Background executor claimed ${delegationId}; host execution remains provenance until artifact ingestion.`
+    }));
+    let hostInvocation = null;
+    let artifactPath = options.artifactPath ?? null;
+    if (!artifactPath && worker?.kind === 'claude_code_subagent') {
+        hostInvocation = await invokeClaudeCodeSubagentHost({
+            projectRoot,
+            runId,
+            taskId: options.taskId,
+            agent,
+            delegationId,
+            queueItemId: `${runId}:${delegationId}`,
+            expectedArtifact,
+            timeoutSeconds: options.timeoutSeconds,
+            commandOptions: options.hostInvocation
+        });
+        artifactPath = hostInvocation.artifactPath;
+        await appendEvent(projectRoot, runId, {
+            event: 'host_invocation_completed',
+            runId,
+            summary: `Host invocation completed for ${delegationId}`,
+            data: { delegationId, taskId: options.taskId, workerAdapterId, artifactPath, exitCode: hostInvocation.exitCode, signal: hostInvocation.signal, timedOut: hostInvocation.timedOut }
+        });
+    }
+    if (!artifactPath) {
+        return {
+            version: BACKGROUND_EXECUTOR_CONTRACT_VERSION,
+            runId,
+            taskId: options.taskId,
+            delegationId,
+            queueItemId: `${runId}:${delegationId}`,
+            workerAdapterId,
+            status: 'claimed',
+            artifactPath: null,
+            ingestion: null,
+            hostInvocation: null,
+            issues: [],
+            message: `Background executor claimed ${delegationId}; provide ${expectedArtifact} and rerun with --artifact to ingest terminal evidence.`
+        };
+    }
+    const ingestion = await ingestArtifactResult(projectRoot, runId, { delegationId, artifactPath });
+    const executorStatus = ingestion.valid ? ingestion.record.delegationStatus === 'COMPLETED' ? 'completed' : 'failed' : 'blocked';
+    await completeExecutionOrchestration(projectRoot, model, inspected.task ?? null, {
+        branch,
+        runId,
+        taskId: options.taskId,
+        agent,
+        workerKind: worker?.kind ?? null,
+        delegationId,
+        expectedArtifact,
+        artifactPath: ingestion.record.artifactPath,
+        resultStatus: ingestion.record.resultStatus,
+        completed: executorStatus === 'completed',
+        dispatchBlocking: worker?.kind === 'claude_code_subagent'
+    });
+    const ingestedState = await readRunState(projectRoot, runId);
+    await writeRunState(projectRoot, {
+        ...ingestedState,
+        status: executorStatus === 'completed' ? 'completed' : executorStatus === 'failed' ? 'failed' : 'blocked',
+        phase: 'background',
+        currentTask: options.taskId
+    });
+    await writeAgentExecutionRecord(projectRoot, buildAgentExecutionRecord({
+        runId,
+        taskId: options.taskId,
+        agent,
+        route,
+        status: executorStatus,
+        delegationId,
+        queueItemId: `${runId}:${delegationId}`,
+        ingestion: ingestion.record,
+        evidenceSummary: ingestion.valid ? `Background executor ingested terminal artifact for ${delegationId}.` : `Background executor artifact ingestion blocked for ${delegationId}.`
+    }));
+    return {
+        version: BACKGROUND_EXECUTOR_CONTRACT_VERSION,
+        runId,
+        taskId: options.taskId,
+        delegationId,
+        queueItemId: `${runId}:${delegationId}`,
+        workerAdapterId,
+        status: executorStatus,
+        artifactPath: ingestion.record.artifactPath,
+        ingestion: ingestion.record,
+        hostInvocation,
+        issues: ingestion.record.issues,
+        message: ingestion.valid ? `Background executor ingested terminal artifact for ${delegationId}.` : `Background executor artifact ingestion blocked for ${delegationId}.`
+    };
+}
+//# sourceMappingURL=background-executor.js.map

package/node_modules/@sdd-agent-platform/core/dist/execution/background-executor.js.map

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

package/node_modules/@sdd-agent-platform/core/dist/execution/foreground-subagents.d.ts

@@ -0,0 +1,55 @@
+import { type RuntimeRef } from '../contracts.js';
+import { type ContractValidationIssue } from '../contracts/issues.js';
+import { type ArtifactResultIngestionResult } from '../artifacts/ingestion.js';
+import { type HostInvocationCommandOptions, type HostInvocationResult } from './host-invocation.js';
+export type ForegroundSubagentStatus = 'completed' | 'failed' | 'blocked';
+export interface ForegroundSubagentRunOptions {
+    branch?: string;
+    runId?: string;
+    taskId: string;
+    agents: string[];
+    timeoutSeconds?: number;
+    approved?: boolean;
+    hostInvocation?: HostInvocationCommandOptions;
+}
+export interface ForegroundSubagentDigest {
+    contract: 'sdd-foreground-subagent-digest-v1';
+    agent: string;
+    delegationId: string;
+    taskId: string;
+    status: ForegroundSubagentStatus;
+    authority: 'non-authoritative';
+    summary: string;
+    keyFindings: string[];
+    recommendation: string | null;
+    confidence: 'high' | 'medium' | 'low';
+    needsMainAgentReview: boolean;
+    sourceArtifactRef: RuntimeRef | null;
+    deepReadRefs: RuntimeRef[];
+    allowedUse: Array<'summary' | 'diagnostic'>;
+    forbiddenUse: Array<'final-risk-decision' | 'stage-completion' | 'ship-gate-pass'>;
+    generatedAt: string;
+}
+export interface ForegroundSubagentSlotResult {
+    agent: string;
+    delegationId: string;
+    artifactPath: string | null;
+    status: ForegroundSubagentStatus;
+    hostInvocation: HostInvocationResult | null;
+    ingestion: ArtifactResultIngestionResult['record'] | null;
+    issues: ContractValidationIssue[];
+    digest: ForegroundSubagentDigest | null;
+    digestRef: RuntimeRef | null;
+}
+export interface ForegroundSubagentRunResult {
+    contract: 'sdd-foreground-subagents-v1';
+    runId: string;
+    branch: string;
+    taskId: string;
+    status: ForegroundSubagentStatus;
+    agents: ForegroundSubagentSlotResult[];
+    message: string;
+    summaryRefs: RuntimeRef[];
+    doNotReadUnlessNeededRefs: RuntimeRef[];
+}
+export declare function runForegroundSubagents(projectRoot: string, options: ForegroundSubagentRunOptions): Promise<ForegroundSubagentRunResult>;