Koşu olayları - Pactmark

Uyumluluk: Pactmark 0.2.x. Her yük katı bir nesnedir. Olaylar özet ve kimlik taşır — asla prompt, tamamlama, çalışma alanı veya kimlik bilgisi içeriği taşımaz.

Durumlar

Yaşam döngüsü

Olay	Yük
`RunAccepted`	`workOrderId`, `workOrderBindingDigest`, `requiredVerifierIds[]`
`PlanningStarted`	`stepId`
`ExecutionStarted`	`stepId`, `toolCallId?`
`RunSuspended`	`stepId`, `resumeTarget`, `reasonCode`, `effectId?`
`RunCompleted`	`stepId`, `evidenceRecordId`, `outputDigest`
`RunFailed`	`stepId?`, `errorCode` (`/^KAF_[A-Z0-9_]+$/` ile eşleşen), `safeDetails?`
`RunCancelled`	`stepId?`, `reasonCode`, `actorId`

resumeTarget; planning, running veya verifying olabilir.

Model sınırı

Olay	Yük
`ModelCallStarted`	`stepId`, `modelCallReservationId`, `requestDigest`
`ModelCallCompleted`	`stepId`, `modelCallReservationId`, `responseDigest`, `finishReason`

İçerik değil özetler. Bir Pactmark olay akışından bir prompt’u yeniden kurmak tasarım gereği imkânsızdır — olay akışının model etkileşiminin kendisinden daha uzun saklanabilmesinin nedeni de budur.

Araçlar

Olay	Yük
`ToolCallRequested`	`stepId`, `toolCallId`, `toolRegistrationDigest`, `argumentsDigest`
`ToolCallCompleted`	`stepId`, `toolCallId`, `resultDigest`

Yeniden denemeler

Olay	Yük
`RetryScheduled`	`stepId`, `boundary` (`model`\|`tool`), `boundaryKey`, `attempt`, `nextAttempt`, `classification`, `delayMs`, `notBefore`
`RetryResumed`	`stepId`, `boundary`, `boundaryKey`, `attempt`

classification; timed_out, retryable veya uncertain olabilir.

İnsan etkileşimi

Olay	Yük
`InputRequested`	`stepId`, `requestId`, `inputSchemaDigest`, `safePrompt`
`InputSubmitted`	`stepId`, `requestId`, `inputSubmissionRecordId`, `inputSchemaDigest`, `valueDigest`
`ApprovalRequested`	`stepId`, `decisionId`, `decisionGateDigest`, `proposedEffectDigest`
`ApprovalRecorded`	`stepId`, `decisionId`, `approvalId`, `resumeTarget` (`planning`\|`running`)
`ApprovalRejected`	`stepId`, `decisionId`, `nextStatus` (`planning`\|`failed`\|`cancelled`), `reasonCode`

safePrompt, modelin ham çıktısından zaten ayrılmış, insana yönelik bir metindir.

Etkiler

Olay	Yük
`EffectPrepared`	`stepId`, `effectId`, `effectDigest`, `effectKey`, `strategy`
`EffectDispatched`	`stepId`, `effectId`, `attempt`
`EffectAcknowledged`	`stepId`, `effectId`, `resultDigest`, `acknowledgement`
`EffectUncertain`	`stepId`, `effectId`, `uncertaintyCode`
`EffectNeedsReconciliation`	`stepId`, `effectId`, `effectMayHaveOccurred: true`
`EffectReconciliationRecorded`	`stepId`, `effectId`, `resolution`, `commandId`
`EffectAbandoned`	`stepId`, `effectId`, `reason`, `effectMayHaveOccurred: true`
`CompensationRequested`	`stepId`, `originalRunId`, `originalEffectDigest`, `compensationRunId`
`EffectCompensated`	`stepId`, `originalEffectDigest`, `compensationEffectDigest`, `acknowledgementDigest`

effectMayHaveOccurred, hem EffectNeedsReconciliation hem EffectAbandoned üzerinde literal true değeridir. Şema, bu durumları etkinin kesinlikle olmadığını ima ederek kaydetmenize izin vermez.

resolution; recovered_acknowledgement veya abandon_uncertain olabilir.

Çıktı ve doğrulama

Olay	Yük
`ArtifactProduced`	`stepId`, `artifactId`, `artifactDigest`
`VerificationStarted`	`stepId`, `artifactDigest`
`VerificationRecorded`	`stepId`, `verificationId`, `verifierId`, `status`, `verificationDigest`
`VerificationExceptionRecorded`	`stepId`, `exceptionId`, `exceptionDigest`, `verifierId`, `verifierRegistrationDigest`, `artifactDigest`, `rubricVersion`, `rubricDigest`, `reviewerRole`, `expiresAt`, `reason`, `compensatingControls[]`

status; pass, fail veya needs_review olabilir. compensatingControls boş olamaz.

Olayları tüketmek

for await (const event of runtime.events(authority, runId, { afterSequence })) {
  switch (event.eventType) {
    case "ApprovalRequested":
      return queueForReview(event.payload.decisionId);
    case "EffectNeedsReconciliation":
      return alertOnCall(event.payload.effectId);
    case "RunFailed":
      return handle(event.payload.errorCode); // kararlı KAF_* kodu
  }
}

eventType ve KAF_* kodlarına göre dallanın. İnsan tarafından okunabilir metin, belgelenmiş sözleşme dışındaki sıralama ve stack trace’ler kararlı API değildir.

Koşu yaşam döngüsü

Bu olayların koşuyu durumlar arasında nasıl taşıdığı.

Hata başvurusu

Yeniden denenebilirliği ve HTTP durumuyla her KAF_* kodu.

​Durumlar

​Yaşam döngüsü

​Model sınırı

​Araçlar

​Yeniden denemeler

​İnsan etkileşimi

​Etkiler

​Çıktı ve doğrulama

​Olayları tüketmek

Koşu yaşam döngüsü

Hata başvurusu

Durumlar

Yaşam döngüsü

Model sınırı

Araçlar

Yeniden denemeler

İnsan etkileşimi

Etkiler

Çıktı ve doğrulama

Olayları tüketmek