language-operator 0.1.70 → 0.1.80

data/lib/language_operator/agent.rb

@@ -4,6 +4,7 @@ require_relative 'agent/base'
 require_relative 'agent/executor'
 require_relative 'agent/task_executor'
 require_relative 'agent/web_server'
+require_relative 'agent/execution_state'
 require_relative 'agent/instrumentation'
 require_relative 'dsl'
 require_relative 'logger'
@@ -162,15 +163,14 @@ module LanguageOperator
         # Hybrid mode: All agents now run main work AND web server (chat endpoints always enabled)
         logger.info('Starting hybrid agent (autonomous + web server)',
                     agent_name: agent_def.name,
-                    chat_endpoint_enabled: true,  # Always true now
+                    chat_endpoint_enabled: true, # Always true now
                     has_webhooks: agent_def.webhooks.any?,
-                    has_mcp_tools: !!(agent_def.mcp_server&.tools?))
+                    has_mcp_tools: !!agent_def.mcp_server&.tools?)
 
         # Start web server in background thread
         web_server = LanguageOperator::Agent::WebServer.new(agent)
         agent_def.webhooks.each { |webhook_def| webhook_def.register(web_server) }
-        web_server.register_mcp_tools(agent_def.mcp_server) if agent_def.mcp_server&.tools?
-        web_server.register_chat_endpoint(agent_def.chat_endpoint, agent)  # Always register chat endpoint
+        register_standard_endpoints(web_server, agent, agent_def)
 
         web_thread = Thread.new do
           web_server.start
@@ -199,33 +199,30 @@ module LanguageOperator
           raise 'Agent definition must have either main block (DSL v1) or workflow (DSL v0)'
         end
       when 'scheduled', 'event-driven'
-        # Scheduled mode: Execute once and exit (Kubernetes CronJob handles scheduling)
-        logger.info('Agent running in scheduled mode - executing once',
+        # Standby mode - web server only, wait for /api/v1/execute triggers
+        logger.info('Starting agent in standby mode (scheduled) - waiting for HTTP triggers',
                     agent_name: agent_def.name,
-                    dsl_version: uses_dsl_v1 ? 'v1' : 'v0')
-
-        if uses_dsl_v1
-          # DSL v1: Execute main block once
-          execute_main_block(agent, agent_def)
-        elsif uses_dsl_v0
-          # DSL v0: Execute workflow once
-          executor = LanguageOperator::Agent::Executor.new(agent)
-          executor.execute_workflow(agent_def)
-        else
-          raise 'Agent definition must have either main block (DSL v1) or workflow (DSL v0)'
-        end
+                    chat_endpoint_enabled: true,
+                    has_webhooks: agent_def.webhooks.any?,
+                    has_mcp_tools: !!agent_def.mcp_server&.tools?)
 
-        logger.info('Scheduled execution completed - exiting',
-                    agent_name: agent_def.name)
+        web_server = LanguageOperator::Agent::WebServer.new(agent)
+        agent_def.webhooks.each { |webhook_def| webhook_def.register(web_server) }
+        register_standard_endpoints(web_server, agent, agent_def)
+        web_server.register_execute_endpoint(agent, agent_def)
 
-        # Flush telemetry for short-lived processes
-        agent.send(:flush_telemetry)
+        web_server.start # Blocks here, waiting for requests
       when 'reactive', 'http', 'webhook'
-        # Start web server with webhooks, MCP tools, and chat endpoint
+        # Standby mode - web server with webhooks, MCP tools, chat, and execute endpoint
+        logger.info('Starting agent in standby mode (reactive)',
+                    agent_name: agent_def.name,
+                    has_webhooks: agent_def.webhooks.any?)
+
         web_server = LanguageOperator::Agent::WebServer.new(agent)
         agent_def.webhooks.each { |webhook_def| webhook_def.register(web_server) }
-        web_server.register_mcp_tools(agent_def.mcp_server) if agent_def.mcp_server&.tools?
-        web_server.register_chat_endpoint(agent_def.chat_endpoint, agent) if agent_def.chat_endpoint
+        register_standard_endpoints(web_server, agent, agent_def)
+        web_server.register_execute_endpoint(agent, agent_def)
+
         web_server.start
       else
         raise "Unknown agent mode: #{agent.mode}"
