Describe your AI agent pipeline and The Architect will design it for you
Or start from a template
create_genai_app · SSE streaming · WebSocket
health · auth middleware · router · conversations
RateLimiter"] + REST["REST API
create_agentic_app · SSE streaming · WebSocket
health · auth middleware · router · conversations
RateLimiter"] QUEUES["Message Queues
Kafka · RabbitMQ · Redis
consumers · producers · QueueRouter"] end @@ -66,9 +66,9 @@ graph TD end subgraph Core Layer - CFG["Config
FireflyGenAIConfig
get_config · reset_config"] + CFG["Config
FireflyAgenticConfig
get_config · reset_config"] TYPES["Types & Protocols
AgentLike · 10 protocols
TypeVars · type aliases"] - EXC["Exceptions
FireflyGenAIError hierarchy
18 exception classes"] + EXC["Exceptions
FireflyAgenticError hierarchy
18 exception classes"] PLUG["Plugin System
PluginDiscovery
3 entry-point groups"] end @@ -207,9 +207,9 @@ The Core layer provides foundational types, configuration, exceptions, and the p system. Every other module depends on at least one Core component. - **types.py** -- Enumerations for model providers, agent states, and log levels. -- **config.py** -- `FireflyGenAIConfig`, a Pydantic Settings singleton that reads +- **config.py** -- `FireflyAgenticConfig`, a Pydantic Settings singleton that reads from environment variables and `.env` files. -- **exceptions.py** -- A structured exception hierarchy rooted at `FireflyGenAIError`. +- **exceptions.py** -- A structured exception hierarchy rooted at `FireflyAgenticError`. - **plugin.py** -- `PluginDiscovery` discovers and loads entry-point plugins at startup. ### Security Layer @@ -343,7 +343,7 @@ observability and explainability artefacts. ```mermaid sequenceDiagram participant Client - participant REST as REST API
(create_genai_app) + participant REST as REST API
(create_agentic_app) participant MW as Middleware
(CORS · RequestID) participant Reg as AgentRegistry participant Agent as FireflyAgent @@ -512,17 +512,17 @@ graph TD ## Plugin System Plugins are discovered via Python entry points under three well-known groups: -`fireflyframework_genai.agents`, `fireflyframework_genai.tools`, and -`fireflyframework_genai.reasoning_patterns`. The `PluginDiscovery` class scans +`fireflyframework_agentic.agents`, `fireflyframework_agentic.tools`, and +`fireflyframework_agentic.reasoning_patterns`. The `PluginDiscovery` class scans these groups and loads the referenced objects so they can self-register with their respective registries. ```mermaid flowchart LR subgraph Package pyproject.toml - EP1["fireflyframework_genai.agents
my_agent = my_pkg:MyAgent"] - EP2["fireflyframework_genai.tools
my_tool = my_pkg:MyTool"] - EP3["fireflyframework_genai.reasoning_patterns
my_pattern = my_pkg:MyPattern"] + EP1["fireflyframework_agentic.agents
my_agent = my_pkg:MyAgent"] + EP2["fireflyframework_agentic.tools
my_tool = my_pkg:MyTool"] + EP3["fireflyframework_agentic.reasoning_patterns
my_pattern = my_pkg:MyPattern"] end PD["PluginDiscovery
discover_all() · discover_group()"] @@ -544,17 +544,17 @@ flowchart LR To create a plugin, add entry points in your package's `pyproject.toml`: ```toml -[project.entry-points."fireflyframework_genai.agents"] +[project.entry-points."fireflyframework_agentic.agents"] my_agent = "my_package.agents:MyAgent" -[project.entry-points."fireflyframework_genai.tools"] +[project.entry-points."fireflyframework_agentic.tools"] my_tool = "my_package.tools:MyTool" ``` Then call discovery at startup: ```python -from fireflyframework_genai.plugin import PluginDiscovery +from fireflyframework_agentic.plugin import PluginDiscovery result = PluginDiscovery.discover_all() print(f"Loaded {len(result.successful)} plugins, {len(result.failed)} failed") @@ -564,20 +564,20 @@ print(f"Loaded {len(result.successful)} plugins, {len(result.failed)} failed") ## Configuration -All configuration is managed through `FireflyGenAIConfig`, which reads values from -environment variables prefixed with `FIREFLY_GENAI_`. For example: +All configuration is managed through `FireflyAgenticConfig`, which reads values from +environment variables prefixed with `FIREFLY_AGENTIC_`. For example: ```bash -export FIREFLY_GENAI_DEFAULT_MODEL=openai:gpt-4o -export FIREFLY_GENAI_LOG_LEVEL=DEBUG -export FIREFLY_GENAI_OTEL_ENDPOINT=http://localhost:4317 +export FIREFLY_AGENTIC_DEFAULT_MODEL=openai:gpt-4o +export FIREFLY_AGENTIC_LOG_LEVEL=DEBUG +export FIREFLY_AGENTIC_OTEL_ENDPOINT=http://localhost:4317 ``` The configuration singleton is available via: ```python -from fireflyframework_genai.core import FireflyGenAIConfig +from fireflyframework_agentic.core import FireflyAgenticConfig -config = FireflyGenAIConfig() +config = FireflyAgenticConfig() print(config.default_model) ``` diff --git a/docs/content.md b/docs/content.md index 98e73821..b46cb0d2 100644 --- a/docs/content.md +++ b/docs/content.md @@ -19,7 +19,7 @@ images, and other artefacts that exceed a model's context window. - **paragraph** -- Splits at paragraph boundaries (double newlines). ```python -from fireflyframework_genai.content.chunking import TextChunker +from fireflyframework_agentic.content.chunking import TextChunker chunker = TextChunker(chunk_size=4000, chunk_overlap=200, strategy="token") chunks = chunker.chunk(long_text) @@ -36,7 +36,7 @@ and an open `metadata` dictionary. rules (`---`). Segments shorter than `min_length` are discarded. ```python -from fireflyframework_genai.content.chunking import DocumentSplitter +from fireflyframework_agentic.content.chunking import DocumentSplitter splitter = DocumentSplitter(min_length=50) segments = splitter.split(raw_text) @@ -48,7 +48,7 @@ segments = splitter.split(raw_text) of high-resolution images that exceed the model's pixel budget. ```python -from fireflyframework_genai.content.chunking import ImageTiler +from fireflyframework_agentic.content.chunking import ImageTiler tiler = ImageTiler(tile_width=1024, tile_height=1024, overlap=128) tiles = tiler.compute_tiles(image_width=4096, image_height=3072) @@ -63,7 +63,7 @@ and `col` fields. parallelism and an optional result aggregator. ```python -from fireflyframework_genai.content.chunking import BatchProcessor +from fireflyframework_agentic.content.chunking import BatchProcessor processor = BatchProcessor(concurrency=4) results = await processor.process(agent, chunks) @@ -79,7 +79,7 @@ results = await processor.process(agent, chunks) words-to-tokens ratio (default: `1.33`). ```python -from fireflyframework_genai.content.compression import TokenEstimator +from fireflyframework_agentic.content.compression import TokenEstimator estimator = TokenEstimator() tokens = estimator.estimate("Hello world, this is a test.") @@ -95,7 +95,7 @@ pluggable strategies: - **MapReduceStrategy** -- Chunks the text, summarises each chunk, then merges. ```python -from fireflyframework_genai.content.compression import ( +from fireflyframework_agentic.content.compression import ( ContextCompressor, TruncationStrategy, ) @@ -110,7 +110,7 @@ compressed = await compressor.compress(long_text, max_tokens=2000) keeping total token usage within a budget by evicting the oldest items. ```python -from fireflyframework_genai.content.compression import SlidingWindowManager +from fireflyframework_agentic.content.compression import SlidingWindowManager window = SlidingWindowManager(max_tokens=8000) window.add("First message") diff --git a/docs/embeddings.md b/docs/embeddings.md index 1c08c925..e1b0e531 100644 --- a/docs/embeddings.md +++ b/docs/embeddings.md @@ -37,7 +37,7 @@ graph TD ## Quick Start ```python -from fireflyframework_genai.embeddings.providers import OpenAIEmbedder +from fireflyframework_agentic.embeddings.providers import OpenAIEmbedder # Create an embedder embedder = OpenAIEmbedder(model="text-embedding-3-small") @@ -60,7 +60,7 @@ print(len(vector)) # 1536 ### OpenAI ```python -from fireflyframework_genai.embeddings.providers import OpenAIEmbedder +from fireflyframework_agentic.embeddings.providers import OpenAIEmbedder embedder = OpenAIEmbedder( model="text-embedding-3-small", # or "text-embedding-3-large" @@ -69,12 +69,12 @@ embedder = OpenAIEmbedder( ) ``` -Install: `pip install fireflyframework-genai[openai-embeddings]` +Install: `pip install fireflyframework-agentic[openai-embeddings]` ### Azure OpenAI ```python -from fireflyframework_genai.embeddings.providers import AzureEmbedder +from fireflyframework_agentic.embeddings.providers import AzureEmbedder embedder = AzureEmbedder( model="my-embedding-deployment", @@ -85,12 +85,12 @@ embedder = AzureEmbedder( ) ``` -Install: `pip install fireflyframework-genai[azure-embeddings]` +Install: `pip install fireflyframework-agentic[azure-embeddings]` ### Cohere ```python -from fireflyframework_genai.embeddings.providers import CohereEmbedder +from fireflyframework_agentic.embeddings.providers import CohereEmbedder embedder = CohereEmbedder( model="embed-english-v3.0", @@ -99,12 +99,12 @@ embedder = CohereEmbedder( ) ``` -Install: `pip install fireflyframework-genai[cohere-embeddings]` +Install: `pip install fireflyframework-agentic[cohere-embeddings]` ### Google Generative AI ```python -from fireflyframework_genai.embeddings.providers import GoogleEmbedder +from fireflyframework_agentic.embeddings.providers import GoogleEmbedder embedder = GoogleEmbedder( model="models/text-embedding-004", @@ -112,12 +112,12 @@ embedder = GoogleEmbedder( ) ``` -Install: `pip install fireflyframework-genai[google-embeddings]` +Install: `pip install fireflyframework-agentic[google-embeddings]` ### Mistral ```python -from fireflyframework_genai.embeddings.providers import MistralEmbedder +from fireflyframework_agentic.embeddings.providers import MistralEmbedder embedder = MistralEmbedder( model="mistral-embed", @@ -125,12 +125,12 @@ embedder = MistralEmbedder( ) ``` -Install: `pip install fireflyframework-genai[mistral-embeddings]` +Install: `pip install fireflyframework-agentic[mistral-embeddings]` ### Voyage AI ```python -from fireflyframework_genai.embeddings.providers import VoyageEmbedder +from fireflyframework_agentic.embeddings.providers import VoyageEmbedder embedder = VoyageEmbedder( model="voyage-3", @@ -138,12 +138,12 @@ embedder = VoyageEmbedder( ) ``` -Install: `pip install fireflyframework-genai[voyage-embeddings]` +Install: `pip install fireflyframework-agentic[voyage-embeddings]` ### AWS Bedrock ```python -from fireflyframework_genai.embeddings.providers import BedrockEmbedder +from fireflyframework_agentic.embeddings.providers import BedrockEmbedder embedder = BedrockEmbedder( model="amazon.titan-embed-text-v2:0", @@ -151,12 +151,12 @@ embedder = BedrockEmbedder( ) ``` -Install: `pip install fireflyframework-genai[bedrock-embeddings]` +Install: `pip install fireflyframework-agentic[bedrock-embeddings]` ### Ollama (Local) ```python -from fireflyframework_genai.embeddings.providers import OllamaEmbedder +from fireflyframework_agentic.embeddings.providers import OllamaEmbedder embedder = OllamaEmbedder( model="nomic-embed-text", @@ -164,7 +164,7 @@ embedder = OllamaEmbedder( ) ``` -Install: `pip install fireflyframework-genai[ollama-embeddings]` +Install: `pip install fireflyframework-agentic[ollama-embeddings]` --- @@ -173,7 +173,7 @@ Install: `pip install fireflyframework-genai[ollama-embeddings]` Built-in functions for comparing embedding vectors: ```python -from fireflyframework_genai.embeddings import cosine_similarity, euclidean_distance, dot_product +from fireflyframework_agentic.embeddings import cosine_similarity, euclidean_distance, dot_product a = [0.1, 0.2, 0.3] b = [0.4, 0.5, 0.6] @@ -190,8 +190,8 @@ dot_product(a, b) # raw dot product Manage multiple named embedder instances: ```python -from fireflyframework_genai.embeddings import EmbedderRegistry -from fireflyframework_genai.embeddings.providers import OpenAIEmbedder, CohereEmbedder +from fireflyframework_agentic.embeddings import EmbedderRegistry +from fireflyframework_agentic.embeddings.providers import OpenAIEmbedder, CohereEmbedder registry = EmbedderRegistry() registry.register("openai", OpenAIEmbedder()) @@ -209,7 +209,7 @@ registry.unregister("cohere") ## Auto-Batching `BaseEmbedder` automatically splits large text lists into provider-sized batches -(default: 100, configurable via `FireflyGenAIConfig.embedding_batch_size`). +(default: 100, configurable via `FireflyAgenticConfig.embedding_batch_size`). Subclasses only need to implement `_embed_batch()` for a single batch. ```python @@ -223,13 +223,13 @@ assert len(result.embeddings) == 500 ## Configuration -Global defaults via environment variables (prefix `FIREFLY_GENAI_`): +Global defaults via environment variables (prefix `FIREFLY_AGENTIC_`): | Setting | Env Variable | Default | |---------|-------------|---------| -| `default_embedding_model` | `FIREFLY_GENAI_DEFAULT_EMBEDDING_MODEL` | `openai:text-embedding-3-small` | -| `embedding_batch_size` | `FIREFLY_GENAI_EMBEDDING_BATCH_SIZE` | `100` | -| `embedding_max_retries` | `FIREFLY_GENAI_EMBEDDING_MAX_RETRIES` | `3` | +| `default_embedding_model` | `FIREFLY_AGENTIC_DEFAULT_EMBEDDING_MODEL` | `openai:text-embedding-3-small` | +| `embedding_batch_size` | `FIREFLY_AGENTIC_EMBEDDING_BATCH_SIZE` | `100` | +| `embedding_max_retries` | `FIREFLY_AGENTIC_EMBEDDING_MAX_RETRIES` | `3` | --- @@ -238,7 +238,7 @@ Global defaults via environment variables (prefix `FIREFLY_GENAI_`): To create a custom embedding provider, subclass `BaseEmbedder` and implement `_embed_batch()`: ```python -from fireflyframework_genai.embeddings.base import BaseEmbedder +from fireflyframework_agentic.embeddings.base import BaseEmbedder class MyEmbedder(BaseEmbedder): def __init__(self, model: str = "my-model", **kwargs): @@ -256,7 +256,7 @@ class MyEmbedder(BaseEmbedder): Use embeddings in DAG pipelines: ```python -from fireflyframework_genai.pipeline import Pipeline, PipelineStep, EmbeddingStep +from fireflyframework_agentic.pipeline import Pipeline, PipelineStep, EmbeddingStep pipeline = Pipeline( steps=[ diff --git a/docs/experiments.md b/docs/experiments.md index 70036ce3..63abc936 100644 --- a/docs/experiments.md +++ b/docs/experiments.md @@ -30,7 +30,7 @@ flowchart TD ## Defining an Experiment ```python -from fireflyframework_genai.experiments import Experiment, Variant +from fireflyframework_agentic.experiments import Experiment, Variant experiment = Experiment( name="model_comparison", @@ -50,7 +50,7 @@ The `ExperimentRunner` executes each variant against a list of test inputs and collects metrics (latency, token usage, quality scores). ```python -from fireflyframework_genai.experiments import ExperimentRunner +from fireflyframework_agentic.experiments import ExperimentRunner runner = ExperimentRunner() results = await runner.run( @@ -67,7 +67,7 @@ The `ExperimentTracker` persists experiment results to disk (JSON) for later ana and reproducibility. ```python -from fireflyframework_genai.experiments import ExperimentTracker +from fireflyframework_agentic.experiments import ExperimentTracker tracker = ExperimentTracker(storage_dir="./experiment_results") tracker.save(results) @@ -82,7 +82,7 @@ The `VariantComparator` computes comparison metrics across experiment variants t determine which variant performs better. ```python -from fireflyframework_genai.experiments import VariantComparator +from fireflyframework_agentic.experiments import VariantComparator comparator = VariantComparator() metrics = comparator.compare(results) diff --git a/docs/explainability.md b/docs/explainability.md index 0cd42609..3fb8eed8 100644 --- a/docs/explainability.md +++ b/docs/explainability.md @@ -28,7 +28,7 @@ The `TraceRecorder` captures every decision an agent makes during execution: whi tool it chose, what reasoning path it followed, what alternatives it considered. ```python -from fireflyframework_genai.explainability import TraceRecorder +from fireflyframework_agentic.explainability import TraceRecorder recorder = TraceRecorder() recorder.record_decision( @@ -51,7 +51,7 @@ The `ExplanationGenerator` transforms raw decision records into natural-language explanations suitable for end users or auditors. ```python -from fireflyframework_genai.explainability import ExplanationGenerator +from fireflyframework_agentic.explainability import ExplanationGenerator generator = ExplanationGenerator() explanation = generator.generate(recorder.decisions) @@ -73,7 +73,7 @@ flowchart LR ``` ```python -from fireflyframework_genai.explainability import AuditTrail +from fireflyframework_agentic.explainability import AuditTrail trail = AuditTrail() trail.append(decision_record) @@ -88,7 +88,7 @@ The `ReportBuilder` compiles decisions, explanations, and audit entries into a structured report in Markdown or JSON format. ```python -from fireflyframework_genai.explainability import ReportBuilder +from fireflyframework_agentic.explainability import ReportBuilder builder = ReportBuilder() builder.add_decisions(recorder.decisions) diff --git a/docs/exposure-queues.md b/docs/exposure-queues.md index 4db1aa55..0dbe86a9 100644 --- a/docs/exposure-queues.md +++ b/docs/exposure-queues.md @@ -42,16 +42,16 @@ flowchart TD Install the queue extra for your broker: ```bash -uv add "fireflyframework-genai[kafka]" # Kafka -uv add "fireflyframework-genai[rabbitmq]" # RabbitMQ -uv add "fireflyframework-genai[redis]" # Redis -uv add "fireflyframework-genai[queues]" # All brokers +uv add "fireflyframework-agentic[kafka]" # Kafka +uv add "fireflyframework-agentic[rabbitmq]" # RabbitMQ +uv add "fireflyframework-agentic[redis]" # Redis +uv add "fireflyframework-agentic[queues]" # All brokers ``` ### Kafka ```python -from fireflyframework_genai.exposure.queues.kafka import KafkaAgentConsumer +from fireflyframework_agentic.exposure.queues.kafka import KafkaAgentConsumer consumer = KafkaAgentConsumer( agent_name="assistant", @@ -65,7 +65,7 @@ await consumer.start() ### RabbitMQ ```python -from fireflyframework_genai.exposure.queues.rabbitmq import RabbitMQAgentConsumer +from fireflyframework_agentic.exposure.queues.rabbitmq import RabbitMQAgentConsumer consumer = RabbitMQAgentConsumer( agent_name="assistant", @@ -78,7 +78,7 @@ await consumer.start() ### Redis ```python -from fireflyframework_genai.exposure.queues.redis import RedisAgentConsumer +from fireflyframework_agentic.exposure.queues.redis import RedisAgentConsumer consumer = RedisAgentConsumer( agent_name="assistant", @@ -95,7 +95,7 @@ await consumer.start() All consumers and producers operate on `QueueMessage` objects: ```python -from fireflyframework_genai.exposure.queues import QueueMessage +from fireflyframework_agentic.exposure.queues import QueueMessage message = QueueMessage( body="Summarise this document.", @@ -121,7 +121,7 @@ flowchart TD ``` ```python -from fireflyframework_genai.exposure.queues import QueueRouter, QueueMessage +from fireflyframework_agentic.exposure.queues import QueueRouter, QueueMessage router = QueueRouter(default_agent="fallback") router.add_route(r"summary\..*", "summariser") @@ -139,7 +139,7 @@ To integrate with a message broker not supported out of the box, extend `BaseQueueConsumer` and implement the `start` and `stop` methods: ```python -from fireflyframework_genai.exposure.queues.base import BaseQueueConsumer +from fireflyframework_agentic.exposure.queues.base import BaseQueueConsumer class MyBrokerConsumer(BaseQueueConsumer): async def start(self) -> None: diff --git a/docs/exposure-rest.md b/docs/exposure-rest.md index 3ddb598e..660a35f7 100644 --- a/docs/exposure-rest.md +++ b/docs/exposure-rest.md @@ -28,15 +28,15 @@ flowchart TD Install the REST extra: ```bash -uv add "fireflyframework-genai[rest]" +uv add "fireflyframework-agentic[rest]" ``` Create a FastAPI application: ```python -from fireflyframework_genai.exposure.rest import create_genai_app +from fireflyframework_agentic.exposure.rest import create_agentic_app -app = create_genai_app(title="My GenAI Service", version="1.0.0") +app = create_agentic_app(title="My GenAI Service", version="1.0.0") ``` Run with Uvicorn: @@ -49,7 +49,7 @@ uvicorn myapp:app --reload ## Application Factory -The `create_genai_app` function creates a configured FastAPI application with: +The `create_agentic_app` function creates a configured FastAPI application with: - Agent routes auto-generated from the `AgentRegistry`. - Health-check endpoints at `/health` and `/health/ready`. @@ -57,7 +57,7 @@ The `create_genai_app` function creates a configured FastAPI application with: - CORS middleware with configurable origins. ```python -app = create_genai_app( +app = create_agentic_app( title="Production GenAI API", version="2.0.0", enable_cors=True, @@ -140,7 +140,7 @@ The REST layer includes a sliding-window rate limiter that can be applied as middleware to protect agents from excessive traffic. ```python -from fireflyframework_genai.exposure.rest.middleware import add_rate_limit_middleware +from fireflyframework_agentic.exposure.rest.middleware import add_rate_limit_middleware add_rate_limit_middleware( app, @@ -167,7 +167,7 @@ add_rate_limit_middleware( The `RateLimiter` class can also be used standalone outside of middleware: ```python -from fireflyframework_genai.exposure.rest.middleware import RateLimiter +from fireflyframework_agentic.exposure.rest.middleware import RateLimiter limiter = RateLimiter(max_requests=10, window_seconds=30.0) if not limiter.is_allowed("client-123"): @@ -188,7 +188,7 @@ When both are configured, a request is accepted if **either** method succeeds. Unauthenticated requests receive a `401 Unauthorized` response. ```python -from fireflyframework_genai.exposure.rest.middleware import add_auth_middleware +from fireflyframework_agentic.exposure.rest.middleware import add_auth_middleware add_auth_middleware( app, @@ -202,8 +202,8 @@ The authentication middleware is **auto-wired** when the config fields `auth_api_keys` or `auth_bearer_tokens` are set: ```bash -export FIREFLY_GENAI_AUTH_API_KEYS='["key-abc-123"]' -export FIREFLY_GENAI_AUTH_BEARER_TOKENS='["token-xyz"]' +export FIREFLY_AGENTIC_AUTH_API_KEYS='["key-abc-123"]' +export FIREFLY_AGENTIC_AUTH_BEARER_TOKENS='["token-xyz"]' ``` --- diff --git a/docs/input-output-nodes.md b/docs/input-output-nodes.md deleted file mode 100644 index 7e32ffb4..00000000 --- a/docs/input-output-nodes.md +++ /dev/null @@ -1,320 +0,0 @@ -# Input/Output Boundary Nodes - -Copyright 2026 Firefly Software Solutions Inc. Licensed under the Apache License 2.0. - -Input and Output nodes define pipeline entry and exit points, inspired by -BPM (Business Process Management) start/end events. They enable a pipeline -to declare *how* it receives data and *where* results go, which unlocks -auto-generated APIs, queue consumers, scheduled triggers, and runtime -management. - ---- - -## Why Boundary Nodes Matter - -Without boundary nodes a pipeline is a passive graph of processing steps -- -you must write glue code to feed it data and route results. With boundary -nodes, the Studio runtime can: - -1. Auto-generate REST endpoints from the pipeline schema. -2. Spin up queue consumers (Kafka, RabbitMQ, Redis) automatically. -3. Run pipelines on a cron schedule via APScheduler. -4. Validate inputs and outputs at the API boundary. -5. Route results to webhooks, stores, or multiple destinations. - -A pipeline must have **exactly one Input node** and **at least one Output -node** when boundary nodes are used. The compiler enforces this constraint. - ---- - -## Input Node - -The Input node defines how data enters the pipeline. - -### Trigger Types - -| Trigger | Description | Config Object | -|---|---|---| -| `manual` | Triggered by the user or REST API call | None required | -| `http` | Triggered by an HTTP request to the auto-generated endpoint | `HttpConfig` | -| `queue` | Triggered by messages from a message broker | `QueueConfig` | -| `schedule` | Triggered on a cron schedule | `ScheduleConfig` | -| `file_upload` | Triggered by a file upload to `/upload` | `FileConfig` | - -### Configuration Examples - -**Manual trigger** (simplest -- no extra config needed): - -```json -{ - "type": "input", - "data": { - "trigger_type": "manual", - "schema": { - "type": "object", - "properties": { - "query": {"type": "string"} - }, - "required": ["query"] - } - } -} -``` - -**HTTP trigger** with custom settings: - -```json -{ - "type": "input", - "data": { - "trigger_type": "http", - "http_config": { - "method": "POST", - "path_suffix": "", - "auth_required": false - }, - "schema": { - "type": "object", - "properties": { - "document": {"type": "string"}, - "language": {"type": "string"} - } - } - } -} -``` - -**Queue trigger** (Kafka): - -```json -{ - "type": "input", - "data": { - "trigger_type": "queue", - "queue_config": { - "broker": "kafka", - "topic_or_queue": "incoming-documents", - "group_id": "studio-doc-processor", - "connection_url": "localhost:9092" - } - } -} -``` - -**Scheduled trigger** (cron): - -```json -{ - "type": "input", - "data": { - "trigger_type": "schedule", - "schedule_config": { - "cron_expression": "0 */6 * * *", - "timezone": "America/New_York", - "payload": {"source": "scheduled_run"} - } - } -} -``` - -**File upload trigger**: - -```json -{ - "type": "input", - "data": { - "trigger_type": "file_upload", - "file_config": { - "accepted_types": ["application/pdf", "text/plain"], - "max_size_mb": 25 - } - } -} -``` - ---- - -## Output Node - -The Output node defines where pipeline results are delivered. - -### Destination Types - -| Destination | Description | Config Object | -|---|---|---| -| `response` | Return result in the HTTP response (default) | None required | -| `queue` | Publish result to a message broker | `QueueConfig` | -| `webhook` | POST result to an external URL | `WebhookConfig` | -| `store` | Write result to a file or database | `StoreConfig` | -| `multi` | Fan out to multiple destinations | `destinations` list | - -### Configuration Examples - -**Response destination** (return to caller): - -```json -{ - "type": "output", - "data": { - "destination_type": "response", - "response_schema": { - "type": "object", - "properties": { - "classification": {"type": "string"}, - "confidence": {"type": "number"} - } - } - } -} -``` - -**Webhook destination**: - -```json -{ - "type": "output", - "data": { - "destination_type": "webhook", - "webhook_config": { - "url": "https://api.example.com/results", - "method": "POST", - "headers": {"Authorization": "Bearer sk-..."} - } - } -} -``` - -**Queue destination** (RabbitMQ): - -```json -{ - "type": "output", - "data": { - "destination_type": "queue", - "queue_config": { - "broker": "rabbitmq", - "topic_or_queue": "processed-results", - "connection_url": "amqp://localhost" - } - } -} -``` - -**Store destination** (file): - -```json -{ - "type": "output", - "data": { - "destination_type": "store", - "store_config": { - "storage_type": "file", - "path_or_table": "/data/results/" - } - } -} -``` - -**Multi destination** (fan out to several targets): - -```json -{ - "type": "output", - "data": { - "destination_type": "multi", - "destinations": [ - {"type": "response"}, - {"type": "webhook", "url": "https://hooks.example.com/notify"} - ] - } -} -``` - ---- - -## Schema Definition - -Both Input and Output nodes support JSON Schema-style `schema` / -`response_schema` fields. These serve two purposes: - -1. **Validation** -- The API layer can validate incoming payloads against - the input schema before pipeline execution begins. -2. **Documentation** -- The `/api/projects/{name}/schema` endpoint exposes - the schema so API consumers know what to send and expect. - -```python -# Retrieve a project's schema programmatically -import httpx - -resp = httpx.get("http://localhost:8470/api/projects/my-project/schema") -schema = resp.json() -# { -# "input_schema": {"type": "object", "properties": {...}}, -# "output_schema": {"type": "object", "properties": {...}}, -# "trigger_type": "http" -# } -``` - ---- - -## Compiler Interaction - -When the pipeline compiler encounters Input/Output nodes it enforces -structural constraints and compiles them into pass-through steps: - -- **Input node**: Validates the `InputNodeConfig` at compile time, then - becomes a `CallableStep` that forwards `context.inputs` downstream. - Schema validation happens at the API boundary, not inside the step. -- **Output node**: Validates the `OutputNodeConfig` and becomes a - `CallableStep` that stores the output config in `context.metadata` and - passes the result through. Destination routing (queue publish, webhook - POST, etc.) is handled by `ProjectRuntime` after execution completes. - -Compiler constraints: - -| Rule | Error | -|---|---| -| More than one Input node | `CompilationError`: must have exactly one | -| Input node without any Output node | `CompilationError`: at least one Output required | -| Invalid trigger/destination type | `ValidationError` from Pydantic | - ---- - -## Python Data Models - -The configuration models live in -`fireflyframework_genai.studio.execution.io_nodes`: - -```python -from fireflyframework_genai.studio.execution.io_nodes import ( - InputNodeConfig, - OutputNodeConfig, - QueueConfig, - ScheduleConfig, - HttpConfig, - FileConfig, - WebhookConfig, - StoreConfig, -) - -# Create an input config -input_cfg = InputNodeConfig( - trigger_type="queue", - queue_config=QueueConfig( - broker="kafka", - topic_or_queue="events", - ), -) - -# Create an output config -output_cfg = OutputNodeConfig( - destination_type="webhook", - webhook_config=WebhookConfig(url="https://hooks.example.com"), -) -``` - ---- - -*See also: [Project API](project-api.md) for auto-generated REST endpoints, -[Scheduling](scheduling.md) for cron configuration, -[Pipeline Guide](pipeline.md) for the broader pipeline system.* diff --git a/docs/lab.md b/docs/lab.md index 1279e020..40039383 100644 --- a/docs/lab.md +++ b/docs/lab.md @@ -40,7 +40,7 @@ A `LabSession` provides a conversational interface for testing an agent interact Each exchange is recorded with timestamps and metadata. ```python -from fireflyframework_genai.lab import LabSession +from fireflyframework_agentic.lab import LabSession session = LabSession(name="writing-test", agent=writer_agent) response = await session.interact("Write a haiku about testing.") @@ -59,7 +59,7 @@ The `Benchmark` runs an agent against a list of prompts and measures latency met (average, min, max, p95). ```python -from fireflyframework_genai.lab import Benchmark +from fireflyframework_agentic.lab import Benchmark bench = Benchmark(inputs=[ "Translate 'hello' to French.", @@ -94,7 +94,7 @@ The `ModelComparison` class runs the same prompts through multiple agents and co their outputs side by side. ```python -from fireflyframework_genai.lab import ModelComparison +from fireflyframework_agentic.lab import ModelComparison comparison = ModelComparison(prompts=[ "Write a haiku about Python.", @@ -115,7 +115,7 @@ The `EvalDataset` class manages collections of `EvalCase` test inputs and option expected outputs. Datasets can be loaded from JSON files or built programmatically. ```python -from fireflyframework_genai.lab import EvalDataset, EvalCase +from fireflyframework_agentic.lab import EvalDataset, EvalCase # Programmatically dataset = EvalDataset(cases=[ @@ -136,7 +136,7 @@ function. A `Scorer` is any callable `(expected: str, actual: str) -> float`. Th framework ships with `exact_match_scorer` as a default. ```python -from fireflyframework_genai.lab import EvalOrchestrator, EvalDataset, EvalCase +from fireflyframework_agentic.lab import EvalOrchestrator, EvalDataset, EvalCase # Custom scorer def fuzzy_scorer(expected: str, actual: str) -> float: diff --git a/docs/memory.md b/docs/memory.md index 2fc0eedb..dfd5d29c 100644 --- a/docs/memory.md +++ b/docs/memory.md @@ -37,8 +37,8 @@ graph TD ## Quick Start ```python -from fireflyframework_genai.agents import FireflyAgent -from fireflyframework_genai.memory import MemoryManager +from fireflyframework_agentic.agents import FireflyAgent +from fireflyframework_agentic.memory import MemoryManager # Create a memory manager memory = MemoryManager(max_conversation_tokens=32_000) @@ -67,7 +67,7 @@ result2 = await agent.run("What about its type system?", conversation_id=conv_id automatically enforces a token budget by dropping oldest turns (FIFO). ```python -from fireflyframework_genai.memory import ConversationMemory +from fireflyframework_agentic.memory import ConversationMemory conv_mem = ConversationMemory(max_tokens=16_000) cid = conv_mem.new_conversation() @@ -108,7 +108,7 @@ Pass a `summarizer` callable that takes a list of `ConversationTurn` objects and returns a summary string: ```python -from fireflyframework_genai.memory import ConversationMemory +from fireflyframework_agentic.memory import ConversationMemory def my_summarizer(turns): texts = [f"{t.user_prompt} -> {t.assistant_response}" for t in turns] @@ -135,7 +135,7 @@ into a concise paragraph, preserving key facts while staying within budget. Configure the threshold via environment variable: ```bash -export FIREFLY_GENAI_MEMORY_SUMMARIZE_THRESHOLD=10 +export FIREFLY_AGENTIC_MEMORY_SUMMARIZE_THRESHOLD=10 ``` --- @@ -147,7 +147,7 @@ It is useful for passing context between pipeline steps, storing extraction results for validation, or maintaining entities across reasoning iterations. ```python -from fireflyframework_genai.memory import WorkingMemory +from fireflyframework_agentic.memory import WorkingMemory wm = WorkingMemory(scope_id="idp-session-42") wm.set("doc_type", "invoice") @@ -169,7 +169,7 @@ Multiple `WorkingMemory` instances can share the same store backend while maintaining independent namespaces: ```python -from fireflyframework_genai.memory import InMemoryStore, WorkingMemory +from fireflyframework_agentic.memory import InMemoryStore, WorkingMemory store = InMemoryStore() agent_a_mem = WorkingMemory(store=store, scope_id="agent_a") @@ -190,7 +190,7 @@ assert agent_b_mem.get("key") == "from B" Dict-backed, fast, non-persistent. Suitable for testing and short-lived sessions. ```python -from fireflyframework_genai.memory import InMemoryStore +from fireflyframework_agentic.memory import InMemoryStore store = InMemoryStore() ``` @@ -199,7 +199,7 @@ store = InMemoryStore() JSON file persistence. Each namespace is a separate file. ```python -from fireflyframework_genai.memory import FileStore +from fireflyframework_agentic.memory import FileStore store = FileStore(base_dir=".firefly_memory") ``` @@ -216,10 +216,10 @@ entries = await store.load_async("conversations") ### PostgreSQLStore Production-grade PostgreSQL persistence with connection pooling. Requires -`asyncpg` (install via `pip install fireflyframework-genai[postgres]`). +`asyncpg` (install via `pip install fireflyframework-agentic[postgres]`). ```python -from fireflyframework_genai.memory.database_store import PostgreSQLStore +from fireflyframework_agentic.memory.database_store import PostgreSQLStore store = PostgreSQLStore( url="postgresql://user:pass@localhost/firefly", @@ -233,9 +233,9 @@ memory = MemoryManager(store=store) **Environment Configuration:** ```bash -export FIREFLY_GENAI_MEMORY_BACKEND=postgres -export FIREFLY_GENAI_MEMORY_POSTGRES_URL=postgresql://user:pass@localhost/firefly -export FIREFLY_GENAI_MEMORY_POSTGRES_POOL_SIZE=10 +export FIREFLY_AGENTIC_MEMORY_BACKEND=postgres +export FIREFLY_AGENTIC_MEMORY_POSTGRES_URL=postgresql://user:pass@localhost/firefly +export FIREFLY_AGENTIC_MEMORY_POSTGRES_POOL_SIZE=10 ``` The store automatically creates required tables on first use. All operations @@ -262,10 +262,10 @@ CREATE INDEX idx_created_at ON firefly_memory(created_at); ### MongoDBStore Scalable MongoDB persistence with connection pooling. Requires `motor` and -`pymongo` (install via `pip install fireflyframework-genai[mongodb]`). +`pymongo` (install via `pip install fireflyframework-agentic[mongodb]`). ```python -from fireflyframework_genai.memory.database_store import MongoDBStore +from fireflyframework_agentic.memory.database_store import MongoDBStore store = MongoDBStore( url="mongodb://localhost:27017/", @@ -279,10 +279,10 @@ memory = MemoryManager(store=store) **Environment Configuration:** ```bash -export FIREFLY_GENAI_MEMORY_BACKEND=mongodb -export FIREFLY_GENAI_MEMORY_MONGODB_URL=mongodb://localhost:27017/ -export FIREFLY_GENAI_MEMORY_MONGODB_DATABASE=firefly -export FIREFLY_GENAI_MEMORY_MONGODB_POOL_SIZE=10 +export FIREFLY_AGENTIC_MEMORY_BACKEND=mongodb +export FIREFLY_AGENTIC_MEMORY_MONGODB_URL=mongodb://localhost:27017/ +export FIREFLY_AGENTIC_MEMORY_MONGODB_DATABASE=firefly +export FIREFLY_AGENTIC_MEMORY_MONGODB_POOL_SIZE=10 ``` The store automatically creates required collections and indexes: @@ -310,7 +310,7 @@ db.firefly_memory.createIndex({ created_at: 1 }) Implement the `MemoryStore` protocol for Redis, SQL, or any other backend: ```python -from fireflyframework_genai.memory import MemoryStore, MemoryEntry +from fireflyframework_agentic.memory import MemoryStore, MemoryEntry class RedisStore: def save(self, namespace: str, entry: MemoryEntry) -> None: ... @@ -352,7 +352,7 @@ suitable for `ConversationMemory`'s `summarizer` parameter. It uses an ephemeral Pydantic AI agent to compress evicted turns into a concise summary. ```python -from fireflyframework_genai.memory.summarization import create_llm_summarizer +from fireflyframework_agentic.memory.summarization import create_llm_summarizer summarizer = create_llm_summarizer(model="openai:gpt-4o-mini") conv_mem = ConversationMemory( @@ -382,7 +382,7 @@ strategy that extracts key sentences from the most recent turns. memory. It is the object you attach to agents, delegation routers, and pipelines. ```python -from fireflyframework_genai.memory import MemoryManager +from fireflyframework_agentic.memory import MemoryManager mgr = MemoryManager( max_conversation_tokens=32_000, @@ -425,7 +425,7 @@ result = await agent.run("Hi", conversation_id=cid) ### Multi-Agent Delegation ```python -from fireflyframework_genai.agents.delegation import DelegationRouter, RoundRobinStrategy +from fireflyframework_agentic.agents.delegation import DelegationRouter, RoundRobinStrategy router = DelegationRouter([agent_a, agent_b], RoundRobinStrategy(), memory=mgr) result = await router.route("Translate this text.") @@ -435,7 +435,7 @@ result = await router.route("Translate this text.") ### Pipelines ```python -from fireflyframework_genai.pipeline.context import PipelineContext +from fireflyframework_agentic.pipeline.context import PipelineContext ctx = PipelineContext(inputs=data, memory=mgr) result = await engine.run(context=ctx) @@ -469,8 +469,8 @@ Pass `conversation_id` in the request body for multi-turn conversations: Memory settings are configured via environment variables: ```bash -export FIREFLY_GENAI_MEMORY_BACKEND=in_memory # or "file" -export FIREFLY_GENAI_MEMORY_MAX_CONVERSATION_TOKENS=128000 -export FIREFLY_GENAI_MEMORY_SUMMARIZE_THRESHOLD=10 -export FIREFLY_GENAI_MEMORY_FILE_DIR=.firefly_memory +export FIREFLY_AGENTIC_MEMORY_BACKEND=in_memory # or "file" +export FIREFLY_AGENTIC_MEMORY_MAX_CONVERSATION_TOKENS=128000 +export FIREFLY_AGENTIC_MEMORY_SUMMARIZE_THRESHOLD=10 +export FIREFLY_AGENTIC_MEMORY_FILE_DIR=.firefly_memory ``` diff --git a/docs/observability.md b/docs/observability.md index 2ed89203..f4366eee 100644 --- a/docs/observability.md +++ b/docs/observability.md @@ -29,7 +29,7 @@ flowchart TD creating spans with GenAI-specific attributes (model name, token counts, agent name). ```python -from fireflyframework_genai.observability import FireflyTracer +from fireflyframework_agentic.observability import FireflyTracer tracer = FireflyTracer(service_name="my-genai-app") @@ -44,7 +44,7 @@ For convenience, the `@traced` decorator automatically creates a span around any function call: ```python -from fireflyframework_genai.observability import traced +from fireflyframework_agentic.observability import traced @traced(name="process_request") async def process_request(prompt: str) -> str: @@ -59,7 +59,7 @@ across service boundaries (HTTP, message queues, pipelines). **Trace Context Functions:** ```python -from fireflyframework_genai.observability.tracer import inject_trace_context, extract_trace_context +from fireflyframework_agentic.observability.tracer import inject_trace_context, extract_trace_context # Inject trace context into HTTP headers headers = {} @@ -82,7 +82,7 @@ The framework's REST API automatically propagates trace context: ```python # Middleware injects trace context into responses # and extracts from incoming requests -from fireflyframework_genai.exposure.rest.middleware import add_trace_propagation_middleware +from fireflyframework_agentic.exposure.rest.middleware import add_trace_propagation_middleware add_trace_propagation_middleware(app) ``` @@ -93,7 +93,7 @@ Message queue consumers/producers automatically propagate trace context: ```python # Kafka example - trace context in message headers -from fireflyframework_genai.exposure.queues.kafka import KafkaConsumer +from fireflyframework_agentic.exposure.queues.kafka import KafkaConsumer consumer = KafkaConsumer( topic="requests", @@ -107,7 +107,7 @@ consumer = KafkaConsumer( Traces flow through pipeline steps via `PipelineContext.correlation_id`: ```python -from fireflyframework_genai.pipeline.context import PipelineContext +from fireflyframework_agentic.pipeline.context import PipelineContext # Create context with correlation ID for trace linking context = PipelineContext( @@ -127,7 +127,7 @@ result = await pipeline.run(context) measurements. ```python -from fireflyframework_genai.observability import FireflyMetrics +from fireflyframework_agentic.observability import FireflyMetrics metrics = FireflyMetrics(service_name="my-genai-app") metrics.increment("agent.invocations", labels={"agent": "writer"}) @@ -137,7 +137,7 @@ metrics.record_histogram("agent.latency_ms", 142.5, labels={"agent": "writer"}) ### The @metered Decorator ```python -from fireflyframework_genai.observability import metered +from fireflyframework_agentic.observability import metered @metered(name="agent_call") async def call_agent(prompt: str) -> str: @@ -152,7 +152,7 @@ async def call_agent(prompt: str) -> str: occurrences: agent started, tool invoked, reasoning step completed, error encountered. ```python -from fireflyframework_genai.observability import FireflyEvents +from fireflyframework_agentic.observability import FireflyEvents events = FireflyEvents() events.emit("agent.started", {"agent": "writer", "model": "gpt-4o"}) @@ -166,7 +166,7 @@ The `configure_exporters` function sets up OpenTelemetry exporters based on the framework's configuration: ```python -from fireflyframework_genai.observability import configure_exporters +from fireflyframework_agentic.observability import configure_exporters configure_exporters( otlp_endpoint="http://localhost:4317", @@ -187,7 +187,7 @@ The `UsageTracker` automatically records token usage, cost estimates, and latenc for every agent run, reasoning pattern step, and pipeline execution. ```python -from fireflyframework_genai.observability import default_usage_tracker +from fireflyframework_agentic.observability import default_usage_tracker # After running agents, inspect accumulated usage summary = default_usage_tracker.get_summary() @@ -207,12 +207,12 @@ are retained in memory. When the limit is exceeded, the oldest records are evicted (FIFO). This prevents unbounded memory growth in long-running services. ```python -from fireflyframework_genai.observability.usage import UsageTracker +from fireflyframework_agentic.observability.usage import UsageTracker tracker = UsageTracker(max_records=5_000) ``` -The default `max_records` is controlled by the `FIREFLY_GENAI_USAGE_TRACKER_MAX_RECORDS` +The default `max_records` is controlled by the `FIREFLY_AGENTIC_USAGE_TRACKER_MAX_RECORDS` environment variable (default: `10_000`). Set to `0` for unlimited retention (not recommended for production). @@ -242,13 +242,13 @@ Two cost calculator implementations are provided: exact match, prefix match (e.g. `openai:gpt-4o-2024-08-06` matches `openai:gpt-4o`), and **cross-provider alias matching** for proxy providers. - **`GenAIPricesCostCalculator`** — delegates to the optional `genai-prices` package - for up-to-date pricing data. Install with `pip install fireflyframework-genai[costs]`. + for up-to-date pricing data. Install with `pip install fireflyframework-agentic[costs]`. The `get_cost_calculator()` factory selects the best available calculator based on -the `FIREFLY_GENAI_COST_CALCULATOR` setting (`"auto"`, `"static"`, or `"genai_prices"`). +the `FIREFLY_AGENTIC_COST_CALCULATOR` setting (`"auto"`, `"static"`, or `"genai_prices"`). ```python -from fireflyframework_genai.observability import get_cost_calculator +from fireflyframework_agentic.observability import get_cost_calculator calc = get_cost_calculator() cost = calc.estimate("openai:gpt-4o", input_tokens=1000, output_tokens=500) @@ -276,8 +276,8 @@ routes the request to the underlying model. Configure budget thresholds via environment variables: ```bash -export FIREFLY_GENAI_BUDGET_ALERT_THRESHOLD_USD=5.00 -export FIREFLY_GENAI_BUDGET_LIMIT_USD=10.00 +export FIREFLY_AGENTIC_BUDGET_ALERT_THRESHOLD_USD=5.00 +export FIREFLY_AGENTIC_BUDGET_LIMIT_USD=10.00 ``` When cumulative cost exceeds the alert threshold, a `WARNING` is logged. @@ -287,7 +287,7 @@ Budget checking runs automatically on every `UsageTracker.record()` call. To disable cost tracking entirely: ```bash -export FIREFLY_GENAI_COST_TRACKING_ENABLED=false +export FIREFLY_AGENTIC_COST_TRACKING_ENABLED=false ``` --- @@ -298,7 +298,7 @@ The `QuotaManager` provides production-grade quota enforcement with rate limitin daily budget caps, and adaptive backoff for 429 rate limit responses. ```python -from fireflyframework_genai.observability.quota import QuotaManager +from fireflyframework_agentic.observability.quota import QuotaManager quota = QuotaManager( daily_budget_usd=100.0, @@ -327,7 +327,7 @@ quota.record_request("openai:gpt-4o", cost_usd=0.05, tokens=1500) `RateLimiter` implements a **sliding window** algorithm for precise rate limiting: ```python -from fireflyframework_genai.observability.quota import RateLimiter +from fireflyframework_agentic.observability.quota import RateLimiter limiter = RateLimiter(max_requests=60, window_seconds=60.0) @@ -345,7 +345,7 @@ The sliding window ensures accurate rate limiting without bursts at window bound `AdaptiveBackoff` automatically increases retry delays for 429 responses: ```python -from fireflyframework_genai.observability.quota import AdaptiveBackoff +from fireflyframework_agentic.observability.quota import AdaptiveBackoff backoff = AdaptiveBackoff( base_delay=1.0, # Start at 1 second @@ -376,21 +376,21 @@ The retry loop: 4. Uses `AdaptiveBackoff` for exponential delay with jitter 5. Resets backoff on success -Configuration via environment variables or `FireflyGenAIConfig`: +Configuration via environment variables or `FireflyAgenticConfig`: | Variable | Default | Description | |----------|---------|-------------| -| `FIREFLY_GENAI_RATE_LIMIT_MAX_RETRIES` | `3` | Max retry attempts for 429 errors | -| `FIREFLY_GENAI_RATE_LIMIT_BASE_DELAY` | `1.0` | Base delay in seconds | -| `FIREFLY_GENAI_RATE_LIMIT_MAX_DELAY` | `60.0` | Maximum delay between retries | +| `FIREFLY_AGENTIC_RATE_LIMIT_MAX_RETRIES` | `3` | Max retry attempts for 429 errors | +| `FIREFLY_AGENTIC_RATE_LIMIT_BASE_DELAY` | `1.0` | Base delay in seconds | +| `FIREFLY_AGENTIC_RATE_LIMIT_MAX_DELAY` | `60.0` | Maximum delay between retries | ```python -from fireflyframework_genai.config import get_config, reset_config +from fireflyframework_agentic.config import get_config, reset_config import os # Configure via environment -os.environ["FIREFLY_GENAI_RATE_LIMIT_MAX_RETRIES"] = "5" -os.environ["FIREFLY_GENAI_RATE_LIMIT_BASE_DELAY"] = "2.0" +os.environ["FIREFLY_AGENTIC_RATE_LIMIT_MAX_RETRIES"] = "5" +os.environ["FIREFLY_AGENTIC_RATE_LIMIT_BASE_DELAY"] = "2.0" reset_config() # Pick up new values # Or read current config @@ -408,21 +408,21 @@ When disabled, each agent creates a standalone backoff tracker. ```bash # Enable quota management (default: true) -export FIREFLY_GENAI_QUOTA_ENABLED=true +export FIREFLY_AGENTIC_QUOTA_ENABLED=true # Set daily budget cap -export FIREFLY_GENAI_QUOTA_BUDGET_DAILY_USD=100.0 +export FIREFLY_AGENTIC_QUOTA_BUDGET_DAILY_USD=100.0 # Configure per-model rate limits (JSON) -export FIREFLY_GENAI_QUOTA_RATE_LIMITS='{"openai:gpt-4o": 60, "anthropic:claude-opus-4": 50}' +export FIREFLY_AGENTIC_QUOTA_RATE_LIMITS='{"openai:gpt-4o": 60, "anthropic:claude-opus-4": 50}' # Enable adaptive backoff (default: true) -export FIREFLY_GENAI_QUOTA_ADAPTIVE_BACKOFF=true +export FIREFLY_AGENTIC_QUOTA_ADAPTIVE_BACKOFF=true # Rate limit retry settings -export FIREFLY_GENAI_RATE_LIMIT_MAX_RETRIES=3 -export FIREFLY_GENAI_RATE_LIMIT_BASE_DELAY=1.0 -export FIREFLY_GENAI_RATE_LIMIT_MAX_DELAY=60.0 +export FIREFLY_AGENTIC_RATE_LIMIT_MAX_RETRIES=3 +export FIREFLY_AGENTIC_RATE_LIMIT_BASE_DELAY=1.0 +export FIREFLY_AGENTIC_RATE_LIMIT_MAX_DELAY=60.0 ``` ### Integration with Agents @@ -430,8 +430,8 @@ export FIREFLY_GENAI_RATE_LIMIT_MAX_DELAY=60.0 Quota enforcement can be integrated via middleware or direct checks: ```python -from fireflyframework_genai.agents import FireflyAgent -from fireflyframework_genai.agents.builtin_middleware import CostGuardMiddleware +from fireflyframework_agentic.agents import FireflyAgent +from fireflyframework_agentic.agents.builtin_middleware import CostGuardMiddleware # Budget enforcement via middleware agent = FireflyAgent( @@ -463,7 +463,7 @@ with `timestamp`, `level`, `logger`, and `message` fields. Enable JSON logging with the `format_style` parameter: ```python -from fireflyframework_genai import configure_logging +from fireflyframework_agentic import configure_logging configure_logging("INFO", format_style="json") ``` @@ -471,13 +471,13 @@ configure_logging("INFO", format_style="json") Example output: ```json -{"timestamp": "2026-01-15T10:30:00+00:00", "level": "INFO", "logger": "fireflyframework_genai.agents.base", "message": "run agent='writer' prompt='Write a...'"} +{"timestamp": "2026-01-15T10:30:00+00:00", "level": "INFO", "logger": "fireflyframework_agentic.agents.base", "message": "run agent='writer' prompt='Write a...'"} ``` The `JsonFormatter` class can also be used standalone with any Python logger: ```python -from fireflyframework_genai.logging import JsonFormatter +from fireflyframework_agentic.logging import JsonFormatter import logging handler = logging.StreamHandler() diff --git a/docs/pipeline.md b/docs/pipeline.md index 6dbba357..1df572a0 100644 --- a/docs/pipeline.md +++ b/docs/pipeline.md @@ -33,8 +33,8 @@ graph LR The `PipelineBuilder` provides a chainable API for constructing pipelines: ```python -from fireflyframework_genai.pipeline.builder import PipelineBuilder -from fireflyframework_genai.pipeline.steps import AgentStep, CallableStep +from fireflyframework_agentic.pipeline.builder import PipelineBuilder +from fireflyframework_agentic.pipeline.steps import AgentStep, CallableStep engine = ( PipelineBuilder("invoice-pipeline") @@ -57,8 +57,8 @@ The builder auto-wraps compatible objects: For full control, construct the DAG directly: ```python -from fireflyframework_genai.pipeline.dag import DAG, DAGNode, DAGEdge -from fireflyframework_genai.pipeline.engine import PipelineEngine +from fireflyframework_agentic.pipeline.dag import DAG, DAGNode, DAGEdge +from fireflyframework_agentic.pipeline.engine import PipelineEngine dag = DAG("my-pipeline") dag.add_node(DAGNode(node_id="step_a", step=my_step)) @@ -108,7 +108,7 @@ graph TD ``` ```python -from fireflyframework_genai.pipeline.steps import FanOutStep, FanInStep +from fireflyframework_agentic.pipeline.steps import FanOutStep, FanInStep engine = ( PipelineBuilder("parallel") @@ -133,8 +133,8 @@ for cost and throughput. It's ideal for bulk classification, extraction, or summarization tasks. ```python -from fireflyframework_genai.pipeline.steps import BatchLLMStep -from fireflyframework_genai.pipeline.builder import PipelineBuilder +from fireflyframework_agentic.pipeline.steps import BatchLLMStep +from fireflyframework_agentic.pipeline.builder import PipelineBuilder classifier = FireflyAgent( name="sentiment-classifier", @@ -199,8 +199,8 @@ BatchLLMStep respects all agent middleware including caching, circuit breakers, and cost guards: ```python -from fireflyframework_genai.agents.prompt_cache import PromptCacheMiddleware -from fireflyframework_genai.resilience.circuit_breaker import CircuitBreakerMiddleware +from fireflyframework_agentic.agents.prompt_cache import PromptCacheMiddleware +from fireflyframework_agentic.resilience.circuit_breaker import CircuitBreakerMiddleware classifier = FireflyAgent( name="batch-classifier", @@ -253,7 +253,7 @@ receives the node's input and returns a string key. Downstream nodes use condition gates to check the branch key and execute only the matching path. ```python -from fireflyframework_genai.pipeline.steps import BranchStep, CallableStep +from fireflyframework_agentic.pipeline.steps import BranchStep, CallableStep def classify_intent(inputs): text = inputs.get("input", "") @@ -292,7 +292,7 @@ pipeline behaves when the node fails: - **`FAIL_PIPELINE`** -- Abort the entire pipeline immediately. ```python -from fireflyframework_genai.pipeline.dag import DAGNode, FailureStrategy +from fireflyframework_agentic.pipeline.dag import DAGNode, FailureStrategy dag.add_node(DAGNode( node_id="critical_step", @@ -335,8 +335,8 @@ marked as failed and the pipeline reports `success=False`. You can attach a `MemoryManager` to the `PipelineContext` so that all steps share conversation and working memory. `AgentStep` injects the memory into downstream agent runs; `ReasoningStep` passes it to patterns via the `memory` kwarg. ```python -from fireflyframework_genai.memory import MemoryManager -from fireflyframework_genai.pipeline.context import PipelineContext +from fireflyframework_agentic.memory import MemoryManager +from fireflyframework_agentic.pipeline.context import PipelineContext memory = MemoryManager(working_scope_id="invoice-run-42") ctx = PipelineContext(inputs=document_bytes, metadata={"source": "email"}, memory=memory) @@ -351,7 +351,7 @@ result = await engine.run(context=ctx) - Node results from completed upstream nodes. ```python -from fireflyframework_genai.pipeline.context import PipelineContext +from fireflyframework_agentic.pipeline.context import PipelineContext ctx = PipelineContext( inputs=document_bytes, @@ -405,7 +405,7 @@ nodes start, complete, fail, or get skipped. Implement any subset of the five hooks: ```python -from fireflyframework_genai.pipeline.engine import PipelineEventHandler +from fireflyframework_agentic.pipeline.engine import PipelineEventHandler class MyHandler: async def on_node_start(self, node_id: str, pipeline_name: str) -> None: @@ -427,7 +427,7 @@ class MyHandler: Pass the handler when constructing the engine: ```python -from fireflyframework_genai.pipeline.engine import PipelineEngine +from fireflyframework_agentic.pipeline.engine import PipelineEngine engine = PipelineEngine(dag, event_handler=MyHandler()) result = await engine.run(inputs="test") @@ -440,37 +440,9 @@ failure, or feeding events to an observability pipeline. ## Boundary Nodes (Input / Output) -When building pipelines in Studio, you can use **Input** and **Output** -boundary nodes to define pipeline entry and exit points. These nodes are -compiled to pass-through `CallableStep` instances but carry configuration -metadata that enables the `ProjectRuntime` to auto-generate REST endpoints, -start queue consumers, or run cron schedulers. - -- **Input node** -- Defines trigger type (`manual`, `http`, `queue`, - `schedule`, `file_upload`) and an optional input schema. -- **Output node** -- Defines destination type (`response`, `queue`, - `webhook`, `store`, `multi`) and an optional response schema. - -The compiler enforces that a pipeline has exactly one Input node and at -least one Output node when boundary nodes are present. - -```python -from fireflyframework_genai.studio.execution.io_nodes import ( - InputNodeConfig, - OutputNodeConfig, - QueueConfig, -) - -# Queue-triggered pipeline -input_cfg = InputNodeConfig( - trigger_type="queue", - queue_config=QueueConfig(broker="kafka", topic_or_queue="events"), -) - -# Response destination -output_cfg = OutputNodeConfig(destination_type="response") -``` - -See the [Input/Output Nodes Guide](input-output-nodes.md) for full -configuration details and the [Project API Guide](project-api.md) for the -auto-generated REST endpoints. +Boundary nodes (`Input`, `Output`) for declaring pipeline entry and exit +points -- with auto-generated REST endpoints, queue consumers, and +scheduled triggers -- are provided by the +[fireflyframework-agentic-studio](https://github.com/fireflyframework/fireflyframework-agentic-studio) +package. See its docs for configuration details and the auto-generated +project API. diff --git a/docs/project-api.md b/docs/project-api.md deleted file mode 100644 index 772f0cc4..00000000 --- a/docs/project-api.md +++ /dev/null @@ -1,363 +0,0 @@ -# Per-Project API - -Copyright 2026 Firefly Software Solutions Inc. Licensed under the Apache License 2.0. - -Every Studio project gets an auto-generated set of REST endpoints for -running pipelines, managing the runtime, and querying execution history. -A GraphQL endpoint and WebSocket streaming protocol are also available. - ---- - -## REST Endpoints - -All project endpoints are scoped under `/api/projects/{name}/`. - -| Method | Path | Description | -|---|---|---| -| `POST` | `/{name}/run` | Synchronous pipeline execution | -| `POST` | `/{name}/run/async` | Asynchronous execution (returns immediately) | -| `GET` | `/{name}/runs/{execution_id}` | Poll an async execution result | -| `POST` | `/{name}/upload` | Trigger pipeline via file upload | -| `GET` | `/{name}/schema` | Retrieve input/output schema | -| `POST` | `/{name}/runtime/start` | Start the project runtime | -| `POST` | `/{name}/runtime/stop` | Stop the project runtime | -| `GET` | `/{name}/runtime/status` | Query runtime status | -| `GET` | `/{name}/runtime/executions` | List recent executions | - -### Synchronous Execution - -```bash -curl -X POST http://localhost:8470/api/projects/my-project/run \ - -H "Content-Type: application/json" \ - -d '{"input": "Classify this document"}' -``` - -Response: - -```json -{ - "result": "invoice", - "execution_id": "a1b2c3d4-...", - "duration_ms": 1234.56 -} -``` - -### Asynchronous Execution - -Start a run that returns immediately: - -```bash -curl -X POST http://localhost:8470/api/projects/my-project/run/async \ - -H "Content-Type: application/json" \ - -d '{"input": "Process this batch"}' -``` - -Response: - -```json -{"execution_id": "e5f6g7h8-...", "status": "running"} -``` - -Poll for results: - -```bash -curl http://localhost:8470/api/projects/my-project/runs/e5f6g7h8-... -``` - -Response (when complete): - -```json -{ - "execution_id": "e5f6g7h8-...", - "status": "completed", - "result": "...", - "duration_ms": 5678.90 -} -``` - -Status values: `running`, `completed`, `failed`. - -### File Upload - -```bash -curl -X POST http://localhost:8470/api/projects/my-project/upload \ - -F "file=@document.pdf" -``` - -The uploaded file is passed to the pipeline as: - -```json -{ - "file_name": "document.pdf", - "content_type": "application/pdf", - "content": "
KafkaAgentConsumer
RabbitMQAgentConsumer
RedisAgentConsumer"] ROUTER["QueueRouter
pattern-based routing"] REG["AgentRegistry"] @@ -3494,9 +3494,9 @@ flowchart LR ```bash # Install the backend you need -uv add "fireflyframework-genai[kafka]" -uv add "fireflyframework-genai[rabbitmq]" -uv add "fireflyframework-genai[redis]" +uv add "fireflyframework-agentic[kafka]" +uv add "fireflyframework-agentic[rabbitmq]" +uv add "fireflyframework-agentic[redis]" ``` ### Consumers @@ -3507,7 +3507,7 @@ registered agent. They run continuously — think of them as your agent's "inbox #### Kafka Consumer ```python -from fireflyframework_genai.exposure.queues.kafka import KafkaAgentConsumer +from fireflyframework_agentic.exposure.queues.kafka import KafkaAgentConsumer # This consumer reads from the "idp-incoming-documents" topic. # Every message body is passed to the "document_classifier" agent's run() method. @@ -3523,7 +3523,7 @@ await consumer.start() # Blocks and processes messages until stopped #### RabbitMQ Consumer ```python -from fireflyframework_genai.exposure.queues.rabbitmq import RabbitMQAgentConsumer +from fireflyframework_agentic.exposure.queues.rabbitmq import RabbitMQAgentConsumer consumer = RabbitMQAgentConsumer( agent_name="document_classifier", @@ -3536,7 +3536,7 @@ await consumer.start() #### Redis Consumer ```python -from fireflyframework_genai.exposure.queues.redis import RedisAgentConsumer +from fireflyframework_agentic.exposure.queues.redis import RedisAgentConsumer consumer = RedisAgentConsumer( agent_name="document_classifier", @@ -3554,8 +3554,8 @@ to the broker. Each producer satisfies the `QueueProducer` protocol. #### Kafka Producer ```python -from fireflyframework_genai.exposure.queues.kafka import KafkaAgentProducer -from fireflyframework_genai.exposure.queues import QueueMessage +from fireflyframework_agentic.exposure.queues.kafka import KafkaAgentProducer +from fireflyframework_agentic.exposure.queues import QueueMessage # Create a producer that publishes to the "idp-results" topic. producer = KafkaAgentProducer( @@ -3576,7 +3576,7 @@ await producer.stop() #### RabbitMQ Producer ```python -from fireflyframework_genai.exposure.queues.rabbitmq import RabbitMQAgentProducer +from fireflyframework_agentic.exposure.queues.rabbitmq import RabbitMQAgentProducer producer = RabbitMQAgentProducer( queue_name="idp-results", @@ -3589,7 +3589,7 @@ await producer.stop() #### Redis Producer ```python -from fireflyframework_genai.exposure.queues.redis import RedisAgentProducer +from fireflyframework_agentic.exposure.queues.redis import RedisAgentProducer producer = RedisAgentProducer( channel="idp-results", @@ -3605,9 +3605,9 @@ The most common pattern is a **consumer that processes messages and publishes re This turns your agent into a microservice that reads from one topic and writes to another: ```python -from fireflyframework_genai.exposure.queues.kafka import KafkaAgentConsumer, KafkaAgentProducer -from fireflyframework_genai.exposure.queues import QueueMessage -from fireflyframework_genai.agents.registry import agent_registry +from fireflyframework_agentic.exposure.queues.kafka import KafkaAgentConsumer, KafkaAgentProducer +from fireflyframework_agentic.exposure.queues import QueueMessage +from fireflyframework_agentic.agents.registry import agent_registry # Set up both sides consumer = KafkaAgentConsumer( @@ -3637,7 +3637,7 @@ async def process_and_publish(): All consumers and producers work with `QueueMessage`: ```python -from fireflyframework_genai.exposure.queues import QueueMessage +from fireflyframework_agentic.exposure.queues import QueueMessage message = QueueMessage( body="Process this invoice", @@ -3652,7 +3652,7 @@ message = QueueMessage( Route messages to different agents based on routing-key patterns: ```python -from fireflyframework_genai.exposure.queues import QueueRouter +from fireflyframework_agentic.exposure.queues import QueueRouter router = QueueRouter(default_agent="fallback") router.add_route(r"invoice\..*", "invoice_processor") @@ -3668,7 +3668,7 @@ router.add_route(r"contract\..*", "contract_processor") For unsupported brokers, extend `BaseQueueConsumer`: ```python -from fireflyframework_genai.exposure.queues.base import BaseQueueConsumer +from fireflyframework_agentic.exposure.queues.base import BaseQueueConsumer class MyBrokerConsumer(BaseQueueConsumer): async def start(self) -> None: @@ -3690,8 +3690,8 @@ and routes to specialised extractors. Results go back on a results topic for downstream systems to pick up: ```python -from fireflyframework_genai.exposure.queues.kafka import KafkaAgentConsumer, KafkaAgentProducer -from fireflyframework_genai.exposure.queues import QueueRouter, QueueMessage +from fireflyframework_agentic.exposure.queues.kafka import KafkaAgentConsumer, KafkaAgentProducer +from fireflyframework_agentic.exposure.queues import QueueRouter, QueueMessage # Route different document types to specialised extraction agents. # Messages with routing_key "invoice.*" go to the invoice extractor, etc. @@ -3736,7 +3736,7 @@ the factory handles prompt engineering, output typing, and registry registration ### Summarizer ```python -from fireflyframework_genai.agents.templates import create_summarizer_agent +from fireflyframework_agentic.agents.templates import create_summarizer_agent agent = create_summarizer_agent( max_length="short", # concise | short | medium | detailed @@ -3752,7 +3752,7 @@ result = await agent.run("Long invoice description text here...") Returns a structured `ClassificationResult` with category, confidence, and reasoning: ```python -from fireflyframework_genai.agents.templates import create_classifier_agent +from fireflyframework_agentic.agents.templates import create_classifier_agent agent = create_classifier_agent( categories=["invoice", "receipt", "contract", "form"], @@ -3774,7 +3774,7 @@ Extracts structured data into a user-provided Pydantic model: ```python from pydantic import BaseModel -from fireflyframework_genai.agents.templates import create_extractor_agent +from fireflyframework_agentic.agents.templates import create_extractor_agent class Invoice(BaseModel): vendor: str @@ -3799,8 +3799,8 @@ result = await agent.run("Invoice from Acme Corp, $1,234.56, 2026-01-15") Memory-enabled multi-turn assistant: ```python -from fireflyframework_genai.agents.templates import create_conversational_agent -from fireflyframework_genai.memory import MemoryManager +from fireflyframework_agentic.agents.templates import create_conversational_agent +from fireflyframework_agentic.memory import MemoryManager memory = MemoryManager(max_conversation_tokens=32_000) agent = create_conversational_agent( @@ -3820,7 +3820,7 @@ result = await agent.run("What's the payment status?", conversation_id=cid) Intent-based routing to child agents: ```python -from fireflyframework_genai.agents.templates import create_router_agent +from fireflyframework_agentic.agents.templates import create_router_agent agent = create_router_agent( agent_map={ @@ -3850,7 +3850,7 @@ All template factories accept: Replace our manual agents with templates for cleaner code: ```python -from fireflyframework_genai.agents.templates import ( +from fireflyframework_agentic.agents.templates import ( create_classifier_agent, create_extractor_agent, ) @@ -3925,7 +3925,7 @@ graph LR ### Delegation Router ```python -from fireflyframework_genai.agents.delegation import DelegationRouter, RoundRobinStrategy +from fireflyframework_agentic.agents.delegation import DelegationRouter, RoundRobinStrategy router = DelegationRouter( agents=[agent_a, agent_b, agent_c], @@ -3940,7 +3940,7 @@ Distributes requests evenly across a pool of agents. Useful for load balancing when all agents have equivalent capabilities: ```python -from fireflyframework_genai.agents.delegation import RoundRobinStrategy +from fireflyframework_agentic.agents.delegation import RoundRobinStrategy strategy = RoundRobinStrategy() router = DelegationRouter([agent_1, agent_2, agent_3], strategy) @@ -3952,7 +3952,7 @@ router = DelegationRouter([agent_1, agent_2, agent_3], strategy) Selects the first agent whose tags include a required capability: ```python -from fireflyframework_genai.agents.delegation import CapabilityStrategy +from fireflyframework_agentic.agents.delegation import CapabilityStrategy strategy = CapabilityStrategy(required_tag="invoice_extraction") router = DelegationRouter([invoice_agent, receipt_agent], strategy) @@ -3965,7 +3965,7 @@ result = await router.route("Extract invoice data.") When a `MemoryManager` is attached, delegated agents receive a forked memory scope: ```python -from fireflyframework_genai.memory import MemoryManager +from fireflyframework_agentic.memory import MemoryManager memory = MemoryManager(working_scope_id="main") router = DelegationRouter([agent_a, agent_b], RoundRobinStrategy(), memory=memory) @@ -3976,7 +3976,7 @@ result = await router.route("Process this.") ### IDP Tie-In: Routing Documents to Specialised Agents ```python -from fireflyframework_genai.agents.delegation import DelegationRouter, CapabilityStrategy +from fireflyframework_agentic.agents.delegation import DelegationRouter, CapabilityStrategy # Specialised agents for different document types invoice_agent = create_extractor_agent(InvoiceSchema, name="invoice_extractor") @@ -4004,7 +4004,7 @@ imports, no central configuration file — just install the package and go. ### Discovering Plugins ```python -from fireflyframework_genai.plugin import PluginDiscovery +from fireflyframework_agentic.plugin import PluginDiscovery result = PluginDiscovery.discover_all() print(f"Loaded {len(result.successful)} plugins, {len(result.failed)} failed") @@ -4015,21 +4015,21 @@ print(f"Loaded {len(result.successful)} plugins, {len(result.failed)} failed") In your package's `pyproject.toml`, declare entry points under the framework's groups: ```toml -[project.entry-points."fireflyframework_genai.agents"] +[project.entry-points."fireflyframework_agentic.agents"] my_agent = "my_package.agents:MySpecialAgent" -[project.entry-points."fireflyframework_genai.tools"] +[project.entry-points."fireflyframework_agentic.tools"] my_tool = "my_package.tools:MyCustomTool" -[project.entry-points."fireflyframework_genai.reasoning_patterns"] +[project.entry-points."fireflyframework_agentic.reasoning_patterns"] my_pattern = "my_package.reasoning:MyCustomPattern" ``` The three entry-point groups are: -- `fireflyframework_genai.agents` — Custom agents. -- `fireflyframework_genai.tools` — Custom tools. -- `fireflyframework_genai.reasoning_patterns` — Custom reasoning patterns. +- `fireflyframework_agentic.agents` — Custom agents. +- `fireflyframework_agentic.tools` — Custom tools. +- `fireflyframework_agentic.reasoning_patterns` — Custom reasoning patterns. On discovery, the framework loads each entry point and registers it in the appropriate registry. @@ -4038,7 +4038,7 @@ registry. ```python # Enable auto-discovery on startup (default: True) -# FIREFLY_GENAI_PLUGIN_AUTO_DISCOVER=true +# FIREFLY_AGENTIC_PLUGIN_AUTO_DISCOVER=true ``` ### IDP Tie-In: Packaging IDP as a Plugin @@ -4047,7 +4047,7 @@ You can package the entire IDP pipeline as a plugin that self-registers when ins ```toml # In idp_plugin/pyproject.toml -[project.entry-points."fireflyframework_genai.agents"] +[project.entry-points."fireflyframework_agentic.agents"] document_classifier = "idp_plugin.agents:classifier_agent" field_extractor = "idp_plugin.agents:extractor_agent" ocr_agent = "idp_plugin.agents:ocr_agent" @@ -4060,7 +4060,7 @@ agents automatically. ## Chapter 20: Putting It All Together -You've learned every module in fireflyframework-genai, each in isolation. Now it's time +You've learned every module in fireflyframework-agentic, each in isolation. Now it's time to see how they all fit together in a single, production-grade application. The diagram below shows the full system architecture — every layer, every connection: @@ -4108,7 +4108,7 @@ graph TB subgraph "Foundation" PAI["Pydantic AI\n(model calls, streaming)"] - CFG["FireflyGenAIConfig\n(env-driven settings)"] + CFG["FireflyAgenticConfig\n(env-driven settings)"] PLUG["Plugin System\n(entry-point discovery)"] end @@ -4163,27 +4163,27 @@ idp-service/ ### Configuration (.env) ```bash -FIREFLY_GENAI_DEFAULT_MODEL=openai:gpt-4o -FIREFLY_GENAI_DEFAULT_TEMPERATURE=0.1 -FIREFLY_GENAI_MAX_RETRIES=3 -FIREFLY_GENAI_OBSERVABILITY_ENABLED=true -FIREFLY_GENAI_OTLP_ENDPOINT=http://localhost:4317 -FIREFLY_GENAI_MEMORY_BACKEND=file -FIREFLY_GENAI_MEMORY_FILE_DIR=.firefly_memory -FIREFLY_GENAI_DEFAULT_CHUNK_SIZE=4000 -FIREFLY_GENAI_VALIDATION_ENABLED=true +FIREFLY_AGENTIC_DEFAULT_MODEL=openai:gpt-4o +FIREFLY_AGENTIC_DEFAULT_TEMPERATURE=0.1 +FIREFLY_AGENTIC_MAX_RETRIES=3 +FIREFLY_AGENTIC_OBSERVABILITY_ENABLED=true +FIREFLY_AGENTIC_OTLP_ENDPOINT=http://localhost:4317 +FIREFLY_AGENTIC_MEMORY_BACKEND=file +FIREFLY_AGENTIC_MEMORY_FILE_DIR=.firefly_memory +FIREFLY_AGENTIC_DEFAULT_CHUNK_SIZE=4000 +FIREFLY_AGENTIC_VALIDATION_ENABLED=true ``` ### Agents (agents.py) ```python from pydantic import BaseModel, Field -from fireflyframework_genai.agents.templates import ( +from fireflyframework_agentic.agents.templates import ( create_classifier_agent, create_extractor_agent, create_summarizer_agent, ) -from fireflyframework_genai.agents import FireflyAgent +from fireflyframework_agentic.agents import FireflyAgent # Output schema for extraction class InvoiceData(BaseModel): @@ -4240,9 +4240,9 @@ registers it in the global `ToolRegistry`, and returns the instance. The `ToolKi bundles them for agent injection via `as_pydantic_tools()`: ```python -from fireflyframework_genai.tools import firefly_tool, guarded, retryable, ToolKit -from fireflyframework_genai.tools.guards import RateLimitGuard, ValidationGuard -from fireflyframework_genai.tools.builtins import CalculatorTool +from fireflyframework_agentic.tools import firefly_tool, guarded, retryable, ToolKit +from fireflyframework_agentic.tools.guards import RateLimitGuard, ValidationGuard +from fireflyframework_agentic.tools.builtins import CalculatorTool # OCR tool — rate-limited because the upstream API is metered @retryable(max_retries=2, backoff=1.0) @@ -4277,13 +4277,13 @@ extraction_kit = ToolKit( ### Validation (validation.py) ```python -from fireflyframework_genai.validation.rules import ( +from fireflyframework_agentic.validation.rules import ( OutputValidator, RegexRule, FormatRule, RangeRule, ) -from fireflyframework_genai.validation.qos import ( +from fireflyframework_agentic.validation.qos import ( QoSGuard, ConfidenceScorer, ConsistencyChecker, GroundingChecker, ) -from fireflyframework_genai.validation import OutputReviewer +from fireflyframework_agentic.validation import OutputReviewer from .agents import InvoiceData, extractor_agent invoice_validator = OutputValidator({ @@ -4312,14 +4312,14 @@ qos_guard = QoSGuard( ### Pipeline (pipeline.py) ```python -from fireflyframework_genai.pipeline.builder import PipelineBuilder -from fireflyframework_genai.pipeline.steps import AgentStep, ReasoningStep, CallableStep -from fireflyframework_genai.pipeline.context import PipelineContext -from fireflyframework_genai.reasoning import PlanAndExecutePattern, ReflexionPattern -from fireflyframework_genai.content.chunking import TextChunker, BatchProcessor -from fireflyframework_genai.content.compression import ContextCompressor, MapReduceStrategy -from fireflyframework_genai.memory import MemoryManager -from fireflyframework_genai.observability import traced +from fireflyframework_agentic.pipeline.builder import PipelineBuilder +from fireflyframework_agentic.pipeline.steps import AgentStep, ReasoningStep, CallableStep +from fireflyframework_agentic.pipeline.context import PipelineContext +from fireflyframework_agentic.reasoning import PlanAndExecutePattern, ReflexionPattern +from fireflyframework_agentic.content.chunking import TextChunker, BatchProcessor +from fireflyframework_agentic.content.compression import ContextCompressor, MapReduceStrategy +from fireflyframework_agentic.memory import MemoryManager +from fireflyframework_agentic.observability import traced from .agents import classifier_agent, ocr_agent, summary_agent, extractor_agent from .validation import invoice_validator, reviewer @@ -4375,8 +4375,8 @@ async def process_document(document_bytes: bytes, metadata: dict | None = None) ### REST Application (app.py) ```python -from fireflyframework_genai.exposure.rest import create_genai_app -from fireflyframework_genai.observability import configure_exporters +from fireflyframework_agentic.exposure.rest import create_agentic_app +from fireflyframework_agentic.observability import configure_exporters from fastapi import UploadFile from .pipeline import process_document @@ -4384,7 +4384,7 @@ from .pipeline import process_document configure_exporters(otlp_endpoint="http://localhost:4317", console=True) # Create the app -app = create_genai_app(title="IDP Service", version="1.0.0") +app = create_agentic_app(title="IDP Service", version="1.0.0") @app.post("/idp/process") async def handle_document(file: UploadFile): @@ -4399,8 +4399,8 @@ async def handle_document(file: UploadFile): ### Queue Consumers (consumers.py) ```python -from fireflyframework_genai.exposure.queues.kafka import KafkaAgentConsumer -from fireflyframework_genai.exposure.queues import QueueRouter +from fireflyframework_agentic.exposure.queues.kafka import KafkaAgentConsumer +from fireflyframework_agentic.exposure.queues import QueueRouter # Route different document types to specialised processing router = QueueRouter(default_agent="document_classifier") @@ -4430,7 +4430,7 @@ python -m idp_service.consumers Before deploying to production, verify: -- [ ] **Configuration** — All `FIREFLY_GENAI_*` environment variables are set. +- [ ] **Configuration** — All `FIREFLY_AGENTIC_*` environment variables are set. - [ ] **Model access** — API keys for your LLM provider are configured. - [ ] **Observability** — OTLP endpoint is reachable; traces are flowing. - [ ] **Memory persistence** — `memory_backend` is set to `"file"` (or a custom backend) @@ -4449,7 +4449,7 @@ Before deploying to production, verify: ## Next Steps -Congratulations — you now know every module in fireflyframework-genai. Here are some +Congratulations — you now know every module in fireflyframework-agentic. Here are some paths to explore further: - **Dive deeper** — Each chapter links to a detailed module guide in `docs/`. diff --git a/docs/use-case-idp.md b/docs/use-case-idp.md index 85c4b8f5..6dd7396f 100644 --- a/docs/use-case-idp.md +++ b/docs/use-case-idp.md @@ -3,7 +3,7 @@ Copyright 2026 Firefly Software Solutions Inc. Licensed under the Apache License 2.0. This guide demonstrates how to build a production-grade Intelligent Document Processing -pipeline using fireflyframework-genai. The pipeline takes a raw document (PDF, image, +pipeline using fireflyframework-agentic. The pipeline takes a raw document (PDF, image, or scanned file), splits it into logical sub-documents, classifies each one, extracts structured data, validates the results, assembles a final output, and generates an LLM-powered explainability narrative -- all orchestrated as a 7-node DAG pipeline with @@ -41,8 +41,8 @@ the raw text with page markers. The extracted text is then chunked and compresse if needed. ```python -from fireflyframework_genai.content.chunking import TextChunker -from fireflyframework_genai.content.compression import ContextCompressor, TruncationStrategy +from fireflyframework_agentic.content.chunking import TextChunker +from fireflyframework_agentic.content.compression import ContextCompressor, TruncationStrategy # Chunk the extracted text chunker = TextChunker(chunk_size=20_000, chunk_overlap=200, strategy="token") @@ -62,7 +62,7 @@ incorporation followed by bylaws). The splitting phase uses a `FireflyAgent` to analyse page-level summaries and detect document boundaries. ```python -from fireflyframework_genai.agents import FireflyAgent +from fireflyframework_agentic.agents import FireflyAgent splitter_agent = FireflyAgent( name="document_splitter", @@ -89,7 +89,7 @@ bylaws, corporate filing, etc.) using `create_classifier_agent` with category descriptions and a Plan-and-Execute reasoning pattern for systematic analysis. ```python -from fireflyframework_genai.agents.templates import create_classifier_agent +from fireflyframework_agentic.agents.templates import create_classifier_agent DOCUMENT_TYPES = ["certificate_of_incorporation", "bylaws", "corporate_filing", "amendment", "other"] DOCUMENT_TYPE_DESCRIPTIONS = { @@ -114,7 +114,7 @@ result = await classifier_agent.run_with_reasoning( For multi-page documents, use `ImageTiler` to split large scans: ```python -from fireflyframework_genai.content.chunking import ImageTiler +from fireflyframework_agentic.content.chunking import ImageTiler tiler = ImageTiler(tile_width=1024, tile_height=1024, overlap=64) tiles = tiler.compute_tiles(image_width=4096, image_height=6144) @@ -130,9 +130,9 @@ validation failures. A custom retry prompt avoids resending the full document te on each retry, focusing only on the errors. ```python -from fireflyframework_genai.agents.templates import create_extractor_agent -from fireflyframework_genai.validation import OutputReviewer, OutputValidator -from fireflyframework_genai.validation.rules import RegexRule, FormatRule, EnumRule +from fireflyframework_agentic.agents.templates import create_extractor_agent +from fireflyframework_agentic.validation import OutputReviewer, OutputValidator +from fireflyframework_agentic.validation.rules import RegexRule, FormatRule, EnumRule extractor_agent = create_extractor_agent( CorporateDocumentData, # Pydantic model @@ -166,14 +166,14 @@ to ensure extracted fields conform to business rules and are grounded in the sou text. If validation fails, the `ReflexionPattern` drives self-correction. ```python -from fireflyframework_genai.validation.rules import ( +from fireflyframework_agentic.validation.rules import ( OutputValidator, RegexRule, FormatRule, EnumRule, ) -from fireflyframework_genai.validation.qos import GroundingChecker -from fireflyframework_genai.reasoning import ReflexionPattern +from fireflyframework_agentic.validation.qos import GroundingChecker +from fireflyframework_agentic.reasoning import ReflexionPattern # -- Structural validation -- validator = OutputValidator({ @@ -240,8 +240,8 @@ audit report. A `FireflyAgent` reads the trace records, audit trail, and assembl output to generate a human-readable narrative covering the full pipeline run. ```python -from fireflyframework_genai.agents import FireflyAgent -from fireflyframework_genai.explainability import TraceRecorder, AuditTrail, ReportBuilder +from fireflyframework_agentic.agents import FireflyAgent +from fireflyframework_agentic.explainability import TraceRecorder, AuditTrail, ReportBuilder # The trace recorder and audit trail have been collecting data throughout the pipeline recorder = TraceRecorder() @@ -277,7 +277,7 @@ Add memory to persist conversation across phases and carry facts like classifica results into later steps. ```python -from fireflyframework_genai.memory import MemoryManager +from fireflyframework_agentic.memory import MemoryManager memory = MemoryManager(working_scope_id="idp-session") ``` @@ -286,9 +286,9 @@ This gives you parallel execution, retries, timeouts, condition gates, and a ful execution trace for observability. ```python -from fireflyframework_genai.pipeline.builder import PipelineBuilder -from fireflyframework_genai.pipeline.steps import CallableStep -from fireflyframework_genai.pipeline.context import PipelineContext +from fireflyframework_agentic.pipeline.builder import PipelineBuilder +from fireflyframework_agentic.pipeline.steps import CallableStep +from fireflyframework_agentic.pipeline.context import PipelineContext # -- Build the 7-node pipeline DAG -- @@ -329,11 +329,11 @@ else: Register the pipeline as a REST endpoint so it can be called from external systems: ```python -from fireflyframework_genai.exposure.rest import create_genai_app +from fireflyframework_agentic.exposure.rest import create_agentic_app # The IDP agents are already registered in the AgentRegistry. # The REST app auto-generates endpoints for each agent. -app = create_genai_app() +app = create_agentic_app() # The pipeline itself can be exposed as a custom endpoint: from fastapi import UploadFile diff --git a/docs/validation.md b/docs/validation.md index 4a8094ce..9117c7a4 100644 --- a/docs/validation.md +++ b/docs/validation.md @@ -23,7 +23,7 @@ with five built-in rule types: - **CustomRule** -- User-supplied predicate function. ```python -from fireflyframework_genai.validation.rules import ( +from fireflyframework_agentic.validation.rules import ( OutputValidator, RegexRule, RangeRule, @@ -44,7 +44,7 @@ entire output dictionary at once. The result is a `ValidationReport` listing all passing and failing fields. ```python -from fireflyframework_genai.validation.rules import OutputValidator, RegexRule, EnumRule, RangeRule +from fireflyframework_agentic.validation.rules import OutputValidator, RegexRule, EnumRule, RangeRule validator = OutputValidator({ "status": [EnumRule("status", ["approved", "rejected", "pending"])], @@ -67,7 +67,7 @@ confidence markers (e.g. "I'm 85% confident") or using heuristic indicators like hedging language. ```python -from fireflyframework_genai.validation.qos import ConfidenceScorer +from fireflyframework_agentic.validation.qos import ConfidenceScorer scorer = ConfidenceScorer(my_agent) score = await scorer.score("The answer is definitely 42.") @@ -79,7 +79,7 @@ Runs the same prompt through an agent multiple times and measures the consistenc of the outputs. ```python -from fireflyframework_genai.validation.qos import ConsistencyChecker +from fireflyframework_agentic.validation.qos import ConsistencyChecker checker = ConsistencyChecker(my_agent, num_runs=3) score, outputs = await checker.check("What is the capital of France?") @@ -92,7 +92,7 @@ Verifies that a response is grounded in provided reference text by checking how of the response content can be traced back to the source material. ```python -from fireflyframework_genai.validation.qos import GroundingChecker +from fireflyframework_agentic.validation.qos import GroundingChecker checker = GroundingChecker() score, field_map = checker.check( @@ -108,7 +108,7 @@ print(score) # 1.0 if all fields are grounded in the source pipeline node or used standalone. It produces a `QoSResult` with a pass/fail verdict. ```python -from fireflyframework_genai.validation.qos import ( +from fireflyframework_agentic.validation.qos import ( QoSGuard, ConfidenceScorer, ConsistencyChecker, GroundingChecker, ) @@ -137,7 +137,7 @@ automatically retries with a feedback prompt describing exactly what was wrong. ```python from pydantic import BaseModel, Field -from fireflyframework_genai.validation import OutputReviewer +from fireflyframework_agentic.validation import OutputReviewer class InvoiceData(BaseModel): vendor: str @@ -155,7 +155,7 @@ print(result.attempts) # 1 if first try succeeded, 2+ if retries were needed Combine schema parsing with field-level validation rules: ```python -from fireflyframework_genai.validation import OutputReviewer, OutputValidator, EnumRule +from fireflyframework_agentic.validation import OutputReviewer, OutputValidator, EnumRule validator = OutputValidator({ "vendor": [EnumRule("vendor", ["Acme Corp", "Globex", "Initech"])], @@ -173,8 +173,8 @@ result = await reviewer.review(agent, "Extract invoice data from: ...") Attach a reviewer to any reasoning pattern to validate the final output: ```python -from fireflyframework_genai.reasoning import ReActPattern -from fireflyframework_genai.validation import OutputReviewer +from fireflyframework_agentic.reasoning import ReActPattern +from fireflyframework_agentic.validation import OutputReviewer reviewer = OutputReviewer(output_type=InvoiceData, max_retries=2) pattern = ReActPattern(reviewer=reviewer) diff --git a/docs/vectorstores.md b/docs/vectorstores.md index 2af6e898..4af3e6dc 100644 --- a/docs/vectorstores.md +++ b/docs/vectorstores.md @@ -31,8 +31,8 @@ graph TD ## Quick Start ```python -from fireflyframework_genai.embeddings.providers import OpenAIEmbedder -from fireflyframework_genai.vectorstores import InMemoryVectorStore, VectorDocument +from fireflyframework_agentic.embeddings.providers import OpenAIEmbedder +from fireflyframework_agentic.vectorstores import InMemoryVectorStore, VectorDocument # Create a store with auto-embedding embedder = OpenAIEmbedder() @@ -61,7 +61,7 @@ for r in results: Zero-dependency, brute-force cosine similarity. Ideal for development and testing. ```python -from fireflyframework_genai.vectorstores import InMemoryVectorStore +from fireflyframework_agentic.vectorstores import InMemoryVectorStore store = InMemoryVectorStore(embedder=my_embedder) ``` @@ -71,7 +71,7 @@ No extra install required. ### ChromaDB ```python -from fireflyframework_genai.vectorstores import ChromaVectorStore +from fireflyframework_agentic.vectorstores import ChromaVectorStore # Ephemeral (in-process) store = ChromaVectorStore(collection_name="my_docs", embedder=my_embedder) @@ -82,12 +82,12 @@ client = chromadb.HttpClient(host="localhost", port=8000) store = ChromaVectorStore(collection_name="my_docs", client=client, embedder=my_embedder) ``` -Install: `pip install fireflyframework-genai[vectorstores-chroma]` +Install: `pip install fireflyframework-agentic[vectorstores-chroma]` ### Pinecone ```python -from fireflyframework_genai.vectorstores import PineconeVectorStore +from fireflyframework_agentic.vectorstores import PineconeVectorStore store = PineconeVectorStore( index_name="my-index", @@ -96,12 +96,12 @@ store = PineconeVectorStore( ) ``` -Install: `pip install fireflyframework-genai[vectorstores-pinecone]` +Install: `pip install fireflyframework-agentic[vectorstores-pinecone]` ### Qdrant ```python -from fireflyframework_genai.vectorstores import QdrantVectorStore +from fireflyframework_agentic.vectorstores import QdrantVectorStore store = QdrantVectorStore( collection_name="my_collection", @@ -112,7 +112,7 @@ store = QdrantVectorStore( ) ``` -Install: `pip install fireflyframework-genai[vectorstores-qdrant]` +Install: `pip install fireflyframework-agentic[vectorstores-qdrant]` --- @@ -121,7 +121,7 @@ Install: `pip install fireflyframework-genai[vectorstores-qdrant]` ### VectorDocument ```python -from fireflyframework_genai.vectorstores import VectorDocument +from fireflyframework_agentic.vectorstores import VectorDocument doc = VectorDocument( id="unique-id", # required @@ -135,7 +135,7 @@ doc = VectorDocument( ### SearchResult ```python -from fireflyframework_genai.vectorstores import SearchResult +from fireflyframework_agentic.vectorstores import SearchResult # Returned by search() and search_text() result.document # VectorDocument @@ -145,7 +145,7 @@ result.score # float (0.0 to 1.0, higher = more similar) ### SearchFilter ```python -from fireflyframework_genai.vectorstores import SearchFilter +from fireflyframework_agentic.vectorstores import SearchFilter # Supported operators: eq, ne, gt, lt, gte, lte, in filters = [ @@ -202,7 +202,7 @@ results = await store.search_text("my query") ## Registry ```python -from fireflyframework_genai.vectorstores import VectorStoreRegistry, InMemoryVectorStore +from fireflyframework_agentic.vectorstores import VectorStoreRegistry, InMemoryVectorStore registry = VectorStoreRegistry() registry.register("memory", InMemoryVectorStore(embedder=my_embedder)) @@ -215,12 +215,12 @@ await store.upsert(docs) ## Configuration -Global defaults via environment variables (prefix `FIREFLY_GENAI_`): +Global defaults via environment variables (prefix `FIREFLY_AGENTIC_`): | Setting | Env Variable | Default | |---------|-------------|---------| -| `default_vector_store` | `FIREFLY_GENAI_DEFAULT_VECTOR_STORE` | `memory` | -| `vector_store_namespace` | `FIREFLY_GENAI_VECTOR_STORE_NAMESPACE` | `default` | +| `default_vector_store` | `FIREFLY_AGENTIC_DEFAULT_VECTOR_STORE` | `memory` | +| `vector_store_namespace` | `FIREFLY_AGENTIC_VECTOR_STORE_NAMESPACE` | `default` | --- @@ -229,7 +229,7 @@ Global defaults via environment variables (prefix `FIREFLY_GENAI_`): Build retrieval-augmented generation workflows using pipeline steps: ```python -from fireflyframework_genai.pipeline import Pipeline, PipelineStep, RetrievalStep +from fireflyframework_agentic.pipeline import Pipeline, PipelineStep, RetrievalStep # RetrievalStep embeds the query and searches the store retrieval = RetrievalStep( @@ -254,8 +254,8 @@ result = await pipeline.execute("What is RAG?") Subclass `BaseVectorStore` and implement three methods: ```python -from fireflyframework_genai.vectorstores.base import BaseVectorStore -from fireflyframework_genai.vectorstores.types import SearchFilter, SearchResult, VectorDocument +from fireflyframework_agentic.vectorstores.base import BaseVectorStore +from fireflyframework_agentic.vectorstores.types import SearchFilter, SearchResult, VectorDocument class MyVectorStore(BaseVectorStore): async def _upsert(self, documents: list[VectorDocument], namespace: str) -> None: diff --git a/examples/README.md b/examples/README.md index d8d6bd8f..c0048a67 100644 --- a/examples/README.md +++ b/examples/README.md @@ -2,7 +2,7 @@ Copyright 2026 Firefly Software Solutions Inc. Licensed under the Apache License 2.0. -Runnable example scripts demonstrating the major features of `fireflyframework-genai`. +Runnable example scripts demonstrating the major features of `fireflyframework-agentic`. ## Prerequisites @@ -76,10 +76,6 @@ If `OPENAI_API_KEY` is not set, each script will prompt you interactively. Requires `pdfplumber` (included in dev dependencies). -## Studio Examples - -- **`studio_launch.py`** — Launch Firefly Studio programmatically with custom `StudioConfig`. Shows how to embed the Studio app with a custom port, host, and project directory. Requires `pip install "fireflyframework-genai[studio]"`. **No API key required** (the AI assistant requires one, but the IDE itself does not). - ## Reasoning Pattern Examples - **`reasoning_cot.py`** — Chain of Thought: step-by-step reasoning with `ReasoningThought` and trace inspection. diff --git a/examples/basic_agent.py b/examples/basic_agent.py index f4e91159..73930928 100644 --- a/examples/basic_agent.py +++ b/examples/basic_agent.py @@ -30,7 +30,7 @@ from _common import MODEL, ensure_api_key -from fireflyframework_genai.agents import FireflyAgent +from fireflyframework_agentic.agents import FireflyAgent async def main() -> None: diff --git a/examples/batch_processing.py b/examples/batch_processing.py index 2d0ae757..69493fec 100644 --- a/examples/batch_processing.py +++ b/examples/batch_processing.py @@ -38,9 +38,9 @@ import os import time -from fireflyframework_genai.agents.base import FireflyAgent -from fireflyframework_genai.pipeline.builder import PipelineBuilder -from fireflyframework_genai.pipeline.steps import BatchLLMStep +from fireflyframework_agentic.agents.base import FireflyAgent +from fireflyframework_agentic.pipeline.builder import PipelineBuilder +from fireflyframework_agentic.pipeline.steps import BatchLLMStep async def demo_basic_batch_processing(): @@ -72,7 +72,7 @@ async def demo_basic_batch_processing(): batch_size=10, # Process up to 10 at once ) - from fireflyframework_genai.pipeline.context import PipelineContext + from fireflyframework_agentic.pipeline.context import PipelineContext context = PipelineContext(inputs={}, correlation_id="batch-demo") inputs = {"reviews": reviews} @@ -116,7 +116,7 @@ async def demo_large_scale_batch(): batch_size=5, # Process 5 at a time ) - from fireflyframework_genai.pipeline.context import PipelineContext + from fireflyframework_agentic.pipeline.context import PipelineContext context = PipelineContext(inputs={}, correlation_id="large-batch") inputs = {"documents": documents} @@ -165,7 +165,7 @@ def on_batch_complete(results): on_batch_complete=on_batch_complete, ) - from fireflyframework_genai.pipeline.context import PipelineContext + from fireflyframework_agentic.pipeline.context import PipelineContext context = PipelineContext(inputs={}, correlation_id="callback-demo") inputs = {"texts": texts} @@ -253,7 +253,7 @@ async def demo_cost_comparison(): print("⚠️ Skipping cost comparison (requires OPENAI_API_KEY)") return - from fireflyframework_genai.observability.usage import default_usage_tracker + from fireflyframework_agentic.observability.usage import default_usage_tracker agent = FireflyAgent( "cost-test", @@ -278,7 +278,7 @@ async def demo_cost_comparison(): initial_cost = default_usage_tracker.get_summary().total_cost_usd step = BatchLLMStep(agent, prompts_key="prompts") - from fireflyframework_genai.pipeline.context import PipelineContext + from fireflyframework_agentic.pipeline.context import PipelineContext context = PipelineContext(inputs={}, correlation_id="cost-test") await step.execute(context, {"prompts": prompts}) diff --git a/examples/cached_tool.py b/examples/cached_tool.py index 12e254e3..74a997db 100644 --- a/examples/cached_tool.py +++ b/examples/cached_tool.py @@ -35,7 +35,7 @@ async def main() -> None: - from fireflyframework_genai.tools.cached import CachedTool + from fireflyframework_agentic.tools.cached import CachedTool # -- Define a "slow" tool that simulates network latency ------------------ diff --git a/examples/circuit_breaker.py b/examples/circuit_breaker.py index c8b25d19..9c912a55 100644 --- a/examples/circuit_breaker.py +++ b/examples/circuit_breaker.py @@ -41,7 +41,7 @@ import asyncio import random -from fireflyframework_genai.resilience.circuit_breaker import ( +from fireflyframework_agentic.resilience.circuit_breaker import ( CircuitBreaker, CircuitBreakerOpenError, ) @@ -310,7 +310,7 @@ async def main(): print("✓ Automatically transitions based on failures and successes") print("✓ Use with fallback strategies for resilient applications") print("\nUsage:") - print(" from fireflyframework_genai.resilience import CircuitBreaker") + print(" from fireflyframework_agentic.resilience import CircuitBreaker") print() print(" breaker = CircuitBreaker(") print(" failure_threshold=5,") @@ -322,7 +322,7 @@ async def main(): print(" result = await external_api_call()") print() print("With agent middleware:") - print(" from fireflyframework_genai.resilience import CircuitBreakerMiddleware") + print(" from fireflyframework_agentic.resilience import CircuitBreakerMiddleware") print() print(" agent = FireflyAgent(") print(" 'resilient-agent',") diff --git a/examples/classifier.py b/examples/classifier.py index b065ffd5..6a18a16a 100644 --- a/examples/classifier.py +++ b/examples/classifier.py @@ -29,7 +29,7 @@ from _common import MODEL, ensure_api_key -from fireflyframework_genai.agents.templates import create_classifier_agent +from fireflyframework_agentic.agents.templates import create_classifier_agent SAMPLES = [ "My invoice shows an incorrect charge for last month's subscription.", diff --git a/examples/conversation_export_import.py b/examples/conversation_export_import.py index 12b698b1..174edb9d 100644 --- a/examples/conversation_export_import.py +++ b/examples/conversation_export_import.py @@ -35,7 +35,7 @@ def main() -> None: - from fireflyframework_genai.memory.conversation import ConversationMemory + from fireflyframework_agentic.memory.conversation import ConversationMemory # ── 1. Build a conversation ───────────────────────────────────────── print("=== Build a Conversation ===\n") @@ -107,7 +107,7 @@ def main() -> None: # ── 7. LLM summarizer factory ─────────────────────────────────────── print("\n=== LLM Summarizer (factory demo) ===\n") - from fireflyframework_genai.memory.summarization import create_llm_summarizer + from fireflyframework_agentic.memory.summarization import create_llm_summarizer summarizer = create_llm_summarizer() print(f" create_llm_summarizer() → {type(summarizer).__name__} (callable={callable(summarizer)})") diff --git a/examples/conversational_memory.py b/examples/conversational_memory.py index e7ffadc5..93beb817 100644 --- a/examples/conversational_memory.py +++ b/examples/conversational_memory.py @@ -31,8 +31,8 @@ from _common import MODEL, ensure_api_key -from fireflyframework_genai.agents.templates import create_conversational_agent -from fireflyframework_genai.memory import MemoryManager +from fireflyframework_agentic.agents.templates import create_conversational_agent +from fireflyframework_agentic.memory import MemoryManager async def main() -> None: diff --git a/examples/database_persistence.py b/examples/database_persistence.py index b99d0a28..39268c4c 100755 --- a/examples/database_persistence.py +++ b/examples/database_persistence.py @@ -25,7 +25,7 @@ Prerequisites: 1. Install PostgreSQL dependencies: - pip install fireflyframework-genai[postgres] + pip install fireflyframework-agentic[postgres] 2. Start PostgreSQL (using Docker): docker run -d \\ @@ -36,8 +36,8 @@ postgres:17 3. Set environment variables: - export FIREFLY_GENAI_MEMORY_BACKEND=postgres - export FIREFLY_GENAI_MEMORY_POSTGRES_URL=postgresql://postgres:firefly123@localhost/firefly_memory + export FIREFLY_AGENTIC_MEMORY_BACKEND=postgres + export FIREFLY_AGENTIC_MEMORY_POSTGRES_URL=postgresql://postgres:firefly123@localhost/firefly_memory export OPENAI_API_KEY=sk-... Usage: @@ -46,10 +46,10 @@ import asyncio -from fireflyframework_genai.agents.base import FireflyAgent -from fireflyframework_genai.config import get_config -from fireflyframework_genai.memory.database_store import PostgreSQLStore -from fireflyframework_genai.memory.manager import MemoryManager +from fireflyframework_agentic.agents.base import FireflyAgent +from fireflyframework_agentic.config import get_config +from fireflyframework_agentic.memory.database_store import PostgreSQLStore +from fireflyframework_agentic.memory.manager import MemoryManager async def main() -> None: @@ -100,7 +100,7 @@ async def main() -> None: # Store a fact in working memory (persisted to PostgreSQL) memory.set_fact("user_name", "Alice") - memory.set_fact("project", "Firefly GenAI Framework") + memory.set_fact("project", "Firefly Agentic Framework") print("\n✓ Stored facts in working memory (PostgreSQL)") # Second interaction - memory is recalled from PostgreSQL diff --git a/examples/delegation_strategies.py b/examples/delegation_strategies.py index 00142e25..49806484 100644 --- a/examples/delegation_strategies.py +++ b/examples/delegation_strategies.py @@ -32,8 +32,8 @@ from _common import MODEL, ensure_api_key -from fireflyframework_genai.agents import FireflyAgent -from fireflyframework_genai.agents.delegation import ( +from fireflyframework_agentic.agents import FireflyAgent +from fireflyframework_agentic.agents.delegation import ( CapabilityStrategy, ContentBasedStrategy, CostAwareStrategy, diff --git a/examples/distributed_tracing.py b/examples/distributed_tracing.py index b6dd897f..5c3a57a3 100755 --- a/examples/distributed_tracing.py +++ b/examples/distributed_tracing.py @@ -15,7 +15,7 @@ """Distributed tracing with W3C Trace Context propagation. -This example demonstrates how Firefly GenAI automatically propagates trace +This example demonstrates how Firefly Agentic automatically propagates trace context across service boundaries using the W3C Trace Context standard. Features demonstrated: @@ -33,7 +33,7 @@ jaegertracing/all-in-one:latest 2. Set environment variables: - export FIREFLY_GENAI_OTLP_ENDPOINT=http://localhost:4317 + export FIREFLY_AGENTIC_OTLP_ENDPOINT=http://localhost:4317 export OPENAI_API_KEY=sk-... 3. View traces at: http://localhost:16686 @@ -46,9 +46,9 @@ from opentelemetry import trace -from fireflyframework_genai.agents.base import FireflyAgent -from fireflyframework_genai.config import get_config -from fireflyframework_genai.observability.tracer import ( +from fireflyframework_agentic.agents.base import FireflyAgent +from fireflyframework_agentic.config import get_config +from fireflyframework_agentic.observability.tracer import ( default_tracer, extract_trace_context, inject_trace_context, @@ -163,7 +163,7 @@ async def main() -> None: print("✓ View at: http://localhost:16686") else: print("\n⚠ No OTLP endpoint configured - traces will be console-only") - print("Set FIREFLY_GENAI_OTLP_ENDPOINT=http://localhost:4317 to enable Jaeger") + print("Set FIREFLY_AGENTIC_OTLP_ENDPOINT=http://localhost:4317 to enable Jaeger") # Start distributed trace tracer = trace.get_tracer(__name__) @@ -205,7 +205,7 @@ async def main() -> None: print("View Trace in Jaeger") print("=" * 70) print("1. Open http://localhost:16686") - print("2. Select 'fireflyframework_genai' service") + print("2. Select 'fireflyframework_agentic' service") print("3. Click 'Find Traces'") print(f"4. Look for trace ID: {root_context.trace_id:032x}") print("5. Click the trace to see the full span hierarchy:") diff --git a/examples/extractor.py b/examples/extractor.py index cb64bb2a..a3744aa9 100644 --- a/examples/extractor.py +++ b/examples/extractor.py @@ -30,7 +30,7 @@ from _common import MODEL, ensure_api_key from pydantic import BaseModel -from fireflyframework_genai.agents.templates import create_extractor_agent +from fireflyframework_agentic.agents.templates import create_extractor_agent class ContactInfo(BaseModel): diff --git a/examples/full_integration.py b/examples/full_integration.py index f8dcb280..394dbe12 100644 --- a/examples/full_integration.py +++ b/examples/full_integration.py @@ -36,27 +36,27 @@ import os # Core framework -from fireflyframework_genai.agents.base import FireflyAgent +from fireflyframework_agentic.agents.base import FireflyAgent # Middleware (all production features) -from fireflyframework_genai.agents.builtin_middleware import ( +from fireflyframework_agentic.agents.builtin_middleware import ( CostGuardMiddleware, LoggingMiddleware, ObservabilityMiddleware, ) -from fireflyframework_genai.agents.prompt_cache import PromptCacheMiddleware -from fireflyframework_genai.config import get_config +from fireflyframework_agentic.agents.prompt_cache import PromptCacheMiddleware +from fireflyframework_agentic.config import get_config # Database persistence -from fireflyframework_genai.memory.manager import MemoryManager +from fireflyframework_agentic.memory.manager import MemoryManager # Observability -from fireflyframework_genai.observability.usage import default_usage_tracker +from fireflyframework_agentic.observability.usage import default_usage_tracker # Pipeline with batch processing -from fireflyframework_genai.pipeline.builder import PipelineBuilder -from fireflyframework_genai.pipeline.steps import BatchLLMStep -from fireflyframework_genai.resilience.circuit_breaker import CircuitBreakerMiddleware +from fireflyframework_agentic.pipeline.builder import PipelineBuilder +from fireflyframework_agentic.pipeline.steps import BatchLLMStep +from fireflyframework_agentic.resilience.circuit_breaker import CircuitBreakerMiddleware async def demo_full_stack_agent(): @@ -75,8 +75,8 @@ async def demo_full_stack_agent(): # Create memory manager (supports in-memory, file, PostgreSQL, MongoDB) memory = MemoryManager( working_scope_id="production-app", - # To use PostgreSQL: Uncomment and set FIREFLY_GENAI_MEMORY_BACKEND=postgres - # To use MongoDB: Uncomment and set FIREFLY_GENAI_MEMORY_BACKEND=mongodb + # To use PostgreSQL: Uncomment and set FIREFLY_AGENTIC_MEMORY_BACKEND=postgres + # To use MongoDB: Uncomment and set FIREFLY_AGENTIC_MEMORY_BACKEND=mongodb ) # Create production-ready agent with all features @@ -222,7 +222,7 @@ async def aggregate(context, inputs): builder.add_edge("classify", "aggregate") # Run pipeline - from fireflyframework_genai.pipeline.context import PipelineContext + from fireflyframework_agentic.pipeline.context import PipelineContext pipeline = builder.build() @@ -247,15 +247,15 @@ async def demo_security_features(): # RBAC (if enabled) print("1. RBAC (Role-Based Access Control):") - print(" Configure with: FIREFLY_GENAI_RBAC_ENABLED=true") - print(" Set JWT secret: FIREFLY_GENAI_RBAC_JWT_SECRET=your-secret") + print(" Configure with: FIREFLY_AGENTIC_RBAC_ENABLED=true") + print(" Set JWT secret: FIREFLY_AGENTIC_RBAC_JWT_SECRET=your-secret") print(" Use @require_permission decorator on agent endpoints") print() # Encryption (if enabled) print("2. Data Encryption:") - print(" Configure with: FIREFLY_GENAI_ENCRYPTION_ENABLED=true") - print(" Set encryption key: FIREFLY_GENAI_ENCRYPTION_KEY=your-key-32-bytes") + print(" Configure with: FIREFLY_AGENTIC_ENCRYPTION_ENABLED=true") + print(" Set encryption key: FIREFLY_AGENTIC_ENCRYPTION_KEY=your-key-32-bytes") print(" Use EncryptedMemoryStore wrapper for sensitive data") print() @@ -269,7 +269,7 @@ async def demo_security_features(): # CORS Security print("4. CORS Security:") print(" Default: No origins allowed (secure)") - print(" Configure: FIREFLY_GENAI_CORS_ALLOWED_ORIGINS=['https://app.example.com']") + print(" Configure: FIREFLY_AGENTIC_CORS_ALLOWED_ORIGINS=['https://app.example.com']") print() @@ -307,46 +307,46 @@ async def demo_configuration_integration(): print() print("# Database Persistence") - print("export FIREFLY_GENAI_MEMORY_BACKEND=postgres # or mongodb, file, in_memory") - print("export FIREFLY_GENAI_MEMORY_POSTGRES_URL=postgresql://user:pass@localhost/db") - print("export FIREFLY_GENAI_MEMORY_MONGODB_URL=mongodb://localhost:27017/") + print("export FIREFLY_AGENTIC_MEMORY_BACKEND=postgres # or mongodb, file, in_memory") + print("export FIREFLY_AGENTIC_MEMORY_POSTGRES_URL=postgresql://user:pass@localhost/db") + print("export FIREFLY_AGENTIC_MEMORY_MONGODB_URL=mongodb://localhost:27017/") print() print("# Distributed Tracing") - print("export FIREFLY_GENAI_OBSERVABILITY_ENABLED=true") - print("export FIREFLY_GENAI_OTLP_ENDPOINT=http://localhost:4317") - print("export FIREFLY_GENAI_SERVICE_NAME=my-genai-app") + print("export FIREFLY_AGENTIC_OBSERVABILITY_ENABLED=true") + print("export FIREFLY_AGENTIC_OTLP_ENDPOINT=http://localhost:4317") + print("export FIREFLY_AGENTIC_SERVICE_NAME=my-genai-app") print() print("# Quota Management") - print("export FIREFLY_GENAI_QUOTA_ENABLED=true") - print("export FIREFLY_GENAI_QUOTA_BUDGET_DAILY_USD=100.0") - print("export FIREFLY_GENAI_QUOTA_RATE_LIMITS='{\"openai:gpt-4o\": 60}'") + print("export FIREFLY_AGENTIC_QUOTA_ENABLED=true") + print("export FIREFLY_AGENTIC_QUOTA_BUDGET_DAILY_USD=100.0") + print("export FIREFLY_AGENTIC_QUOTA_RATE_LIMITS='{\"openai:gpt-4o\": 60}'") print() print("# Security") - print("export FIREFLY_GENAI_RBAC_ENABLED=true") - print("export FIREFLY_GENAI_RBAC_JWT_SECRET=your-secret-key") - print("export FIREFLY_GENAI_ENCRYPTION_ENABLED=true") - print("export FIREFLY_GENAI_ENCRYPTION_KEY=your-32-byte-key") - print("export FIREFLY_GENAI_CORS_ALLOWED_ORIGINS=['https://app.example.com']") + print("export FIREFLY_AGENTIC_RBAC_ENABLED=true") + print("export FIREFLY_AGENTIC_RBAC_JWT_SECRET=your-secret-key") + print("export FIREFLY_AGENTIC_ENCRYPTION_ENABLED=true") + print("export FIREFLY_AGENTIC_ENCRYPTION_KEY=your-32-byte-key") + print("export FIREFLY_AGENTIC_CORS_ALLOWED_ORIGINS=['https://app.example.com']") print() print("# HTTP Connection Pooling") - print("export FIREFLY_GENAI_HTTP_POOL_ENABLED=true") - print("export FIREFLY_GENAI_HTTP_POOL_SIZE=100") + print("export FIREFLY_AGENTIC_HTTP_POOL_ENABLED=true") + print("export FIREFLY_AGENTIC_HTTP_POOL_SIZE=100") print() print("# Cost Optimization") - print("export FIREFLY_GENAI_BUDGET_LIMIT_USD=500.0") - print("export FIREFLY_GENAI_BUDGET_ALERT_THRESHOLD_USD=400.0") + print("export FIREFLY_AGENTIC_BUDGET_LIMIT_USD=500.0") + print("export FIREFLY_AGENTIC_BUDGET_ALERT_THRESHOLD_USD=400.0") print() async def main(): """Run all integration demonstrations.""" print("=" * 70) - print("FireflyFramework GenAI - Full Integration Demonstration") + print("FireflyFramework Agentic - Full Integration Demonstration") print("=" * 70) print() print("This example demonstrates all production-ready features working together:") diff --git a/examples/http_connection_pooling.py b/examples/http_connection_pooling.py index 1ba1fcc2..48dac5d0 100644 --- a/examples/http_connection_pooling.py +++ b/examples/http_connection_pooling.py @@ -21,7 +21,7 @@ for each request. Requirements: - pip install fireflyframework-genai[http] # Installs httpx + pip install fireflyframework-agentic[http] # Installs httpx Performance Benefits: - 30-50% faster for sequential requests @@ -36,7 +36,7 @@ import contextlib import time -from fireflyframework_genai.tools.builtins.http import HTTPX_AVAILABLE, HttpTool +from fireflyframework_agentic.tools.builtins.http import HTTPX_AVAILABLE, HttpTool async def demo_with_connection_pooling(): @@ -44,7 +44,7 @@ async def demo_with_connection_pooling(): print("\n=== HTTP Connection Pooling Demo ===\n") if not HTTPX_AVAILABLE: - print("⚠️ httpx not installed. Install with: pip install fireflyframework-genai[http]") + print("⚠️ httpx not installed. Install with: pip install fireflyframework-agentic[http]") print("Falling back to urllib (no connection pooling)\n") else: print("✓ httpx is available - connection pooling enabled\n") @@ -203,15 +203,15 @@ async def main(): print(" ✓ Lower resource usage and better scalability") print() print("To enable connection pooling:") - print(" 1. Install httpx: pip install fireflyframework-genai[http]") + print(" 1. Install httpx: pip install fireflyframework-agentic[http]") print(" 2. Set use_pool=True when creating HttpTool") print(" 3. Configure pool_size based on your workload") print() print("Configuration via environment variables:") - print(" FIREFLY_GENAI_HTTP_POOL_ENABLED=true") - print(" FIREFLY_GENAI_HTTP_POOL_SIZE=100") - print(" FIREFLY_GENAI_HTTP_POOL_MAX_KEEPALIVE=20") - print(" FIREFLY_GENAI_HTTP_POOL_TIMEOUT=30.0") + print(" FIREFLY_AGENTIC_HTTP_POOL_ENABLED=true") + print(" FIREFLY_AGENTIC_HTTP_POOL_SIZE=100") + print(" FIREFLY_AGENTIC_HTTP_POOL_MAX_KEEPALIVE=20") + print(" FIREFLY_AGENTIC_HTTP_POOL_TIMEOUT=30.0") print() diff --git a/examples/idp_pipeline.py b/examples/idp_pipeline.py index 62c05d18..29c931f9 100644 --- a/examples/idp_pipeline.py +++ b/examples/idp_pipeline.py @@ -64,26 +64,26 @@ split_prompt, ) -from fireflyframework_genai.agents import FireflyAgent -from fireflyframework_genai.agents.builtin_middleware import ( +from fireflyframework_agentic.agents import FireflyAgent +from fireflyframework_agentic.agents.builtin_middleware import ( CostGuardMiddleware, OutputGuardMiddleware, PromptGuardMiddleware, ) -from fireflyframework_genai.agents.templates import create_classifier_agent, create_extractor_agent -from fireflyframework_genai.content.chunking import TextChunker -from fireflyframework_genai.content.compression import ContextCompressor, TruncationStrategy -from fireflyframework_genai.explainability import AuditTrail, ReportBuilder, TraceRecorder -from fireflyframework_genai.logging import configure_logging -from fireflyframework_genai.memory import MemoryManager -from fireflyframework_genai.pipeline.builder import PipelineBuilder -from fireflyframework_genai.pipeline.context import PipelineContext -from fireflyframework_genai.pipeline.engine import PipelineEngine -from fireflyframework_genai.pipeline.steps import CallableStep -from fireflyframework_genai.reasoning import ReflexionPattern -from fireflyframework_genai.tools.cached import CachedTool -from fireflyframework_genai.validation.qos import GroundingChecker -from fireflyframework_genai.validation.reviewer import OutputReviewer +from fireflyframework_agentic.agents.templates import create_classifier_agent, create_extractor_agent +from fireflyframework_agentic.content.chunking import TextChunker +from fireflyframework_agentic.content.compression import ContextCompressor, TruncationStrategy +from fireflyframework_agentic.explainability import AuditTrail, ReportBuilder, TraceRecorder +from fireflyframework_agentic.logging import configure_logging +from fireflyframework_agentic.memory import MemoryManager +from fireflyframework_agentic.pipeline.builder import PipelineBuilder +from fireflyframework_agentic.pipeline.context import PipelineContext +from fireflyframework_agentic.pipeline.engine import PipelineEngine +from fireflyframework_agentic.pipeline.steps import CallableStep +from fireflyframework_agentic.reasoning import ReflexionPattern +from fireflyframework_agentic.tools.cached import CachedTool +from fireflyframework_agentic.validation.qos import GroundingChecker +from fireflyframework_agentic.validation.reviewer import OutputReviewer # ── ANSI colour helpers ───────────────────────────────────────────────────── _USE_COLOR = hasattr(sys.stdout, "isatty") and sys.stdout.isatty() @@ -1132,7 +1132,7 @@ async def main() -> None: print(f"{BOLD}{CYAN}{'=' * 70}{RESET}") print(f"{BOLD} Intelligent Document Processing (IDP) Pipeline{RESET}") - print(f"{DIM} Firefly GenAI Framework — Complex Example{RESET}") + print(f"{DIM} Firefly Agentic Framework — Complex Example{RESET}") print(f"{BOLD}{CYAN}{'=' * 70}{RESET}") print(f"\n{DIM}PDF:{RESET} {PDF_URL}\n") diff --git a/examples/idp_tools.py b/examples/idp_tools.py index e5e17852..c9daced4 100644 --- a/examples/idp_tools.py +++ b/examples/idp_tools.py @@ -31,9 +31,9 @@ from pydantic import BaseModel, Field -from fireflyframework_genai.prompts.template import PromptTemplate, PromptVariable -from fireflyframework_genai.tools import ToolKit, firefly_tool -from fireflyframework_genai.validation.rules import ( +from fireflyframework_agentic.prompts.template import PromptTemplate, PromptVariable +from fireflyframework_agentic.tools import ToolKit, firefly_tool +from fireflyframework_agentic.validation.rules import ( CustomRule, EnumRule, OutputValidator, diff --git a/examples/incremental_streaming.py b/examples/incremental_streaming.py index 5d86d673..21200e97 100644 --- a/examples/incremental_streaming.py +++ b/examples/incremental_streaming.py @@ -36,7 +36,7 @@ import os import time -from fireflyframework_genai.agents.base import FireflyAgent +from fireflyframework_agentic.agents.base import FireflyAgent async def demo_buffered_streaming(): diff --git a/examples/mongodb_persistence.py b/examples/mongodb_persistence.py index 1dafa822..d457d808 100755 --- a/examples/mongodb_persistence.py +++ b/examples/mongodb_persistence.py @@ -25,7 +25,7 @@ Prerequisites: 1. Install MongoDB dependencies: - pip install fireflyframework-genai[mongodb] + pip install fireflyframework-agentic[mongodb] 2. Start MongoDB (using Docker): docker run -d \\ @@ -35,8 +35,8 @@ mongo:8 3. Set environment variables: - export FIREFLY_GENAI_MEMORY_BACKEND=mongodb - export FIREFLY_GENAI_MEMORY_MONGODB_URL=mongodb://localhost:27017/ + export FIREFLY_AGENTIC_MEMORY_BACKEND=mongodb + export FIREFLY_AGENTIC_MEMORY_MONGODB_URL=mongodb://localhost:27017/ export OPENAI_API_KEY=sk-... Usage: @@ -45,10 +45,10 @@ import asyncio -from fireflyframework_genai.agents.base import FireflyAgent -from fireflyframework_genai.config import get_config -from fireflyframework_genai.memory.database_store import MongoDBStore -from fireflyframework_genai.memory.manager import MemoryManager +from fireflyframework_agentic.agents.base import FireflyAgent +from fireflyframework_agentic.config import get_config +from fireflyframework_agentic.memory.database_store import MongoDBStore +from fireflyframework_agentic.memory.manager import MemoryManager async def main() -> None: diff --git a/examples/observability_usage.py b/examples/observability_usage.py index 75b7227b..3799ea7d 100644 --- a/examples/observability_usage.py +++ b/examples/observability_usage.py @@ -31,7 +31,7 @@ def main() -> None: - from fireflyframework_genai.observability.usage import UsageRecord, UsageTracker + from fireflyframework_agentic.observability.usage import UsageRecord, UsageTracker # ── 1. Basic usage recording ──────────────────────────────────────── print("=== Basic Usage Tracking ===\n") diff --git a/examples/pipeline_branching.py b/examples/pipeline_branching.py index b8bd3ac6..08ffb897 100644 --- a/examples/pipeline_branching.py +++ b/examples/pipeline_branching.py @@ -36,11 +36,11 @@ import asyncio from dataclasses import dataclass, field -from fireflyframework_genai.pipeline.builder import PipelineBuilder -from fireflyframework_genai.pipeline.context import PipelineContext -from fireflyframework_genai.pipeline.dag import DAG, DAGEdge, DAGNode -from fireflyframework_genai.pipeline.engine import PipelineEngine -from fireflyframework_genai.pipeline.steps import BranchStep, CallableStep +from fireflyframework_agentic.pipeline.builder import PipelineBuilder +from fireflyframework_agentic.pipeline.context import PipelineContext +from fireflyframework_agentic.pipeline.dag import DAG, DAGEdge, DAGNode +from fireflyframework_agentic.pipeline.engine import PipelineEngine +from fireflyframework_agentic.pipeline.steps import BranchStep, CallableStep # -- Event handler that prints live progress ---------------------------------- diff --git a/examples/prompt_caching.py b/examples/prompt_caching.py index c91a963e..6d4a17e9 100644 --- a/examples/prompt_caching.py +++ b/examples/prompt_caching.py @@ -40,8 +40,8 @@ import asyncio import os -from fireflyframework_genai.agents.base import FireflyAgent -from fireflyframework_genai.agents.prompt_cache import CacheStatistics, PromptCacheMiddleware +from fireflyframework_agentic.agents.base import FireflyAgent +from fireflyframework_agentic.agents.prompt_cache import CacheStatistics, PromptCacheMiddleware # Sample long system prompt that would benefit from caching LEGAL_ASSISTANT_PROMPT = ( @@ -103,7 +103,7 @@ async def demo_without_caching(): print(f"System prompt length: ~{len(LEGAL_ASSISTANT_PROMPT.split())} words") print(f"Processing {len(questions)} questions without caching...\n") - from fireflyframework_genai.observability.usage import default_usage_tracker + from fireflyframework_agentic.observability.usage import default_usage_tracker initial_cost = default_usage_tracker.get_summary().total_cost_usd @@ -148,7 +148,7 @@ async def demo_with_caching(): print(f"System prompt length: ~{len(LEGAL_ASSISTANT_PROMPT.split())} words") print(f"Processing {len(questions)} questions with caching...\n") - from fireflyframework_genai.observability.usage import default_usage_tracker + from fireflyframework_agentic.observability.usage import default_usage_tracker initial_cost = default_usage_tracker.get_summary().total_cost_usd @@ -311,7 +311,7 @@ async def main(): print("✓ Reduces latency by avoiding reprocessing") print("✓ Works best with >1024 token cacheable content") print("\nUsage:") - print(" from fireflyframework_genai.agents.prompt_cache import PromptCacheMiddleware") + print(" from fireflyframework_agentic.agents.prompt_cache import PromptCacheMiddleware") print() print(" agent = FireflyAgent(") print(" 'assistant',") diff --git a/examples/quota_management.py b/examples/quota_management.py index 620849be..f1cbc711 100755 --- a/examples/quota_management.py +++ b/examples/quota_management.py @@ -15,7 +15,7 @@ """API quota management and rate limiting example. -This example demonstrates how to use Firefly GenAI's quota management system +This example demonstrates how to use Firefly Agentic's quota management system to enforce production-grade budget and rate limits for LLM API calls. Features demonstrated: @@ -27,9 +27,9 @@ Prerequisites: Set environment variables: - export FIREFLY_GENAI_QUOTA_ENABLED=true - export FIREFLY_GENAI_QUOTA_BUDGET_DAILY_USD=5.0 - export FIREFLY_GENAI_QUOTA_RATE_LIMITS='{"openai:gpt-4o-mini": 10}' + export FIREFLY_AGENTIC_QUOTA_ENABLED=true + export FIREFLY_AGENTIC_QUOTA_BUDGET_DAILY_USD=5.0 + export FIREFLY_AGENTIC_QUOTA_RATE_LIMITS='{"openai:gpt-4o-mini": 10}' export OPENAI_API_KEY=sk-... Usage: @@ -38,11 +38,11 @@ import asyncio -from fireflyframework_genai.agents.base import FireflyAgent -from fireflyframework_genai.config import get_config -from fireflyframework_genai.exceptions import BudgetExceededError, RateLimitError -from fireflyframework_genai.observability.quota import QuotaManager -from fireflyframework_genai.observability.usage import default_usage_tracker +from fireflyframework_agentic.agents.base import FireflyAgent +from fireflyframework_agentic.config import get_config +from fireflyframework_agentic.exceptions import BudgetExceededError, RateLimitError +from fireflyframework_agentic.observability.quota import QuotaManager +from fireflyframework_agentic.observability.usage import default_usage_tracker async def demonstrate_budget_enforcement(): @@ -199,7 +199,7 @@ async def demonstrate_config_integration(): if cfg.quota_enabled: # Quota manager is automatically created from config - from fireflyframework_genai.observability.quota import default_quota_manager + from fireflyframework_agentic.observability.quota import default_quota_manager if default_quota_manager: print("\n✓ Default quota manager created from configuration") @@ -209,7 +209,7 @@ async def demonstrate_config_integration(): print("\n⚠ Quota enabled but no default manager created") else: print("\n⚠ Quota management is disabled") - print(" Set FIREFLY_GENAI_QUOTA_ENABLED=true to enable") + print(" Set FIREFLY_AGENTIC_QUOTA_ENABLED=true to enable") async def demonstrate_production_pattern(): diff --git a/examples/reasoning_cot.py b/examples/reasoning_cot.py index 9d307efd..21faff53 100644 --- a/examples/reasoning_cot.py +++ b/examples/reasoning_cot.py @@ -30,8 +30,8 @@ from _common import MODEL, ensure_api_key -from fireflyframework_genai.agents import FireflyAgent -from fireflyframework_genai.reasoning import ChainOfThoughtPattern +from fireflyframework_agentic.agents import FireflyAgent +from fireflyframework_agentic.reasoning import ChainOfThoughtPattern async def main() -> None: diff --git a/examples/reasoning_goal.py b/examples/reasoning_goal.py index f6a62399..b935be9c 100644 --- a/examples/reasoning_goal.py +++ b/examples/reasoning_goal.py @@ -30,8 +30,8 @@ from _common import MODEL, ensure_api_key -from fireflyframework_genai.agents import FireflyAgent -from fireflyframework_genai.reasoning import GoalDecompositionPattern +from fireflyframework_agentic.agents import FireflyAgent +from fireflyframework_agentic.reasoning import GoalDecompositionPattern async def main() -> None: diff --git a/examples/reasoning_memory.py b/examples/reasoning_memory.py index b6308d3d..95105758 100644 --- a/examples/reasoning_memory.py +++ b/examples/reasoning_memory.py @@ -31,9 +31,9 @@ from _common import MODEL, ensure_api_key -from fireflyframework_genai.agents import FireflyAgent -from fireflyframework_genai.memory import MemoryManager -from fireflyframework_genai.reasoning import ReActPattern +from fireflyframework_agentic.agents import FireflyAgent +from fireflyframework_agentic.memory import MemoryManager +from fireflyframework_agentic.reasoning import ReActPattern async def main() -> None: diff --git a/examples/reasoning_pipeline.py b/examples/reasoning_pipeline.py index 27b6cbef..20ce9f28 100644 --- a/examples/reasoning_pipeline.py +++ b/examples/reasoning_pipeline.py @@ -30,8 +30,8 @@ from _common import MODEL, ensure_api_key -from fireflyframework_genai.agents import FireflyAgent -from fireflyframework_genai.reasoning import ( +from fireflyframework_agentic.agents import FireflyAgent +from fireflyframework_agentic.reasoning import ( ChainOfThoughtPattern, ReasoningPipeline, ReflexionPattern, diff --git a/examples/reasoning_plan.py b/examples/reasoning_plan.py index 3745ec15..a6c11da8 100644 --- a/examples/reasoning_plan.py +++ b/examples/reasoning_plan.py @@ -32,12 +32,12 @@ from _common import MODEL, ensure_api_key -from fireflyframework_genai import configure_logging -from fireflyframework_genai.agents import FireflyAgent -from fireflyframework_genai.reasoning import PlanAndExecutePattern +from fireflyframework_agentic import configure_logging +from fireflyframework_agentic.agents import FireflyAgent +from fireflyframework_agentic.reasoning import PlanAndExecutePattern # Enable INFO-level logging so that plan generation and step execution -# progress is printed in real time — only for fireflyframework_genai loggers. +# progress is printed in real time — only for fireflyframework_agentic loggers. configure_logging("INFO") diff --git a/examples/reasoning_react.py b/examples/reasoning_react.py index d038d672..98a05015 100644 --- a/examples/reasoning_react.py +++ b/examples/reasoning_react.py @@ -30,8 +30,8 @@ from _common import MODEL, ensure_api_key -from fireflyframework_genai.agents import FireflyAgent -from fireflyframework_genai.reasoning import ReActPattern +from fireflyframework_agentic.agents import FireflyAgent +from fireflyframework_agentic.reasoning import ReActPattern async def main() -> None: diff --git a/examples/reasoning_reflexion.py b/examples/reasoning_reflexion.py index eebffd8a..dd668f69 100644 --- a/examples/reasoning_reflexion.py +++ b/examples/reasoning_reflexion.py @@ -30,8 +30,8 @@ from _common import MODEL, ensure_api_key -from fireflyframework_genai.agents import FireflyAgent -from fireflyframework_genai.reasoning import ReflexionPattern +from fireflyframework_agentic.agents import FireflyAgent +from fireflyframework_agentic.reasoning import ReflexionPattern async def main() -> None: diff --git a/examples/reasoning_tot.py b/examples/reasoning_tot.py index 35fdb0b8..fe4a5ad4 100644 --- a/examples/reasoning_tot.py +++ b/examples/reasoning_tot.py @@ -30,8 +30,8 @@ from _common import MODEL, ensure_api_key -from fireflyframework_genai.agents import FireflyAgent -from fireflyframework_genai.reasoning import TreeOfThoughtsPattern +from fireflyframework_agentic.agents import FireflyAgent +from fireflyframework_agentic.reasoning import TreeOfThoughtsPattern async def main() -> None: diff --git a/examples/router.py b/examples/router.py index 7e6d593e..19161605 100644 --- a/examples/router.py +++ b/examples/router.py @@ -29,7 +29,7 @@ from _common import MODEL, ensure_api_key -from fireflyframework_genai.agents.templates import create_router_agent +from fireflyframework_agentic.agents.templates import create_router_agent REQUESTS = [ "I was charged twice for my last order.", diff --git a/examples/security_guards.py b/examples/security_guards.py index b6488fa4..e15922b3 100644 --- a/examples/security_guards.py +++ b/examples/security_guards.py @@ -37,7 +37,7 @@ def main() -> None: # ── 1. PromptGuard: detect prompt injection ───────────────────────── print("=== PromptGuard: Input Scanning ===\n") - from fireflyframework_genai.security.prompt_guard import PromptGuard + from fireflyframework_agentic.security.prompt_guard import PromptGuard guard = PromptGuard() @@ -67,7 +67,7 @@ def main() -> None: # ── 3. OutputGuard: detect PII and secrets ────────────────────────── print("\n=== OutputGuard: Output Scanning ===\n") - from fireflyframework_genai.security.output_guard import OutputGuard, default_output_guard + from fireflyframework_agentic.security.output_guard import OutputGuard, default_output_guard test_outputs = [ "The meeting is at 3pm tomorrow.", diff --git a/examples/studio_launch.py b/examples/studio_launch.py deleted file mode 100644 index eaf2d5f9..00000000 --- a/examples/studio_launch.py +++ /dev/null @@ -1,52 +0,0 @@ -# Copyright 2026 Firefly Software Solutions Inc -# -# Licensed under the Apache License, Version 2.0 (the "License"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. - -"""Launch Firefly Studio. - -Demonstrates three ways to start the Studio IDE: - -1. CLI: ``firefly studio`` -2. Convenience: ``launch_studio()`` -3. Programmatic: ``create_studio_app()`` + uvicorn - -Requirements: - pip install "fireflyframework-genai[studio]" -""" - -from __future__ import annotations - - -def main() -> None: - """Launch Studio with custom configuration.""" - import uvicorn - - from fireflyframework_genai.studio.config import StudioConfig - from fireflyframework_genai.studio.server import create_studio_app - - config = StudioConfig( - port=8470, - host="127.0.0.1", - open_browser=True, - dev_mode=False, - # projects_dir="/path/to/custom/projects", # optional - ) - - app = create_studio_app(config=config) - - print(f"Firefly Studio running at http://{config.host}:{config.port}") - uvicorn.run(app, host=config.host, port=config.port) - - -if __name__ == "__main__": - main() diff --git a/examples/summarizer.py b/examples/summarizer.py index 56ca8ffe..6941152f 100644 --- a/examples/summarizer.py +++ b/examples/summarizer.py @@ -29,7 +29,7 @@ from _common import MODEL, ensure_api_key -from fireflyframework_genai.agents.templates import create_summarizer_agent +from fireflyframework_agentic.agents.templates import create_summarizer_agent ARTICLE = """\ Artificial intelligence has undergone a dramatic transformation over the past diff --git a/examples/tool_timeout.py b/examples/tool_timeout.py index e19519a5..085cd5da 100644 --- a/examples/tool_timeout.py +++ b/examples/tool_timeout.py @@ -30,8 +30,8 @@ import asyncio -from fireflyframework_genai.exceptions import ToolTimeoutError -from fireflyframework_genai.tools.base import BaseTool +from fireflyframework_agentic.exceptions import ToolTimeoutError +from fireflyframework_agentic.tools.base import BaseTool class FastTool(BaseTool): diff --git a/install.ps1 b/install.ps1 index 6917fe11..3333cf52 100644 --- a/install.ps1 +++ b/install.ps1 @@ -16,10 +16,10 @@ <# .SYNOPSIS - Interactive installer for fireflyframework-genai. + Interactive installer for fireflyframework-agentic. .DESCRIPTION - Installs fireflyframework-genai from source with interactive TUI, requirement + Installs fireflyframework-agentic from source with interactive TUI, requirement detection, and progress indicators. .PARAMETER NonInteractive @@ -31,7 +31,7 @@ .EXAMPLE .\install.ps1 .\install.ps1 -NonInteractive -Extras all - irm https://raw.githubusercontent.com/fireflyframework/fireflyframework-genai/main/install.ps1 | iex + irm https://raw.githubusercontent.com/fireflyframework/fireflyframework-agentic/main/install.ps1 | iex #> [CmdletBinding()] @@ -46,8 +46,8 @@ $ErrorActionPreference = "Stop" # ── Constants ──────────────────────────────────────────────────────────────── $script:VERSION = "26.01.01" -$script:PACKAGE = "fireflyframework-genai" -$script:REPO_URL = "https://github.com/fireflyframework/fireflyframework-genai.git" +$script:PACKAGE = "fireflyframework-agentic" +$script:REPO_URL = "https://github.com/fireflyframework/fireflyframework-agentic.git" $script:MIN_PYTHON_MAJOR = 3 $script:MIN_PYTHON_MINOR = 13 $script:SPINNER_FRAMES = @("⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏") @@ -88,7 +88,7 @@ function Show-Banner { Write-Host " \______ /\___ >___| /\____|__ /__|" -ForegroundColor Cyan Write-Host " \/ \/ \/ \/" -ForegroundColor Cyan Write-Host "" - Write-Host " fireflyframework-genai" -ForegroundColor White -NoNewline + Write-Host " fireflyframework-agentic" -ForegroundColor White -NoNewline Write-Host " v$script:VERSION" -ForegroundColor DarkGray Write-Host " The production-grade GenAI metaframework built on Pydantic AI" -ForegroundColor DarkGray Write-Host " Copyright 2026 Firefly Software Solutions Inc. Apache License 2.0." -ForegroundColor DarkGray @@ -386,9 +386,9 @@ function Test-Installation { Write-Info "Verifying package import..." try { - $ver = & $script:PythonCmd -c "import fireflyframework_genai; print(fireflyframework_genai.__version__)" 2>&1 + $ver = & $script:PythonCmd -c "import fireflyframework_agentic; print(fireflyframework_agentic.__version__)" 2>&1 if ($LASTEXITCODE -eq 0) { - Write-Ok "fireflyframework-genai v$ver is ready" + Write-Ok "fireflyframework-agentic v$ver is ready" return $true } } catch { } @@ -402,7 +402,7 @@ function Show-Summary { Write-Host " ╔══════════════════════════════════════════════════════════════╗" -ForegroundColor Green Write-Host " ║" -ForegroundColor Green -NoNewline - Write-Host " fireflyframework-genai v$($script:VERSION)" -ForegroundColor White -NoNewline + Write-Host " fireflyframework-agentic v$($script:VERSION)" -ForegroundColor White -NoNewline Write-Host " installed successfully! " -NoNewline Write-Host "║" -ForegroundColor Green Write-Host " ╚══════════════════════════════════════════════════════════════╝" -ForegroundColor Green @@ -412,19 +412,19 @@ function Show-Summary { Write-Host "" Write-Host " # Configure your model provider" -ForegroundColor DarkGray Write-Host ' $env:OPENAI_API_KEY = "sk-..."' -ForegroundColor White - Write-Host ' $env:FIREFLY_GENAI_DEFAULT_MODEL = "openai:gpt-4o"' -ForegroundColor White + Write-Host ' $env:FIREFLY_AGENTIC_DEFAULT_MODEL = "openai:gpt-4o"' -ForegroundColor White Write-Host "" Write-Host " # Create your first agent" -ForegroundColor DarkGray - Write-Host " from fireflyframework_genai.agents import firefly_agent" -ForegroundColor White + Write-Host " from fireflyframework_agentic.agents import firefly_agent" -ForegroundColor White Write-Host "" Write-Host ' @firefly_agent(name="assistant", model="openai:gpt-4o")' -ForegroundColor White Write-Host " def instructions(ctx):" -ForegroundColor White Write-Host ' return "You are a helpful assistant."' -ForegroundColor White Write-Host "" Write-Info "Resources:" - Write-Host " Documentation: https://github.com/fireflyframework/fireflyframework-genai/tree/main/docs" -ForegroundColor DarkGray - Write-Host " Tutorial: https://github.com/fireflyframework/fireflyframework-genai/blob/main/docs/tutorial.md" -ForegroundColor DarkGray - Write-Host " Repository: https://github.com/fireflyframework/fireflyframework-genai" -ForegroundColor DarkGray + Write-Host " Documentation: https://github.com/fireflyframework/fireflyframework-agentic/tree/main/docs" -ForegroundColor DarkGray + Write-Host " Tutorial: https://github.com/fireflyframework/fireflyframework-agentic/blob/main/docs/tutorial.md" -ForegroundColor DarkGray + Write-Host " Repository: https://github.com/fireflyframework/fireflyframework-agentic" -ForegroundColor DarkGray Write-Host "" } diff --git a/install.sh b/install.sh index 916f8439..4c1fa240 100755 --- a/install.sh +++ b/install.sh @@ -16,13 +16,13 @@ set -euo pipefail # ══════════════════════════════════════════════════════════════════════════════ -# fireflyframework-genai — Interactive Installer +# fireflyframework-agentic — Interactive Installer # ══════════════════════════════════════════════════════════════════════════════ readonly VERSION="26.01.01" -readonly PACKAGE="fireflyframework-genai" -readonly PACKAGE_IMPORT="fireflyframework_genai" -readonly REPO_URL="https://github.com/fireflyframework/fireflyframework-genai.git" +readonly PACKAGE="fireflyframework-agentic" +readonly PACKAGE_IMPORT="fireflyframework_agentic" +readonly REPO_URL="https://github.com/fireflyframework/fireflyframework-agentic.git" readonly MIN_PYTHON_MAJOR=3 readonly MIN_PYTHON_MINOR=13 readonly TOTAL_STEPS=6 @@ -711,19 +711,19 @@ print_summary() { printf " %s# %d. Configure your model provider%s\n" "$DIM" "$step_num" "$RESET" printf " export OPENAI_API_KEY=sk-...\n" - printf " export FIREFLY_GENAI_DEFAULT_MODEL=openai:gpt-4o\n\n" + printf " export FIREFLY_AGENTIC_DEFAULT_MODEL=openai:gpt-4o\n\n" step_num=$((step_num + 1)) printf " %s# %d. Create your first agent%s\n" "$DIM" "$step_num" "$RESET" - printf " from fireflyframework_genai.agents import firefly_agent\n\n" + printf " from fireflyframework_agentic.agents import firefly_agent\n\n" printf " @firefly_agent(name=\"assistant\", model=\"openai:gpt-4o\")\n" printf " def instructions(ctx):\n" printf " return \"You are a helpful assistant.\"\n\n" printf " %s%sResources:%s\n\n" "$BOLD" "$WHITE" "$RESET" - printf " %sDocs :%s https://github.com/fireflyframework/fireflyframework-genai/tree/main/docs\n" "$DIM" "$RESET" - printf " %sTutorial :%s https://github.com/fireflyframework/fireflyframework-genai/blob/main/docs/tutorial.md\n" "$DIM" "$RESET" - printf " %sRepository:%s https://github.com/fireflyframework/fireflyframework-genai\n\n" "$DIM" "$RESET" + printf " %sDocs :%s https://github.com/fireflyframework/fireflyframework-agentic/tree/main/docs\n" "$DIM" "$RESET" + printf " %sTutorial :%s https://github.com/fireflyframework/fireflyframework-agentic/blob/main/docs/tutorial.md\n" "$DIM" "$RESET" + printf " %sRepository:%s https://github.com/fireflyframework/fireflyframework-agentic\n\n" "$DIM" "$RESET" } # ══════════════════════════════════════════════════════════════════════════════ diff --git a/pyproject.toml b/pyproject.toml index 54d57c79..db7464ab 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,5 +1,5 @@ [project] -name = "fireflyframework-genai" +name = "fireflyframework-agentic" version = "26.02.07" description = "A GenAI metaframework built on Pydantic AI for building production-grade GenAI applications with agents, reasoning patterns, prompt engineering, observability, and more." readme = "README.md" @@ -49,7 +49,7 @@ redis = [ "redis>=5.2.0", ] queues = [ - "fireflyframework-genai[kafka,rabbitmq,redis]", + "fireflyframework-agentic[kafka,rabbitmq,redis]", ] postgres = [ "asyncpg>=0.30.0", @@ -66,13 +66,6 @@ security = [ http = [ "httpx>=0.28.0", ] -studio = [ - "fastapi>=0.115.0", - "uvicorn[standard]>=0.34.0", - "httpx>=0.28.0", - "strawberry-graphql[fastapi]>=0.252.0", - "apscheduler>=4.0.0a5", -] costs = [ "genai-prices>=0.0.1", ] @@ -113,7 +106,7 @@ vectorstores-qdrant = [ "qdrant-client>=1.12.0", ] all = [ - "fireflyframework-genai[rest,queues,postgres,mongodb,security,http,studio,costs,embeddings,openai-embeddings,cohere-embeddings,google-embeddings,mistral-embeddings,voyage-embeddings,azure-embeddings,bedrock-embeddings,ollama-embeddings,vectorstores-chroma,vectorstores-pinecone,vectorstores-qdrant]", + "fireflyframework-agentic[rest,queues,postgres,mongodb,security,http,costs,embeddings,openai-embeddings,cohere-embeddings,google-embeddings,mistral-embeddings,voyage-embeddings,azure-embeddings,bedrock-embeddings,ollama-embeddings,vectorstores-chroma,vectorstores-pinecone,vectorstores-qdrant]", ] dev = [ "pytest>=8.3.0", @@ -128,15 +121,12 @@ dev = [ "pre-commit>=3.8.0", ] -[project.scripts] -firefly = "fireflyframework_genai.studio.cli:main" - [project.urls] Homepage = "https://fireflyframework.org/" -Documentation = "https://github.com/fireflyframework/fireflyframework-genai/tree/main/docs" -Repository = "https://github.com/fireflyframework/fireflyframework-genai" -Issues = "https://github.com/fireflyframework/fireflyframework-genai/issues" -Changelog = "https://github.com/fireflyframework/fireflyframework-genai/blob/main/CHANGELOG.md" +Documentation = "https://github.com/fireflyframework/fireflyframework-agentic/tree/main/docs" +Repository = "https://github.com/fireflyframework/fireflyframework-agentic" +Issues = "https://github.com/fireflyframework/fireflyframework-agentic/issues" +Changelog = "https://github.com/fireflyframework/fireflyframework-agentic/blob/main/CHANGELOG.md" [build-system] requires = ["uv_build>=0.9.5,<0.10.0"] @@ -151,7 +141,7 @@ select = ["E", "F", "W", "I", "N", "UP", "B", "SIM", "TC"] ignore = ["E501", "TC001", "TC002", "TC003", "UP040", "UP046", "B008"] [tool.ruff.lint.isort] -known-first-party = ["fireflyframework_genai"] +known-first-party = ["fireflyframework_agentic"] [tool.pyright] pythonVersion = "3.13" diff --git a/scripts/build_studio.py b/scripts/build_studio.py deleted file mode 100644 index d2158f63..00000000 --- a/scripts/build_studio.py +++ /dev/null @@ -1,92 +0,0 @@ -#!/usr/bin/env python3 -# Copyright 2026 Firefly Software Solutions Inc -# -# Licensed under the Apache License, Version 2.0 (the "License"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. - -"""Build and bundle the Firefly Studio frontend into the Python package. - -Usage:: - - python scripts/build_studio.py - -This script: -1. Runs ``npm run build`` in ``studio-frontend/`` -2. Copies the build output to ``src/fireflyframework_genai/studio/static/`` -3. The server then serves these files via FastAPI's StaticFiles mount. -""" - -from __future__ import annotations - -import shutil -import subprocess -import sys -from pathlib import Path - -# Resolve paths relative to the repository root. -REPO_ROOT = Path(__file__).resolve().parent.parent -FRONTEND_DIR = REPO_ROOT / "studio-frontend" -BUILD_DIR = FRONTEND_DIR / "build" -STATIC_DIR = REPO_ROOT / "src" / "fireflyframework_genai" / "studio" / "static" - - -def main() -> None: - """Build the frontend and copy to the static directory.""" - # 1. Install dependencies if needed - if not (FRONTEND_DIR / "node_modules").exists(): - print("Installing frontend dependencies...") - subprocess.run( - ["npm", "install"], - cwd=FRONTEND_DIR, - check=True, - ) - - # 2. Build the frontend - print("Building Studio frontend...") - subprocess.run( - ["npm", "run", "build"], - cwd=FRONTEND_DIR, - check=True, - ) - - if not BUILD_DIR.exists(): - print("ERROR: Build directory not found at", BUILD_DIR, file=sys.stderr) - sys.exit(1) - - # 3. Clear existing static files (except .gitkeep) - if STATIC_DIR.exists(): - for item in STATIC_DIR.iterdir(): - if item.name == ".gitkeep": - continue - if item.is_dir(): - shutil.rmtree(item) - else: - item.unlink() - - # 4. Copy build output to static directory - print(f"Copying build output to {STATIC_DIR}...") - STATIC_DIR.mkdir(parents=True, exist_ok=True) - for item in BUILD_DIR.iterdir(): - dest = STATIC_DIR / item.name - if item.is_dir(): - shutil.copytree(item, dest) - else: - shutil.copy2(item, dest) - - # Count files - file_count = sum(1 for _ in STATIC_DIR.rglob("*") if _.is_file() and _.name != ".gitkeep") - print(f"Bundled {file_count} files into {STATIC_DIR}") - print("Done! The Studio frontend is now bundled into the Python package.") - - -if __name__ == "__main__": - main() diff --git a/src/fireflyframework_genai/__init__.py b/src/fireflyframework_agentic/__init__.py similarity index 80% rename from src/fireflyframework_genai/__init__.py rename to src/fireflyframework_agentic/__init__.py index 2430c4f4..aa79d572 100644 --- a/src/fireflyframework_genai/__init__.py +++ b/src/fireflyframework_agentic/__init__.py @@ -12,7 +12,7 @@ # See the License for the specific language governing permissions and # limitations under the License. -"""Firefly GenAI Framework -- A metaframework built on Pydantic AI. +"""Firefly Agentic Framework -- A metaframework built on Pydantic AI. This package provides production-grade abstractions for building GenAI applications including agents, reasoning patterns, prompt engineering, @@ -21,16 +21,16 @@ Quick start:: - from fireflyframework_genai import FireflyGenAIConfig, get_config + from fireflyframework_agentic import FireflyAgenticConfig, get_config config = get_config() print(config.default_model) """ -from fireflyframework_genai._version import __version__ -from fireflyframework_genai.config import FireflyGenAIConfig, get_config, reset_config -from fireflyframework_genai.embeddings import BaseEmbedder, EmbedderRegistry, EmbeddingProtocol -from fireflyframework_genai.exceptions import ( +from fireflyframework_agentic._version import __version__ +from fireflyframework_agentic.config import FireflyAgenticConfig, get_config, reset_config +from fireflyframework_agentic.embeddings import BaseEmbedder, EmbedderRegistry, EmbeddingProtocol +from fireflyframework_agentic.exceptions import ( AgentError, AgentNotFoundError, BudgetExceededError, @@ -45,7 +45,7 @@ ExperimentError, ExplainabilityError, ExposureError, - FireflyGenAIError, + FireflyAgenticError, FireflyMemoryError, MemoryError, ObservabilityError, @@ -69,9 +69,9 @@ VectorStoreConnectionError, VectorStoreError, ) -from fireflyframework_genai.logging import configure_logging, enable_debug -from fireflyframework_genai.plugin import PluginDiscovery -from fireflyframework_genai.types import ( +from fireflyframework_agentic.logging import configure_logging, enable_debug +from fireflyframework_agentic.plugin import PluginDiscovery +from fireflyframework_agentic.types import ( JSON, AgentDepsT, AgentLike, @@ -89,14 +89,14 @@ UserPrompt, VideoUrl, ) -from fireflyframework_genai.vectorstores import BaseVectorStore, InMemoryVectorStore, VectorStoreProtocol +from fireflyframework_agentic.vectorstores import BaseVectorStore, InMemoryVectorStore, VectorStoreProtocol __all__ = [ "__version__", - "FireflyGenAIConfig", + "FireflyAgenticConfig", "get_config", "reset_config", - "FireflyGenAIError", + "FireflyAgenticError", "FireflyMemoryError", "ConfigurationError", "AgentError", diff --git a/src/fireflyframework_genai/_version.py b/src/fireflyframework_agentic/_version.py similarity index 91% rename from src/fireflyframework_genai/_version.py rename to src/fireflyframework_agentic/_version.py index ef8e6e98..94af8f56 100644 --- a/src/fireflyframework_genai/_version.py +++ b/src/fireflyframework_agentic/_version.py @@ -12,6 +12,6 @@ # See the License for the specific language governing permissions and # limitations under the License. -"""Version information for fireflyframework-genai.""" +"""Version information for fireflyframework-agentic.""" __version__ = "26.02.06" diff --git a/src/fireflyframework_genai/agents/__init__.py b/src/fireflyframework_agentic/agents/__init__.py similarity index 73% rename from src/fireflyframework_genai/agents/__init__.py rename to src/fireflyframework_agentic/agents/__init__.py index ee169c7e..b86cbc0f 100644 --- a/src/fireflyframework_genai/agents/__init__.py +++ b/src/fireflyframework_agentic/agents/__init__.py @@ -14,8 +14,8 @@ """Agents subpackage -- creation, registration, lifecycle, and delegation.""" -from fireflyframework_genai.agents.base import FireflyAgent -from fireflyframework_genai.agents.builtin_middleware import ( +from fireflyframework_agentic.agents.base import FireflyAgent +from fireflyframework_agentic.agents.builtin_middleware import ( BudgetExceededError, CacheMiddleware, CostGuardMiddleware, @@ -29,10 +29,10 @@ RetryMiddleware, ValidationMiddleware, ) -from fireflyframework_genai.agents.cache import ResultCache -from fireflyframework_genai.agents.context import AgentContext -from fireflyframework_genai.agents.decorators import firefly_agent -from fireflyframework_genai.agents.delegation import ( +from fireflyframework_agentic.agents.cache import ResultCache +from fireflyframework_agentic.agents.context import AgentContext +from fireflyframework_agentic.agents.decorators import firefly_agent +from fireflyframework_agentic.agents.delegation import ( CapabilityStrategy, ContentBasedStrategy, CostAwareStrategy, @@ -40,16 +40,16 @@ DelegationStrategy, RoundRobinStrategy, ) -from fireflyframework_genai.agents.fallback import FallbackModelWrapper, run_with_fallback -from fireflyframework_genai.agents.lifecycle import AgentLifecycle, agent_lifecycle -from fireflyframework_genai.agents.middleware import ( +from fireflyframework_agentic.agents.fallback import FallbackModelWrapper, run_with_fallback +from fireflyframework_agentic.agents.lifecycle import AgentLifecycle, agent_lifecycle +from fireflyframework_agentic.agents.middleware import ( AgentMiddleware, MiddlewareChain, MiddlewareContext, ) -from fireflyframework_genai.agents.prompt_cache import CacheStatistics, PromptCacheMiddleware -from fireflyframework_genai.agents.registry import AgentInfo, AgentRegistry, agent_registry -from fireflyframework_genai.agents.templates import ( +from fireflyframework_agentic.agents.prompt_cache import CacheStatistics, PromptCacheMiddleware +from fireflyframework_agentic.agents.registry import AgentInfo, AgentRegistry, agent_registry +from fireflyframework_agentic.agents.templates import ( create_classifier_agent, create_conversational_agent, create_extractor_agent, diff --git a/src/fireflyframework_genai/agents/base.py b/src/fireflyframework_agentic/agents/base.py similarity index 92% rename from src/fireflyframework_genai/agents/base.py rename to src/fireflyframework_agentic/agents/base.py index 96f868e6..7b8aa435 100644 --- a/src/fireflyframework_genai/agents/base.py +++ b/src/fireflyframework_agentic/agents/base.py @@ -12,13 +12,13 @@ # See the License for the specific language governing permissions and # limitations under the License. -"""FireflyAgent -- the primary agent abstraction in the Firefly GenAI framework. +"""FireflyAgent -- the primary agent abstraction in the Firefly Agentic framework. :class:`FireflyAgent` wraps :class:`pydantic_ai.Agent` and enriches it with framework-level concerns: metadata (name, version, tags), automatic -registration in the :class:`~fireflyframework_genai.agents.registry.AgentRegistry`, +registration in the :class:`~fireflyframework_agentic.agents.registry.AgentRegistry`, lifecycle hooks, and sensible defaults drawn from -:class:`~fireflyframework_genai.config.FireflyGenAIConfig`. +:class:`~fireflyframework_agentic.config.FireflyAgenticConfig`. """ from __future__ import annotations @@ -34,13 +34,13 @@ from pydantic_ai.models import Model from pydantic_ai.settings import ModelSettings -from fireflyframework_genai.config import get_config -from fireflyframework_genai.types import AgentDepsT, Metadata, OutputT, UserContent +from fireflyframework_agentic.config import get_config +from fireflyframework_agentic.types import AgentDepsT, Metadata, OutputT, UserContent if TYPE_CHECKING: - from fireflyframework_genai.agents.context import AgentContext - from fireflyframework_genai.agents.middleware import AgentMiddleware, MiddlewareChain - from fireflyframework_genai.memory.manager import MemoryManager + from fireflyframework_agentic.agents.context import AgentContext + from fireflyframework_agentic.agents.middleware import AgentMiddleware, MiddlewareChain + from fireflyframework_agentic.memory.manager import MemoryManager logger = logging.getLogger(__name__) @@ -72,7 +72,7 @@ class FireflyAgent(Generic[AgentDepsT, OutputT]): * **Metadata** -- name, version, description, tags, and arbitrary metadata for discovery and documentation. * **Convention defaults** -- the default model and retry count are pulled - from :func:`~fireflyframework_genai.config.get_config` when not + from :func:`~fireflyframework_agentic.config.get_config` when not explicitly provided. * **Decorator proxies** -- :meth:`tool`, :meth:`tool_plain`, and :meth:`instructions` delegate to the underlying agent so that the @@ -83,7 +83,7 @@ class FireflyAgent(Generic[AgentDepsT, OutputT]): model: A Pydantic AI model string (e.g. ``"openai:gpt-4o"``) or a pre-configured :class:`pydantic_ai.models.Model` instance for programmatic credential management. Defaults to the value in - :class:`FireflyGenAIConfig`. + :class:`FireflyAgenticConfig`. instructions: Static instruction text or sequence of texts. output_type: The Pydantic model (or scalar type) for structured output. deps_type: The dependency type expected at run time. @@ -137,13 +137,13 @@ def __init__( resolved_retries = retries if retries is not None else cfg.max_retries # Keep the original model identifier for cost tracking. - from fireflyframework_genai.model_utils import get_model_identifier + from fireflyframework_agentic.model_utils import get_model_identifier self._model_identifier: str = get_model_identifier(resolved_model) self._memory = memory - from fireflyframework_genai.agents.middleware import MiddlewareChain + from fireflyframework_agentic.agents.middleware import MiddlewareChain self._middleware = MiddlewareChain(self._build_middleware(middleware, default_middleware=default_middleware)) @@ -163,7 +163,7 @@ def __init__( ) if auto_register: - from fireflyframework_genai.agents.registry import agent_registry + from fireflyframework_agentic.agents.registry import agent_registry agent_registry.register(self) logger.debug("Auto-registered agent '%s' v%s", name, version) @@ -229,7 +229,7 @@ async def run( """Run the agent asynchronously. *prompt* can be a plain string, a sequence of multimodal - :class:`~fireflyframework_genai.types.UserContent` parts (text, + :class:`~fireflyframework_agentic.types.UserContent` parts (text, images, documents, audio, video, binary data), or ``None``. When a :class:`MemoryManager` is attached and *conversation_id* @@ -238,8 +238,8 @@ async def run( Delegates to ``pydantic_ai.Agent.run``. """ - from fireflyframework_genai.agents.context import AgentContext as _AgentContext - from fireflyframework_genai.agents.middleware import MiddlewareContext + from fireflyframework_agentic.agents.context import AgentContext as _AgentContext + from fireflyframework_agentic.agents.middleware import MiddlewareContext if context is None: context = _AgentContext() @@ -283,8 +283,8 @@ def run_sync( **kwargs: Any, ) -> Any: """Run the agent synchronously. Delegates to ``pydantic_ai.Agent.run_sync``.""" - from fireflyframework_genai.agents.context import AgentContext as _AgentContext - from fireflyframework_genai.agents.middleware import MiddlewareContext + from fireflyframework_agentic.agents.context import AgentContext as _AgentContext + from fireflyframework_agentic.agents.middleware import MiddlewareContext if context is None: context = _AgentContext() @@ -339,8 +339,8 @@ async def run_stream( - "buffered" (default): Stream in chunks/messages (backward compatible) - "incremental": True token-by-token streaming with minimal latency """ - from fireflyframework_genai.agents.context import AgentContext as _AgentContext - from fireflyframework_genai.agents.middleware import MiddlewareContext + from fireflyframework_agentic.agents.context import AgentContext as _AgentContext + from fireflyframework_agentic.agents.middleware import MiddlewareContext if streaming_mode not in ("buffered", "incremental"): raise ValueError(f"Invalid streaming_mode: {streaming_mode!r}. Expected 'buffered' or 'incremental'.") @@ -431,8 +431,8 @@ def _record_usage( if usage is None: return - from fireflyframework_genai.observability.cost import get_cost_calculator - from fireflyframework_genai.observability.usage import UsageRecord, default_usage_tracker + from fireflyframework_agentic.observability.cost import get_cost_calculator + from fireflyframework_agentic.observability.usage import UsageRecord, default_usage_tracker input_tokens = getattr(usage, "input_tokens", 0) or 0 output_tokens = getattr(usage, "output_tokens", 0) or 0 @@ -493,9 +493,9 @@ async def run_with_reasoning( Returns: A :class:`ReasoningResult` produced by the pattern. """ - from fireflyframework_genai.agents.context import AgentContext as _AgentContext - from fireflyframework_genai.agents.middleware import MiddlewareContext - from fireflyframework_genai.reasoning.trace import ReasoningResult + from fireflyframework_agentic.agents.context import AgentContext as _AgentContext + from fireflyframework_agentic.agents.middleware import MiddlewareContext + from fireflyframework_agentic.reasoning.trace import ReasoningResult if context is None: context = _AgentContext() @@ -556,7 +556,7 @@ def _is_rate_limit_error(exc: Exception) -> bool: - Bedrock ``ThrottlingException`` / ``TooManyRequestsException`` - String patterns as a fallback """ - from fireflyframework_genai.exceptions import RateLimitError + from fireflyframework_agentic.exceptions import RateLimitError if isinstance(exc, RateLimitError): return True @@ -584,13 +584,13 @@ async def _run_with_rate_limit_retry( """Execute ``self._agent.run()`` with automatic 429 retry using AdaptiveBackoff. Reads retry parameters from :func:`get_config` and uses the - :class:`~fireflyframework_genai.observability.quota.AdaptiveBackoff` + :class:`~fireflyframework_agentic.observability.quota.AdaptiveBackoff` instance on the default :class:`QuotaManager` when quota is enabled, or creates a standalone backoff otherwise. """ import re - from fireflyframework_genai.observability.quota import ( + from fireflyframework_agentic.observability.quota import ( AdaptiveBackoff, default_quota_manager, ) @@ -659,7 +659,7 @@ def _build_middleware( :class:`ObservabilityMiddleware` to the chain unless the user already supplied one. """ - from fireflyframework_genai.agents.builtin_middleware import ( + from fireflyframework_agentic.agents.builtin_middleware import ( LoggingMiddleware, ObservabilityMiddleware, ) @@ -687,16 +687,16 @@ def _build_middleware( def _resolve_tools(tools: Sequence[Any]) -> list[Any]: """Convert framework tool types into Pydantic AI tool objects. - * :class:`~fireflyframework_genai.tools.base.BaseTool` instances are + * :class:`~fireflyframework_agentic.tools.base.BaseTool` instances are wrapped in :class:`pydantic_ai.Tool` so their ``execute`` method is called by the underlying agent. - * :class:`~fireflyframework_genai.tools.toolkit.ToolKit` instances are + * :class:`~fireflyframework_agentic.tools.toolkit.ToolKit` instances are expanded via :meth:`~ToolKit.as_pydantic_tools`. * Everything else (plain functions, ``pydantic_ai.Tool`` objects) is passed through unchanged. """ - from fireflyframework_genai.tools.base import BaseTool - from fireflyframework_genai.tools.toolkit import ToolKit + from fireflyframework_agentic.tools.base import BaseTool + from fireflyframework_agentic.tools.toolkit import ToolKit resolved: list[Any] = [] for item in tools: diff --git a/src/fireflyframework_genai/agents/builtin_middleware.py b/src/fireflyframework_agentic/agents/builtin_middleware.py similarity index 93% rename from src/fireflyframework_genai/agents/builtin_middleware.py rename to src/fireflyframework_agentic/agents/builtin_middleware.py index 51ddc14e..dcfa18f8 100644 --- a/src/fireflyframework_genai/agents/builtin_middleware.py +++ b/src/fireflyframework_agentic/agents/builtin_middleware.py @@ -24,7 +24,7 @@ Usage:: - from fireflyframework_genai.agents.builtin_middleware import ( + from fireflyframework_agentic.agents.builtin_middleware import ( LoggingMiddleware, PromptGuardMiddleware, CostGuardMiddleware, @@ -44,7 +44,7 @@ import time from typing import Any -from fireflyframework_genai.agents.middleware import MiddlewareContext +from fireflyframework_agentic.agents.middleware import MiddlewareContext logger = logging.getLogger(__name__) @@ -75,8 +75,8 @@ class LoggingMiddleware: ``after_run`` with elapsed time, token count, and estimated cost. The middleware uses the standard Python logger under the - ``fireflyframework_genai`` hierarchy so that - :func:`~fireflyframework_genai.logging.configure_logging` controls + ``fireflyframework_agentic`` hierarchy so that + :func:`~fireflyframework_agentic.logging.configure_logging` controls its output (including the ``colored`` and ``json`` format styles). Parameters: @@ -173,7 +173,7 @@ class PromptGuardMiddleware: replaced with ``[REDACTED]``) and execution continues. Parameters: - guard: A :class:`~fireflyframework_genai.security.prompt_guard.PromptGuard` + guard: A :class:`~fireflyframework_agentic.security.prompt_guard.PromptGuard` instance. Defaults to the module-level ``default_prompt_guard``. sanitise: When *True*, sanitise the prompt instead of rejecting. """ @@ -187,7 +187,7 @@ def __init__( if guard is not None: self._guard = guard else: - from fireflyframework_genai.security.prompt_guard import PromptGuard + from fireflyframework_agentic.security.prompt_guard import PromptGuard self._guard = PromptGuard(sanitise=sanitise) self._sanitise = sanitise @@ -255,7 +255,7 @@ def __init__( def _get_tracker(self) -> Any: if self._tracker is not None: return self._tracker - from fireflyframework_genai.observability.usage import default_usage_tracker + from fireflyframework_agentic.observability.usage import default_usage_tracker return default_usage_tracker @@ -309,7 +309,7 @@ async def before_run(self, context: MiddlewareContext) -> None: """Open an OTel span and emit the agent-started event.""" from opentelemetry import trace as _trace - tracer = _trace.get_tracer("fireflyframework_genai") + tracer = _trace.get_tracer("fireflyframework_agentic") span = tracer.start_span( f"agent.{context.agent_name}", attributes={ @@ -320,7 +320,7 @@ async def before_run(self, context: MiddlewareContext) -> None: context.metadata["_otel_span"] = span context.metadata["_obs_t0"] = time.monotonic() - from fireflyframework_genai.observability.events import default_events + from fireflyframework_agentic.observability.events import default_events default_events.agent_started(context.agent_name) @@ -341,7 +341,7 @@ async def after_run(self, context: MiddlewareContext, result: Any) -> Any: if usage is not None: tokens = getattr(usage, "total_tokens", 0) or 0 - from fireflyframework_genai.observability.metrics import default_metrics + from fireflyframework_agentic.observability.metrics import default_metrics default_metrics.record_latency( elapsed_ms, @@ -365,7 +365,7 @@ class ExplainabilityMiddleware: """Records decision traces for explainability and audit. Captures :class:`DecisionRecord` entries via the - :class:`~fireflyframework_genai.explainability.trace_recorder.TraceRecorder`. + :class:`~fireflyframework_agentic.explainability.trace_recorder.TraceRecorder`. Unlike :class:`ObservabilityMiddleware`, this middleware is **not** auto-wired. Enable it explicitly via the agent's ``middleware`` list. @@ -381,7 +381,7 @@ def __init__(self, *, recorder: Any | None = None) -> None: def _get_recorder(self) -> Any: if self._recorder is not None: return self._recorder - from fireflyframework_genai.explainability.trace_recorder import ( + from fireflyframework_agentic.explainability.trace_recorder import ( default_trace_recorder, ) @@ -420,7 +420,7 @@ class CacheMiddleware: agent run can be skipped. On ``after_run``, stores the result on miss. Parameters: - cache: A :class:`~fireflyframework_genai.agents.cache.ResultCache`. + cache: A :class:`~fireflyframework_agentic.agents.cache.ResultCache`. """ def __init__(self, *, cache: Any) -> None: @@ -453,7 +453,7 @@ class OutputGuardMiddleware: matched fragments with ``[REDACTED]``. Parameters: - guard: An :class:`~fireflyframework_genai.security.output_guard.OutputGuard` + guard: An :class:`~fireflyframework_agentic.security.output_guard.OutputGuard` instance. Defaults to the module-level ``default_output_guard``. sanitise: When *True*, sanitise the output instead of rejecting. block_categories: Only block on these categories (e.g. ``["secrets", "pii"]``). @@ -470,7 +470,7 @@ def __init__( if guard is not None: self._guard = guard else: - from fireflyframework_genai.security.output_guard import OutputGuard + from fireflyframework_agentic.security.output_guard import OutputGuard self._guard = OutputGuard(sanitise=sanitise) self._sanitise = sanitise @@ -522,7 +522,7 @@ class ValidationMiddleware: After the agent runs, the output is parsed and validated without re-running the agent. If validation fails, an - :class:`~fireflyframework_genai.exceptions.OutputReviewError` is raised. + :class:`~fireflyframework_agentic.exceptions.OutputReviewError` is raised. Parameters: reviewer: An :class:`OutputReviewer` whose parsing and validation @@ -541,7 +541,7 @@ async def after_run(self, context: MiddlewareContext, result: Any) -> Any: parsed, parse_errors = self._reviewer._parse_output(raw) if parse_errors: - from fireflyframework_genai.exceptions import OutputReviewError + from fireflyframework_agentic.exceptions import OutputReviewError raise OutputReviewError(f"Output validation failed: {parse_errors}") @@ -549,7 +549,7 @@ async def after_run(self, context: MiddlewareContext, result: Any) -> Any: report = self._reviewer._validate_output(validated) if report is not None and not report.valid: rule_errors = [r.message for r in report.errors if r.message] - from fireflyframework_genai.exceptions import OutputReviewError + from fireflyframework_agentic.exceptions import OutputReviewError raise OutputReviewError(f"Validation rules failed: {rule_errors}") diff --git a/src/fireflyframework_genai/agents/cache.py b/src/fireflyframework_agentic/agents/cache.py similarity index 98% rename from src/fireflyframework_genai/agents/cache.py rename to src/fireflyframework_agentic/agents/cache.py index 37a87d69..55901e28 100644 --- a/src/fireflyframework_genai/agents/cache.py +++ b/src/fireflyframework_agentic/agents/cache.py @@ -16,7 +16,7 @@ Usage:: - from fireflyframework_genai.agents.cache import ResultCache + from fireflyframework_agentic.agents.cache import ResultCache cache = ResultCache(ttl_seconds=300, max_size=100) cached = cache.get("openai:gpt-4o", "summarise this text") diff --git a/src/fireflyframework_genai/agents/context.py b/src/fireflyframework_agentic/agents/context.py similarity index 100% rename from src/fireflyframework_genai/agents/context.py rename to src/fireflyframework_agentic/agents/context.py diff --git a/src/fireflyframework_genai/agents/decorators.py b/src/fireflyframework_agentic/agents/decorators.py similarity index 94% rename from src/fireflyframework_genai/agents/decorators.py rename to src/fireflyframework_agentic/agents/decorators.py index af926e7f..90c45373 100644 --- a/src/fireflyframework_genai/agents/decorators.py +++ b/src/fireflyframework_agentic/agents/decorators.py @@ -32,12 +32,12 @@ def summariser_instructions(ctx): from pydantic_ai.models import Model -from fireflyframework_genai.agents.base import FireflyAgent -from fireflyframework_genai.types import Metadata +from fireflyframework_agentic.agents.base import FireflyAgent +from fireflyframework_agentic.types import Metadata if TYPE_CHECKING: - from fireflyframework_genai.agents.middleware import AgentMiddleware - from fireflyframework_genai.memory.manager import MemoryManager + from fireflyframework_agentic.agents.middleware import AgentMiddleware + from fireflyframework_agentic.memory.manager import MemoryManager def firefly_agent( diff --git a/src/fireflyframework_genai/agents/delegation.py b/src/fireflyframework_agentic/agents/delegation.py similarity index 97% rename from src/fireflyframework_genai/agents/delegation.py rename to src/fireflyframework_agentic/agents/delegation.py index 6c192329..d7070901 100644 --- a/src/fireflyframework_genai/agents/delegation.py +++ b/src/fireflyframework_agentic/agents/delegation.py @@ -27,12 +27,12 @@ from collections.abc import Sequence from typing import TYPE_CHECKING, Any, Protocol, runtime_checkable -from fireflyframework_genai.exceptions import DelegationError -from fireflyframework_genai.types import UserContent +from fireflyframework_agentic.exceptions import DelegationError +from fireflyframework_agentic.types import UserContent if TYPE_CHECKING: - from fireflyframework_genai.agents.base import FireflyAgent - from fireflyframework_genai.memory.manager import MemoryManager + from fireflyframework_agentic.agents.base import FireflyAgent + from fireflyframework_agentic.memory.manager import MemoryManager logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/agents/fallback.py b/src/fireflyframework_agentic/agents/fallback.py similarity index 97% rename from src/fireflyframework_genai/agents/fallback.py rename to src/fireflyframework_agentic/agents/fallback.py index 3775a5ee..aea36d92 100644 --- a/src/fireflyframework_genai/agents/fallback.py +++ b/src/fireflyframework_agentic/agents/fallback.py @@ -20,7 +20,7 @@ Usage:: - from fireflyframework_genai.agents.fallback import FallbackModelWrapper + from fireflyframework_agentic.agents.fallback import FallbackModelWrapper wrapper = FallbackModelWrapper( models=["openai:gpt-4o", "openai:gpt-4o-mini", "openai:gpt-3.5-turbo"], @@ -125,7 +125,7 @@ async def run_with_fallback( Raises: The last exception encountered if all models fail. """ - from fireflyframework_genai.model_utils import get_model_identifier + from fireflyframework_agentic.model_utils import get_model_identifier fallback.reset() original_model = agent.agent.model diff --git a/src/fireflyframework_genai/agents/lifecycle.py b/src/fireflyframework_agentic/agents/lifecycle.py similarity index 100% rename from src/fireflyframework_genai/agents/lifecycle.py rename to src/fireflyframework_agentic/agents/lifecycle.py diff --git a/src/fireflyframework_genai/agents/middleware.py b/src/fireflyframework_agentic/agents/middleware.py similarity index 100% rename from src/fireflyframework_genai/agents/middleware.py rename to src/fireflyframework_agentic/agents/middleware.py diff --git a/src/fireflyframework_genai/agents/prompt_cache.py b/src/fireflyframework_agentic/agents/prompt_cache.py similarity index 98% rename from src/fireflyframework_genai/agents/prompt_cache.py rename to src/fireflyframework_agentic/agents/prompt_cache.py index 4ff5adf1..2e395c12 100644 --- a/src/fireflyframework_genai/agents/prompt_cache.py +++ b/src/fireflyframework_agentic/agents/prompt_cache.py @@ -28,7 +28,7 @@ Example:: - from fireflyframework_genai.agents.prompt_cache import PromptCacheMiddleware + from fireflyframework_agentic.agents.prompt_cache import PromptCacheMiddleware agent = FireflyAgent( "document-qa", @@ -147,7 +147,7 @@ async def before_run(self, context: Any) -> None: if not model: return - from fireflyframework_genai.model_utils import detect_model_family + from fireflyframework_agentic.model_utils import detect_model_family family = detect_model_family(model) if family == "anthropic": diff --git a/src/fireflyframework_genai/agents/registry.py b/src/fireflyframework_agentic/agents/registry.py similarity index 96% rename from src/fireflyframework_genai/agents/registry.py rename to src/fireflyframework_agentic/agents/registry.py index 32592ca2..2cfcdaba 100644 --- a/src/fireflyframework_genai/agents/registry.py +++ b/src/fireflyframework_agentic/agents/registry.py @@ -22,10 +22,10 @@ from pydantic import BaseModel -from fireflyframework_genai.exceptions import AgentNotFoundError +from fireflyframework_agentic.exceptions import AgentNotFoundError if TYPE_CHECKING: - from fireflyframework_genai.agents.base import FireflyAgent + from fireflyframework_agentic.agents.base import FireflyAgent logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/agents/templates/__init__.py b/src/fireflyframework_agentic/agents/templates/__init__.py similarity index 70% rename from src/fireflyframework_genai/agents/templates/__init__.py rename to src/fireflyframework_agentic/agents/templates/__init__.py index ef0c8f5a..9ace7ebd 100644 --- a/src/fireflyframework_genai/agents/templates/__init__.py +++ b/src/fireflyframework_agentic/agents/templates/__init__.py @@ -19,11 +19,11 @@ Users can customise model, instructions, and behaviour via keyword arguments. """ -from fireflyframework_genai.agents.templates.classifier import create_classifier_agent -from fireflyframework_genai.agents.templates.conversational import create_conversational_agent -from fireflyframework_genai.agents.templates.extractor import create_extractor_agent -from fireflyframework_genai.agents.templates.router import create_router_agent -from fireflyframework_genai.agents.templates.summarizer import create_summarizer_agent +from fireflyframework_agentic.agents.templates.classifier import create_classifier_agent +from fireflyframework_agentic.agents.templates.conversational import create_conversational_agent +from fireflyframework_agentic.agents.templates.extractor import create_extractor_agent +from fireflyframework_agentic.agents.templates.router import create_router_agent +from fireflyframework_agentic.agents.templates.summarizer import create_summarizer_agent __all__ = [ "create_classifier_agent", diff --git a/src/fireflyframework_genai/agents/templates/classifier.py b/src/fireflyframework_agentic/agents/templates/classifier.py similarity index 98% rename from src/fireflyframework_genai/agents/templates/classifier.py rename to src/fireflyframework_agentic/agents/templates/classifier.py index 0db28071..c86852f2 100644 --- a/src/fireflyframework_genai/agents/templates/classifier.py +++ b/src/fireflyframework_agentic/agents/templates/classifier.py @@ -26,7 +26,7 @@ from pydantic import BaseModel, Field from pydantic_ai.models import Model -from fireflyframework_genai.agents.base import FireflyAgent +from fireflyframework_agentic.agents.base import FireflyAgent class ClassificationResult(BaseModel): diff --git a/src/fireflyframework_genai/agents/templates/conversational.py b/src/fireflyframework_agentic/agents/templates/conversational.py similarity index 90% rename from src/fireflyframework_genai/agents/templates/conversational.py rename to src/fireflyframework_agentic/agents/templates/conversational.py index ec2256f1..32ad5d71 100644 --- a/src/fireflyframework_genai/agents/templates/conversational.py +++ b/src/fireflyframework_agentic/agents/templates/conversational.py @@ -25,17 +25,17 @@ from pydantic_ai.models import Model -from fireflyframework_genai.agents.base import FireflyAgent +from fireflyframework_agentic.agents.base import FireflyAgent if TYPE_CHECKING: - from fireflyframework_genai.memory.manager import MemoryManager + from fireflyframework_agentic.memory.manager import MemoryManager def _default_conversational_tools() -> list[Any]: """Lazily instantiate built-in tools useful for conversation.""" - from fireflyframework_genai.tools.builtins.calculator_tool import CalculatorTool - from fireflyframework_genai.tools.builtins.datetime_tool import DateTimeTool - from fireflyframework_genai.tools.builtins.text_tool import TextTool + from fireflyframework_agentic.tools.builtins.calculator_tool import CalculatorTool + from fireflyframework_agentic.tools.builtins.datetime_tool import DateTimeTool + from fireflyframework_agentic.tools.builtins.text_tool import TextTool return [DateTimeTool(), CalculatorTool(), TextTool()] diff --git a/src/fireflyframework_genai/agents/templates/extractor.py b/src/fireflyframework_agentic/agents/templates/extractor.py similarity index 93% rename from src/fireflyframework_genai/agents/templates/extractor.py rename to src/fireflyframework_agentic/agents/templates/extractor.py index c6c0d519..e9ab4bb9 100644 --- a/src/fireflyframework_genai/agents/templates/extractor.py +++ b/src/fireflyframework_agentic/agents/templates/extractor.py @@ -25,14 +25,14 @@ from pydantic_ai.models import Model -from fireflyframework_genai.agents.base import FireflyAgent -from fireflyframework_genai.types import OutputT +from fireflyframework_agentic.agents.base import FireflyAgent +from fireflyframework_agentic.types import OutputT def _default_extractor_tools() -> list[Any]: """Lazily instantiate built-in tools useful for extraction.""" - from fireflyframework_genai.tools.builtins.json_tool import JsonTool - from fireflyframework_genai.tools.builtins.text_tool import TextTool + from fireflyframework_agentic.tools.builtins.json_tool import JsonTool + from fireflyframework_agentic.tools.builtins.text_tool import TextTool return [JsonTool(), TextTool()] diff --git a/src/fireflyframework_genai/agents/templates/router.py b/src/fireflyframework_agentic/agents/templates/router.py similarity index 98% rename from src/fireflyframework_genai/agents/templates/router.py rename to src/fireflyframework_agentic/agents/templates/router.py index 3d804f4e..0a4ab280 100644 --- a/src/fireflyframework_genai/agents/templates/router.py +++ b/src/fireflyframework_agentic/agents/templates/router.py @@ -27,7 +27,7 @@ from pydantic import BaseModel, Field from pydantic_ai.models import Model -from fireflyframework_genai.agents.base import FireflyAgent +from fireflyframework_agentic.agents.base import FireflyAgent class RoutingDecision(BaseModel): diff --git a/src/fireflyframework_genai/agents/templates/summarizer.py b/src/fireflyframework_agentic/agents/templates/summarizer.py similarity index 96% rename from src/fireflyframework_genai/agents/templates/summarizer.py rename to src/fireflyframework_agentic/agents/templates/summarizer.py index 1978a3f0..416a66f3 100644 --- a/src/fireflyframework_genai/agents/templates/summarizer.py +++ b/src/fireflyframework_agentic/agents/templates/summarizer.py @@ -25,12 +25,12 @@ from pydantic_ai.models import Model -from fireflyframework_genai.agents.base import FireflyAgent +from fireflyframework_agentic.agents.base import FireflyAgent def _default_summarizer_tools() -> list[Any]: """Lazily instantiate built-in tools useful for summarization.""" - from fireflyframework_genai.tools.builtins.text_tool import TextTool + from fireflyframework_agentic.tools.builtins.text_tool import TextTool return [TextTool()] diff --git a/src/fireflyframework_genai/config.py b/src/fireflyframework_agentic/config.py similarity index 95% rename from src/fireflyframework_genai/config.py rename to src/fireflyframework_agentic/config.py index c25c9c6a..7c1c2101 100644 --- a/src/fireflyframework_genai/config.py +++ b/src/fireflyframework_agentic/config.py @@ -12,10 +12,10 @@ # See the License for the specific language governing permissions and # limitations under the License. -"""Central configuration for the Firefly GenAI framework. +"""Central configuration for the Firefly Agentic framework. All configuration values can be overridden via environment variables prefixed -with ``FIREFLY_GENAI_``. For example, setting ``FIREFLY_GENAI_DEFAULT_MODEL`` +with ``FIREFLY_AGENTIC_``. For example, setting ``FIREFLY_AGENTIC_DEFAULT_MODEL`` in the environment will override the ``default_model`` field. """ @@ -28,7 +28,7 @@ from pydantic_settings import BaseSettings, SettingsConfigDict -class FireflyGenAIConfig(BaseSettings): +class FireflyAgenticConfig(BaseSettings): """Framework-wide configuration loaded from environment variables. This configuration object centralises every tunable knob in the framework. @@ -38,7 +38,7 @@ class FireflyGenAIConfig(BaseSettings): """ model_config = SettingsConfigDict( - env_prefix="FIREFLY_GENAI_", + env_prefix="FIREFLY_AGENTIC_", env_file=".env", env_file_encoding="utf-8", extra="ignore", @@ -238,7 +238,7 @@ class FireflyGenAIConfig(BaseSettings): """Default namespace for vector store operations.""" @model_validator(mode="after") - def _validate_cross_fields(self) -> FireflyGenAIConfig: + def _validate_cross_fields(self) -> FireflyAgenticConfig: """Validate cross-field constraints.""" if ( self.budget_alert_threshold_usd is not None @@ -264,17 +264,17 @@ def _validate_cross_fields(self) -> FireflyGenAIConfig: # created exactly once, even under concurrent access from multiple threads. # --------------------------------------------------------------------------- -_config_instance: FireflyGenAIConfig | None = None +_config_instance: FireflyAgenticConfig | None = None _config_lock = threading.Lock() -def get_config() -> FireflyGenAIConfig: - """Return the singleton :class:`FireflyGenAIConfig` instance. Thread-safe.""" +def get_config() -> FireflyAgenticConfig: + """Return the singleton :class:`FireflyAgenticConfig` instance. Thread-safe.""" global _config_instance # noqa: PLW0603 if _config_instance is None: with _config_lock: if _config_instance is None: - _config_instance = FireflyGenAIConfig() + _config_instance = FireflyAgenticConfig() return _config_instance diff --git a/src/fireflyframework_genai/content/__init__.py b/src/fireflyframework_agentic/content/__init__.py similarity index 92% rename from src/fireflyframework_genai/content/__init__.py rename to src/fireflyframework_agentic/content/__init__.py index 7c59cc25..98b9ce91 100644 --- a/src/fireflyframework_genai/content/__init__.py +++ b/src/fireflyframework_agentic/content/__init__.py @@ -19,7 +19,7 @@ chunks through agents in batch. """ -from fireflyframework_genai.content.chunking import ( +from fireflyframework_agentic.content.chunking import ( BatchProcessor, Chunk, Chunker, @@ -27,7 +27,7 @@ ImageTiler, TextChunker, ) -from fireflyframework_genai.content.compression import ( +from fireflyframework_agentic.content.compression import ( CompressionStrategy, ContextCompressor, MapReduceStrategy, diff --git a/src/fireflyframework_genai/content/chunking.py b/src/fireflyframework_agentic/content/chunking.py similarity index 99% rename from src/fireflyframework_genai/content/chunking.py rename to src/fireflyframework_agentic/content/chunking.py index e5f36ff8..fa8f9eea 100644 --- a/src/fireflyframework_genai/content/chunking.py +++ b/src/fireflyframework_agentic/content/chunking.py @@ -29,7 +29,7 @@ from pydantic import BaseModel, Field -from fireflyframework_genai.types import AgentLike +from fireflyframework_agentic.types import AgentLike logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/content/compression.py b/src/fireflyframework_agentic/content/compression.py similarity index 98% rename from src/fireflyframework_genai/content/compression.py rename to src/fireflyframework_agentic/content/compression.py index 753527d2..8a062894 100644 --- a/src/fireflyframework_genai/content/compression.py +++ b/src/fireflyframework_agentic/content/compression.py @@ -24,8 +24,8 @@ from collections import deque from typing import Any, Protocol, runtime_checkable -from fireflyframework_genai.content.chunking import TextChunker -from fireflyframework_genai.types import AgentLike +from fireflyframework_agentic.content.chunking import TextChunker +from fireflyframework_agentic.types import AgentLike logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/embeddings/__init__.py b/src/fireflyframework_agentic/embeddings/__init__.py similarity index 53% rename from src/fireflyframework_genai/embeddings/__init__.py rename to src/fireflyframework_agentic/embeddings/__init__.py index f9629cc8..0aeb1914 100644 --- a/src/fireflyframework_genai/embeddings/__init__.py +++ b/src/fireflyframework_agentic/embeddings/__init__.py @@ -1,13 +1,13 @@ """Embedding generation: protocol, base class, providers, and similarity utilities.""" -from fireflyframework_genai.embeddings.base import BaseEmbedder, EmbeddingProtocol -from fireflyframework_genai.embeddings.registry import EmbedderRegistry -from fireflyframework_genai.embeddings.similarity import ( +from fireflyframework_agentic.embeddings.base import BaseEmbedder, EmbeddingProtocol +from fireflyframework_agentic.embeddings.registry import EmbedderRegistry +from fireflyframework_agentic.embeddings.similarity import ( cosine_similarity, dot_product, euclidean_distance, ) -from fireflyframework_genai.embeddings.types import EmbeddingResult, EmbeddingUsage +from fireflyframework_agentic.embeddings.types import EmbeddingResult, EmbeddingUsage __all__ = [ "BaseEmbedder", diff --git a/src/fireflyframework_genai/embeddings/base.py b/src/fireflyframework_agentic/embeddings/base.py similarity index 94% rename from src/fireflyframework_genai/embeddings/base.py rename to src/fireflyframework_agentic/embeddings/base.py index e605a34b..6537c4c6 100644 --- a/src/fireflyframework_genai/embeddings/base.py +++ b/src/fireflyframework_agentic/embeddings/base.py @@ -15,9 +15,9 @@ from abc import ABC, abstractmethod from typing import Any, Protocol, runtime_checkable -from fireflyframework_genai.config import get_config -from fireflyframework_genai.embeddings.types import EmbeddingResult, EmbeddingUsage -from fireflyframework_genai.exceptions import EmbeddingError +from fireflyframework_agentic.config import get_config +from fireflyframework_agentic.embeddings.types import EmbeddingResult, EmbeddingUsage +from fireflyframework_agentic.exceptions import EmbeddingError logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_agentic/embeddings/providers/__init__.py b/src/fireflyframework_agentic/embeddings/providers/__init__.py new file mode 100644 index 00000000..626b5551 --- /dev/null +++ b/src/fireflyframework_agentic/embeddings/providers/__init__.py @@ -0,0 +1,21 @@ +"""Embedding provider implementations.""" + +from fireflyframework_agentic.embeddings.providers.azure import AzureEmbedder +from fireflyframework_agentic.embeddings.providers.bedrock import BedrockEmbedder +from fireflyframework_agentic.embeddings.providers.cohere import CohereEmbedder +from fireflyframework_agentic.embeddings.providers.google import GoogleEmbedder +from fireflyframework_agentic.embeddings.providers.mistral import MistralEmbedder +from fireflyframework_agentic.embeddings.providers.ollama import OllamaEmbedder +from fireflyframework_agentic.embeddings.providers.openai import OpenAIEmbedder +from fireflyframework_agentic.embeddings.providers.voyage import VoyageEmbedder + +__all__ = [ + "AzureEmbedder", + "BedrockEmbedder", + "CohereEmbedder", + "GoogleEmbedder", + "MistralEmbedder", + "OllamaEmbedder", + "OpenAIEmbedder", + "VoyageEmbedder", +] diff --git a/src/fireflyframework_genai/embeddings/providers/azure.py b/src/fireflyframework_agentic/embeddings/providers/azure.py similarity index 93% rename from src/fireflyframework_genai/embeddings/providers/azure.py rename to src/fireflyframework_agentic/embeddings/providers/azure.py index 6a1bda26..0d70aa9b 100644 --- a/src/fireflyframework_genai/embeddings/providers/azure.py +++ b/src/fireflyframework_agentic/embeddings/providers/azure.py @@ -10,8 +10,8 @@ except ImportError: AsyncAzureOpenAI = None # type: ignore[assignment,misc] -from fireflyframework_genai.embeddings.base import BaseEmbedder -from fireflyframework_genai.exceptions import EmbeddingProviderError +from fireflyframework_agentic.embeddings.base import BaseEmbedder +from fireflyframework_agentic.exceptions import EmbeddingProviderError logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/embeddings/providers/bedrock.py b/src/fireflyframework_agentic/embeddings/providers/bedrock.py similarity index 93% rename from src/fireflyframework_genai/embeddings/providers/bedrock.py rename to src/fireflyframework_agentic/embeddings/providers/bedrock.py index 939c28c5..8b6ca13b 100644 --- a/src/fireflyframework_genai/embeddings/providers/bedrock.py +++ b/src/fireflyframework_agentic/embeddings/providers/bedrock.py @@ -12,8 +12,8 @@ except ImportError: boto3 = None # type: ignore[assignment] -from fireflyframework_genai.embeddings.base import BaseEmbedder -from fireflyframework_genai.exceptions import EmbeddingProviderError +from fireflyframework_agentic.embeddings.base import BaseEmbedder +from fireflyframework_agentic.exceptions import EmbeddingProviderError logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/embeddings/providers/cohere.py b/src/fireflyframework_agentic/embeddings/providers/cohere.py similarity index 93% rename from src/fireflyframework_genai/embeddings/providers/cohere.py rename to src/fireflyframework_agentic/embeddings/providers/cohere.py index 4958b710..f982cc16 100644 --- a/src/fireflyframework_genai/embeddings/providers/cohere.py +++ b/src/fireflyframework_agentic/embeddings/providers/cohere.py @@ -10,8 +10,8 @@ except ImportError: AsyncCohere = None # type: ignore[assignment,misc] -from fireflyframework_genai.embeddings.base import BaseEmbedder -from fireflyframework_genai.exceptions import EmbeddingProviderError +from fireflyframework_agentic.embeddings.base import BaseEmbedder +from fireflyframework_agentic.exceptions import EmbeddingProviderError logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/embeddings/providers/google.py b/src/fireflyframework_agentic/embeddings/providers/google.py similarity index 92% rename from src/fireflyframework_genai/embeddings/providers/google.py rename to src/fireflyframework_agentic/embeddings/providers/google.py index ee5b040b..b42881e5 100644 --- a/src/fireflyframework_genai/embeddings/providers/google.py +++ b/src/fireflyframework_agentic/embeddings/providers/google.py @@ -11,8 +11,8 @@ except ImportError: genai = None # type: ignore[assignment] -from fireflyframework_genai.embeddings.base import BaseEmbedder -from fireflyframework_genai.exceptions import EmbeddingProviderError +from fireflyframework_agentic.embeddings.base import BaseEmbedder +from fireflyframework_agentic.exceptions import EmbeddingProviderError logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/embeddings/providers/mistral.py b/src/fireflyframework_agentic/embeddings/providers/mistral.py similarity index 91% rename from src/fireflyframework_genai/embeddings/providers/mistral.py rename to src/fireflyframework_agentic/embeddings/providers/mistral.py index ba7f45e3..1651ef8b 100644 --- a/src/fireflyframework_genai/embeddings/providers/mistral.py +++ b/src/fireflyframework_agentic/embeddings/providers/mistral.py @@ -10,8 +10,8 @@ except ImportError: Mistral = None # type: ignore[assignment,misc] -from fireflyframework_genai.embeddings.base import BaseEmbedder -from fireflyframework_genai.exceptions import EmbeddingProviderError +from fireflyframework_agentic.embeddings.base import BaseEmbedder +from fireflyframework_agentic.exceptions import EmbeddingProviderError logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/embeddings/providers/ollama.py b/src/fireflyframework_agentic/embeddings/providers/ollama.py similarity index 92% rename from src/fireflyframework_genai/embeddings/providers/ollama.py rename to src/fireflyframework_agentic/embeddings/providers/ollama.py index c6d134c6..38523246 100644 --- a/src/fireflyframework_genai/embeddings/providers/ollama.py +++ b/src/fireflyframework_agentic/embeddings/providers/ollama.py @@ -10,8 +10,8 @@ except ImportError: httpx = None # type: ignore[assignment] -from fireflyframework_genai.embeddings.base import BaseEmbedder -from fireflyframework_genai.exceptions import EmbeddingProviderError +from fireflyframework_agentic.embeddings.base import BaseEmbedder +from fireflyframework_agentic.exceptions import EmbeddingProviderError logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/embeddings/providers/openai.py b/src/fireflyframework_agentic/embeddings/providers/openai.py similarity index 92% rename from src/fireflyframework_genai/embeddings/providers/openai.py rename to src/fireflyframework_agentic/embeddings/providers/openai.py index ae157020..b4df058d 100644 --- a/src/fireflyframework_genai/embeddings/providers/openai.py +++ b/src/fireflyframework_agentic/embeddings/providers/openai.py @@ -7,8 +7,8 @@ from openai import AsyncOpenAI -from fireflyframework_genai.embeddings.base import BaseEmbedder -from fireflyframework_genai.exceptions import EmbeddingProviderError +from fireflyframework_agentic.embeddings.base import BaseEmbedder +from fireflyframework_agentic.exceptions import EmbeddingProviderError logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/embeddings/providers/voyage.py b/src/fireflyframework_agentic/embeddings/providers/voyage.py similarity index 91% rename from src/fireflyframework_genai/embeddings/providers/voyage.py rename to src/fireflyframework_agentic/embeddings/providers/voyage.py index 3fa5e677..8bd6dc09 100644 --- a/src/fireflyframework_genai/embeddings/providers/voyage.py +++ b/src/fireflyframework_agentic/embeddings/providers/voyage.py @@ -10,8 +10,8 @@ except ImportError: voyageai = None # type: ignore[assignment] -from fireflyframework_genai.embeddings.base import BaseEmbedder -from fireflyframework_genai.exceptions import EmbeddingProviderError +from fireflyframework_agentic.embeddings.base import BaseEmbedder +from fireflyframework_agentic.exceptions import EmbeddingProviderError logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/embeddings/registry.py b/src/fireflyframework_agentic/embeddings/registry.py similarity index 90% rename from src/fireflyframework_genai/embeddings/registry.py rename to src/fireflyframework_agentic/embeddings/registry.py index 1dabd462..f941cabe 100644 --- a/src/fireflyframework_genai/embeddings/registry.py +++ b/src/fireflyframework_agentic/embeddings/registry.py @@ -2,7 +2,7 @@ from __future__ import annotations -from fireflyframework_genai.embeddings.base import EmbeddingProtocol +from fireflyframework_agentic.embeddings.base import EmbeddingProtocol class EmbedderRegistry: diff --git a/src/fireflyframework_genai/embeddings/similarity.py b/src/fireflyframework_agentic/embeddings/similarity.py similarity index 100% rename from src/fireflyframework_genai/embeddings/similarity.py rename to src/fireflyframework_agentic/embeddings/similarity.py diff --git a/src/fireflyframework_genai/embeddings/types.py b/src/fireflyframework_agentic/embeddings/types.py similarity index 100% rename from src/fireflyframework_genai/embeddings/types.py rename to src/fireflyframework_agentic/embeddings/types.py diff --git a/src/fireflyframework_genai/exceptions.py b/src/fireflyframework_agentic/exceptions.py similarity index 83% rename from src/fireflyframework_genai/exceptions.py rename to src/fireflyframework_agentic/exceptions.py index a19f0cd9..c8dd253d 100644 --- a/src/fireflyframework_genai/exceptions.py +++ b/src/fireflyframework_agentic/exceptions.py @@ -12,31 +12,31 @@ # See the License for the specific language governing permissions and # limitations under the License. -"""Exception hierarchy for the Firefly GenAI framework. +"""Exception hierarchy for the Firefly Agentic framework. Every module raises exceptions from this hierarchy so that callers can catch -at the granularity they need -- from the broad :class:`FireflyGenAIError` +at the granularity they need -- from the broad :class:`FireflyAgenticError` base to specific leaf exceptions like :class:`ToolGuardError`. """ from __future__ import annotations -class FireflyGenAIError(Exception): - """Base exception for all errors raised by the Firefly GenAI framework.""" +class FireflyAgenticError(Exception): + """Base exception for all errors raised by the Firefly Agentic framework.""" # -- Configuration ----------------------------------------------------------- -class ConfigurationError(FireflyGenAIError): +class ConfigurationError(FireflyAgenticError): """Raised when the framework configuration is invalid or missing.""" # -- Agents ------------------------------------------------------------------ -class AgentError(FireflyGenAIError): +class AgentError(FireflyAgenticError): """Raised for errors during agent creation, registration, or execution.""" @@ -51,7 +51,7 @@ class DelegationError(AgentError): # -- Tools ------------------------------------------------------------------- -class ToolError(FireflyGenAIError): +class ToolError(FireflyAgenticError): """Raised for errors during tool execution.""" @@ -70,7 +70,7 @@ class ToolTimeoutError(ToolError): # -- Prompts ----------------------------------------------------------------- -class PromptError(FireflyGenAIError): +class PromptError(FireflyAgenticError): """Raised for errors in prompt template rendering, validation, or loading.""" @@ -85,7 +85,7 @@ class PromptValidationError(PromptError): # -- Reasoning --------------------------------------------------------------- -class ReasoningError(FireflyGenAIError): +class ReasoningError(FireflyAgenticError): """Raised for errors during reasoning pattern execution.""" @@ -100,28 +100,28 @@ class ReasoningPatternNotFoundError(ReasoningError): # -- Experiments ------------------------------------------------------------- -class ExperimentError(FireflyGenAIError): +class ExperimentError(FireflyAgenticError): """Raised for errors during experiment definition, execution, or tracking.""" # -- Observability ----------------------------------------------------------- -class ObservabilityError(FireflyGenAIError): +class ObservabilityError(FireflyAgenticError): """Raised for errors in tracing, metrics, or event emission.""" # -- Explainability ---------------------------------------------------------- -class ExplainabilityError(FireflyGenAIError): +class ExplainabilityError(FireflyAgenticError): """Raised for errors in trace recording, explanation generation, or audit.""" # -- Exposure ---------------------------------------------------------------- -class ExposureError(FireflyGenAIError): +class ExposureError(FireflyAgenticError): """Raised for errors in REST API or queue-based agent exposure.""" @@ -132,40 +132,40 @@ class QueueConnectionError(ExposureError): # -- Content processing ------------------------------------------------------ -class ChunkingError(FireflyGenAIError): +class ChunkingError(FireflyAgenticError): """Raised for errors during document chunking or splitting.""" -class CompressionError(FireflyGenAIError): +class CompressionError(FireflyAgenticError): """Raised for errors during context compression.""" # -- Validation -------------------------------------------------------------- -class OutputValidationError(FireflyGenAIError): +class OutputValidationError(FireflyAgenticError): """Raised when structured output validation fails.""" -class QoSError(FireflyGenAIError): +class QoSError(FireflyAgenticError): """Raised when output quality falls below QoS thresholds.""" -class OutputReviewError(FireflyGenAIError): +class OutputReviewError(FireflyAgenticError): """Raised when the output reviewer exhausts all retry attempts without producing valid output.""" # -- Pipeline ---------------------------------------------------------------- -class PipelineError(FireflyGenAIError): +class PipelineError(FireflyAgenticError): """Raised for errors during pipeline construction or execution.""" # -- Memory ------------------------------------------------------------------ -class FireflyMemoryError(FireflyGenAIError): +class FireflyMemoryError(FireflyAgenticError): """Raised for errors during memory storage, retrieval, or management.""" @@ -184,7 +184,7 @@ class DatabaseConnectionError(DatabaseStoreError): # -- Quota & Rate Limiting --------------------------------------------------- -class QuotaError(FireflyGenAIError): +class QuotaError(FireflyAgenticError): """Base exception for quota and rate limit errors.""" @@ -199,7 +199,7 @@ class RateLimitError(QuotaError): # -- Embeddings -------------------------------------------------------- -class EmbeddingError(FireflyGenAIError): +class EmbeddingError(FireflyAgenticError): """Raised for errors during embedding generation.""" @@ -210,7 +210,7 @@ class EmbeddingProviderError(EmbeddingError): # -- Vector Stores ----------------------------------------------------- -class VectorStoreError(FireflyGenAIError): +class VectorStoreError(FireflyAgenticError): """Raised for errors during vector store operations.""" diff --git a/src/fireflyframework_genai/experiments/__init__.py b/src/fireflyframework_agentic/experiments/__init__.py similarity index 67% rename from src/fireflyframework_genai/experiments/__init__.py rename to src/fireflyframework_agentic/experiments/__init__.py index 9d0b94b5..32bdaa31 100644 --- a/src/fireflyframework_genai/experiments/__init__.py +++ b/src/fireflyframework_agentic/experiments/__init__.py @@ -14,11 +14,11 @@ """Experiments subpackage -- A/B testing and variant comparison.""" -from fireflyframework_genai.experiments.comparator import ComparisonMetrics, VariantComparator -from fireflyframework_genai.experiments.experiment import Experiment -from fireflyframework_genai.experiments.runner import ExperimentRunner -from fireflyframework_genai.experiments.tracker import ExperimentTracker, VariantResult -from fireflyframework_genai.experiments.variant import Variant +from fireflyframework_agentic.experiments.comparator import ComparisonMetrics, VariantComparator +from fireflyframework_agentic.experiments.experiment import Experiment +from fireflyframework_agentic.experiments.runner import ExperimentRunner +from fireflyframework_agentic.experiments.tracker import ExperimentTracker, VariantResult +from fireflyframework_agentic.experiments.variant import Variant __all__ = [ "ComparisonMetrics", diff --git a/src/fireflyframework_genai/experiments/comparator.py b/src/fireflyframework_agentic/experiments/comparator.py similarity index 96% rename from src/fireflyframework_genai/experiments/comparator.py rename to src/fireflyframework_agentic/experiments/comparator.py index fb47435a..863d6834 100644 --- a/src/fireflyframework_genai/experiments/comparator.py +++ b/src/fireflyframework_agentic/experiments/comparator.py @@ -20,7 +20,7 @@ from pydantic import BaseModel -from fireflyframework_genai.experiments.tracker import VariantResult +from fireflyframework_agentic.experiments.tracker import VariantResult class ComparisonMetrics(BaseModel): diff --git a/src/fireflyframework_genai/experiments/experiment.py b/src/fireflyframework_agentic/experiments/experiment.py similarity index 96% rename from src/fireflyframework_genai/experiments/experiment.py rename to src/fireflyframework_agentic/experiments/experiment.py index a3631195..e5db5fb5 100644 --- a/src/fireflyframework_genai/experiments/experiment.py +++ b/src/fireflyframework_agentic/experiments/experiment.py @@ -21,7 +21,7 @@ from pydantic import BaseModel -from fireflyframework_genai.experiments.variant import Variant +from fireflyframework_agentic.experiments.variant import Variant class Experiment(BaseModel): diff --git a/src/fireflyframework_genai/experiments/runner.py b/src/fireflyframework_agentic/experiments/runner.py similarity index 93% rename from src/fireflyframework_genai/experiments/runner.py rename to src/fireflyframework_agentic/experiments/runner.py index bc31c624..d20c122e 100644 --- a/src/fireflyframework_genai/experiments/runner.py +++ b/src/fireflyframework_agentic/experiments/runner.py @@ -24,8 +24,8 @@ import time from typing import Any -from fireflyframework_genai.experiments.experiment import Experiment -from fireflyframework_genai.experiments.tracker import ExperimentTracker, VariantResult +from fireflyframework_agentic.experiments.experiment import Experiment +from fireflyframework_agentic.experiments.tracker import ExperimentTracker, VariantResult logger = logging.getLogger(__name__) @@ -60,7 +60,7 @@ async def run( Returns: A list of :class:`VariantResult` objects. """ - from fireflyframework_genai.agents.context import AgentContext + from fireflyframework_agentic.agents.context import AgentContext if context is None: context = AgentContext() diff --git a/src/fireflyframework_genai/experiments/tracker.py b/src/fireflyframework_agentic/experiments/tracker.py similarity index 100% rename from src/fireflyframework_genai/experiments/tracker.py rename to src/fireflyframework_agentic/experiments/tracker.py diff --git a/src/fireflyframework_genai/experiments/variant.py b/src/fireflyframework_agentic/experiments/variant.py similarity index 100% rename from src/fireflyframework_genai/experiments/variant.py rename to src/fireflyframework_agentic/experiments/variant.py diff --git a/src/fireflyframework_genai/explainability/__init__.py b/src/fireflyframework_agentic/explainability/__init__.py similarity index 77% rename from src/fireflyframework_genai/explainability/__init__.py rename to src/fireflyframework_agentic/explainability/__init__.py index 1878590d..0f421778 100644 --- a/src/fireflyframework_genai/explainability/__init__.py +++ b/src/fireflyframework_agentic/explainability/__init__.py @@ -14,14 +14,14 @@ """Explainability subpackage -- trace recording, explanations, audit, and reports.""" -from fireflyframework_genai.explainability.audit import AuditEntry, AuditTrail -from fireflyframework_genai.explainability.explanation import ExplanationGenerator -from fireflyframework_genai.explainability.report import ( +from fireflyframework_agentic.explainability.audit import AuditEntry, AuditTrail +from fireflyframework_agentic.explainability.explanation import ExplanationGenerator +from fireflyframework_agentic.explainability.report import ( ExplainabilityReport, ReportBuilder, ReportSection, ) -from fireflyframework_genai.explainability.trace_recorder import ( +from fireflyframework_agentic.explainability.trace_recorder import ( DecisionRecord, TraceRecorder, default_trace_recorder, diff --git a/src/fireflyframework_genai/explainability/audit.py b/src/fireflyframework_agentic/explainability/audit.py similarity index 100% rename from src/fireflyframework_genai/explainability/audit.py rename to src/fireflyframework_agentic/explainability/audit.py diff --git a/src/fireflyframework_genai/explainability/explanation.py b/src/fireflyframework_agentic/explainability/explanation.py similarity index 92% rename from src/fireflyframework_genai/explainability/explanation.py rename to src/fireflyframework_agentic/explainability/explanation.py index 77bf6593..7e97fa30 100644 --- a/src/fireflyframework_genai/explainability/explanation.py +++ b/src/fireflyframework_agentic/explainability/explanation.py @@ -15,7 +15,7 @@ """Generate human-readable explanations from decision traces. :class:`ExplanationGenerator` takes a list of -:class:`~fireflyframework_genai.explainability.trace_recorder.DecisionRecord` +:class:`~fireflyframework_agentic.explainability.trace_recorder.DecisionRecord` objects and produces a narrative description of the agent's decision-making process. """ @@ -24,7 +24,7 @@ from collections.abc import Sequence -from fireflyframework_genai.explainability.trace_recorder import DecisionRecord +from fireflyframework_agentic.explainability.trace_recorder import DecisionRecord class ExplanationGenerator: diff --git a/src/fireflyframework_genai/explainability/report.py b/src/fireflyframework_agentic/explainability/report.py similarity index 95% rename from src/fireflyframework_genai/explainability/report.py rename to src/fireflyframework_agentic/explainability/report.py index b887c361..9a2917a7 100644 --- a/src/fireflyframework_genai/explainability/report.py +++ b/src/fireflyframework_agentic/explainability/report.py @@ -26,8 +26,8 @@ from pydantic import BaseModel, Field -from fireflyframework_genai.explainability.explanation import ExplanationGenerator -from fireflyframework_genai.explainability.trace_recorder import DecisionRecord +from fireflyframework_agentic.explainability.explanation import ExplanationGenerator +from fireflyframework_agentic.explainability.trace_recorder import DecisionRecord class ReportSection(BaseModel): diff --git a/src/fireflyframework_genai/explainability/trace_recorder.py b/src/fireflyframework_agentic/explainability/trace_recorder.py similarity index 100% rename from src/fireflyframework_genai/explainability/trace_recorder.py rename to src/fireflyframework_agentic/explainability/trace_recorder.py diff --git a/src/fireflyframework_genai/exposure/__init__.py b/src/fireflyframework_agentic/exposure/__init__.py similarity index 82% rename from src/fireflyframework_genai/exposure/__init__.py rename to src/fireflyframework_agentic/exposure/__init__.py index b4bc01d1..b118ef01 100644 --- a/src/fireflyframework_genai/exposure/__init__.py +++ b/src/fireflyframework_agentic/exposure/__init__.py @@ -14,7 +14,7 @@ """Exposure package -- REST API and message queue agent exposure.""" -from fireflyframework_genai.exposure.queues import ( +from fireflyframework_agentic.exposure.queues import ( BaseQueueConsumer, QueueConsumer, QueueMessage, @@ -33,17 +33,17 @@ def __getattr__(name: str): """Lazy-load REST symbols so the package works without FastAPI installed.""" - _rest_names = {"create_genai_app", "AgentRequest", "AgentResponse", "HealthResponse"} + _rest_names = {"create_agentic_app", "AgentRequest", "AgentResponse", "HealthResponse"} if name in _rest_names: - from fireflyframework_genai.exposure.rest import ( + from fireflyframework_agentic.exposure.rest import ( AgentRequest, AgentResponse, HealthResponse, - create_genai_app, + create_agentic_app, ) _map = { - "create_genai_app": create_genai_app, + "create_agentic_app": create_agentic_app, "AgentRequest": AgentRequest, "AgentResponse": AgentResponse, "HealthResponse": HealthResponse, diff --git a/src/fireflyframework_genai/exposure/queues/__init__.py b/src/fireflyframework_agentic/exposure/queues/__init__.py similarity index 85% rename from src/fireflyframework_genai/exposure/queues/__init__.py rename to src/fireflyframework_agentic/exposure/queues/__init__.py index 5904d80b..eb94c130 100644 --- a/src/fireflyframework_genai/exposure/queues/__init__.py +++ b/src/fireflyframework_agentic/exposure/queues/__init__.py @@ -14,13 +14,13 @@ """Queues exposure subpackage -- Kafka, RabbitMQ, Redis consumers, producers, and routing.""" -from fireflyframework_genai.exposure.queues.base import ( +from fireflyframework_agentic.exposure.queues.base import ( BaseQueueConsumer, QueueConsumer, QueueMessage, QueueProducer, ) -from fireflyframework_genai.exposure.queues.router import QueueRouter +from fireflyframework_agentic.exposure.queues.router import QueueRouter __all__ = [ "BaseQueueConsumer", @@ -39,7 +39,7 @@ def __getattr__(name: str): _redis_names = {"RedisAgentConsumer", "RedisAgentProducer"} if name in _kafka_names: - from fireflyframework_genai.exposure.queues.kafka import ( + from fireflyframework_agentic.exposure.queues.kafka import ( KafkaAgentConsumer, KafkaAgentProducer, ) @@ -47,7 +47,7 @@ def __getattr__(name: str): return {"KafkaAgentConsumer": KafkaAgentConsumer, "KafkaAgentProducer": KafkaAgentProducer}[name] if name in _rabbitmq_names: - from fireflyframework_genai.exposure.queues.rabbitmq import ( + from fireflyframework_agentic.exposure.queues.rabbitmq import ( RabbitMQAgentConsumer, RabbitMQAgentProducer, ) @@ -55,7 +55,7 @@ def __getattr__(name: str): return {"RabbitMQAgentConsumer": RabbitMQAgentConsumer, "RabbitMQAgentProducer": RabbitMQAgentProducer}[name] if name in _redis_names: - from fireflyframework_genai.exposure.queues.redis import ( + from fireflyframework_agentic.exposure.queues.redis import ( RedisAgentConsumer, RedisAgentProducer, ) diff --git a/src/fireflyframework_genai/exposure/queues/base.py b/src/fireflyframework_agentic/exposure/queues/base.py similarity index 96% rename from src/fireflyframework_genai/exposure/queues/base.py rename to src/fireflyframework_agentic/exposure/queues/base.py index 09fb5e05..7c928b06 100644 --- a/src/fireflyframework_genai/exposure/queues/base.py +++ b/src/fireflyframework_agentic/exposure/queues/base.py @@ -77,7 +77,7 @@ async def stop(self) -> None: async def _process_message(self, message: QueueMessage) -> str: """Route the message to the configured agent and return the response.""" - from fireflyframework_genai.agents.registry import agent_registry + from fireflyframework_agentic.agents.registry import agent_registry agent = agent_registry.get(self._agent_name) result = await agent.run(message.body) diff --git a/src/fireflyframework_genai/exposure/queues/kafka.py b/src/fireflyframework_agentic/exposure/queues/kafka.py similarity index 90% rename from src/fireflyframework_genai/exposure/queues/kafka.py rename to src/fireflyframework_agentic/exposure/queues/kafka.py index 1b531839..b158bd55 100644 --- a/src/fireflyframework_genai/exposure/queues/kafka.py +++ b/src/fireflyframework_agentic/exposure/queues/kafka.py @@ -15,7 +15,7 @@ """Kafka consumer/producer for agent exposure. Requires the ``aiokafka`` optional dependency (install via -``pip install fireflyframework-genai[kafka]``). +``pip install fireflyframework-agentic[kafka]``). """ from __future__ import annotations @@ -23,7 +23,7 @@ import logging from typing import Any -from fireflyframework_genai.exposure.queues.base import BaseQueueConsumer, QueueMessage +from fireflyframework_agentic.exposure.queues.base import BaseQueueConsumer, QueueMessage logger = logging.getLogger(__name__) @@ -44,7 +44,7 @@ def __init__( *, topic: str, bootstrap_servers: str = "localhost:9092", - group_id: str = "firefly-genai", + group_id: str = "firefly-agentic", ) -> None: super().__init__(agent_name) self._topic = topic @@ -58,7 +58,7 @@ async def start(self) -> None: from aiokafka import AIOKafkaConsumer # type: ignore[import-not-found] except ImportError as _err: raise ImportError( - "aiokafka is required for Kafka support. Install it with: pip install fireflyframework-genai[kafka]" + "aiokafka is required for Kafka support. Install it with: pip install fireflyframework-agentic[kafka]" ) from _err self._consumer = AIOKafkaConsumer( @@ -73,7 +73,7 @@ async def start(self) -> None: try: async for msg in self._consumer: # Extract trace context from message headers for distributed tracing - from fireflyframework_genai.observability.tracer import extract_trace_context, trace_context_scope + from fireflyframework_agentic.observability.tracer import extract_trace_context, trace_context_scope headers = {k: v.decode("utf-8") if isinstance(v, bytes) else v for k, v in (msg.headers or [])} span_context = extract_trace_context(headers) @@ -101,7 +101,7 @@ async def stop(self) -> None: class KafkaAgentProducer: """Publish messages to a Kafka topic. - Satisfies the :class:`~fireflyframework_genai.exposure.queues.base.QueueProducer` + Satisfies the :class:`~fireflyframework_agentic.exposure.queues.base.QueueProducer` protocol. Parameters: @@ -125,7 +125,7 @@ async def start(self) -> None: from aiokafka import AIOKafkaProducer # type: ignore[import-not-found] except ImportError as _err: raise ImportError( - "aiokafka is required for Kafka support. Install it with: pip install fireflyframework-genai[kafka]" + "aiokafka is required for Kafka support. Install it with: pip install fireflyframework-agentic[kafka]" ) from _err self._producer = AIOKafkaProducer( diff --git a/src/fireflyframework_genai/exposure/queues/rabbitmq.py b/src/fireflyframework_agentic/exposure/queues/rabbitmq.py similarity index 91% rename from src/fireflyframework_genai/exposure/queues/rabbitmq.py rename to src/fireflyframework_agentic/exposure/queues/rabbitmq.py index 8aec65aa..734e26b9 100644 --- a/src/fireflyframework_genai/exposure/queues/rabbitmq.py +++ b/src/fireflyframework_agentic/exposure/queues/rabbitmq.py @@ -15,7 +15,7 @@ """RabbitMQ consumer for agent exposure. Requires the ``aio-pika`` optional dependency (install via -``pip install fireflyframework-genai[rabbitmq]``). +``pip install fireflyframework-agentic[rabbitmq]``). """ from __future__ import annotations @@ -23,7 +23,7 @@ import logging from typing import Any, cast -from fireflyframework_genai.exposure.queues.base import BaseQueueConsumer, QueueMessage +from fireflyframework_agentic.exposure.queues.base import BaseQueueConsumer, QueueMessage logger = logging.getLogger(__name__) @@ -56,7 +56,7 @@ async def start(self) -> None: except ImportError as _err: raise ImportError( "aio-pika is required for RabbitMQ support. " - "Install it with: pip install fireflyframework-genai[rabbitmq]" + "Install it with: pip install fireflyframework-agentic[rabbitmq]" ) from _err self._connection = await aio_pika.connect_robust(self._url) @@ -69,7 +69,7 @@ async def start(self) -> None: async for amqp_message in queue_iter: async with amqp_message.process(): # Extract trace context from message headers for distributed tracing - from fireflyframework_genai.observability.tracer import extract_trace_context, trace_context_scope + from fireflyframework_agentic.observability.tracer import extract_trace_context, trace_context_scope headers = {} if amqp_message.headers: @@ -97,7 +97,7 @@ async def stop(self) -> None: class RabbitMQAgentProducer: """Publish messages to a RabbitMQ exchange. - Satisfies the :class:`~fireflyframework_genai.exposure.queues.base.QueueProducer` + Satisfies the :class:`~fireflyframework_agentic.exposure.queues.base.QueueProducer` protocol. Parameters: @@ -125,7 +125,7 @@ async def start(self) -> None: except ImportError as _err: raise ImportError( "aio-pika is required for RabbitMQ support. " - "Install it with: pip install fireflyframework-genai[rabbitmq]" + "Install it with: pip install fireflyframework-agentic[rabbitmq]" ) from _err self._connection = await aio_pika.connect_robust(self._url) diff --git a/src/fireflyframework_genai/exposure/queues/redis.py b/src/fireflyframework_agentic/exposure/queues/redis.py similarity index 90% rename from src/fireflyframework_genai/exposure/queues/redis.py rename to src/fireflyframework_agentic/exposure/queues/redis.py index 9f33d135..c203a27a 100644 --- a/src/fireflyframework_genai/exposure/queues/redis.py +++ b/src/fireflyframework_agentic/exposure/queues/redis.py @@ -15,7 +15,7 @@ """Redis Pub/Sub consumer for agent exposure. Requires the ``redis`` optional dependency (install via -``pip install fireflyframework-genai[redis]``). +``pip install fireflyframework-agentic[redis]``). """ from __future__ import annotations @@ -23,7 +23,7 @@ import logging from typing import Any -from fireflyframework_genai.exposure.queues.base import BaseQueueConsumer, QueueMessage +from fireflyframework_agentic.exposure.queues.base import BaseQueueConsumer, QueueMessage logger = logging.getLogger(__name__) @@ -56,7 +56,7 @@ async def start(self) -> None: except ImportError as _err: raise ImportError( "redis[hiredis] is required for Redis support. " - "Install it with: pip install fireflyframework-genai[redis]" + "Install it with: pip install fireflyframework-agentic[redis]" ) from _err self._client = aioredis.from_url(self._url) @@ -76,7 +76,7 @@ async def start(self) -> None: # If not JSON, treat as plain text import json - from fireflyframework_genai.observability.tracer import extract_trace_context, trace_context_scope + from fireflyframework_agentic.observability.tracer import extract_trace_context, trace_context_scope span_context = None try: @@ -112,7 +112,7 @@ async def stop(self) -> None: class RedisAgentProducer: """Publish messages to a Redis Pub/Sub channel. - Satisfies the :class:`~fireflyframework_genai.exposure.queues.base.QueueProducer` + Satisfies the :class:`~fireflyframework_agentic.exposure.queues.base.QueueProducer` protocol. Parameters: @@ -137,7 +137,7 @@ async def start(self) -> None: except ImportError as _err: raise ImportError( "redis[hiredis] is required for Redis support. " - "Install it with: pip install fireflyframework-genai[redis]" + "Install it with: pip install fireflyframework-agentic[redis]" ) from _err self._client = aioredis.from_url(self._url) diff --git a/src/fireflyframework_genai/exposure/queues/router.py b/src/fireflyframework_agentic/exposure/queues/router.py similarity index 91% rename from src/fireflyframework_genai/exposure/queues/router.py rename to src/fireflyframework_agentic/exposure/queues/router.py index 8d003969..5f3d4740 100644 --- a/src/fireflyframework_genai/exposure/queues/router.py +++ b/src/fireflyframework_agentic/exposure/queues/router.py @@ -18,9 +18,9 @@ import re -from fireflyframework_genai.agents.registry import agent_registry -from fireflyframework_genai.exceptions import ExposureError -from fireflyframework_genai.exposure.queues.base import QueueMessage +from fireflyframework_agentic.agents.registry import agent_registry +from fireflyframework_agentic.exceptions import ExposureError +from fireflyframework_agentic.exposure.queues.base import QueueMessage class QueueRouter: diff --git a/src/fireflyframework_genai/exposure/rest/__init__.py b/src/fireflyframework_agentic/exposure/rest/__init__.py similarity index 78% rename from src/fireflyframework_genai/exposure/rest/__init__.py rename to src/fireflyframework_agentic/exposure/rest/__init__.py index fbc675ec..57023078 100644 --- a/src/fireflyframework_genai/exposure/rest/__init__.py +++ b/src/fireflyframework_agentic/exposure/rest/__init__.py @@ -14,12 +14,12 @@ """REST exposure subpackage -- FastAPI app factory, router, middleware, streaming.""" -from fireflyframework_genai.exposure.rest.app import create_genai_app -from fireflyframework_genai.exposure.rest.schemas import AgentRequest, AgentResponse, HealthResponse +from fireflyframework_agentic.exposure.rest.app import create_agentic_app +from fireflyframework_agentic.exposure.rest.schemas import AgentRequest, AgentResponse, HealthResponse __all__ = [ "AgentRequest", "AgentResponse", "HealthResponse", - "create_genai_app", + "create_agentic_app", ] diff --git a/src/fireflyframework_genai/exposure/rest/app.py b/src/fireflyframework_agentic/exposure/rest/app.py similarity index 78% rename from src/fireflyframework_genai/exposure/rest/app.py rename to src/fireflyframework_agentic/exposure/rest/app.py index 7dcc1587..e09cfdc0 100644 --- a/src/fireflyframework_genai/exposure/rest/app.py +++ b/src/fireflyframework_agentic/exposure/rest/app.py @@ -14,7 +14,7 @@ """FastAPI application factory for exposing Firefly agents over REST. -Call :func:`create_genai_app` to get a fully-configured FastAPI instance +Call :func:`create_agentic_app` to get a fully-configured FastAPI instance with agent, health, and streaming endpoints. """ @@ -31,13 +31,13 @@ @asynccontextmanager async def _lifespan(app: Any) -> AsyncIterator[None]: """FastAPI lifespan: plugin discovery, warmup, OTel, and shutdown.""" - from fireflyframework_genai.config import get_config + from fireflyframework_agentic.config import get_config cfg = get_config() # -- Startup ----------------------------------------------------------- if cfg.plugin_auto_discover: - from fireflyframework_genai.plugin import PluginDiscovery + from fireflyframework_agentic.plugin import PluginDiscovery result = PluginDiscovery.discover_all() logger.info( @@ -46,14 +46,14 @@ async def _lifespan(app: Any) -> AsyncIterator[None]: len(result.failed), ) - from fireflyframework_genai.agents.lifecycle import agent_lifecycle - from fireflyframework_genai.reasoning.prompts import register_reasoning_prompts + from fireflyframework_agentic.agents.lifecycle import agent_lifecycle + from fireflyframework_agentic.reasoning.prompts import register_reasoning_prompts register_reasoning_prompts() await agent_lifecycle.run_warmup() if cfg.observability_enabled: - from fireflyframework_genai.observability.exporters import configure_exporters + from fireflyframework_agentic.observability.exporters import configure_exporters configure_exporters( otlp_endpoint=cfg.otlp_endpoint, @@ -66,9 +66,9 @@ async def _lifespan(app: Any) -> AsyncIterator[None]: await agent_lifecycle.run_shutdown() -def create_genai_app( +def create_agentic_app( *, - title: str = "Firefly GenAI", + title: str = "Firefly Agentic", version: str = "0.1.0", cors: bool = True, request_id: bool = True, @@ -93,13 +93,13 @@ def create_genai_app( # without installing the [rest] extra. from fastapi import FastAPI # type: ignore[import-not-found] - from fireflyframework_genai.exposure.rest.health import create_health_router - from fireflyframework_genai.exposure.rest.middleware import ( + from fireflyframework_agentic.exposure.rest.health import create_health_router + from fireflyframework_agentic.exposure.rest.middleware import ( add_cors_middleware, add_rate_limit_middleware, add_request_id_middleware, ) - from fireflyframework_genai.exposure.rest.router import create_agent_router + from fireflyframework_agentic.exposure.rest.router import create_agent_router app = FastAPI(title=title, version=version, lifespan=_lifespan) @@ -113,11 +113,11 @@ def create_genai_app( add_rate_limit_middleware(app, **rl_kwargs) # Auto-wire auth middleware from config - from fireflyframework_genai.config import get_config + from fireflyframework_agentic.config import get_config cfg = get_config() if cfg.auth_api_keys or cfg.auth_bearer_tokens: - from fireflyframework_genai.exposure.rest.middleware import add_auth_middleware + from fireflyframework_agentic.exposure.rest.middleware import add_auth_middleware add_auth_middleware( app, @@ -130,7 +130,7 @@ def create_genai_app( app.include_router(create_agent_router()) # WebSocket - from fireflyframework_genai.exposure.rest.websocket import create_websocket_router + from fireflyframework_agentic.exposure.rest.websocket import create_websocket_router app.include_router(create_websocket_router()) diff --git a/src/fireflyframework_genai/exposure/rest/health.py b/src/fireflyframework_agentic/exposure/rest/health.py similarity index 91% rename from src/fireflyframework_genai/exposure/rest/health.py rename to src/fireflyframework_agentic/exposure/rest/health.py index edee3b65..f196b4eb 100644 --- a/src/fireflyframework_genai/exposure/rest/health.py +++ b/src/fireflyframework_agentic/exposure/rest/health.py @@ -21,8 +21,8 @@ if TYPE_CHECKING: from fastapi import APIRouter # type: ignore[import-not-found] -from fireflyframework_genai.agents.registry import agent_registry -from fireflyframework_genai.exposure.rest.schemas import HealthResponse +from fireflyframework_agentic.agents.registry import agent_registry +from fireflyframework_agentic.exposure.rest.schemas import HealthResponse def create_health_router() -> APIRouter: diff --git a/src/fireflyframework_genai/exposure/rest/middleware.py b/src/fireflyframework_agentic/exposure/rest/middleware.py similarity index 96% rename from src/fireflyframework_genai/exposure/rest/middleware.py rename to src/fireflyframework_agentic/exposure/rest/middleware.py index d295f0d9..e5c37646 100644 --- a/src/fireflyframework_genai/exposure/rest/middleware.py +++ b/src/fireflyframework_agentic/exposure/rest/middleware.py @@ -236,7 +236,7 @@ def add_trace_propagation_middleware(app: Any) -> None: Example:: from fastapi import FastAPI - from fireflyframework_genai.exposure.rest.middleware import add_trace_propagation_middleware + from fireflyframework_agentic.exposure.rest.middleware import add_trace_propagation_middleware app = FastAPI() add_trace_propagation_middleware(app) @@ -245,14 +245,14 @@ def add_trace_propagation_middleware(app: Any) -> None: See Also: - https://www.w3.org/TR/trace-context/ - - :func:`~fireflyframework_genai.observability.tracer.extract_trace_context` - - :func:`~fireflyframework_genai.observability.tracer.inject_trace_context` + - :func:`~fireflyframework_agentic.observability.tracer.extract_trace_context` + - :func:`~fireflyframework_agentic.observability.tracer.inject_trace_context` """ from starlette.middleware.base import BaseHTTPMiddleware from starlette.requests import Request from starlette.responses import Response - from fireflyframework_genai.observability.tracer import ( + from fireflyframework_agentic.observability.tracer import ( extract_trace_context, inject_trace_context, trace_context_scope, diff --git a/src/fireflyframework_genai/exposure/rest/router.py b/src/fireflyframework_agentic/exposure/rest/router.py similarity index 95% rename from src/fireflyframework_genai/exposure/rest/router.py rename to src/fireflyframework_agentic/exposure/rest/router.py index a5581318..e63e66ab 100644 --- a/src/fireflyframework_genai/exposure/rest/router.py +++ b/src/fireflyframework_agentic/exposure/rest/router.py @@ -26,10 +26,10 @@ if TYPE_CHECKING: from fastapi import APIRouter # type: ignore[import-not-found] -from fireflyframework_genai.agents.registry import agent_registry -from fireflyframework_genai.exposure.rest.schemas import AgentRequest, AgentResponse -from fireflyframework_genai.exposure.rest.streaming import sse_stream, sse_stream_incremental -from fireflyframework_genai.memory.manager import MemoryManager +from fireflyframework_agentic.agents.registry import agent_registry +from fireflyframework_agentic.exposure.rest.schemas import AgentRequest, AgentResponse +from fireflyframework_agentic.exposure.rest.streaming import sse_stream, sse_stream_incremental +from fireflyframework_agentic.memory.manager import MemoryManager logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/exposure/rest/schemas.py b/src/fireflyframework_agentic/exposure/rest/schemas.py similarity index 100% rename from src/fireflyframework_genai/exposure/rest/schemas.py rename to src/fireflyframework_agentic/exposure/rest/schemas.py diff --git a/src/fireflyframework_genai/exposure/rest/streaming.py b/src/fireflyframework_agentic/exposure/rest/streaming.py similarity index 97% rename from src/fireflyframework_genai/exposure/rest/streaming.py rename to src/fireflyframework_agentic/exposure/rest/streaming.py index 09cc7687..6d224211 100644 --- a/src/fireflyframework_genai/exposure/rest/streaming.py +++ b/src/fireflyframework_agentic/exposure/rest/streaming.py @@ -20,7 +20,7 @@ from collections.abc import AsyncIterator from typing import Any, cast -from fireflyframework_genai.types import AgentLike +from fireflyframework_agentic.types import AgentLike async def sse_stream(agent: AgentLike, prompt: Any, **kwargs: Any) -> AsyncIterator[str]: diff --git a/src/fireflyframework_genai/exposure/rest/websocket.py b/src/fireflyframework_agentic/exposure/rest/websocket.py similarity index 97% rename from src/fireflyframework_genai/exposure/rest/websocket.py rename to src/fireflyframework_agentic/exposure/rest/websocket.py index ae9a768b..ca277b6c 100644 --- a/src/fireflyframework_genai/exposure/rest/websocket.py +++ b/src/fireflyframework_agentic/exposure/rest/websocket.py @@ -53,8 +53,8 @@ def create_websocket_router() -> APIRouter: """Create a FastAPI router with the agent WebSocket endpoint.""" from fastapi import APIRouter, WebSocket, WebSocketDisconnect # type: ignore[import-not-found] - from fireflyframework_genai.agents.registry import agent_registry - from fireflyframework_genai.memory.manager import MemoryManager + from fireflyframework_agentic.agents.registry import agent_registry + from fireflyframework_agentic.memory.manager import MemoryManager router = APIRouter(tags=["websocket"]) _ws_memory = MemoryManager(working_scope_id="ws") diff --git a/src/fireflyframework_genai/lab/__init__.py b/src/fireflyframework_agentic/lab/__init__.py similarity index 69% rename from src/fireflyframework_genai/lab/__init__.py rename to src/fireflyframework_agentic/lab/__init__.py index b2dddb9c..29436cc3 100644 --- a/src/fireflyframework_genai/lab/__init__.py +++ b/src/fireflyframework_agentic/lab/__init__.py @@ -14,11 +14,11 @@ """Lab subpackage -- sessions, benchmarks, comparisons, datasets, and evaluation.""" -from fireflyframework_genai.lab.benchmark import Benchmark, BenchmarkResult -from fireflyframework_genai.lab.comparison import ComparisonEntry, ModelComparison -from fireflyframework_genai.lab.dataset import EvalCase, EvalDataset -from fireflyframework_genai.lab.evaluator import EvalOrchestrator, EvalReport, EvalResult -from fireflyframework_genai.lab.session import LabSession, SessionEntry +from fireflyframework_agentic.lab.benchmark import Benchmark, BenchmarkResult +from fireflyframework_agentic.lab.comparison import ComparisonEntry, ModelComparison +from fireflyframework_agentic.lab.dataset import EvalCase, EvalDataset +from fireflyframework_agentic.lab.evaluator import EvalOrchestrator, EvalReport, EvalResult +from fireflyframework_agentic.lab.session import LabSession, SessionEntry __all__ = [ "Benchmark", diff --git a/src/fireflyframework_genai/lab/benchmark.py b/src/fireflyframework_agentic/lab/benchmark.py similarity index 97% rename from src/fireflyframework_genai/lab/benchmark.py rename to src/fireflyframework_agentic/lab/benchmark.py index e9c77297..a16b9166 100644 --- a/src/fireflyframework_genai/lab/benchmark.py +++ b/src/fireflyframework_agentic/lab/benchmark.py @@ -21,7 +21,7 @@ from pydantic import BaseModel -from fireflyframework_genai.types import AgentLike +from fireflyframework_agentic.types import AgentLike class BenchmarkResult(BaseModel): diff --git a/src/fireflyframework_genai/lab/comparison.py b/src/fireflyframework_agentic/lab/comparison.py similarity index 100% rename from src/fireflyframework_genai/lab/comparison.py rename to src/fireflyframework_agentic/lab/comparison.py diff --git a/src/fireflyframework_genai/lab/dataset.py b/src/fireflyframework_agentic/lab/dataset.py similarity index 100% rename from src/fireflyframework_genai/lab/dataset.py rename to src/fireflyframework_agentic/lab/dataset.py diff --git a/src/fireflyframework_genai/lab/evaluator.py b/src/fireflyframework_agentic/lab/evaluator.py similarity index 95% rename from src/fireflyframework_genai/lab/evaluator.py rename to src/fireflyframework_agentic/lab/evaluator.py index 9e272c9f..8d79f292 100644 --- a/src/fireflyframework_genai/lab/evaluator.py +++ b/src/fireflyframework_agentic/lab/evaluator.py @@ -20,8 +20,8 @@ from pydantic import BaseModel -from fireflyframework_genai.lab.dataset import EvalDataset -from fireflyframework_genai.types import AgentLike +from fireflyframework_agentic.lab.dataset import EvalDataset +from fireflyframework_agentic.types import AgentLike # A scorer takes (expected, actual) and returns a float score Scorer = Callable[[str, str], float] diff --git a/src/fireflyframework_genai/lab/session.py b/src/fireflyframework_agentic/lab/session.py similarity index 97% rename from src/fireflyframework_genai/lab/session.py rename to src/fireflyframework_agentic/lab/session.py index 010d5545..58cadefa 100644 --- a/src/fireflyframework_genai/lab/session.py +++ b/src/fireflyframework_agentic/lab/session.py @@ -21,7 +21,7 @@ from pydantic import BaseModel, Field -from fireflyframework_genai.types import AgentLike +from fireflyframework_agentic.types import AgentLike class SessionEntry(BaseModel): diff --git a/src/fireflyframework_genai/logging.py b/src/fireflyframework_agentic/logging.py similarity index 94% rename from src/fireflyframework_genai/logging.py rename to src/fireflyframework_agentic/logging.py index 1cb8decc..73d3fc9d 100644 --- a/src/fireflyframework_genai/logging.py +++ b/src/fireflyframework_agentic/logging.py @@ -12,23 +12,23 @@ # See the License for the specific language governing permissions and # limitations under the License. -"""Logging utilities for the Firefly GenAI framework. +"""Logging utilities for the Firefly Agentic framework. -All framework modules log under the ``fireflyframework_genai`` hierarchy. +All framework modules log under the ``fireflyframework_agentic`` hierarchy. Use :func:`configure_logging` or :func:`enable_debug` to turn on framework-level logging without touching the root logger or third-party libraries. Quick start:: - from fireflyframework_genai.logging import configure_logging + from fireflyframework_agentic.logging import configure_logging configure_logging("INFO") # agent + reasoning progress configure_logging("DEBUG") # includes LLM call timings Or even shorter:: - from fireflyframework_genai.logging import enable_debug + from fireflyframework_agentic.logging import enable_debug enable_debug() # equivalent to configure_logging("DEBUG") """ @@ -42,7 +42,7 @@ from datetime import UTC, datetime from typing import Any -_LOGGER_NAME = "fireflyframework_genai" +_LOGGER_NAME = "fireflyframework_agentic" _DEFAULT_FORMAT = "%(asctime)s %(levelname)-7s %(name)s %(message)s" _DEFAULT_DATEFMT = "%H:%M:%S" @@ -186,13 +186,13 @@ def configure_logging( stream: Any | None = None, format_style: str = "text", ) -> None: - """Configure logging for all ``fireflyframework_genai`` modules. + """Configure logging for all ``fireflyframework_agentic`` modules. This attaches a :class:`logging.StreamHandler` to the framework's root logger so that agent, reasoning, memory, and tool operations are visible at the requested *level*. - The handler is added **only** to the ``fireflyframework_genai`` logger, + The handler is added **only** to the ``fireflyframework_agentic`` logger, so third-party and application-level loggers are not affected. Calling this function multiple times replaces the previous handler. diff --git a/src/fireflyframework_genai/memory/__init__.py b/src/fireflyframework_agentic/memory/__init__.py similarity index 66% rename from src/fireflyframework_genai/memory/__init__.py rename to src/fireflyframework_agentic/memory/__init__.py index 9bbfdf24..9dbcc758 100644 --- a/src/fireflyframework_genai/memory/__init__.py +++ b/src/fireflyframework_agentic/memory/__init__.py @@ -14,12 +14,12 @@ """Memory subsystem: conversation history, working memory, and storage backends.""" -from fireflyframework_genai.memory.conversation import ConversationMemory -from fireflyframework_genai.memory.manager import MemoryManager -from fireflyframework_genai.memory.store import FileStore, InMemoryStore, MemoryStore -from fireflyframework_genai.memory.summarization import create_llm_summarizer -from fireflyframework_genai.memory.types import ConversationTurn, MemoryEntry, MemoryScope -from fireflyframework_genai.memory.working import WorkingMemory +from fireflyframework_agentic.memory.conversation import ConversationMemory +from fireflyframework_agentic.memory.manager import MemoryManager +from fireflyframework_agentic.memory.store import FileStore, InMemoryStore, MemoryStore +from fireflyframework_agentic.memory.summarization import create_llm_summarizer +from fireflyframework_agentic.memory.types import ConversationTurn, MemoryEntry, MemoryScope +from fireflyframework_agentic.memory.working import WorkingMemory __all__ = [ "ConversationMemory", diff --git a/src/fireflyframework_genai/memory/conversation.py b/src/fireflyframework_agentic/memory/conversation.py similarity index 98% rename from src/fireflyframework_genai/memory/conversation.py rename to src/fireflyframework_agentic/memory/conversation.py index e930dc34..9488c580 100644 --- a/src/fireflyframework_genai/memory/conversation.py +++ b/src/fireflyframework_agentic/memory/conversation.py @@ -30,8 +30,8 @@ from pydantic_ai.messages import ModelMessage -from fireflyframework_genai.content.compression import TokenEstimator -from fireflyframework_genai.memory.types import ConversationTurn +from fireflyframework_agentic.content.compression import TokenEstimator +from fireflyframework_agentic.memory.types import ConversationTurn logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/memory/database_store.py b/src/fireflyframework_agentic/memory/database_store.py similarity index 97% rename from src/fireflyframework_genai/memory/database_store.py rename to src/fireflyframework_agentic/memory/database_store.py index 727de654..0eaff2c1 100644 --- a/src/fireflyframework_genai/memory/database_store.py +++ b/src/fireflyframework_agentic/memory/database_store.py @@ -21,7 +21,7 @@ Examples: PostgreSQL backend:: - from fireflyframework_genai.memory.database_store import PostgreSQLStore + from fireflyframework_agentic.memory.database_store import PostgreSQLStore store = PostgreSQLStore( url="postgresql://user:pass@localhost/firefly", @@ -34,7 +34,7 @@ MongoDB backend:: - from fireflyframework_genai.memory.database_store import MongoDBStore + from fireflyframework_agentic.memory.database_store import MongoDBStore store = MongoDBStore( url="mongodb://localhost:27017/", @@ -53,8 +53,8 @@ from datetime import UTC, datetime from typing import Any -from fireflyframework_genai.exceptions import DatabaseConnectionError, DatabaseStoreError -from fireflyframework_genai.memory.types import MemoryEntry +from fireflyframework_agentic.exceptions import DatabaseConnectionError, DatabaseStoreError +from fireflyframework_agentic.memory.types import MemoryEntry _SAFE_IDENTIFIER = re.compile(r"^[a-zA-Z_][a-zA-Z0-9_]*$") @@ -96,7 +96,7 @@ class PostgreSQLStore: Note: Requires the optional ``postgres`` dependency group: - ``pip install fireflyframework-genai[postgres]`` + ``pip install fireflyframework-agentic[postgres]`` """ def __init__( @@ -135,7 +135,7 @@ async def initialize(self) -> None: except ImportError as exc: raise DatabaseStoreError( "PostgreSQL support requires 'asyncpg' and 'sqlalchemy'. " - "Install with: pip install fireflyframework-genai[postgres]" + "Install with: pip install fireflyframework-agentic[postgres]" ) from exc try: @@ -391,7 +391,7 @@ class MongoDBStore: Note: Requires the optional ``mongodb`` dependency group: - ``pip install fireflyframework-genai[mongodb]`` + ``pip install fireflyframework-agentic[mongodb]`` """ def __init__( @@ -428,7 +428,7 @@ async def initialize(self) -> None: except ImportError as exc: raise DatabaseStoreError( "MongoDB support requires 'motor' and 'pymongo'. " - "Install with: pip install fireflyframework-genai[mongodb]" + "Install with: pip install fireflyframework-agentic[mongodb]" ) from exc try: diff --git a/src/fireflyframework_genai/memory/manager.py b/src/fireflyframework_agentic/memory/manager.py similarity index 90% rename from src/fireflyframework_genai/memory/manager.py rename to src/fireflyframework_agentic/memory/manager.py index 1d1e26d2..a0e673ac 100644 --- a/src/fireflyframework_genai/memory/manager.py +++ b/src/fireflyframework_agentic/memory/manager.py @@ -27,9 +27,9 @@ from pydantic_ai.messages import ModelMessage -from fireflyframework_genai.memory.conversation import ConversationMemory -from fireflyframework_genai.memory.store import InMemoryStore, MemoryStore -from fireflyframework_genai.memory.working import WorkingMemory +from fireflyframework_agentic.memory.conversation import ConversationMemory +from fireflyframework_agentic.memory.store import InMemoryStore, MemoryStore +from fireflyframework_agentic.memory.working import WorkingMemory logger = logging.getLogger(__name__) @@ -73,7 +73,7 @@ def from_config(cls) -> MemoryManager: Reads ``memory_backend``, ``memory_max_conversation_tokens``, ``memory_summarize_threshold``, and backend-specific configuration - from :func:`~fireflyframework_genai.config.get_config`. + from :func:`~fireflyframework_agentic.config.get_config`. Supported backends: - ``in_memory``: Fast dict-backed storage (default, non-persistent) @@ -83,13 +83,13 @@ def from_config(cls) -> MemoryManager: Note: Database backends require their respective optional dependencies: - ``pip install fireflyframework-genai[postgres]`` or - ``pip install fireflyframework-genai[mongodb]`` + ``pip install fireflyframework-agentic[postgres]`` or + ``pip install fireflyframework-agentic[mongodb]`` """ import asyncio from concurrent.futures import ThreadPoolExecutor - from fireflyframework_genai.config import get_config + from fireflyframework_agentic.config import get_config def _run_sync(coro: Any) -> Any: """Run *coro* synchronously, safe even when an event loop is already running.""" @@ -109,17 +109,17 @@ def _run_sync(coro: Any) -> Any: store: MemoryStore if cfg.memory_backend == "file": - from fireflyframework_genai.memory.store import FileStore + from fireflyframework_agentic.memory.store import FileStore store = FileStore(base_dir=cfg.memory_file_dir) elif cfg.memory_backend == "postgres": - from fireflyframework_genai.memory.database_store import PostgreSQLStore + from fireflyframework_agentic.memory.database_store import PostgreSQLStore if cfg.memory_postgres_url is None: raise ValueError( "memory_postgres_url must be set when using postgres backend. " - "Set FIREFLY_GENAI_MEMORY_POSTGRES_URL environment variable." + "Set FIREFLY_AGENTIC_MEMORY_POSTGRES_URL environment variable." ) store = PostgreSQLStore( @@ -133,12 +133,12 @@ def _run_sync(coro: Any) -> Any: logger.info("PostgreSQL memory backend initialized") elif cfg.memory_backend == "mongodb": - from fireflyframework_genai.memory.database_store import MongoDBStore + from fireflyframework_agentic.memory.database_store import MongoDBStore if cfg.memory_mongodb_url is None: raise ValueError( "memory_mongodb_url must be set when using mongodb backend. " - "Set FIREFLY_GENAI_MEMORY_MONGODB_URL environment variable." + "Set FIREFLY_AGENTIC_MEMORY_MONGODB_URL environment variable." ) store = MongoDBStore( diff --git a/src/fireflyframework_genai/memory/store.py b/src/fireflyframework_agentic/memory/store.py similarity index 99% rename from src/fireflyframework_genai/memory/store.py rename to src/fireflyframework_agentic/memory/store.py index 3e7963e6..26519860 100644 --- a/src/fireflyframework_genai/memory/store.py +++ b/src/fireflyframework_agentic/memory/store.py @@ -29,7 +29,7 @@ from pathlib import Path from typing import Any, Protocol, runtime_checkable -from fireflyframework_genai.memory.types import MemoryEntry +from fireflyframework_agentic.memory.types import MemoryEntry logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/memory/summarization.py b/src/fireflyframework_agentic/memory/summarization.py similarity index 93% rename from src/fireflyframework_genai/memory/summarization.py rename to src/fireflyframework_agentic/memory/summarization.py index ff215ce8..4b70c28e 100644 --- a/src/fireflyframework_genai/memory/summarization.py +++ b/src/fireflyframework_agentic/memory/summarization.py @@ -15,13 +15,13 @@ """LLM-based conversation summarization. :func:`create_llm_summarizer` returns a callable suitable for -:class:`~fireflyframework_genai.memory.conversation.ConversationMemory`'s +:class:`~fireflyframework_agentic.memory.conversation.ConversationMemory`'s ``summarizer`` parameter. It compresses evicted turns into a concise summary using an LLM agent. Usage:: - from fireflyframework_genai.memory.summarization import create_llm_summarizer + from fireflyframework_agentic.memory.summarization import create_llm_summarizer summarizer = create_llm_summarizer(model="openai:gpt-4o-mini") memory = ConversationMemory(summarizer=summarizer) @@ -34,7 +34,7 @@ from collections.abc import Callable from typing import Any -from fireflyframework_genai.memory.types import ConversationTurn +from fireflyframework_agentic.memory.types import ConversationTurn logger = logging.getLogger(__name__) @@ -91,7 +91,7 @@ async def _async_summarize(turns: list[ConversationTurn]) -> str: resolved_model = model if resolved_model is None: - from fireflyframework_genai.config import get_config + from fireflyframework_agentic.config import get_config resolved_model = get_config().default_model diff --git a/src/fireflyframework_genai/memory/types.py b/src/fireflyframework_agentic/memory/types.py similarity index 100% rename from src/fireflyframework_genai/memory/types.py rename to src/fireflyframework_agentic/memory/types.py diff --git a/src/fireflyframework_genai/memory/working.py b/src/fireflyframework_agentic/memory/working.py similarity index 96% rename from src/fireflyframework_genai/memory/working.py rename to src/fireflyframework_agentic/memory/working.py index 2368df41..a2b87614 100644 --- a/src/fireflyframework_genai/memory/working.py +++ b/src/fireflyframework_agentic/memory/working.py @@ -24,8 +24,8 @@ import logging from typing import Any -from fireflyframework_genai.memory.store import InMemoryStore, MemoryStore -from fireflyframework_genai.memory.types import MemoryEntry, MemoryScope +from fireflyframework_agentic.memory.store import InMemoryStore, MemoryStore +from fireflyframework_agentic.memory.types import MemoryEntry, MemoryScope logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/model_utils.py b/src/fireflyframework_agentic/model_utils.py similarity index 100% rename from src/fireflyframework_genai/model_utils.py rename to src/fireflyframework_agentic/model_utils.py diff --git a/src/fireflyframework_genai/observability/__init__.py b/src/fireflyframework_agentic/observability/__init__.py similarity index 73% rename from src/fireflyframework_genai/observability/__init__.py rename to src/fireflyframework_agentic/observability/__init__.py index 1045f7aa..a6ab9f9c 100644 --- a/src/fireflyframework_genai/observability/__init__.py +++ b/src/fireflyframework_agentic/observability/__init__.py @@ -14,24 +14,24 @@ """Observability subpackage -- tracing, metrics, events, and exporters.""" -from fireflyframework_genai.observability.cost import ( +from fireflyframework_agentic.observability.cost import ( CostCalculator, GenAIPricesCostCalculator, StaticPriceCostCalculator, get_cost_calculator, ) -from fireflyframework_genai.observability.decorators import metered, traced -from fireflyframework_genai.observability.events import FireflyEvent, FireflyEvents, default_events -from fireflyframework_genai.observability.exporters import configure_exporters -from fireflyframework_genai.observability.metrics import FireflyMetrics, default_metrics -from fireflyframework_genai.observability.tracer import ( +from fireflyframework_agentic.observability.decorators import metered, traced +from fireflyframework_agentic.observability.events import FireflyEvent, FireflyEvents, default_events +from fireflyframework_agentic.observability.exporters import configure_exporters +from fireflyframework_agentic.observability.metrics import FireflyMetrics, default_metrics +from fireflyframework_agentic.observability.tracer import ( FireflyTracer, default_tracer, extract_trace_context, inject_trace_context, trace_context_scope, ) -from fireflyframework_genai.observability.usage import ( +from fireflyframework_agentic.observability.usage import ( UsageRecord, UsageSummary, UsageTracker, diff --git a/src/fireflyframework_genai/observability/cost.py b/src/fireflyframework_agentic/observability/cost.py similarity index 100% rename from src/fireflyframework_genai/observability/cost.py rename to src/fireflyframework_agentic/observability/cost.py diff --git a/src/fireflyframework_genai/observability/decorators.py b/src/fireflyframework_agentic/observability/decorators.py similarity index 96% rename from src/fireflyframework_genai/observability/decorators.py rename to src/fireflyframework_agentic/observability/decorators.py index 452220e3..baa95750 100644 --- a/src/fireflyframework_genai/observability/decorators.py +++ b/src/fireflyframework_agentic/observability/decorators.py @@ -25,8 +25,8 @@ from collections.abc import Callable from typing import Any, TypeVar -from fireflyframework_genai.observability.metrics import default_metrics -from fireflyframework_genai.observability.tracer import default_tracer +from fireflyframework_agentic.observability.metrics import default_metrics +from fireflyframework_agentic.observability.tracer import default_tracer F = TypeVar("F", bound=Callable[..., Any]) diff --git a/src/fireflyframework_genai/observability/events.py b/src/fireflyframework_agentic/observability/events.py similarity index 96% rename from src/fireflyframework_genai/observability/events.py rename to src/fireflyframework_agentic/observability/events.py index 2f23e3fa..fb8f351d 100644 --- a/src/fireflyframework_genai/observability/events.py +++ b/src/fireflyframework_agentic/observability/events.py @@ -12,7 +12,7 @@ # See the License for the specific language governing permissions and # limitations under the License. -"""Structured event logging for Firefly GenAI operations. +"""Structured event logging for Firefly Agentic operations. :class:`FireflyEvents` emits structured log records for agent runs, tool executions, reasoning steps, and lifecycle transitions. @@ -26,7 +26,7 @@ from pydantic import BaseModel, Field -logger = logging.getLogger("fireflyframework_genai.events") +logger = logging.getLogger("fireflyframework_agentic.events") class FireflyEvent(BaseModel): diff --git a/src/fireflyframework_genai/observability/exporters.py b/src/fireflyframework_agentic/observability/exporters.py similarity index 98% rename from src/fireflyframework_genai/observability/exporters.py rename to src/fireflyframework_agentic/observability/exporters.py index 23d86950..827f8f0f 100644 --- a/src/fireflyframework_genai/observability/exporters.py +++ b/src/fireflyframework_agentic/observability/exporters.py @@ -36,7 +36,7 @@ def configure_exporters( *, - service_name: str = "fireflyframework_genai", + service_name: str = "fireflyframework_agentic", otlp_endpoint: str | None = None, console: bool = False, ) -> TracerProvider: diff --git a/src/fireflyframework_genai/observability/metrics.py b/src/fireflyframework_agentic/observability/metrics.py similarity index 97% rename from src/fireflyframework_genai/observability/metrics.py rename to src/fireflyframework_agentic/observability/metrics.py index 780aad69..51503d73 100644 --- a/src/fireflyframework_genai/observability/metrics.py +++ b/src/fireflyframework_agentic/observability/metrics.py @@ -12,7 +12,7 @@ # See the License for the specific language governing permissions and # limitations under the License. -"""Metrics collection for Firefly GenAI agents. +"""Metrics collection for Firefly Agentic agents. :class:`FireflyMetrics` uses the OpenTelemetry metrics API to record token usage, latency, cost estimates, and error rates. @@ -22,7 +22,7 @@ from opentelemetry import metrics -_METER_NAME = "fireflyframework_genai" +_METER_NAME = "fireflyframework_agentic" class FireflyMetrics: diff --git a/src/fireflyframework_genai/observability/quota.py b/src/fireflyframework_agentic/observability/quota.py similarity index 98% rename from src/fireflyframework_genai/observability/quota.py rename to src/fireflyframework_agentic/observability/quota.py index 455a164e..4a29c4e9 100644 --- a/src/fireflyframework_genai/observability/quota.py +++ b/src/fireflyframework_agentic/observability/quota.py @@ -16,7 +16,7 @@ This module provides production-grade quota enforcement, rate limiting, and adaptive backoff for LLM API calls. It integrates with the existing -:class:`~fireflyframework_genai.observability.usage.UsageTracker` to enforce: +:class:`~fireflyframework_agentic.observability.usage.UsageTracker` to enforce: - **Daily budget limits** in USD - **Per-model rate limits** (requests per minute) @@ -26,7 +26,7 @@ Example: Basic quota management:: - from fireflyframework_genai.observability.quota import QuotaManager + from fireflyframework_agentic.observability.quota import QuotaManager quota = QuotaManager( daily_budget_usd=10.0, @@ -54,7 +54,7 @@ from collections import defaultdict from datetime import UTC, date, datetime -from fireflyframework_genai.exceptions import BudgetExceededError, RateLimitError +from fireflyframework_agentic.exceptions import BudgetExceededError, RateLimitError logger = logging.getLogger(__name__) @@ -516,7 +516,7 @@ def create_quota_manager_from_config() -> QuotaManager | None: Returns: QuotaManager instance if quota management is enabled, None otherwise. """ - from fireflyframework_genai.config import get_config + from fireflyframework_agentic.config import get_config cfg = get_config() diff --git a/src/fireflyframework_genai/observability/tracer.py b/src/fireflyframework_agentic/observability/tracer.py similarity index 98% rename from src/fireflyframework_genai/observability/tracer.py rename to src/fireflyframework_agentic/observability/tracer.py index 60fc82fa..6180203e 100644 --- a/src/fireflyframework_genai/observability/tracer.py +++ b/src/fireflyframework_agentic/observability/tracer.py @@ -12,7 +12,7 @@ # See the License for the specific language governing permissions and # limitations under the License. -"""OpenTelemetry tracer integration for Firefly GenAI. +"""OpenTelemetry tracer integration for Firefly Agentic. :class:`FireflyTracer` wraps the OpenTelemetry tracer with convenience methods for creating agent- and tool-scoped spans. @@ -31,7 +31,7 @@ from opentelemetry import trace from opentelemetry.trace import Span, SpanContext, StatusCode, TraceFlags, Tracer -_TRACER_NAME = "fireflyframework_genai" +_TRACER_NAME = "fireflyframework_agentic" # Context variable for trace propagation across async boundaries _trace_context: ContextVar[SpanContext | None] = ContextVar("trace_context", default=None) diff --git a/src/fireflyframework_genai/observability/usage.py b/src/fireflyframework_agentic/observability/usage.py similarity index 95% rename from src/fireflyframework_genai/observability/usage.py rename to src/fireflyframework_agentic/observability/usage.py index 21ace612..9bc32dcf 100644 --- a/src/fireflyframework_genai/observability/usage.py +++ b/src/fireflyframework_agentic/observability/usage.py @@ -17,8 +17,8 @@ :class:`UsageTracker` is the central accumulator for token usage, cost, and latency across all agents, reasoning patterns, and pipeline nodes. Each call is captured as a :class:`UsageRecord` and automatically emitted -to :class:`~fireflyframework_genai.observability.metrics.FireflyMetrics` -and :class:`~fireflyframework_genai.observability.events.FireflyEvents`. +to :class:`~fireflyframework_agentic.observability.metrics.FireflyMetrics` +and :class:`~fireflyframework_agentic.observability.events.FireflyEvents`. """ from __future__ import annotations @@ -220,7 +220,7 @@ def reset(self) -> None: def _emit_metrics(usage: UsageRecord) -> None: """Send usage data to OTel metrics.""" try: - from fireflyframework_genai.observability.metrics import default_metrics + from fireflyframework_agentic.observability.metrics import default_metrics if usage.total_tokens > 0: default_metrics.record_tokens(usage.total_tokens, agent=usage.agent, model=usage.model) @@ -239,7 +239,7 @@ def _emit_metrics(usage: UsageRecord) -> None: def _emit_event(usage: UsageRecord) -> None: """Emit a structured event for the usage record.""" try: - from fireflyframework_genai.observability.events import default_events + from fireflyframework_agentic.observability.events import default_events default_events.agent_completed( usage.agent, @@ -256,7 +256,7 @@ def _emit_event(usage: UsageRecord) -> None: def _check_budget(self, usage: UsageRecord) -> None: """Log warnings when budget thresholds are exceeded.""" try: - from fireflyframework_genai.config import get_config + from fireflyframework_agentic.config import get_config cfg = get_config() if not cfg.cost_tracking_enabled: @@ -288,7 +288,7 @@ def _check_budget(self, usage: UsageRecord) -> None: def _create_default_tracker() -> UsageTracker: """Create the default tracker with config-driven max_records.""" try: - from fireflyframework_genai.config import get_config + from fireflyframework_agentic.config import get_config return UsageTracker(max_records=get_config().usage_tracker_max_records) except Exception: # noqa: BLE001 diff --git a/src/fireflyframework_genai/pipeline/__init__.py b/src/fireflyframework_agentic/pipeline/__init__.py similarity index 75% rename from src/fireflyframework_genai/pipeline/__init__.py rename to src/fireflyframework_agentic/pipeline/__init__.py index a514f01a..990efc38 100644 --- a/src/fireflyframework_genai/pipeline/__init__.py +++ b/src/fireflyframework_agentic/pipeline/__init__.py @@ -19,12 +19,12 @@ pipelines where independent stages execute concurrently. """ -from fireflyframework_genai.pipeline.builder import PipelineBuilder -from fireflyframework_genai.pipeline.context import PipelineContext -from fireflyframework_genai.pipeline.dag import DAG, DAGEdge, DAGNode, FailureStrategy -from fireflyframework_genai.pipeline.engine import PipelineEngine, PipelineEventHandler -from fireflyframework_genai.pipeline.result import ExecutionTraceEntry, NodeResult, PipelineResult -from fireflyframework_genai.pipeline.steps import ( +from fireflyframework_agentic.pipeline.builder import PipelineBuilder +from fireflyframework_agentic.pipeline.context import PipelineContext +from fireflyframework_agentic.pipeline.dag import DAG, DAGEdge, DAGNode, FailureStrategy +from fireflyframework_agentic.pipeline.engine import PipelineEngine, PipelineEventHandler +from fireflyframework_agentic.pipeline.result import ExecutionTraceEntry, NodeResult, PipelineResult +from fireflyframework_agentic.pipeline.steps import ( AgentStep, BatchLLMStep, BranchStep, diff --git a/src/fireflyframework_genai/pipeline/builder.py b/src/fireflyframework_agentic/pipeline/builder.py similarity index 95% rename from src/fireflyframework_genai/pipeline/builder.py rename to src/fireflyframework_agentic/pipeline/builder.py index 47258751..3b07c3ad 100644 --- a/src/fireflyframework_genai/pipeline/builder.py +++ b/src/fireflyframework_agentic/pipeline/builder.py @@ -32,9 +32,9 @@ from collections.abc import Callable from typing import Any -from fireflyframework_genai.pipeline.dag import DAG, DAGEdge, DAGNode, FailureStrategy -from fireflyframework_genai.pipeline.engine import PipelineEngine -from fireflyframework_genai.pipeline.steps import AgentStep, CallableStep, StepExecutor +from fireflyframework_agentic.pipeline.dag import DAG, DAGEdge, DAGNode, FailureStrategy +from fireflyframework_agentic.pipeline.engine import PipelineEngine +from fireflyframework_agentic.pipeline.steps import AgentStep, CallableStep, StepExecutor class PipelineBuilder: diff --git a/src/fireflyframework_genai/pipeline/context.py b/src/fireflyframework_agentic/pipeline/context.py similarity index 97% rename from src/fireflyframework_genai/pipeline/context.py rename to src/fireflyframework_agentic/pipeline/context.py index 1dad3b34..e894f10b 100644 --- a/src/fireflyframework_genai/pipeline/context.py +++ b/src/fireflyframework_agentic/pipeline/context.py @@ -20,7 +20,7 @@ from typing import TYPE_CHECKING, Any if TYPE_CHECKING: - from fireflyframework_genai.memory.manager import MemoryManager + from fireflyframework_agentic.memory.manager import MemoryManager class PipelineContext: diff --git a/src/fireflyframework_genai/pipeline/dag.py b/src/fireflyframework_agentic/pipeline/dag.py similarity index 99% rename from src/fireflyframework_genai/pipeline/dag.py rename to src/fireflyframework_agentic/pipeline/dag.py index 7e4a71f8..d8c69322 100644 --- a/src/fireflyframework_genai/pipeline/dag.py +++ b/src/fireflyframework_agentic/pipeline/dag.py @@ -28,7 +28,7 @@ from pydantic import BaseModel -from fireflyframework_genai.exceptions import PipelineError +from fireflyframework_agentic.exceptions import PipelineError class FailureStrategy(StrEnum): diff --git a/src/fireflyframework_genai/pipeline/engine.py b/src/fireflyframework_agentic/pipeline/engine.py similarity index 96% rename from src/fireflyframework_genai/pipeline/engine.py rename to src/fireflyframework_agentic/pipeline/engine.py index f378bc82..d0ffa507 100644 --- a/src/fireflyframework_genai/pipeline/engine.py +++ b/src/fireflyframework_agentic/pipeline/engine.py @@ -24,9 +24,9 @@ from datetime import UTC, datetime from typing import Any, Protocol, runtime_checkable -from fireflyframework_genai.pipeline.context import PipelineContext -from fireflyframework_genai.pipeline.dag import DAG, FailureStrategy -from fireflyframework_genai.pipeline.result import ( +from fireflyframework_agentic.pipeline.context import PipelineContext +from fireflyframework_agentic.pipeline.dag import DAG, FailureStrategy +from fireflyframework_agentic.pipeline.result import ( ExecutionTraceEntry, NodeResult, PipelineResult, @@ -342,13 +342,13 @@ async def _execute_node( def _start_otel_span(name: str, **attributes: Any) -> Any: """Start an OTel span if observability is enabled, else return *None*.""" try: - from fireflyframework_genai.config import get_config + from fireflyframework_agentic.config import get_config if not get_config().observability_enabled: return None from opentelemetry import trace - return trace.get_tracer("fireflyframework_genai").start_span( + return trace.get_tracer("fireflyframework_agentic").start_span( name, attributes={f"firefly.{k}": str(v) for k, v in attributes.items()}, ) @@ -359,12 +359,12 @@ def _start_otel_span(name: str, **attributes: Any) -> Any: def _aggregate_usage(correlation_id: str) -> Any: """Aggregate usage records for the given correlation ID.""" try: - from fireflyframework_genai.config import get_config + from fireflyframework_agentic.config import get_config if not get_config().cost_tracking_enabled: return None - from fireflyframework_genai.observability.usage import default_usage_tracker + from fireflyframework_agentic.observability.usage import default_usage_tracker summary = default_usage_tracker.get_summary_for_correlation(correlation_id) return summary if summary.record_count > 0 else None diff --git a/src/fireflyframework_genai/pipeline/result.py b/src/fireflyframework_agentic/pipeline/result.py similarity index 97% rename from src/fireflyframework_genai/pipeline/result.py rename to src/fireflyframework_agentic/pipeline/result.py index 334f531b..b5b9967c 100644 --- a/src/fireflyframework_genai/pipeline/result.py +++ b/src/fireflyframework_agentic/pipeline/result.py @@ -21,7 +21,7 @@ from pydantic import BaseModel, Field -from fireflyframework_genai.observability.usage import UsageSummary +from fireflyframework_agentic.observability.usage import UsageSummary class NodeResult(BaseModel): diff --git a/src/fireflyframework_genai/pipeline/steps.py b/src/fireflyframework_agentic/pipeline/steps.py similarity index 98% rename from src/fireflyframework_genai/pipeline/steps.py rename to src/fireflyframework_agentic/pipeline/steps.py index 4a04143d..1f9cf737 100644 --- a/src/fireflyframework_genai/pipeline/steps.py +++ b/src/fireflyframework_agentic/pipeline/steps.py @@ -23,10 +23,10 @@ from collections.abc import Callable, Coroutine from typing import Any, Protocol, runtime_checkable -from fireflyframework_genai.embeddings.base import EmbeddingProtocol -from fireflyframework_genai.pipeline.context import PipelineContext -from fireflyframework_genai.types import AgentLike -from fireflyframework_genai.vectorstores.base import VectorStoreProtocol +from fireflyframework_agentic.embeddings.base import EmbeddingProtocol +from fireflyframework_agentic.pipeline.context import PipelineContext +from fireflyframework_agentic.types import AgentLike +from fireflyframework_agentic.vectorstores.base import VectorStoreProtocol logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/plugin.py b/src/fireflyframework_agentic/plugin.py similarity index 90% rename from src/fireflyframework_genai/plugin.py rename to src/fireflyframework_agentic/plugin.py index 86933617..0011fc21 100644 --- a/src/fireflyframework_genai/plugin.py +++ b/src/fireflyframework_agentic/plugin.py @@ -12,18 +12,18 @@ # See the License for the specific language governing permissions and # limitations under the License. -"""Plugin discovery system for the Firefly GenAI framework. +"""Plugin discovery system for the Firefly Agentic framework. Third-party packages can register agents, tools, and reasoning patterns by declaring entry points in their ``pyproject.toml``:: - [project.entry-points."fireflyframework_genai.agents"] + [project.entry-points."fireflyframework_agentic.agents"] my_agent = "my_package.agents:MyAgent" - [project.entry-points."fireflyframework_genai.tools"] + [project.entry-points."fireflyframework_agentic.tools"] my_tool = "my_package.tools:MyTool" - [project.entry-points."fireflyframework_genai.reasoning_patterns"] + [project.entry-points."fireflyframework_agentic.reasoning_patterns"] my_pattern = "my_package.reasoning:MyPattern" On startup, :meth:`PluginDiscovery.discover_all` scans these groups and loads @@ -41,9 +41,9 @@ logger = logging.getLogger(__name__) # Well-known entry-point group names -ENTRY_POINT_AGENTS = "fireflyframework_genai.agents" -ENTRY_POINT_TOOLS = "fireflyframework_genai.tools" -ENTRY_POINT_REASONING = "fireflyframework_genai.reasoning_patterns" +ENTRY_POINT_AGENTS = "fireflyframework_agentic.agents" +ENTRY_POINT_TOOLS = "fireflyframework_agentic.tools" +ENTRY_POINT_REASONING = "fireflyframework_agentic.reasoning_patterns" ALL_GROUPS = (ENTRY_POINT_AGENTS, ENTRY_POINT_TOOLS, ENTRY_POINT_REASONING) diff --git a/src/fireflyframework_genai/prompts/__init__.py b/src/fireflyframework_agentic/prompts/__init__.py similarity index 75% rename from src/fireflyframework_genai/prompts/__init__.py rename to src/fireflyframework_agentic/prompts/__init__.py index 37419f7e..efc4b82d 100644 --- a/src/fireflyframework_genai/prompts/__init__.py +++ b/src/fireflyframework_agentic/prompts/__init__.py @@ -14,19 +14,19 @@ """Prompts subpackage -- templates, registry, composition, validation, and loading.""" -from fireflyframework_genai.prompts.composer import ( +from fireflyframework_agentic.prompts.composer import ( ConditionalComposer, MergeComposer, SequentialComposer, ) -from fireflyframework_genai.prompts.loader import PromptLoader -from fireflyframework_genai.prompts.registry import PromptRegistry, prompt_registry -from fireflyframework_genai.prompts.template import ( +from fireflyframework_agentic.prompts.loader import PromptLoader +from fireflyframework_agentic.prompts.registry import PromptRegistry, prompt_registry +from fireflyframework_agentic.prompts.template import ( PromptInfo, PromptTemplate, PromptVariable, ) -from fireflyframework_genai.prompts.validator import PromptValidator, ValidationResult +from fireflyframework_agentic.prompts.validator import PromptValidator, ValidationResult __all__ = [ "ConditionalComposer", diff --git a/src/fireflyframework_genai/prompts/composer.py b/src/fireflyframework_agentic/prompts/composer.py similarity index 97% rename from src/fireflyframework_genai/prompts/composer.py rename to src/fireflyframework_agentic/prompts/composer.py index 0bb298c2..3d4c7dba 100644 --- a/src/fireflyframework_genai/prompts/composer.py +++ b/src/fireflyframework_agentic/prompts/composer.py @@ -23,7 +23,7 @@ from collections.abc import Callable, Sequence from typing import Any -from fireflyframework_genai.prompts.template import PromptTemplate +from fireflyframework_agentic.prompts.template import PromptTemplate class SequentialComposer: diff --git a/src/fireflyframework_genai/prompts/loader.py b/src/fireflyframework_agentic/prompts/loader.py similarity index 97% rename from src/fireflyframework_genai/prompts/loader.py rename to src/fireflyframework_agentic/prompts/loader.py index b41fe4ba..888c3ce3 100644 --- a/src/fireflyframework_genai/prompts/loader.py +++ b/src/fireflyframework_agentic/prompts/loader.py @@ -24,7 +24,7 @@ from collections.abc import Sequence from pathlib import Path -from fireflyframework_genai.prompts.template import PromptTemplate, PromptVariable +from fireflyframework_agentic.prompts.template import PromptTemplate, PromptVariable logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/prompts/registry.py b/src/fireflyframework_agentic/prompts/registry.py similarity index 95% rename from src/fireflyframework_genai/prompts/registry.py rename to src/fireflyframework_agentic/prompts/registry.py index c2bda438..3470e761 100644 --- a/src/fireflyframework_genai/prompts/registry.py +++ b/src/fireflyframework_agentic/prompts/registry.py @@ -23,8 +23,8 @@ import logging -from fireflyframework_genai.exceptions import PromptNotFoundError -from fireflyframework_genai.prompts.template import PromptInfo, PromptTemplate +from fireflyframework_agentic.exceptions import PromptNotFoundError +from fireflyframework_agentic.prompts.template import PromptInfo, PromptTemplate logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/prompts/template.py b/src/fireflyframework_agentic/prompts/template.py similarity index 97% rename from src/fireflyframework_genai/prompts/template.py rename to src/fireflyframework_agentic/prompts/template.py index a1783291..e35deec4 100644 --- a/src/fireflyframework_genai/prompts/template.py +++ b/src/fireflyframework_agentic/prompts/template.py @@ -27,8 +27,8 @@ from jinja2 import BaseLoader, Environment, TemplateSyntaxError from pydantic import BaseModel -from fireflyframework_genai.exceptions import PromptError, PromptValidationError -from fireflyframework_genai.types import Metadata +from fireflyframework_agentic.exceptions import PromptError, PromptValidationError +from fireflyframework_agentic.types import Metadata # Shared Jinja2 environment with safe defaults _jinja_env = Environment(loader=BaseLoader(), autoescape=False, keep_trailing_newline=True) diff --git a/src/fireflyframework_genai/prompts/validator.py b/src/fireflyframework_agentic/prompts/validator.py similarity index 100% rename from src/fireflyframework_genai/prompts/validator.py rename to src/fireflyframework_agentic/prompts/validator.py diff --git a/src/fireflyframework_genai/py.typed b/src/fireflyframework_agentic/py.typed similarity index 100% rename from src/fireflyframework_genai/py.typed rename to src/fireflyframework_agentic/py.typed diff --git a/src/fireflyframework_genai/reasoning/__init__.py b/src/fireflyframework_agentic/reasoning/__init__.py similarity index 75% rename from src/fireflyframework_genai/reasoning/__init__.py rename to src/fireflyframework_agentic/reasoning/__init__.py index f020488d..c70c8a65 100644 --- a/src/fireflyframework_genai/reasoning/__init__.py +++ b/src/fireflyframework_agentic/reasoning/__init__.py @@ -14,13 +14,13 @@ """Reasoning subpackage -- patterns, traces, models, prompts, registry, and pipeline.""" -from fireflyframework_genai.reasoning.base import ( +from fireflyframework_agentic.reasoning.base import ( AbstractReasoningPattern, ReasoningPattern, ) -from fireflyframework_genai.reasoning.chain_of_thought import ChainOfThoughtPattern -from fireflyframework_genai.reasoning.goal_decomposition import GoalDecompositionPattern -from fireflyframework_genai.reasoning.models import ( +from fireflyframework_agentic.reasoning.chain_of_thought import ChainOfThoughtPattern +from fireflyframework_agentic.reasoning.goal_decomposition import GoalDecompositionPattern +from fireflyframework_agentic.reasoning.models import ( BranchEvaluation, BranchList, GoalDecompositionResult, @@ -32,9 +32,9 @@ ReflectionVerdict, StepStatus, ) -from fireflyframework_genai.reasoning.pipeline import ReasoningPipeline -from fireflyframework_genai.reasoning.plan_and_execute import PlanAndExecutePattern -from fireflyframework_genai.reasoning.prompts import ( +from fireflyframework_agentic.reasoning.pipeline import ReasoningPipeline +from fireflyframework_agentic.reasoning.plan_and_execute import PlanAndExecutePattern +from fireflyframework_agentic.reasoning.prompts import ( COT_STEP_PROMPT, GOAL_DECOMPOSE_PROMPT, GOAL_PLAN_PHASE_PROMPT, @@ -50,13 +50,13 @@ TOT_EVALUATE_PROMPT, register_reasoning_prompts, ) -from fireflyframework_genai.reasoning.react import ReActPattern -from fireflyframework_genai.reasoning.reflexion import ReflexionPattern -from fireflyframework_genai.reasoning.registry import ( +from fireflyframework_agentic.reasoning.react import ReActPattern +from fireflyframework_agentic.reasoning.reflexion import ReflexionPattern +from fireflyframework_agentic.reasoning.registry import ( ReasoningPatternRegistry, reasoning_registry, ) -from fireflyframework_genai.reasoning.trace import ( +from fireflyframework_agentic.reasoning.trace import ( ActionStep, ObservationStep, PlanStep, @@ -66,7 +66,7 @@ ReflectionStep, ThoughtStep, ) -from fireflyframework_genai.reasoning.tree_of_thoughts import TreeOfThoughtsPattern +from fireflyframework_agentic.reasoning.tree_of_thoughts import TreeOfThoughtsPattern __all__ = [ "AbstractReasoningPattern", diff --git a/src/fireflyframework_genai/reasoning/base.py b/src/fireflyframework_agentic/reasoning/base.py similarity index 94% rename from src/fireflyframework_genai/reasoning/base.py rename to src/fireflyframework_agentic/reasoning/base.py index 1d744e34..dc91fd33 100644 --- a/src/fireflyframework_genai/reasoning/base.py +++ b/src/fireflyframework_agentic/reasoning/base.py @@ -37,18 +37,18 @@ from pydantic_ai import Agent as PydanticAgent from pydantic_ai.models import Model -from fireflyframework_genai.exceptions import ReasoningError, ReasoningStepLimitError -from fireflyframework_genai.prompts.template import PromptTemplate -from fireflyframework_genai.reasoning.trace import ( +from fireflyframework_agentic.exceptions import ReasoningError, ReasoningStepLimitError +from fireflyframework_agentic.prompts.template import PromptTemplate +from fireflyframework_agentic.reasoning.trace import ( ReasoningResult, ReasoningStep, ReasoningTrace, ) -from fireflyframework_genai.types import AgentLike, UserContent +from fireflyframework_agentic.types import AgentLike, UserContent if TYPE_CHECKING: - from fireflyframework_genai.memory.manager import MemoryManager - from fireflyframework_genai.validation.reviewer import OutputReviewer + from fireflyframework_agentic.memory.manager import MemoryManager + from fireflyframework_agentic.validation.reviewer import OutputReviewer logger = logging.getLogger(__name__) @@ -236,7 +236,7 @@ def _fallback_parse(raw: Any, output_type: type[T]) -> T: pass # Type-specific text fallbacks - from fireflyframework_genai.reasoning.models import ( + from fireflyframework_agentic.reasoning.models import ( BranchEvaluation, GoalDecompositionResult, GoalPhase, @@ -265,7 +265,7 @@ def _fallback_parse(raw: Any, output_type: type[T]) -> T: phases = [GoalPhase(name=ln) for ln in lines] return GoalDecompositionResult(goal="", phases=phases) # type: ignore[return-value] - from fireflyframework_genai.reasoning.models import BranchList + from fireflyframework_agentic.reasoning.models import BranchList if output_type is BranchList: branches = [b.strip() for b in raw_str.split("---") if b.strip()] @@ -286,7 +286,7 @@ def _init_memory(memory: Any, pattern_name: str) -> MemoryManager | None: If *memory* is not a ``MemoryManager`` (or is ``None``), returns ``None`` and memory integration is disabled. """ - from fireflyframework_genai.memory.manager import MemoryManager + from fireflyframework_agentic.memory.manager import MemoryManager if isinstance(memory, MemoryManager): return memory.fork(working_scope_id=f"reasoning:{pattern_name}") @@ -323,10 +323,10 @@ async def execute(self, agent: AgentLike, input: str | Sequence[UserContent], ** """Run the reasoning loop. *input* may be a plain string or a sequence of multimodal - :class:`~fireflyframework_genai.types.UserContent` parts. + :class:`~fireflyframework_agentic.types.UserContent` parts. If ``memory`` is passed as a keyword argument (a - :class:`~fireflyframework_genai.memory.manager.MemoryManager`), + :class:`~fireflyframework_agentic.memory.manager.MemoryManager`), the pattern forks it into an isolated working-memory scope and automatically persists each reasoning step. Working memory context is available to subclass hooks via ``state["memory"]``. @@ -449,7 +449,7 @@ async def _review_output(self, state: dict[str, Any], output: Any) -> Any: If review fails after all retries, the original output is returned with a warning logged (non-fatal by default). """ - from fireflyframework_genai.exceptions import OutputReviewError + from fireflyframework_agentic.exceptions import OutputReviewError reviewer = self._reviewer if reviewer is None: @@ -476,7 +476,7 @@ def _record_structured_usage( ) -> None: """Record usage from an ephemeral agent result.""" try: - from fireflyframework_genai.config import get_config + from fireflyframework_agentic.config import get_config cfg = get_config() if not cfg.cost_tracking_enabled: @@ -486,8 +486,8 @@ def _record_structured_usage( if usage is None: return - from fireflyframework_genai.observability.cost import get_cost_calculator - from fireflyframework_genai.observability.usage import UsageRecord, default_usage_tracker + from fireflyframework_agentic.observability.cost import get_cost_calculator + from fireflyframework_agentic.observability.usage import UsageRecord, default_usage_tracker input_tokens = getattr(usage, "input_tokens", 0) or 0 output_tokens = getattr(usage, "output_tokens", 0) or 0 diff --git a/src/fireflyframework_genai/reasoning/chain_of_thought.py b/src/fireflyframework_agentic/reasoning/chain_of_thought.py similarity index 89% rename from src/fireflyframework_genai/reasoning/chain_of_thought.py rename to src/fireflyframework_agentic/reasoning/chain_of_thought.py index 438944fa..532ed8c7 100644 --- a/src/fireflyframework_genai/reasoning/chain_of_thought.py +++ b/src/fireflyframework_agentic/reasoning/chain_of_thought.py @@ -16,7 +16,7 @@ The simplest pattern. The agent reasons through the problem step by step, validating each step, until it reaches a conclusion signalled by the -:class:`~fireflyframework_genai.reasoning.models.ReasoningThought` +:class:`~fireflyframework_agentic.reasoning.models.ReasoningThought` ``is_final`` flag. """ @@ -27,17 +27,17 @@ from pydantic_ai.models import Model -from fireflyframework_genai.prompts.template import PromptTemplate -from fireflyframework_genai.reasoning.base import AbstractReasoningPattern -from fireflyframework_genai.reasoning.models import ReasoningThought -from fireflyframework_genai.reasoning.prompts import COT_STEP_PROMPT -from fireflyframework_genai.reasoning.trace import ( +from fireflyframework_agentic.prompts.template import PromptTemplate +from fireflyframework_agentic.reasoning.base import AbstractReasoningPattern +from fireflyframework_agentic.reasoning.models import ReasoningThought +from fireflyframework_agentic.reasoning.prompts import COT_STEP_PROMPT +from fireflyframework_agentic.reasoning.trace import ( ReasoningStep, ThoughtStep, ) if TYPE_CHECKING: - from fireflyframework_genai.validation.reviewer import OutputReviewer + from fireflyframework_agentic.validation.reviewer import OutputReviewer logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/reasoning/goal_decomposition.py b/src/fireflyframework_agentic/reasoning/goal_decomposition.py similarity index 93% rename from src/fireflyframework_genai/reasoning/goal_decomposition.py rename to src/fireflyframework_agentic/reasoning/goal_decomposition.py index cfe5549f..c00a0341 100644 --- a/src/fireflyframework_genai/reasoning/goal_decomposition.py +++ b/src/fireflyframework_agentic/reasoning/goal_decomposition.py @@ -15,7 +15,7 @@ """Goal Decomposition reasoning pattern: Goal -> Phases -> Tasks. Hierarchically decomposes a high-level goal into structured -:class:`~fireflyframework_genai.reasoning.models.GoalPhase` objects +:class:`~fireflyframework_agentic.reasoning.models.GoalPhase` objects with typed task lists. Each task can optionally be delegated to another reasoning pattern (e.g. ReAct). """ @@ -29,17 +29,17 @@ from pydantic_ai.models import Model -from fireflyframework_genai.prompts.template import PromptTemplate -from fireflyframework_genai.reasoning.base import AbstractReasoningPattern -from fireflyframework_genai.reasoning.models import ( +from fireflyframework_agentic.prompts.template import PromptTemplate +from fireflyframework_agentic.reasoning.base import AbstractReasoningPattern +from fireflyframework_agentic.reasoning.models import ( GoalDecompositionResult, ) -from fireflyframework_genai.reasoning.prompts import ( +from fireflyframework_agentic.reasoning.prompts import ( GOAL_DECOMPOSE_PROMPT, GOAL_PLAN_PHASE_PROMPT, GOAL_TASK_EXECUTION_PROMPT, ) -from fireflyframework_genai.reasoning.trace import ( +from fireflyframework_agentic.reasoning.trace import ( ActionStep, ObservationStep, PlanStep, @@ -47,10 +47,10 @@ ReasoningStep, ReasoningTrace, ) -from fireflyframework_genai.types import AgentLike, UserContent +from fireflyframework_agentic.types import AgentLike, UserContent if TYPE_CHECKING: - from fireflyframework_genai.validation.reviewer import OutputReviewer + from fireflyframework_agentic.validation.reviewer import OutputReviewer logger = logging.getLogger(__name__) diff --git a/src/fireflyframework_genai/reasoning/models.py b/src/fireflyframework_agentic/reasoning/models.py similarity index 100% rename from src/fireflyframework_genai/reasoning/models.py rename to src/fireflyframework_agentic/reasoning/models.py diff --git a/src/fireflyframework_genai/reasoning/pipeline.py b/src/fireflyframework_agentic/reasoning/pipeline.py similarity index 95% rename from src/fireflyframework_genai/reasoning/pipeline.py rename to src/fireflyframework_agentic/reasoning/pipeline.py index 8412d3bb..e6c1c8b1 100644 --- a/src/fireflyframework_genai/reasoning/pipeline.py +++ b/src/fireflyframework_agentic/reasoning/pipeline.py @@ -25,11 +25,11 @@ from collections.abc import Sequence from typing import Any -from fireflyframework_genai.reasoning.trace import ( +from fireflyframework_agentic.reasoning.trace import ( ReasoningResult, ReasoningTrace, ) -from fireflyframework_genai.types import AgentLike, UserContent +from fireflyframework_agentic.types import AgentLike, UserContent # Use a structural (duck-typing) check rather than importing the Protocol # to avoid circular dependencies. @@ -62,7 +62,7 @@ async def execute(self, agent: AgentLike, input: str | Sequence[UserContent], ** subsequent patterns receive the string output of the previous pattern. If a ``memory`` keyword argument is provided (a - :class:`~fireflyframework_genai.memory.manager.MemoryManager`), + :class:`~fireflyframework_agentic.memory.manager.MemoryManager`), it is passed through to **every** pattern's ``execute()`` call. Because each pattern forks the memory into its own working-memory scope (``reasoning:
No matching models
'),Xt=I('Not configured'),ea=I(''),ta=I(' Type any model ID for unlisted models
No matching models
'),Wn=j('Not configured'),Hn=j(''),Gn=j(' Type any model ID for unlisted models
'+(n?t:V(t,!0))+`"+(n?t:V(t,!0))+`-${this.parser.parse(r)}-`}html({text:r}){return r}def(r){return""}heading({tokens:r,depth:e}){return`
-`}list(r){let e=r.ordered,n=r.start,s="";for(let a=0;a
${this.parser.parseInline(r)}
-`}table(r){let e="",n="";for(let t=0;t${V(r,!0)}`}br(r){return""}del({tokens:r}){return`
An error occurred:
"+V(n.message+"",!0)+"";return e?Promise.resolve(s):s}if(e)return Promise.reject(n);throw n}}},le=new Cr;function R(r,e){return le.parse(r,e)}R.options=R.setOptions=function(r){return le.setOptions(r),R.defaults=le.defaults,Rt(R.defaults),R};R.getDefaults=He;R.defaults=oe;R.use=function(...r){return le.use(...r),R.defaults=le.defaults,Rt(R.defaults),R};R.walkTokens=function(r,e){return le.walkTokens(r,e)};R.parseInline=le.parseInline;R.Parser=Q;R.parser=Q.parse;R.Renderer=Te;R.TextRenderer=Xe;R.Lexer=F;R.lexer=F.lex;R.Tokenizer=Re;R.Hooks=xe;R.parse=R;R.options;R.setOptions;R.use;R.walkTokens;R.parseInline;Q.parse;F.lex;export{as as A,ls as B,Kr as C,gs as D,vs as E,ns as F,Yr as G,_s as H,xs as I,R as J,Rs as K,Or as L,ms as M,Br as N,Ts as O,Hr as P,As as Q,ss as R,Gr as S,es as T,_n as U,Ss as V,os as W,Pn as X,bs as Z,Xr as a,Qr as b,Fr as c,jr as d,Ur as e,Jr as f,ts as g,An as h,Zr as i,rs as j,is as k,fs as l,cs as m,us as n,ps as o,Vr as p,ds as q,hs as r,ks as s,$s as t,ys as u,ws as v,St as w,zs as x,Nn as y,Wr as z}; diff --git a/studio-desktop/frontend-dist/_app/immutable/chunks/BNectIeB.js b/studio-desktop/frontend-dist/_app/immutable/chunks/BNectIeB.js deleted file mode 100644 index 2c1dd46e..00000000 --- a/studio-desktop/frontend-dist/_app/immutable/chunks/BNectIeB.js +++ /dev/null @@ -1,2 +0,0 @@ -var Nn=Array.isArray,On=Array.prototype.indexOf,me=Array.prototype.includes,Rn=Array.from,kn=Object.defineProperty,Ne=Object.getOwnPropertyDescriptor,Mn=Object.getOwnPropertyDescriptors,Dn=Object.prototype,Cn=Array.prototype,Rt=Object.getPrototypeOf,bt=Object.isExtensible;function Wr(e){return typeof e=="function"}const de=()=>{};function $r(e){return e()}function kt(e){for(var t=0;t
No matching models
'),Ut=B('Not configured'),Qt=B(''),Yt=B(' Type any model ID for unlisted models
No matching models
'),Xt=B('Not configured'),ea=B(''),ta=B(' Type any model ID for unlisted models
Publicly accessible
'),Ii=g(` cloudflared not installed
Cloudflare Tunnel requires the cloudflared CLI tool.
- Install it to enable public tunnel sharing.
macOS (Homebrew)
brew install cloudflared Linux
curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 -o /usr/local/bin/cloudflared && chmod +x /usr/local/bin/cloudflared Send a POST request with JSON to run your pipeline remotely.
Usage Example
Open this URL in any browser to access your studio remotely.
Delete ?
This action cannot be undone.
Projects
Run Pipeline
Provide input for your pipeline (or leave blank to run without input)
No matching commands
'),ho=g(' '),bo=g(''),_o=g(' ESC
Keyboard Shortcuts
ESC The Architect speaks with measured authority and philosophical precision. He will address you by name and guide you through the design of your pipeline.
'),Do=g(' A friendly, helpful AI assistant that guides you through building pipelines.
'),jo=g(`Your Information
The Architect and Oracle use this to personalise interactions.
Assistant Personality
Choose the AI assistant's persona. "The Architect" uses a philosophical, - Matrix-inspired personality. Any other name uses a standard helpful assistant.
Configure API keys for your LLM providers. Keys are stored locally and never sent to external services.
',1),Go=g(' Active'),Ko=g('No service connections configured yet. Click "Add Service" to get started.
'),Xo=g("Configure credentials for pipeline tools. These enable search, database, and messaging capabilities in your pipelines.
Service Connections
Manage external service connections for databases, queues, and third-party APIs.
Default Model
This model is used for new agent nodes and The Architect. You can override per-node.
Generation Parameters
Control the creativity and reliability of model outputs.
Precise Creative
Number of retry attempts if a model call fails.
Firefly Agentic Studio
A visual IDE for building, testing, and deploying AI agent pipelines.
Version 0.1.0-alpha
Framework Firefly Framework GenAI
Backend FastAPI + Python 3.11+
Frontend SvelteKit 5 + TypeScript
License Apache 2.0
Keyboard Shortcuts
Save Pipeline Cmd + S
Toggle Architect Cmd + /
Command Palette Cmd + K
Close Modal / Panel ESC
Welcome to Firefly Agentic Studio
Build, test, and deploy AI agent pipelines visually. - We'll help you configure your AI providers in just a few steps.
Visual pipeline builder
Multi-provider AI support
Local credential storage
Select at least one provider to continue
'),_l=g('Choose your AI providers
Select the providers you have API keys for. You can add more later in Settings.
',1),ml=g('Enter your API keys
Credentials are stored locally at ~/.firefly-studio/settings.json and never sent to our servers.
Configure defaults
Choose the default model for new agent nodes. You can override per-node later.
Personalise your experience
Tell us about yourself so the AI assistant can address you properly and provide contextual help.
as default. The Architect and The Oracle are ready. - The Architect will build your pipelines, and The Oracle will guide your decisions.
You can change these anytime from the Settings menu.
result
'),_c=g(''),kc=g('
'),Ac=g(''),$c=g(''),Nc=g('
Plan
${k||"code"}
${a} Send a POST request with a JSON body to run your pipeline remotely.
Delete ?
This action cannot be undone.
Projects
Run Pipeline
Provide input for your pipeline (or leave blank to run without input)
No matching commands
'),El=w(' '),Sl=w(''),Al=w(' ESC
Keyboard Shortcuts
ESCYour Information
The assistant will use this to personalise interactions.
Assistant Personality
Settings
ESCWelcome to Firefly Agentic Studio
Build, test, and deploy AI agent pipelines visually. - We'll help you configure your AI providers in just a few steps.
Visual pipeline builder
Multi-provider AI support
Local credential storage
Select at least one provider to continue
'),Jl=w('Choose your AI providers
Select the providers you have API keys for. You can add more later in Settings.
',1),eo=w('Enter your API keys
Credentials are stored locally at ~/.firefly-studio/settings.json and never sent to our servers.
Configure defaults
Choose the default model for new agent nodes. You can override per-node later.
Personalise your experience
Tell us about yourself so the AI assistant can address you properly and provide contextual help.
as default. The Architect and The Oracle are ready. - The Architect will build your pipelines, and The Oracle will guide your decisions.
You can change these anytime from the Settings menu.
'+(n?a:ln(a,!0))+`"+(n?a:ln(a,!0))+`-${this.parser.parse(t)}-`}html({text:t}){return t}def(t){return""}heading({tokens:t,depth:e}){return`
-`}list(t){let e=t.ordered,n=t.start,r="";for(let i=0;i
${this.parser.parseInline(t)}
-`}table(t){let e="",n="";for(let a=0;a${ln(t,!0)}`}br(t){return""}del({tokens:t}){return`
An error occurred:
"+ln(n.message+"",!0)+"";return e?Promise.resolve(r):r}if(e)return Promise.reject(n);throw n}}},Pn=new pc;function Ke(t,e){return Pn.parse(t,e)}Ke.options=Ke.setOptions=function(t){return Pn.setOptions(t),Ke.defaults=Pn.defaults,nr(Ke.defaults),Ke};Ke.getDefaults=rs;Ke.defaults=Dn;Ke.use=function(...t){return Pn.use(...t),Ke.defaults=Pn.defaults,nr(Ke.defaults),Ke};Ke.walkTokens=function(t,e){return Pn.walkTokens(t,e)};Ke.parseInline=Pn.parseInline;Ke.Parser=Yt;Ke.parser=Yt.parse;Ke.Renderer=fa;Ke.TextRenderer=gs;Ke.Lexer=Vt;Ke.lexer=Vt.lex;Ke.Tokenizer=ha;Ke.Hooks=Yn;Ke.parse=Ke;Ke.options;Ke.setOptions;Ke.use;Ke.walkTokens;Ke.parseInline;Yt.parse;Vt.lex;function gc(t){return t&&t.__esModule&&Object.prototype.hasOwnProperty.call(t,"default")?t.default:t}var Ia,Ms;function vc(){if(Ms)return Ia;Ms=1;function t(l){return l instanceof Map?l.clear=l.delete=l.set=function(){throw new Error("map is read-only")}:l instanceof Set&&(l.add=l.clear=l.delete=function(){throw new Error("set is read-only")}),Object.freeze(l),Object.getOwnPropertyNames(l).forEach(v=>{const N=l[v],ce=typeof N;(ce==="object"||ce==="function")&&!Object.isFrozen(N)&&t(N)}),l}class e{constructor(v){v.data===void 0&&(v.data={}),this.data=v.data,this.isMatchIgnored=!1}ignoreMatch(){this.isMatchIgnored=!0}}function n(l){return l.replace(/&/g,"&").replace(//g,">").replace(/"/g,""").replace(/'/g,"'")}function r(l,...v){const N=Object.create(null);for(const ce in l)N[ce]=l[ce];return v.forEach(function(ce){for(const He in ce)N[He]=ce[He]}),N}const a="
result
'),Hc=w(''),Zc=w('
'),Yc=w(''),Xc=w(''),Qc=w('
Plan
${Y||"code"}
${H} Send a POST request with a JSON body to run your pipeline remotely.
Delete ?
This action cannot be undone.
Projects
Run Pipeline
Provide input for your pipeline (or leave blank to run without input)
No matching commands
'),Tl=w(' '),Nl=w(''),Rl=w(' ESC
Keyboard Shortcuts
ESCYour Information
The assistant will use this to personalise interactions.
Assistant Personality
Settings
ESCWelcome to Firefly Agentic Studio
Build, test, and deploy AI agent pipelines visually. - We'll help you configure your AI providers in just a few steps.
Visual pipeline builder
Multi-provider AI support
Local credential storage
Select at least one provider to continue
'),no=w('Choose your AI providers
Select the providers you have API keys for. You can add more later in Settings.
',1),ao=w('Enter your API keys
Credentials are stored locally at ~/.firefly-studio/settings.json and never sent to our servers.
Configure defaults
Choose the default model for new agent nodes. You can override per-node later.
Personalise your experience
Tell us about yourself so the AI assistant can address you properly and provide contextual help.
as default. The Architect and The Oracle are ready. - The Architect will build your pipelines, and The Oracle will guide your decisions.
You can change these anytime from the Settings menu.
'+(n?a:ln(a,!0))+`"+(n?a:ln(a,!0))+`-${this.parser.parse(t)}-`}html({text:t}){return t}def(t){return""}heading({tokens:t,depth:e}){return`
-`}list(t){let e=t.ordered,n=t.start,r="";for(let i=0;i
${this.parser.parseInline(t)}
-`}table(t){let e="",n="";for(let a=0;a${ln(t,!0)}`}br(t){return""}del({tokens:t}){return`
An error occurred:
"+ln(n.message+"",!0)+"";return e?Promise.resolve(r):r}if(e)return Promise.reject(n);throw n}}},Pn=new vc;function Ke(t,e){return Pn.parse(t,e)}Ke.options=Ke.setOptions=function(t){return Pn.setOptions(t),Ke.defaults=Pn.defaults,sr(Ke.defaults),Ke};Ke.getDefaults=rs;Ke.defaults=Dn;Ke.use=function(...t){return Pn.use(...t),Ke.defaults=Pn.defaults,sr(Ke.defaults),Ke};Ke.walkTokens=function(t,e){return Pn.walkTokens(t,e)};Ke.parseInline=Pn.parseInline;Ke.Parser=Yt;Ke.parser=Yt.parse;Ke.Renderer=ba;Ke.TextRenderer=gs;Ke.Lexer=Vt;Ke.lexer=Vt.lex;Ke.Tokenizer=fa;Ke.Hooks=Yn;Ke.parse=Ke;Ke.options;Ke.setOptions;Ke.use;Ke.walkTokens;Ke.parseInline;Yt.parse;Vt.lex;function hc(t){return t&&t.__esModule&&Object.prototype.hasOwnProperty.call(t,"default")?t.default:t}var Pa,Os;function fc(){if(Os)return Pa;Os=1;function t(l){return l instanceof Map?l.clear=l.delete=l.set=function(){throw new Error("map is read-only")}:l instanceof Set&&(l.add=l.clear=l.delete=function(){throw new Error("set is read-only")}),Object.freeze(l),Object.getOwnPropertyNames(l).forEach(v=>{const N=l[v],ce=typeof N;(ce==="object"||ce==="function")&&!Object.isFrozen(N)&&t(N)}),l}class e{constructor(v){v.data===void 0&&(v.data={}),this.data=v.data,this.isMatchIgnored=!1}ignoreMatch(){this.isMatchIgnored=!0}}function n(l){return l.replace(/&/g,"&").replace(//g,">").replace(/"/g,""").replace(/'/g,"'")}function r(l,...v){const N=Object.create(null);for(const ce in l)N[ce]=l[ce];return v.forEach(function(ce){for(const He in ce)N[He]=ce[He]}),N}const a="
result
'),Gc=w(''),Vc=w('
'),Qc=w(''),Jc=w(''),ed=w('
Plan
${K||"code"}
${H} Send a POST request with a JSON body to run your pipeline remotely.
Delete ?
This action cannot be undone.
Projects
Run Pipeline
Provide input for your pipeline (or leave blank to run without input)
No matching commands
'),Tl=w(' '),Nl=w(''),Rl=w(' ESC
Keyboard Shortcuts
ESCYour Information
The assistant will use this to personalise interactions.
Assistant Personality
Settings
ESCWelcome to Firefly Agentic Studio
Build, test, and deploy AI agent pipelines visually. - We'll help you configure your AI providers in just a few steps.
Visual pipeline builder
Multi-provider AI support
Local credential storage
Select at least one provider to continue
'),no=w('Choose your AI providers
Select the providers you have API keys for. You can add more later in Settings.
',1),ao=w('Enter your API keys
Credentials are stored locally at ~/.firefly-studio/settings.json and never sent to our servers.
Configure defaults
Choose the default model for new agent nodes. You can override per-node later.
Personalise your experience
Tell us about yourself so the AI assistant can address you properly and provide contextual help.
as default. The Architect and The Oracle are ready. - The Architect will build your pipelines, and The Oracle will guide your decisions.
You can change these anytime from the Settings menu.
'+(n?a:ln(a,!0))+`"+(n?a:ln(a,!0))+`-${this.parser.parse(t)}-`}html({text:t}){return t}def(t){return""}heading({tokens:t,depth:e}){return`
-`}list(t){let e=t.ordered,n=t.start,r="";for(let i=0;i
${this.parser.parseInline(t)}
-`}table(t){let e="",n="";for(let a=0;a${ln(t,!0)}`}br(t){return""}del({tokens:t}){return`
An error occurred:
"+ln(n.message+"",!0)+"";return e?Promise.resolve(r):r}if(e)return Promise.reject(n);throw n}}},Pn=new vc;function Ke(t,e){return Pn.parse(t,e)}Ke.options=Ke.setOptions=function(t){return Pn.setOptions(t),Ke.defaults=Pn.defaults,sr(Ke.defaults),Ke};Ke.getDefaults=rs;Ke.defaults=Dn;Ke.use=function(...t){return Pn.use(...t),Ke.defaults=Pn.defaults,sr(Ke.defaults),Ke};Ke.walkTokens=function(t,e){return Pn.walkTokens(t,e)};Ke.parseInline=Pn.parseInline;Ke.Parser=Yt;Ke.parser=Yt.parse;Ke.Renderer=ba;Ke.TextRenderer=gs;Ke.Lexer=Vt;Ke.lexer=Vt.lex;Ke.Tokenizer=fa;Ke.Hooks=Yn;Ke.parse=Ke;Ke.options;Ke.setOptions;Ke.use;Ke.walkTokens;Ke.parseInline;Yt.parse;Vt.lex;function hc(t){return t&&t.__esModule&&Object.prototype.hasOwnProperty.call(t,"default")?t.default:t}var Pa,Os;function fc(){if(Os)return Pa;Os=1;function t(l){return l instanceof Map?l.clear=l.delete=l.set=function(){throw new Error("map is read-only")}:l instanceof Set&&(l.add=l.clear=l.delete=function(){throw new Error("set is read-only")}),Object.freeze(l),Object.getOwnPropertyNames(l).forEach(v=>{const N=l[v],ce=typeof N;(ce==="object"||ce==="function")&&!Object.isFrozen(N)&&t(N)}),l}class e{constructor(v){v.data===void 0&&(v.data={}),this.data=v.data,this.isMatchIgnored=!1}ignoreMatch(){this.isMatchIgnored=!0}}function n(l){return l.replace(/&/g,"&").replace(//g,">").replace(/"/g,""").replace(/'/g,"'")}function r(l,...v){const N=Object.create(null);for(const ce in l)N[ce]=l[ce];return v.forEach(function(ce){for(const He in ce)N[He]=ce[He]}),N}const a="
result
'),Gc=w(''),Vc=w('
'),Qc=w(''),Jc=w(''),ed=w('
Plan
${K||"code"}
${H}",1);function G(m,n){h(n,!1),u();var r=k(),t=g(r),c=e(t,!0);s(t);var a=x(t,2),f=e(a,!0);s(a),l(()=>{o(c,i.status),o(f,i.error?.message)}),v(m,r),d()}export{G as component}; diff --git a/studio-desktop/frontend-dist/_app/immutable/nodes/1.CM9fyoZO.js b/studio-desktop/frontend-dist/_app/immutable/nodes/1.CM9fyoZO.js deleted file mode 100644 index b8ee8561..00000000 --- a/studio-desktop/frontend-dist/_app/immutable/nodes/1.CM9fyoZO.js +++ /dev/null @@ -1 +0,0 @@ -import"../chunks/DsnmJJEf.js";import{i as u}from"../chunks/CiPkpaXo.js";import{p as h,f as g,z as l,a as v,j as d,A as _,B as e,C as s,D as x,F as o}from"../chunks/BESIXtBI.js";import{s as $,p}from"../chunks/gvU2Nsg7.js";const k={get error(){return p.error},get status(){return p.status}};$.updated.check;const i=k;var b=_("
",1);function C(m,n){h(n,!1),u();var r=b(),t=g(r),c=e(t,!0);s(t);var a=x(t,2),f=e(a,!0);s(a),l(()=>{o(c,i.status),o(f,i.error?.message)}),v(m,r),d()}export{C as component}; diff --git a/studio-desktop/frontend-dist/_app/immutable/nodes/1.CgtKuGLP.js b/studio-desktop/frontend-dist/_app/immutable/nodes/1.CgtKuGLP.js deleted file mode 100644 index 62e86517..00000000 --- a/studio-desktop/frontend-dist/_app/immutable/nodes/1.CgtKuGLP.js +++ /dev/null @@ -1 +0,0 @@ -import"../chunks/DsnmJJEf.js";import{i as u}from"../chunks/D7CioVkw.js";import{p as h,i as g,z as l,j as v,f as d,A as _,B as s,C as a,D as x,F as o}from"../chunks/hL-aZVJ4.js";import{s as $,p}from"../chunks/DEAaRqcq.js";const k={get error(){return p.error},get status(){return p.status}};$.updated.check;const i=k;var b=_("
",1);function C(m,n){h(n,!1),u();var r=b(),t=g(r),c=s(t,!0);a(t);var e=x(t,2),f=s(e,!0);a(e),l(()=>{o(c,i.status),o(f,i.error?.message)}),v(m,r),d()}export{C as component}; diff --git a/studio-desktop/frontend-dist/_app/immutable/nodes/1.Czl_Q6cB.js b/studio-desktop/frontend-dist/_app/immutable/nodes/1.Czl_Q6cB.js deleted file mode 100644 index 9e5d0a27..00000000 --- a/studio-desktop/frontend-dist/_app/immutable/nodes/1.Czl_Q6cB.js +++ /dev/null @@ -1 +0,0 @@ -import"../chunks/DsnmJJEf.js";import{i as u}from"../chunks/l8YpzWR9.js";import{p as g,g as h,z as l,i as v,j as d,A as _,B as s,C as a,D as x,F as o}from"../chunks/DCyBifBO.js";import{s as $,p}from"../chunks/DhiGuJwU.js";const k={get error(){return p.error},get status(){return p.status}};$.updated.check;const i=k;var b=_("
",1);function C(m,n){g(n,!1),u();var r=b(),t=h(r),c=s(t,!0);a(t);var e=x(t,2),f=s(e,!0);a(e),l(()=>{o(c,i.status),o(f,i.error?.message)}),v(m,r),d()}export{C as component}; diff --git a/studio-desktop/frontend-dist/_app/immutable/nodes/2.B2KpwBSe.js b/studio-desktop/frontend-dist/_app/immutable/nodes/2.B2KpwBSe.js deleted file mode 100644 index 62c0e5e9..00000000 --- a/studio-desktop/frontend-dist/_app/immutable/nodes/2.B2KpwBSe.js +++ /dev/null @@ -1 +0,0 @@ -import"../chunks/DsnmJJEf.js";import{c as ne,f as re,a as d,T as Ja,p as et,Q as D,U as at,z as E,V as h,t as a,j as tt,B as n,A as _,D as c,G as l,C as s,W as te,X as st,S as se,R as na,F as $,Y as ra,Z as la}from"../chunks/BESIXtBI.js";import{l as Re,s as Ue,i as x,b as nt,a as rt,c as ia}from"../chunks/CJh9TUc0.js";import{I as qe,s as We,P as ge,S as he,e as Te,b as me,a as lt,c as it,d as Ee,f as ot,g as ct,B as fe,D as Ie,h as Le,p as vt,X as oa,i as ut,F as dt,L as pt,j as gt,l as ht,k as mt,m as ft,n as _t,r as Ne,T as bt,o as yt,u as xt,q as Pt}from"../chunks/0zSFSexy.js";import{g as _e}from"../chunks/gvU2Nsg7.js";import{p as Me,c as Be}from"../chunks/8I91iWf8.js";import{U as be,A as ca,F as wt}from"../chunks/Biw60Ycb.js";import{I as kt}from"../chunks/p0Zj8fW7.js";import"../chunks/CiPkpaXo.js";function zt(R,A){const U=Re(A,["children","$$slots","$$events","$$legacy"]);const q=[["circle",{cx:"12",cy:"12",r:"1"}],["circle",{cx:"12",cy:"5",r:"1"}],["circle",{cx:"12",cy:"19",r:"1"}]];qe(R,Ue({name:"ellipsis-vertical"},()=>U,{get iconNode(){return q},children:(L,le)=>{var k=ne(),P=re(k);We(P,A,"default",{}),d(L,k)},$$slots:{default:!0}}))}function Dt(R,A){const U=Re(A,["children","$$slots","$$events","$$legacy"]);const q=[["path",{d:"M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497z"}],["path",{d:"m15 5 4 4"}]];qe(R,Ue({name:"pencil"},()=>U,{get iconNode(){return q},children:(L,le)=>{var k=ne(),P=re(k);We(P,A,"default",{}),d(L,k)},$$slots:{default:!0}}))}function jt(R,A){const U=Re(A,["children","$$slots","$$events","$$legacy"]);const q=[["path",{d:"M12 4v16"}],["path",{d:"M4 7V5a1 1 0 0 1 1-1h14a1 1 0 0 1 1 1v2"}],["path",{d:"M9 20h6"}]];qe(R,Ue({name:"type"},()=>U,{get iconNode(){return q},children:(L,le)=>{var k=ne(),P=re(k);We(P,A,"default",{}),d(L,k)},$$slots:{default:!0}}))}var $t=_(''),At=_(''),Ft=_('
Creating your project...
'),St=_(''),Ct=_(''),Kt=_('
Your projects
Creating your project...
'),bt=j(''),yt=j(''),xt=j('Recent projects
What do you want to build?
Design, test, and deploy AI agent pipelines visually
Or start from a template
Creating your project...
'),Dt=k(''),Pt=k(''),Ft=k('Recent projects
Describe your AI agent pipeline and The Architect will design it for you
Or start from a template
Creating your project...
'),Ye=k(''),Ze=k(''),ea=k('Recent projects
What do you want to build?
Design, test, and deploy AI agent pipelines visually
Or start from a template
Instructions
'),Gg=x('
Exec In
Exec Out
tool
'),em=x('timeout
'),nm=x('Exec In
Exec Out
Max Steps
'),cm=x('Exec In
Exec Out
In
True
False
action
'),bm=x('namespace
'),xm=x('Exec In
Exec Out
rule
'),Cm=x('on_fail
'),Em=x('Exec In
Exec Out
desc
'),Im=x('code
'),Am=x('In
Out
split
'),Vm=x('max
'),Hm=x('In
Out 1
Out 2
merge
'),jm=x('timeout
'),Wm=x('In 1
In 2
Out
Exec Out
Trigger Config
Exec In
Destination Config
Exposes an HTTP endpoint that triggers this pipeline when called.
Runs the pipeline on a schedule using standard cron syntax.
Manual trigger. Run the pipeline via the Run button or API call.
Returns the pipeline output as an API response.
Custom tool. Define the tool name as registered in the framework tool registry.
Routes flow based on a key in the pipeline context. Connect the True and False handles to different downstream nodes. Use configure_node to set branches as a JSON dict mapping values to paths.
Saves the current pipeline state/output to memory for later retrieval.
'),H1=x('Loads previously saved state from memory and injects it into the pipeline context.
'),F1=x('Wipes all stored memory. Use with caution.
'),q1=x('Select an action: store saves data, retrieve loads it, clear wipes memory.
'),B1=x(' ',1),K1=x('Ensures the output is not empty, null, or blank.
'),j1=x('Validates that the output is a string type.
'),W1=x('Validates that the output is a list/array.
'),Z1=x('Validates that the output is a dictionary/object.
'),Y1=x('Custom validation rule. Define the rule key as registered in the framework.
'),X1=x('Select a validation rule to apply to the pipeline output before passing downstream.
'),G1=x(' ',1),U1=x('Must define: async def execute(context, inputs) -> Any
Splits a single input into multiple items for parallel processing across downstream branches.
Concatenates all branch results into a single string.
'),$1=x('Collects all branch results into a list.
'),e_=x('Merges results from parallel branches back into a single output.
'),t_=x(' ',1),n_=x(''),a_=x('Inputs
'),o_=x(''),r_=x('Outputs
'),s_=x(' Connections
Pipeline I/O
Processing
No execution events yet. Run your pipeline to see logs here.
'),g_=x(' '),m_=x(' '),__=x(' '),y_=x('Args
'),L_=x('Result
'),V_=x(' Run your pipeline to see the execution timeline
'),J_=x(''),Q_=x(''),$_=x('Shift+click another checkpoint to compare'),e0=x('Added
'),a0=x(' '),o0=x('Removed
'),r0=x(' '),s0=x('Changed
'),i0=x('No differences'),l0=x(' Loading history...
'),w0=x(' No version history yet
'),k0=x(''),z0=x('Version History
Loading...
'),P0=x(' No connectors available
'),M0=x(' Installed'),T0=x(" Hide Guide",1),I0=x(" Setup Guide",1),A0=x(''),D0=x(" Installing...",1),O0=x(" Install",1),R0=x(''),L0=x(''),V0=x(''),H0=x('
Create Custom Tool
No custom tools defined Create a custom API, webhook, or Python tool to extend your agents
Loading...
'),ty=x(' No datasets. Upload a JSON or CSV file to get started.
'),ny=x(''),ay=x(''),oy=x(' '),ry=x('Results
Total
Passed
Failed
Pass Rate
Evaluate
Datasets
%
Loading...
'),py=x(' No experiments yet. Create one to A/B test pipeline variants.
'),hy=x('Experiments
Generating Python code...
'),Ey=x(' Click "Export as Python" to generate deployable code from your pipeline.
'),Ny=x('Deploy / Export
Loading usage data...
'),Ty=x(' No usage data available. Run a pipeline to see metrics.
'),Iy=x('By Model
Model Requests Tokens Cost
By Agent
Agent Requests Tokens Cost
Total Requests
Total Tokens
Total Cost
Avg Latency
Monitor
Loading file...
'),By=x(' Loading files...
'),jy=x(' No files in this project.
'),Wy=x('No insights yet
Click "Analyze" to review your pipeline, or insights will appear - automatically as you build.
Sent to Architect
'),sb=x('Skipped
'),ib=x('Talk to The Oracle
Ask about your pipeline, get advice on architecture decisions, or - discuss optimization strategies.
Loading executions...
'),pb=x(' No executions yet. Start the runtime and trigger a pipeline to see results.
'),hb=x('ID
Status
Duration
Status Execution ID Duration
Executions
'),xb=x(' '),wb=x(' '),kb=x(' '),zb=x(""),Sb=x(''),Cb=x('
Instructions
'),fg=P('
Exec In
Exec Out
tool
'),_g=P('timeout
'),bg=P('Exec In
Exec Out
Max Steps
'),Eg=P('Exec In
Exec Out
In
True
False
action
'),Hg=P('namespace
'),Vg=P('Exec In
Exec Out
rule
'),jg=P('on_fail
'),Zg=P('Exec In
Exec Out
desc
'),Ug=P('code
'),Qg=P('In
Out
split
'),nm=P('max
'),rm=P('In
Out 1
Out 2
merge
'),lm=P('timeout
'),cm=P('In 1
In 2
Out
Exec Out
Trigger Config
Exec In
Destination Config
Exposes an HTTP endpoint that triggers this pipeline when called.
Runs the pipeline on a schedule using standard cron syntax.
Manual trigger. Run the pipeline via the Run button or API call.
Returns the pipeline output as an API response.
Custom tool. Define the tool name as registered in the framework tool registry.
Routes flow based on a key in the pipeline context. Connect the True and False handles to different downstream nodes. Use configure_node to set branches as a JSON dict mapping values to paths.
Saves the current pipeline state/output to memory for later retrieval.
'),r1=P('Loads previously saved state from memory and injects it into the pipeline context.
'),a1=P('Wipes all stored memory. Use with caution.
'),o1=P('Select an action: store saves data, retrieve loads it, clear wipes memory.
'),s1=P(' ',1),i1=P('Ensures the output is not empty, null, or blank.
'),l1=P('Validates that the output is a string type.
'),c1=P('Validates that the output is a list/array.
'),d1=P('Validates that the output is a dictionary/object.
'),u1=P('Custom validation rule. Define the rule key as registered in the framework.
'),v1=P('Select a validation rule to apply to the pipeline output before passing downstream.
'),f1=P(' ',1),p1=P('Must define: async def execute(context, inputs) -> Any
Splits a single input into multiple items for parallel processing across downstream branches.
Concatenates all branch results into a single string.
'),m1=P('Collects all branch results into a list.
'),_1=P('Merges results from parallel branches back into a single output.
'),y1=P(' ',1),b1=P(''),x1=P('Inputs
'),w1=P(''),k1=P('Outputs
'),S1=P(' Connections
Pipeline I/O
Processing
No execution events yet. Run your pipeline to see logs here.
'),D1=P(' '),O1=P(' '),R1=P(' '),L1=P('Generating code...
'),q1=P('Add nodes to your pipeline to generate code.
'),Y1=P(' Run your pipeline to see the execution timeline
'),G1=P(''),U1=P(''),Q1=P('Shift+click another checkpoint to compare'),J1=P('Added
'),t_=P(' '),n_=P('Removed
'),r_=P(' '),a_=P('Changed
'),o_=P('No differences'),s_=P(' Loading history...
'),b_=P(' No version history yet
'),x_=P(''),w_=P('Version History
Loading...
'),C_=P(' No connectors available
'),E_=P('Installed'),N_=P(" Install",1),M_=P(''),P_=P(' No custom tools defined. Create one to get started.
'),A_=P(' Loading...
'),H_=P(' No datasets. Upload a JSON or CSV file to get started.
'),V_=P(''),F_=P(''),B_=P(' '),q_=P('Results
Total
Passed
Failed
Pass Rate
Evaluate
Datasets
%
Loading...
'),Q_=P(' No experiments yet. Create one to A/B test pipeline variants.
'),J_=P('Experiments
Generating Python code...
'),d0=P(' Click "Export as Python" to generate deployable code from your pipeline.
'),u0=P('Deploy / Export
Loading usage data...
'),p0=P(' No usage data available. Run a pipeline to see metrics.
'),h0=P('By Model
Model Requests Tokens Cost
By Agent
Agent Requests Tokens Cost
Total Requests
Total Tokens
Total Cost
Avg Latency
Monitor
Loading file...
'),z0=P(' Loading files...
'),E0=P(' No files in this project.
'),N0=P('No insights yet
Click "Analyze" to review your pipeline, or insights will appear automatically as you build.
Sent to Architect
'),B0=P('Skipped
'),q0=P(' Oracle's Insights
Loading executions...
'),Y0=P(' No executions yet. Start the runtime and trigger a pipeline to see results.
'),X0=P('ID
Status
Duration
Status Execution ID Duration
Executions
'),$0=P(' '),ey=P(' '),ty=P(' '),ny=P(""),ry=P(''),ay=P('
Instructions
'),fg=P('