tau-all-agent 0.1.0

package/skills/oracle/scripts/oracle-bundle

@@ -0,0 +1,227 @@
+#!/usr/bin/env bash
+set -eo pipefail
+
+ROOT_DIR="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+
+MAX_BYTES=$((1024 * 1024))
+DRY_RUN=0
+PROMPT=""
+FILE_SELECTORS=()
+
+usage() {
+  cat <<'EOF'
+Usage:
+  oracle-bundle -p "<task>" --file "path|dir|glob" [--file "..."] [--dry-run] [--max-bytes N]
+
+Notes:
+  - Runs from the git repo root when inside a repo; otherwise uses $PWD.
+  - --file accepts paths, dirs, or glob-like patterns (string globs).
+  - Exclude patterns by prefixing with "!" (e.g. --file "!**/*.test.*").
+EOF
+}
+
+trim() {
+  local s="$1"
+  s="${s#"${s%%[!$' \t\r\n']*}"}"
+  s="${s%"${s##*[!$' \t\r\n']}"}"
+  printf '%s' "$s"
+}
+
+has_glob_chars() {
+  case "$1" in
+    *'*'* | *'?'* | *'['* | *']'* ) return 0 ;;
+    * ) return 1 ;;
+  esac
+}
+
+file_size_bytes() {
+  local path="$1"
+  local size=""
+  size="$(stat -f%z "$path" 2>/dev/null || true)"
+  if [[ -n "$size" ]]; then
+    printf '%s' "$size"
+    return 0
+  fi
+
+  size="$(stat -c%s "$path" 2>/dev/null || true)"
+  if [[ -n "$size" ]]; then
+    printf '%s' "$size"
+    return 0
+  fi
+
+  wc -c <"$path" | tr -d ' '
+}
+
+path_has_ignored_dir() {
+  local rel="$1"
+  case "$rel" in
+    .git/* | */.git/*) return 0 ;;
+    node_modules/* | */node_modules/*) return 0 ;;
+    dist/* | */dist/*) return 0 ;;
+    build/* | */build/*) return 0 ;;
+    coverage/* | */coverage/*) return 0 ;;
+    .next/* | */.next/*) return 0 ;;
+    .turbo/* | */.turbo/*) return 0 ;;
+    tmp/* | */tmp/*) return 0 ;;
+    *) return 1 ;;
+  esac
+}
+
+matches_any_pattern() {
+  local rel="$1"
+  shift
+  local pat=""
+  for pat in "$@"; do
+    # shellcheck disable=SC2053
+    [[ "$rel" == $pat ]] && return 0
+  done
+  return 1
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -p | --prompt)
+      PROMPT="${2-}"
+      shift 2
+      ;;
+    --file | -f)
+      FILE_SELECTORS+=("${2-}")
+      shift 2
+      ;;
+    --max-bytes)
+      MAX_BYTES="${2-}"
+      shift 2
+      ;;
+    --dry-run)
+      DRY_RUN=1
+      shift
+      ;;
+    -h | --help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "error: unknown argument: $1" >&2
+      usage >&2
+      exit 2
+      ;;
+  esac
+done
+
+if [[ -z "$PROMPT" && ! -t 0 ]]; then
+  PROMPT="$(cat)"
+fi
+
+if [[ -z "$(trim "$PROMPT")" ]]; then
+  echo "error: prompt is empty (use -p/--prompt)" >&2
+  exit 2
+fi
+
+cd "${ROOT_DIR}"
+
+selectors=()
+for raw in "${FILE_SELECTORS[@]-}"; do
+  IFS=',' read -r -a parts <<<"$raw"
+  for part in "${parts[@]}"; do
+    part="$(trim "$part")"
+    [[ -n "$part" ]] && selectors+=("$part")
+  done
+done
+
+include_patterns=()
+exclude_patterns=()
+
+for sel in "${selectors[@]}"; do
+  is_exclude=0
+  if [[ "$sel" == !* ]]; then
+    is_exclude=1
+    sel="${sel:1}"
+  fi
+
+  sel="$(trim "$sel")"
+  sel="${sel%/}"
+  if [[ -z "$sel" ]]; then
+    continue
+  fi
+
+  if [[ "$sel" == /* ]]; then
+    if [[ "$sel" == "${ROOT_DIR}/"* ]]; then
+      sel="${sel#"${ROOT_DIR}/"}"
+    else
+      echo "error: absolute paths must be under repo root: ${sel}" >&2
+      exit 2
+    fi
+  fi
+
+  if [[ -e "$sel" && -d "$sel" ]] && ! has_glob_chars "$sel"; then
+    sel="${sel}/**"
+  fi
+
+  if [[ $is_exclude -eq 1 ]]; then
+    exclude_patterns+=("$sel")
+  else
+    include_patterns+=("$sel")
+  fi
+done
+
+if [[ "${#include_patterns[@]}" -eq 0 ]]; then
+  echo "error: no include patterns provided (need at least one non-! --file)" >&2
+  exit 2
+fi
+
+all_files=()
+if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+  while IFS= read -r f; do
+    [[ -n "$f" ]] && all_files+=("$f")
+  done < <(git ls-files -co --exclude-standard)
+else
+  while IFS= read -r f; do
+    f="${f#./}"
+    [[ -n "$f" ]] && all_files+=("$f")
+  done < <(find . -type f -print)
+fi
+
+selected=()
+skipped=()
+
+for rel in "${all_files[@]}"; do
+  [[ -z "$rel" ]] && continue
+  path_has_ignored_dir "$rel" && continue
+
+  if ! matches_any_pattern "$rel" "${include_patterns[@]}"; then
+    continue
+  fi
+
+  if [[ "${#exclude_patterns[@]}" -gt 0 ]] && matches_any_pattern "$rel" "${exclude_patterns[@]}"; then
+    continue
+  fi
+
+  if [[ ! -f "$rel" ]]; then
+    continue
+  fi
+
+  size="$(file_size_bytes "$rel")"
+  if [[ "$size" -gt "$MAX_BYTES" ]]; then
+    skipped+=("${rel} (too large: ${size} bytes)")
+    continue
+  fi
+
+  selected+=("$rel")
+done
+
+if [[ "$DRY_RUN" -eq 1 ]]; then
+  printf '%s\n' "${selected[@]}" | LC_ALL=C sort
+  if [[ "${#skipped[@]}" -gt 0 ]]; then
+    printf '\nSkipped:\n' >&2
+    printf '%s\n' "${skipped[@]}" >&2
+  fi
+  exit 0
+fi
+
+printf '# Task\n\n%s\n\n# Files\n' "$(trim "$PROMPT")"
+printf '%s\n' "${selected[@]}" | LC_ALL=C sort | while IFS= read -r rel; do
+  [[ -z "$rel" ]] && continue
+  printf '\n## %s\n\n```\n' "$rel"
+  cat "$rel"
+  printf '\n```\n'
+done

package/skills/sentry/SKILL.md

@@ -0,0 +1,198 @@
+---
+name: sentry
+description: "Fetch and analyze Sentry issues, events, transactions, and logs. Helps agents debug errors, find root causes, and understand what happened at specific times."
+---
+
+# Sentry
+
+Access Sentry data via the Sentry API for debugging and investigation.
+
+## Requirements
+
+A Sentry auth token available to the scripts (by default they read `~/.sentryclirc`).
+
+## Quick reference
+
+Run these scripts from this skill directory.
+
+| Task                  | Command                                                                          |
+| --------------------- | -------------------------------------------------------------------------------- |
+| Find errors on a date | `"./scripts/search-events.js" --org X --start 2025-12-23T15:00:00 --level error` |
+| List open issues      | `"./scripts/list-issues.js" --org X --status unresolved`                         |
+| Get issue details     | `"./scripts/fetch-issue.js" <issue-id-or-url> --latest`                          |
+| Get event details     | `"./scripts/fetch-event.js" <event-id> --org X --project Y`                      |
+| Search logs           | `"./scripts/search-logs.js" --org X --project Y "level:error"`                   |
+
+## Common debugging workflows
+
+### “What went wrong at this time?”
+
+Find events around a specific timestamp:
+
+```bash
+# Find all events in a 2-hour window
+"./scripts/search-events.js" --org myorg --project backend \
+  --start 2025-12-23T15:00:00 --end 2025-12-23T17:00:00
+
+# Filter to just errors
+"./scripts/search-events.js" --org myorg --start 2025-12-23T15:00:00 \
+  --level error
+
+# Find a specific transaction type
+"./scripts/search-events.js" --org myorg --start 2025-12-23T15:00:00 \
+  --transaction process-incoming-email
+```
+
+### “What errors have occurred recently?”
+
+```bash
+# List unresolved errors from last 24 hours
+"./scripts/list-issues.js" --org myorg --status unresolved --level error --period 24h
+
+# Find high-frequency issues
+"./scripts/list-issues.js" --org myorg --query "times_seen:>50" --sort freq
+
+# Issues affecting users
+"./scripts/list-issues.js" --org myorg --query "is:unresolved has:user" --sort user
+```
+
+### “Get details about a specific issue/event”
+
+```bash
+# Get issue with latest stack trace
+"./scripts/fetch-issue.js" 5765604106 --latest
+"./scripts/fetch-issue.js" https://sentry.io/organizations/myorg/issues/123/ --latest
+"./scripts/fetch-issue.js" MYPROJ-123 --org myorg --latest
+
+# Get specific event with all breadcrumbs
+"./scripts/fetch-event.js" abc123def456 --org myorg --project backend --breadcrumbs
+```
+
+### “Find events with a specific tag”
+
+```bash
+# Find by custom tag (e.g., thread_id, user_id)
+"./scripts/search-events.js" --org myorg --tag thread_id:th_abc123
+
+# Find by user email
+"./scripts/search-events.js" --org myorg --query "user.email:*@example.com"
+```
+
+---
+
+## Fetch issue
+
+```bash
+"./scripts/fetch-issue.js" <issue-id-or-url> [options]
+```
+
+Get details about a specific issue (grouped error).
+
+**Accepts:**
+
+- Issue ID: `5765604106`
+- Issue URL: `https://sentry.io/organizations/sentry/issues/5765604106/`
+- New URL format: `https://myorg.sentry.io/issues/5765604106/`
+- Short ID: `JAVASCRIPT-ABC` (requires `--org`)
+
+**Options:**
+
+- `--latest` include the latest event with full stack trace
+- `--org <org>` organization slug (for short IDs)
+- `--json` output raw JSON
+
+---
+
+## Fetch event
+
+```bash
+"./scripts/fetch-event.js" <event-id> --org <org> --project <project> [options]
+```
+
+**Options:**
+
+- `--org, -o <org>` organization slug (required)
+- `--project, -p <project>` project slug (required)
+- `--breadcrumbs, -b` show all breadcrumbs (default: last 30)
+- `--spans` show span tree for transactions
+- `--json` output raw JSON
+
+---
+
+## Search events (Discover)
+
+```bash
+"./scripts/search-events.js" [options]
+```
+
+**Time range options:**
+
+- `--period, -t <period>` relative time (24h, 7d, 14d)
+- `--start <datetime>` start time (ISO 8601: 2025-12-23T15:00:00)
+- `--end <datetime>` end time (ISO 8601)
+
+**Filter options:**
+
+- `--org, -o <org>` organization slug (required)
+- `--project, -p <project>` project slug or ID
+- `--query, -q <query>` Discover search query
+- `--transaction <name>` transaction name filter
+- `--tag <key:value>` tag filter (repeatable)
+- `--level <level>` level filter (error, warning, info)
+- `--limit, -n <n>` max results (default: 25, max: 100)
+- `--fields <fields>` comma-separated fields to include
+
+**Query syntax (Discover):**
+
+```
+transaction:process-*     Wildcard transaction match
+level:error               Filter by level
+user.email:foo@bar.com    Filter by user
+environment:production    Filter by environment
+has:stack.filename        Has stack trace
+```
+
+---
+
+## List issues
+
+```bash
+"./scripts/list-issues.js" [options]
+```
+
+**Options:**
+
+- `--org, -o <org>` organization slug (required)
+- `--project, -p <project>` project slug (repeatable)
+- `--query, -q <query>` issue search query
+- `--status <status>` unresolved, resolved, ignored
+- `--level <level>` error, warning, info, fatal
+- `--period, -t <period>` time period (default: 14d)
+- `--limit, -n <n>` max results (default: 25)
+- `--sort <sort>` date, new, priority, freq, user
+- `--json` output raw JSON
+
+---
+
+## Search logs (Logs Explorer)
+
+```bash
+"./scripts/search-logs.js" [query|url] [options]
+```
+
+**Options:**
+
+- `--org, -o <org>` organization slug (required unless URL provided)
+- `--project, -p <project>` filter by project slug or ID
+- `--period, -t <period>` time period (default: 24h)
+- `--limit, -n <n>` max results (default: 100, max: 1000)
+- `--json` output raw JSON
+
+---
+
+## Tips
+
+1. Start broad (time window + simple query), then drill into a single event/issue.
+2. Use `--breadcrumbs` on `fetch-event.js` for the full lead-up to an error.
+3. Use `list-issues.js --sort freq` to find recurring problems.
+4. Use tags (`request_id`, `user_id`, etc.) to correlate events.

package/skills/sentry/lib/auth.js

@@ -0,0 +1,99 @@
+import { readFileSync, existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+
+export const SENTRY_API_BASE = "https://sentry.io/api/0";
+
+// Cache for project slug -> ID resolution
+const projectIdCache = new Map();
+
+/**
+ * Get auth token from ~/.sentryclirc
+ * @returns {string} The auth token
+ */
+export function getAuthToken() {
+  const rcPath = join(homedir(), ".sentryclirc");
+  if (!existsSync(rcPath)) {
+    console.error("Error: ~/.sentryclirc not found");
+    console.error("Provide a Sentry auth token via ~/.sentryclirc (user-managed).");
+    process.exit(1);
+  }
+
+  const content = readFileSync(rcPath, "utf-8");
+  const match = content.match(/token\s*=\s*(.+)/);
+  if (!match) {
+    console.error("Error: No token found in ~/.sentryclirc");
+    process.exit(1);
+  }
+  return match[1].trim();
+}
+
+/**
+ * Fetch JSON from a Sentry API endpoint
+ * @param {string} url - The full URL to fetch
+ * @param {string} token - The auth token
+ * @returns {Promise<any>} The parsed JSON response
+ */
+export async function fetchJson(url, token) {
+  const res = await fetch(url, {
+    headers: {
+      Authorization: `Bearer ${token}`,
+    },
+  });
+
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`API error ${res.status}: ${text}`);
+  }
+
+  return res.json();
+}
+
+/**
+ * Format a timestamp for display
+ * @param {string|number} ts - Timestamp (ISO string or unix)
+ * @returns {string} Formatted timestamp
+ */
+export function formatTimestamp(ts) {
+  if (!ts) return "N/A";
+  try {
+    const date = new Date(ts);
+    if (isNaN(date.getTime())) return ts;
+    return date.toLocaleString();
+  } catch {
+    return ts;
+  }
+}
+
+/**
+ * Resolve a project slug to its numeric ID.
+ * If the input is already a numeric ID, returns it as-is.
+ * @param {string} org - Organization slug
+ * @param {string} project - Project slug or numeric ID
+ * @param {string} token - Auth token
+ * @returns {Promise<string>} The numeric project ID
+ */
+export async function resolveProjectId(org, project, token) {
+  // If already numeric, return as-is
+  if (/^\d+$/.test(project)) {
+    return project;
+  }
+
+  // Check cache
+  const cacheKey = `${org}/${project}`;
+  if (projectIdCache.has(cacheKey)) {
+    return projectIdCache.get(cacheKey);
+  }
+
+  // Fetch project details to get the ID
+  const url = `${SENTRY_API_BASE}/projects/${encodeURIComponent(org)}/${encodeURIComponent(project)}/`;
+  const data = await fetchJson(url, token);
+
+  if (!data || !data.id) {
+    throw new Error(`Project '${project}' not found in organization '${org}'`);
+  }
+
+  const id = String(data.id);
+  projectIdCache.set(cacheKey, id);
+  return id;
+}