koz 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0ebe61246f28706d241447b6a2ed03844e451d41f565bd657c1384f7297fe977
+  data.tar.gz: f8b81184a5fd9348e5b4e127e939141793ed41e2c18960cd2dc9c56f9f190fb6
+SHA512:
+  metadata.gz: 7724ca35328f42aaa4d774abf0744fef8c7a74f0117deb676fad172c48af4990105a7d9c3c20866ab30819f953227b67c17d56df8f32d98d6c7051e6c69f0590
+  data.tar.gz: 5d5609fc8d6678473c425e5a5a2bd367a7101193eda2e1ff99a1722a5925b950e39cf154e600765da648b8fb784f7d9b972a83fff866808837a91f3f611f28c7

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2026-08-25
+
+- Initial release

data/README.md

@@ -0,0 +1,49 @@
+# Koz :: 宇宙
+
+造反有理，革命无罪。
+
+一个不中立，人类可达、科技向善的机器人框架。
+
+# 功能
+
+- 插件系统
+
+- 接入 LLM（大语言模型）
+
+- 记忆
+
+- WebUI
+
+# 安装
+
+```
+gem install koz
+```
+
+# 启动
+
+```
+kozbot
+```
+
+默认工作目录为 `~/.kozbot`
+
+以当前文件夹为工作目录
+
+```
+kozbot -d
+```
+
+指定 webui 端口
+
+```
+kozbot --port 10100
+```
+
+# 安装插件
+
+安装 OneBot 适配器
+
+```
+gem install kozbot-snowluma
+```

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/kozbot.rb

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+
+require 'koz'
+require 'ostruct'
+
+MY = OpenStruct.new
+
+require 'ostruct'
+MY ||= OpenStruct.new
+
+MY.home = Dir.home+"/.koz-bot"
+MY.config = Koz::Config.connect_file MY.home+'/config.yaml'
+puts "koz starts!"
+
+class App < Koz::Poti
+  enter do |r|
+    # TODO
+    puts "[\e[33mINFO\e[0m] got message: #{r.data.inspect}"
+    r.on post_type: 'message' do
+      r.reply "Ciallo～(∠・ω< )⌒☆、ここは demo ロボット～谢谢茄子"
+    end
+  end
+end

data/lib/koz/config.rb

@@ -0,0 +1,116 @@
+require 'yaml'
+
+module Koz
+  class Config
+    def self.connect_file path
+      new(path)
+    end
+
+    def keys
+      @config.keys
+    end
+
+    def key? key
+      @config.key? key
+    end
+
+    def initialize path
+      @path = path
+      @config = YAML.load_file(path)
+      @handler = -> (keys, new_value, old_value) {  }
+    end
+
+    def handle &blk
+      @handler = blk
+    end
+
+    def reload
+      @config = YAML.load_file(@path)
+    end
+
+    def to_yaml
+      @config.to_yaml
+    end
+
+    def save_config
+      File.write(@path, @config.to_yaml)
+    end
+
+    def get key, *rest
+      # keys = key.split('/')
+      @config.dig(key, *rest)
+    end
+
+    def set *keys, new_value, yaml: false
+      return false if keys.empty?
+      # keys = keys.map{_1.split("/")}.flatten
+      if yaml
+        new_value = YAML.load(value)
+      end
+    
+      key = keys.last
+      if keys.size > 1
+        container = @config.dig(*keys[..-2])
+      else
+        container = @config
+      end
+      old_value = container[key]
+      container[key] = JSON.parse(new_value.to_json)
+      @handler.call(keys, new_value, old_value)
+      save_config
+    end
+
+    def yaml_set(*)
+      set(*, yaml: true)
+    end
+
+    def safe_get(*)
+      YAML.load get(*).to_yaml
+    end
+
+    # insert an element to a array [key]
+    def insert element, at:
+      case at
+      when String
+        if @config.key? at
+          @config[at]
+        else
+          @config.dig(*at.split(/[\/.]/))
+        end
+      when Array
+        @config.dig(*at)
+      end.push element
+      save_config
+    end
+
+    # delete an element at array [key]
+    def delete element, at:
+      case at
+      when String
+        if @config.key? at
+          @config[at]
+        else
+          @config.dig(*at.split(/[\/.]/))
+        end
+      when Array
+        @config.dig(*at)
+      end.delete element
+      save_config
+    end
+
+    alias [] get
+    alias []= set
+
+  end
+
+  class Event
+    attr_accessor :config
+  end
+  
+  class Box
+    def config
+      @event.config
+    end
+  end
+
+end

data/lib/koz/event.rb

