roscoe 2.1.0__tar.gz → 2.2.0__tar.gz

{roscoe-2.1.0/roscoe.egg-info → roscoe-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: roscoe
-Version: 2.1.0
+Version: 2.2.0
 Summary: roscoe — Ready-to-run Orchestration SDK: Configurable, Observable, Extensible.
 Author-email: rhealaloo <rhealaloo@gmail.com>
 License-Expression: MIT

{roscoe-2.1.0 → roscoe-2.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "roscoe"
-version = "2.1.0"
+version = "2.2.0"
 description = "roscoe — Ready-to-run Orchestration SDK: Configurable, Observable, Extensible."
 readme = "README.md"
 requires-python = ">=3.11"

{roscoe-2.1.0 → roscoe-2.2.0}/roscoe/__init__.py

@@ -3,6 +3,6 @@
 from roscoe.core.agent_result import AgentResult
 from roscoe.core.agent_runner import AgentRunner
 
-__version__ = "2.1.0"
+__version__ = "2.2.0"
 
 __all__ = ["AgentRunner", "AgentResult", "__version__"]

{roscoe-2.1.0 → roscoe-2.2.0}/roscoe/cli/init_command.py

@@ -32,6 +32,7 @@ _PROVIDERS = {
     "azure_openai": {"env_key": "AZURE_OPENAI_KEY", "default_model": "gpt-4o", "base_url": None},
     "anthropic": {"env_key": "ANTHROPIC_API_KEY", "default_model": "claude-sonnet-4-5", "base_url": None},
     "gemini": {"env_key": "GOOGLE_API_KEY", "default_model": "gemini-1.5-pro", "base_url": None},
+    "nvidia": {"env_key": "NVIDIA_API_KEY", "default_model": "openai/gpt-oss-120b", "base_url": None},
     "ollama": {"env_key": None, "default_model": "llama3.1", "base_url": None},
 }
 
@@ -195,6 +196,7 @@ def _run_wizard(name: str) -> dict:
         "azure_openai": "azure_openai",
         "anthropic": "anthropic",
         "gemini": "gemini",
+        "nvidia": "nvidia  (NVIDIA NIM, free-tier models available)",
         "ollama": "ollama  (free, local, no API key)",
     }
     for i, p in enumerate(providers, 1):
@@ -355,10 +357,7 @@ def _apply_wizard(dest: Path, answers: dict) -> None:
         tools_yaml = ", ".join(f'"{t}"' for t in answers["approval_tools"])
         text = text.replace(
             "  # human_approval:\n"
-            "  #   require_approval_for:\n"
-            "  #     - send_email             # tool function names that need sign-off\n"
-            "  #     - delete_record\n"
-            "  #     - submit_payment",
+            "  #   require_approval_for: [send_email, delete_record]   # gate sensitive tools",
             f"  human_approval:\n"
             f"    require_approval_for: [{tools_yaml}]",
         )
@@ -374,7 +373,7 @@ def _apply_wizard(dest: Path, answers: dict) -> None:
 
     if answers["persistent_memory"]:
         text = text.replace(
-            "    enabled: false              # flip to true to enable cross-session memory",
+            "    enabled: false                # long-term facts per user_id",
             "    enabled: true",
         )
 
@@ -416,6 +415,7 @@ def scaffold_project(
 def _add_template_extras(dest: Path, template: str) -> None:
     (dest / "main.py").write_text(_TEMPLATE_MAIN[template])
     (dest / ".env.example").write_text(_TEMPLATE_ENV[template])
+    shutil.copy(SCAFFOLD_DIR / "docs.md", dest / "docs.md")
     evals_dir = dest / "evals"
     evals_dir.mkdir(exist_ok=True)
     (evals_dir / "test_cases.json").write_text(json.dumps(_EXAMPLE_CASES, indent=2))

roscoe-2.2.0/roscoe/cli/scaffold/agent_config.yaml

@@ -0,0 +1,36 @@
+# roscoe agent configuration — __PROJECT_NAME__
+# Full reference for every option below: docs.md (scaffolded alongside this file).
+# ${VAR_NAME} anywhere in this file resolves from your shell env or .env.
+
+agent_name: __PROJECT_NAME__
+system_prompt_file: prompts/system.txt
+# ui_script: app.py             # custom web UI `roscoe run` launches instead of
+                                 # the built-in widget (defaults to app.py if present)
+
+model:
+  provider: openai               # openai | azure_openai | anthropic | gemini | nvidia | ollama
+  model: gpt-4o-mini
+  api_key: ${OPENAI_API_KEY}
+  temperature: 0.1               # 0.0 = precise, 1.0 = creative
+
+memory:
+  conversation:
+    enabled: true
+    window_size: 10              # messages kept per session
+  persistent:
+    enabled: false                # long-term facts per user_id
+    backend: sqlite
+    connection: ./facts.db
+
+middleware:
+  retry:
+    max_attempts: 3
+  rate_limiter:
+    enabled: true
+    requests_per_minute: 60
+  cost_tracking:
+    enabled: true                 # result.cost_usd — see `roscoe prices` in docs.md
+  audit:
+    enabled: true                 # logs/audit.jsonl — feeds `roscoe monitor`
+  # human_approval:
+  #   require_approval_for: [send_email, delete_record]   # gate sensitive tools

{roscoe-2.1.0 → roscoe-2.2.0}/roscoe/cli/wizard_gui.py

@@ -19,6 +19,7 @@ _PROVIDERS = [
     ("Azure OpenAI", "azure_openai"),
     ("Anthropic", "anthropic"),
     ("Gemini", "gemini"),
+    ("NVIDIA  (NIM, free-tier models available)", "nvidia"),
     ("Ollama  (free, local, no API key)", "ollama"),
 ]
 
@@ -28,6 +29,7 @@ _DEFAULT_MODELS = {
     "azure_openai": "gpt-4o",
     "anthropic": "claude-sonnet-4-5",
     "gemini": "gemini-1.5-pro",
+    "nvidia": "openai/gpt-oss-120b",
     "ollama": "llama3.1",
 }
 
@@ -37,6 +39,7 @@ _ENV_KEYS = {
     "azure_openai": "AZURE_OPENAI_KEY",
     "anthropic": "ANTHROPIC_API_KEY",
     "gemini": "GOOGLE_API_KEY",
+    "nvidia": "NVIDIA_API_KEY",
     "ollama": None,
 }
 

{roscoe-2.1.0 → roscoe-2.2.0/roscoe.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: roscoe
-Version: 2.1.0
+Version: 2.2.0
 Summary: roscoe — Ready-to-run Orchestration SDK: Configurable, Observable, Extensible.
 Author-email: rhealaloo <rhealaloo@gmail.com>
 License-Expression: MIT

roscoe-2.1.0/roscoe/cli/scaffold/agent_config.yaml

@@ -1,188 +0,0 @@
-# =============================================================================
-# roscoe agent configuration — __PROJECT_NAME__
-# =============================================================================
-#
-# This is the only file you need to configure. Everything below is read by
-# AgentRunner.from_config() and wired automatically — no boilerplate code.
-#
-# Environment variables: use ${VAR_NAME} anywhere in this file. Values are
-# resolved from your shell environment (or a .env file if you load one).
-#
-# Docs: https://github.com/rhealaloo45/roscoe
-# =============================================================================
-
-
-# ---------- Agent identity ---------------------------------------------------
-
-agent_name: __PROJECT_NAME__
-
-# The system prompt tells the LLM who it is and how to behave.
-# Inline string or point to a file:
-system_prompt_file: prompts/system.txt
-# system_prompt: |
-#   You are a helpful assistant. Be concise.
-
-# `roscoe run` opens a generic browser chat by default. If this project has
-# its own web UI (a Flask app that builds the agent itself — custom login,
-# dashboard, branded chat), roscoe defers to it instead: it looks for
-# `app.py` in this directory and just runs it. Only set this if your file
-# is named something else:
-# ui_script: app.py
-
-
-# ---------- Model ------------------------------------------------------------
-# Swap providers by changing this block. Your Python code stays identical.
-#
-# Supported providers:
-#   openai        — GPT-4o, GPT-4o-mini, etc.
-#   azure_openai  — Azure-hosted OpenAI (needs deployment + endpoint)
-#   anthropic     — Claude Sonnet, Opus, Haiku
-#   gemini        — Gemini 1.5 Pro / Flash
-#   ollama        — any local model (free, no API key)
-#
-# OpenAI-compatible endpoints (OpenRouter, Together, etc.):
-#   provider: openai
-#   base_url: https://openrouter.ai/api/v1
-#   model: meta-llama/llama-3.1-8b-instruct
-
-model:
-  provider: openai
-  model: gpt-4o-mini
-  api_key: ${OPENAI_API_KEY}
-  temperature: 0.1
-  # max_tokens: 4096            # cap the response length
-
-  # --- Azure OpenAI example (uncomment & replace the block above) ---
-  # provider: azure_openai
-  # deployment: my-gpt4o-deployment
-  # endpoint: ${AZURE_OPENAI_ENDPOINT}
-  # api_key: ${AZURE_OPENAI_KEY}
-  # api_version: "2024-02-01"
-
-  # --- Anthropic example ---
-  # provider: anthropic
-  # model: claude-sonnet-4-5
-  # api_key: ${ANTHROPIC_API_KEY}
-
-  # --- Gemini example ---
-  # provider: gemini
-  # model: gemini-1.5-pro
-  # api_key: ${GOOGLE_API_KEY}
-
-  # --- Ollama (local, free, no key) ---
-  # provider: ollama
-  # model: llama3.1
-
-
-# ---------- Memory -----------------------------------------------------------
-# Conversation = short-term (per session_id, windowed).
-# Persistent   = long-term facts per user_id, stored in sqlite.
-# Knowledge    = RAG retrieval (FAISS or keyword). Set up in code, not here.
-
-memory:
-  conversation:
-    enabled: true
-    window_size: 10             # keep last N messages per session
-
-  persistent:
-    enabled: false              # flip to true to enable cross-session memory
-    backend: sqlite
-    connection: ./facts.db      # file path, or ":memory:" for throwaway
-    # max_facts: 50             # cap stored facts per user (default: unlimited)
-
-
-# ---------- Middleware -------------------------------------------------------
-# All middleware is automatic — set it here, forget about it in code.
-
-middleware:
-
-  # Retry — retries failed LLM calls with exponential backoff.
-  # Handles transient errors (rate limits, timeouts, 500s) automatically.
-  retry:
-    max_attempts: 3             # total attempts (1 = no retry)
-    # wait_multiplier: 1        # backoff multiplier in seconds
-    # wait_max: 10              # max wait between retries
-
-  # Rate limiter — token-bucket per provider. Prevents thrashing API limits
-  # when multiple agents share the same provider.
-  # Ollama is always skipped (no external limit).
-  rate_limiter:
-    enabled: true
-    requests_per_minute: 60     # adjust based on your API tier
-    # rpm: 60                   # alias for requests_per_minute
-
-  # Cost tracking — estimates USD cost from token counts.
-  # Shows up in result.cost_usd and the audit log.
-  # Built-in rates: gpt-4o, gpt-4o-mini, claude-sonnet-4-5, gemini-1.5-pro.
-  # Prices drift — add or correct your own rates for ANY provider (no code):
-  #   roscoe prices           # desktop editor, saves to ~/.roscoe/prices.json
-  cost_tracking:
-    enabled: true
-
-  # Tool guardrails — hard timeout per tool call, plus an error budget so a
-  # failing tool is refused instead of retried every iteration. Both optional.
-  # tools:
-  #   timeout_seconds: 30       # kill a single tool call after N seconds
-  #   max_failures: 3           # disable a tool for the run after N failures
-
-  # Audit logging — writes one JSONL line per run to logs/audit.jsonl.
-  # Non-blocking (async). Contains: run_id, agent, provider, model, tokens,
-  # cost, status, latency. Feed to `roscoe monitor` for dashboards.
-  audit:
-    enabled: true
-    # path: logs/audit.jsonl    # default path; override if needed
-
-  # Human approval — pause the agent before running sensitive tools.
-  # The run returns status="paused"; call agent.resume(run_id, "approve")
-  # to continue, or "reject" / "modify" to block / change args.
-  # human_approval:
-  #   require_approval_for:
-  #     - send_email             # tool function names that need sign-off
-  #     - delete_record
-  #     - submit_payment
-
-
-# ---------- Connectors (optional) --------------------------------------------
-# Connectors are pre-built tool bundles for common services.
-# Set them up in code, not in this file:
-#
-#   from roscoe.connectors import GitHubConnector
-#   gh = GitHubConnector({"token": "ghp_..."})
-#   agent = AgentRunner.from_config("agent_config.yaml", tools=gh.tools)
-#
-# Available connectors:
-#   RESTConnector        — any REST API (base_url + token)
-#   JiraConnector        — Jira Cloud (email + api_token)
-#   ServiceNowConnector  — ServiceNow (instance_url + user/pass)
-#   OutlookConnector     — Microsoft Graph email/calendar
-#   SharePointConnector  — Microsoft Graph files
-#   GitHubConnector      — GitHub API (PAT)
-#   NotionConnector      — Notion API (integration token)
-#   GoogleWorkspaceConnector — Gmail + Calendar + Tasks + Drive (service account)
-#   SnowflakeConnector   — Snowflake SQL (pip install roscoe[snowflake])
-#
-# Mix connector tools with your own:
-#   tools = [my_tool] + gh.tools + jira.tools
-
-
-# ---------- Monitoring (optional) --------------------------------------------
-# After runs accumulate, use the CLI to view a dashboard:
-#   roscoe monitor --path logs/audit.jsonl
-#
-# Export to Prometheus Pushgateway or Azure Monitor in code:
-#   from roscoe.monitoring.exporters.prometheus import PrometheusPushgatewayExporter
-#   exporter = PrometheusPushgatewayExporter(gateway_url="http://localhost:9091")
-#   exporter.push(metrics)
-
-
-# ---------- Evals (optional) -------------------------------------------------
-# Define test cases in evals/test_cases.json (already scaffolded).
-# Run from CLI:
-#   roscoe eval --dataset evals/test_cases.json --config agent_config.yaml
-#
-# Add --judge to enable LLM-as-judge scoring (output quality + hallucination).
-# Without --judge, only deterministic tool-usage scoring runs.
-#
-# Compare two runs for regressions:
-#   from roscoe.evals.regression import compare_runs
-#   diff = compare_runs(report_a, report_b)