tactus 0.37.0__py3-none-any.whl → 0.39.0__py3-none-any.whl

tactus/stdlib/tac/tactus/corpora/base.tac

@@ -0,0 +1,42 @@
+local function merge_defaults(defaults, config)
+  local merged = {}
+  if defaults then
+    for key, value in pairs(defaults) do
+      merged[key] = value
+    end
+  end
+  if config then
+    for key, value in pairs(config) do
+      merged[key] = value
+    end
+  end
+  return merged
+end
+
+local function normalize_corpus_config(config, defaults)
+  local merged = merge_defaults(defaults, config or {})
+  if merged.root ~= nil and merged.corpus_root == nil then
+    merged.corpus_root = merged.root
+    merged.root = nil
+  end
+  return merged
+end
+
+local function wrap_corpus(defaults)
+  local function constructor(config)
+    return _tactus_internal_corpus(normalize_corpus_config(config, defaults))
+  end
+  local cls = {}
+  function cls:new(config)
+    return constructor(config)
+  end
+  return setmetatable(cls, {
+    __call = function(_, config)
+      return constructor(config)
+    end,
+  })
+end
+
+return {
+  wrap_corpus = wrap_corpus,
+}

tactus/stdlib/tac/tactus/corpora/filesystem.tac

@@ -0,0 +1,5 @@
+local base = require("tactus.corpora.base")
+
+return {
+  Corpus = base.wrap_corpus({}),
+}

tactus/stdlib/tac/tactus/retrievers/base.tac

@@ -0,0 +1,37 @@
+local function merge_defaults(defaults, config)
+  local merged = {}
+  if defaults then
+    for key, value in pairs(defaults) do
+      merged[key] = value
+    end
+  end
+  if config then
+    for key, value in pairs(config) do
+      merged[key] = value
+    end
+  end
+  return merged
+end
+
+local corpora_base = require("tactus.corpora.base")
+
+local function wrap_retriever(defaults)
+  local function constructor(config)
+    local merged = merge_defaults(defaults, config or {})
+    return _tactus_internal_retriever(merged)
+  end
+  local cls = {}
+  function cls:new(config)
+    return constructor(config)
+  end
+  return setmetatable(cls, {
+    __call = function(_, config)
+      return constructor(config)
+    end,
+  })
+end
+
+return {
+  wrap_corpus = corpora_base.wrap_corpus,
+  wrap_retriever = wrap_retriever,
+}

tactus/stdlib/tac/tactus/retrievers/embedding_index_file.tac

@@ -0,0 +1,6 @@
+local base = require("tactus.retrievers.base")
+
+return {
+  Corpus = base.wrap_corpus({}),
+  Retriever = base.wrap_retriever({ retriever_id = "embedding-index-file" }),
+}

tactus/stdlib/tac/tactus/retrievers/embedding_index_inmemory.tac

@@ -0,0 +1,6 @@
+local base = require("tactus.retrievers.base")
+
+return {
+  Corpus = base.wrap_corpus({}),
+  Retriever = base.wrap_retriever({ retriever_id = "embedding-index-inmemory" }),
+}

tactus/stdlib/tac/tactus/retrievers/index.md

