ad-agent_architecture 0.0.7 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 25616fff163424e27ea21bf76cabec403e7113c7b018e791ed42fe523e7964aa
-  data.tar.gz: a34ad7c9d1275dc3db2394623874408225b67ab6a1a6d39bf0f2b46fafc7608f
+  metadata.gz: b1afc432b8e4a84cec6f099987e20ccb1abd19b278a1f299fdd3cd822e47b6f2
+  data.tar.gz: fd1b6e9054740f005c083712e3cd67b1872cc0cd8d66eadaa2c9541fb3f33c9c
 SHA512:
-  metadata.gz: f2acf82a7726aa7168e595cac40238e79e634a2a396c93899ab30394494bae8ba3d96e1a843e27a4a826e18c96fefbc290cd34ae4592dbdd24a83a7a12ec0734
-  data.tar.gz: 6f7948ae17ac536b0608e5063d6b61411ea74408d5cbdc8007772e6dab32d372b5c714f5a31ff19043958513094a5e9322661bbff41fca466f81ee86e21eacc8
+  metadata.gz: 7af0666287aaef19e10bc414c160066ff2ab0dde2f55f2ae758790454028bccc5bb33ee48fb1ff63ca307a98ab25a82a16a896d2dbf256090151870519e5cb78
+  data.tar.gz: ae03bbcc49b5f4a0f467852a6f2c411c5d45484ba86eeac3251f75ce97379b2f04e8790530248ad997e5b8fee776174c5ef6ec36b128d89dfc693c52e09de874

data/.rubocop.yml

@@ -14,7 +14,7 @@ AllCops:
   Exclude:
     - ".builders/**/*"
     - "spec/samples/**/*"
-    - "lib/ad/agent_architecture/db/*"
+    - "lib/ad/agent_architecture/database/*"
 
 Metrics/BlockLength:
   Exclude:
@@ -43,7 +43,7 @@ Metrics/BlockLength:
 Metrics/MethodLength:
   Max: 25
   Exclude:
-    - "lib/ad/agent_architecture/dsl/*"
+    - "lib/ad/agent_architecture/**/*"
 
 Layout/LineLength:
   Max: 200
@@ -91,7 +91,7 @@ Style/AccessorGrouping:
   Enabled: false
 Metrics/AbcSize:
   Exclude:
