@tangle-network/starter-foundry 0.7.3 → 0.13.2

package/registry/families/agent-debug-ui-ts/files/src/styles.css

@@ -0,0 +1,382 @@
+@import '@tangle-network/sandbox-ui/styles';
+
+:root {
+  color-scheme: dark;
+  --bg: #0b1120;
+  --bg-pane: #0f172a;
+  --bg-pane-soft: #111c33;
+  --border: #1e293b;
+  --text: #e2e8f0;
+  --text-soft: #94a3b8;
+  --accent: #38bdf8;
+  --error: #f87171;
+  font-family: ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Inter, sans-serif;
+}
+
+html,
+body,
+#root {
+  height: 100%;
+  margin: 0;
+  background: var(--bg);
+  color: var(--text);
+}
+
+* {
+  box-sizing: border-box;
+}
+
+.app {
+  display: grid;
+  grid-template-rows: auto auto 1fr auto;
+  height: 100vh;
+}
+
+.app--config-error {
+  display: block;
+  padding: 32px;
+  max-width: 640px;
+  margin: 0 auto;
+}
+
+.app__header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 16px;
+  padding: 12px 20px;
+  border-bottom: 1px solid var(--border);
+  background: var(--bg-pane);
+}
+
+.app__header h1 {
+  margin: 0;
+  font-size: 16px;
+}
+
+.app__subtitle {
+  margin: 2px 0 0;
+  font-size: 12px;
+  color: var(--text-soft);
+}
+
+.app__prompt-bar {
+  display: flex;
+  gap: 8px;
+  flex: 1;
+  max-width: 720px;
+}
+
+.app__prompt-bar input {
+  flex: 1;
+  padding: 8px 10px;
+  border-radius: 6px;
+  border: 1px solid var(--border);
+  background: var(--bg-pane-soft);
+  color: var(--text);
+  font-size: 13px;
+}
+
+.app__prompt-bar button {
+  padding: 8px 14px;
+  border-radius: 6px;
+  border: 1px solid var(--accent);
+  background: var(--accent);
+  color: #0b1120;
+  font-weight: 600;
+  cursor: pointer;
+}
+
+.app__prompt-bar button:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+.app__error {
+  padding: 8px 20px;
+  background: rgba(248, 113, 113, 0.12);
+  color: var(--error);
+  border-bottom: 1px solid rgba(248, 113, 113, 0.3);
+  font-size: 13px;
+}
+
+.app__grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  grid-template-rows: 1fr 1fr;
+  gap: 1px;
+  background: var(--border);
+  overflow: hidden;
+}
+
+.app__pane {
+  background: var(--bg-pane);
+  overflow: auto;
+  padding: 12px 14px;
+  min-height: 0;
+}
+
+.app__pane--chat {
+  grid-column: 1;
+  grid-row: 1;
+}
+
+.app__pane--stream {
+  grid-column: 2;
+  grid-row: 1;
+}
+
+.app__pane--tools {
+  grid-column: 1;
+  grid-row: 2;
+}
+
+.app__pane--inspector {
+  grid-column: 2;
+  grid-row: 2;
+}
+
+.app__footer {
+  border-top: 1px solid var(--border);
+  background: var(--bg-pane);
+}
+
+/* Chat pair */
+.chat-pair {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+.chat-pair__msg {
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  padding: 10px 12px;
+  background: var(--bg-pane-soft);
+}
+
+.chat-pair__msg header {
+  font-size: 11px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: var(--text-soft);
+  margin-bottom: 6px;
+}
+
+.chat-pair__msg pre {
+  margin: 0;
+  white-space: pre-wrap;
+  word-break: break-word;
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 13px;
+  line-height: 1.5;
+}
+
+.chat-pair__streaming {
+  color: var(--accent);
+  font-weight: 400;
+  text-transform: none;
+}
+
+.chat-pair__locked {
+  color: #86efac;
+  font-weight: 400;
+  text-transform: none;
+}
+
+.chat-pair__reasoning {
+  margin-bottom: 8px;
+  font-size: 12px;
+  color: var(--text-soft);
+}
+
+.chat-pair__reasoning summary {
+  cursor: pointer;
+}
+
+/* Event stream */
+.event-stream {
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 12px;
+}
+
+.event-stream--empty,
+.tool-timeline--empty,
+.event-inspector--empty {
+  color: var(--text-soft);
+}
+
+.event-stream__header,
+.tool-timeline__header {
+  display: flex;
+  justify-content: space-between;
+  font-size: 11px;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: var(--text-soft);
+  margin-bottom: 8px;
+}
+
+.event-stream__list,
+.tool-timeline__list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
+
+.event-stream__row {
+  display: grid;
+  grid-template-columns: 50px 60px 160px 1fr;
+  gap: 8px;
+  padding: 4px 6px;
+  border-radius: 4px;
+  cursor: pointer;
+  align-items: baseline;
+}
+
+.event-stream__row:hover {
+  background: var(--bg-pane-soft);
+}
+
+.event-stream__row--selected {
+  background: rgba(56, 189, 248, 0.16);
+  outline: 1px solid var(--accent);
+}
+
+.event-stream__idx {
+  color: var(--text-soft);
+}
+
+.event-stream__elapsed {
+  color: var(--text-soft);
+}
+
+.event-stream__type {
+  font-weight: 600;
+}
+
+.event-stream__summary {
+  color: var(--text);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+/* Tool timeline */
+.tool-timeline__row {
+  padding: 6px 4px;
+  border-radius: 4px;
+  cursor: pointer;
+}
+
+.tool-timeline__row:hover {
+  background: var(--bg-pane-soft);
+}
+
+.tool-timeline__row--selected {
+  outline: 1px solid var(--accent);
+}
+
+.tool-timeline__label {
+  display: flex;
+  gap: 12px;
+  align-items: baseline;
+  font-size: 12px;
+  margin-bottom: 4px;
+}
+
+.tool-timeline__state {
+  text-transform: uppercase;
+  font-size: 10px;
+  letter-spacing: 0.05em;
+}
+
+.tool-timeline__duration {
+  color: var(--text-soft);
+  font-size: 11px;
+}
+
+.tool-timeline__track {
+  position: relative;
+  height: 8px;
+  background: var(--bg-pane-soft);
+  border-radius: 4px;
+  overflow: hidden;
+}
+
+.tool-timeline__bar {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  border-radius: 4px;
+}
+
+/* Event inspector */
+.event-inspector__header {
+  display: flex;
+  gap: 12px;
+  font-size: 11px;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: var(--text-soft);
+  margin-bottom: 8px;
+}
+
+.event-inspector__type {
+  color: var(--accent);
+}
+
+.event-inspector__json {
+  margin: 0;
+  white-space: pre-wrap;
+  word-break: break-word;
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 12px;
+  background: var(--bg-pane-soft);
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  padding: 10px;
+}
+
+/* Replay scrubber */
+.replay-scrubber {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 10px 16px;
+}
+
+.replay-scrubber__btn {
+  padding: 6px 12px;
+  border-radius: 6px;
+  border: 1px solid var(--border);
+  background: var(--bg-pane-soft);
+  color: var(--text);
+  cursor: pointer;
+  font-weight: 600;
+}
+
+.replay-scrubber__btn--live {
+  border-color: var(--accent);
+  color: var(--accent);
+}
+
+.replay-scrubber__btn:disabled {
+  opacity: 0.4;
+  cursor: not-allowed;
+}
+
+.replay-scrubber__range {
+  flex: 1;
+}
+
+.replay-scrubber__readout {
+  color: var(--text-soft);
+  font-size: 12px;
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  white-space: nowrap;
+}

package/registry/families/agent-debug-ui-ts/files/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "allowImportingTsExtensions": false,
+    "noEmit": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  },
+  "include": ["src"],
+  "references": [{ "path": "./tsconfig.node.json" }]
+}

