@tangle-network/starter-foundry 0.7.2 → 0.13.0

package/registry/layers/agent-tools/clinical-screeners/manifest.json

@@ -0,0 +1,61 @@
+{
+  "id": "clinical-screeners",
+  "slot": "agent-tools",
+  "description": "Validated clinical screeners (PHQ-9, GAD-7, AUDIT-C) for therapy / coaching / mental-health bundles. Includes mandatory escalation-to-real-clinician disclaimer and crisis-language detection. NEVER treat agent output as clinical advice; always pair with the escalation contract.",
+  "appliesTo": [
+    "agent-runtime-research",
+    "agent-runtime-therapist-ts"
+  ],
+  "provides": [
+    "screener:phq9",
+    "screener:gad7",
+    "screener:audit-c",
+    "safety:crisis-escalation"
+  ],
+  "requires": [
+    "tangle:base"
+  ],
+  "defaults": {
+    "clinicalScreeners": true,
+    "screeners": [
+      "phq-9",
+      "gad-7",
+      "audit-c"
+    ],
+    "escalationRequired": true
+  },
+  "files": [
+    {
+      "source": "files/lib/tools/screeners.ts",
+      "target": "src/lib/tools/screeners.ts"
+    },
+    {
+      "source": "files/templates/screener-phq9.md",
+      "target": "templates/screener-phq9.md"
+    },
+    {
+      "source": "files/templates/screener-gad7.md",
+      "target": "templates/screener-gad7.md"
+    },
+    {
+      "source": "files/templates/escalation-protocol.md",
+      "target": "templates/escalation-protocol.md"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "src/lib/tools/screeners.ts"
+    },
+    {
+      "type": "file-exists",
+      "path": "templates/escalation-protocol.md"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "templates/screener-*.md",
+      "src/lib/tools/screeners.ts"
+    ]
+  }
+}

package/registry/layers/agent-tools/phony-voice/files/lib/tools/voice.ts

@@ -0,0 +1,38 @@
+// Voice toolkit — STT / TTS / voice-cloning / voice RAG via @ph0ny/sdk.
+// Only the public @ph0ny/sdk package is used; internal phony packages
+// (@ph0ny/voice, @ph0ny/agents, @ph0ny/voice-widget) are NOT permitted
+// in shipping bundles.
+
+export interface SpeakOptions {
+  text: string
+  voiceId: string
+  format?: 'mp3' | 'wav' | 'pcm16'
+}
+
+export interface TranscribeOptions {
+  audio: Blob | ArrayBuffer | string
+  language?: string
+}
+
+export async function speak(_opts: SpeakOptions): Promise<ArrayBuffer> {
+  // Implementation imports @ph0ny/sdk at runtime: const { Phony } = await import('@ph0ny/sdk')
+  // const phony = new Phony({ apiKey: process.env.PHONY_API_KEY })
+  // return await phony.tts.synthesize(opts)
+  throw new Error('speak: wire @ph0ny/sdk.tts.synthesize() here')
+}
+
+export async function transcribe(_opts: TranscribeOptions): Promise<{ text: string; language: string }> {
+  throw new Error('transcribe: wire @ph0ny/sdk.stt.transcribe() here')
+}
+
+export interface CloneVoiceOptions {
+  name: string
+  samples: Array<Blob | ArrayBuffer>
+  consentToken: string
+}
+
+export async function cloneVoice(_opts: CloneVoiceOptions): Promise<{ voiceId: string }> {
+  // Voice cloning REQUIRES explicit consent — the consentToken must come
+  // from a verified-consent flow upstream. Bundles never clone without it.
+  throw new Error('cloneVoice: wire @ph0ny/sdk.voiceCloning.create() here, gated on consentToken')
+}

package/registry/layers/agent-tools/phony-voice/manifest.json

