loudmouth-ai 0.1.0 → 0.2.0

package/skills/local-places/src/local_places/schemas.py

@@ -1,107 +0,0 @@
-from __future__ import annotations
-
-from pydantic import BaseModel, Field, field_validator
-
-
-class LatLng(BaseModel):
-    lat: float = Field(ge=-90, le=90)
-    lng: float = Field(ge=-180, le=180)
-
-
-class LocationBias(BaseModel):
-    lat: float = Field(ge=-90, le=90)
-    lng: float = Field(ge=-180, le=180)
-    radius_m: float = Field(gt=0)
-
-
-class Filters(BaseModel):
-    types: list[str] | None = None
-    open_now: bool | None = None
-    min_rating: float | None = Field(default=None, ge=0, le=5)
-    price_levels: list[int] | None = None
-    keyword: str | None = Field(default=None, min_length=1)
-
-    @field_validator("types")
-    @classmethod
-    def validate_types(cls, value: list[str] | None) -> list[str] | None:
-        if value is None:
-            return value
-        if len(value) > 1:
-            raise ValueError(
-                "Only one type is supported. Use query/keyword for additional filtering."
-            )
-        return value
-
-    @field_validator("price_levels")
-    @classmethod
-    def validate_price_levels(cls, value: list[int] | None) -> list[int] | None:
-        if value is None:
-            return value
-        invalid = [level for level in value if level not in range(0, 5)]
-        if invalid:
-            raise ValueError("price_levels must be integers between 0 and 4.")
-        return value
-
-    @field_validator("min_rating")
-    @classmethod
-    def validate_min_rating(cls, value: float | None) -> float | None:
-        if value is None:
-            return value
-        if (value * 2) % 1 != 0:
-            raise ValueError("min_rating must be in 0.5 increments.")
-        return value
-
-
-class SearchRequest(BaseModel):
-    query: str = Field(min_length=1)
-    location_bias: LocationBias | None = None
-    filters: Filters | None = None
-    limit: int = Field(default=10, ge=1, le=20)
-    page_token: str | None = None
-
-
-class PlaceSummary(BaseModel):
-    place_id: str
-    name: str | None = None
-    address: str | None = None
-    location: LatLng | None = None
-    rating: float | None = None
-    price_level: int | None = None
-    types: list[str] | None = None
-    open_now: bool | None = None
-
-
-class SearchResponse(BaseModel):
-    results: list[PlaceSummary]
-    next_page_token: str | None = None
-
-
-class LocationResolveRequest(BaseModel):
-    location_text: str = Field(min_length=1)
-    limit: int = Field(default=5, ge=1, le=10)
-
-
-class ResolvedLocation(BaseModel):
-    place_id: str
-    name: str | None = None
-    address: str | None = None
-    location: LatLng | None = None
-    types: list[str] | None = None
-
-
-class LocationResolveResponse(BaseModel):
-    results: list[ResolvedLocation]
-
-
-class PlaceDetails(BaseModel):
-    place_id: str
-    name: str | None = None
-    address: str | None = None
-    location: LatLng | None = None
-    rating: float | None = None
-    price_level: int | None = None
-    types: list[str] | None = None
-    phone: str | None = None
-    website: str | None = None
-    hours: list[str] | None = None
-    open_now: bool | None = None

package/skills/mcporter/SKILL.md