package/registry/families/agent-debug-ui-ts/files/tsconfig.node.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "composite": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "target": "ES2022",
+    "skipLibCheck": true,
+    "allowSyntheticDefaultImports": true
+  },
+  "include": ["vite.config.ts"]
+}

package/registry/families/agent-debug-ui-ts/files/vite.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+import path from 'node:path'
+
+export default defineConfig({
+  plugins: [react()],
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, 'src'),
+    },
+  },
+  server: {
+    port: 4180,
+  },
+})

package/registry/families/agent-debug-ui-ts/manifest.json

@@ -0,0 +1,92 @@
+{
+  "id": "agent-debug-ui-ts",
+  "description": "Vite+React UI for live debugging of agent runs. Connects to a Tangle sandbox via @tangle-network/sandbox SSE stream, visualizes events in real-time, supports step-through replay. Composes ui-adapter:blocks-renderer + @tangle-network/sandbox-ui primitives.",
+  "tags": [
+    "ui",
+    "agent-debug",
+    "debugger",
+    "live-trace",
+    "sse-stream",
+    "vite",
+    "react"
+  ],
+  "taxonomy": {
+    "language": "typescript",
+    "runtime": "vite",
+    "surface": "ui"
+  },
+  "slots": {
+    "ui-adapter": {
+      "options": ["ui-adapter:blocks-renderer"],
+      "default": "ui-adapter:blocks-renderer"
+    }
+  },
+  "defaults": {
+    "projectType": "agent-debug-ui",
+    "publicVars": ["TANGLE_SANDBOX_BASE_URL", "SANDBOX_ID"]
+  },
+  "files": [
+    { "source": "files/package.json", "target": "package.json" },
+    { "source": "files/tsconfig.json", "target": "tsconfig.json" },
+    { "source": "files/tsconfig.node.json", "target": "tsconfig.node.json" },
+    { "source": "files/vite.config.ts", "target": "vite.config.ts" },
+    { "source": "files/index.html", "target": "index.html" },
+    { "source": "files/.env.example", "target": ".env.example" },
+    { "source": "files/README.md", "target": "README.md" },
+    { "source": "files/src/main.tsx", "target": "src/main.tsx" },
+    { "source": "files/src/App.tsx", "target": "src/App.tsx" },
+    { "source": "files/src/styles.css", "target": "src/styles.css" },
+    { "source": "files/src/components/EventStream.tsx", "target": "src/components/EventStream.tsx" },
+    { "source": "files/src/components/ToolCallTimeline.tsx", "target": "src/components/ToolCallTimeline.tsx" },
+    { "source": "files/src/components/ChatPair.tsx", "target": "src/components/ChatPair.tsx" },
+    { "source": "files/src/components/EventInspector.tsx", "target": "src/components/EventInspector.tsx" },
+    { "source": "files/src/components/ReplayScrubber.tsx", "target": "src/components/ReplayScrubber.tsx" },
+    { "source": "files/src/lib/sandbox-stream.ts", "target": "src/lib/sandbox-stream.ts" },
+    { "source": "files/src/lib/event-types.ts", "target": "src/lib/event-types.ts" },
+    { "source": "files/pnpm-workspace.yaml", "target": "pnpm-workspace.yaml" }
+  ],
+  "validationChecks": [
+    { "type": "file-exists", "path": "package.json" },
+    { "type": "file-exists", "path": "index.html" },
+    { "type": "file-exists", "path": "vite.config.ts" },
+    { "type": "file-exists", "path": "tsconfig.json" },
+    { "type": "file-exists", "path": "src/main.tsx" },
+    { "type": "file-exists", "path": "src/App.tsx" },
+    { "type": "file-exists", "path": "src/lib/sandbox-stream.ts" },
+    { "type": "file-exists", "path": "src/lib/event-types.ts" },
+    { "type": "file-exists", "path": "src/components/EventStream.tsx" },
+    { "type": "file-exists", "path": "src/components/ToolCallTimeline.tsx" },
+    { "type": "file-exists", "path": "src/components/ChatPair.tsx" },
+    { "type": "file-exists", "path": "src/components/EventInspector.tsx" },
+    { "type": "file-exists", "path": "src/components/ReplayScrubber.tsx" },
+    { "type": "file-exists", "path": "src/lib/parse-blocks.ts" },
+    { "type": "file-exists", "path": "src/lib/blocks-to-artifacts.tsx" }
+  ],
+  "tieredKeywords": {
+    "tier1": [
+      "agent-debug-ui",
+      "agent-debugger",
+      "live-trace-debugger",
+      "agent-step-debugger",
+      "agent-stream-debugger"
+    ],
+    "tier2": [
+      "sse-stream",
+      "tool-call-inspector",
+      "live-replay",
+      "step-through-agent",
+      "event-timeline"
+    ],
+    "tier3": ["debugger"],
+    "archetypes": ["debug-ui"]
+  },
+  "contextHints": {
+    "commands": ["pnpm dev", "pnpm build"],
+    "entrypoints": ["src/App.tsx"],
+    "extensionPoints": [
+      "src/App.tsx",
+      "src/lib/sandbox-stream.ts",
+      "src/components/EventStream.tsx"
+    ]
+  }
+}

