@loop-engine/actors

1npm install @loop-engine/actors

1interface HumanActor extends ActorRef {
2  type: "human"
3  userId: string
4  displayName: string
5  roles?: string[]
6}
7 
8interface AutomationActor extends ActorRef {
9  type: "automation"
10  serviceId: string
11  version?: string
12}
13 
14interface AIAgentActor extends ActorRef {
15  type: "ai-agent"
16  modelId: string
17  provider: string
18  confidence?: number
19  promptHash?: string
20  toolsUsed?: string[]
21}

1canActorExecuteTransition(
2  actor: Actor,
3  transition: TransitionSpec,
4  constraints?: AIActorConstraints
5): { authorized: boolean; requiresApproval: boolean; reason?: string }

1"cmt">// @no-typecheck
2import { canActorExecuteTransition } from "@loop-engine/actors"
3 
4const auth = canActorExecuteTransition(agentActor, transition)
5if (!auth.authorized) {
6  console.log(auth.reason)
7}

1buildAIActorEvidence(params: {
2  modelId: string
3  provider: string
4  reasoning: string
5  confidence: number
6  dataPoints?: Record<string, unknown>
7  rawResponse?: unknown
8  prompt?: string
9}): Promise<AIAgentSubmission["evidence"] & { modelId: string; provider: string; promptHash?: string }>

1import { buildAIActorEvidence } from "@loop-engine/actors"
2 
3const evidence = await buildAIActorEvidence({
4  modelId: "gpt-4o",
5  provider: "openai",
6  reasoning: "Demand spike at DC-East",
7  confidence: 0.82,
8  dataPoints: { recommended_qty: 500 }
9})