turnkit 0.2.10 → 0.4.0

data/lib/turnkit/workflow.rb

@@ -4,13 +4,7 @@ require_relative "agent"
 
 module TurnKit
   class Workflow
-    attr_reader :name, :description, :instructions, :tools, :skills, :available_skills
-    attr_reader :model, :client, :store, :prompt_mode, :thinking, :compaction, :output_schema
-    attr_reader :on_event
-    attr_reader :max_iterations, :timeout, :cost_limit, :max_depth, :max_tool_executions, :max_tool_executions_by_name
-    attr_reader :output_audit, :output_audit_mode, :output_policy, :output_policy_mode, :output_policy_model, :output_policy_thinking
-
-    DEFAULT_INSTRUCTIONS = <<~TEXT.strip
+    ORCHESTRATOR_PREAMBLE = <<~TEXT.strip
       You are an autonomous task orchestrator. Navigate from the application
       request to a final output without asking the user follow-up questions.
 
@@ -29,104 +23,36 @@ module TurnKit
       limits.
     TEXT
 
-    def initialize(name: "workflow", description: "", instructions: nil,
-      tools: [], skills: [], available_skills: [], model: nil, client: nil,
-      store: nil, prompt_mode: :task, thinking: nil, compaction: nil, on_event: nil,
-      output_schema: nil, max_iterations: nil, timeout: nil, max_spend: nil,
-      cost_limit: nil, max_depth: nil, max_tool_executions: nil, max_tool_executions_by_name: nil,
-      output_audit: nil, output_audit_mode: nil, output_policy: nil, output_policy_mode: nil, output_policy_model: nil, output_policy_thinking: nil)
+    DEFAULT_INSTRUCTIONS = ORCHESTRATOR_PREAMBLE
+
+    attr_reader :name, :options
 
+    def initialize(name: "workflow", instructions: nil, preamble: true, **options)
       @name = name.to_s
-      @description = description.to_s
-      @instructions = instructions || DEFAULT_INSTRUCTIONS
-      @tools = Array(tools)
-      @skills = Array(skills)
-      @available_skills = Array(available_skills)
-      @model = model
-      @client = client
-      @store = store
-      @prompt_mode = prompt_mode
-      @thinking = thinking
-      @compaction = compaction
-      @on_event = on_event
-      @output_schema = output_schema
-      @max_iterations = max_iterations
-      @timeout = timeout
-      @cost_limit = cost_limit || max_spend
-      @max_depth = max_depth
-      @max_tool_executions = max_tool_executions
-      @max_tool_executions_by_name = max_tool_executions_by_name
-      @output_audit = output_audit
-      @output_audit_mode = output_audit_mode
-      @output_policy = output_policy
-      @output_policy_mode = output_policy_mode
-      @output_policy_model = output_policy_model
-      @output_policy_thinking = output_policy_thinking
       raise ArgumentError, "name is required" if @name.empty?
-      @agent = build_agent
-    end
-
-    def run(prompt = nil, task: nil, input: nil, async: false, subject: nil, metadata: {},
-      max_spend: nil, cost_limit: nil, **options)
-
-      task = task || prompt
-      raise ArgumentError, "task is required" if task.to_s.empty?
-
-      runtime_agent = if options.empty? && cost_limit.nil? && max_spend.nil?
-        @agent
-      else
-        build_agent(cost_limit: cost_limit || max_spend, **options)
-      end
 
-      runtime_agent.run(
-        task,
-        input: input,
-        async: async,
-        subject: subject,
-        metadata: metadata
-      )
+      @options = options.merge(
+        name: @name,
+        prompt_mode: options.fetch(:prompt_mode, :task),
+        instructions: compose_instructions(instructions, preamble: preamble)
+      ).freeze
+      @agent = Agent.new(**@options)
     end
 
-    def agent(**options)
-      options.empty? ? @agent : build_agent(**options)
+    def run(prompt = nil, task: nil, input: nil, async: false, subject: nil, metadata: {}, **overrides)
+      agent(**overrides).run(task || prompt, input: input, async: async, subject: subject, metadata: metadata)
     end
 
-    def max_spend
-      cost_limit
+    def agent(**overrides)
+      overrides.empty? ? @agent : Agent.new(**@options.merge(overrides.compact))
     end
 
     private
