ad-agent_architecture 0.0.5 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48e72bffc8e25721cc39304860dac54bdde2cbe3828fd9bf39ea5a93d2ae40d8
-  data.tar.gz: 6579e5af918b96e8eb9960ea2e672cf1b2315fad054f794ca5789cec1779624c
+  metadata.gz: 25616fff163424e27ea21bf76cabec403e7113c7b018e791ed42fe523e7964aa
+  data.tar.gz: a34ad7c9d1275dc3db2394623874408225b67ab6a1a6d39bf0f2b46fafc7608f
 SHA512:
-  metadata.gz: a3ac5432296309961a50273fbb71cdf0fd681ab5d1a40cf7054a9b1a044001d1262d0eefc91f08f579a887294104dc3e22e2fbe3717e3c32b98fe0eae7ff54de
-  data.tar.gz: 93c048683f119fa32427bf57422bf1217bb689870162cb733a3eda10bdba6d92c0f8b7606e3550630b747ad2000a7bd48ec7c83beaa4ab2c67593a67c7b5b5ef
+  metadata.gz: f2acf82a7726aa7168e595cac40238e79e634a2a396c93899ab30394494bae8ba3d96e1a843e27a4a826e18c96fefbc290cd34ae4592dbdd24a83a7a12ec0734
+  data.tar.gz: 6f7948ae17ac536b0608e5063d6b61411ea74408d5cbdc8007772e6dab32d372b5c714f5a31ff19043958513094a5e9322661bbff41fca466f81ee86e21eacc8

data/.rubocop.yml

@@ -42,6 +42,8 @@ Metrics/BlockLength:
 
 Metrics/MethodLength:
   Max: 25
+  Exclude:
+    - "lib/ad/agent_architecture/dsl/*"
 
 Layout/LineLength:
   Max: 200
@@ -87,6 +89,12 @@ Lint/AmbiguousBlockAssociation:
 
 Style/AccessorGrouping:
   Enabled: false
+Metrics/AbcSize:
+  Exclude:
+    - "lib/ad/agent_architecture/dsl/*"
+Metrics/NoExpectationExample:
+  Exclude:
+    - "spec/ad/agent_architecture/dsl/*"
 
 Layout/SpaceBeforeComma:
   Enabled: false
@@ -105,3 +113,7 @@ RSpec/SpecFilePathSuffix:
 RSpec/NamedSubject:
   Exclude:
     - "**/spec/**/*"
+
+RSpec/ExampleLength:
+  Exclude:
+    - "**/spec/**/*"

data/CHANGELOG.md

