open-multi-agent-kit 0.78.0

package/dist/contracts/decision.d.ts

@@ -0,0 +1,23 @@
+import type { OMK_DECISION_SCHEMA_VERSION } from "../version.js";
+export type DecisionKind = "provider-selection" | "fallback-routing" | "retry-policy" | "skip-policy" | "dependent-block" | "context-brokering" | "skill-assignment" | "evidence-verdict" | "security-policy";
+export type DecisionActor = "runtime-router" | "scheduler" | "evidence-gate" | "provider-router" | "operator";
+export type DecisionTrace = {
+    schemaVersion: typeof OMK_DECISION_SCHEMA_VERSION;
+    runId: string;
+    decisionId: string;
+    timestamp: string;
+    kind: DecisionKind;
+    actor: DecisionActor;
+    inputRefs: string[];
+    outputRefs: string[];
+    selected?: string;
+    candidates?: string[];
+    reason: string;
+    confidence?: number;
+};
+export type DecisionRef = {
+    schemaVersion?: typeof OMK_DECISION_SCHEMA_VERSION;
+    decisionId: string;
+    runId?: string;
+    path?: string;
+};

package/dist/contracts/decision.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/envelope.d.ts

@@ -0,0 +1,29 @@
+import type { OMK_CONTRACT_VERSION, OMK_RUNTIME_VERSION } from "../version.js";
+import type { DecisionRef } from "./decision.js";
+import type { OmkError, OmkWarning } from "./errors.js";
+import type { EvidenceRef } from "./evidence.js";
+export type OmkCommandStatus = "passed" | "failed" | "blocked" | "skipped" | "partial" | "dry-run" | "not-applicable";
+export type OmkJsonEnvelope<TData = unknown> = {
+    ok: boolean;
+    schemaVersion: typeof OMK_CONTRACT_VERSION;
+    command: string;
+    omkVersion: string;
+    runtimeVersion: typeof OMK_RUNTIME_VERSION;
+    commit?: string;
+    runId?: string;
+    traceId: string;
+    status: OmkCommandStatus;
+    data: TData;
+    warnings: OmkWarning[];
+    errors: OmkError[];
+    evidenceRefs?: EvidenceRef[];
+    decisionRefs?: DecisionRef[];
+    metadata: {
+        cwd: string;
+        platform: NodeJS.Platform;
+        nodeVersion: string;
+        provider?: string;
+        durationMs: number;
+        timestamp: string;
+    };
+};

package/dist/contracts/envelope.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/errors.d.ts

@@ -0,0 +1,13 @@
+export declare const OMK_ERROR_CODES: readonly ["CONFIG_INVALID", "PROVIDER_UNAVAILABLE", "PROVIDER_AUTH_REQUIRED", "PROVIDER_CAPABILITY_MISMATCH", "ROUTE_FALLBACK_TRIGGERED", "EVIDENCE_MISSING", "EVIDENCE_FAILED", "DAG_NODE_BLOCKED", "RUN_ARTIFACT_MISSING", "REPLAY_INCOMPLETE", "SECURITY_POLICY_BLOCKED", "MCP_UNHEALTHY", "INTERNAL_ERROR"];
+export type OmkErrorCode = (typeof OMK_ERROR_CODES)[number];
+export type OmkSeverity = "info" | "warning" | "error" | "fatal";
+export type OmkError = {
+    code: OmkErrorCode;
+    message: string;
+    recoverable: boolean;
+    severity: OmkSeverity;
+    hint?: string;
+    cause?: string;
+    path?: string;
+};
+export type OmkWarning = OmkError;

package/dist/contracts/errors.js

