@botbotgo/agent-harness 0.0.309 → 0.0.311

package/dist/contracts/runtime.d.ts

@@ -1,1042 +1,5 @@
-import type { RequestState } from "./core.js";
-import type { CompiledAgentBinding, CompiledModel, CompiledTool, ParsedAgentObject, ParsedToolObject, WorkspaceBundle } from "./workspace.js";
-/**
- * Persisted runtime summary for an inspectable conversation session.
- * This is the canonical runtime-facing conversation record.
- */
-export type SessionSummary = {
-    agentId: string;
-    sessionId: string;
-    latestRequestId: string;
-    createdAt: string;
-    updatedAt: string;
-    status: RequestState;
-    currentAgentId?: string;
-};
-/**
- * Bulk session-history projection for conversation lists and sidebars.
- * This stays runtime-owned and intentionally lighter than full session inspection.
- */
-export type SessionListSummary = SessionSummary & {
-    entryAgentId: string;
-    messageCount: number;
-    hasVisibleMessages: boolean;
-    lastMessageRole?: TranscriptMessage["role"];
-    title?: string;
-    snippet?: string;
-};
-export type KnownHarnessEventType = "request.created" | "request.queued" | "request.dequeued" | "request.state.changed" | "request.resumed" | "approval.requested" | "approval.resolved" | "artifact.created" | "output.delta" | "runtime.health.changed" | "runtime.synthetic_fallback";
-export type HarnessEventType = KnownHarnessEventType | (string & {});
-/**
- * Persisted runtime event recorded by the harness runtime.
- * Event payload semantics should stay aligned with upstream/runtime behavior
- * rather than introducing a second execution protocol.
- */
-export type HarnessEvent = {
-    eventId: string;
-    eventType: HarnessEventType;
-    timestamp: string;
-    sessionId: string;
-    requestId: string;
-    sequence: number;
-    source: "runtime" | "policy" | "surface" | "worker";
-    payload: Record<string, unknown>;
-};
-export type HarnessEventListener = (event: HarnessEvent) => void | Promise<void>;
-export type HarnessEventProjection = {
-    name?: string;
-    shouldHandle?: (event: HarnessEvent) => boolean;
-    handleEvent: HarnessEventListener;
-};
-/**
- * Operator-facing timeline item projected from persisted runtime events.
- * This is an inspection convenience over runtime records, not a new execution protocol.
- */
-export type RuntimeTimelineItem = {
-    eventId: string;
-    sessionId: string;
-    requestId: string;
-    eventType: HarnessEventType;
-    timestamp: string;
-    sequence: number;
-    source: HarnessEvent["source"];
-    kind: "request" | "queue" | "approval" | "recovery" | "artifact" | "other";
-    payload: Record<string, unknown>;
-};
-export type RuntimeTimelineProjectionOptions = {
-    sessionId?: string;
-    requestId?: string;
-};
-/**
- * Ordered upstream/runtime execution trace projected from persisted upstream events.
- * This is an inspection surface for recovery/debugging, not a second execution protocol.
- */
-export type RuntimeHistoryItem = {
-    type: "thinking";
-    text: string;
-} | {
-    type: "step";
-    step: string;
-    category: "llm" | "tool" | "skill" | "memory" | "chain" | "approval";
-    status: "started" | "completed" | "failed";
-    key: string;
-} | {
-    type: "tool-result";
-    toolName: string;
-    output: unknown;
-    isError?: boolean;
-    key: string;
-};
-export type RuntimeSurfaceKind = "agent" | "llm" | "memory" | "skill" | "tool";
-export type RuntimeSurfaceItem = {
-    kind: RuntimeSurfaceKind;
-    id: string;
-    name: string;
-    action: string;
-    status: "started" | "completed" | "failed";
-    agentId?: string;
-    agentName?: string;
-    ownerAgentId?: string;
-    ownerAgentName?: string;
-    sourceEventId?: string;
-    detail?: Record<string, unknown>;
-};
-export type AgentReference = {
-    id: string;
-    name: string;
-};
-export type RuntimeQueueDiagnostics = {
-    status: HealthStatus;
-    activeRequestSlots: number;
-    pendingRequestSlots: number;
-    stuckRequests: number;
-    queueEvents: RuntimeTimelineItem[];
-    summary: string;
-};
-export type RuntimeGovernanceDiagnostics = {
-    runsWithGovernance: number;
-    highRiskTools: number;
-    approvalRequiredTools: number;
-    autoApprovedTools: number;
-    autoRejectedTools: number;
-    untrustedMcpTools: number;
-    crossTenantTools: number;
-    writeAccessMcpTools: number;
-    summary: string;
-};
-export type RuntimeOperatorOverview = {
-    updatedAt: string;
-    summary: string;
-    health: RuntimeHealthSnapshot;
-    queue: RuntimeQueueDiagnostics;
-    approvals: {
-        total: number;
-        items: ApprovalRecord[];
-    };
-    requests: {
-        total: number;
-        states: Partial<Record<RequestState, number>>;
-        items: RequestSummary[];
-    };
-    governance: RuntimeGovernanceDiagnostics;
-};
-export type RuntimeToolExecutionToolPolicy = {
-    toolId: string;
-    name: string;
-    retryable: boolean;
-    hasInputSchema: boolean;
-    requiresApproval: boolean;
-};
-export type RuntimeSnapshotModel = {
-    id: string;
-    provider: string;
-    model: string;
-    baseUrl?: string;
-};
-export type RuntimeSnapshotTool = {
-    name: string;
-    description: string;
-};
-export type RuntimeSnapshotSkill = {
-    name: string;
-    path: string;
-    description?: string;
-};
-export type RuntimeSnapshotTracing = {
-    enabled: boolean;
-    correlationId: string;
-    tags?: string[];
-    metadata?: Record<string, unknown>;
-};
-export type RuntimeGovernanceRiskLevel = "low" | "medium" | "high";
-export type RuntimeGovernanceDecisionMode = "none" | "manual" | "auto-approve" | "auto-reject" | "deny-and-continue";
-export type RuntimeGovernanceToolPolicy = {
-    toolName: string;
-    toolId: string;
-    toolType: string;
-    category: "local" | "backend" | "mcp" | "provider-native";
-    mcpServerRef?: string;
-    mcpTransport?: string;
-    mcpTrustTier?: "trusted" | "reviewed" | "untrusted";
-    mcpAccess?: "read-only" | "read-write";
-    tenantScope?: "workspace" | "project" | "tenant" | "cross-tenant";
-    approvalReason?: string;
-    promptInjectionRisk?: RuntimeGovernanceRiskLevel;
-    oauthScopes?: string[];
-    risk: RuntimeGovernanceRiskLevel;
-    requiresApproval: boolean;
-    approvalPolicy: "explicit-hitl" | "runtime-default" | "none";
-    decisionMode: RuntimeGovernanceDecisionMode;
-    hasInputSchema: boolean;
-    inputRiskHints: string[];
-};
-export type RuntimeGovernanceBundle = {
-    bundleId: string;
-    title: string;
-    summary: string;
-    toolPolicies: RuntimeGovernanceToolPolicy[];
-};
-export type RuntimeSnapshot = {
-    agentId: string;
-    model?: RuntimeSnapshotModel;
-    tools: RuntimeSnapshotTool[];
-    skills: RuntimeSnapshotSkill[];
-    memory: string[];
-    tracing?: RuntimeSnapshotTracing;
-    governance?: {
-        bundles: RuntimeGovernanceBundle[];
-    };
-};
-export type MemoryCandidate = {
-    content: string;
-    summary?: string;
-    kind?: string;
-    scope?: string;
-    confidence?: number;
-    tags?: string[];
-    sourceType?: string;
-    sourceRef?: string;
-    observedAt?: string;
-    sensitivity?: string;
-    noStore?: boolean;
-    knowledgeMutation?: {
-        identity: string;
-        operation?: "create" | "update" | "delete";
-    };
-    operationalRule?: {
-        trigger: string;
-        action: string;
-        target: string;
-        effect?: "apply" | "invalidate";
-    };
-    provenance?: Record<string, unknown>;
-};
-export type MemoryKind = "semantic" | "episodic" | "procedural";
-export type MemoryScope = "session" | "agent" | "workspace" | "user" | "project";
-export type MemoryRecordStatus = "active" | "stale" | "conflicted" | "archived" | "pending_review";
-export type MemoryDecisionAction = "reject" | "store" | "merge" | "refresh" | "supersede" | "archive" | "review";
-export type KnowledgeMutationOperation = "create" | "update" | "delete";
-export type MemoryRecord = {
-    id: string;
-    canonicalKey: string;
-    kind: MemoryKind;
-    scope: MemoryScope;
-    content: string;
-    summary: string;
-    status: MemoryRecordStatus;
-    confidence: number;
-    createdAt: string;
-    observedAt: string;
-    lastConfirmedAt: string;
-    expiresAt?: string;
-    sourceType: string;
-    sourceRefs: string[];
-    tags: string[];
-    knowledgeIdentity?: string;
-    knowledgeOperation?: KnowledgeMutationOperation;
-    operationalRule?: {
-        trigger: string;
-        action: string;
-        target: string;
-        effect?: "apply" | "invalidate";
-    };
-    provenance: Record<string, unknown>;
-    revision: number;
-    supersedes: string[];
-    conflictsWith: string[];
-};
-export type MemoryDecision = {
-    action: MemoryDecisionAction;
-    reason: string;
-    recordId?: string;
-    kind?: MemoryRecord["kind"];
-    scope?: MemoryScope;
-    confidence?: number;
-    maintenance?: "none" | "dedupe" | "merge" | "review";
-    reviewRequired?: boolean;
-};
-export type MemorizeInputRecord = {
-    content: string;
-    summary?: string;
-    kind?: MemoryKind;
-    scope?: MemoryScope;
-    confidence?: number;
-    tags?: string[];
-    sourceType?: string;
-    sourceRef?: string;
-    observedAt?: string;
-    sensitivity?: string;
-    knowledgeMutation?: {
-        identity: string;
-        operation?: KnowledgeMutationOperation;
-    };
-    operationalRule?: {
-        trigger: string;
-        action: string;
-        target: string;
-        effect?: "apply" | "invalidate";
-    };
-    provenance?: Record<string, unknown>;
-    noStore?: boolean;
-};
-export type MemorizeInput = {
-    records: MemorizeInputRecord[];
-    sessionId?: string;
-    requestId?: string;
-    agentId?: string;
-    userId?: string;
-    projectId?: string;
-    recordedAt?: string;
-};
-export type KnowledgeRuntimeContext = {
-    sessionId?: string;
-    requestId?: string;
-    agentId?: string;
-    workspaceId: string;
-    userId?: string;
-    projectId?: string;
-    recordedAt?: string;
-};
-export type MemorizeResult = {
-    records: MemoryRecord[];
-    decisions: MemoryDecision[];
-};
-export type RecallInput = {
-    query: string;
-    scopes?: MemoryScope[];
-    kinds?: MemoryKind[];
-    topK?: number;
-    includeStale?: boolean;
-    sessionId?: string;
-    agentId?: string;
-    workspaceId?: string;
-    userId?: string;
-    projectId?: string;
-};
-export type RecallResult = {
-    items: MemoryRecord[];
-};
-export type ListMemoriesInput = {
-    scopes?: MemoryScope[];
-    kinds?: MemoryKind[];
-    status?: MemoryRecordStatus[];
-    sessionId?: string;
-    agentId?: string;
-    workspaceId?: string;
-    userId?: string;
-    projectId?: string;
-    limit?: number;
-};
-export type ListMemoriesResult = {
-    items: MemoryRecord[];
-};
-export type UpdateMemoryInput = {
-    memoryId: string;
-    content?: string;
-    summary?: string;
-    status?: MemoryRecordStatus;
-    confidence?: number;
-    expiresAt?: string | null;
-    sourceType?: string;
-    sourceRefs?: string[];
-    tags?: string[];
-    observedAt?: string;
-    lastConfirmedAt?: string;
-    knowledgeIdentity?: string;
-    knowledgeOperation?: KnowledgeMutationOperation;
-    provenance?: Record<string, unknown>;
-};
-export type RemoveMemoryInput = {
-    memoryId: string;
-};
-/**
- * Operator-facing projection of tool execution policy already compiled into a binding.
- * This summarizes existing timeout, retry, validation, and retry-safety hints without
- * introducing a second tool framework or stronger guarantees than the runtime provides.
- */
-export type RuntimeToolExecutionPolicy = {
-    agentId: string;
-    invokeTimeoutMs?: number;
-    streamIdleTimeoutMs: number;
-    providerRetries: {
-        maxAttempts: number;
-        backoffMs: number;
-        retryableMessages: string[];
-    };
-    validation: {
-        schemaBoundToolCount: number;
-        allToolsHaveSchemas: boolean;
-    };
-    idempotencyHints: {
-        replayEligible: boolean;
-        retryableToolCount: number;
-        nonRetryableToolCount: number;
-    };
-    tools: RuntimeToolExecutionToolPolicy[];
-};
-export type RuntimeEventSink = {
-    publish: (event: HarnessEvent) => void;
-    subscribe: (listener: HarnessEventListener) => () => void;
-    registerProjection: (projection: HarnessEventProjection) => () => void;
-};
-export type HealthStatus = "healthy" | "degraded" | "unhealthy";
-export type RuntimeHealthCheck = {
-    status: HealthStatus;
-    updatedAt: string;
-    reason?: string;
-};
-export type RuntimeHealthSymptom = {
-    code: string;
-    severity: "info" | "warn" | "error";
-    message: string;
-    firstSeenAt: string;
-    lastSeenAt: string;
-};
-/**
- * Harness-operated operational state built from persisted records and runtime telemetry.
- * This is runtime ops state, not an upstream execution semantic.
- */
-export type RuntimeHealthSnapshot = {
-    status: HealthStatus;
-    updatedAt: string;
-    checks: {
-        runtime: RuntimeHealthCheck;
-        llm: RuntimeHealthCheck;
-        persistence: RuntimeHealthCheck;
-        capacity: RuntimeHealthCheck;
-        workload: RuntimeHealthCheck;
-    };
-    symptoms: RuntimeHealthSymptom[];
-    stats: {
-        activeRequestSlots: number;
-        pendingRequestSlots: number;
-        pendingApprovals: number;
-        stuckRequests: number;
-        checkpointBytes?: number;
-        runtimeDbBytes?: number;
-        artifactBytes?: number;
-        llmSuccessRate1m?: number;
-        llmP95LatencyMs1m?: number;
-    };
-};
-export type RequestResult = {
-    sessionId: string;
-    requestId: string;
-    state: RequestState;
-    output: string;
-    finalMessageText?: string;
-    outputContent?: unknown;
-    contentBlocks?: unknown[];
-    structuredResponse?: unknown;
-    interruptContent?: string;
-    agentId?: string;
-    approvalId?: string;
-    pendingActionId?: string;
-    delegationId?: string;
-    artifacts?: ArtifactRecord[];
-    metadata?: Record<string, unknown>;
-};
-export type UpstreamRuntimeEvent = unknown;
-export type UpstreamRuntimeEventItem = {
-    sessionId: string;
-    requestId: string;
-    surfaceItem: RuntimeSurfaceItem;
-    event: UpstreamRuntimeEvent;
-};
-export type RuntimeListeners = {
-    onEvent?: (event: HarnessEvent) => void | Promise<void>;
-    onUpstreamEvent?: (event: UpstreamRuntimeEvent) => void | Promise<void>;
-    onTraceItem?: (item: UpstreamRuntimeEventItem) => void | Promise<void>;
-    onPlanState?: (planState: RequestPlanState) => void | Promise<void>;
-};
-export type RequestExecutionStepKind = RuntimeSurfaceKind | "approval";
-export type RequestExecutionStep = {
-    id: string;
-    kind: RequestExecutionStepKind;
-    name: string;
-    action: string;
-    status: "started" | "completed" | "failed";
-    occurredAt?: string;
-    startedAt?: string;
-    endedAt?: string;
-    agentId?: string;
-    agentName?: string;
-    ownerAgentId?: string;
-    ownerAgentName?: string;
-    sourceEventId?: string;
-    detail?: Record<string, unknown>;
-    output?: unknown;
-    isError?: boolean;
-};
-export type RequestTodoSnapshot = RequestPlanItem & {
-    key: string;
-    events: RequestExecutionStep[];
-};
-export type RequestApprovalSnapshot = {
-    approvalId?: string;
-    pendingActionId?: string;
-    toolName?: string;
-    status?: ApprovalRecord["status"];
-    allowedDecisions?: Array<"approve" | "edit" | "reject">;
-};
-export type RequestEventSnapshot = {
-    sessionId: string;
-    requestId: string;
-    updatedAt: string;
-    state: RequestResult["state"];
-    agentId?: string;
-    plan: {
-        version: number;
-        updatedAt: string;
-        summary: RequestPlanSummary;
-        items: RequestTodoSnapshot[];
-    };
-    activeTodoKey?: string;
-    activeEventId?: string;
-    approval?: RequestApprovalSnapshot;
-    output: string;
-    contentBlocks?: unknown[];
-    structuredResponse?: unknown;
-    interruptContent?: string;
-    events: RequestExecutionStep[];
-};
-export type RequestDataEvent = {
-    type: "output.text.delta";
-    sessionId: string;
-    requestId: string;
-    agentId: string;
-    text: string;
-} | {
-    type: "progress.commentary";
-    sessionId: string;
-    requestId: string;
-    agentId: string;
-    text: string;
-} | {
-    type: "output.content-blocks";
-    sessionId: string;
-    requestId: string;
-    agentId: string;
-    contentBlocks: unknown[];
-} | {
-    type: "tool.result";
-    sessionId: string;
-    requestId: string;
-    agentId: string;
-    toolName: string;
-    output: unknown;
-    isError?: boolean;
-} | {
-    type: "debug.upstream";
-    sessionId: string;
-    requestId: string;
-    surfaceItem?: RuntimeSurfaceItem;
-    event: UpstreamRuntimeEvent;
-} | {
-    type: "debug.profile";
-    sessionId: string;
-    requestId: string;
-    step: RequestExecutionStep;
-};
-export type RequestListeners = RuntimeListeners & {
-    eventListener?: (snapshot: RequestEventSnapshot) => void | Promise<void>;
-    dataListener?: (event: RequestDataEvent) => void | Promise<void>;
-};
-export type MessageContentPart = {
-    type: "text";
-    text: string;
-} | {
-    type: "image_url";
-    image_url: string;
-};
-export type MessageContent = string | MessageContentPart[];
-export type InvocationEnvelope = {
-    context?: Record<string, unknown>;
-    inputs?: Record<string, unknown>;
-    attachments?: Record<string, unknown>;
-    capabilities?: Record<string, unknown>;
-};
-export type RequestStartOptions = {
-    agentId?: string;
-    input: MessageContent;
-    sessionId?: string;
-    priority?: number;
-    invocation?: InvocationEnvelope;
-    listeners?: RequestListeners;
-};
-export type RequestDecisionOptions = {
-    sessionId: string;
-    requestId?: string;
-    approvalId?: string;
-    decision: "approve" | "edit" | "reject";
-    editedInput?: Record<string, unknown>;
-    listeners?: RequestListeners;
-};
-export type RequestOptions = RequestStartOptions | RequestDecisionOptions;
-export type HarnessStreamItem = {
-    type: "event";
-    event: HarnessEvent;
-} | {
-    type: "commentary";
-    sessionId: string;
-    requestId: string;
-    agentId: string;
-    content: string;
-} | {
-    type: "content";
-    sessionId: string;
-    requestId: string;
-    agentId: string;
-    content: string;
-} | {
-    type: "content-blocks";
-    sessionId: string;
-    requestId: string;
-    agentId: string;
-    contentBlocks: unknown[];
-} | {
-    type: "tool-result";
-    sessionId: string;
-    requestId: string;
-    agentId: string;
-    toolName: string;
-    output: unknown;
-    isError?: boolean;
-} | {
-    type: "plan-state";
-    sessionId: string;
-    requestId: string;
-    agentId: string;
-    planState: RequestPlanState;
-} | {
-    type: "upstream-event";
-    sessionId: string;
-    requestId: string;
-    surfaceItem?: RuntimeSurfaceItem;
-    event: UpstreamRuntimeEvent;
-} | {
-    type: "profile-step";
-    sessionId: string;
-    requestId: string;
-    step: RequestExecutionStep;
-} | {
-    type: "result";
-    result: RequestResult;
-};
-export type TranscriptMessage = {
-    role: "user" | "assistant";
-    content: MessageContent;
-    requestId: string;
-    createdAt: string;
-};
-export type SessionRequestRecord = {
-    requestId: string;
-    sessionId: string;
-    agentId: string;
-    parentRequestId?: string;
-    executionMode: string;
-    adapterKind?: string;
-    createdAt: string;
-    updatedAt: string;
-    state: RequestState;
-    checkpointRef: string | null;
-    resumable: boolean;
-    startedAt: string;
-    endedAt?: string;
-    lastActivityAt: string;
-    currentAgentId?: string;
-    delegationChain: string[];
-    runtimeSnapshot?: RuntimeSnapshot;
-};
-/**
- * Persisted request summary projected from upstream execution state plus runtime lifecycle metadata.
- * This is the canonical runtime-facing execution record.
- */
-export type RequestSummary = SessionRequestRecord;
-export type RequestRecord = RequestSummary & {
-    traceItems?: unknown[];
-    runtimeTimeline?: RuntimeTimelineItem[];
-};
-export type RequestPlanItemStatus = "pending" | "in_progress" | "completed" | "failed" | "cancelled" | "blocked" | (string & {});
-export type RequestPlanItem = {
-    id?: string;
-    content: string;
-    status: RequestPlanItemStatus;
-    ownerAgentId?: string;
-    startedAt?: string;
-    endedAt?: string;
-    result?: unknown;
-    metadata?: Record<string, unknown>;
-};
-export type RequestPlanSummary = {
-    total: number;
-    pending: number;
-    inProgress: number;
-    completed: number;
-    failed: number;
-    cancelled: number;
-    blocked: number;
-};
-export type RequestPlanState = {
-    sessionId: string;
-    requestId: string;
-    version: number;
-    updatedAt: string;
-    items: RequestPlanItem[];
-    summary: RequestPlanSummary;
-};
-/**
- * Persisted session inspection record assembled from runtime records.
- * This is an inspectable projection, not a second session semantic model.
- */
-export type SessionRecord = {
-    sessionId: string;
-    entryAgentId: string;
-    currentAgentId?: string;
-    currentState: RequestState;
-    latestRequestId: string;
-    createdAt: string;
-    updatedAt: string;
-    messages: TranscriptMessage[];
-    requests: RequestRecord[];
-    pendingDecision?: {
-        approvalId: string;
-        pendingActionId: string;
-        toolName: string;
-        allowedDecisions: Array<"approve" | "edit" | "reject">;
-        requestedAt: string;
-    };
-};
-export type ResumeOptions = {
-    sessionId?: string;
-    requestId?: string;
-    approvalId?: string;
-    decision?: "approve" | "edit" | "reject";
-    editedInput?: Record<string, unknown>;
-};
-export type CancelOptions = {
-    requestId: string;
-    reason?: string;
-};
-export type RestartConversationOptions = {
-    sessionId: string;
-    mode: "restart-in-session" | "restart-new-session";
-    input: string;
-};
-/**
- * Persisted approval inspection record.
- * Approval decision semantics should stay aligned with upstream interrupt/approval
- * behavior even though the record is stored and resolved through harness persistence.
- */
-export type ApprovalRecord = {
-    approvalId: string;
-    pendingActionId: string;
-    sessionId: string;
-    requestId: string;
-    toolName: string;
-    approvalReason?: string;
-    status: "pending" | "approved" | "edited" | "rejected" | "expired";
-    requestedAt: string;
-    resolvedAt: string | null;
-    allowedDecisions: Array<"approve" | "edit" | "reject">;
-    inputPreview: Record<string, unknown>;
-};
-export type InternalApprovalRecord = ApprovalRecord & {
-    toolCallId: string;
-    checkpointRef: string;
-    eventRefs: string[];
-};
-export type ArtifactRecord = {
-    artifactId: string;
-    kind: string;
-    path: string;
-    createdAt: string;
-};
-export type ArtifactListing = {
-    sessionId: string;
-    requestId: string;
-    items: ArtifactRecord[];
-};
-export type RuntimeToolResolver = (toolIds: string[], binding?: CompiledAgentBinding) => unknown[];
-export type RuntimeModelResolver = (modelId: string) => unknown;
-export type RuntimeEmbeddingModelResolver = (embeddingModelId: string) => unknown;
-export type RuntimeVectorStoreResolver = (vectorStoreId: string) => unknown;
-export type RuntimeMiddlewareResolver = (binding: CompiledAgentBinding) => unknown[];
-export type RuntimeDeclaredMiddlewareResolver = (input: {
-    kind: string;
-    config: Record<string, unknown>;
-    binding?: CompiledAgentBinding;
-    resolveModel: (model: CompiledModel) => Promise<unknown>;
-}) => unknown | unknown[] | null | undefined | Promise<unknown | unknown[] | null | undefined>;
-export type RuntimeCheckpointerResolver = (binding: CompiledAgentBinding) => unknown;
-export type RuntimeStoreResolver = (binding: CompiledAgentBinding) => unknown;
-export type RuntimeBackendResolver = (binding: CompiledAgentBinding) => unknown;
-export type RuntimeScheduleDefinition = {
-    type: "cron";
-    expression: string;
-} | {
-    type: "interval";
-    everyMinutes: number;
-} | {
-    type: "daily";
-    time: string;
-} | {
-    type: "weekly";
-    time: string;
-    days: string[];
-};
-export type RuntimeScheduleStatus = "active" | "missing";
-export type RuntimeScheduleSource = "crontab" | "schtasks";
-export type RuntimeScheduleRecord = {
-    scheduleId: string;
-    name: string;
-    instruction: string;
-    agentId?: string;
-    schedule: RuntimeScheduleDefinition;
-    source: RuntimeScheduleSource;
-    platform: NodeJS.Platform;
-    status: RuntimeScheduleStatus;
-    systemId: string;
-    createdAt: string;
-    updatedAt: string;
-    metadata?: Record<string, unknown>;
-};
-export type RuntimeScheduleListFilter = {
-    scheduleId?: string;
-    name?: string;
-    agentId?: string;
-    source?: RuntimeScheduleSource;
-    status?: RuntimeScheduleStatus;
-    query?: string;
-};
-export type RuntimeScheduleManageInput = {
-    operation?: "create" | "list" | "get" | "update" | "delete";
-    scheduleId?: string;
-    name?: string;
-    instruction?: string;
-    agentId?: string;
-    schedule?: RuntimeScheduleDefinition;
-    metadata?: Record<string, unknown>;
-    filters?: RuntimeScheduleListFilter;
-};
-export type RuntimeScheduleManageResult = {
-    ok: true;
-    operation: "create" | "get" | "update";
-    schedule: RuntimeScheduleRecord;
-} | {
-    ok: true;
-    operation: "list";
-    items: RuntimeScheduleRecord[];
-    total: number;
-} | {
-    ok: true;
-    operation: "delete";
-    scheduleId: string;
-};
-export type RuntimeScheduleManager = {
-    manageSchedule(input: RuntimeScheduleManageInput): Promise<RuntimeScheduleManageResult>;
-    getSchedule(scheduleId: string): Promise<RuntimeScheduleRecord | null>;
-};
-export type RuntimeAdapterOptions = {
-    toolResolver?: RuntimeToolResolver;
-    modelResolver?: RuntimeModelResolver;
-    embeddingModelResolver?: RuntimeEmbeddingModelResolver;
-    vectorStoreResolver?: RuntimeVectorStoreResolver;
-    middlewareResolver?: RuntimeMiddlewareResolver;
-    declaredMiddlewareResolver?: RuntimeDeclaredMiddlewareResolver;
-    checkpointerResolver?: RuntimeCheckpointerResolver;
-    storeResolver?: RuntimeStoreResolver;
-    backendResolver?: RuntimeBackendResolver;
-    scheduleManager?: RuntimeScheduleManager;
-    functionToolContextResolver?: (input: {
-        binding?: CompiledAgentBinding;
-        sessionId?: string;
-        requestId?: string;
-    }) => Record<string, unknown> | undefined;
-    /**
-     * DeepAgent execution semantics stay upstream-owned.
-     * `minimal` keeps harness runtime persistence/ops active while only attaching
-     * upstream substrate objects when the binding explicitly needs them.
-     */
-    deepAgentUpstreamSubstrateMode?: "full" | "minimal";
-};
-export type ToolKindAdapter = {
-    type: string;
-    validate: (tool: ParsedToolObject, tools: Map<string, ParsedToolObject>) => void;
-    compile: (tool: ParsedToolObject, tools: Map<string, ParsedToolObject>) => CompiledTool[];
-};
-export type SkillSourceResolver = {
-    kind: string;
-    resolve: (input: {
-        workspaceRoot: string;
-        skill: {
-            sourcePathRef: string;
-        };
-        packagingRoots: string[];
-    }) => string[];
-};
-export type SkillInheritancePolicy = {
-    kind: string;
-    apply: (input: {
-        agent: ParsedAgentObject;
-        ownSkills: string[];
-        parentSkills: string[];
-    }) => string[];
-};
-export type SkillPackagingConvention = {
-    kind: string;
-    resolve: (input: {
-        workspaceRoot: string;
-        skill: {
-            sourcePathRef: string;
-        };
-    }) => string[];
-};
-export type PolicyDecision = {
-    allowed: boolean;
-    reasons: string[];
-    bundles?: RuntimeGovernanceBundle[];
-};
-export type PolicyEvaluator = {
-    kind: string;
-    evaluate: (binding: CompiledAgentBinding) => PolicyDecision | null;
-};
-export type EventSubscriber = {
-    kind: string;
-    onEvent: HarnessEventListener;
-};
-export type RuntimeEvaluationExportInput = {
-    sessionId: string;
-    requestId: string;
-    includeArtifacts?: boolean;
-    includeArtifactContents?: boolean;
-    expectedOutput?: string;
-    rubric?: string[];
-    tags?: string[];
-    metadata?: Record<string, unknown>;
-};
-export type RuntimeArtifactWriteInput = {
-    sessionId: string;
-    requestId: string;
-    kind: string;
-    path: string;
-    content: unknown;
-    artifactId?: string;
-    createdAt?: string;
-};
-export type RuntimeEvaluationArtifact = ArtifactRecord & {
-    content?: unknown;
-};
-export type RuntimeEvaluationExport = {
-    session: SessionRecord | null;
-    request: RequestRecord | null;
-    requestInput: {
-        input: MessageContent;
-        invocation?: InvocationEnvelope;
-        priority?: number;
-    } | null;
-    approvals: ApprovalRecord[];
-    transcript: TranscriptMessage[];
-    events: HarnessEvent[];
-    artifacts: RuntimeEvaluationArtifact[];
-    runtimeHealth: RuntimeHealthSnapshot;
-    expectedOutput?: string;
-    rubric: string[];
-    tags: string[];
-    metadata?: Record<string, unknown>;
-};
-export type RuntimeEvaluationReplayInput = {
-    bundle: RuntimeEvaluationExport;
-    agentId?: string;
-    sessionId?: string;
-    invocation?: InvocationEnvelope;
-};
-export type RuntimeEvaluationReplayResult = {
-    request: {
-        agentId: string;
-        input: MessageContent;
-        invocation?: InvocationEnvelope;
-        sessionId?: string;
-    };
-    result: RequestResult;
-    assertions: {
-        expectedOutputMatched?: boolean;
-    };
-};
-export type RuntimeRequestPackageInput = {
-    sessionId: string;
-    requestId: string;
-    includeArtifacts?: boolean;
-    includeArtifactContents?: boolean;
-    includeRuntimeHealth?: boolean;
-};
-export type RuntimeApprovalSummary = {
-    total: number;
-    pending: number;
-    approved: number;
-    edited: number;
-    rejected: number;
-    expired: number;
-    toolNames: string[];
-    approvalReasons: string[];
-};
-export type RuntimeGovernanceEvidence = {
-    bundles: RuntimeGovernanceBundle[];
-    approvalSummary: RuntimeApprovalSummary;
-    summary: string;
-};
-export type RuntimeRequestPackage = {
-    session: SessionRecord | null;
-    request: RequestRecord | null;
-    approvals: ApprovalRecord[];
-    transcript: TranscriptMessage[];
-    events: HarnessEvent[];
-    artifacts: RuntimeEvaluationArtifact[];
-    governance: RuntimeGovernanceEvidence;
-    runtimeHealth?: RuntimeHealthSnapshot;
-};
-export type RuntimeSessionPackageInput = {
-    sessionId: string;
-    includeArtifacts?: boolean;
-    includeArtifactContents?: boolean;
-    includeRuntimeHealth?: boolean;
-};
-export type RuntimeSessionPackage = {
-    session: SessionRecord | null;
-    requests: RequestRecord[];
-    approvals: ApprovalRecord[];
-    transcript: TranscriptMessage[];
-    requestsPackages: RuntimeRequestPackage[];
-    governance: {
-        requests: Array<{
-            requestId: string;
-            evidence: RuntimeGovernanceEvidence;
-        }>;
-        approvalSummary: RuntimeApprovalSummary;
-        summary: string;
-    };
-    runtimeHealth?: RuntimeHealthSnapshot;
-};
-export type RuntimeInventoryContext = {
-    workspace: WorkspaceBundle;
-};
+export * from "./runtime-observability.js";
+export * from "./runtime-memory.js";
+export * from "./runtime-requests.js";
+export * from "./runtime-scheduling.js";
+export * from "./runtime-evaluation.js";