@ai-dev-orchestrator/schemas 0.1.1

package/dist/dashboard/dashboard-domain.js

@@ -0,0 +1,305 @@
+import { z } from 'zod/v4';
+import { approvalStatusSchema } from '../artifacts/agreement-artifacts';
+import { artifactRefSchema, artifactTypeSchema } from '../artifacts/artifact-system';
+import { qualityGateConfigSchema } from '../config/configuration';
+import { healthStatusSchema } from '../observability/metrics';
+import { budgetExhaustionContextSchema } from '../persistence/state-persistence';
+import { liveRequestKindSchema, permissionDecisionActionSchema, roleTrustLevelSchema, sessionTransportSchema, } from '../shared/string-enums';
+export const runStatusSchema = z.enum([
+    'running',
+    'paused',
+    'waiting',
+    'completed',
+    'aborted',
+    'failed',
+    'interrupted',
+]);
+export const dashboardWaitingContextSchema = z.object({
+    reason: z.string(),
+    requiredInput: z.string(),
+    requestingState: z.string(),
+    autoResumeSafe: z.boolean(),
+    presentedArtifacts: z.array(artifactRefSchema).readonly(),
+    waitingSince: z.string(),
+    budgetExhaustion: budgetExhaustionContextSchema.optional(),
+    liveSessionId: z.string().optional(),
+    pendingRequestId: z.string().optional(),
+    liveRequestType: liveRequestKindSchema.optional(),
+    sessionTransport: sessionTransportSchema.optional(),
+});
+export const dashboardSessionViewSchema = z.object({
+    sessionId: z.string(),
+    runId: z.string(),
+    role: z.string(),
+    stateId: z.string(),
+    transport: sessionTransportSchema,
+    state: z.string(),
+    pendingRequestKind: liveRequestKindSchema.optional(),
+    pendingRequestId: z.string().optional(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    expiresAt: z.string().optional(),
+    error: z.string().optional(),
+});
+export const runStateViewSchema = z.object({
+    runId: z.string(),
+    status: runStatusSchema,
+    currentState: z.string(),
+    previousState: z.string().nullable(),
+    startedAt: z.string(),
+    stateEnteredAt: z.string(),
+    elapsedMs: z.number(),
+    transitionCount: z.number(),
+    isWaitingForHuman: z.boolean(),
+    waitingReason: z.string().optional(),
+    waitingContext: dashboardWaitingContextSchema.optional(),
+    repoRoot: z.string().optional(),
+    processAlive: z.boolean().optional(),
+});
+export const parallelInfoSchema = z.object({
+    type: z.enum(['fork', 'join']),
+    parallelRoles: z.array(z.string()).readonly().optional(),
+    roleDurations: z.record(z.string(), z.number()).optional(),
+    dynamicRole: z.string().optional(),
+    dynamicWorkerCount: z.number().optional(),
+});
+export const stateNodeSchema = z.object({
+    id: z.string(),
+    type: z.string(),
+    label: z.string(),
+    visited: z.boolean(),
+    current: z.boolean(),
+    timeSpentMs: z.number(),
+    visitCount: z.number(),
+    parallelInfo: parallelInfoSchema.optional(),
+    roles: z.array(z.string()).readonly().optional(),
+    /** Script names from `run_script` entry actions. */
+    scripts: z.array(z.string()).readonly().optional(),
+});
+export const transitionEdgeSchema = z.object({
+    from: z.string(),
+    to: z.string(),
+    trigger: z.string(),
+    traversed: z.boolean(),
+    traversalCount: z.number(),
+});
+export const workflowStateViewSchema = z.object({
+    runId: z.string(),
+    states: z.array(stateNodeSchema).readonly(),
+    transitions: z.array(transitionEdgeSchema).readonly(),
+    currentState: z.string(),
+    visitedStates: z.array(z.string()).readonly(),
+    stateHistory: z.array(z.string()).readonly(),
+    abortReason: z.string().optional(),
+});
+export const artifactEntryViewSchema = z.object({
+    ref: artifactRefSchema,
+    type: artifactTypeSchema,
+    name: z.string(),
+    version: z.number(),
+    producedBy: z.string(),
+    createdAt: z.string(),
+    sizeBytes: z.number(),
+    verdict: approvalStatusSchema.optional(),
+});
+export const artifactInventoryViewSchema = z.object({
+    runId: z.string(),
+    artifacts: z.array(artifactEntryViewSchema).readonly(),
+    totalCount: z.number(),
+    totalSizeBytes: z.number(),
+    byType: z.record(z.string(), z.number()),
+});
+export const artifactVersionViewSchema = z.object({
+    ref: artifactRefSchema,
+    version: z.number(),
+    checksum: z.string(),
+    createdAt: z.string(),
+});
+export const artifactDetailViewSchema = z.object({
+    ref: artifactRefSchema,
+    type: artifactTypeSchema,
+    name: z.string(),
+    currentVersion: z.number(),
+    producedBy: z.string(),
+    createdAt: z.string(),
+    sizeBytes: z.number(),
+    versions: z.array(artifactVersionViewSchema).readonly(),
+    dependsOn: z.array(artifactRefSchema).readonly(),
+    dependedOnBy: z.array(artifactRefSchema).readonly(),
+});
+export const artifactContentViewSchema = z.object({
+    content: z.string(),
+    contentType: z.enum(['markdown', 'json', 'text', 'diff']),
+    sizeBytes: z.number(),
+});
+export const contractProgressViewSchema = z.object({
+    contractId: z.string(),
+    currentIteration: z.number(),
+    maxIterations: z.number(),
+    status: z.string(),
+    findingsTotal: z.number(),
+    findingsResolved: z.number(),
+    judgeArbitrations: z.number(),
+});
+export const iterationProgressViewSchema = z.object({
+    runId: z.string(),
+    contracts: z.array(contractProgressViewSchema).readonly(),
+    totalIterations: z.number(),
+    totalFindings: z.number(),
+    resolvedFindings: z.number(),
+});
+export const findingEntryViewSchema = z.object({
+    id: z.string(),
+    severity: z.string(),
+    status: z.string(),
+    category: z.string(),
+    description: z.string(),
+    source: z.string(),
+    iteration: z.number(),
+});
+export const findingsViewSchema = z.object({
+    runId: z.string(),
+    findings: z.array(findingEntryViewSchema).readonly(),
+    totalCount: z.number(),
+    bySeverity: z.record(z.string(), z.number()),
+    byStatus: z.record(z.string(), z.number()),
+});
+export const roleUsageViewSchema = z.object({
+    role: z.string(),
+    inputTokens: z.number(),
+    outputTokens: z.number(),
+    dispatches: z.number(),
+    totalDurationMs: z.number(),
+});
+export const usageBreakdownViewSchema = z.object({
+    runId: z.string(),
+    totalInputTokens: z.number(),
+    totalOutputTokens: z.number(),
+    totalTokens: z.number(),
+    byRole: z.array(roleUsageViewSchema).readonly(),
+    budgetSummary: z
+        .object({
+        configuredMaxTokens: z.number().nullable(),
+        budgetExceeded: z.boolean(),
+        alertThresholds: z.array(z.number()).readonly().optional(),
+        crossedThresholds: z.array(z.number()).readonly().optional(),
+    })
+        .optional(),
+});
+export const runSummaryViewSchema = z.object({
+    runId: z.string(),
+    repository: z.string(),
+    repoRoot: z.string().optional(),
+    workflow: z.string(),
+    status: z.string(),
+    startedAt: z.string(),
+    completedAt: z.string(),
+    durationMs: z.number(),
+    totalArtifacts: z.number(),
+    totalTokens: z.number(),
+    totalInputTokens: z.number(),
+    totalOutputTokens: z.number(),
+    finalState: z.string(),
+    sources: z.array(z.string()).readonly().optional(),
+});
+export const roleAssignmentViewSchema = z.object({
+    role: z.string(),
+    model: z.string().optional(),
+    dispatchType: z.string().optional(),
+    runner: z.string().optional(),
+    maxTokens: z.number().nullable().optional(),
+    timeoutMs: z.number().optional(),
+    maxTurns: z.number().optional(),
+});
+export const runConfigViewSchema = z.object({
+    roles: z.array(roleAssignmentViewSchema).readonly(),
+    iterationLimits: z.record(z.string(), z.number()),
+    qualityGates: qualityGateConfigSchema,
+    budget: z.object({
+        maxTokensPerRun: z.number().nullable(),
+    }),
+    sources: z.array(z.string()).readonly().optional(),
+    workflow: z.string().optional(),
+});
+export const dashboardEventTypeSchema = z.enum([
+    'state_changed',
+    'artifact_produced',
+    'finding_added',
+    'finding_resolved',
+    'iteration_completed',
+    'worker_dispatched',
+    'worker_completed',
+    'script_started',
+    'script_completed',
+    'health_changed',
+    'run_started',
+    'run_completed',
+    'run_failed',
+    'run_aborted',
+    'permission_requested',
+    'permission_resolved',
+    'clarification_requested',
+    'clarification_resolved',
+]);
+export const dashboardEventSchema = z.object({
+    type: dashboardEventTypeSchema,
+    timestamp: z.string(),
+    runId: z.string().optional(),
+    data: z.record(z.string(), z.unknown()).optional(),
+});
+export const subsystemHealthViewSchema = z.object({
+    name: z.string(),
+    status: healthStatusSchema,
+    lastCheckedAt: z.string(),
+    consecutiveFailures: z.number(),
+    message: z.string(),
+    version: z.string().optional(),
+});
+export const systemHealthViewSchema = z.object({
+    timestamp: z.string(),
+    overallStatus: healthStatusSchema,
+    subsystems: z.array(subsystemHealthViewSchema).readonly(),
+});
+export const runnerDefinitionSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    models: z.array(z.string()).readonly(),
+});
+export const settingsRoleAssignmentSchema = z.object({
+    model: z.string(),
+    dispatchType: z.string().optional(),
+    runner: z.string().optional(),
+});
+export const settingsPermissionRuleSchema = z.object({
+    action: z.string(),
+    decision: z.enum(['grant', 'deny']),
+    scope: z.string().optional(),
+    pattern: z.string().optional(),
+});
+export const settingsPermissionPolicySchema = z.object({
+    defaultAction: permissionDecisionActionSchema,
+    rules: z.array(settingsPermissionRuleSchema).readonly().optional(),
+    roleTrust: z.record(z.string(), roleTrustLevelSchema).optional(),
+    safeCommands: z.array(z.string()).readonly().optional(),
+});
+export const settingsGovernanceSchema = z.object({
+    iterationLimits: z.object({
+        defaults: z.record(z.string(), z.number()),
+    }),
+    qualityGates: qualityGateConfigSchema,
+    budget: z
+        .object({
+        maxTokensPerRun: z.number().optional(),
+    })
+        .optional(),
+    permissionPolicy: settingsPermissionPolicySchema.optional(),
+});
+export const projectSettingsViewSchema = z.object({
+    roles: z.object({
+        assignments: z.record(z.string(), settingsRoleAssignmentSchema),
+    }),
+    governance: settingsGovernanceSchema,
+    runtime: z.object({ logLevel: z.string() }),
+    availableRunners: z.array(z.string()).readonly(),
+    modelsByRunner: z.record(z.string(), z.array(z.string()).readonly()),
+});

