@tangle-network/starter-foundry 0.1.0

package/registry/layers/capability/webrtc/files/call-controls.tsx

@@ -0,0 +1,82 @@
+'use client'
+
+import { cn } from '@/lib/utils'
+import { Button } from '@/components/ui/button'
+import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from '@/components/ui/tooltip'
+import { Mic, MicOff, Video, VideoOff, Monitor, MessageSquare, PhoneOff } from 'lucide-react'
+
+interface CallControlsProps {
+  isMuted: boolean
+  isCameraOff: boolean
+  isScreenSharing: boolean
+  onToggleMic: () => void
+  onToggleCamera: () => void
+  onShareScreen: () => void
+  onToggleChat: () => void
+  onLeave: () => void
+}
+
+const controls = (props: CallControlsProps) => [
+  {
+    icon: props.isMuted ? MicOff : Mic,
+    label: props.isMuted ? 'Unmute' : 'Mute',
+    onClick: props.onToggleMic,
+    active: !props.isMuted,
+    destructive: false,
+  },
+  {
+    icon: props.isCameraOff ? VideoOff : Video,
+    label: props.isCameraOff ? 'Turn on camera' : 'Turn off camera',
+    onClick: props.onToggleCamera,
+    active: !props.isCameraOff,
+    destructive: false,
+  },
+  {
+    icon: Monitor,
+    label: props.isScreenSharing ? 'Stop sharing' : 'Share screen',
+    onClick: props.onShareScreen,
+    active: props.isScreenSharing,
+    destructive: false,
+  },
+  {
+    icon: MessageSquare,
+    label: 'Chat',
+    onClick: props.onToggleChat,
+    active: false,
+    destructive: false,
+  },
+  {
+    icon: PhoneOff,
+    label: 'Leave call',
+    onClick: props.onLeave,
+    active: false,
+    destructive: true,
+  },
+]
+
+export function CallControls(props: CallControlsProps) {
+  return (
+    <div className="flex items-center justify-center gap-2 border-t border-zinc-800 bg-zinc-950 px-4 py-3">
+      <TooltipProvider delayDuration={0}>
+        {controls(props).map((ctrl) => (
+          <Tooltip key={ctrl.label}>
+            <TooltipTrigger asChild>
+              <Button
+                variant={ctrl.destructive ? 'destructive' : ctrl.active ? 'secondary' : 'outline'}
+                size="icon"
+                className={cn(
+                  'h-10 w-10 rounded-full',
+                  !ctrl.destructive && !ctrl.active && 'border-zinc-700 bg-zinc-800 text-zinc-300 hover:bg-zinc-700'
+                )}
+                onClick={ctrl.onClick}
+              >
+                <ctrl.icon className="h-4 w-4" />
+              </Button>
+            </TooltipTrigger>
+            <TooltipContent side="top">{ctrl.label}</TooltipContent>
+          </Tooltip>
+        ))}
+      </TooltipProvider>
+    </div>
+  )
+}

package/registry/layers/capability/webrtc/files/participant-tile.tsx

@@ -0,0 +1,66 @@
+import * as React from 'react'
+import { cn } from '@/lib/utils'
+import { Mic, MicOff, VideoOff } from 'lucide-react'
+
+interface ParticipantTileProps {
+  name: string
+  videoTrack?: MediaStreamTrack
+  audioTrack?: MediaStreamTrack
+  isMuted: boolean
+  isCameraOff: boolean
+}
+
+export function ParticipantTile({ name, videoTrack, isMuted, isCameraOff }: ParticipantTileProps) {
+  const videoRef = React.useRef<HTMLVideoElement>(null)
+
+  React.useEffect(() => {
+    if (videoTrack && videoRef.current) {
+      const stream = new MediaStream([videoTrack])
+      videoRef.current.srcObject = stream
+    }
+  }, [videoTrack])
+
+  const initials = name
+    .split(' ')
+    .map((n) => n[0])
+    .join('')
+    .toUpperCase()
+    .slice(0, 2)
+
+  return (
+    <div className="relative flex h-full w-full items-center justify-center overflow-hidden rounded-lg bg-zinc-900">
+      {isCameraOff ? (
+        <div className="flex flex-col items-center gap-2">
+          <div className="flex h-16 w-16 items-center justify-center rounded-full bg-zinc-700 text-lg font-semibold text-zinc-300">
+            {initials}
+          </div>
+          <VideoOff className="h-4 w-4 text-zinc-500" />
+        </div>
+      ) : (
+        <video ref={videoRef} autoPlay playsInline muted className="h-full w-full object-cover" />
+      )}
+
+      <div className="absolute bottom-0 left-0 right-0 flex items-center justify-between bg-gradient-to-t from-black/70 to-transparent px-3 py-2">
+        <span className="truncate text-xs font-medium text-white">{name}</span>
+        <div className="flex items-center gap-1">
+          {!isMuted && (
+            <div className="flex items-end gap-px">
+              {[12, 16, 10].map((h, i) => (
+                <div
+                  key={i}
+                  className="w-0.5 animate-pulse rounded-full bg-emerald-400"
+                  style={{ height: `${h}px`, animationDelay: `${i * 150}ms` }}
+                />
+              ))}
+            </div>
+          )}
+          {isMuted ? (
+            <MicOff className="h-3.5 w-3.5 text-red-400" />
+          ) : (
+            <Mic className="h-3.5 w-3.5 text-emerald-400" />
+          )}
+        </div>
+      </div>
+    </div>
+  )
+}

