anantham-v2 2.0.0-alpha.1

package/dist/domain/evaluation.d.ts.map

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

package/dist/domain/evaluation.js

@@ -0,0 +1,176 @@
+import { z } from "zod";
+/**
+ * Benchmark Scenario Categories.
+ * PRD Part 3 Section 80–120.
+ */
+export const BenchmarkCategorySchema = z.enum([
+    "task_execution",
+    "tool_use",
+    "multi_step_agent",
+    "parallel_execution",
+    "workflow_dag",
+    "approval_gate",
+    "background_job",
+    "lease_fencing",
+    "crash_recovery",
+    "remote_node",
+    "mcp_interaction",
+    "plugin_lifecycle",
+    "skill_execution",
+    "webhook_integration",
+    "policy_denial",
+    "prompt_injection",
+    "secret_leakage",
+    "project_isolation",
+    "artifact_integrity",
+    "false_completion",
+]);
+/**
+ * Evaluation Assertion Types.
+ * PRD Part 3 Section 94.
+ */
+export const EvaluationAssertionTypeSchema = z.enum([
+    "STATE_EQUALS",
+    "EVENT_EXISTS",
+    "ARTIFACT_EXISTS",
+    "POLICY_DECISION",
+    "TOOL_COUNT_LIMIT",
+    "RESOURCE_LIMIT",
+    "SECRET_ABSENT",
+    "PROJECT_CONTAINMENT",
+    "RECOVERY_SURVIVED",
+]);
+/**
+ * Machine-verifiable objective evaluation assertion.
+ */
+export const EvaluationAssertionSchema = z.object({
+    id: z.string().min(1),
+    type: EvaluationAssertionTypeSchema,
+    target: z.string().min(1), // e.g. "task.status", "event.type", "artifact.path"
+    expected: z.unknown(), // e.g. "completed", "policy.denied", hash string
+    description: z.string().min(1),
+    criticality: z.enum(["CRITICAL", "OPTIONAL"]).default("CRITICAL"),
+});
+/**
+ * Benchmark Case Contract.
+ */
+export const BenchmarkCaseSchema = z.object({
+    caseId: z.string().min(1),
+    datasetId: z.string().min(1),
+    datasetVersion: z.string().min(1),
+    name: z.string().min(1),
+    description: z.string().min(1),
+    category: BenchmarkCategorySchema,
+    difficulty: z.enum(["EASY", "MEDIUM", "HARD", "ADVERSARIAL"]).default("MEDIUM"),
+    scenario: z.string().min(1),
+    inputs: z.record(z.unknown()).default({}),
+    requiredTools: z.array(z.string()).default([]),
+    requiredCapabilities: z.array(z.string()).default([]),
+    assertions: z.array(EvaluationAssertionSchema),
+    timeoutMs: z.number().int().positive().default(30000),
+    tags: z.array(z.string()).default([]),
+});
+/**
+ * Benchmark Dataset Contract.
+ */
+export const BenchmarkDatasetSchema = z.object({
+    datasetId: z.string().min(1),
+    version: z.string().min(1),
+    name: z.string().min(1),
+    description: z.string().min(1),
+    cases: z.array(BenchmarkCaseSchema),
+});
+/**
+ * Result of evaluating an individual assertion.
+ */
+export const AssertionEvaluationResultSchema = z.object({
+    assertionId: z.string().min(1),
+    passed: z.boolean(),
+    expected: z.unknown(),
+    observed: z.unknown(),
+    evidence: z.string(),
+    criticality: z.enum(["CRITICAL", "OPTIONAL"]),
+});
+/**
+ * Result of evaluating a single benchmark case.
+ */
+export const EvaluationCaseResultSchema = z.object({
+    caseId: z.string().min(1),
+    status: z.enum(["PASS", "FAIL", "PARTIAL", "INCONCLUSIVE"]),
+    score: z.number().min(0).max(100),
+    assertionResults: z.array(AssertionEvaluationResultSchema),
+    evidence: z.record(z.unknown()).default({}),
+    failureClassification: z
+        .enum([
+        "NONE",
+        "BENCHMARK_DEFINITION",
+        "RUNTIME",
+        "POLICY",
+        "SECURITY",
+        "TIMEOUT",
+        "ASSERTION",
+        "RECOVERY",
+        "RESOURCE",
+    ])
+        .default("NONE"),
+    durationMs: z.number().min(0),
+    startedAt: z.string().min(1),
+    completedAt: z.string().min(1),
+});
+/**
+ * Provenance metadata for an evaluation run.
+ */
+export const EvaluationProvenanceSchema = z.object({
+    runtimeVersion: z.string().min(1),
+    gitCommit: z.string().min(1),
+    datasetId: z.string().min(1),
+    datasetVersion: z.string().min(1),
+    modelProfile: z.string().default("default"),
+    seed: z.number().optional(),
+    environment: z.string().default("node-test"),
+});
+/**
+ * Authoritative Evaluation Run.
+ */
+export const EvaluationRunSchema = z.object({
+    id: z.string().min(1),
+    datasetId: z.string().min(1),
+    datasetVersion: z.string().min(1),
+    status: z.enum(["RUNNING", "COMPLETED", "FAILED", "CANCELLED"]),
+    summary: z.object({
+        totalCases: z.number().int().min(0),
+        passedCases: z.number().int().min(0),
+        failedCases: z.number().int().min(0),
+        partialCases: z.number().int().min(0),
+        inconclusiveCases: z.number().int().min(0),
+        overallScore: z.number().min(0).max(100),
+    }),
+    results: z.array(EvaluationCaseResultSchema),
+    provenance: EvaluationProvenanceSchema,
+    createdAt: z.string().min(1),
+    completedAt: z.string().optional(),
+});
+/**
+ * Regression analysis comparing two evaluation runs.
+ */
+export const RegressionComparisonSchema = z.object({
+    baselineRunId: z.string().min(1),
+    currentRunId: z.string().min(1),
+    datasetId: z.string().min(1),
+    scoreDelta: z.number(),
+    newFailures: z.array(z.string()),
+    fixedFailures: z.array(z.string()),
+    unchangedFailures: z.array(z.string()),
+    regressionDetected: z.boolean(),
+});
+/**
+ * Comprehensive Evaluation Report.
+ */
+export const EvaluationReportSchema = z.object({
+    reportId: z.string().min(1),
+    runId: z.string().min(1),
+    generatedAt: z.string().min(1),
+    run: EvaluationRunSchema,
+    regression: RegressionComparisonSchema.optional(),
+});
+//# sourceMappingURL=evaluation.js.map

