language-operator 0.1.46 → 0.1.47

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '014892e52c89c77009fbcdc0dde8449e2c839ef18ddad8f7dac4ed393e294a8b'
-  data.tar.gz: 240d5cf62f332fa83535cb8739b4149c6e3aae3d191b3cb5f21645e847db0d27
+  metadata.gz: 6a7f1f7e5550c2118f096f8dad4eaba602d36c99bee49ed7c0bdf09b6c3a5098
+  data.tar.gz: e1c4b977724e311aadc28788d4d83affb87cc0bc21c34c423984e6fe8c3a5b79
 SHA512:
-  metadata.gz: b0bfc1d43409d369e848d448cd5a5c9cb21a0f85bd41d7cdf993be322f5be43b0e9aabdd39d7979701bf8a41f4476bf0502782af4eb712fb8bc669d4568384e0
-  data.tar.gz: 0bd79c7a91e1b5d59904cdb1467fc0c507e62993d9cb676ce202d23d218f3ecfa6c0ffe299959cf47c6ed82b7147eb1ffe1170069f0f083f2c4e68bf90dd1962
+  metadata.gz: 2261ac662c454529aa1e56e2ae3c59bcd989f523a314ff5a4cf8b769a727fb9544def42d570271c9529761d9fd32366347f89262922ecef43e0f73f2fbe56409
+  data.tar.gz: dc31892136d0702e32c6e107b50c8a90d5b439bacc32e59015c84f2490196526177f5825c04537a3c0ef1d6b65f9367ba3a340ee14fcd0ca7f9dceca77e7ce55

data/.claude/commands/task.md

@@ -0,0 +1,10 @@
+# Task Commmand
+
+## Inputs
+
+- :task str - name of task to run
+- :persona str (optional) - persona to assume
+
+## Instructions
+
+You have been instructed to read and execute a task.  The task definitions are found in ./requirements/tasks/:name.md.

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    language-operator (0.1.46)
+    language-operator (0.1.47)
       faraday (~> 2.0)
       k8s-ruby (~> 0.17)
       mcp (~> 0.4)

data/components/agent/.rubocop.yml

@@ -0,0 +1 @@
+inherit_from: ../../.rubocop.yml

data/components/agent/Dockerfile

@@ -0,0 +1,43 @@
+FROM ghcr.io/language-operator/base:latest
+
+# Install agent-specific packages (Ruby deps inherited from base)
+RUN apk add --no-cache jq
+
+WORKDIR /app/agent
+
+# Copy Gemfile and install dependencies
+COPY Gemfile /app/agent/
+
+# Copy local gem if building in CI (will be downloaded from artifact)
+# Use wildcard with --chown to avoid failure if file doesn't exist
+COPY --chown=root:root language-operator-*.gem* /tmp/
+
+# Install local gem first if it exists, then install bundle dependencies
+RUN if ls /tmp/language-operator-*.gem 1> /dev/null 2>&1; then \
+        echo "Installing local language-operator gem..." && \
+        gem install /tmp/language-operator-*.gem && \
+        rm /tmp/language-operator-*.gem*; \
+    fi && \
+    bundle install --no-cache
+
+# Copy default agent configuration
+COPY config/ /app/agent/config/
+
+# Copy entrypoint script
+COPY bin/langop-agent /usr/local/bin/langop-agent
+RUN chmod +x /usr/local/bin/langop-agent
+
+# Set ownership
+RUN chown -R langop:langop /app/agent
+
+# Switch to langop user
+USER langop
+
+# Set environment defaults
+ENV WORKSPACE_PATH="/workspace" \
+    AGENT_MODE="autonomous" \
+    AGENT_CODE_PATH="/etc/agent/code/agent.rb" \
+    AGENT_FALLBACK_MODE="error"
+
+# Default command - auto-loads synthesized code from ConfigMap
+CMD ["/usr/local/bin/langop-agent"]

data/components/agent/Dockerfile.dev