@@ -1,38 +0,0 @@
----
-name: mcporter
-description: Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.
-homepage: http://mcporter.dev
-metadata: {"clawdbot":{"emoji":"📦","requires":{"bins":["mcporter"]},"install":[{"id":"node","kind":"node","package":"mcporter","bins":["mcporter"],"label":"Install mcporter (node)"}]}}
----
-
-# mcporter
-
-Use `mcporter` to work with MCP servers directly.
-
-Quick start
-- `mcporter list`
-- `mcporter list <server> --schema`
-- `mcporter call <server.tool> key=value`
-
-Call tools
-- Selector: `mcporter call linear.list_issues team=ENG limit:5`
-- Function syntax: `mcporter call "linear.create_issue(title: \"Bug\")"`
-- Full URL: `mcporter call https://api.example.com/mcp.fetch url:https://example.com`
-- Stdio: `mcporter call --stdio "bun run ./server.ts" scrape url=https://example.com`
-- JSON payload: `mcporter call <server.tool> --args '{"limit":5}'`
-
-Auth + config
-- OAuth: `mcporter auth <server | url> [--reset]`
-- Config: `mcporter config list|get|add|remove|import|login|logout`
-
-Daemon
-- `mcporter daemon start|status|stop|restart`
-
-Codegen
-- CLI: `mcporter generate-cli --server <name>` or `--command <url>`
-- Inspect: `mcporter inspect-cli <path> [--json]`
-- TS: `mcporter emit-ts <server> --mode client|types`
-
-Notes
-- Config default: `./config/mcporter.json` (override with `--config`).
-- Prefer `--output json` for machine-readable results.

package/skills/model-usage/SKILL.md

@@ -1,45 +0,0 @@
----
-name: model-usage
-description: Use CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.
-metadata: {"clawdbot":{"emoji":"📊","os":["darwin"],"requires":{"bins":["codexbar"]},"install":[{"id":"brew-cask","kind":"brew","cask":"steipete/tap/codexbar","bins":["codexbar"],"label":"Install CodexBar (brew cask)"}]}}
----
-
-# Model usage
-
-## Overview
-Get per-model usage cost from CodexBar's local cost logs. Supports "current model" (most recent daily entry) or "all models" summaries for Codex or Claude.
-
-TODO: add Linux CLI support guidance once CodexBar CLI install path is documented for Linux.
-
-## Quick start
-1) Fetch cost JSON via CodexBar CLI or pass a JSON file.
-2) Use the bundled script to summarize by model.
-
-```bash
-python {baseDir}/scripts/model_usage.py --provider codex --mode current
-python {baseDir}/scripts/model_usage.py --provider codex --mode all
-python {baseDir}/scripts/model_usage.py --provider claude --mode all --format json --pretty
-```
-
-## Current model logic
-- Uses the most recent daily row with `modelBreakdowns`.
-- Picks the model with the highest cost in that row.
-- Falls back to the last entry in `modelsUsed` when breakdowns are missing.
-- Override with `--model <name>` when you need a specific model.
-
-## Inputs
-- Default: runs `codexbar cost --format json --provider <codex|claude>`.
-- File or stdin:
-
-```bash
-codexbar cost --provider codex --format json > /tmp/cost.json
-python {baseDir}/scripts/model_usage.py --input /tmp/cost.json --mode all
-cat /tmp/cost.json | python {baseDir}/scripts/model_usage.py --input - --mode current
-```
-
-## Output
-- Text (default) or JSON (`--format json --pretty`).
-- Values are cost-only per model; tokens are not split by model in CodexBar output.
-
-## References
-- Read `references/codexbar-cli.md` for CLI flags and cost JSON fields.

package/skills/model-usage/references/codexbar-cli.md

@@ -1,28 +0,0 @@
-# CodexBar CLI quick ref (usage + cost)
-
-## Install
-- App: Preferences -> Advanced -> Install CLI
-- Repo: ./bin/install-codexbar-cli.sh
-
-## Commands
-- Usage snapshot (web/cli sources):
-  - codexbar usage --format json --pretty
-  - codexbar --provider all --format json
-- Local cost usage (Codex + Claude only):
-  - codexbar cost --format json --pretty
-  - codexbar cost --provider codex|claude --format json
-
-## Cost JSON fields
-The payload is an array (one per provider).
-- provider, source, updatedAt
-- sessionTokens, sessionCostUSD
-- last30DaysTokens, last30DaysCostUSD
-- daily[]: date, inputTokens, outputTokens, cacheReadTokens, cacheCreationTokens, totalTokens, totalCost, modelsUsed, modelBreakdowns[]
-- modelBreakdowns[]: modelName, cost
-- totals: totalInputTokens, totalOutputTokens, cacheReadTokens, cacheCreationTokens, totalTokens, totalCost
-
-## Notes
-- Cost usage is local-only. It reads JSONL logs under:
-  - Codex: ~/.codex/sessions/**/*.jsonl
-  - Claude: ~/.config/claude/projects/**/*.jsonl or ~/.claude/projects/**/*.jsonl
-- If web usage is required (non-local), use codexbar usage (not cost).