package/dist/domain/evaluation.js.map

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

package/dist/domain/event.d.ts

@@ -0,0 +1,253 @@
+import { z } from "zod";
+/**
+ * Authoritative actor categories.
+ * PRD Part 1 Section 38.
+ */
+export declare const ActorTypeSchema: z.ZodEnum<["user", "agent", "system", "tool", "mcp", "verifier"]>;
+export type ActorType = z.infer<typeof ActorTypeSchema>;
+/**
+ * Canonical event type constants.
+ * PRD Part 1 Section 39.
+ */
+export declare const EventTypes: {
+    readonly SESSION_CREATED: "session.created";
+    readonly SESSION_RENAMED: "session.renamed";
+    readonly SESSION_FORKED: "session.forked";
+    readonly SESSION_RESUMED: "session.resumed";
+    readonly SESSION_PAUSED: "session.paused";
+    readonly SESSION_COMPLETED: "session.completed";
+    readonly SESSION_DELETED: "session.deleted";
+    readonly TASK_CREATED: "task.created";
+    readonly TASK_STARTED: "task.started";
+    readonly TASK_CLAIM_REQUESTED: "task.claim_requested";
+    readonly TASK_CLAIMED: "task.claimed";
+    readonly TASK_LEASE_ACQUIRED: "task.lease_acquired";
+    readonly TASK_HEARTBEAT: "task.heartbeat";
+    readonly TASK_LEASE_RENEWED: "task.lease_renewed";
+    readonly TASK_LEASE_EXPIRED: "task.lease_expired";
+    readonly TASK_RECLAIMED: "task.reclaimed";
+    readonly TASK_RELEASED: "task.released";
+    readonly TASK_PAUSED: "task.paused";
+    readonly TASK_RESUMED: "task.resumed";
+    readonly TASK_STEERED: "task.steered";
+    readonly TASK_CANCELLED: "task.cancelled";
+    readonly TASK_COMPLETED: "task.completed";
+    readonly TASK_FAILED: "task.failed";
+    readonly MODEL_REQUESTED: "model.requested";
+    readonly MODEL_RESPONDED: "model.responded";
+    readonly MODEL_FAILED: "model.failed";
+    readonly TOOL_REQUESTED: "tool.requested";
+    readonly TOOL_APPROVED: "tool.approved";
+    readonly TOOL_DENIED: "tool.denied";
+    readonly TOOL_COMPLETED: "tool.completed";
+    readonly TOOL_FAILED: "tool.failed";
+    readonly SIDE_EFFECT_REQUESTED: "side_effect.requested";
+    readonly SIDE_EFFECT_STARTED: "side_effect.started";
+    readonly SIDE_EFFECT_COMPLETED: "side_effect.completed";
+    readonly SIDE_EFFECT_FAILED: "side_effect.failed";
+    readonly SIDE_EFFECT_UNKNOWN: "side_effect.unknown";
+    readonly SIDE_EFFECT_DIVERGENCE: "side_effect.divergence";
+    readonly MCP_REGISTERED: "mcp.registered";
+    readonly MCP_DEREGISTERED: "mcp.deregistered";
+    readonly MCP_CONNECTED: "mcp.connected";
+    readonly MCP_DISCONNECTED: "mcp.disconnected";
+    readonly MCP_DISCOVERED: "mcp.discovered";
+    readonly MCP_HEALTH_CHANGED: "mcp.health_changed";
+    readonly MCP_CIRCUIT_BROKEN: "mcp.circuit_broken";
+    readonly MCP_TOOL_CALLED: "mcp.tool.called";
+    readonly MCP_RESOURCE_READ: "mcp.resource.read";
+    readonly MCP_PROMPT_RETRIEVED: "mcp.prompt.retrieved";
+    readonly MCP_FAILED: "mcp.failed";
+    readonly PLUGIN_DISCOVERED: "plugin.discovered";
+    readonly PLUGIN_INSPECTED: "plugin.inspected";
+    readonly PLUGIN_VALIDATED: "plugin.validated";
+    readonly PLUGIN_INSTALLED: "plugin.installed";
+    readonly PLUGIN_ACTIVATED: "plugin.activated";
+    readonly PLUGIN_DEACTIVATED: "plugin.deactivated";
+    readonly PLUGIN_DISABLED: "plugin.disabled";
+    readonly PLUGIN_UNLOADED: "plugin.unloaded";
+    readonly PLUGIN_RELOADED: "plugin.reloaded";
+    readonly PLUGIN_UPDATED: "plugin.updated";
+    readonly PLUGIN_ROLLED_BACK: "plugin.rolled_back";
+    readonly PLUGIN_HEALTH_CHANGED: "plugin.health_changed";
+    readonly PLUGIN_FAILED: "plugin.failed";
+    readonly SKILL_DISCOVERED: "skill.discovered";
+    readonly SKILL_VALIDATED: "skill.validated";
+    readonly SKILL_INSTALLED: "skill.installed";
+    readonly SKILL_ENABLED: "skill.enabled";
+    readonly SKILL_DISABLED: "skill.disabled";
+    readonly SKILL_LOADED: "skill.loaded";
+    readonly SKILL_EXECUTED: "skill.executed";
+    readonly SKILL_TESTED: "skill.tested";
+    readonly SKILL_RELOADED: "skill.reloaded";
+    readonly SKILL_FAILED: "skill.failed";
+    readonly SKILL_REMOVED: "skill.removed";
+    readonly HOOK_REGISTERED: "hook.registered";
+    readonly HOOK_VALIDATED: "hook.validated";
+    readonly HOOK_ENABLED: "hook.enabled";
+    readonly HOOK_DISABLED: "hook.disabled";
+    readonly HOOK_TRIGGERED: "hook.triggered";
+    readonly HOOK_STARTED: "hook.started";
+    readonly HOOK_COMPLETED: "hook.completed";
+    readonly HOOK_FAILED: "hook.failed";
+    readonly HOOK_TIMED_OUT: "hook.timed_out";
+    readonly HOOK_BLOCKED: "hook.blocked";
+    readonly HOOK_REMOVED: "hook.removed";
+    readonly AGENT_REGISTERED: "agent.registered";
+    readonly AGENT_CONFIGURED: "agent.configured";
+    readonly AGENT_RESOLVING: "agent.resolving";
+    readonly AGENT_READY: "agent.ready";
+    readonly AGENT_STARTED: "agent.started";
+    readonly AGENT_PAUSED: "agent.paused";
+    readonly AGENT_RESUMED: "agent.resumed";
+    readonly AGENT_BLOCKED: "agent.blocked";
+    readonly AGENT_FAILED: "agent.failed";
+    readonly AGENT_COMPLETED: "agent.completed";
+    readonly AGENT_STOPPED: "agent.stopped";
+    readonly AGENT_REMOVED: "agent.removed";
+    readonly SUBAGENT_SPAWNED: "subagent.spawned";
+    readonly SUBAGENT_DELEGATED: "subagent.delegated";
+    readonly SUBAGENT_COMPLETED: "subagent.completed";
+    readonly SUBAGENT_FAILED: "subagent.failed";
+    readonly TEAM_CREATED: "team.created";
+    readonly TEAM_UPDATED: "team.updated";
+    readonly TEAM_STARTED: "team.started";
+    readonly TEAM_PAUSED: "team.paused";
+    readonly TEAM_COMPLETED: "team.completed";
+    readonly TEAM_CANCELLED: "team.cancelled";
+    readonly TEAM_MEMBER_JOINED: "team.member.joined";
+    readonly TEAM_MEMBER_LEFT: "team.member.left";
+    readonly PEER_MESSAGE_SENT: "peer.message.sent";
+    readonly HANDOFF_PREPARED: "handoff.prepared";
+    readonly HANDOFF_ACCEPTED: "handoff.accepted";
+    readonly HANDOFF_REJECTED: "handoff.rejected";
+    readonly WORKSPACE_CREATED: "workspace.created";
+    readonly WORKSPACE_ACTIVATED: "workspace.activated";
+    readonly WORKSPACE_CHANGED: "workspace.changed";
+    readonly WORKSPACE_CONFLICT_DETECTED: "workspace.conflict_detected";
+    readonly WORKSPACE_INTEGRATION_STARTED: "workspace.integration_started";
+    readonly WORKSPACE_INTEGRATED: "workspace.integrated";
+    readonly WORKSPACE_INTEGRATION_REJECTED: "workspace.integration_rejected";
+    readonly WORKSPACE_QUARANTINED: "workspace.quarantined";
+    readonly WORKSPACE_RECOVERED: "workspace.recovered";
+    readonly WORKSPACE_CLEANED: "workspace.cleaned";
+    readonly WORKSPACE_FAILED: "workspace.failed";
+    readonly WORKFLOW_REGISTERED: "workflow.registered";
+    readonly WORKFLOW_VALIDATED: "workflow.validated";
+    readonly WORKFLOW_STARTED: "workflow.started";
+    readonly WORKFLOW_PAUSED: "workflow.paused";
+    readonly WORKFLOW_RESUMED: "workflow.resumed";
+    readonly WORKFLOW_TASK_STARTED: "workflow.task_started";
+    readonly WORKFLOW_TASK_COMPLETED: "workflow.task_completed";
+    readonly WORKFLOW_TASK_FAILED: "workflow.task_failed";
+    readonly WORKFLOW_CONDITION_EVALUATED: "workflow.condition_evaluated";
+    readonly WORKFLOW_COMPLETED: "workflow.completed";
+    readonly WORKFLOW_FAILED: "workflow.failed";
+    readonly WORKFLOW_CANCELLED: "workflow.cancelled";
+    readonly JOB_CREATED: "job.created";
+    readonly JOB_QUEUED: "job.queued";
+    readonly JOB_CLAIMED: "job.claimed";
+    readonly JOB_STARTED: "job.started";
+    readonly JOB_HEARTBEAT: "job.heartbeat";
+    readonly JOB_CHECKPOINTED: "job.checkpointed";
+    readonly JOB_CANCEL_REQUESTED: "job.cancel_requested";
+    readonly JOB_CANCELLED: "job.cancelled";
+    readonly JOB_TIMED_OUT: "job.timed_out";
+    readonly JOB_RECLAIMED: "job.reclaimed";
+    readonly JOB_RETRYING: "job.retrying";
+    readonly JOB_COMPLETED: "job.completed";
+    readonly JOB_FAILED: "job.failed";
+    readonly JOB_RECOVERY_REQUIRED: "job.recovery_required";
+    readonly NODE_REGISTERED: "node.registered";
+    readonly NODE_CONNECTED: "node.connected";
+    readonly NODE_DISCONNECTED: "node.disconnected";
+    readonly NODE_HEARTBEAT: "node.heartbeat";
+    readonly NODE_DRAINING: "node.draining";
+    readonly NODE_QUARANTINED: "node.quarantined";
+    readonly DISPATCH_CREATED: "dispatch.created";
+    readonly DISPATCH_SENT: "dispatch.sent";
+    readonly DISPATCH_ACCEPTED: "dispatch.accepted";
+    readonly DISPATCH_REJECTED: "dispatch.rejected";
+    readonly DISPATCH_COMPLETED: "dispatch.completed";
+    readonly DISPATCH_FAILED: "dispatch.failed";
+    readonly DISPATCH_TIMED_OUT: "dispatch.timed_out";
+    readonly DISPATCH_RECLAIMED: "dispatch.reclaimed";
+    readonly REMOTE_RESULT_RECEIVED: "remote.result_received";
+    readonly REMOTE_RESULT_REJECTED: "remote.result_rejected";
+    readonly REMOTE_SPLIT_BRAIN_DETECTED: "remote.split_brain_detected";
+    readonly CHECKPOINT_CREATED: "checkpoint.created";
+    readonly CHECKPOINT_RESTORED: "checkpoint.restored";
+    readonly CHECKPOINT_INVALIDATED: "checkpoint.invalidated";
+    readonly CONTEXT_BUILT: "context.built";
+    readonly CONTEXT_COMPACTED: "context.compacted";
+    readonly MEMORY_PROPOSED: "memory.proposed";
+    readonly MEMORY_WRITTEN: "memory.written";
+    readonly MEMORY_DELETED: "memory.deleted";
+    readonly MEMORY_INVALIDATED: "memory.invalidated";
+    readonly ARTIFACT_CREATED: "artifact.created";
+    readonly ARTIFACT_UPDATED: "artifact.updated";
+    readonly VERIFICATION_STARTED: "verification.started";
+    readonly VERIFICATION_COMPLETED: "verification.completed";
+    readonly VERIFICATION_FAILED: "verification.failed";
+    readonly INTEGRATION_REGISTERED: "integration.registered";
+    readonly INTEGRATION_WEBHOOK_RECEIVED: "integration.webhook_received";
+    readonly INTEGRATION_WEBHOOK_DELIVERED: "integration.webhook_delivered";
+    readonly INTEGRATION_WEBHOOK_FAILED: "integration.webhook_failed";
+    readonly INTEGRATION_CICD_TRIGGERED: "integration.cicd_triggered";
+};
+export type EventType = (typeof EventTypes)[keyof typeof EventTypes] | (string & {});
+/**
+ * Authoritative HarnessEvent contract.
+ * PRD Part 1 Section 38.
+ */
+export declare const HarnessEventSchema: z.ZodObject<{
+    id: z.ZodString;
+    schemaVersion: z.ZodNumber;
+    projectId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+    type: z.ZodString;
+    actor: z.ZodEnum<["user", "agent", "system", "tool", "mcp", "verifier"]>;
+    timestamp: z.ZodString;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    correlationId: z.ZodOptional<z.ZodString>;
+    parentEventId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    id: string;
+    schemaVersion: number;
+    actor: "system" | "user" | "agent" | "tool" | "mcp" | "verifier";
+    timestamp: string;
+    payload: Record<string, unknown>;
+    projectId?: string | undefined;
+    sessionId?: string | undefined;
+    taskId?: string | undefined;
+    agentId?: string | undefined;
+    correlationId?: string | undefined;
+    parentEventId?: string | undefined;
+}, {
+    type: string;
+    id: string;
+    schemaVersion: number;
+    actor: "system" | "user" | "agent" | "tool" | "mcp" | "verifier";
+    timestamp: string;
+    payload: Record<string, unknown>;
+    projectId?: string | undefined;
+    sessionId?: string | undefined;
+    taskId?: string | undefined;
+    agentId?: string | undefined;
+    correlationId?: string | undefined;
+    parentEventId?: string | undefined;
+}>;
+export type HarnessEvent = z.infer<typeof HarnessEventSchema>;
+/**
+ * Enforces deep immutability on a committed HarnessEvent.
+ * Section 40: "Once committed, an authoritative event cannot be edited in place."
+ */
+export declare function freezeEvent<T extends HarnessEvent>(event: T): Readonly<T>;
+/**
+ * Verifies if an event is frozen.
+ */
+export declare function isEventFrozen(event: HarnessEvent): boolean;
+//# sourceMappingURL=event.d.ts.map

package/dist/domain/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/domain/event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,eAAe,mEAO1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkOb,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAgBzE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAE1D"}