asimov-construct 25.0.0.dev.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f09cf8be0e11508993dc700df0149b4312b251609797bcb8400562dfc9ae01b8
+  data.tar.gz: 8f98eb8c3f2cc0775ee6de54f2c3a233ed28ecc58a77a37012b9ca80e597d9ff
+SHA512:
+  metadata.gz: 44adbfe80ee860e5f8c0e4898fb9136081cdc4f23d6c5b0623f89abef8e160418c73cb12ee631a37fd433951fb8c6f2be2c4948c8a40a6d10afd066575f83827
+  data.tar.gz: 36b0f7adfa50f580a023997e3562354d8cd85ceea3c95147d449cc2626194cf877476cb6d337581f7a496df76889315b4101fffcbbca649fa96eb75269c4bf44

data/AUTHORS

@@ -0,0 +1 @@
+* Arto Bendiken <arto@asimov.so>

data/CHANGES.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## 25.0.0.dev.4 - 2025-02-15
+
+## 25.0.0.dev.3 - 2025-02-15
+
+## 25.0.0.dev.2 - 2025-02-15
+
+## 25.0.0.dev.1 - 2025-02-12
+
+## 25.0.0.dev.0 - 2025-02-11
+
+## 24.0.0.dev.0 - 2024-06-26

data/README.md

