Class: Insika::Commands::TriggerWorkflow

Inherits:
Object
  • Object
show all
Defined in:
lib/insika/commands/trigger_workflow.rb

Overview

Turn command: fires a workflow. Reuses the canonical pipeline — only stage 6 varies (Executor). Validates everything synchronously and responds {task_id:} immediately. The workflow allowlist is NOT checked here: it is stage-3 enforcement via WorkflowAllowlist -> PolicyDenied -> task :failed.

Constant Summary collapse

ALLOWED_KEYS = 
%i[workflow agent input session_id].freeze

Instance Method Summary collapse

Constructor Details

#initialize(profiles:, session_store:, task_store:, executor:, workflow_registry:) ⇒ TriggerWorkflow

Returns a new instance of TriggerWorkflow.



13
14
15
16
17
18
19
 
# File 'lib/insika/commands/trigger_workflow.rb', line 13

def initialize(profiles:, session_store:, task_store:, executor:, workflow_registry:)
  @profiles = ProfileSource.coerce(profiles)
  @session_store = session_store
  @task_store = task_store
  @executor = executor
  @workflow_registry = workflow_registry
end

Instance Method Details

#call(command) ⇒ Object

Raises:



21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
 
# File 'lib/insika/commands/trigger_workflow.rb', line 21

def call(command)
  p = normalize(command.payload)
  reject_unknown_keys!(command.payload) # strict validation

  workflow = p[:workflow].to_s
  raise Insika::ValidationError, "workflow is required" if workflow.empty?

  agent = p[:agent].to_s
  raise Insika::ValidationError, "agent is required" if agent.empty?

  profile = @profiles[agent] ||
            (raise Insika::NotFoundError, "agent '#{agent}' not configured")

  input = p[:input] || {}
  raise Insika::ValidationError, "input must be a Hash" unless input.is_a?(Hash)

  if p[:session_id]
    @session_store.find(p[:session_id]) ||
      (raise Insika::NotFoundError, "session '#{p[:session_id]}' not found")
  end

  # existence is validatable without executing — names, NEVER resolve (don't instantiate
  # outside the fiber).
  unless @workflow_registry.names.include?(workflow)
    raise Insika::NotFoundError, "workflow '#{workflow}' not registered"
  end

  # I/O by schema (item 22 / §4.4): the INPUT is validated SYNCHRONOUSLY —
  # a non-conforming input is a WorkflowSchemaError (< ValidationError -> 422)
  # with NO run created. `definition` reads the schema metadata without
  # resolving the factory (stays out of the fiber). No-op without an input_schema.
  @workflow_registry.definition(workflow).validate_input!(input)

  task = @task_store.create(command: command.to_h, session_id: p[:session_id])
  @executor.spawn_in_session(task, profile: profile)
  # runId = the run's durable record, which IS the Task (checkpointed +
  # recoverable). Exposed under both names so the workflow consumer has a
  # stable `run_id` while every task surface (GET /v1/tasks/:id, the event
  # stream) keeps working unchanged.
  { task_id: task.id, run_id: task.id }
end