-      def build_agent(**overrides)
-        attrs = {
-          name: name,
-          description: description,
-          instructions: instructions,
-          tools: tools,
-          skills: skills,
-          available_skills: available_skills,
-          model: model,
-          client: client,
-          store: store,
-          prompt_mode: prompt_mode,
-          thinking: thinking,
-          compaction: compaction,
-          on_event: on_event,
-          output_schema: output_schema,
-          max_iterations: max_iterations,
-          timeout: timeout,
-          cost_limit: cost_limit,
-          max_depth: max_depth,
-          max_tool_executions: max_tool_executions,
-          max_tool_executions_by_name: max_tool_executions_by_name,
-          output_audit: output_audit,
-          output_audit_mode: output_audit_mode,
-          output_policy: output_policy,
-          output_policy_mode: output_policy_mode,
-          output_policy_model: output_policy_model,
-          output_policy_thinking: output_policy_thinking
-        }
-        attrs.merge!(overrides.compact)
-        Agent.new(**attrs)
+      def compose_instructions(instructions, preamble:)
+        parts = []
+        parts << ORCHESTRATOR_PREAMBLE if preamble
+        parts << instructions.to_s.strip unless instructions.to_s.strip.empty?
+        parts.join("\n\n")
       end
   end
 end

data/lib/turnkit.rb

@@ -15,12 +15,14 @@ require_relative "turnkit/cost"
 require_relative "turnkit/budget"
 require_relative "turnkit/event"
 require_relative "turnkit/model_request"
+require_relative "turnkit/schema_check"
 require_relative "turnkit/agent"
 require_relative "turnkit/workflow"
 require_relative "turnkit/client"
 require_relative "turnkit/conversation"
 require_relative "turnkit/message"
 require_relative "turnkit/record"
+require_relative "turnkit/image_result"
 require_relative "turnkit/result"
 require_relative "turnkit/skill"
 require_relative "turnkit/output_audit"
@@ -33,9 +35,11 @@ require_relative "turnkit/store"
 require_relative "turnkit/memory_store"
 require_relative "turnkit/compaction"
 require_relative "turnkit/tool"
+require_relative "turnkit/image_tool"
 require_relative "turnkit/tool_call"
 require_relative "turnkit/tool_execution"
 require_relative "turnkit/sub_agent_tool"
+require_relative "turnkit/load_skill_tool"
 require_relative "turnkit/message_projection"
 require_relative "turnkit/tool_runner"
 require_relative "turnkit/turn"
@@ -52,7 +56,7 @@ module TurnKit
     attr_accessor :default_model, :client, :store, :logger
     attr_accessor :max_iterations, :timeout, :max_depth, :max_tool_executions
     attr_accessor :max_tool_executions_by_name
-    attr_accessor :cost_limit, :prompt_cache
+    attr_accessor :max_spend, :prompt_cache
     attr_accessor :compaction
     attr_accessor :output_policy_model, :output_policy_thinking
     attr_accessor :cost_rates, :cost_calculator
@@ -72,6 +76,7 @@ module TurnKit
   self.max_depth = 3
   self.max_tool_executions = 100
   self.max_tool_executions_by_name = {}
+  self.max_spend = nil
   self.prompt_cache = :auto
   self.compaction = true
   self.cost_rates = {}
@@ -97,21 +102,18 @@ module TurnKit
     self.default_model = value
   end
 
-  def self.max_spend
-    cost_limit
-  end
-
-  def self.max_spend=(value)
-    self.cost_limit = value
-  end
-
   def self.reconcile_stale!(before: Clock.now - (timeout || 300))
     store.find_stale_turns(before: before).each do |turn|
       store.update_turn(turn.fetch("id"), "status" => "stale", "completed_at" => Clock.now)
     end
   end
 
-  def self.audit_output(output, constraints: [], context: {})
+  def self.check_output_policy(output, constraints: [], context: {})
     OutputAudit.check(output, constraints: constraints, context: context)
   end
+
+  def self.paint(prompt, model:, provider: nil, size: nil, assume_model_exists: nil, input_images: nil, mask: nil, params: {}, metadata: {}, client: nil)
+    image_client = client || self.client
+    image_client.paint(prompt: prompt, model: model, provider: provider, size: size, assume_model_exists: assume_model_exists, input_images: input_images, mask: mask, params: params, metadata: metadata).images.first
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: turnkit
 version: !ruby/object:Gem::Version
-  version: 0.2.10
+  version: 0.4.0
 platform: ruby
 authors:
 - Sam Couch
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-10 00:00:00.000000000 Z
+date: 2026-06-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby_llm
@@ -57,6 +57,9 @@ files:
 - lib/turnkit/generators/turnkit/install/templates/turn.rb
 - lib/turnkit/generators/turnkit/install_generator.rb
 - lib/turnkit/id.rb
+- lib/turnkit/image_result.rb
+- lib/turnkit/image_tool.rb
+- lib/turnkit/load_skill_tool.rb
 - lib/turnkit/memory_store.rb
 - lib/turnkit/message.rb
 - lib/turnkit/message_projection.rb
@@ -70,6 +73,7 @@ files:
 - lib/turnkit/record.rb
 - lib/turnkit/result.rb
 - lib/turnkit/run.rb
+- lib/turnkit/schema_check.rb
 - lib/turnkit/skill.rb
 - lib/turnkit/store.rb
 - lib/turnkit/stores/active_record_store.rb