@@ -233,6 +230,18 @@ module LanguageOperator
     end
     # rubocop:enable Metrics/AbcSize, Metrics/MethodLength, Metrics/PerceivedComplexity
 
+    # Register standard endpoints for web server
+    #
+    # @param web_server [LanguageOperator::Agent::WebServer] The web server instance
+    # @param agent [LanguageOperator::Agent::Base] The agent instance
+    # @param agent_def [LanguageOperator::Dsl::AgentDefinition] The agent definition
+    # @return [void]
+    def self.register_standard_endpoints(web_server, agent, agent_def)
+      web_server.register_mcp_tools(agent_def.mcp_server) if agent_def.mcp_server&.tools?
+      web_server.register_chat_endpoint(agent)
+      web_server.register_workspace_endpoints(agent)
+    end
+
     # Execute main block (DSL v1) in autonomous mode
     #
     # @param agent [LanguageOperator::Agent::Base] The agent instance

data/lib/language_operator/dsl/agent_definition.rb

@@ -4,7 +4,6 @@ require_relative 'main_definition'
 require_relative 'task_definition'
 require_relative 'webhook_definition'
 require_relative 'mcp_server_definition'
-require_relative 'chat_endpoint_definition'
 require_relative '../logger'
 require_relative '../loggable'
 
@@ -64,7 +63,6 @@ module LanguageOperator
         @execution_mode = :autonomous
         @webhooks = []
         @mcp_server = nil
-        @chat_endpoint = nil
 
         logger.debug('Agent definition initialized',
                      name: name,
@@ -314,29 +312,6 @@ module LanguageOperator
         @mcp_server
       end
 
-      # Get chat endpoint definition (always available)
-      #
-      # Returns the chat endpoint definition. If none was explicitly configured,
-      # returns a default chat endpoint with basic configuration.
-      #
-      # @return [ChatEndpointDefinition] The chat endpoint definition
-      def chat_endpoint
-        @chat_endpoint ||= create_default_chat_endpoint
-      end
-
-      # Define chat endpoint capabilities
-      #
-      # Allows this agent to respond to OpenAI-compatible chat completion requests.
-      # Other systems can treat this agent as a language model.
-      #
-      # @yield Chat endpoint configuration block
-      # @return [ChatEndpointDefinition] The chat endpoint definition
-      def as_chat_endpoint(&block)
-        @chat_endpoint ||= ChatEndpointDefinition.new(@name)
-        @chat_endpoint.instance_eval(&block) if block
-        # Note: Don't force mode change - agents can be autonomous AND have chat endpoints
-        @chat_endpoint
-      end
 
       # Execute the agent
       #
@@ -363,31 +338,6 @@ module LanguageOperator
 
       private
 
-      # Create default chat endpoint configuration
-      #
-      # @return [ChatEndpointDefinition] Default chat endpoint
-      def create_default_chat_endpoint
-        endpoint = ChatEndpointDefinition.new(@name)
-        
-        # Set default system prompt based on agent description
-        default_prompt = if @description
-          "You are #{@description.downcase}. Provide helpful assistance based on your capabilities."
-        else
-          "You are an AI agent named #{@name}. Provide helpful assistance to users."
-        end
-        
-        endpoint.system_prompt(default_prompt)
-        endpoint.model(@name)  # Use agent name as model name
-        endpoint.temperature(0.7)  # Balanced default
-        endpoint.max_tokens(2000)  # Reasonable default
-        
-        logger.debug('Created default chat endpoint',
-                     agent_name: @name,
-                     model_name: @name,
-                     system_prompt: default_prompt[0..100])
-                     
-        endpoint
-      end
 
       def logger_component
         "Agent:#{@name}"
@@ -403,7 +353,7 @@ module LanguageOperator
                     name: @name,
                     webhooks: @webhooks.size,
                     mcp_tools: @mcp_server&.tools&.size || 0,
-                    chat_endpoint: !@chat_endpoint.nil?)
+                    chat_endpoint: true)
 
         # Create an Agent::Base instance with this definition
         require_relative '../agent/base'
@@ -427,8 +377,8 @@ module LanguageOperator
         # Register MCP tools
         web_server.register_mcp_tools(@mcp_server) if @mcp_server&.tools?
 