@@ -0,0 +1,38 @@
+FROM ghcr.io/language-operator/base:latest
+
+# Install agent-specific packages (Ruby deps inherited from base)
+RUN apk add --no-cache jq
+
+WORKDIR /app/agent
+
+# Copy the local gem file
+COPY language-operator-*.gem /tmp/
+
+# Copy Gemfile and install dependencies with development group
+COPY Gemfile /app/agent/
+
+# Install the local gem directly instead of using bundler groups
+RUN gem install /tmp/language-operator-*.gem && \
+    bundle install --no-cache
+
+# Copy default agent configuration
+COPY config/ /app/agent/config/
+
+# Copy entrypoint script
+COPY bin/langop-agent /usr/local/bin/langop-agent
+RUN chmod +x /usr/local/bin/langop-agent
+
+# Set ownership
+RUN chown -R langop:langop /app/agent
+
+# Switch to langop user
+USER langop
+
+# Set environment defaults
+ENV WORKSPACE_PATH="/workspace" \
+    AGENT_MODE="autonomous" \
+    AGENT_CODE_PATH="/etc/agent/code/agent.rb" \
+    AGENT_FALLBACK_MODE="error"
+
+# Default command - auto-loads synthesized code from ConfigMap
+CMD ["/usr/local/bin/langop-agent"]

data/components/agent/Gemfile

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gem 'language-operator', '~> 0.1.46'
+
+# Agent-specific dependencies for autonomous execution
+gem 'concurrent-ruby', '~> 1.3'
+gem 'rufus-scheduler', '~> 3.9'
+
+group :development do
+  gem 'rubocop', '~> 1.60'
+  gem 'rubocop-performance', '~> 1.20'
+  gem 'yard', '~> 0.9.37'
+end

data/components/agent/Makefile

