@tangle-network/starter-foundry 0.7.3 → 0.13.2

package/registry/families/agent-marketplace-ui-ts/files/src/lib/catalog.ts

@@ -0,0 +1,208 @@
+// catalog.ts — single source of truth for "what bundles exist".
+//
+// Two operating modes:
+//
+//   1. Filesystem mode (default, server-side): walks CATALOG_REGISTRY_PATH,
+//      reading every manifest.json + (optionally) AGENTS.md / agents.json.
+//      Used at build time or per-request from server components.
+//
+//   2. API mode (client-fallback): fetches a pre-built catalog snapshot from
+//      CATALOG_API_URL. Use when the foundry repo isn't on the deploy target's
+//      filesystem (Vercel, CF Pages).
+//
+// Both modes return the same `Bundle[]` shape so the rest of the UI is mode-
+// agnostic.
+
+import { promises as fs } from 'node:fs'
+import path from 'node:path'
+
+export interface BundleTaxonomy {
+  language: string
+  runtime: string
+  surface: string
+}
+
+export interface Bundle {
+  /** stable id, matches the directory name under registry/families/ */
+  id: string
+  description: string
+  tags: string[]
+  taxonomy: BundleTaxonomy
+  /**
+   * AGENTS.md path relative to the bundle directory. Single-agent bundles
+   * have one AGENTS.md at the root; multi-agent bundles have an orchestrator
+   * AGENTS.md plus per-role AGENTS.md under roles/. We surface only the
+   * orchestrator path here — the detail page can drill into agents.json.
+   */
+  agentsMdPath?: string
+  /** True if the bundle has agents.json (multi-agent shape). */
+  isMultiAgent: boolean
+  /** Tier1 keywords — drives card-level "what does this do" badges. */
+  tier1Keywords: string[]
+  /**
+   * Optional inline AGENTS.md body. Populated when callers ask the loader to
+   * pre-read the markdown (avoids a separate fs roundtrip per detail view).
+   */
+  agentsMdBody?: string
+  /** Inline agents.json contents (multi-agent only). */
+  agentsJson?: Record<string, unknown>
+}
+
+interface RawManifest {
+  id?: string
+  description?: string
+  tags?: string[]
+  taxonomy?: Partial<BundleTaxonomy>
+  files?: Array<{ source: string; target: string }>
+  tieredKeywords?: { tier1?: string[] }
+  defaults?: { team?: { agentsConfigPath?: string } }
+}
+
+function isManifest(value: unknown): value is RawManifest {
+  return typeof value === 'object' && value !== null
+}
+
+function deriveAgentsMdPath(manifest: RawManifest): string | undefined {
+  const file = manifest.files?.find((f) => f.target === 'AGENTS.md')
+  return file?.target
+}
+
+function deriveIsMultiAgent(manifest: RawManifest): boolean {
+  if (manifest.defaults?.team?.agentsConfigPath) return true
+  return manifest.files?.some((f) => f.target === 'agents.json') ?? false
+}
+
+function bundleFromManifest(manifest: RawManifest): Bundle | null {
+  if (!manifest.id || !manifest.description || !Array.isArray(manifest.tags)) return null
+  const taxonomy: BundleTaxonomy = {
+    language: manifest.taxonomy?.language ?? 'unknown',
+    runtime: manifest.taxonomy?.runtime ?? 'unknown',
+    surface: manifest.taxonomy?.surface ?? 'unknown',
+  }
+  return {
+    id: manifest.id,
+    description: manifest.description,
+    tags: manifest.tags,
+    taxonomy,
+    agentsMdPath: deriveAgentsMdPath(manifest),
+    isMultiAgent: deriveIsMultiAgent(manifest),
+    tier1Keywords: manifest.tieredKeywords?.tier1 ?? [],
+  }
+}
+
+/**
+ * Load every bundle from the on-disk registry. `registryPath` should point at
+ * the `registry/families/` directory.
+ */
+export async function loadCatalog(registryPath: string): Promise<Bundle[]> {
+  const entries = await fs.readdir(registryPath, { withFileTypes: true })
+  const bundles: Bundle[] = []
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue
+    if (entry.name.startsWith('_') || entry.name.startsWith('.')) continue
+    const manifestPath = path.join(registryPath, entry.name, 'manifest.json')
+    let raw: string
+    try {
+      raw = await fs.readFile(manifestPath, 'utf8')
+    } catch {
+      continue
+    }
+    let parsed: unknown
+    try {
+      parsed = JSON.parse(raw)
+    } catch {
+      continue
+    }
+    if (!isManifest(parsed)) continue
+    const bundle = bundleFromManifest(parsed)
+    if (bundle) bundles.push(bundle)
+  }
+  // Stable order: agent-runtime first, then multi-agent, then everything else,
+  // alphabetised within each group. Easier scanning for end users.
+  bundles.sort((a, b) => {
+    const groupA = groupRank(a)
+    const groupB = groupRank(b)
+    if (groupA !== groupB) return groupA - groupB
+    return a.id.localeCompare(b.id)
+  })
+  return bundles
+}
+
+function groupRank(b: Bundle): number {
+  if (b.id.startsWith('agent-runtime-')) return 0
+  if (b.id.startsWith('multi-agent-')) return 1
+  if (b.taxonomy.surface.includes('ui')) return 2
+  return 3
+}
+
+/**
+ * Hydrate a single bundle's AGENTS.md (and agents.json if multi-agent). Useful
+ * for the detail page; avoids loading every bundle's markdown upfront.
+ */
+export async function loadBundleDetail(
+  registryPath: string,
+  bundleId: string,
+): Promise<Bundle | null> {
+  // Convention: directory name matches manifest id. Verified by
+  // scripts/validate-registry.ts on every PR.
+  const manifestPath = path.join(registryPath, bundleId, 'manifest.json')
+  let manifestRaw: string
+  try {
+    manifestRaw = await fs.readFile(manifestPath, 'utf8')
+  } catch {
+    return null
+  }
+  let manifest: unknown
+  try {
+    manifest = JSON.parse(manifestRaw)
+  } catch {
+    return null
+  }
+  if (!isManifest(manifest)) return null
+  const base = bundleFromManifest(manifest)
+  if (!base) return null
+  const bundleDir = path.join(registryPath, bundleId, 'files')
+
+  let agentsMdBody: string | undefined
+  if (base.agentsMdPath) {
+    try {
+      agentsMdBody = await fs.readFile(path.join(bundleDir, 'AGENTS.md'), 'utf8')
+    } catch {
+      // bundle declares AGENTS.md in manifest but file missing — surface as
+      // undefined so the UI shows a "no AGENTS.md found" affordance rather
+      // than crashing.
+    }
+  }
+
+  let agentsJson: Record<string, unknown> | undefined
+  if (base.isMultiAgent) {
+    try {
+      const text = await fs.readFile(path.join(bundleDir, 'agents.json'), 'utf8')
+      const parsed = JSON.parse(text) as unknown
+      if (parsed && typeof parsed === 'object') {
+        agentsJson = parsed as Record<string, unknown>
+      }
+    } catch {
+      // multi-agent flag was inferred from manifest but agents.json missing;
+      // continue without it.
+    }
+  }
+
+  return { ...base, agentsMdBody, agentsJson }
+}
+
+/**
+ * Resolve the catalog source from environment. Server components call this
+ * once; client components receive `Bundle[]` from server props.
+ */
+export function resolveRegistryPath(): string {
+  const fromEnv = process.env.CATALOG_REGISTRY_PATH
+  if (!fromEnv) {
+    throw new Error(
+      'CATALOG_REGISTRY_PATH is not set. Point it at the registry/families ' +
+        'directory of a starter-foundry checkout, or set CATALOG_API_URL to ' +
+        'use a JSON snapshot.',
+    )
+  }
+  return path.resolve(fromEnv)
+}