-        # Register chat endpoint
-        web_server.register_chat_endpoint(@chat_endpoint, agent) if @chat_endpoint
+        # Register chat endpoint - automatic for all agents
+        web_server.register_chat_endpoint(agent)
 
         # Start the server
         web_server.start

data/lib/language_operator/dsl/chat_endpoint_definition.rb

@@ -3,11 +3,15 @@
 module LanguageOperator
   module Dsl
     # Chat endpoint definition for agents
+    # 
+    # DEPRECATED: This class is deprecated. All agents now automatically get
+    # identity-aware chat endpoints without configuration. The `as_chat_endpoint`
+    # DSL method is no longer needed.
     #
     # Allows agents to expose an OpenAI-compatible chat completion endpoint.
     # Other systems can treat the agent as a language model.
     #
-    # @example Define chat endpoint in an agent
+    # @example Define basic chat endpoint
     #   agent "github-expert" do
     #     as_chat_endpoint do
     #       system_prompt "You are a GitHub API expert"
@@ -15,9 +19,26 @@ module LanguageOperator
     #       max_tokens 2000
     #     end
     #   end
+    #
+    # @example Define chat endpoint with identity awareness
+    #   agent "support-bot" do
+    #     as_chat_endpoint do
+    #       system_prompt "You are a helpful customer support assistant"
+    #       
+    #       # Configure identity awareness and context injection
+    #       identity_awareness do
+    #         enabled true
+    #         prompt_template :detailed
+    #         context_injection :standard
+    #       end
+    #       
+    #       temperature 0.8
+    #     end
+    #   end
     class ChatEndpointDefinition
       attr_reader :system_prompt, :temperature, :max_tokens, :model_name,
-                  :top_p, :frequency_penalty, :presence_penalty, :stop_sequences
+                  :top_p, :frequency_penalty, :presence_penalty, :stop_sequences,
+                  :identity_awareness_enabled, :prompt_template_level, :context_injection_level
 
       def initialize(agent_name)
         @agent_name = agent_name
@@ -29,6 +50,11 @@ module LanguageOperator
         @frequency_penalty = 0.0
         @presence_penalty = 0.0
         @stop_sequences = nil
+        
+        # Identity awareness and context injection settings
+        @identity_awareness_enabled = true
+        @prompt_template_level = :standard
+        @context_injection_level = :standard
       end
 
       # Set system prompt for chat mode
@@ -110,6 +136,90 @@ module LanguageOperator
 
         @stop_sequences = sequences
       end
+
+      # Enable or disable identity awareness and context injection
+      #
+      # When enabled, the system prompt will be dynamically enhanced with
+      # agent identity, operational context, and environment information.
+      #
+      # @param enabled [Boolean] Whether to enable identity awareness
+      # @return [Boolean] Current setting
+      def enable_identity_awareness(enabled = nil)
+        return @identity_awareness_enabled if enabled.nil?
+
+        @identity_awareness_enabled = enabled
+      end
+
+      # Set the prompt template level for context injection
+      #
+      # Available levels:
+      # - :minimal - Basic agent identity only
+      # - :standard - Identity + basic operational context (default)
+      # - :detailed - Full context with capabilities
+      # - :comprehensive - All available context and guidelines
+      #
+      # @param level [Symbol] Template level
+      # @return [Symbol] Current template level
+      def prompt_template(level = nil)
+        return @prompt_template_level if level.nil?
+
+        valid_levels = [:minimal, :standard, :detailed, :comprehensive]
+        unless valid_levels.include?(level)
+          raise ArgumentError, "Invalid template level: #{level}. Must be one of: #{valid_levels.join(', ')}"
+        end
+
+        @prompt_template_level = level
+      end
+
+      # Set the context injection level for conversations
+      #
+      # Controls how much operational context is injected into ongoing conversations.
+      #
+      # Available levels:
+      # - :none - No context injection
+      # - :minimal - Basic status only
+      # - :standard - Standard operational context (default)
+      # - :detailed - Full context with metrics
+      #
+      # @param level [Symbol] Context injection level
+      # @return [Symbol] Current context injection level
+      def context_injection(level = nil)
+        return @context_injection_level if level.nil?
+
+        valid_levels = [:none, :minimal, :standard, :detailed]
+        unless valid_levels.include?(level)
+          raise ArgumentError, "Invalid context level: #{level}. Must be one of: #{valid_levels.join(', ')}"
+        end
+
+        @context_injection_level = level
+      end
+
+      # Configure identity awareness with options block
+      #
+      # @example
+      #   identity_awareness do
+      #     enabled true
+      #     prompt_template :detailed
+      #     context_injection :standard
+      #   end
+      #
+      # @yield Block for configuring identity awareness options
+      def identity_awareness(&block)
+        if block_given?
+          instance_eval(&block)
+        else
+          {
+            enabled: @identity_awareness_enabled,
+            prompt_template: @prompt_template_level,
+            context_injection: @context_injection_level
+          }
+        end
+      end
+
+      # Alias methods for convenience
+      alias_method :enabled, :enable_identity_awareness
+      alias_method :template, :prompt_template
+      alias_method :context, :context_injection
     end
   end
 end