@@ -0,0 +1,15 @@
+export const OMK_ERROR_CODES = [
+    "CONFIG_INVALID",
+    "PROVIDER_UNAVAILABLE",
+    "PROVIDER_AUTH_REQUIRED",
+    "PROVIDER_CAPABILITY_MISMATCH",
+    "ROUTE_FALLBACK_TRIGGERED",
+    "EVIDENCE_MISSING",
+    "EVIDENCE_FAILED",
+    "DAG_NODE_BLOCKED",
+    "RUN_ARTIFACT_MISSING",
+    "REPLAY_INCOMPLETE",
+    "SECURITY_POLICY_BLOCKED",
+    "MCP_UNHEALTHY",
+    "INTERNAL_ERROR",
+];

package/dist/contracts/evidence.d.ts

@@ -0,0 +1,23 @@
+import type { OMK_EVIDENCE_SCHEMA_VERSION } from "../version.js";
+export type EvidenceStatus = "passed" | "failed" | "missing" | "skipped" | "blocked";
+export type EvidenceKind = "file-exists" | "command-passes" | "git-diff-non-empty" | "summary-present" | "marker-present" | "screenshot-present" | "custom";
+export type EvidenceRecord = {
+    schemaVersion: typeof OMK_EVIDENCE_SCHEMA_VERSION;
+    runId: string;
+    nodeId?: string;
+    evidenceId: string;
+    kind: EvidenceKind;
+    status: EvidenceStatus;
+    required: boolean;
+    path?: string;
+    command?: string;
+    exitCode?: number;
+    observedAt: string;
+    message?: string;
+};
+export type EvidenceRef = {
+    schemaVersion?: typeof OMK_EVIDENCE_SCHEMA_VERSION;
+    evidenceId: string;
+    runId?: string;
+    path?: string;
+};

package/dist/contracts/evidence.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/goal.d.ts