package/skills/model-usage/scripts/model_usage.py

@@ -1,310 +0,0 @@
-#!/usr/bin/env python3
-"""
-Summarize CodexBar local cost usage by model.
-
-Defaults to current model (most recent daily entry), or list all models.
-"""
-
-from __future__ import annotations
-
-import argparse
-import json
-import os
-import subprocess
-import sys
-from dataclasses import dataclass
-from datetime import date, datetime, timedelta
-from typing import Any, Dict, Iterable, List, Optional, Tuple
-
-
-def eprint(msg: str) -> None:
-    print(msg, file=sys.stderr)
-
-
-def run_codexbar_cost(provider: str) -> List[Dict[str, Any]]:
-    cmd = ["codexbar", "cost", "--format", "json", "--provider", provider]
-    try:
-        output = subprocess.check_output(cmd, text=True)
-    except FileNotFoundError:
-        raise RuntimeError("codexbar not found on PATH. Install CodexBar CLI first.")
-    except subprocess.CalledProcessError as exc:
-        raise RuntimeError(f"codexbar cost failed (exit {exc.returncode}).")
-    try:
-        payload = json.loads(output)
-    except json.JSONDecodeError as exc:
-        raise RuntimeError(f"Failed to parse codexbar JSON output: {exc}")
-    if not isinstance(payload, list):
-        raise RuntimeError("Expected codexbar cost JSON array.")
-    return payload
-
-
-def load_payload(input_path: Optional[str], provider: str) -> Dict[str, Any]:
-    if input_path:
-        if input_path == "-":
-            raw = sys.stdin.read()
-        else:
-            with open(input_path, "r", encoding="utf-8") as handle:
-                raw = handle.read()
-        data = json.loads(raw)
-    else:
-        data = run_codexbar_cost(provider)
-
-    if isinstance(data, dict):
-        return data
-
-    if isinstance(data, list):
-        for entry in data:
-            if isinstance(entry, dict) and entry.get("provider") == provider:
-                return entry
-        raise RuntimeError(f"Provider '{provider}' not found in codexbar payload.")
-
-    raise RuntimeError("Unsupported JSON input format.")
-
-
-@dataclass
-class ModelCost:
-    model: str
-    cost: float
-
-
-def parse_daily_entries(payload: Dict[str, Any]) -> List[Dict[str, Any]]:
-    daily = payload.get("daily")
-    if not daily:
-        return []
-    if not isinstance(daily, list):
-        return []
-    return [entry for entry in daily if isinstance(entry, dict)]
-
-
-def parse_date(value: str) -> Optional[date]:
-    try:
-        return datetime.strptime(value, "%Y-%m-%d").date()
-    except Exception:
-        return None
-
-
-def filter_by_days(entries: List[Dict[str, Any]], days: Optional[int]) -> List[Dict[str, Any]]:
-    if not days:
-        return entries
-    cutoff = date.today() - timedelta(days=days - 1)
-    filtered: List[Dict[str, Any]] = []
-    for entry in entries:
-        day = entry.get("date")
-        if not isinstance(day, str):
-            continue
-        parsed = parse_date(day)
-        if parsed and parsed >= cutoff:
-            filtered.append(entry)
-    return filtered
-
-
-def aggregate_costs(entries: Iterable[Dict[str, Any]]) -> Dict[str, float]:
-    totals: Dict[str, float] = {}
-    for entry in entries:
-        breakdowns = entry.get("modelBreakdowns")
-        if not breakdowns:
-            continue
-        if not isinstance(breakdowns, list):
-            continue
-        for item in breakdowns:
-            if not isinstance(item, dict):
-                continue
-            model = item.get("modelName")
-            cost = item.get("cost")
-            if not isinstance(model, str):
-                continue
-            if not isinstance(cost, (int, float)):
-                continue
-            totals[model] = totals.get(model, 0.0) + float(cost)
-    return totals
-
-
-def pick_current_model(entries: List[Dict[str, Any]]) -> Tuple[Optional[str], Optional[str]]:
-    if not entries:
-        return None, None
-    sorted_entries = sorted(
-        entries,
-        key=lambda entry: entry.get("date") or "",
-    )
-    for entry in reversed(sorted_entries):
-        breakdowns = entry.get("modelBreakdowns")
-        if isinstance(breakdowns, list) and breakdowns:
-            scored: List[ModelCost] = []
-            for item in breakdowns:
-                if not isinstance(item, dict):
-                    continue
-                model = item.get("modelName")
-                cost = item.get("cost")
-                if isinstance(model, str) and isinstance(cost, (int, float)):
-                    scored.append(ModelCost(model=model, cost=float(cost)))
-            if scored:
-                scored.sort(key=lambda item: item.cost, reverse=True)
-                return scored[0].model, entry.get("date") if isinstance(entry.get("date"), str) else None
-        models_used = entry.get("modelsUsed")
-        if isinstance(models_used, list) and models_used:
-            last = models_used[-1]
-            if isinstance(last, str):
-                return last, entry.get("date") if isinstance(entry.get("date"), str) else None
-    return None, None
-
-
-def usd(value: Optional[float]) -> str:
-    if value is None:
-        return "—"
-    return f"${value:,.2f}"
-
-
-def latest_day_cost(entries: List[Dict[str, Any]], model: str) -> Tuple[Optional[str], Optional[float]]:
-    if not entries:
-        return None, None
-    sorted_entries = sorted(
-        entries,
-        key=lambda entry: entry.get("date") or "",
-    )
-    for entry in reversed(sorted_entries):
-        breakdowns = entry.get("modelBreakdowns")
-        if not isinstance(breakdowns, list):
-            continue
-        for item in breakdowns:
-            if not isinstance(item, dict):
-                continue
-            if item.get("modelName") == model:
-                cost = item.get("cost") if isinstance(item.get("cost"), (int, float)) else None
-                day = entry.get("date") if isinstance(entry.get("date"), str) else None
-                return day, float(cost) if cost is not None else None
-    return None, None
-
-
-def render_text_current(
-    provider: str,
-    model: str,
-    latest_date: Optional[str],
-    total_cost: Optional[float],
-    latest_cost: Optional[float],
-    latest_cost_date: Optional[str],
-    entry_count: int,
-) -> str:
-    lines = [f"Provider: {provider}", f"Current model: {model}"]
-    if latest_date:
-        lines.append(f"Latest model date: {latest_date}")
-    lines.append(f"Total cost (rows): {usd(total_cost)}")
-    if latest_cost_date:
-        lines.append(f"Latest day cost: {usd(latest_cost)} ({latest_cost_date})")
-    lines.append(f"Daily rows: {entry_count}")
-    return "\n".join(lines)
-
-
-def render_text_all(provider: str, totals: Dict[str, float]) -> str:
-    lines = [f"Provider: {provider}", "Models:"]
-    for model, cost in sorted(totals.items(), key=lambda item: item[1], reverse=True):
-        lines.append(f"- {model}: {usd(cost)}")
-    return "\n".join(lines)
-
-
-def build_json_current(
-    provider: str,
-    model: str,
-    latest_date: Optional[str],
-    total_cost: Optional[float],
-    latest_cost: Optional[float],
-    latest_cost_date: Optional[str],
-    entry_count: int,
-) -> Dict[str, Any]:
-    return {
-        "provider": provider,
-        "mode": "current",
-        "model": model,
-        "latestModelDate": latest_date,
-        "totalCostUSD": total_cost,
-        "latestDayCostUSD": latest_cost,
-        "latestDayCostDate": latest_cost_date,
-        "dailyRowCount": entry_count,
-    }
-
-
-def build_json_all(provider: str, totals: Dict[str, float]) -> Dict[str, Any]:
-    return {
-        "provider": provider,
-        "mode": "all",
-        "models": [
-            {"model": model, "totalCostUSD": cost}
-            for model, cost in sorted(totals.items(), key=lambda item: item[1], reverse=True)
-        ],
-    }
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(description="Summarize CodexBar model usage from local cost logs.")
-    parser.add_argument("--provider", choices=["codex", "claude"], default="codex")
-    parser.add_argument("--mode", choices=["current", "all"], default="current")
-    parser.add_argument("--model", help="Explicit model name to report instead of auto-current.")
-    parser.add_argument("--input", help="Path to codexbar cost JSON (or '-' for stdin).")
-    parser.add_argument("--days", type=int, help="Limit to last N days (based on daily rows).")
-    parser.add_argument("--format", choices=["text", "json"], default="text")
-    parser.add_argument("--pretty", action="store_true", help="Pretty-print JSON output.")
-
-    args = parser.parse_args()
-
-    try:
-        payload = load_payload(args.input, args.provider)
-    except Exception as exc:
-        eprint(str(exc))
-        return 1
-
-    entries = parse_daily_entries(payload)
-    entries = filter_by_days(entries, args.days)
-
-    if args.mode == "current":
-        model = args.model
-        latest_date = None
-        if not model:
-            model, latest_date = pick_current_model(entries)
-        if not model:
-            eprint("No model data found in codexbar cost payload.")
-            return 2
-        totals = aggregate_costs(entries)
-        total_cost = totals.get(model)
-        latest_cost_date, latest_cost = latest_day_cost(entries, model)
-
-        if args.format == "json":
-            payload_out = build_json_current(
-                provider=args.provider,
-                model=model,
-                latest_date=latest_date,
-                total_cost=total_cost,
-                latest_cost=latest_cost,
-                latest_cost_date=latest_cost_date,
-                entry_count=len(entries),
-            )
-            indent = 2 if args.pretty else None
-            print(json.dumps(payload_out, indent=indent, sort_keys=args.pretty))
-        else:
-            print(
-                render_text_current(
-                    provider=args.provider,
-                    model=model,
-                    latest_date=latest_date,
-                    total_cost=total_cost,
-                    latest_cost=latest_cost,
-                    latest_cost_date=latest_cost_date,
-                    entry_count=len(entries),
-                )
-            )
-        return 0
-
-    totals = aggregate_costs(entries)
-    if not totals:
-        eprint("No model breakdowns found in codexbar cost payload.")
-        return 2
-
-    if args.format == "json":
-        payload_out = build_json_all(provider=args.provider, totals=totals)
-        indent = 2 if args.pretty else None
-        print(json.dumps(payload_out, indent=indent, sort_keys=args.pretty))
-    else:
-        print(render_text_all(provider=args.provider, totals=totals))
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

