Artifacts & Audit Mission plan generation, transcripts, browser recordings, and immutable audit trail.
The artifacts-audit service is the central intake for mission artifacts, browser session recordings, and the immutable audit event trail. It generates deterministic plans, aggregates transcripts, and maintains a chronological ledger of high-value system events.
Method Path Description POST/api/v1/households/{id}/artifacts/mission-planGenerate a structured mission plan POST/api/v1/households/{id}/artifacts/outcome-summaryGenerate a mission outcome summary POST/api/v1/households/{id}/artifacts/recordingRegister browser recording metadata POST/api/v1/households/{id}/artifacts/transcriptAggregate a conversation transcript
Method Path Description GET/api/v1/households/{id}/artifacts/{artifactId}Get a specific artifact GET/api/v1/households/{id}/missions/{mId}/artifactsList artifacts for a mission (filter: artifact_type)
Method Path Description POST/api/v1/households/{id}/audit/eventsAppend an immutable audit event GET/api/v1/households/{id}/missions/{mId}/auditGet audit trail (params: limit, offset)
Type Description Data Shape MissionPlanDeterministic execution plan goal, constraints, steps, toolCallsExpected, stopConditions, assumptionsOutcomeSummaryPost-mission structured outcome finalState, totalTurns, toolCallsMade, keyDecisions, resultItemsBrowserRecordingHyperbeam session recording sessionId, storagePath, signedUrl, durationSeconds, actionLogTranscriptAggregated voice + text history missionId, entries[], totalMessages, hasVoiceAuditLogInternal audit log artifact event data
// POST /households/{id}/artifacts/mission-plan { "missionId" : "msn_123" , "missionType" : "STYLE" , "goal" : "Find a casual spring outfit under $200" , "constraints" : { "maxPrice" : 200 , "season" : "SPRING" }, "contextData" : { "wardrobeItemCount" : 12 } } Every audit event is an immutable ledger entry with severity classification:
// POST /households/{id}/audit/events { "missionId" : "msn_123" , "category" : "PURCHASE_GATE" , "severity" : "CRITICAL" , "action" : "USER_APPROVED_PURCHASE" , "detail" : { "requestId" : "req_456" , "amount" : 250 }, "sourceService" : "api-gateway" } Event Categories:
Category Description MISSION_LIFECYCLEMission created, completed, failed TOOL_CALLAgent tool execution (wardrobe, commerce, etc.) PURCHASE_GATEApproval, intent creation, checkout confirmation SAFETY_VIOLATIONPolicy or safety rule breach USER_ACTIONExplicit user actions (likes, takeover, etc.) SESSION_EVENTHyperbeam session state changes DATA_ACCESSReads of sensitive household data SYSTEMInternal system events
Severity Levels: INFO | WARNING | CRITICAL
Variable Default Description PERSISTENCE_BACKENDinmemoryfirestore or inmemoryARTIFACT_STORAGE_BACKENDlocalgcs or localARTIFACT_LOCAL_DIR/tmp/anyaself-artifactsLocal artifact storage path ORCHESTRATOR_BASE_URLhttp://orchestrator:8003/api/v1For cross-references INTERNAL_API_TOKENdev-internal-tokenInternal service token