package/registry/layers/capability/webrtc/files/video-room.tsx

@@ -0,0 +1,97 @@
+'use client'
+
+import * as React from 'react'
+import { cn } from '@/lib/utils'
+import { Badge } from '@/components/ui/badge'
+import { ParticipantTile } from './participant-tile'
+
+interface Participant {
+  id: string
+  name: string
+  videoTrack?: MediaStreamTrack
+  audioTrack?: MediaStreamTrack
+  isLocal: boolean
+}
+
+interface VideoRoomProps {
+  participants: Participant[]
+  onLeave: () => void
+}
+
+type ConnectionStatus = 'connecting' | 'connected' | 'disconnected'
+
+const statusStyles: Record<ConnectionStatus, { variant: 'default' | 'secondary' | 'destructive'; label: string }> = {
+  connecting: { variant: 'secondary', label: 'Connecting...' },
+  connected: { variant: 'default', label: 'Connected' },
+  disconnected: { variant: 'destructive', label: 'Disconnected' },
+}
+
+function gridCols(count: number): string {
+  if (count <= 1) return 'grid-cols-1'
+  if (count <= 4) return 'grid-cols-2'
+  if (count <= 9) return 'grid-cols-3'
+  return 'grid-cols-4'
+}
+
+export function VideoRoom({ participants, onLeave }: VideoRoomProps) {
+  const [status, setStatus] = React.useState<ConnectionStatus>('connecting')
+
+  React.useEffect(() => {
+    const timer = setTimeout(() => setStatus('connected'), 1500)
+    return () => clearTimeout(timer)
+  }, [])
+
+  const remoteParticipants = participants.filter((p) => !p.isLocal)
+  const localParticipant = participants.find((p) => p.isLocal)
+
+  const { variant, label } = statusStyles[status]
+
+  return (
+    <div className="relative flex h-full flex-col bg-black">
+      <div className="flex items-center justify-between px-4 py-2">
+        <Badge variant={variant} className="text-xs">
+          {label}
+        </Badge>
+        <span className="text-xs text-zinc-400">
+          {participants.length} participant{participants.length !== 1 && 's'}
+        </span>
+      </div>
+
+      <div
+        className={cn(
+          'grid flex-1 gap-2 p-2',
+          gridCols(remoteParticipants.length || 1)
+        )}
+      >
+        {remoteParticipants.length === 0 ? (
+          <div className="flex items-center justify-center rounded-lg border border-dashed border-zinc-700 text-zinc-500">
+            <p className="text-sm">Waiting for others to join...</p>
+          </div>
+        ) : (
+          remoteParticipants.map((p) => (
+            <ParticipantTile
+              key={p.id}
+              name={p.name}
+              videoTrack={p.videoTrack}
+              audioTrack={p.audioTrack}
+              isMuted={!p.audioTrack}
+              isCameraOff={!p.videoTrack}
+            />
+          ))
+        )}
+      </div>
+
+      {localParticipant && (
+        <div className="absolute bottom-4 right-4 h-36 w-48 overflow-hidden rounded-lg border-2 border-zinc-700 shadow-lg">
+          <ParticipantTile
+            name={localParticipant.name}
+            videoTrack={localParticipant.videoTrack}
+            audioTrack={localParticipant.audioTrack}
+            isMuted={!localParticipant.audioTrack}
+            isCameraOff={!localParticipant.videoTrack}
+          />
+        </div>
+      )}
+    </div>
+  )
+}

package/registry/layers/capability/webrtc/files/webrtc-config.json