package/skills/nano-banana-pro/SKILL.md

@@ -1,30 +0,0 @@
----
-name: nano-banana-pro
-description: Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro).
-homepage: https://ai.google.dev/
-metadata: {"clawdbot":{"emoji":"🍌","requires":{"bins":["uv"],"env":["GEMINI_API_KEY"]},"primaryEnv":"GEMINI_API_KEY","install":[{"id":"uv-brew","kind":"brew","formula":"uv","bins":["uv"],"label":"Install uv (brew)"}]}}
----
-
-# Nano Banana Pro (Gemini 3 Pro Image)
-
-Use the bundled script to generate or edit images.
-
-Generate
-```bash
-uv run {baseDir}/scripts/generate_image.py --prompt "your image description" --filename "output.png" --resolution 1K
-```
-
-Edit
-```bash
-uv run {baseDir}/scripts/generate_image.py --prompt "edit instructions" --filename "output.png" --input-image "/path/in.png" --resolution 2K
-```
-
-API key
-- `GEMINI_API_KEY` env var
-- Or set `skills."nano-banana-pro".apiKey` / `skills."nano-banana-pro".env.GEMINI_API_KEY` in `~/.clawdbot/clawdbot.json`
-
-Notes
-- Resolutions: `1K` (default), `2K`, `4K`.
-- Use timestamps in filenames: `yyyy-mm-dd-hh-mm-ss-name.png`.
-- The script prints a `MEDIA:` line for Clawdbot to auto-attach on supported chat providers.
-- Do not read the image back; report the saved path only.