data/lib/language_operator/templates/schema/agent_dsl_openapi.yaml

@@ -2,7 +2,7 @@
 :openapi: 3.0.3
 :info:
   :title: Language Operator Agent API
-  :version: 0.1.70
+  :version: 0.1.73
   :description: HTTP API endpoints exposed by Language Operator reactive agents
   :contact:
     :name: Language Operator

data/lib/language_operator/templates/schema/agent_dsl_schema.json

@@ -3,7 +3,7 @@
   "$id": "https://github.com/language-operator/language-operator-gem/schema/agent-dsl.json",
   "title": "Language Operator Agent DSL",
   "description": "Schema for defining autonomous AI agents using the Language Operator DSL",
-  "version": "0.1.70",
+  "version": "0.1.73",
   "type": "object",
   "properties": {
     "name": {

data/lib/language_operator/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LanguageOperator
-  VERSION = '0.1.70'
+  VERSION = '0.1.80'
 end

data/synth/003/Makefile

@@ -27,11 +27,17 @@ inspect:
 learning-status:
 	$(AICTL) learning status $(AGENT)
 
+learn:
+	kubectl patch languageagent $(AGENT) --type='merge' -p='{"status":{"runsPendingLearning":10}}'
+
+
 logs:
 	$(AICTL) logs $(AGENT)
 
 clean:
 	$(AICTL) delete $(AGENT) --force
+	kubectl delete configmaps -l app.kubernetes.io/name=$(AGENT) --ignore-not-found=true
+	kubectl delete configmaps --field-selector metadata.name~=$(AGENT)-v --ignore-not-found=true
 
 save:
 	$(AICTL) code $(AGENT) --raw > agent.rb

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: language-operator
 version: !ruby/object:Gem::Version
-  version: 0.1.70
+  version: 0.1.80
 platform: ruby
 authors:
 - James Ryan
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2025-12-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mcp
@@ -517,22 +517,28 @@ files:
 - docs/how-agents-work.md
 - docs/installation.md
 - docs/observability.md
+- docs/persona-driven-system-prompts.md
 - docs/quickstart.md
 - docs/schema-versioning.md
 - docs/understanding-generated-code.md
 - docs/using-tools.md
 - docs/webhooks.md
+- examples/basic_agent_with_default_chat.rb
 - examples/chat_endpoint_agent.rb
 - examples/hybrid_agent.rb
+- examples/identity_aware_chat_agent.rb
 - examples/pure_agent_test.rb
 - examples/ux_helpers_demo.rb
 - lib/language_operator.rb
 - lib/language_operator/agent.rb
 - lib/language_operator/agent/base.rb
 - lib/language_operator/agent/event_config.rb
+- lib/language_operator/agent/execution_state.rb
 - lib/language_operator/agent/executor.rb
 - lib/language_operator/agent/instrumentation.rb
+- lib/language_operator/agent/metadata_collector.rb
 - lib/language_operator/agent/metrics_tracker.rb
+- lib/language_operator/agent/prompt_builder.rb
 - lib/language_operator/agent/safety/ast_validator.rb
 - lib/language_operator/agent/safety/audit_logger.rb
 - lib/language_operator/agent/safety/budget_tracker.rb
@@ -693,7 +699,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.6.6
 specification_version: 4
 summary: Ruby SDK for Language Operator
 test_files: []