@@ -0,0 +1,67 @@
+# Image configuration
+IMAGE_NAME := ghcr.io/language-operator/agent
+IMAGE_TAG := latest
+IMAGE_FULL := $(IMAGE_NAME):$(IMAGE_TAG)
+
+# Include shared targets
+include ../../Makefile.common
+
+# Default target
+.PHONY: help
+help:
+	@echo "Available targets:"
+	@echo "  build       - Build the Docker image"
+	@echo "  build-dev   - Build the Docker image with local gem"
+	@echo "  push-dev    - Build and push dev image to all k8s nodes"
+	@echo "  build-all   - Build all inherited images in order (base→agent)"
+	@echo "  scan        - Scan the Docker image with Trivy"
+	@echo "  shell       - Run interactive shell in container"
+	@echo "  run         - Run the agent framework"
+	@echo "  test        - Run tests (linting)"
+	@echo "  lint        - Run RuboCop linter"
+	@echo "  doc         - Generate YARD documentation"
+	@echo "  clean       - Clean generated files"
+
+# Build development image with local gem
+.PHONY: build-dev
+build-dev:
+	@echo "Building local gem..."
+	cd ../../../language-operator-gem && gem build language-operator.gemspec
+	@echo "Copying gem to build context..."
+	cp ../../../language-operator-gem/*.gem .
+	@echo "Building Docker image..."
+	docker build -f Dockerfile.dev -t $(IMAGE_NAME):dev -t $(IMAGE_NAME):$(IMAGE_TAG)-dev .
+	@echo "Cleaning up gem file..."
+	rm language-operator-*.gem
+
+# Push development image to all k8s cluster nodes (containerd/k3s)
+.PHONY: push-dev
+push-dev: build-dev
+	@echo "Pushing development image to all k8s nodes..."
+	@for node in $$(kubectl get nodes -o jsonpath='{.items[*].metadata.name}'); do \
+		echo "==> Pushing to node: $$node"; \
+		docker save $(IMAGE_NAME):dev | ssh $$node 'sudo k3s ctr images import -' || echo "Failed to push to $$node"; \
+	done
+	@echo "✓ Development image pushed to all nodes!"
+
+# Build all inherited images in dependency order
+.PHONY: build-all
+build-all:
+	@echo "Building inherited image chain: base → agent"
+	@echo ""
+	@echo "==> Building base image..."
+	cd ../base && $(MAKE) build
+	@echo ""
+	@echo "==> Building agent image..."
+	$(MAKE) build
+	@echo ""
+	@echo "✓ All images built successfully!"
+
+# Run the agent framework
+.PHONY: run
+run:
+	docker run --rm -it \
+		-v $(PWD)/config:/app/agent/config \
+		-e WORKSPACE_PATH=/workspace \
+		-e AGENT_MODE=autonomous \
+		$(IMAGE_FULL)

data/components/agent/bin/langop-agent

@@ -0,0 +1,140 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Langop Agent Entrypoint
+#
+# This script auto-loads synthesized agent code from a ConfigMap volume
+# or falls back to default agent behavior if no code is provided.
+#
+# The operator synthesizes agent DSL code from natural language instructions
+# and mounts it as a ConfigMap at AGENT_CODE_PATH.
+
+# Disable output buffering for immediate log visibility
+$stdout.sync = true
+$stderr.sync = true
+
+require 'language_operator'
+
+# Wait for tool sidecars to be ready
+def wait_for_tools(config)
+  return unless config['mcp_servers']
+
+  require 'net/http'
+  require 'uri'
+
+  servers = config['mcp_servers'] || []
+  servers.each do |server|
+    url = server['url']
+    next unless url&.start_with?('http')
+
+    uri = URI.parse(url)
+    max_attempts = 30
+    delay = 1
+
+    puts "Waiting for tool at #{uri.host}:#{uri.port}..."
+
+    max_attempts.times do |attempt|
+      # Try to connect to the health endpoint or root
+      Net::HTTP.start(uri.host, uri.port, open_timeout: 1, read_timeout: 1) do |http|
+        http.head('/')
+      end
+      puts "Tool ready at #{uri.host}:#{uri.port}"
+      break
+    rescue StandardError
+      if attempt < max_attempts - 1
+        sleep(delay)
+      else
+        puts "Tool at #{uri.host}:#{uri.port} not ready after #{max_attempts} attempts"
+      end
+    end
+  end
+end
+
+# Configuration
+code_path = ENV.fetch('AGENT_CODE_PATH', '/etc/agent/code/agent.rb')
+fallback_mode = ENV.fetch('AGENT_FALLBACK_MODE', 'error') # error | autonomous | interactive
+
+# Check if synthesized code exists
+if File.exist?(code_path)
+  begin
+    # Load the synthesized DSL code using the agent loader
+    # This provides the DSL context with the 'agent' method
+    LanguageOperator::Dsl.load_agent_file(code_path)
+
+    # Get the agent from the registry
+    agents = LanguageOperator::Dsl.agent_registry.all
+    if agents.empty?
+      puts 'No agent defined in code'
+      exit 1
+    end
+
+    agent_def = agents.first
+
+    # Execute the agent based on its definition using DSL v1 flow
+    config = LanguageOperator::Client::Config.from_env
+    agent = LanguageOperator::Agent::Base.new(config)
+
+    # Wait for tool sidecars to be ready before connecting
+    wait_for_tools(config)
+
+    # Use the proper agent execution flow that handles DSL v1 main blocks, tasks, and output handlers
+    LanguageOperator::Agent.run_with_definition(agent, agent_def)
+  rescue StandardError => e
+    puts "Error loading agent code: #{e.message}"
+    puts e.backtrace.take(5).join("\n")
+
+    case fallback_mode
+    when 'autonomous'
+      puts 'Falling back to autonomous mode with default config'
+      fallback_to_autonomous
+    when 'interactive'
+      puts 'Falling back to interactive mode'
+      fallback_to_interactive
+    else
+      puts 'No fallback configured, exiting'
+      exit 1
+    end
+  end
+
+else
+  puts "No synthesized code found at #{code_path}"
+
+  case fallback_mode
+  when 'autonomous'
+    puts 'Starting in autonomous mode with default config'
+    fallback_to_autonomous
+  when 'interactive'
+    puts 'Starting in interactive mode'
+    fallback_to_interactive
+  else
+    puts 'No agent code provided and no fallback configured'
+    puts 'The operator should have created a ConfigMap with synthesized code'
+    puts 'Check LanguageAgent status for synthesis errors'
+    exit 1
+  end
+end
+
+# Fallback implementations
+def fallback_to_autonomous
+  config = LanguageOperator::Client::Config.load_with_fallback
+  agent = LanguageOperator::Agent::Base.new(config)
+
+  # Get instructions from environment
+  instructions = ENV.fetch('AGENT_INSTRUCTIONS', nil)
+
+  if instructions && !instructions.empty?
+    agent.connect!
+
+    # Simple autonomous loop
+    executor = LanguageOperator::Agent::Executor.new(agent)
+    executor.execute(instructions)
+  else
+    puts 'No instructions provided in AGENT_INSTRUCTIONS'
+    exit 1
+  end
+end
+
+def fallback_to_interactive
+  puts 'Interactive mode not yet implemented'
+  exit 1
+end

data/components/agent/config/config.yaml

@@ -0,0 +1,47 @@
+# Agent Configuration Example
+#
+# This configuration file defines the behavior of a language agent.
+
+# LLM Configuration
+llm:
+  provider: openai_compatible  # openai, anthropic, or openai_compatible
+  model: llama3.2
+  endpoint: http://model-proxy:8080/v1
+  # api_key: optional for local models
+
+# MCP Server Connections
+mcp_servers:
+  - name: default-tools
+    url: http://tools:80/mcp
+    transport: streamable
+    enabled: true
+    description: "Default tool server"
+
+# Agent-specific configuration
+agent:
+  # Instructions for the agent
+  instructions: |
+    You are a helpful autonomous agent.
+    Monitor your workspace and complete assigned tasks.
+
+  # Execution mode: autonomous, interactive, scheduled, event-driven
+  mode: autonomous
+
+  # Maximum iterations for autonomous mode (prevents infinite loops)
+  max_iterations: 100
+
+  # Schedules for scheduled mode (cron format)
+  schedules:
+    - cron: "0 6 * * *"  # Daily at 6:00 AM
+      task: "Check for updates and report status"
+
+    # - cron: "0 * * * *"  # Every hour
+    #   task: "Monitor system health"
+
+# Workspace configuration
+workspace:
+  enabled: true
+  path: /workspace
+
+# Debug mode
+debug: false

data/components/base/Dockerfile

@@ -0,0 +1,34 @@
+FROM alpine:3
+
+ENV LANGOP_VERSION=0.1
+ENV LANGOP_USER=langop
+
+# Install tini for proper init and su-exec for user switching
+RUN apk add --no-cache tini su-exec
+
+# Install common Ruby dependencies for all components
+RUN apk add --no-cache \
+    ruby \
+    ruby-dev \
+    ruby-bundler \
+    build-base \
+    curl \
+    ca-certificates \
+    tzdata
+
+# Create the langop user (but don't switch to it yet - let child images do their work first)
+RUN addgroup -S langop && adduser -S langop -G langop
+
+# Create gem directories for bundler
+RUN mkdir -p /root/.gem /home/langop/.gem && \
+    chown -R langop:langop /home/langop/.gem
+
+# Copy entrypoint script
+COPY entrypoint.sh /usr/local/bin/entrypoint.sh
+RUN chmod +x /usr/local/bin/entrypoint.sh
+
+# Use tini as PID 1, which will run our entrypoint script
+ENTRYPOINT ["/sbin/tini", "--", "/usr/local/bin/entrypoint.sh"]
+
+# Default command
+CMD ["/bin/sh"]

data/components/base/Makefile

@@ -0,0 +1,42 @@
+# Image configuration
+IMAGE_NAME := ghcr.io/language-operator/base
+IMAGE_TAG := latest
+IMAGE_FULL := $(IMAGE_NAME):$(IMAGE_TAG)
+
+# Include shared targets
+include ../../Makefile.common
+
+# Default target
+.PHONY: help
+help:
+	@echo "Available targets:"
+	@echo "  build - Build the Docker image"
+	@echo "  push  - Push the Docker image to the registry"
+	@echo "  scan  - Scan the Docker image with Trivy"
+	@echo "  test  - Test the Docker image"
+	@echo "  shell - Run the image and exec into it with an interactive shell"
+	@echo "  run   - Run the container"
+	@echo "  env   - Display sorted list of environment variables in the image"
+
+# Push the Docker image to the registry
+.PHONY: push
+push:
+	docker push $(IMAGE_FULL)
+
+# Override test to include base-specific tests
+.PHONY: test
+test:
+	@echo "Testing base image..."
+	docker run --rm $(IMAGE_FULL) ruby --version
+	docker run --rm $(IMAGE_FULL) bundle --version
+	@echo "All tests passed!"
+
+# Run the container
+.PHONY: run
+run:
+	docker run --rm -it $(IMAGE_FULL)
+
+# Display sorted list of environment variables in the image
+.PHONY: env
+env:
+	docker run --rm $(IMAGE_FULL) /bin/sh -c 'env | sort'

data/components/base/entrypoint.sh

@@ -0,0 +1,12 @@
+#!/bin/sh
+
+# Entrypoint script for langop/base image
+
+# If running as root and LANGOP_USER is set, switch to that user
+if [ "$(id -u)" = "0" ] && [ -n "$LANGOP_USER" ]; then
+    # Use su-exec for minimal overhead user switching
+    exec su-exec "$LANGOP_USER" "$@"
+else
+    # Already running as non-root user
+    exec "$@"
+fi

data/components/base/gem-credentials

@@ -0,0 +1,2 @@
+---
+https://git.theryans.io/api/packages/language-operator/rubygems: Bearer b579c250d4ac8223641f5f0178024c896b542812

data/components/tool/.gitignore

@@ -0,0 +1,10 @@
+# YARD documentation
+/doc/
+/.yardoc/
+
+# Bundler
+/vendor/bundle/
+/.bundle/
+
+# RuboCop cache
+/.rubocop-*

data/components/tool/.rubocop.yml

@@ -0,0 +1,19 @@
+inherit_from: ../../.rubocop.yml
+
+# Component-specific overrides
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: single_quotes
+
+Metrics/MethodLength:
+  Max: 20
+
+Metrics/BlockLength:
+  Exclude:
+    - '*.rb'
+    - 'examples/**/*.rb'
+
+Metrics/AbcSize:
+  Max: 20