package/registry/families/agent-eval-harness-py/files/.github/workflows/eval.yml

@@ -0,0 +1,70 @@
+name: eval
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: pytest + example eval
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install (with dev extras)
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: pytest
+        run: pytest -q
+
+      - name: Run example eval (driver=local, no judge)
+        run: |
+          python -m eval run \
+            --scenarios scenarios \
+            --out artifacts/scorecard.json \
+            --driver local \
+            --product agent-eval-harness-py-ci
+
+      - name: Upload scorecard artifact
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: scorecard
+          path: artifacts/scorecard.json
+          if-no-files-found: error
+
+      - name: Regression gate (vs main baseline if present)
+        if: github.event_name == 'pull_request'
+        env:
+          BASELINE_URL: https://raw.githubusercontent.com/${{ github.repository }}/main/artifacts/scorecard.json
+        run: |
+          set -euo pipefail
+          mkdir -p artifacts
+          if curl -fsSL "$BASELINE_URL" -o artifacts/baseline.json 2>/dev/null; then
+            python -m eval compare artifacts/baseline.json artifacts/scorecard.json \
+              --out artifacts/gate-report.json
+          else
+            echo "[eval.compare] no baseline at $BASELINE_URL; first-run skip"
+          fi
+
+      - name: Upload gate report
+        if: github.event_name == 'pull_request' && always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: gate-report
+          path: artifacts/gate-report.json
+          if-no-files-found: ignore