@@ -0,0 +1,47 @@
+{
+  "id": "phony-voice",
+  "slot": "agent-tools",
+  "description": "Voice toolkit for agent-runtime bundles. Wraps @ph0ny/sdk (the only public phony package) for STT, TTS, voice-cloning, and voice RAG. Stack on therapist, music-producer, friend, language-tutor, voice-orchestrator bundles. Internal phony packages are NOT included.",
+  "appliesTo": [
+    "agent-runtime-chef-ts",
+    "agent-runtime-fitness-coach-ts",
+    "agent-runtime-friend-ts",
+    "agent-runtime-language-tutor-ts",
+    "agent-runtime-mediator-ts",
+    "agent-runtime-meditation-coach-ts",
+    "agent-runtime-music-producer-ts",
+    "agent-runtime-relationship-coach-ts",
+    "agent-runtime-research",
+    "agent-runtime-therapist-ts",
+    "multi-agent-creative-studio-ts"
+  ],
+  "provides": [
+    "voice:stt",
+    "voice:tts",
+    "voice:cloning"
+  ],
+  "requires": [
+    "tangle:base"
+  ],
+  "defaults": {
+    "phonyVoice": true,
+    "phonyVoiceSdk": "@ph0ny/sdk"
+  },
+  "files": [
+    {
+      "source": "files/lib/tools/voice.ts",
+      "target": "src/lib/tools/voice.ts"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "src/lib/tools/voice.ts"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "src/lib/tools/voice.ts"
+    ]
+  }
+}

package/registry/layers/agent-tools/research-corpus/files/lib/tools/research.ts

@@ -0,0 +1,46 @@
+// Research-corpus tool kit. Wraps four citation sources with a uniform
+// {title, authors, year, venue, abstract, doi, url} shape so the agent
+// can do axis-by-axis lit-survey work without provider-specific code in
+// the system prompt.
+
+export interface Paper {
+  title: string
+  authors: string[]
+  year: number
+  venue?: string
+  abstract?: string
+  doi?: string
+  url: string
+  citationCount?: number
+  source: 'arxiv' | 'semantic-scholar' | 'openalex' | 'crossref'
+}
+
+export interface SearchOptions {
+  query: string
+  yearFrom?: number
+  yearTo?: number
+  limit?: number
+  providers?: Array<'arxiv' | 'semantic-scholar' | 'openalex' | 'crossref'>
+}
+
+export async function searchPapers(_opts: SearchOptions): Promise<Paper[]> {
+  // Implementation fans out to each enabled provider, dedupes by DOI,
+  // ranks by citation count + year recency, returns top `limit`.
+  // Each provider call goes through the bundle's sandbox so rate-limit
+  // + retry policy is uniform.
+  throw new Error('searchPapers: wire arxiv/s2/openalex/crossref clients here, dedupe by DOI')
+}
+
+export async function getCitationGraph(_doi: string, _depth = 1): Promise<{
+  paper: Paper
+  citedBy: Paper[]
+  cites: Paper[]
+}> {
+  throw new Error('getCitationGraph: walk Semantic Scholar citation graph to depth `_depth`')
+}
+
+export async function summarizePaper(_paper: Paper, _maxTokens = 200): Promise<string> {
+  // Summary goes through router.tangle.tools (see lib/tangle.ts);
+  // never call a non-router LLM endpoint from a bundle.
+  throw new Error('summarizePaper: chatViaRouter() with a summarization prompt')
+}

package/registry/layers/agent-tools/research-corpus/manifest.json