@@ -0,0 +1,18 @@
+{
+  "provider": "livekit",
+  "signalingUrl": "{{signalingUrl}}",
+  "iceServers": [
+    { "urls": "stun:stun.l.google.com:19302" }
+  ],
+  "maxParticipants": "{{maxParticipants}}",
+  "features": {
+    "screenShare": true,
+    "recording": false,
+    "chat": true,
+    "handRaise": true
+  },
+  "layout": {
+    "mode": "grid",
+    "spotlightThreshold": 4
+  }
+}

package/registry/layers/capability/webrtc/manifest.json

@@ -0,0 +1,30 @@
+{
+  "id": "webrtc",
+  "description": "Adds WebRTC video/voice calling with room management, screen sharing, and participant grid.",
+  "group": "capability",
+  "appliesTo": ["nextjs-ts", "react-vite-ts", "fullstack-ts", "remix-ts"],
+  "keywords": ["webrtc", "video call", "voice call", "video chat", "screen sharing", "video conference", "peer to peer", "livekit", "daily", "huddle", "zoom clone", "google meet"],
+  "files": [
+    { "source": "files/webrtc-config.json", "target": "webrtc-config.json" },
+    { "source": "files/video-room.tsx", "target": "src/components/webrtc/video-room.tsx" },
+    { "source": "files/participant-tile.tsx", "target": "src/components/webrtc/participant-tile.tsx" },
+    { "source": "files/call-controls.tsx", "target": "src/components/webrtc/call-controls.tsx" }
+  ],
+  "defaults": {
+    "signalingUrl": "ws://localhost:7880",
+    "maxParticipants": 12
+  },
+  "buildHints": {
+    "pages": ["/room", "/room/[id]"],
+    "apiRoutes": ["/api/room/create", "/api/room/token"],
+    "components": ["VideoRoom", "ParticipantTile", "CallControls", "ScreenShareView"],
+    "integrations": ["LiveKit or Daily.co for SFU signaling", "STUN/TURN for NAT traversal"],
+    "architectureNotes": [
+      "VideoRoom manages local/remote media streams and participant grid layout.",
+      "CallControls provides mute/unmute, camera toggle, screen share, and leave buttons.",
+      "ParticipantTile renders a single video with name overlay and audio indicator.",
+      "Wire /api/room/token to generate room access tokens from your signaling provider.",
+      "For production, use LiveKit Cloud or self-hosted LiveKit server."
+    ]
+  }
+}

package/registry/layers/database/convex/files/database-config.json

@@ -0,0 +1,5 @@
+{
+  "provider": "convex",
+  "driver": "@convex-dev/server",
+  "connection": "convex://example-project"
+}

package/registry/layers/database/convex/manifest.json

@@ -0,0 +1,31 @@
+{
+  "id": "convex",
+  "slot": "database",
+  "description": "Database profile for Convex-backed starters.",
+  "appliesTo": [
+    "api-service",
+    "python-api",
+    "rust-service",
+    "cloudflare-worker-ts",
+    "fullstack-ts",
+    "go-api",
+    "mcp-server-ts",
+    "dspy-pipeline-py",
+    "agent-service-ts",
+    "agent-service-py",
+    "agent-service-rust",
+    "x402-service",
+    "zk-prover-service",
+    "evm-infra-ts",
+    "python-worker"
+  ],
+  "defaults": {
+    "databaseProvider": "convex"
+  },
+  "files": [
+    {
+      "source": "files/database-config.json",
+      "target": "database-config.json"
+    }
+  ]
+}

package/registry/layers/database/mongodb/files/database-config.json

@@ -0,0 +1,5 @@
+{
+  "provider": "mongodb",
+  "driver": "mongodb",
+  "connection": "mongodb://127.0.0.1:27017/app"
+}

package/registry/layers/database/mongodb/manifest.json

@@ -0,0 +1,31 @@
+{
+  "id": "mongodb",
+  "slot": "database",
+  "description": "Database profile for MongoDB-backed starters.",
+  "appliesTo": [
+    "api-service",
+    "python-api",
+    "rust-service",
+    "cloudflare-worker-ts",
+    "fullstack-ts",
+    "go-api",
+    "mcp-server-ts",
+    "dspy-pipeline-py",
+    "agent-service-ts",
+    "agent-service-py",
+    "agent-service-rust",
+    "x402-service",
+    "zk-prover-service",
+    "evm-infra-ts",
+    "python-worker"
+  ],
+  "defaults": {
+    "databaseProvider": "mongodb"
+  },
+  "files": [
+    {
+      "source": "files/database-config.json",
+      "target": "database-config.json"
+    }
+  ]
+}

package/registry/layers/database/postgres/files/database-config.json

@@ -0,0 +1,5 @@
+{
+  "provider": "postgres",
+  "driver": "postgres",
+  "connection": "postgres://app:app@127.0.0.1:5432/app"
+}