@@ -0,0 +1,53 @@
+# ASIMOV Software Development Kit (SDK) for Ruby
+
+[![License](https://img.shields.io/badge/license-Public%20Domain-blue.svg)](https://unlicense.org)
+[![Compatibility](https://img.shields.io/badge/ruby-3.2%2B-blue)](https://rubygems.org/gems/asimov.rb)
+[![Package](https://img.shields.io/gem/v/asimov.rb)](https://rubygems.org/gems/asimov.rb)
+[![Documentation](https://img.shields.io/badge/rubydoc-latest-blue)](https://rubydoc.info/gems/asimov.rb)
+
+🚧 _We are building in public. This is presently under heavy construction._
+
+## ✨ Features
+
+- 100% free and unencumbered public domain software.
+
+## 🛠️ Prerequisites
+
+- [Ruby] 3.2+
+
+## ⬇️ Installation
+
+### Installation via RubyGems
+
+```bash
+gem install asimov.rb --pre
+```
+
+## 👉 Examples
+
+- [Importing the SDK](#importing-the-sdk)
+
+### Importing the SDK
+
+```ruby
+require 'asimov'
+```
+
+## 📚 Reference
+
+https://rubydoc.info/gems/asimov.rb
+
+## 👨‍💻 Development
+
+```bash
+git clone https://github.com/asimov-platform/asimov.rb.git
+```
+
+- - -
+
+[![Share on Twitter](https://img.shields.io/badge/share%20on-twitter-03A9F4?logo=twitter)](https://twitter.com/share?url=https://github.com/asimov-platform/asimov.rb&text=ASIMOV%20Software%20Development%20Kit%20%28SDK%29%20for%20Ruby)
+[![Share on Reddit](https://img.shields.io/badge/share%20on-reddit-red?logo=reddit)](https://reddit.com/submit?url=https://github.com/asimov-platform/asimov.rb&title=ASIMOV%20Software%20Development%20Kit%20%28SDK%29%20for%20Ruby)
+[![Share on Hacker News](https://img.shields.io/badge/share%20on-hacker%20news-orange?logo=ycombinator)](https://news.ycombinator.com/submitlink?u=https://github.com/asimov-platform/asimov.rb&t=ASIMOV%20Software%20Development%20Kit%20%28SDK%29%20for%20Ruby)
+[![Share on Facebook](https://img.shields.io/badge/share%20on-facebook-1976D2?logo=facebook)](https://www.facebook.com/sharer/sharer.php?u=https://github.com/asimov-platform/asimov.rb)
+
+[Ruby]: https://ruby-lang.org

data/UNLICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org/>

data/VERSION

@@ -0,0 +1 @@
+25.0.0.dev.4

data/lib/asimov/construct.rb

@@ -0,0 +1,215 @@
+# This is free and unencumbered software released into the public domain.
+
+require "asimov/config"
+require "kdl"
+require "pathname"
+
+class KDL::Document
+  def deconstruct
+    self.nodes
+  end
+
+  def deconstruct_keys(keys)
+    keys.inject({}) do |result, key|
+      result[key] = self[key]
+      result
+    end
+  end
+end # KDL::Document
+
+class KDL::Node
+  def deconstruct
+    self.children
+  end
+
+  def deconstruct_keys(keys)
+    {name:, arguments:, properties:, children:, type:}
+  end
+end # KDL::Node
+
+class ASIMOV::Construct
+  ##
+  # @example
+  #   p ASIMOV::Construct.count
+  #
+  # @return [Integer]
+  def self.count
+    self.each.count
+  end
+
+  ##
+  # @example
+  #   p ASIMOV::Construct.ids
+  #
+  # @return [Array<String>]
+  def self.ids
+    self.each.map(&:id).to_a
+  end
+
+  ##
+  # @example
+  #   ASIMOV::Construct.list(prefix: "isaac") do |construct|
+  #     puts construct.name
+  #   end
+  #
+  # @example
+  #   p ASIMOV::Construct.list(prefix: "isaac").to_a
+  #
+  # @param  [String, #to_s] prefix
+  # @yield [construct]
+  # @yieldparam [ASIMOV::Construct] construct
+  # @yieldreturn [void]
+  # @return [Enumerator] if no block was given
+  def self.list(prefix: nil, &block)
+    return enum_for(__method__, prefix:) unless block_given?
+    result = self.each
+    result = result.filter { _1.id.start_with?(prefix.to_s) } if prefix
+    result.each(&block)
+  end
+
+  ##
+  # @example
+  #   ASIMOV::Construct.each do |construct|
+  #     puts construct.name
+  #   end
+  #
+  # @yield [construct]
+  # @yieldparam [ASIMOV::Construct] construct
+  # @yieldreturn [void]
+  # @return [Enumerator] if no block was given
+  def self.each(&block)
+    return enum_for(__method__) unless block_given?
+    construct_dirs = ASIMOV::Config.each_construct_dir.to_a
+    construct_dirs.filter! { _1.join("construct.kdl").readable? }
+    construct_dirs.sort_by!(&:basename).each do |construct_path|
+      block.call(self.parse(construct_path))
+    end
+  end
+
+  ##
+  # @example
+  #   ASIMOV::Construct.open("isaac.asimov") do |construct|
+  #     puts construct.system_prompt
+  #   end
+  #
+  # @param  [String, #to_s] id
+  # @yield [construct]
+  # @yieldparam [ASIMOV::Construct] construct
+  # @yieldreturn [Object]
+  # @return [ASIMOV::Construct] or `nil` if the construct does not exist
+  def self.open(id, &block)
+    id = id.is_a?(self.class) ? id.id : id.to_s
+    result = self.parse(ASIMOV::Config.constructs_dir.join(id))
+    result = block.call(result) if block_given?
+    result
+  rescue Errno::ENOENT => error
+    nil
+  end
+
+  ##
+  # @example
+  #   ASIMOV::Construct.parse("asimov-constructs/isaac.asimov")
+  #
+  # @param  [Pathname, #to_s] path
+  # @return [ASIMOV::Construct]
+  def self.parse(path)
+    manifest_path = Pathname(path).join("construct.kdl")
+    manifest = KDL.load_file(manifest_path)
+    construct_kwargs = case manifest
+      in [{name: "construct", arguments: [construct_id], children:}]
+        children.inject({}) do |kwargs, node|
+          case node
+            in {name: "name", children:}
+              kwargs[:names] = children.inject({}) do |result, node|
+                result[node.name.to_sym] = node.arguments&.first&.value
+                result
+              end
+            in {name: "links", children:}
+              kwargs[:links] = children.inject({}) do |result, node|
+                result[node.name.to_sym] = node.arguments&.first&.value
+                result
+              end
+          end
+          kwargs
+        end
+      else
+        raise ArgumentError, "invalid construct manifest: #{manifest_path}"
+    end
+    self.new(construct_id, path:, **construct_kwargs)
+  end
+
+  ##
+  # @param  [String, #to_s] id
+  # @param  [Pathname] path
+  # @param  [Hash{Symbol => String}, #to_h] names
+  # @param  [Hash{Symbol => String}, #to_h] links
+  def initialize(id, path: nil, names: {}, links: {})
+    @id = id.to_s.freeze
+    @path = path ? Pathname(path).freeze : nil
+    @names = (names || {en: @id}).to_h.freeze
+    @links = (links || {}).to_h.freeze
+  end
+
+  ##
+  # @return [String]
+  attr_reader :id
+
+  ##
+  # @return [Pathname]
+  attr_reader :path
+
+  ##
+  # @return [String]
+  attr_reader :name
+  def name; self.names[:en]; end
+
+  ##
+  # @return [Hash{Symbol => String}]
+  attr_reader :names
+
+  ##
+  # @return [Hash{Symbol => String}]
+  attr_reader :links
+
+  ##
+  # @return [String]
+  def system_prompt
+    self.path.join("system.md").read.strip rescue nil
+  end
+
+  ##
+  # @return [String]
+  def to_h
+    {id:, names:, links:}
+  end
+
+  ##
+  # @return [KDL::Document]
+  def to_kdl
+    require "kdl"
+    KDL::Document.new([
+      KDL::Node.new("construct", arguments: [self.id], children: [
+        KDL::Node.new("name", children: self.names.map do |k, v|
+          KDL::Node.new(k.to_s, arguments: [v])
+        end),
+        KDL::Node.new("links", children: self.links.map do |k, v|
+          KDL::Node.new(k.to_s, arguments: [v])
+        end),
+      ]),
+    ])
+  end
+
+  ##
+  # @return [String]
+  def to_json
+    require "json"
+    JSON.pretty_generate(self.to_h)
+  end
+
+  ##
+  # @return [String]
+  def to_yaml
+    require "yaml"
+    YAML.dump(self.to_h, stringify_names: true)
+  end
+end # ASIMOV::Construct

data/lib/asimov-construct.rb

@@ -0,0 +1,3 @@
+# This is free and unencumbered software released into the public domain.
+
+require_relative "asimov/construct"

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification
+name: asimov-construct
+version: !ruby/object:Gem::Version
+  version: 25.0.0.dev.4
+platform: ruby
+authors:
+- ASIMOV Protocol
+bindir: bin
+cert_chain: []
+date: 2025-02-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: asimov-config
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 25.0.0.dev.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 25.0.0.dev.4
+- !ruby/object:Gem::Dependency
+  name: kdl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: ''
+email: support@asimov.so
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- AUTHORS
+- CHANGES.md
+- README.md
+- UNLICENSE
+- VERSION
+- lib/asimov-construct.rb
+- lib/asimov/construct.rb
+homepage: https://sdk.asimov.so
+licenses:
+- Unlicense
+metadata:
+  bug_tracker_uri: https://github.com/asimov-platform/asimov.rb/issues
+  changelog_uri: https://github.com/asimov-platform/asimov.rb/blob/master/CHANGES.md
+  documentation_uri: https://rubydoc.info/gems/asimov-construct
+  homepage_uri: https://sdk.asimov.so
+  source_code_uri: https://github.com/asimov-platform/asimov.rb
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: ASIMOV Software Development Kit (SDK) for Ruby
+test_files: []