@@ -1,3 +1,18 @@
+## [0.0.6](https://github.com/appydave/ad-agent_architecture/compare/v0.0.5...v0.0.6) (2024-06-28)
+
+
+### Bug Fixes
+
+* update requirements documentation ([e80d072](https://github.com/appydave/ad-agent_architecture/commit/e80d0728652c7a4fdeb014324f196e0044cb13af))
+
+## [0.0.5](https://github.com/appydave/ad-agent_architecture/compare/v0.0.4...v0.0.5) (2024-06-28)
+
+
+### Bug Fixes
+
+* add sqlite3, sequal and setup a schema ([a8fa9c9](https://github.com/appydave/ad-agent_architecture/commit/a8fa9c9ff29ed223644d3622bd46ca5d626af9a9))
+* add sqlite3, sequal and setup a schema ([87ded1e](https://github.com/appydave/ad-agent_architecture/commit/87ded1e6886d3190fc83ecaa4e215bacf044378f))
+
 ## [0.0.4](https://github.com/appydave/ad-agent_architecture/compare/v0.0.3...v0.0.4) (2024-06-26)
 
 

data/docs/requirements.md

@@ -1,3 +1,65 @@
+# AppyDave - Agent Architecture Schema
+
+## Purpose
+
+The application is designed to handle structured workflows for building documents or text-based assets using LLMs from OpenAi, Anthropic and others. It should be adaptable to any workflow that follows a structured concept or a series of steps.
+
+## Sample Workflows
+- YouTube titles
+- YouTube scripts
+- YouTube transcription to Medium, LinkedIn, etc.
+
+## Key Components
+
+### Static Workflow Definition
+- **Workflows**: Define a series of tasks to achieve a specific goal.
+- **Sections**: Subdivisions within workflows to organize steps logically.
+- **Steps**: Individual tasks within a section, each associated with an AI prompt and various input/output attributes.
+- **Attributes**: Parameters used in steps, which can be simple values or arrays.
+- **Input/Output Attributes**: Map attributes to steps as either inputs or outputs.
+
+### Dynamic Workflow Execution
+- **Workflow Runs**: Instances of workflow executions.
+- **Section Runs**: Instances of section executions within a workflow run.
+- **Step Runs**: Instances of step executions within a section run, supporting multiple branches.
+- **Attribute Values**: Store the values of attributes during step executions.
+
+## Features
+
+### Schema Creation and Models
+- Use Sequel and SQLite to define and manage the database schema.
+- Models are defined for workflows, sections, steps, attributes, and their relationships.
+
+### Testing and Validation
+- Unit tests to verify the schema and associations using RSpec.
+- Guard setup to automatically run tests when certain files are modified.
+
+### Data Management
+- Methods to export the database schema and data to JSON files for backup.
+- Methods to restore the database from JSON files for easy editing and re-importing.
+
+## Initial Workflows
+- These include YouTube video scripts, YouTube title creation, and transcription to articles.
+- These workflows serve as examples and validation for the broader concept.
+
+## Implementation Details
+- **Database**: Use SQLite with Sequel for ORM.
+- **Code Structure**: Organize code into modules and classes for database schema creation and model definitions.
+- **Testing**: Ensure models and associations are correctly implemented and tested.
+
+## Next Steps
+
+### Refine DSL for Static Workflows
+- Enhance the DSL to create and update static workflows.
+- Ensure it updates the database and exports workflows in JSON/YAML format.
+- Implement rendering of the workflow structure as HTML.
+
+### Plan Dynamic Execution
+- Determine the approach for executing workflows dynamically.
+- Decide on using a DSL or a web application for this purpose.
+
+This summary should help guide the development and focus on the core objectives and future directions.
+
 
 ## Schema for AI Agents
 

data/lib/ad/agent_architecture/db/models.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
-require 'sequel'
-
 module Ad
   module AgentArchitecture
     module Database
       # Workflow model represents a workflow entity in the database.
       class Workflow < Sequel::Model
+        set_primary_key :id
+
         one_to_many :sections, class: 'Ad::AgentArchitecture::Database::Section'
         one_to_many :attributes, class: 'Ad::AgentArchitecture::Database::Attribute'
         one_to_many :workflow_runs, class: 'Ad::AgentArchitecture::Database::WorkflowRun'

data/lib/ad/agent_architecture/db/save_workflow_graph.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Ad
+  module AgentArchitecture
+    module Database
+      class SaveWorkflowGraph
+        def initialize(workflow_hash)
+          @workflow_hash = workflow_hash
+        end
+
+        def save
+          DB.transaction do
+            # Save workflow
+            workflow_record = Ad::AgentArchitecture::Database::Workflow.create(name: @workflow_hash[:name])
+
+            # Save attributes
+            attribute_records = @workflow_hash[:attributes].map do |_name, attr|
+              Ad::AgentArchitecture::Database::Attribute.create(
+                name: attr[:name], type: attr[:type], is_array: attr[:is_array], workflow: workflow_record
+              )
+            end
+            attribute_map = attribute_records.to_h { |ar| [ar.name.to_sym, ar] }
+
+            # Save sections and steps
+            @workflow_hash[:sections].each do |section|
+              section_record = Ad::AgentArchitecture::Database::Section.create(
+                name: section[:name], order: section[:order], workflow: workflow_record
+              )
+
+              section[:steps].each do |step|
+                step_record = Ad::AgentArchitecture::Database::Step.create(
+                  name: step[:name], order: step[:order], prompt: step[:prompt], section: section_record
+                )
+
+                step[:input_attributes].each do |attr_name|
+                  Ad::AgentArchitecture::Database::InputAttribute.create(
+                    step: step_record, attribute: attribute_map[attr_name.to_sym]
+                  )
+                end
+
+                step[:output_attributes].each do |attr_name|
+                  Ad::AgentArchitecture::Database::OutputAttribute.create(
+                    step: step_record, attribute: attribute_map[attr_name.to_sym]
+                  )
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ad/agent_architecture/dsl/agent_workflow_dsl.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module Ad
+  module AgentArchitecture
+    module Dsl
+      # DSL for defining agent workflows
+      class AgentWorkflowDsl
+        def self.create(name:, &block)
+          new(name).tap do |dsl|
+            dsl.instance_eval(&block) if block_given?
+            dsl.save
+          end
+        end
+
+        def initialize(name)
+          @workflow = { name: name, sections: [], attributes: {} }
+          @current_section_order = 1
+        end
+
+        def attributes(&block)
+          instance_eval(&block) if block_given?
+        end
+
+        def attribute(name, type:, is_array: false)
+          @workflow[:attributes][name] = { name: name, type: type, is_array: is_array }
+        end
+
+        def section(name:, &block)
+          @current_step_order = 1
+          @current_section = { name: name, order: @current_section_order, steps: [] }
+          @current_section_order += 1
+          instance_eval(&block) if block_given?
+          @workflow[:sections] << @current_section
+        end
+
+        def step(name:, &block)
+          @current_step = { name: name, order: @current_step_order, input_attributes: [], output_attributes: [] }
+          @current_step_order += 1
+          instance_eval(&block) if block_given?
+          @current_section[:steps] << @current_step
+        end
+
+        def input(attr_name, **_opts)
+          @current_step[:input_attributes] << attr_name
+        end
+
+        def output(attr_name, **_opts)
+          @current_step[:output_attributes] << attr_name
+        end
+
+        def prompt(prompt_text, **_opts)
+          @current_step[:prompt] = prompt_text
+        end
+
+        def save
+          DB.transaction do
+            # Save workflow
+            workflow_record = Ad::AgentArchitecture::Database::Workflow.create(name: @workflow[:name])
+
+            # Save attributes
+            attribute_records = @workflow[:attributes].map do |_name, attr|
+              Ad::AgentArchitecture::Database::Attribute.create(
+                name: attr[:name], type: attr[:type], is_array: attr[:is_array], workflow: workflow_record
+              )
+            end
+            attribute_map = attribute_records.to_h { |ar| [ar.name.to_sym, ar] }
+
+            # Save sections and steps
+            @workflow[:sections].each do |section|
+              section_record = Ad::AgentArchitecture::Database::Section.create(
+                name: section[:name], order: section[:order], workflow: workflow_record
+              )
+
+              section[:steps].each do |step|
+                step_record = Ad::AgentArchitecture::Database::Step.create(
+                  name: step[:name], order: step[:order], prompt: step[:prompt], section: section_record
+                )
+
+                step[:input_attributes].each do |attr_name|
+                  Ad::AgentArchitecture::Database::InputAttribute.create(
+                    step: step_record, attribute: attribute_map[attr_name.to_sym]
+                  )
+                end
+
+                step[:output_attributes].each do |attr_name|
+                  Ad::AgentArchitecture::Database::OutputAttribute.create(
+                    step: step_record, attribute: attribute_map[attr_name.to_sym]
+                  )
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ad/agent_architecture/version.rb

@@ -2,6 +2,6 @@
 
 module Ad
   module AgentArchitecture
-    VERSION = '0.0.5'
+    VERSION = '0.0.7'
   end
 end

data/lib/ad/agent_architecture.rb

@@ -11,6 +11,7 @@ DB = Sequel.sqlite
 Ad::AgentArchitecture::Database::CreateSchema.new(DB).execute
 
 require 'ad/agent_architecture/db/models'
+require 'ad/agent_architecture/dsl/agent_workflow_dsl'
 
 module Ad
   module AgentArchitecture

data/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "ad-agent_architecture",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "ad-agent_architecture",
-      "version": "0.0.5",
+      "version": "0.0.7",
       "devDependencies": {
         "@klueless-js/semantic-release-rubygem": "github:klueless-js/semantic-release-rubygem",
         "@semantic-release/changelog": "^6.0.3",

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ad-agent_architecture",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "Architecture/Schema for AI Agents",
   "scripts": {
     "release": "semantic-release"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ad-agent_architecture
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.7
 platform: ruby
 authors:
 - David Cruwys
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-06-28 00:00:00.000000000 Z
+date: 2024-06-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: k_log
@@ -82,6 +82,8 @@ files:
 - lib/ad/agent_architecture.rb
 - lib/ad/agent_architecture/db/create_schema.rb
 - lib/ad/agent_architecture/db/models.rb
+- lib/ad/agent_architecture/db/save_workflow_graph.rb
+- lib/ad/agent_architecture/dsl/agent_workflow_dsl.rb
 - lib/ad/agent_architecture/version.rb
 - package-lock.json
 - package.json