data/components/tool/.yardopts

@@ -0,0 +1,7 @@
+--markup markdown
+--readme README.md
+--output-dir doc
+--protected
+--private
+lib/**/*.rb
+server.rb

data/components/tool/Dockerfile

@@ -0,0 +1,44 @@
+FROM ghcr.io/language-operator/base:latest
+
+# Ruby dependencies inherited from base image
+
+# Create application directory
+WORKDIR /app
+
+# Copy Gemfile and install dependencies
+COPY Gemfile /app/
+
+# Copy local gem if building in CI (will be downloaded from artifact)
+# Use wildcard with --chown to avoid failure if file doesn't exist
+COPY --chown=root:root language-operator-*.gem* /tmp/
+
+# Install local gem first if it exists, then install bundle dependencies
+RUN if ls /tmp/language-operator-*.gem 1> /dev/null 2>&1; then \
+        echo "Installing local language-operator gem..." && \
+        gem install /tmp/language-operator-*.gem && \
+        rm /tmp/language-operator-*.gem*; \
+    fi && \
+    bundle install --no-cache
+
+# Copy application files
+COPY server.rb /app/
+COPY lib/ /app/lib/
+
+# Create /mcp directory for tool definitions
+RUN mkdir -p /mcp && chown -R langop:langop /mcp
+
+# Ensure app directory is owned by langop user
+RUN chown -R langop:langop /app
+
+# Expose default port
+EXPOSE 80
+
+# Set environment variables
+ENV PORT=80
+ENV RACK_ENV=production
+
+# Switch to langop user
+USER langop
+
+# Start the server
+CMD ["ruby", "server.rb"]

