@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 }

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

1buildActorEvidence(actor: Actor, baseEvidence: Evidence): Evidence

1import { buildActorEvidence } from "@loop-engine/actors"
2 
3const evidence = buildActorEvidence(aiActor, {
4  ai_confidence: 0.82,
5  ai_reasoning: "Demand spike at DC-East",
6  recommended_qty: 500
7})