package/registry/families/agent-marketplace-ui-ts/files/src/lib/search.ts

@@ -0,0 +1,54 @@
+// search.ts — fuzzy search over the bundle catalog. Wraps fuse.js with a tuned
+// key set: id (high weight, exact-id navigation), tags + tier1 keywords (route
+// signals), description (free-text fallback).
+
+import Fuse, { type IFuseOptions } from 'fuse.js'
+import type { Bundle } from './catalog'
+
+const FUSE_OPTIONS: IFuseOptions<Bundle> = {
+  includeScore: true,
+  threshold: 0.4,
+  ignoreLocation: true,
+  keys: [
+    { name: 'id', weight: 0.4 },
+    { name: 'tags', weight: 0.2 },
+    { name: 'tier1Keywords', weight: 0.2 },
+    { name: 'description', weight: 0.15 },
+    { name: 'taxonomy.surface', weight: 0.05 },
+  ],
+}
+
+export interface FilterState {
+  query: string
+  surfaces: string[]
+  shape: 'all' | 'single-agent' | 'multi-agent'
+}
+
+export function emptyFilter(): FilterState {
+  return { query: '', surfaces: [], shape: 'all' }
+}
+
+export function uniqueSurfaces(bundles: Bundle[]): string[] {
+  const set = new Set<string>()
+  for (const b of bundles) set.add(b.taxonomy.surface)
+  return [...set].sort()
+}
+
+/**
+ * Filter + score a bundle list. Empty query returns all bundles in their
+ * input order, filtered by surface/shape predicates only.
+ */
+export function searchBundles(bundles: Bundle[], filter: FilterState): Bundle[] {
+  const filtered = bundles.filter((b) => {
+    if (filter.surfaces.length > 0 && !filter.surfaces.includes(b.taxonomy.surface)) {
+      return false
+    }
+    if (filter.shape === 'single-agent' && b.isMultiAgent) return false
+    if (filter.shape === 'multi-agent' && !b.isMultiAgent) return false
+    return true
+  })
+  const query = filter.query.trim()
+  if (!query) return filtered
+  const fuse = new Fuse(filtered, FUSE_OPTIONS)
+  return fuse.search(query).map((r) => r.item)
+}

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