data/components/tool/Dockerfile.dev

@@ -0,0 +1,39 @@
+FROM ghcr.io/language-operator/base:latest
+
+# Ruby dependencies inherited from base image
+
+# Create application directory
+WORKDIR /app
+
+# Copy the local gem file
+COPY language-operator-*.gem /tmp/
+
+# Copy Gemfile and install dependencies
+COPY Gemfile /app/
+
+# Install the local gem directly then install other dependencies
+RUN gem install /tmp/language-operator-*.gem && \
+    bundle install --no-cache
+
+# Copy application files
+COPY server.rb /app/
+COPY lib/ /app/lib/
+
+# Create /mcp directory for tool definitions
+RUN mkdir -p /mcp && chown -R langop:langop /mcp
+
+# Ensure app directory is owned by langop user
+RUN chown -R langop:langop /app
+
+# Expose default port
+EXPOSE 80
+
+# Set environment variables
+ENV PORT=80
+ENV RACK_ENV=production
+
+# Switch to langop user
+USER langop
+
+# Start the server
+CMD ["ruby", "server.rb"]

data/components/tool/Gemfile

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gem 'language-operator', '~> 0.1.46'
+
+# Tool server dependencies
+gem 'json', '~> 2.7'
+gem 'puma', '~> 6.4'
+gem 'rackup', '~> 2.1'
+gem 'sinatra', '~> 4.0'
+gem 'sinatra-contrib', '~> 4.0'
+
+group :development do
+  gem 'rubocop', '~> 1.60'
+  gem 'rubocop-performance', '~> 1.20'
+  gem 'yard', '~> 0.9.37'
+end