@@ -0,0 +1,52 @@
+{
+  "id": "research-corpus",
+  "slot": "agent-tools",
+  "description": "Research-corpus tool kit: arxiv / Semantic Scholar / OpenAlex / Crossref clients via @tangle-network/sandbox shell-out + a citation-graph walker. Stack on agent-runtime-research-* bundles and any analyst role that needs paper-search.",
+  "appliesTo": [
+    "agent-runtime-business-partner-ts",
+    "agent-runtime-chemistry-research-ts",
+    "agent-runtime-cs-research-ts",
+    "agent-runtime-math-research-ts",
+    "agent-runtime-ml-research-ts",
+    "agent-runtime-physics-research-ts",
+    "agent-runtime-research",
+    "multi-agent-research-lab-ts"
+  ],
+  "provides": [
+    "corpus:arxiv",
+    "corpus:semantic-scholar",
+    "corpus:openalex",
+    "corpus:crossref",
+    "research:paper-search",
+    "research:citation-graph"
+  ],
+  "requires": [
+    "tangle:base"
+  ],
+  "defaults": {
+    "researchCorpus": true,
+    "corpusProviders": [
+      "arxiv",
+      "semantic-scholar",
+      "openalex",
+      "crossref"
+    ]
+  },
+  "files": [
+    {
+      "source": "files/lib/tools/research.ts",
+      "target": "src/lib/tools/research.ts"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "src/lib/tools/research.ts"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "src/lib/tools/research.ts"
+    ]
+  }
+}

package/registry/layers/capability/agent-eval/manifest.json

@@ -14,7 +14,7 @@
   },
   "packageDeps": {
     "dependencies": {
-      "@tangle-network/agent-eval": "^0.7.0"
+      "@tangle-network/agent-eval": "^0.23.0"
     }
   },
   "files": [
@@ -67,6 +67,7 @@
     "measurable agent"
   ],
   "tieredKeywords": {
+    "archetypes": ["scoring pipeline", "llm as judge"],
     "tier1": ["agent eval", "eval harness", "quality gate"],
     "tier2": ["llm judge", "scoring pipeline", "benchmark agent", "eval integrated"]
   }

package/registry/layers/capability/ai-chat-ui/manifest.json

@@ -129,6 +129,8 @@
       "ai chat",
       "ai email",
       "ai search",
+      "ai responses",
+      "streaming ai responses",
       "ai-powered",
       "ai-driven",
       "generative ai",

package/registry/layers/capability/bridge-protocol-api/files/bridge-protocol-config.json

@@ -0,0 +1,5 @@
+{
+  "role": "{{bridgeApiRole}}",
+  "statusPath": "{{bridgeStatusPath}}",
+  "stateModel": ["source_confirmed", "relayed", "destination_confirmed", "failed"]
+}

package/registry/layers/capability/bridge-protocol-api/files/bridge-status-routes.ts

@@ -0,0 +1,31 @@
+export type BridgeMessageState =
+  | 'source_confirmed'
+  | 'relayed'
+  | 'destination_confirmed'
+  | 'failed'
+
+export interface BridgeMessageStatus {
+  id: string
+  sourceChainId: number
+  destinationChainId: number
+  state: BridgeMessageState
+  updatedAt: string
+  relayAttempts: number
+}
+
+export function summarizeBridgeStatus(
+  statuses: BridgeMessageStatus[],
+): Record<BridgeMessageState, number> {
+  return statuses.reduce<Record<BridgeMessageState, number>>(
+    (counts, status) => {
+      counts[status.state] += 1
+      return counts
+    },
+    {
+      source_confirmed: 0,
+      relayed: 0,
+      destination_confirmed: 0,
+      failed: 0,
+    },
+  )
+}

package/registry/layers/capability/bridge-protocol-api/manifest.json