@@ -0,0 +1,169 @@
+export type GoalStatus = "draft" | "planned" | "running" | "blocked" | "verifying" | "done" | "failed" | "cancelled" | "closed";
+export type RiskLevel = "low" | "medium" | "high";
+export type CriterionRequirement = "required" | "optional";
+export type EvidenceType = "criterion" | "artifact" | "constraint";
+export interface SuccessCriterion {
+    id: string;
+    description: string;
+    requirement: CriterionRequirement;
+    weight: number;
+    inferred: boolean;
+}
+export interface GoalConstraint {
+    id: string;
+    description: string;
+}
+export interface GoalRisk {
+    id: string;
+    description: string;
+    level: RiskLevel;
+}
+export interface ExpectedArtifact {
+    name: string;
+    path?: string;
+    gate?: "file-exists" | "command-pass" | "summary";
+}
+export type ActionAtomVerb = "bootstrap" | "inspect" | "plan" | "modify" | "verify" | "integrate" | "document" | "research" | "review" | "test" | "coordinate" | "route";
+export interface ActionAtom {
+    id: string;
+    label: string;
+    verb: ActionAtomVerb;
+    object: string;
+    evidenceTarget: string;
+    doneCondition: string;
+    roleHint?: string;
+    source: "heuristic" | "criterion" | "artifact" | "runtime" | "directive";
+}
+export type IntentDirectiveKind = "read-only" | "no-edits" | "scope" | "expected-output" | "constraint";
+export interface IntentDirective {
+    kind: IntentDirectiveKind;
+    value: string;
+    source: "explicit" | "heuristic";
+}
+export interface IntentCapabilityHints {
+    skills: string[];
+    mcpServers: string[];
+    tools: string[];
+    hooks: string[];
+    readOnly: boolean;
+    needsMcp: boolean;
+    needsSkills: boolean;
+    needsHooks: boolean;
+    ensembleVoters: string[];
+}
+export interface IntentConfidence {
+    overall: number;
+    primaryAction: number;
+    directives: number;
+    notes: string[];
+}
+export interface IntentDiagnostic {
+    kind: "redaction" | "directive" | "normalization" | "low-confidence" | "rewrite";
+    message: string;
+    count?: number;
+}
+export interface IntentRewrite {
+    summary: string;
+    accepted: boolean;
+    reason: string;
+}
+export interface IntentFrame {
+    schemaVersion: 2;
+    rawPromptDigest: string;
+    problem: string;
+    desiredOutcome: string;
+    constraints: string[];
+    entities: string[];
+    successCriteria: string[];
+    actionAtoms: ActionAtom[];
+    strict: true;
+    directives: IntentDirective[];
+    confidence: IntentConfidence;
+    capabilityHints: IntentCapabilityHints;
+    diagnostics: IntentDiagnostic[];
+    rewrite?: IntentRewrite;
+}
+export interface PromptNoveltyReport {
+    schemaVersion: 2;
+    action: "continue" | "replan" | "block" | "handoff" | "close";
+    recommendation: "continue" | "replan" | "block" | "handoff" | "close";
+    reason: string;
+    similarityToOriginal: number;
+    similarityToPrevious: number;
+    repeatedNodeNames: string[];
+    hasNewEvidence: boolean;
+    evidenceDelta: number;
+    progressDelta: number;
+    replayRisk: boolean;
+    oscillation: boolean;
+    targetAtomId?: string;
+}
+export interface NextActionContract {
+    action: "continue" | "replan" | "block" | "handoff" | "close";
+    targetId: string;
+    description: string;
+    evidenceTarget: string;
+    doneCondition: string;
+    actionAtom?: ActionAtom;
+}
+export interface GoalSpec {
+    schemaVersion: 1;
+    goalId: string;
+    title: string;
+    rawPrompt: string;
+    objective: string;
+    successCriteria: SuccessCriterion[];
+    constraints: GoalConstraint[];
+    nonGoals: string[];
+    risks: GoalRisk[];
+    expectedArtifacts: ExpectedArtifact[];
+    status: GoalStatus;
+    riskLevel: RiskLevel;
+    planRevision: number;
+    createdAt: string;
+    updatedAt: string;
+    runIds: string[];
+    intentFrame?: IntentFrame;
+    actionAtoms?: ActionAtom[];
+}
+export interface GoalEvidence {
+    criterionId: string;
+    passed: boolean;
+    message?: string;
+    ref?: string;
+    checkedAt: string;
+    evidenceType?: EvidenceType;
+}
+export interface ArtifactEvidence {
+    artifactName: string;
+    passed: boolean;
+    message: string;
+    filePath?: string;
+    commandOutput?: string;
+    url?: string;
+    checkedAt: string;
+}
+export interface MissingCriterion {
+    criterionId: string;
+    description: string;
+    requirement: CriterionRequirement;
+    priority: number;
+}
+export interface NextActionSuggestion {
+    type: "criterion" | "artifact" | "constraint" | "close";
+    targetId: string;
+    description: string;
+    reason: string;
+}
+export interface GoalScore {
+    requiredTotal: number;
+    requiredPassed: number;
+    optionalScore: number;
+    qualityGatePassed: boolean;
+    overall: "pass" | "fail" | "incomplete";
+}
+export interface GoalHistoryEntry {
+    at: string;
+    action: string;
+    detail?: Record<string, unknown>;
+}

package/dist/contracts/goal.js

@@ -0,0 +1,4 @@
+// Contract: src/contracts/goal.ts
+// Owner: Contract Worker (Phase 0)
+// Read-only for all other workers. Version-bump only via Integration Worker.
+export {};

package/dist/contracts/hud.d.ts

@@ -0,0 +1,17 @@
+import type { RunState } from "./orchestration.js";
+export interface MetricSnapshot {
+    cpuPercent: number;
+    memPercent: number;
+    diskPercent?: number;
+    tokenUsageToday: number;
+    sessionCountToday: number;
+}
+export interface HudRenderer {
+    render(state: RunState | null, metrics: MetricSnapshot): void;
+}
+export type LogHandler = (line: string, source: "stdout" | "stderr") => void;
+export interface WorkerLogStream {
+    runId: string;
+    workerId: string;
+    onLine: LogHandler;
+}

package/dist/contracts/hud.js