-    - "lib/ad/agent_architecture/dsl/*"
+    - "lib/ad/agent_architecture/**/*"
 Metrics/NoExpectationExample:
   Exclude:
     - "spec/ad/agent_architecture/dsl/*"

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [0.0.8](https://github.com/appydave/ad-agent_architecture/compare/v0.0.7...v0.0.8) (2024-06-29)
+
+
+### Bug Fixes
+
+* add basic reports ([82d89e1](https://github.com/appydave/ad-agent_architecture/commit/82d89e164744f9100f92ca8ec677447ee1c083cb))
+
+## [0.0.7](https://github.com/appydave/ad-agent_architecture/compare/v0.0.6...v0.0.7) (2024-06-29)
+
+
+### Bug Fixes
+
+* add basic support for database persistence to DSL ([632c815](https://github.com/appydave/ad-agent_architecture/commit/632c815133b2cd31ab95dccb3c0b8564e25aa605))
+
 ## [0.0.6](https://github.com/appydave/ad-agent_architecture/compare/v0.0.5...v0.0.6) (2024-06-28)
 
 

data/lib/ad/agent_architecture/database/sql_query.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Ad
+  module AgentArchitecture
+    module Database
+      class SQLQuery
+        SQL_DIR = File.expand_path('../sql', __dir__)
+
+        def self.query(sql_filename, params = {})
+          sql_path = File.join(SQL_DIR, "#{sql_filename}.sql")
+
+          # puts "SQL_DIR: #{SQL_DIR}"
+          # puts "SQL Path: #{sql_path}"
+          raise "SQL file not found: #{sql_path}" unless File.exist?(sql_path)
+
+          sql = File.read(sql_path)
+          DB.fetch(sql, params)
+        end
+      end
+    end
+  end
+end

data/lib/ad/agent_architecture/dsl/actions/save_database.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Ad
+  module AgentArchitecture
+    module Dsl
+      module Actions
+        # Save workflow graph to database
+        class SaveDatabase
+          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
+end

data/lib/ad/agent_architecture/dsl/actions/save_json.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'json'
+
+module Ad
+  module AgentArchitecture
+    module Dsl
+      module Actions
+        # Save workflow graph to JSON file
+        class SaveJson
+          def initialize(workflow_hash)
+            @workflow_hash = workflow_hash
+          end
+
+          def save(file_name)
+            # Pretty JSON
+            File.write(file_name, JSON.pretty_generate(@workflow_hash))
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ad/agent_architecture/dsl/actions/save_yaml.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'yaml'
+
+module Ad
+  module AgentArchitecture
+    module Dsl
+      module Actions
+        # Save workflow graph to YAML file
+        class SaveYaml
+          def initialize(workflow_hash)
+            @workflow_hash = workflow_hash
+          end
+
+          def save(file_name)
+            File.write(file_name, @workflow_hash.to_yaml)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -8,7 +8,6 @@ module Ad
         def self.create(name:, &block)
           new(name).tap do |dsl|
             dsl.instance_eval(&block) if block_given?
-            dsl.save
           end
         end
 
@@ -53,43 +52,23 @@ module Ad
         end
 
         def save
-          DB.transaction do
-            # Save workflow
-            workflow_record = Ad::AgentArchitecture::Database::Workflow.create(name: @workflow[:name])
+          Ad::AgentArchitecture::Dsl::Actions::SaveDatabase.new(@workflow).save
 
-            # 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] }
+          self
+        end
 
-            # 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
-              )
+        def save_json(file_name: nil)
+          full_file_name = file_name || 'workflow.json'
+          Ad::AgentArchitecture::Dsl::Actions::SaveJson.new(@workflow).save(full_file_name)
 
-              section[:steps].each do |step|
-                step_record = Ad::AgentArchitecture::Database::Step.create(
-                  name: step[:name], order: step[:order], prompt: step[:prompt], section: section_record
-                )
+          self
+        end
 
-                step[:input_attributes].each do |attr_name|
-                  Ad::AgentArchitecture::Database::InputAttribute.create(
-                    step: step_record, attribute: attribute_map[attr_name.to_sym]
-                  )
-                end
+        def save_yaml(file_name: nil)
+          full_file_name = file_name || 'workflow.yaml'
+          Ad::AgentArchitecture::Dsl::Actions::SaveYaml.new(@workflow).save(full_file_name)
 
-                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
+          self
         end
       end
     end

data/lib/ad/agent_architecture/report/workflow_detail_report.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'k_log'
+
+module Ad
+  module AgentArchitecture
+    module Report
+      # Print workflow details
+      class WorkflowDetailReport
+        include KLog::Logging
+
+        def print(workflow)
+          log.section_heading 'Workflow Details Report'
+          log.kv 'Name', workflow.name
+          log.kv 'Description', workflow.description
+
+          workflow.sections.each do |section|
+            log.section_heading "Section: #{section.name}"
+            log.kv 'Order', section.order
+            section.steps.each do |step|
+              log.section_heading "Step: #{step.name}"
+              log.kv 'Order', step.order
+              log.kv 'Prompt', step.prompt
+              log.kv 'Input Attributes', step.input_attributes.map { |ia| ia.attribute.name }.join(', ')
+              log.kv 'Output Attributes', step.output_attributes.map { |oa| oa.attribute.name }.join(', ')
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ad/agent_architecture/report/workflow_list_report.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'k_log'
+
+module Ad
+  module AgentArchitecture
+    module Report
+      # Print workflow details
+      class WorkflowListReport
+        include KLog::Logging
+
+        def print
+          # tp query, :workflow_name, :workflow_description, :section_name, :section_description, :section_order, :step_name, :step_order, :step_prompt, :inputs, :outputs
+          tp query, :workflow_name, :section_name, :step_name, :step_prompt, :inputs, :outputs
+        end
+
+        def query
+          Ad::AgentArchitecture::Database::SQLQuery.query(:workflow_details).map do |row|
+            row[:inputs] = JSON.parse(row[:inputs]) if row[:inputs]
+            row[:outputs] = JSON.parse(row[:outputs]) if row[:outputs]
+            row
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ad/agent_architecture/sql/workflow_details.sql

@@ -0,0 +1,35 @@
+SELECT
+  workflows.id AS workflow_id,
+  workflows.name AS workflow_name,
+  workflows.description AS workflow_description,
+  sections.id AS section_id,
+  sections.name AS section_name,
+  sections.description AS section_description,
+  sections."order" AS section_order,
+  steps.id AS step_id,
+  steps.name AS step_name,
+  steps."order" AS step_order,
+  steps.prompt AS step_prompt,
+  json_group_array(
+    json_object(
+      'name', input_attr.name,
+      'type', input_attr.type,
+      'is_array', input_attr.is_array
+    )
+  ) AS inputs,
+  json_group_array(
+    json_object(
+      'name', output_attr.name,
+      'type', output_attr.type,
+      'is_array', output_attr.is_array
+    )
+  ) AS outputs
+FROM workflows
+LEFT JOIN sections ON workflows.id = sections.workflow_id
+LEFT JOIN steps ON sections.id = steps.section_id
+LEFT JOIN input_attributes ON steps.id = input_attributes.step_id
+LEFT JOIN attributes AS input_attr ON input_attributes.attribute_id = input_attr.id
+LEFT JOIN output_attributes ON steps.id = output_attributes.step_id
+LEFT JOIN attributes AS output_attr ON output_attributes.attribute_id = output_attr.id
+GROUP BY workflows.id, sections.id, steps.id
+ORDER BY workflows.name, sections."order", steps."order";

data/lib/ad/agent_architecture/version.rb

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

data/lib/ad/agent_architecture.rb

@@ -2,16 +2,23 @@
 
 require 'sequel'
 require 'sqlite3'
+require 'k_log'
 
 require 'ad/agent_architecture/version'
-require 'ad/agent_architecture/db/create_schema'
+require 'ad/agent_architecture/database/create_schema'
 
 DB = Sequel.sqlite
 
 Ad::AgentArchitecture::Database::CreateSchema.new(DB).execute
 
-require 'ad/agent_architecture/db/models'
+require 'ad/agent_architecture/database/models'
+require 'ad/agent_architecture/database/sql_query'
 require 'ad/agent_architecture/dsl/agent_workflow_dsl'
+require 'ad/agent_architecture/dsl/actions/save_database'
+require 'ad/agent_architecture/dsl/actions/save_json'
+require 'ad/agent_architecture/dsl/actions/save_yaml'
+require 'ad/agent_architecture/report/workflow_detail_report'
+require 'ad/agent_architecture/report/workflow_list_report'
 
 module Ad
   module AgentArchitecture

data/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "ad-agent_architecture",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "ad-agent_architecture",
-      "version": "0.0.7",
+      "version": "0.0.9",
       "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.7",
+  "version": "0.0.9",
   "description": "Architecture/Schema for AI Agents",
   "scripts": {
     "release": "semantic-release"

data/workflow.json

@@ -0,0 +1,99 @@
+{
+  "name": "YouTube Transcript to Medium Article",
+  "sections": [
+    {
+      "name": "Analysis",
+      "order": 1,
+      "steps": [
+        {
+          "name": "Generate Outline",
+          "order": 1,
+          "input_attributes": [
+            "transcript"
+          ],
+          "output_attributes": [
+            "outline"
+          ],
+          "prompt": "Analyze [transcript] and generate a preliminary outline for a blog post."
+        },
+        {
+          "name": "Write First Draft",
+          "order": 2,
+          "input_attributes": [
+            "outline"
+          ],
+          "output_attributes": [
+            "first_draft"
+          ],
+          "prompt": "Write a blog post based on [outline]."
+        },
+        {
+          "name": "Generate Intros",
+          "order": 3,
+          "input_attributes": [
+            "first_draft"
+          ],
+          "output_attributes": [
+            "intro_variations"
+          ],
+          "prompt": "Create 5 introduction variations for [first_draft]."
+        },
+        {
+          "name": "SEO Analysis",
+          "order": 4,
+          "input_attributes": [
+            "first_draft"
+          ],
+          "output_attributes": [
+            "seo_analysis"
+          ],
+          "prompt": "Analyze the blog post for SEO."
+        }
+      ]
+    },
+    {
+      "name": "Editing",
+      "order": 2,
+      "steps": [
+        {
+          "name": "Edit Draft",
+          "order": 1,
+          "input_attributes": [
+            "first_draft"
+          ],
+          "output_attributes": [
+            "first_draft"
+          ],
+          "prompt": "Edit [first_draft] for grammar, style, and clarity."
+        }
+      ]
+    }
+  ],
+  "attributes": {
+    "transcript": {
+      "name": "transcript",
+      "type": "string",
+      "is_array": false
+    },
+    "outline": {
+      "name": "outline",
+      "type": "string",
+      "is_array": false
+    },
+    "first_draft": {
+      "name": "first_draft",
+      "type": "string",
+      "is_array": false
+    },
+    "intro_variations": {
+      "name": "intro_variations",
+      "type": "array",
+      "is_array": false
+    },
+    "seo_analysis": {
+      "name": "seo_analysis",
+      "type": "string",
+      "is_array": false
+    }
+  }
+}

data/workflow.yaml

@@ -0,0 +1,65 @@
+---
+:name: YouTube Transcript to Medium Article
+:sections:
+- :name: Analysis
+  :order: 1
+  :steps:
+  - :name: Generate Outline
+    :order: 1
+    :input_attributes:
+    - :transcript
+    :output_attributes:
+    - :outline
+    :prompt: Analyze [transcript] and generate a preliminary outline for a blog post.
+  - :name: Write First Draft
+    :order: 2
+    :input_attributes:
+    - :outline
+    :output_attributes:
+    - :first_draft
+    :prompt: Write a blog post based on [outline].
+  - :name: Generate Intros
+    :order: 3
+    :input_attributes:
+    - :first_draft
+    :output_attributes:
+    - :intro_variations
+    :prompt: Create 5 introduction variations for [first_draft].
+  - :name: SEO Analysis
+    :order: 4
+    :input_attributes:
+    - :first_draft
+    :output_attributes:
+    - :seo_analysis
+    :prompt: Analyze the blog post for SEO.
+- :name: Editing
+  :order: 2
+  :steps:
+  - :name: Edit Draft
+    :order: 1
+    :input_attributes:
+    - :first_draft
+    :output_attributes:
+    - :first_draft
+    :prompt: Edit [first_draft] for grammar, style, and clarity.
+:attributes:
+  :transcript:
+    :name: :transcript
+    :type: :string
+    :is_array: false
+  :outline:
+    :name: :outline
+    :type: :string
+    :is_array: false
+  :first_draft:
+    :name: :first_draft
+    :type: :string
+    :is_array: false
+  :intro_variations:
+    :name: :intro_variations
+    :type: :array
+    :is_array: false
+  :seo_analysis:
+    :name: :seo_analysis
+    :type: :string
+    :is_array: false

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ad-agent_architecture
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.9
 platform: ruby
 authors:
 - David Cruwys
@@ -80,14 +80,22 @@ files:
 - docs/requirements.md
 - docs/structure-youtube-script.yaml
 - 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/database/create_schema.rb
+- lib/ad/agent_architecture/database/models.rb
+- lib/ad/agent_architecture/database/sql_query.rb
+- lib/ad/agent_architecture/dsl/actions/save_database.rb
+- lib/ad/agent_architecture/dsl/actions/save_json.rb
+- lib/ad/agent_architecture/dsl/actions/save_yaml.rb
 - lib/ad/agent_architecture/dsl/agent_workflow_dsl.rb
+- lib/ad/agent_architecture/report/workflow_detail_report.rb
+- lib/ad/agent_architecture/report/workflow_list_report.rb
+- lib/ad/agent_architecture/sql/workflow_details.sql
 - lib/ad/agent_architecture/version.rb
 - package-lock.json
 - package.json
 - sig/ad/agent_architecture.rbs
+- workflow.json
+- workflow.yaml
 homepage: http://appydave.com/gems/ad-agent_architecture
 licenses:
 - MIT

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

@@ -1,53 +0,0 @@
-# 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