@@ -0,0 +1,92 @@
+{
+  "id": "bridge-protocol-api",
+  "description": "Bridge backend surface for cross-chain message indexing, relayer status, and deposit or withdrawal tracking APIs.",
+  "domainPack": {
+    "domain": {
+      "family": "bridge",
+      "surface": "indexer"
+    },
+    "provides": ["bridge-indexer", "bridge-status-api", "cross-chain-relayer"],
+    "ambiguityGroup": "bridge-indexer",
+    "authenticitySignals": [
+      "bridge source confirmed",
+      "bridge destination confirmed",
+      "bridge relayer status",
+      "bridge retry queue",
+      "bridge failed states",
+      "bridge message status",
+      "message status",
+      "bridge deposit",
+      "bridge withdrawal"
+    ],
+    "routingPrompts": [
+      {
+        "prompt": "Build a bridge transaction monitor API that indexes source confirmed, relayed, destination confirmed, and failed states",
+        "expectedFamily": "evm-infra-ts",
+        "expectedLayers": ["framework:evm-infra-ts", "capability:bridge-protocol-api"]
+      },
+      {
+        "prompt": "Build a cross-chain relayer status API with retry queue and destination confirmed tracking",
+        "expectedFamily": "evm-infra-ts",
+        "expectedLayers": ["framework:evm-infra-ts", "capability:bridge-protocol-api"]
+      },
+      {
+        "prompt": "Build a bridge deposit and withdrawal indexer that exposes message status by sender and chain pair",
+        "expectedFamily": "evm-infra-ts",
+        "expectedLayers": ["framework:evm-infra-ts", "capability:bridge-protocol-api"]
+      }
+    ]
+  },
+  "appliesTo": ["evm-infra-ts", "api-service"],
+  "provides": ["bridge-protocol-api"],
+  "defaults": {
+    "bridgeApiRole": "indexer",
+    "bridgeStatusPath": "/bridge/status"
+  },
+  "files": [
+    {
+      "source": "files/bridge-protocol-config.json",
+      "target": "bridge-protocol-config.json"
+    },
+    {
+      "source": "files/bridge-status-routes.ts",
+      "target": "bridge-status-routes.ts"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "bridge-protocol-config.json",
+      "bridge-status-routes.ts"
+    ]
+  },
+  "keywords": [
+    "bridge indexer",
+    "bridge monitor",
+    "bridge transaction monitor",
+    "bridge message status",
+    "bridge deposit",
+    "bridge withdrawal",
+    "deposit and withdrawal indexer",
+    "withdrawal indexer",
+    "bridge script",
+    "bridge status api",
+    "bridge relayer",
+    "cross-chain relayer",
+    "message indexer",
+    "bridge relayer status",
+    "bridge source confirmed",
+    "bridge destination confirmed",
+    "bridge failed states",
+    "bridge retry queue"
+  ],
+  "buildHints": {
+    "apiRoutes": ["/bridge/status", "/bridge/messages/:id"],
+    "dataModels": ["BridgeMessage", "BridgeTransfer", "RelayAttempt"],
+    "integrations": ["Source-chain RPC", "Destination-chain RPC", "Bridge protocol event logs"],
+    "architectureNotes": [
+      "Track bridge messages as state machines: source confirmed, relayed, destination confirmed, failed.",
+      "Persist relay attempts separately from transfer records so retries do not overwrite the original message.",
+      "Expose status by message id and by sender address; keep execution writes behind explicit relayer code."
+    ]
+  }
+}

package/registry/layers/capability/crypto-bridge-ui/manifest.json

@@ -2,13 +2,65 @@
   "id": "crypto-bridge-ui",
   "description": "Cross-chain bridge interface with chain selection, fee estimation, and transaction history.",
   "group": "capability",