@@ -0,0 +1,4 @@
+// Contract: src/contracts/hud.ts
+// Owner: Contract Worker (Phase 0)
+// Read-only for all other workers. Version-bump only via Integration Worker.
+export {};

package/dist/contracts/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./decision.js";
+export * from "./envelope.js";
+export * from "./errors.js";
+export * from "./evidence.js";
+export * from "./provider.js";
+export * from "./proof.js";
+export * from "./run.js";
+export * from "./version.js";

package/dist/contracts/index.js

@@ -0,0 +1,8 @@
+export * from "./decision.js";
+export * from "./envelope.js";
+export * from "./errors.js";
+export * from "./evidence.js";
+export * from "./provider.js";
+export * from "./proof.js";
+export * from "./run.js";
+export * from "./version.js";

package/dist/contracts/orchestration.d.ts

@@ -0,0 +1,215 @@
+import type { Dag, DagNode } from "./dag.js";
+import type { TaskRunContext } from "./worker-context.js";
+export type ApprovalPolicy = "interactive" | "auto" | "yolo" | "block";
+export interface TaskResult {
+    success: boolean;
+    exitCode?: number;
+    stdout: string;
+    stderr: string;
+    metadata?: Record<string, unknown>;
+}
+export interface TimeoutPreset {
+    name: string;
+    timeoutMs: number;
+    description?: string;
+}
+export interface CronJob {
+    name: string;
+    schedule: string;
+    dagFile: string;
+    concurrencyPolicy: "allow" | "forbid" | "replace";
+    enabled: boolean;
+    catchup: boolean;
+    lastRunAt?: string;
+    nextRunAt?: string;
+    timeoutPreset?: string;
+}
+export interface CronRun {
+    jobName: string;
+    startedAt: string;
+    completedAt?: string;
+    success: boolean;
+    runId: string;
+    logPath: string;
+    error?: string;
+}
+export interface NodeMonitor {
+    nodeId: string;
+    runId: string;
+    lastHeartbeatAt: string;
+    stallThresholdMs: number;
+    status: "healthy" | "stalled" | "recovered";
+}
+export interface RunOptions {
+    runId: string;
+    workers: number;
+    approvalPolicy: ApprovalPolicy;
+    worktreeRoot?: string;
+    nodeTimeoutMs?: number;
+    timeoutPreset?: string;
+    heartbeatIntervalMs?: number;
+    runTimeoutMs?: number;
+}
+export type TaskType = "explore" | "implement" | "bugfix" | "refactor" | "research" | "review" | "plan" | "test" | "document" | "migrate" | "security" | "general";
+export type NextAction = "continue" | "replan" | "block" | "handoff" | "close";
+export type ExecutionPromptPolicy = "ask" | "auto" | "parallel" | "sequential";
+export type ExecutionStrategy = "parallel" | "sequential" | "plan-only" | "prompt";
+export type ExecutionSelectionSource = "cli" | "config" | "default" | "prompt" | "auto";
+export interface ExecutionSelectionDecision {
+    policy: ExecutionPromptPolicy;
+    source: ExecutionSelectionSource;
+    strategy: ExecutionStrategy;
+    reason: string;
+    isTTY: boolean;
+    isNonTrivial: boolean;
+}
+export interface UserIntent {
+    taskType: TaskType;
+    complexity: "simple" | "moderate" | "complex";
+    estimatedWorkers: number;
+    requiredRoles: string[];
+    isReadOnly: boolean;
+    needsResearch: boolean;
+    needsSecurityReview: boolean;
+    needsTesting: boolean;
+    needsDesignReview: boolean;
+    parallelizable: boolean;
+    rationale: string;
+}
+export type UserIntentLanguage = "ko" | "en" | "mixed" | "unknown";
+export type UserIntentTargetSurface = "cli" | "tui" | "nlp" | "harness" | "provider" | "mcp" | "tests" | "docs";
+export interface UserIntentAmbiguitySignal {
+    kind: string;
+    severity: "low" | "medium" | "high";
+    message: string;
+}
+export interface UserIntentV2 extends UserIntent {
+    confidence: number;
+    matchedRules: string[];
+    language: UserIntentLanguage;
+    domainTerms: string[];
+    targetSurfaces: UserIntentTargetSurface[];
+    extractedFiles: string[];
+    extractedCommands: string[];
+    ambiguitySignals: UserIntentAmbiguitySignal[];
+    routingHints: {
+        preferredExecutionStrategy?: ExecutionStrategy;
+        requireEvidence: boolean;
+        requireHarness: boolean;
+    };
+}
+export type RunRouteMode = "read-only" | "write" | "dangerous";
+export interface EvidenceRequirement {
+    kind: "file" | "diff" | "test" | "log" | "diagnostic" | string;
+    required: boolean;
+    description: string;
+}
+export interface RunRouteDecision {
+    intent: string;
+    selectedAgents: string[];
+    reason: string;
+    requiredEvidence: EvidenceRequirement[];
+    mode: RunRouteMode;
+}
+export interface RunCapabilityAssignment {
+    nodeId?: string;
+    agent?: string;
+    role?: string;
+    skills?: string[];
+    mcpServers?: string[];
+    hooks?: string[];
+    tools?: string[];
+    provider?: string;
+    model?: string;
+    rationale?: string;
+    source?: string;
+}
+export type EstimateConfidence = "low" | "medium" | "high";
+export interface RunProgressEstimate {
+    elapsedMs: number;
+    completedNodes: number;
+    runningNodes: number;
+    pendingNodes: number;
+    failedNodes: number;
+    blockedNodes: number;
+    totalNodes: number;
+    workerCount: number;
+    percentComplete: number;
+    fallbackDurationMs: number;
+    averageCompletedDurationMs?: number;
+    estimatedRemainingMs?: number;
+    estimatedCompletedAt?: string;
+    confidence: EstimateConfidence;
+    updatedAt: string;
+}
+export interface TeamRuntimeWindowStatus {
+    index: number;
+    name: string;
+    role: "coordinator" | "worker" | "reviewer" | "hud" | "unknown";
+    nodeId?: string;
+    status: "expected" | "present" | "missing";
+    paneCount?: number;
+}
+export interface TeamRuntimeStatus {
+    session: string;
+    status: "starting" | "ready" | "attached" | "detached" | "missing";
+    workerCount: number;
+    reviewerCount: number;
+    coordinatorPanes: number;
+    statePath: string;
+    windows: TeamRuntimeWindowStatus[];
+    updatedAt: string;
+}
+export interface RunState {
+    schemaVersion: 1;
+    runId: string;
+    goalId?: string;
+    goal?: {
+        title?: string;
+        objective?: string;
+    };
+    goalSnapshot?: {
+        title: string;
+        objective: string;
+        successCriteria: Array<{
+            id: string;
+            description: string;
+            requirement: string;
+        }>;
+    };
+    nodes: DagNode[];
+    startedAt: string;
+    completedAt?: string;
+    estimate?: RunProgressEstimate;
+    iterationCount?: number;
+    maxIterations?: number;
+    /** ISO timestamp of the last time this state was persisted (activity or commit). */
+    updatedAt?: string;
+    /** ISO timestamp of the last meaningful worker activity (thinking update, node start/complete). */
+    lastActivityAt?: string;
+    /** ISO timestamp of the last heartbeat emit (may be more frequent than persist). */
+    lastHeartbeatAt?: string;
+    /** Monotonically-increasing sequence number for activity ordering. */
+    activitySeq?: number;
+    /** tmux/team runtime status snapshot for `omk team` and HUD reporting. */
+    teamRuntime?: TeamRuntimeStatus;
+    routeDecision?: RunRouteDecision;
+    capabilityAssignments?: RunCapabilityAssignment[] | Record<string, RunCapabilityAssignment>;
+}
+export interface RunResult {
+    state: RunState;
+    success: boolean;
+}
+export interface TaskRunner {
+    run(node: DagNode, env: Record<string, string>, signal?: AbortSignal, context?: TaskRunContext): Promise<TaskResult>;
+    /** Optional live-thinking callback so the executor can surface runner progress. */
+    onThinking?: (thinking: string) => void;
+    /** Create a new runner with an isolated onThinking callback (parallel-safe). */
+    fork?: (onThinking?: (thinking: string) => void) => TaskRunner;
+}
+export interface DagExecutor {
+    execute(dag: Dag, runner: TaskRunner, options: RunOptions): Promise<RunResult>;
+    onStateChange(handler: (state: RunState) => void): () => void;
+    onNodeStart?(handler: (node: DagNode) => void): () => void;
+    onNodeComplete?(handler: (node: DagNode, result: TaskResult) => void): () => void;
+}