package/dist/dashboard/index.d.ts

@@ -0,0 +1,3 @@
+export * from './dashboard-api';
+export * from './dashboard-domain';
+export * from './run-creation-params';

package/dist/dashboard/index.js

@@ -0,0 +1,3 @@
+export * from './dashboard-api';
+export * from './dashboard-domain';
+export * from './run-creation-params';

package/dist/dashboard/run-creation-params.d.ts

@@ -0,0 +1,111 @@
+import { z } from 'zod/v4';
+/** Persistable run configuration from the New Run page (roles, governance, runtime). */
+export declare const runSettingsSchema: z.ZodObject<{
+    roles: z.ZodOptional<z.ZodObject<{
+        assignments: z.ZodRecord<z.ZodString, z.ZodObject<{
+            model: z.ZodString;
+            dispatchType: z.ZodOptional<z.ZodString>;
+            runner: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    governance: z.ZodOptional<z.ZodObject<{
+        iterationLimits: z.ZodObject<{
+            defaults: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        }, z.core.$strip>;
+        qualityGates: z.ZodObject<{
+            specificationReadiness: z.ZodObject<{
+                minCompletenessScore: z.ZodNumber;
+            }, z.core.$strip>;
+            implementationReview: z.ZodObject<{
+                maxHighSeverityFindings: z.ZodNumber;
+                maxMediumSeverityFindings: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        budget: z.ZodOptional<z.ZodObject<{
+            maxTokensPerRun: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        permissionPolicy: z.ZodOptional<z.ZodObject<{
+            defaultAction: z.ZodEnum<{
+                grant: "grant";
+                deny: "deny";
+                ask_human: "ask_human";
+            }>;
+            rules: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                action: z.ZodString;
+                decision: z.ZodEnum<{
+                    grant: "grant";
+                    deny: "deny";
+                }>;
+                scope: z.ZodOptional<z.ZodString>;
+                pattern: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>>;
+            roleTrust: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                none: "none";
+            }>>>;
+            safeCommands: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    runtime: z.ZodOptional<z.ZodObject<{
+        logLevel: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RunSettings = z.infer<typeof runSettingsSchema>;
+export declare const runCreationParamsSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    workflow: z.ZodOptional<z.ZodString>;
+    repoRoot: z.ZodOptional<z.ZodString>;
+    runSettings: z.ZodOptional<z.ZodObject<{
+        roles: z.ZodOptional<z.ZodObject<{
+            assignments: z.ZodRecord<z.ZodString, z.ZodObject<{
+                model: z.ZodString;
+                dispatchType: z.ZodOptional<z.ZodString>;
+                runner: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        governance: z.ZodOptional<z.ZodObject<{
+            iterationLimits: z.ZodObject<{
+                defaults: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            }, z.core.$strip>;
+            qualityGates: z.ZodObject<{
+                specificationReadiness: z.ZodObject<{
+                    minCompletenessScore: z.ZodNumber;
+                }, z.core.$strip>;
+                implementationReview: z.ZodObject<{
+                    maxHighSeverityFindings: z.ZodNumber;
+                    maxMediumSeverityFindings: z.ZodNumber;
+                }, z.core.$strip>;
+            }, z.core.$strip>;
+            budget: z.ZodOptional<z.ZodObject<{
+                maxTokensPerRun: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            permissionPolicy: z.ZodOptional<z.ZodObject<{
+                defaultAction: z.ZodEnum<{
+                    grant: "grant";
+                    deny: "deny";
+                    ask_human: "ask_human";
+                }>;
+                rules: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                    action: z.ZodString;
+                    decision: z.ZodEnum<{
+                        grant: "grant";
+                        deny: "deny";
+                    }>;
+                    scope: z.ZodOptional<z.ZodString>;
+                    pattern: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>>>;
+                roleTrust: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+                    high: "high";
+                    medium: "medium";
+                    none: "none";
+                }>>>;
+                safeCommands: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        runtime: z.ZodOptional<z.ZodObject<{
+            logLevel: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RunCreationParams = z.infer<typeof runCreationParamsSchema>;

package/dist/dashboard/run-creation-params.js

@@ -0,0 +1,14 @@
+import { z } from 'zod/v4';
+import { projectSettingsViewSchema, settingsGovernanceSchema } from './dashboard-domain';
+/** Persistable run configuration from the New Run page (roles, governance, runtime). */
+export const runSettingsSchema = z.object({
+    roles: projectSettingsViewSchema.shape.roles.optional(),
+    governance: settingsGovernanceSchema.optional(),
+    runtime: projectSettingsViewSchema.shape.runtime.optional(),
+});
+export const runCreationParamsSchema = z.object({
+    prompt: z.string().min(1),
+    workflow: z.string().optional(),
+    repoRoot: z.string().optional(),
+    runSettings: runSettingsSchema.optional(),
+});