@@ -0,0 +1,244 @@
+/* sandbox-ui theme tokens — overrideable per app. The sandbox-ui components
+ * read these CSS custom properties; if you swap in your own design system,
+ * replace these values rather than rewriting the components. */
+:root {
+  --background: 0 0% 100%;
+  --foreground: 222 47% 11%;
+  --muted: 210 40% 96%;
+  --muted-foreground: 215 16% 47%;
+  --border: 214 32% 91%;
+  --primary: 222 47% 11%;
+  --primary-foreground: 210 40% 98%;
+  --accent: 210 40% 96%;
+  --accent-foreground: 222 47% 11%;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: 222 47% 6%;
+    --foreground: 210 40% 98%;
+    --muted: 217 33% 17%;
+    --muted-foreground: 215 20% 65%;
+    --border: 217 33% 17%;
+    --primary: 210 40% 98%;
+    --primary-foreground: 222 47% 11%;
+    --accent: 217 33% 17%;
+    --accent-foreground: 210 40% 98%;
+  }
+}
+
+* {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+html,
+body {
+  height: 100%;
+  font-family:
+    -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, sans-serif;
+}
+
+body {
+  background: hsl(var(--background));
+  color: hsl(var(--foreground));
+  line-height: 1.5;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}
+
+button {
+  font: inherit;
+  cursor: pointer;
+}
+
+code,
+pre {
+  font-family: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, monospace;
+  font-size: 0.875em;
+}
+
+pre {
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+
+/* Layout primitives — kept here rather than per-component so the surface area
+ * is small and easy to theme. */
+.mp-container {
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 0 24px;
+}
+
+.mp-header {
+  border-bottom: 1px solid hsl(var(--border));
+  padding: 24px 0;
+  margin-bottom: 24px;
+}
+
+.mp-h1 {
+  font-size: 1.75rem;
+  font-weight: 600;
+  letter-spacing: -0.02em;
+}
+
+.mp-h2 {
+  font-size: 1.25rem;
+  font-weight: 600;
+  margin-bottom: 12px;
+}
+
+.mp-muted {
+  color: hsl(var(--muted-foreground));
+  font-size: 0.875rem;
+}
+
+.mp-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
+  gap: 16px;
+}
+
+.mp-card {
+  border: 1px solid hsl(var(--border));
+  border-radius: 8px;
+  padding: 16px;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  transition: border-color 0.15s ease;
+  background: hsl(var(--background));
+}
+
+.mp-card:hover {
+  border-color: hsl(var(--primary));
+}
+
+.mp-card-title {
+  font-weight: 600;
+  font-size: 1rem;
+  word-break: break-word;
+}
+
+.mp-card-desc {
+  color: hsl(var(--muted-foreground));
+  font-size: 0.875rem;
+  display: -webkit-box;
+  -webkit-line-clamp: 3;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+
+.mp-tag {
+  display: inline-block;
+  padding: 2px 8px;
+  border-radius: 999px;
+  background: hsl(var(--muted));
+  color: hsl(var(--muted-foreground));
+  font-size: 0.75rem;
+  margin-right: 4px;
+  margin-bottom: 4px;
+}
+
+.mp-badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 2px 8px;
+  border-radius: 4px;
+  background: hsl(var(--accent));
+  color: hsl(var(--accent-foreground));
+  font-size: 0.75rem;
+  font-weight: 500;
+}
+
+.mp-badge-multi {
+  background: hsl(217 91% 60% / 0.15);
+  color: hsl(217 91% 35%);
+}
+
+.mp-badge-single {
+  background: hsl(142 71% 45% / 0.15);
+  color: hsl(142 71% 30%);
+}
+
+.mp-input {
+  width: 100%;
+  padding: 8px 12px;
+  border: 1px solid hsl(var(--border));
+  border-radius: 6px;
+  background: hsl(var(--background));
+  color: hsl(var(--foreground));
+  font-size: 0.875rem;
+}
+
+.mp-input:focus {
+  outline: 2px solid hsl(var(--primary));
+  outline-offset: -1px;
+}
+
+.mp-button {
+  padding: 8px 16px;
+  border: 1px solid hsl(var(--border));
+  border-radius: 6px;
+  background: hsl(var(--primary));
+  color: hsl(var(--primary-foreground));
+  font-weight: 500;
+  font-size: 0.875rem;
+}
+
+.mp-button:hover {
+  opacity: 0.9;
+}
+
+.mp-button-secondary {
+  background: hsl(var(--background));
+  color: hsl(var(--foreground));
+}
+
+.mp-filters {
+  display: flex;
+  gap: 12px;
+  align-items: center;
+  flex-wrap: wrap;
+  margin-bottom: 24px;
+}
+
+.mp-codeblock {
+  border: 1px solid hsl(var(--border));
+  border-radius: 6px;
+  padding: 12px;
+  background: hsl(var(--muted));
+  position: relative;
+  margin: 8px 0;
+}
+
+.mp-codeblock pre {
+  font-size: 0.8125rem;
+}
+
+.mp-step {
+  border: 1px solid hsl(var(--border));
+  border-radius: 8px;
+  padding: 16px;
+  margin-bottom: 12px;
+}
+
+.mp-step-num {
+  display: inline-block;
+  width: 24px;
+  height: 24px;
+  border-radius: 50%;
+  background: hsl(var(--primary));
+  color: hsl(var(--primary-foreground));
+  text-align: center;
+  line-height: 24px;
+  font-size: 0.8125rem;
+  font-weight: 600;
+  margin-right: 8px;
+}

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

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "preserve",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "incremental": true,
+    "noEmit": true,
+    "allowJs": false,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+    "plugins": [{ "name": "next" }]
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

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

@@ -0,0 +1,105 @@
+{
+  "id": "agent-marketplace-ui-ts",
+  "description": "Next.js public catalog UI for browsing and installing agent bundles. Lists agent-runtime + multi-agent bundles, renders AGENTS.md preview via ui-adapter:blocks-renderer, guides users through pnpm-exec deploy commands. Composes @tangle-network/sandbox-ui primitives.",
+  "tags": [
+    "ui",
+    "agent-marketplace",
+    "catalog-browser",
+    "bundle-store",
+    "next.js",
+    "react"
+  ],
+  "taxonomy": {
+    "language": "typescript",
+    "runtime": "next.js",
+    "surface": "ui"
+  },
+  "slots": {
+    "ui-adapter": {
+      "options": ["ui-adapter:blocks-renderer"],
+      "default": "ui-adapter:blocks-renderer"
+    }
+  },
+  "defaults": {
+    "projectType": "agent-marketplace-ui",
+    "appName": "agent-marketplace",
+    "publicVars": ["CATALOG_REGISTRY_PATH"],
+    "port": 3000
+  },
+  "files": [
+    { "source": "files/package.json", "target": "package.json" },
+    { "source": "files/next.config.js", "target": "next.config.js" },
+    { "source": "files/tsconfig.json", "target": "tsconfig.json" },
+    { "source": "files/.env.example", "target": ".env.example" },
+    { "source": "files/README.md", "target": "README.md" },
+    { "source": "files/src/app/layout.tsx", "target": "src/app/layout.tsx" },
+    { "source": "files/src/app/page.tsx", "target": "src/app/page.tsx" },
+    { "source": "files/src/app/page-client.tsx", "target": "src/app/page-client.tsx" },
+    { "source": "files/src/app/bundles/[id]/page.tsx", "target": "src/app/bundles/[id]/page.tsx" },
+    { "source": "files/src/app/deploy/[id]/page.tsx", "target": "src/app/deploy/[id]/page.tsx" },
+    { "source": "files/src/components/BundleCard.tsx", "target": "src/components/BundleCard.tsx" },
+    { "source": "files/src/components/BundleGrid.tsx", "target": "src/components/BundleGrid.tsx" },
+    { "source": "files/src/components/SearchFilters.tsx", "target": "src/components/SearchFilters.tsx" },
+    { "source": "files/src/components/AgentsMdPreview.tsx", "target": "src/components/AgentsMdPreview.tsx" },
+    { "source": "files/src/components/DeployFlow.tsx", "target": "src/components/DeployFlow.tsx" },
+    { "source": "files/src/lib/catalog.ts", "target": "src/lib/catalog.ts" },
+    { "source": "files/src/lib/search.ts", "target": "src/lib/search.ts" },
+    { "source": "files/src/styles/globals.css", "target": "src/styles/globals.css" },
+    { "source": "files/pnpm-workspace.yaml", "target": "pnpm-workspace.yaml" }
+  ],
+  "validationChecks": [
+    { "type": "file-exists", "path": "package.json" },
+    { "type": "file-exists", "path": "next.config.js" },
+    { "type": "file-exists", "path": "tsconfig.json" },
+    { "type": "file-exists", "path": "src/app/layout.tsx" },
+    { "type": "file-exists", "path": "src/app/page.tsx" },
+    { "type": "file-exists", "path": "src/app/bundles/[id]/page.tsx" },
+    { "type": "file-exists", "path": "src/app/deploy/[id]/page.tsx" },
+    { "type": "file-exists", "path": "src/components/BundleCard.tsx" },
+    { "type": "file-exists", "path": "src/components/AgentsMdPreview.tsx" },
+    { "type": "file-exists", "path": "src/components/DeployFlow.tsx" },
+    { "type": "file-exists", "path": "src/lib/catalog.ts" },
+    { "type": "file-exists", "path": "src/lib/search.ts" },
+    { "type": "file-exists", "path": "src/lib/parse-blocks.ts" },
+    { "type": "file-exists", "path": "src/lib/blocks-to-artifacts.tsx" }
+  ],
+  "contextHints": {
+    "commands": [
+      "pnpm dev",
+      "pnpm build",
+      "pnpm start"
+    ],
+    "entrypoints": [
+      "src/app/page.tsx",
+      "src/app/bundles/[id]/page.tsx",
+      "src/app/deploy/[id]/page.tsx"
+    ],
+    "extensionPoints": [
+      "src/lib/catalog.ts",
+      "src/components/DeployFlow.tsx",
+      "src/components/AgentsMdPreview.tsx"
+    ]
+  },
+  "tieredKeywords": {
+    "tier1": [
+      "agent-marketplace-ui",
+      "agent-catalog-ui",
+      "agent-bundle-browser",
+      "agent-store-ui",
+      "bundle-marketplace-app"
+    ],
+    "tier2": [
+      "bundle-discovery",
+      "agent-install-flow",
+      "marketplace-search",
+      "bundle-detail-page",
+      "agent-card-grid"
+    ],
+    "tier3": [
+      "marketplace"
+    ],
+    "archetypes": [
+      "catalog-ui"
+    ]
+  }
+}

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

@@ -0,0 +1,45 @@
+name: research
+
+on:
+  schedule:
+    - cron: "17 5 * * *"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  sweep:
+    runs-on: ubuntu-latest
+    timeout-minutes: 45
+    env:
+      TANGLE_API_KEY: ${{ secrets.TANGLE_API_KEY }}
+      TANGLE_SANDBOX_KEY: ${{ secrets.TANGLE_SANDBOX_KEY }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: pip
+
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install -e .
+
+      - name: Test
+        run: pytest -q
+
+      - name: Sweep (propose -> screen -> validate)
+        if: env.TANGLE_API_KEY != '' && env.TANGLE_SANDBOX_KEY != ''
+        run: python -m research sweep --reps 5 --top-k 3
+
+      - name: Upload results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: research-results
+          path: research-results/
+          if-no-files-found: ignore