-  "appliesTo": ["nextjs-ts", "react-vite-ts", "fullstack-ts"],
-  "keywords": ["bridge", "cross-chain", "transfer", "multichain", "layerzero", "wormhole", "chain transfer"],
+  "domainPack": {
+    "domain": {
+      "family": "bridge",
+      "surface": "ui"
+    },
+    "provides": ["bridge-ui", "bridge-history", "chain-selector"],
+    "requires": ["wallet-ui"],
+    "ambiguityGroup": "bridge-ui",
+    "authenticitySignals": [
+      "source chain",
+      "destination chain",
+      "fee estimation",
+      "bridge transaction history",
+      "bridge interface",
+      "transfer status"
+    ],
+    "routingPrompts": [
+      {
+        "prompt": "Build a cross-chain bridge transfer UI with Wormhole",
+        "expectedFamily": "react-vite-ts",
+        "expectedLayers": ["framework:react-vite-ts", "capability:crypto-bridge-ui"]
+      },
+      {
+        "prompt": "Build a multichain bridge dashboard with source chain, destination chain, fee estimate, and transaction history",
+        "expectedFamily": "react-vite-ts",
+        "expectedLayers": ["framework:react-vite-ts", "capability:crypto-bridge-ui"]
+      },
+      {
+        "prompt": "Build a USDe bridge interface from Ethereum to Arbitrum, Optimism, and Base with LayerZero transfer status",
+        "expectedFamily": "react-vite-ts",
+        "expectedLayers": ["framework:react-vite-ts", "capability:crypto-bridge-ui"]
+      }
+    ]
+  },
+  "appliesTo": ["react-vite-ts", "nextjs-ts", "fullstack-ts"],
+  "keywords": [
+    "bridge ui",
+    "bridge interface",
+    "bridge dashboard",
+    "cross-chain bridge",
+    "bridge transfer",
+    "bridge transfer status",
+    "multichain bridge",
+    "layerzero",
+    "wormhole",
+    "cross-chain transfer",
+    "transfer status"
+  ],
   "capabilityRequires": ["shadcn"],
   "files": [
     { "source": "files/bridge-card.tsx", "target": "src/components/crypto/bridge-card.tsx" },
     { "source": "files/bridge-history.tsx", "target": "src/components/crypto/bridge-history.tsx" }
   ],
