@junctionpanel/server 0.1.83 → 0.1.85

package/dist/server/shared/messages.js

@@ -40,6 +40,174 @@ const AgentUsageSchema = z.object({
     outputTokens: z.number().optional(),
     totalCostUsd: z.number().optional(),
 });
+const HarnessVerificationStateSchema = z.enum([
+    'not_needed',
+    'pending',
+    'passed',
+    'failed',
+    'stale',
+]);
+const HarnessRunOwnerSchema = z.enum([
+    'foreground',
+    'background',
+]);
+const HarnessRunLifecycleSchema = z.enum([
+    'queued',
+    'streaming',
+    'waiting_permission',
+    'finalizing',
+    'completed',
+    'interrupted',
+    'error',
+    'recovering',
+]);
+const HarnessRunRecordSchema = z.object({
+    id: z.string(),
+    owner: HarnessRunOwnerSchema,
+    lifecycle: HarnessRunLifecycleSchema,
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    startedAt: z.string(),
+    completedAt: z.string().nullable(),
+    lastProgressAt: z.string().nullable(),
+    turnStartSeq: z.number().int().nullable(),
+    turnEndSeq: z.number().int().nullable(),
+    correlationId: z.string().nullable(),
+    modelId: z.string().nullable(),
+    permissionRequestId: z.string().nullable(),
+    summary: z.string().nullable(),
+});
+const HarnessRunLedgerSchema = z.object({
+    activeRunId: z.string().nullable(),
+    runs: z.array(HarnessRunRecordSchema),
+});
+const HarnessPermissionRiskSchema = z.enum([
+    'safe',
+    'review',
+    'destructive',
+    'shared_state',
+    'external_side_effect',
+]);
+const HarnessPermissionStatusSchema = z.enum([
+    'pending',
+    'allowed',
+    'denied',
+    'canceled',
+]);
+const HarnessPermissionLedgerEntrySchema = z.object({
+    requestId: z.string(),
+    provider: AgentProviderSchema.nullable(),
+    kind: z.string(),
+    toolName: z.string(),
+    fingerprint: z.string(),
+    risk: HarnessPermissionRiskSchema,
+    status: HarnessPermissionStatusSchema,
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    resolutionMessage: z.string().nullable(),
+    recoveryHint: z.string().nullable(),
+    provenance: z.enum(['runtime', 'restored']),
+});
+const HarnessCostStateSchema = z.object({
+    turnsCompleted: z.number().int().nonnegative(),
+    totals: AgentUsageSchema,
+    lastTurnUsage: AgentUsageSchema.nullable(),
+    lastUpdatedAt: z.string().nullable(),
+});
+const HarnessResumeStatusSchema = z.enum([
+    'fresh',
+    'live',
+    'resumed',
+    'checkpoint_restored',
+    'recovering',
+]);
+const HarnessResumeStateSchema = z.object({
+    status: HarnessResumeStatusSchema,
+    source: z.enum(['new_session', 'provider_resume', 'checkpoint', 'snapshot']),
+    updatedAt: z.string(),
+    recoveryHint: z.string().nullable(),
+});
+const HarnessTrustStateSchema = z.enum([
+    'trusted',
+    'restricted',
+    'untrusted',
+]);
+const HarnessValidationRecordSchema = z.object({
+    command: z.string(),
+    status: z.enum(['passed', 'failed']),
+    timestamp: z.string(),
+    cwd: z.string().nullable().optional(),
+    scope: z.enum(['workspace', 'package', 'global', 'unknown']).optional(),
+    coveredPaths: z.array(z.string()).optional(),
+});
+const HarnessWorkerStateSchema = z.object({
+    id: z.string(),
+    provider: AgentProviderSchema.nullable(),
+    threadId: z.string().nullable(),
+    parentAgentId: z.string().nullable(),
+    role: z.enum(['explore', 'plan', 'implement', 'verify', 'generic']),
+    kind: z.enum(['provider_subagent', 'background_command', 'remote_task']),
+    purpose: z.string(),
+    owner: z.string().nullable(),
+    status: z.enum(['pending', 'running', 'completed', 'integrated', 'failed']),
+    queueState: z.enum(['active', 'queued', 'completed']),
+    outputSummary: z.string().nullable(),
+    changedFiles: z.array(z.string()),
+    verificationState: HarnessVerificationStateSchema,
+    startedAt: z.string().nullable(),
+    integratedAt: z.string().nullable(),
+    completedAt: z.string().nullable(),
+    sessionId: z.string().nullable(),
+    transcriptPath: z.string().nullable(),
+    outputPath: z.string().nullable(),
+    rolloutPath: z.string().nullable(),
+    recentActions: z.array(z.object({
+        index: z.number().int().nonnegative(),
+        toolName: z.string(),
+        summary: z.string().optional(),
+    })),
+    permissionState: z.enum(['none', 'pending', 'resolved']),
+    lastPermissionRequestId: z.string().nullable(),
+    lastPermissionToolName: z.string().nullable(),
+    error: z.string().nullable(),
+    progress: z.object({
+        toolCallCount: z.number().int().nonnegative(),
+        lastActivityAt: z.string(),
+        latestSummary: z.string().nullable(),
+    }),
+    lastUpdatedAt: z.string(),
+});
+const HarnessCheckpointSummarySchema = z.object({
+    id: z.string(),
+    kind: z.enum(['pre_mutation', 'turn_final']),
+    createdAt: z.string(),
+    objective: z.string(),
+    summary: z.string().nullable(),
+    changedFiles: z.array(z.string()),
+    restorable: z.boolean(),
+    turnStartSeq: z.number().int().nonnegative(),
+    turnEndSeq: z.number().int().nonnegative(),
+});
+const JunctionHarnessSummarySchema = z.object({
+    harnessVersion: z.string(),
+    objective: z.string().nullable(),
+    trustState: HarnessTrustStateSchema,
+    verification: z.object({
+        state: HarnessVerificationStateSchema,
+        lastValidatedAt: z.string().nullable(),
+        nextRequiredAction: z.string().nullable(),
+        changedFiles: z.array(z.string()),
+        lastValidation: HarnessValidationRecordSchema.nullable(),
+    }),
+    blockers: z.array(z.string()),
+    runLedger: HarnessRunLedgerSchema,
+    permissionLedger: z.array(HarnessPermissionLedgerEntrySchema),
+    costState: HarnessCostStateSchema,
+    resumeState: HarnessResumeStateSchema.nullable(),
+    scratchpadDir: z.string().nullable(),
+    workers: z.array(HarnessWorkerStateSchema),
+    checkpoints: z.array(HarnessCheckpointSummarySchema),
+});
 const AgentImagePreviewSchema = z.object({
     data: z.string(),
     mimeType: z.string(),
@@ -270,6 +438,31 @@ const ToolCallTimelineItemPayloadSchema = z.union([
     ToolCallFailedPayloadSchema,
     ToolCallCanceledPayloadSchema,
 ]);
+const HarnessEventTimelineItemPayloadSchema = z.object({
+    type: z.literal('harness_event'),
+    kind: z.enum([
+        'checkpoint_created',
+        'checkpoint_restored',
+        'verification_changed',
+        'trust_changed',
+        'worker_updated',
+        'hook_decision',
+        'memory_compacted',
+        'run_state_changed',
+        'permission_enqueued',
+        'permission_resolved',
+        'recovery_hint_emitted',
+        'stall_detected',
+        'stall_cleared',
+        'resume_restored',
+    ]),
+    summary: z.string(),
+    details: z.record(z.unknown()).optional(),
+    checkpointId: z.string().nullable().optional(),
+    verificationState: HarnessVerificationStateSchema.optional(),
+    trustState: HarnessTrustStateSchema.optional(),
+    workerId: z.string().nullable().optional(),
+});
 export const AgentTimelineItemPayloadSchema = z.union([
     z.object({
         type: z.literal('user_message'),
@@ -323,6 +516,7 @@ export const AgentTimelineItemPayloadSchema = z.union([
         requestId: z.string(),
         resolution: PersistedPermissionResolutionSchema,
     }),
+    HarnessEventTimelineItemPayloadSchema,
 ]);
 export const AgentStreamEventPayloadSchema = z.discriminatedUnion('type', [
     z.object({
@@ -441,6 +635,7 @@ export const AgentSnapshotPayloadSchema = z.object({
     pendingPermissions: z.array(AgentPermissionRequestPayloadSchema),
     persistence: AgentPersistenceHandleSchema.nullable(),
     runtimeInfo: AgentRuntimeInfoSchema.optional(),
+    harness: JunctionHarnessSummarySchema.optional(),
     lastUsage: AgentUsageSchema.optional(),
     activeTurnStartedAt: z.string().nullable().optional(),
     lastError: z.string().optional(),
@@ -546,6 +741,17 @@ export const FetchAgentRequestMessageSchema = z.object({
     /** Accepts full ID, unique prefix, or exact full title (server resolves). */
     agentId: z.string(),
 });
+export const ListAgentCheckpointsRequestMessageSchema = z.object({
+    type: z.literal('list_agent_checkpoints_request'),
+    requestId: z.string(),
+    agentId: z.string(),
+});
+export const RestoreAgentCheckpointRequestMessageSchema = z.object({
+    type: z.literal('restore_agent_checkpoint_request'),
+    requestId: z.string(),
+    agentId: z.string(),
+    checkpointId: z.string(),
+});
 export const SendAgentMessageRequestSchema = z.object({
     type: z.literal('send_agent_message_request'),
     requestId: z.string(),
@@ -1200,6 +1406,8 @@ export const SessionInboundMessageSchema = z.discriminatedUnion('type', [
     AbortRequestMessageSchema,
     FetchAgentsRequestMessageSchema,
     FetchAgentRequestMessageSchema,
+    ListAgentCheckpointsRequestMessageSchema,
+    RestoreAgentCheckpointRequestMessageSchema,
     DeleteAgentRequestMessageSchema,
     ArchiveAgentRequestMessageSchema,
     UnarchiveAgentRequestMessageSchema,
@@ -1587,6 +1795,26 @@ export const FetchAgentResponseMessageSchema = z.object({
         error: z.string().nullable(),
     }),
 });
+export const ListAgentCheckpointsResponseMessageSchema = z.object({
+    type: z.literal('list_agent_checkpoints_response'),
+    payload: z.object({
+        requestId: z.string(),
+        agentId: z.string(),
+        checkpoints: z.array(HarnessCheckpointSummarySchema),
+        error: z.string().nullable().optional(),
+    }),
+});
+export const RestoreAgentCheckpointResponseMessageSchema = z.object({
+    type: z.literal('restore_agent_checkpoint_response'),
+    payload: z.object({
+        requestId: z.string(),
+        agentId: z.string(),
+        checkpointId: z.string(),
+        restored: z.boolean(),
+        agent: AgentSnapshotPayloadSchema.nullable().optional(),
+        error: z.string().nullable().optional(),
+    }),
+});
 export const FetchProviderChildThreadsResponseMessageSchema = z.object({
     type: z.literal('fetch_provider_child_threads_response'),
     payload: z.object({
@@ -2300,6 +2528,8 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion('type', [
     AgentStatusMessageSchema,
     FetchAgentsResponseMessageSchema,
     FetchAgentResponseMessageSchema,
+    ListAgentCheckpointsResponseMessageSchema,
+    RestoreAgentCheckpointResponseMessageSchema,
     FetchProviderChildThreadsResponseMessageSchema,
     ProviderChildThreadsChangedMessageSchema,
     FetchProviderThreadTimelineResponseMessageSchema,