@@ -0,0 +1,137 @@
+# Retriever Modules
+
+Tactus exposes Biblicus-backed retrievers as Lua modules so you can select a retriever explicitly at the top of your `.tac` file.
+
+## Embedding index (file-backed)
+
+```lua
+local FilesystemCorpus = require("tactus.corpora.filesystem")
+local vector = require("tactus.retrievers.embedding_index_file")
+
+support_notes = FilesystemCorpus.Corpus {
+  root = "corpora/support-notes",
+  configuration = {
+    pipeline = {
+      extract = {
+        -- extraction steps (optional)
+      }
+    }
+  }
+}
+
+support_search = vector.Retriever {
+  corpus = support_notes,
+  configuration = {
+    pipeline = {
+      index = {
+        embedding_provider = { provider_id = "hash-embedding", dimensions = 64 }
+      },
+      query = {
+        limit = 3,
+        maximum_total_characters = 1200
+      }
+    }
+  }
+}
+```
+
+## Embedding index (in-memory)
+
+```lua
+local FilesystemCorpus = require("tactus.corpora.filesystem")
+local vector = require("tactus.retrievers.embedding_index_inmemory")
+
+notes = FilesystemCorpus.Corpus {
+  root = "corpora/notes",
+  configuration = {
+    pipeline = {
+      extract = {
+        -- extraction steps (optional)
+      }
+    }
+  }
+}
+
+search = vector.Retriever {
+  corpus = notes,
+  configuration = {
+    pipeline = {
+      index = {
+        embedding_provider = { provider_id = "hash-embedding", dimensions = 64 },
+        maximum_cache_total_items = 5000
+      },
+      query = {
+        limit = 2
+      }
+    }
+  }
+}
+```
+
+## SQLite full-text search
+
+```lua
+local FilesystemCorpus = require("tactus.corpora.filesystem")
+local vector = require("tactus.retrievers.sqlite_full_text_search")
+
+notes = FilesystemCorpus.Corpus {
+  root = "corpora/notes",
+  configuration = {
+    pipeline = {
+      extract = {
+        -- extraction steps (optional)
+      }
+    }
+  }
+}
+
+search = vector.Retriever {
+  corpus = notes,
+  configuration = {
+    pipeline = {
+      index = {
+        snippet_characters = 400,
+        chunk_size = 800,
+        chunk_overlap = 200
+      },
+      query = {
+        limit = 2,
+        maximum_total_characters = 1200
+      }
+    }
+  }
+}
+```
+
+## TF vector (term-frequency)
+
+```lua
+local FilesystemCorpus = require("tactus.corpora.filesystem")
+local vector = require("tactus.retrievers.tf_vector")
+
+notes = FilesystemCorpus.Corpus {
+  root = "corpora/notes",
+  configuration = {
+    pipeline = {
+      extract = {
+        -- extraction steps (optional)
+      }
+    }
+  }
+}
+
+search = vector.Retriever {
+  corpus = notes,
+  configuration = {
+    pipeline = {
+      index = {
+        -- optional index settings
+      },
+      query = {
+        limit = 2,
+        maximum_total_characters = 1200
+      }
+    }
+  }
+}
+```

tactus/stdlib/tac/tactus/retrievers/init.tac

@@ -0,0 +1,11 @@
+local embedding_index_file = require("tactus.retrievers.embedding_index_file")
+local embedding_index_inmemory = require("tactus.retrievers.embedding_index_inmemory")
+local sqlite_full_text_search = require("tactus.retrievers.sqlite_full_text_search")
+local tf_vector = require("tactus.retrievers.tf_vector")
+
+return {
+  EmbeddingIndexFile = embedding_index_file,
+  EmbeddingIndexInMemory = embedding_index_inmemory,
+  SqliteFullTextSearch = sqlite_full_text_search,
+  TfVector = tf_vector,
+}

tactus/stdlib/tac/tactus/retrievers/sqlite_full_text_search.tac

@@ -0,0 +1,6 @@
+local base = require("tactus.retrievers.base")
+
+return {
+  Corpus = base.wrap_corpus({}),
+  Retriever = base.wrap_retriever({ retriever_id = "sqlite-full-text-search" }),
+}

tactus/stdlib/tac/tactus/retrievers/tf_vector.tac

@@ -0,0 +1,6 @@
+local base = require("tactus.retrievers.base")
+
+return {
+  Corpus = base.wrap_corpus({}),
+  Retriever = base.wrap_retriever({ retriever_id = "tf-vector" }),
+}

tactus/testing/behave_integration.py

@@ -413,6 +413,7 @@ class BehaveEnvironmentGenerator:
             f.write('"""\n\n')
 
             f.write("import sys\n")
+            f.write("import os\n")
             f.write("import json\n")
             f.write("from pathlib import Path\n\n")
 
@@ -440,6 +441,7 @@ class BehaveEnvironmentGenerator:
             f.write(f"    context.mcp_servers = json.loads('{mcp_servers_json}')\n")
             f.write(f"    context.tool_paths = json.loads('{tool_paths_json}')\n")
             f.write(f"    context.mocked = {mocked}\n\n")
+            f.write("    os.environ['TACTUS_MOCK_MODE'] = '1' if context.mocked else '0'\n\n")
 
             f.write("def before_scenario(context, scenario):\n")
             f.write('    """Setup before each scenario."""\n')

tactus/testing/context.py

@@ -171,6 +171,7 @@ class TactusTestContext:
         from tactus.testing.mock_registry import UnifiedMockRegistry
         from tactus.adapters.cli_log import CLILogHandler
 
+        os.environ["TACTUS_MOCK_MODE"] = "1" if self.mocked else "0"
         storage = MemoryStorage()
 
         # Setup mock registry if in mocked mode
@@ -209,6 +210,9 @@ class TactusTestContext:
             from tactus.core.mocking import MockManager
 
             self.runtime.mock_manager = MockManager()
+            from tactus.core.mocking import set_current_mock_manager
+
+            set_current_mock_manager(self.runtime.mock_manager)
             logger.info("Created MockManager for Mocks {} block support")
             # Mocked-mode tests should never call real LLMs by default.
             self.runtime.mock_all_agents = True