+  "contextHints": {
+    "extensionPoints": [
+      "src/components/crypto/bridge-card.tsx",
+      "src/components/crypto/bridge-history.tsx"
+    ]
+  },
   "buildHints": {
     "pages": ["/bridge", "/bridge/history"],
     "apiRoutes": ["/api/bridge/quote", "/api/bridge/status"],

package/registry/layers/capability/defi-bridge/manifest.json

@@ -1,6 +1,18 @@
 {
   "id": "defi-bridge",
   "description": "Adds cross-chain bridge and messaging patterns with lock/mint, burn/release, and proof verification.",
+  "domainPack": {
+    "domain": {
+      "family": "bridge",
+      "protocol": "custom",
+      "runtime": "evm",
+      "surface": "contracts"
+    },
+    "provides": ["bridge-patterns", "cross-chain-messaging", "lock-mint"],
+    "requires": ["solidity-contracts"],
+    "ambiguityGroup": "bridge-contracts",
+    "authenticitySignals": ["cross-chain bridge", "lock and mint", "burn and release", "proof verification"]
+  },
   "appliesTo": [
     "forge-contracts",
     "hardhat-contracts",

package/registry/layers/capability/evm-layerzero-oft/manifest.json

@@ -1,9 +1,68 @@
 {
   "id": "evm-layerzero-oft",
   "description": "Specializes a Foundry contract lane for omnichain token and bridge flows.",
+  "domainPack": {
+    "domain": {
+      "family": "bridge",
+      "provider": "layerzero",
+      "protocol": "oft",
+      "runtime": "foundry",
+      "surface": "contracts"
+    },
+    "provides": ["bridge-contracts", "layerzero-oft", "omnichain-token", "forge-build"],
+    "requires": ["solidity-contracts"],
+    "ambiguityGroup": "bridge-contracts",
+    "validationCommands": ["forge build", "forge test"],
+    "authenticitySignals": ["LayerZero", "OFT", "sendTokens", "omnichain", "bridge"],
+    "authenticityGroups": [
+      {
+        "id": "layerzero-sdk",
+        "description": "At least one LayerZero package, endpoint, or OApp import signal should survive generation.",
+        "minRequired": 1,
+        "signals": [
+          "@layerzerolabs/lz-evm-oapp-v2",
+          "@layerzerolabs/lz-evm-protocol-v2",
+          "@layerzerolabs/oapp-evm",
+          "EndpointV2"
+        ]
+      },
+      {
+        "id": "oft-contract",
+        "description": "Generated contracts should use OFT/OApp wiring, not generic ERC20 bridge placeholders.",
+        "minRequired": 2,
+        "signals": ["OFT", "OApp", "setPeer", "quoteSend", "send", "sendTokens"]
+      },
+      {
+        "id": "bridge-deploy-config",
+        "description": "The project should carry deploy/config evidence for cross-chain peers and execution settings.",
+        "minRequired": 1,
+        "signals": ["SendTokens.s.sol", "bridge-config.json", "trusted remotes", "enforced options", "DVN", "executor"]
+      }
+    ],
+    "routingPrompts": [
+      {
+        "prompt": "Build a LayerZero OFT bridge token with Foundry",
+        "expectedFamily": "forge-contracts",
+        "expectedLayers": ["framework:forge-foundation", "capability:evm-layerzero-oft"]
+      },
+      {
+        "prompt": "Build an omnichain ERC20 contract using LayerZero OFT with forge deploy scripts",
+        "expectedFamily": "forge-contracts",
+        "expectedLayers": ["framework:forge-foundation", "capability:evm-layerzero-oft"]
+      },
+      {
+        "prompt": "Build a cross-chain token bridge contract with sendTokens, trusted remotes, and LayerZero endpoint config",
+        "expectedFamily": "forge-contracts",
+        "expectedLayers": ["framework:forge-foundation", "capability:evm-layerzero-oft"]
+      }
+    ]
+  },
   "appliesTo": [
     "forge-contracts"
   ],
+  "defaults": {
+    "contractName": "OmnichainToken"
+  },
   "files": [
     {
       "source": "files/OmnichainToken.sol",

package/registry/layers/capability/evm-nft-mint-page/manifest.json

@@ -56,6 +56,7 @@
     "tier1": [
       "EVM",
       "NFT",
+      "mint",
       "minting",
       "wallet",
       "OpenSea"

package/registry/layers/capability/evm-uniswap-v4-hook/manifest.json

@@ -0,0 +1,58 @@
+{
+  "id": "evm-uniswap-v4-hook",
+  "description": "Adds Uniswap V4 hook contract routing and agent guidance for BaseHook lifecycle callbacks.",
+  "domainPack": {
+    "domain": {
+      "family": "dex-hook",
+      "protocol": "uniswap-v4",
+      "runtime": "evm",
+      "surface": "contracts"
+    },
+    "provides": ["uniswap-v4-hook", "hook-callbacks", "poolmanager-integration"],
+    "requires": ["solidity-contracts"],
+    "ambiguityGroup": "dex-hook-contracts",
+    "validationCommands": ["forge build", "forge test"],
+    "authenticitySignals": [
+      "BaseHook",
+      "beforeSwap",
+      "afterSwap",
+      "beforeAddLiquidity",
+      "afterAddLiquidity",
+      "PoolManager",
+      "HookFlags",
+      "sqrtPriceX96",
+      "tickSpacing"
+    ],
+    "routingPrompts": [
+      {
+        "prompt": "Build a Uniswap V4 hook contract extending BaseHook with beforeSwap logic",
+        "expectedFamily": "forge-contracts",
+        "expectedLayers": ["framework:forge-foundation", "capability:evm-uniswap-v4-hook"]
+      }
+    ]
+  },
+  "appliesTo": ["forge-contracts", "hardhat-contracts"],
+  "contextHints": {
+    "extensionPoints": ["src/{{contractName}}.sol", "test/"]
+  },
+  "keywords": [
+    "uniswap v4",
+    "uni v4",
+    "v4 hook",
+    "hook contract",
+    "basehook",
+    "beforeswap",
+    "afterswap",
+    "beforeinitialize",
+    "afterinitialize",
+    "beforeaddliquidity",
+    "afteraddliquidity",
+    "poolmanager",
+    "hookflags",
+    "sqrtpricex96",
+    "tickspacing",
+    "tick accumulator",
+    "erc-6909",
+    "erc6909"
+  ]
+}