turnkit 0.2.9 → 0.3.0

data/lib/turnkit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TurnKit
-  VERSION = "0.2.9"
+  VERSION = "0.3.0"
 end

data/lib/turnkit/workflow.rb

@@ -4,11 +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 :max_iterations, :timeout, :cost_limit, :max_depth, :max_tool_executions
-
-    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.
 
@@ -17,87 +13,46 @@ module TurnKit
       patterns. Iterate when work needs missing context, critique, revision, or
       verification.
 
+      When multiple independent items need the same kind of fetch or read, and
+      an available batch tool can handle them in one call, prefer the batch tool
+      over repeated one-item tool calls.
+
       Stop when the task is complete, when the available context and tools are
       sufficient for the best possible answer, or when further iteration would
       not materially improve the result. Respect runtime, cost, and iteration
       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,
-      output_schema: nil, max_iterations: nil, timeout: nil, max_spend: nil,
-      cost_limit: nil, max_depth: nil, max_tool_executions: 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
-      @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
       raise ArgumentError, "name is required" if @name.empty?
-      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?
 
-      build_agent(cost_limit: cost_limit || max_spend, **options).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)
-      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,
-          output_schema: output_schema,
-          max_iterations: max_iterations,
-          timeout: timeout,
-          cost_limit: cost_limit,
-          max_depth: max_depth,
-          max_tool_executions: max_tool_executions
-        }
-        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

@@ -5,6 +5,7 @@ require "digest"
 require "securerandom"
 require "time"
 require "date"
+require "pathname"
 
 require_relative "turnkit/version"
 require_relative "turnkit/error"
@@ -14,6 +15,7 @@ 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"
@@ -22,6 +24,8 @@ require_relative "turnkit/message"
 require_relative "turnkit/record"
 require_relative "turnkit/result"
 require_relative "turnkit/skill"
+require_relative "turnkit/output_audit"
+require_relative "turnkit/output_policy"
 require_relative "turnkit/prompt_data"
 require_relative "turnkit/prompt_context"
 require_relative "turnkit/prompt_contribution"
@@ -33,6 +37,7 @@ require_relative "turnkit/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"
@@ -48,8 +53,10 @@ module TurnKit
   class << self
     attr_accessor :default_model, :client, :store, :logger
     attr_accessor :max_iterations, :timeout, :max_depth, :max_tool_executions
-    attr_accessor :cost_limit, :prompt_cache
+    attr_accessor :max_tool_executions_by_name
+    attr_accessor :max_spend, :prompt_cache
     attr_accessor :compaction
+    attr_accessor :output_policy_model, :output_policy_thinking
     attr_accessor :cost_rates, :cost_calculator
     attr_accessor :prompt_sections, :prompt_behavior, :available_skills
     attr_accessor :prompt_data_max_chars, :context_contributors
@@ -66,6 +73,8 @@ module TurnKit
   self.timeout = 300
   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 = {}
@@ -76,6 +85,8 @@ module TurnKit
   self.system_prompt_contributors = []
   self.model_prompt_contributors = {}
   self.on_event = nil
+  self.output_policy_model = nil
+  self.output_policy_thinking = { effort: :low }
 
   def self.configure
     yield self
@@ -89,17 +100,13 @@ 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.check_output_policy(output, constraints: [], context: {})
+    OutputAudit.check(output, constraints: constraints, context: context)
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: turnkit
 version: !ruby/object:Gem::Version
-  version: 0.2.9
+  version: 0.3.0
 platform: ruby
 authors:
 - Sam Couch
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-08 00:00:00.000000000 Z
+date: 2026-06-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby_llm
@@ -57,10 +57,13 @@ files:
 - lib/turnkit/generators/turnkit/install/templates/turn.rb
 - lib/turnkit/generators/turnkit/install_generator.rb
 - lib/turnkit/id.rb
+- lib/turnkit/load_skill_tool.rb
 - lib/turnkit/memory_store.rb
 - lib/turnkit/message.rb
 - lib/turnkit/message_projection.rb
 - lib/turnkit/model_request.rb
+- lib/turnkit/output_audit.rb
+- lib/turnkit/output_policy.rb
 - lib/turnkit/prompt_context.rb
 - lib/turnkit/prompt_contribution.rb
 - lib/turnkit/prompt_data.rb
@@ -68,6 +71,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