package/registry/layers/database/postgres/manifest.json

@@ -0,0 +1,31 @@
+{
+  "id": "postgres",
+  "slot": "database",
+  "description": "Database profile for PostgreSQL-backed starters.",
+  "appliesTo": [
+    "api-service",
+    "python-api",
+    "rust-service",
+    "cloudflare-worker-ts",
+    "fullstack-ts",
+    "go-api",
+    "mcp-server-ts",
+    "dspy-pipeline-py",
+    "agent-service-ts",
+    "agent-service-py",
+    "agent-service-rust",
+    "x402-service",
+    "zk-prover-service",
+    "evm-infra-ts",
+    "python-worker"
+  ],
+  "defaults": {
+    "databaseProvider": "postgres"
+  },
+  "files": [
+    {
+      "source": "files/database-config.json",
+      "target": "database-config.json"
+    }
+  ]
+}

package/registry/layers/database/sqlite/files/database-config.json

@@ -0,0 +1,5 @@
+{
+  "provider": "sqlite",
+  "driver": "better-sqlite3",
+  "connection": "file:./data/app.db"
+}

package/registry/layers/database/sqlite/manifest.json

@@ -0,0 +1,31 @@
+{
+  "id": "sqlite",
+  "slot": "database",
+  "description": "Database profile for SQLite-backed starters.",
+  "appliesTo": [
+    "api-service",
+    "python-api",
+    "rust-service",
+    "cloudflare-worker-ts",
+    "fullstack-ts",
+    "go-api",
+    "mcp-server-ts",
+    "dspy-pipeline-py",
+    "agent-service-ts",
+    "agent-service-py",
+    "agent-service-rust",
+    "x402-service",
+    "zk-prover-service",
+    "evm-infra-ts",
+    "python-worker"
+  ],
+  "defaults": {
+    "databaseProvider": "sqlite"
+  },
+  "files": [
+    {
+      "source": "files/database-config.json",
+      "target": "database-config.json"
+    }
+  ]
+}

package/registry/layers/framework/agent-service-py/files/agent.config.json

@@ -0,0 +1,9 @@
+{
+  "library": "{{agentLibrary}}",
+  "surface": "{{agentSurface}}",
+  "instructions": [
+    "Treat this starter as an agent runtime with explicit tools and memory seams.",
+    "Bias toward orchestration, retries, and safety controls."
+  ],
+  "loop": ["plan", "act", "reflect"]
+}

package/registry/layers/framework/agent-service-py/files/app.py

@@ -0,0 +1,43 @@
+import json
+from http.server import BaseHTTPRequestHandler, HTTPServer
+
+PORT = int(__import__("os").environ.get("PORT", "{{port}}"))
+
+
+def load_config():
+    try:
+        with open("agent.config.json", "r", encoding="utf-8") as handle:
+            return json.load(handle)
+    except FileNotFoundError:
+        return {
+            "library": "{{agentLibrary}}",
+            "surface": "{{agentSurface}}",
+            "loop": ["plan", "act", "reflect"],
+        }
+
+
+CONFIG = load_config()
+
+
+class AgentHandler(BaseHTTPRequestHandler):
+    def do_GET(self):
+        body = json.dumps(
+            {
+                "status": "agent",
+                "service": "{{serviceName}}",
+                "library": CONFIG["library"],
+                "surface": CONFIG["surface"],
+                "loop": CONFIG["loop"],
+            }
+        ).encode("utf-8")
+        self.send_response(200)
+        self.send_header("Content-Type", "application/json; charset=utf-8")
+        self.send_header("Content-Length", str(len(body)))
+        self.end_headers()
+        self.wfile.write(body)
+
+    def log_message(self, _format, *_args):
+        return
+
+
+HTTPServer(("0.0.0.0", PORT), AgentHandler).serve_forever()

package/registry/layers/framework/agent-service-py/manifest.json

@@ -0,0 +1,15 @@
+{
+  "id": "agent-service-py",
+  "description": "Python agent service framework layer.",
+  "appliesTo": ["agent-service-py"],
+  "files": [
+    {
+      "source": "files/app.py",
+      "target": "app.py"
+    },
+    {
+      "source": "files/agent.config.json",
+      "target": "agent.config.json"
+    }
+  ]
+}

package/registry/layers/framework/agent-service-rust/files/Cargo.toml

@@ -0,0 +1,6 @@
+[package]
+name = "{{packageName}}"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]

package/registry/layers/framework/agent-service-rust/files/agent.config.json