@@ -0,0 +1,28 @@
+module Koz
+  class Event
+    attr_accessor :target, :data, :type, :stopped, :box, :path
+    def initialize
+      @target = nil
+      @data = {}
+      @type = nil
+      @box = Poti
+      @path = []
+    end
+
+    def dup
+      ev = self.class.new
+      ev.target = @target
+      ev.data = @data.dup
+      ev.type = @type.dup
+      ev
+    end
+
+    def >> photon
+      photon.call self
+    end
+
+    def to_box
+      @box.new(self)
+    end
+  end
+end

data/lib/koz/import.rb

@@ -0,0 +1,9 @@
+def import file, into: nil
+  code = File.read file
+  m = into || Module.new
+  unless into
+    code = "module_function\n\n" + code
+  end
+  m.module_eval code, file
+  m
+end

data/lib/koz/poti.rb

@@ -0,0 +1,149 @@
+module Koz
+
+  class BasePoti
+
+    class << self
+      
+      def class_initialize
+        @_entrance = -> (event) {}
+        @_class = 'Poti'
+      end
+
+      attr_accessor :_entrance
+
+      def inheritance(&blk)
+        klass = Class.new(self)
+        if blk
+          case blk.arity
+          when 0
+            klass.class_eval(&blk) 
+          when 1
+            blk.call(klass)
+          end
+        end
+        klass
+      end
+
+      def inherited klass
+        klass.class_initialize
+      end
+
+      def enter &blk
+        @_entrance = blk
+      end
+
+      def call event
+        _call event
+      end
+
+      def _call(event)
+        event
+      end
+
+      def to_proc
+        -> (event) { self.call(event) }
+      end
+
+      def inspect
+        name ? "#{name} < #{@_class}" : "#{@_class}.inheritance"
+      end
+
+    end
+
+    class_initialize
+
+  end
+
+  class Poti < BasePoti
+
+    class << self
+      def _call event
+        return event if event.stopped
+        event = super(event)
+        box = new(event)
+        catch :outer_of_enter do
+          @_entrance.call(box)
+        end
+        event
+      end
+
+      def >> pot
+        -> (event) { pot.call self.call event }
+      end
+
+      def test(**, &blk)
+        ev = Event.new
+        ev.data = {**}
+        yield(ev) if blk
+        call(ev)
+      end
+
+    end
+
+    attr_accessor :event#, :nowa_block
+
+    def initialize event
+      @event = event
+    end
+
+    def data; @event.data; end
+    def target; @event.target; end
+    def type; @event.type; end
+    def type= ano; @event.type= ano; end
+
+    def stop; @event.stopped = true
+    end
+
+    def on(type=true, **kws, &blk)
+      case type
+      when false, nil
+        return type
+      when true
+      when Array
+        type.include?(@event.type)
+      else
+        type === @event.type
+      end
+
+      s_kws = kws.transform_keys(&:to_s)
+      all_match = s_kws.map { |k, v| v === @event.data[k] }.all?
+      if all_match && blk
+        # orig_block = @nowa_block
+        # @nowa_scope = blk
+        catch(:outer) { blk.call }
+        # @nowa_block = orig_block
+      end
+      all_match
+    end
+
+    def group name=nil, cond=true, &blk
+      if cond
+        catch :outer do
+          if name
+            catch :"group_of_#{name}" do
+              blk.call
+            end
+          else
+            blk.call
+          end
+        end
+      end
+    end
+
+    def pass; throw :outer_of_enter, self
+    end
+
+    # def halt; throw :outer_of_pipe, self
+    # end
+
+    def stop; @event.stopped = true
+    end
+
+    def out; throw :outer
+    end
+
+    class_initialize
+
+  end
+
+end

data/lib/koz/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Koz
+  VERSION = "0.1.0"
+end

data/lib/koz.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative "koz/version"
+
+require_relative 'koz/event'
+require_relative 'koz/poti'
+require_relative 'koz/config'
+require_relative 'koz/import'
+
+module Koz
+  class Error < StandardError; end
+  # Your code goes here...
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: koz
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- 彩穂
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: A bot framework support many protocol and api.
+email:
+- 37037844+Saisui@users.noreply.github.com
+executables:
+- kozbot.rb
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- README.md
+- Rakefile
+- bin/kozbot.rb
+- kozbot.bat
+- lib/koz.rb
+- lib/koz/config.rb
+- lib/koz/event.rb
+- lib/koz/import.rb
+- lib/koz/poti.rb
+- lib/koz/version.rb
+homepage: https://github.com/saisui/koz-ruby
+licenses: []
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/saisui/koz-ruby
+  source_code_uri: https://rubygems.org
+  changelog_uri: https://github.com/saisui/koz-ruby/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.9
+specification_version: 4
+summary: The Comfortable Bot Framework.
+test_files: []