@botbotgo/agent-harness 0.0.96 → 0.0.98

package/dist/contracts/types.d.ts

@@ -1,653 +1,3 @@
-export type ExecutionMode = "deepagent" | "langchain-v1" | "langgraph";
-export declare const AUTO_AGENT_ID = "auto";
-export type RuntimeModelSlot = "routing" | "planning" | "execution" | "review" | "final";
-export type RuntimeModelRefMap = Partial<Record<RuntimeModelSlot, string>>;
-export type RuntimeModelMap = Partial<Record<RuntimeModelSlot, CompiledModel>>;
-export type RuntimeCapabilities = {
-    delegation?: boolean;
-    memory?: boolean;
-};
-export type RunState = "queued" | "claimed" | "running" | "waiting_for_approval" | "resuming" | "cancelling" | "cancelled" | "completed" | "failed";
-export type ParsedAgentObject = {
-    id: string;
-    executionMode: ExecutionMode;
-    runtimeModelRefs?: RuntimeModelRefMap;
-    capabilities?: RuntimeCapabilities;
-    description: string;
-    modelRef: string;
-    runRoot?: string;
-    toolRefs: string[];
-    mcpServers?: Array<Record<string, unknown>>;
-    skillPathRefs: string[];
-    memorySources: string[];
-    subagentRefs: string[];
-    subagentPathRefs: string[];
-    langchainAgentConfig?: Record<string, unknown>;
-    deepAgentConfig?: Record<string, unknown>;
-    sourcePath: string;
-};
-export type WorkspaceObject = {
-    id: string;
-    kind: string;
-    sourcePath: string;
-    value: Record<string, unknown>;
-};
-export type ParsedModelObject = {
-    id: string;
-    provider: string;
-    model: string;
-    init: Record<string, unknown>;
-    clientRef?: string;
-    fallbacks: string[];
-    metadata?: Record<string, unknown>;
-    sourcePath: string;
-};
-export type ParsedEmbeddingModelObject = {
-    id: string;
-    provider: string;
-    model: string;
-    init: Record<string, unknown>;
-    clientRef?: string;
-    metadata?: Record<string, unknown>;
-    sourcePath: string;
-};
-export type ParsedVectorStoreObject = {
-    id: string;
-    kind: string;
-    url?: string;
-    authToken?: string;
-    table?: string;
-    column?: string;
-    embeddingModelRef?: string;
-    metadata?: Record<string, unknown>;
-    sourcePath: string;
-};
-export type ParsedMcpServerObject = {
-    id: string;
-    transport: "stdio" | "http" | "sse" | "websocket";
-    url?: string;
-    command?: string;
-    args?: string[];
-    env?: Record<string, string>;
-    cwd?: string;
-    token?: string;
-    headers?: Record<string, string>;
-    sourcePath: string;
-};
-export type ParsedToolObject = {
-    id: string;
-    type: string;
-    name: string;
-    description: string;
-    implementationName?: string;
-    config?: Record<string, unknown>;
-    inputSchemaRef?: string;
-    backendOperation?: string;
-    mcpRef?: string;
-    bundleRefs: string[];
-    hitl?: {
-        enabled: boolean;
-        allow?: Array<"approve" | "edit" | "reject">;
-    };
-    retryable?: boolean;
-    sourcePath: string;
-};
-export type LangChainAgentParams = {
-    model: CompiledModel;
-    tools: CompiledTool[];
-    systemPrompt?: string;
-    stateSchema?: unknown;
-    responseFormat?: unknown;
-    contextSchema?: unknown;
-    filesystem?: Record<string, unknown>;
-    middleware?: Array<Record<string, unknown>>;
-    passthrough?: Record<string, unknown>;
-    subagents?: CompiledSubAgent[];
-    memory?: string[];
-    skills?: string[];
-    generalPurposeAgent?: boolean;
-    taskDescription?: string;
-    includeAgentName?: "inline";
-    version?: "v1" | "v2";
-    name?: string;
-    description: string;
-};
-export type CompiledSubAgent = {
-    name: string;
-    description: string;
-    systemPrompt: string;
-    tools?: CompiledTool[];
-    model?: CompiledModel;
-    interruptOn?: Record<string, boolean | object>;
-    skills?: string[];
-    memory?: string[];
-    responseFormat?: unknown;
-    contextSchema?: unknown;
-    middleware?: Array<Record<string, unknown>>;
-    passthrough?: Record<string, unknown>;
-};
-export type DeepAgentParams = {
-    model: CompiledModel;
-    tools: CompiledTool[];
-    systemPrompt?: string;
-    responseFormat?: unknown;
-    contextSchema?: unknown;
-    middleware?: Array<Record<string, unknown>>;
-    passthrough?: Record<string, unknown>;
-    description: string;
-    subagents: CompiledSubAgent[];
-    interruptOn?: Record<string, boolean | object>;
-    backend?: Record<string, unknown>;
-    store?: Record<string, unknown>;
-    name: string;
-    memory: string[];
-    skills: string[];
-    generalPurposeAgent?: boolean;
-    taskDescription?: string;
-};
-export type CompiledModel = {
-    id: string;
-    provider: string;
-    model: string;
-    init: Record<string, unknown>;
-    clientRef?: string;
-    fallbacks: string[];
-    runtimeValue: string;
-};
-export type CompiledEmbeddingModel = {
-    id: string;
-    provider: string;
-    model: string;
-    init: Record<string, unknown>;
-    clientRef?: string;
-    runtimeValue: string;
-};
-export type CompiledVectorStore = {
-    id: string;
-    kind: string;
-    url?: string;
-    authToken?: string;
-    table?: string;
-    column?: string;
-    embeddingModelRef?: string;
-    runtimeValue: string;
-};
-export type CompiledTool = {
-    id: string;
-    type: string;
-    name: string;
-    description: string;
-    config?: Record<string, unknown>;
-    inputSchemaRef?: string;
-    backendOperation?: string;
-    mcpRef?: string;
-    bundleRefs: string[];
-    hitl?: {
-        enabled: boolean;
-        allow: Array<"approve" | "edit" | "reject">;
-    };
-    retryable?: boolean;
-    runtimeValue: {
-        name: string;
-        description: string;
-        type: string;
-    };
-};
-export type CompiledAgentBinding = {
-    agent: ParsedAgentObject;
-    adapter?: {
-        kind: string;
-        config: Record<string, unknown>;
-    };
-    langchainAgentParams?: LangChainAgentParams;
-    deepAgentParams?: DeepAgentParams;
-    harnessRuntime: {
-        runRoot: string;
-        workspaceRoot?: string;
-        modelRefs?: RuntimeModelRefMap;
-        models?: RuntimeModelMap;
-        capabilities?: RuntimeCapabilities;
-        resilience?: Record<string, unknown>;
-        checkpointer?: Record<string, unknown> | boolean;
-        store?: Record<string, unknown>;
-        runtimeMemory?: Record<string, unknown>;
-    };
-};
-export type WorkspaceBundle = {
-    workspaceRoot: string;
-    resourceSources: string[];
-    refs: Map<string, WorkspaceObject | ParsedAgentObject>;
-    models: Map<string, ParsedModelObject>;
-    embeddings: Map<string, ParsedEmbeddingModelObject>;
-    vectorStores: Map<string, ParsedVectorStoreObject>;
-    mcpServers: Map<string, ParsedMcpServerObject>;
-    tools: Map<string, ParsedToolObject>;
-    agents: Map<string, ParsedAgentObject>;
-    bindings: Map<string, CompiledAgentBinding>;
-};
-export type WorkspaceLoadOptions = {
-    /**
-     * Additional workspace roots to load before the runtime workspace root.
-     * Merge order is deterministic:
-     * framework defaults -> each overlayRoot (in order) -> workspaceRoot.
-     * Later values always override earlier values.
-     */
-    overlayRoots?: string[];
-    resourceSources?: string[];
-};
-export type ThreadSummary = {
-    agentId: string;
-    threadId: string;
-    latestRunId: string;
-    createdAt: string;
-    updatedAt: string;
-    status: RunState;
-};
-export type SessionRecord = ThreadSummary;
-export type KnownHarnessEventType = "run.created" | "run.queued" | "run.dequeued" | "run.state.changed" | "run.reviewed" | "run.resumed" | "approval.requested" | "approval.resolved" | "artifact.created" | "output.delta" | "reasoning.delta" | "runtime.health.changed" | "runtime.synthetic_fallback";
-export type HarnessEventType = KnownHarnessEventType | (string & {});
-export type HarnessEvent = {
-    eventId: string;
-    eventType: HarnessEventType;
-    timestamp: string;
-    threadId: string;
-    runId: 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;
-};
-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;
-};
-export type RuntimeHealthSnapshot = {
-    status: HealthStatus;
-    updatedAt: string;
-    checks: {
-        runtime: RuntimeHealthCheck;
-        llm: RuntimeHealthCheck;
-        persistence: RuntimeHealthCheck;
-        capacity: RuntimeHealthCheck;
-        workload: RuntimeHealthCheck;
-    };
-    symptoms: RuntimeHealthSymptom[];
-    stats: {
-        activeRunSlots: number;
-        pendingRunSlots: number;
-        pendingApprovals: number;
-        stuckRuns: number;
-        checkpointBytes?: number;
-        runtimeDbBytes?: number;
-        artifactBytes?: number;
-        llmSuccessRate1m?: number;
-        llmP95LatencyMs1m?: number;
-    };
-};
-export type RunResult = {
-    threadId: string;
-    runId: string;
-    state: RunState;
-    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 NormalizedUpstreamEvent = {
-    kind: "text-delta";
-    source: "model" | "state";
-    text: string;
-    ns?: string[];
-    nodeName?: string;
-} | {
-    kind: "reasoning-delta";
-    text: string;
-    ns?: string[];
-    nodeName?: string;
-} | {
-    kind: "tool-start";
-    toolName: string;
-    input?: unknown;
-    ns?: string[];
-    nodeName?: string;
-} | {
-    kind: "tool-end";
-    toolName: string;
-    output?: unknown;
-    isError?: boolean;
-    ns?: string[];
-    nodeName?: string;
-} | {
-    kind: "agent-step";
-    label: string;
-    ns?: string[];
-    nodeName?: string;
-} | {
-    kind: "interrupt";
-    interrupt: unknown;
-    ns?: string[];
-    nodeName?: string;
-} | {
-    kind: "run-event";
-    eventName: string;
-    data?: Record<string, unknown>;
-    ns?: string[];
-    nodeName?: string;
-};
-export type CompatibleStreamPart = {
-    type: "messages";
-    ns: string[];
-    data: [unknown, Record<string, unknown>];
-} | {
-    type: "updates";
-    ns: string[];
-    data: Record<string, unknown>;
-} | {
-    type: "custom";
-    ns: string[];
-    data: unknown;
-};
-export type UpstreamRuntimeEvent = {
-    format: "langgraph-v2";
-    /** @deprecated Prefer streamPart plus raw/event/name/data/ns for upstream-aligned consumption. */
-    normalized: NormalizedUpstreamEvent;
-    streamPart: CompatibleStreamPart;
-    raw: unknown;
-    event?: string;
-    name?: string;
-    runType?: string;
-    data?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-    tags?: string[];
-    ns?: string[];
-};
-export type RuntimeListeners = {
-    onEvent?: (event: HarnessEvent) => void | Promise<void>;
-};
-export type FrontendStreamListeners = {
-    onChunk?: (chunk: string) => void | Promise<void>;
-    onContentBlocks?: (blocks: unknown[]) => void | Promise<void>;
-    onUpstreamEvent?: (event: UpstreamRuntimeEvent) => void | Promise<void>;
-    onReasoning?: (chunk: string) => void | Promise<void>;
-    onStep?: (step: string) => void | Promise<void>;
-    onToolResult?: (item: {
-        toolName: string;
-        output: unknown;
-        isError?: boolean;
-    }) => void | Promise<void>;
-};
-export type RunListeners = RuntimeListeners & FrontendStreamListeners;
-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 RunStartOptions = {
-    agentId?: string;
-    input: MessageContent;
-    threadId?: string;
-    priority?: number;
-    invocation?: InvocationEnvelope;
-    listeners?: RunListeners;
-    runtimeListeners?: RuntimeListeners;
-    frontendListeners?: FrontendStreamListeners;
-};
-export type RunDecisionOptions = {
-    threadId: string;
-    runId?: string;
-    approvalId?: string;
-    decision: "approve" | "edit" | "reject";
-    editedInput?: Record<string, unknown>;
-    listeners?: RunListeners;
-    runtimeListeners?: RuntimeListeners;
-    frontendListeners?: FrontendStreamListeners;
-};
-export type RunOptions = RunStartOptions | RunDecisionOptions;
-export type HarnessStreamItem = {
-    type: "event";
-    event: HarnessEvent;
-} | {
-    type: "upstream-event";
-    threadId: string;
-    runId: string;
-    agentId: string;
-    event: UpstreamRuntimeEvent;
-} | {
-    type: "result";
-    result: RunResult;
-} | {
-    type: "content";
-    threadId: string;
-    runId: string;
-    agentId: string;
-    content: string;
-} | {
-    type: "content-blocks";
-    threadId: string;
-    runId: string;
-    agentId: string;
-    contentBlocks: unknown[];
-} | {
-    type: "reasoning";
-    threadId: string;
-    runId: string;
-    agentId: string;
-    content: string;
-} | {
-    type: "step";
-    threadId: string;
-    runId: string;
-    agentId: string;
-    content: string;
-} | {
-    type: "tool-result";
-    threadId: string;
-    runId: string;
-    agentId: string;
-    toolName: string;
-    output: unknown;
-    isError?: boolean;
-};
-export type TranscriptMessage = {
-    role: "user" | "assistant";
-    content: MessageContent;
-    runId: string;
-    createdAt: string;
-};
-export type ThreadRunRecord = {
-    runId: string;
-    threadId: string;
-    agentId: string;
-    executionMode: string;
-    adapterKind?: string;
-    createdAt: string;
-    updatedAt: string;
-    state: RunState;
-    checkpointRef: string | null;
-    resumable: boolean;
-};
-export type RunSummary = ThreadRunRecord;
-export type RunRecord = RunSummary;
-export type ThreadRecord = {
-    threadId: string;
-    entryAgentId: string;
-    currentState: RunState;
-    latestRunId: string;
-    createdAt: string;
-    updatedAt: string;
-    messages: TranscriptMessage[];
-    runs: ThreadRunRecord[];
-    pendingDecision?: {
-        approvalId: string;
-        pendingActionId: string;
-        toolName: string;
-        allowedDecisions: Array<"approve" | "edit" | "reject">;
-        requestedAt: string;
-    };
-};
-export type ResumeOptions = {
-    threadId?: string;
-    runId?: string;
-    approvalId?: string;
-    decision?: "approve" | "edit" | "reject";
-    editedInput?: Record<string, unknown>;
-};
-export type CancelOptions = {
-    runId: string;
-    reason?: string;
-};
-export type RestartConversationOptions = {
-    threadId: string;
-    mode: "restart-in-thread" | "restart-new-thread";
-    input: string;
-};
-export type ApprovalRecord = {
-    approvalId: string;
-    pendingActionId: string;
-    threadId: string;
-    runId: string;
-    toolName: 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 DelegationRecord = {
-    delegationId: string;
-    threadId: string;
-    runId: string;
-    parentRunId: string;
-    specialistAgentId: string;
-    specialistName: string;
-    specialistDescription: string;
-    status: "requested" | "running" | "completed" | "failed" | "cancelled" | "resumable";
-    requestedAt: string;
-    startedAt: string | null;
-    completedAt: string | null;
-    checkpointRef: string | null;
-    inputArtifactRef: string | null;
-    outputArtifactRef: string | null;
-    eventRefs: string[];
-};
-export type ArtifactRecord = {
-    artifactId: string;
-    kind: string;
-    path: string;
-    createdAt: string;
-};
-export type ArtifactListing = {
-    threadId: string;
-    runId: 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 RuntimeAdapterOptions = {
-    toolResolver?: RuntimeToolResolver;
-    modelResolver?: RuntimeModelResolver;
-    embeddingModelResolver?: RuntimeEmbeddingModelResolver;
-    vectorStoreResolver?: RuntimeVectorStoreResolver;
-    middlewareResolver?: RuntimeMiddlewareResolver;
-    declaredMiddlewareResolver?: RuntimeDeclaredMiddlewareResolver;
-    checkpointerResolver?: RuntimeCheckpointerResolver;
-    storeResolver?: RuntimeStoreResolver;
-    backendResolver?: RuntimeBackendResolver;
-};
-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[];
-};
-export type PolicyEvaluator = {
-    kind: string;
-    evaluate: (binding: CompiledAgentBinding) => PolicyDecision | null;
-};
-export type EventSubscriber = {
-    kind: string;
-    onEvent: HarnessEventListener;
-};
+export * from "./core.js";
+export * from "./runtime.js";
+export * from "./workspace.js";

package/dist/contracts/types.js

@@ -1 +1,3 @@
-export const AUTO_AGENT_ID = "auto";
+export * from "./core.js";
+export * from "./runtime.js";
+export * from "./workspace.js";