@@ -0,0 +1,8 @@
+{
+  "library": "{{agentLibrary}}",
+  "surface": "{{agentSurface}}",
+  "instructions": [
+    "Treat this starter as an agent runtime with strong boundaries and explicit orchestration."
+  ],
+  "loop": ["plan", "act", "reflect"]
+}

package/registry/layers/framework/agent-service-rust/files/main.rs

@@ -0,0 +1,23 @@
+use std::env;
+use std::io::{Read, Write};
+use std::net::TcpListener;
+
+fn main() {
+    let port = env::var("PORT").unwrap_or_else(|_| "{{port}}".to_string());
+    let listener = TcpListener::bind(format!("0.0.0.0:{port}")).expect("bind");
+
+    for stream in listener.incoming() {
+        let mut stream = stream.expect("stream");
+        let mut buffer = [0_u8; 1024];
+        let _ = stream.read(&mut buffer);
+        let body = format!(
+            "{{\"status\":\"agent\",\"service\":\"{{serviceName}}\",\"library\":\"{{agentLibrary}}\",\"surface\":\"{{agentSurface}}\"}}"
+        );
+        let response = format!(
+            "HTTP/1.1 200 OK\r\nContent-Type: application/json; charset=utf-8\r\nContent-Length: {}\r\nConnection: close\r\n\r\n{}",
+            body.len(),
+            body
+        );
+        stream.write_all(response.as_bytes()).expect("write response");
+    }
+}

package/registry/layers/framework/agent-service-rust/manifest.json

@@ -0,0 +1,19 @@
+{
+  "id": "agent-service-rust",
+  "description": "Rust agent service framework layer.",
+  "appliesTo": ["agent-service-rust"],
+  "files": [
+    {
+      "source": "files/Cargo.toml",
+      "target": "Cargo.toml"
+    },
+    {
+      "source": "files/main.rs",
+      "target": "src/main.rs"
+    },
+    {
+      "source": "files/agent.config.json",
+      "target": "agent.config.json"
+    }
+  ]
+}

package/registry/layers/framework/agent-service-ts/files/agent.config.json

@@ -0,0 +1,9 @@
+{
+  "library": "{{agentLibrary}}",
+  "surface": "{{agentSurface}}",
+  "instructions": [
+    "Treat this starter as an agent control plane, not a plain CRUD service.",
+    "Bias toward tool registration, memory seams, and explicit execution boundaries."
+  ],
+  "loop": ["plan", "act", "reflect"]
+}

package/registry/layers/framework/agent-service-ts/files/agent.mjs

@@ -0,0 +1,39 @@
+import fs from "node:fs/promises";
+import http from "node:http";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const port = Number.parseInt(process.env.PORT || "{{port}}", 10);
+
+async function loadJson(name, fallback = null) {
+  try {
+    const raw = await fs.readFile(path.join(__dirname, name), "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return fallback;
+  }
+}
+
+const config = await loadJson("agent.config.json", {
+  library: "{{agentLibrary}}",
+  surface: "{{agentSurface}}",
+  loop: ["plan", "act", "reflect"],
+});
+
+const server = http.createServer((_request, response) => {
+  response.writeHead(200, { "content-type": "application/json; charset=utf-8" });
+  response.end(
+    JSON.stringify({
+      status: "agent",
+      service: "{{serviceName}}",
+      library: config.library,
+      surface: config.surface,
+      loop: config.loop,
+    }),
+  );
+});
+
+server.listen(port, "0.0.0.0", () => {
+  console.log(`agent service listening on ${port}`);
+});

package/registry/layers/framework/agent-service-ts/manifest.json

@@ -0,0 +1,15 @@
+{
+  "id": "agent-service-ts",
+  "description": "Node-based TypeScript-style agent service framework layer.",
+  "appliesTo": ["agent-service-ts"],
+  "files": [
+    {
+      "source": "files/agent.mjs",
+      "target": "agent.mjs"
+    },
+    {
+      "source": "files/agent.config.json",
+      "target": "agent.config.json"
+    }
+  ]
+}

package/registry/layers/framework/angular-ts/files/app.component.ts

@@ -0,0 +1,10 @@
+import { Component } from "@angular/core";
+
+@Component({
+  selector: "app-root",
+  standalone: true,
+  template: `<main><h1>{{headline}}</h1><p>{{subheadline}}</p></main>`,
+})
+export class AppComponent {
+  title = "{{headline}}";
+}

package/registry/layers/framework/angular-ts/files/main.ts

@@ -0,0 +1,4 @@
+import { bootstrapApplication } from "@angular/platform-browser";
+import { AppComponent } from "./app/app.component";
+
+bootstrapApplication(AppComponent).catch((err) => console.error(err));