package/dist/contracts/orchestration.js

@@ -0,0 +1,4 @@
+// Contract: src/contracts/orchestration.ts
+// Owner: Contract Worker (Phase 0)
+// Read-only for all other workers. Version-bump only via Integration Worker.
+export {};

package/dist/contracts/proof.d.ts

@@ -0,0 +1,32 @@
+import type { OMK_PROOF_BUNDLE_SCHEMA_VERSION, OMK_RUNTIME_VERSION } from "../version.js";
+export type ProofBundleScenario = "no-kimi-smoke" | "evidence-block" | "fallback-route" | "dag-dependent-block" | "replay-inspect" | "graph-audit" | "example-generation" | "doctor-provider" | "native-safety" | "contract-version-smoke";
+export type ProofBundleVerdict = "passed" | "failed" | "partial";
+export type ProofBundleFiles = {
+    rawPrompt: string;
+    commands: string;
+    stdout?: string;
+    stderr?: string;
+    verifyJson: string;
+    decisionsJsonl: string;
+    runManifest: string;
+    evidenceJsonl: string;
+    diffPatch?: string;
+    replay?: string;
+    inspectJson?: string;
+    limitations: string;
+};
+export type ProofBundle = {
+    schemaVersion: typeof OMK_PROOF_BUNDLE_SCHEMA_VERSION;
+    proofId: string;
+    title: string;
+    omkVersion: string;
+    runtimeVersion: typeof OMK_RUNTIME_VERSION;
+    commit: string;
+    runId: string;
+    providerPolicy: string;
+    scenario: ProofBundleScenario;
+    files: ProofBundleFiles;
+    verdict: ProofBundleVerdict;
+    knownLimitations: string[];
+    checksums: Record<string, string>;
+};

package/dist/contracts/proof.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/provider.d.ts

@@ -0,0 +1,35 @@
+import type { OMK_PROVIDER_SCHEMA_VERSION } from "../version.js";
+export type ProviderMaturity = "stable" | "alpha" | "experimental" | "unsupported";
+export type ProviderCapability = {
+    schemaVersion: typeof OMK_PROVIDER_SCHEMA_VERSION;
+    provider: string;
+    maturity: ProviderMaturity;
+    roles: {
+        writer: boolean;
+        reviewer: boolean;
+        qa: boolean;
+        research: boolean;
+        advisory: boolean;
+        mergeAuthority: boolean;
+    };
+    features: {
+        cli: boolean;
+        api: boolean;
+        streaming: boolean;
+        mcp: boolean;
+        tools: boolean;
+        screenshots: boolean;
+        worktreeSafe: boolean;
+    };
+    health: {
+        available: boolean;
+        authenticated: boolean;
+        latencyMs?: number;
+        lastCheckedAt: string;
+        warningCodes: string[];
+    };
+};
+export type ProviderPolicy = {
+    provider: string;
+    mode?: "auto" | "pinned" | "fallback";
+};

package/dist/contracts/provider.js

@@ -0,0 +1 @@
+export {};