@tangle-network/starter-foundry 0.7.2 → 0.13.0

package/registry/families/agent-runtime-pharmacist-ts/files/methodology/adverse-effect-monitoring.md

@@ -0,0 +1,155 @@
+# Adverse Effect Monitoring Template
+
+## Purpose
+Provide a structured profile of expected adverse effects, monitoring
+parameters, and patient-education points for a specific medication.
+Advisory only — never replaces a prescribing clinician's judgment
+for a real patient. Drug-specific dosing, interactions, and
+monitoring belong with the patient's pharmacist, prescriber, and
+care team.
+
+## When to use
+Trigger when the user asks about side effects of a medication, what
+to watch for, or what monitoring labs are appropriate. For
+interaction screening with another drug, route to
+drug-interaction-check.md. For dose questions, route to
+dosing-guidance.md.
+
+## Method
+
+1. **Identify the drug precisely.**
+   - Generic name (preferred for unambiguity).
+   - Brand name (for the user's own context).
+   - Strength, formulation (IR / ER / SR / depot, oral / IM /
+     IV / topical / inhaled).
+   - Indication (the *same* drug at the *same* dose can have
+     different monitoring needs depending on indication).
+2. **Pull from authoritative sources.**
+   - FDA prescribing information (drugs@FDA, DailyMed) — the
+     primary regulatory source in the US.
+   - Lexicomp / Micromedex / UpToDate — clinical references.
+   - DrugBank / RxList for general consumer-level info.
+   - Clinical guidelines (society / consortium): ATS for
+     pulmonary, ACC/AHA for cardio, IDSA for infectious
+     disease, etc.
+3. **Stratify adverse effects by frequency and severity.**
+
+   | Frequency tier | Definition |
+   |----------------|------------|
+   | Very common | ≥10% of patients |
+   | Common      | 1–10% |
+   | Uncommon    | 0.1–1% |
+   | Rare        | 0.01–0.1% |
+   | Very rare   | <0.01% |
+
+   Tag each effect with severity:
+   - **Mild / nuisance** (manage symptomatically; rarely
+     discontinuation).
+   - **Moderate** (may require dose adjustment or
+     symptom-directed therapy).
+   - **Severe / serious** (warrants discontinuation,
+     dose-reduction, or emergent care).
+   - **Black-box / boxed warning** (FDA-level red flag).
+
+4. **Map monitoring parameters.**
+   - **Baseline**: labs / vitals before initiation. Examples:
+     LFTs before statins, K+/Mg+ before QT-prolonging drugs,
+     pregnancy test before isotretinoin, eGFR before NSAIDs.
+   - **Periodic**: ongoing monitoring at defined intervals.
+   - **Threshold for action**: at what value does the team act?
+     "ALT >3× ULN with symptoms → discontinue and refer."
+   - **Symptom monitoring**: subjective signs the patient
+     should report.
+5. **Identify high-risk interactions** that *increase* AE risk
+   rather than affect efficacy:
+   - Drugs that prolong QT in combination.
+   - CYP inhibitors that elevate the drug's plasma level.
+   - Cumulative serotonergic or anticholinergic burden.
+   - Same-class additive effects (multiple antihypertensives,
+     multiple anticoagulants, multiple sedatives).
+6. **Patient-education delivery.**
+   - **What to expect** (mild / common things — set
+     expectations to reduce non-adherence over benign symptoms).
+   - **What to report** (moderate concerns to flag at the
+     next visit / pharmacist call).
+   - **When to seek emergency care** (severe / immediate
+     concerns — chest pain, difficulty breathing, swelling of
+     face / tongue, severe rash, suicidal ideation when on
+     antidepressants).
+   - Education in language the patient will use, not in
+     pharmacology jargon.
+7. **Special-population callouts** as relevant:
+   - Pregnancy / lactation (Lactmed for breastfeeding).
+   - Pediatric / geriatric.
+   - Renal / hepatic impairment.
+   - Substance-use history (esp. opioids, benzos, stimulants).
+
+## Output
+
+```
+:::artifact
+template: adverse-effect-monitoring
+drug:
+  generic: "..."
+  brand: "..."
+  formulation: "..."
+  indication: "..."
+common-adverse-effects:
+  - { effect: "...", frequency: "common (5%)", severity: "mild", management: "...", typical-onset: "first 1–2 weeks" }
+serious-adverse-effects:
+  - { effect: "...", frequency: "rare (<0.1%)", severity: "severe", risk-factors: ["..."], action-threshold: "..." }
+black-box-warning: "..." | null
+monitoring:
+  baseline: ["LFTs", "lipid panel", "..."]
+  periodic: [{ test: "...", interval: "every 3 months" }]
+  thresholds:
+    - { parameter: "ALT", action: "..." }
+high-risk-interactions:
+  - "QT-prolonging combinations: ..."
+  - "CYP3A4 inhibitors: ..."
+patient-education:
+  expect: "..."
+  report: "..."
+  emergency: "..."
+references:
+  - "FDA label, accessed YYYY-MM-DD"
+  - "Lexicomp, accessed YYYY-MM-DD"
+:::
+```
+
+## Common monitoring failures
+
+1. **Generic frequency labeling.** "Common" without the % range
+   undersells the risk; pull the % from the label.
+2. **Skipping baseline labs.** Many AE profiles depend on
+   pre-treatment status (LFTs, K+, eGFR). Baseline missed =
+   no anchor for periodic comparison.
+3. **Ignoring cumulative class burden.** Two anticholinergics
+   together is more than additive; same with serotonergic
+   load.
+4. **Treating the patient as the prescribing clinician.** The
+   user is not the prescriber; recommend they raise concerns
+   with the actual prescriber rather than acting alone.
+5. **Outdated FDA info.** AE profiles update; always include
+   pull date.
+
+## Refusal triggers
+
+The agent will:
+- **Refuse** to recommend a real patient stop, hold, or alter a
+  medication; that is the prescriber's call. Surface what to
+  ask the prescriber.
+- **Refuse** to interpret labs in a way that constitutes
+  diagnosis or dosing decision.
+- **Escalate** any user description of:
+  - Severe rash with mucous-membrane involvement (Stevens-
+    Johnson / TEN risk).
+  - Anaphylaxis signs (face/tongue swelling, breathing
+    difficulty).
+  - Suicidality on antidepressant or any med with this risk.
+  - Liver-injury signs (jaundice, severe abdominal pain, dark
+    urine).
+  - Severe bleeding on anticoagulant.
+  - Chest pain on stimulant or stimulant-like agent.
+  → call 911 / poison control (US: 1-800-222-1222) /
+  prescriber immediately.

package/registry/families/agent-runtime-pharmacist-ts/files/methodology/dosing-guidance.md

@@ -0,0 +1,41 @@
+# Dosing Guidance Template
+
+## Drug
+
+## Indication
+
+## Adult Dosing
+- Standard dose
+- Titration if applicable
+- Maximum dose
+
+## Renal Impairment Adjustment
+- CrCl > 60 mL/min: no adjustment
+- CrCl 30-60: adjust
+- CrCl < 30: adjust
+- Dialysis: supplement?
+
+## Hepatic Impairment Adjustment
+- Child-Pugh A, B, C adjustments
+
+## Pediatric Dosing
+- Weight-based (mg/kg)
+- Age-based if applicable
+
+## Geriatric Considerations
+- Start low, go slow
+- Renal function adjustment
+
+## Pregnancy & Lactation
+- FDA pregnancy category (if still used)
+- Lactation risk category
+
+## Administration
+- With/without food
+- Timing
+- Special instructions (e.g., avoid grapefruit)
+
+## References
+- FDA label
+- Lexicomp / UpToDate
+- PubMed

package/registry/families/agent-runtime-pharmacist-ts/files/methodology/drug-information.md

@@ -0,0 +1,47 @@
+# Drug Information Template
+
+## Drug Name (Generic & Brand)
+
+## Classification
+- Therapeutic class
+- Pharmacologic class
+- Mechanism of action
+
+## Indications
+- FDA-approved indications
+- Common off-label uses (with evidence level)
+
+## Dosage Forms & Strengths
+- List available formulations
+
+## Pharmacokinetics
+- Absorption
+- Distribution
+- Metabolism (CYP450 enzymes)
+- Elimination half-life
+- Excretion
+
+## Contraindications
+
+## Warnings & Precautions
+- Boxed warnings if any
+- Black box warnings
+
+## Adverse Effects
+- Common (>10%)
+- Less common (1-10%)
+- Serious but rare
+
+## Drug Interactions
+- Major (contraindicated)
+- Moderate (monitor/adjust dose)
+- Minor
+
+## Monitoring Parameters
+
+## Patient Counseling Points
+
+## References
+- FDA label
+- DrugBank
+- PubMed citations

package/registry/families/agent-runtime-pharmacist-ts/files/methodology/drug-interaction-check.md

@@ -0,0 +1,35 @@
+# Drug Interaction Check Template
+
+## Drugs Involved
+- Drug A
+- Drug B (and C, D, etc.)
+
+## Interaction Severity
+- [ ] Contraindicated
+- [ ] Major
+- [ ] Moderate
+- [ ] Minor
+
+## Mechanism
+- Pharmacodynamic
+- Pharmacokinetic (CYP, transporter, etc.)
+
+## Clinical Effect
+- Description of expected outcome
+
+## Management
+- Avoid combination
+- Adjust dose
+- Monitor specific parameters
+- Alternative agent
+
+## Evidence Level
+- [ ] Excellent (RCT, meta-analysis)
+- [ ] Good (observational, case series)
+- [ ] Fair (case reports, theoretical)
+- [ ] Poor (no data)
+
+## References
+- DrugBank interaction record
+- PubMed citations
+- FDA labeling

package/registry/families/agent-runtime-pharmacist-ts/files/methodology/index.json

@@ -0,0 +1,32 @@
+{
+  "entries": [
+    {
+      "id": "drug-information",
+      "capability": "drug-information",
+      "path": "./drug-information.md",
+      "tags": ["drug", "monograph", "pharmacology"],
+      "version": "0.1.0"
+    },
+    {
+      "id": "drug-interaction-check",
+      "capability": "drug-interaction-check",
+      "path": "./drug-interaction-check.md",
+      "tags": ["interaction", "ddi", "safety"],
+      "version": "0.1.0"
+    },
+    {
+      "id": "dosing-guidance",
+      "capability": "dosing-guidance",
+      "path": "./dosing-guidance.md",
+      "tags": ["dosing", "pharmacokinetics", "renal-adjustment"],
+      "version": "0.1.0"
+    },
+    {
+      "id": "adverse-effect-monitoring",
+      "capability": "adverse-effect-monitoring",
+      "path": "./adverse-effect-monitoring.md",
+      "tags": ["adverse-effects", "monitoring", "safety"],
+      "version": "0.1.0"
+    }
+  ]
+}

package/registry/families/agent-runtime-pharmacist-ts/manifest.json

@@ -0,0 +1,156 @@
+{
+  "id": "agent-runtime-pharmacist-ts",
+  "description": "Pharmacist reference agent bundle \u2014 drug information, interaction checks, and medication therapy management. NOT a substitute for a licensed pharmacist, physician, or other healthcare professional. Advisory only. Emits non-licensed/non-fiduciary language and includes escalation blocks. Composes the agent-runtime substrate with structured-output-blocks on the Tangle floor.",
+  "tags": [
+    "agent-runtime",
+    "pharmacist",
+    "drug-reference",
+    "medication-therapy-management",
+    "advisory",
+    "cloudflare-worker"
+  ],
+  "taxonomy": {
+    "language": "markdown",
+    "runtime": "cloudflare-worker",
+    "surface": "agent-runtime"
+  },
+  "includes": [
+    "agent-base:tangle",
+    "agent-base:secure",
+    "agent-output:blocks",
+    "agent-base:memory",
+    "agent-base:scheduler",
+    "agent-base:mcp-registry",
+    "agent-channels:telegram",
+    "agent-channels:discord",
+    "agent-channels:slack",
+    "agent-channels:whatsapp",
+    "agent-channels:imessage",
+    "agent-channels:gmail",
+    "agent-channels:linear"
+  ],
+  "defaults": {
+    "projectType": "agent-runtime-pharmacist",
+    "agentName": "pharmacist",
+    "publicVars": [
+      "AGENT_NAME"
+    ],
+    "routes": [
+      {
+        "path": "/api/chat",
+        "auth": "bearer",
+        "callsTools": [
+          "drug:lookup",
+          "drug:interaction-check",
+          "drug:dosing-calc",
+          "drug:adverse-effects"
+        ]
+      },
+      {
+        "path": "/api/health",
+        "auth": "none",
+        "callsTools": []
+      }
+    ],
+    "declaredCapabilities": [
+      "drug-information",
+      "drug-interaction-check",
+      "dosing-guidance",
+      "adverse-effect-monitoring"
+    ],
+    "runtime": {
+      "sandbox": "tangle",
+      "noNewPrivileges": true,
+      "capDrop": "ALL"
+    },
+    "stakes": "high",
+    "advisoryOnly": true,
+    "outboundDomains": [
+      "api.tangle.tools",
+      "api.drugbank.ca",
+      "api.fda.gov",
+      "pubmed.ncbi.nlm.nih.gov"
+    ],
+    "secrets": [
+      "TANGLE_API_KEY",
+      "DRUGBANK_API_KEY"
+    ]
+  },
+  "files": [
+    {
+      "source": "files/agent.json",
+      "target": "agent.json"
+    },
+    {
+      "source": "files/AGENTS.md",
+      "target": "AGENTS.md"
+    },
+    {
+      "source": "files/methodology/index.json",
+      "target": "methodology/index.json"
+    },
+    {
+      "source": "files/methodology/drug-information.md",
+      "target": "methodology/drug-information.md"
+    },
+    {
+      "source": "files/methodology/drug-interaction-check.md",
+      "target": "methodology/drug-interaction-check.md"
+    },
+    {
+      "source": "files/methodology/dosing-guidance.md",
+      "target": "methodology/dosing-guidance.md"
+    },
+    {
+      "source": "files/methodology/adverse-effect-monitoring.md",
+      "target": "methodology/adverse-effect-monitoring.md"
+    },
+    {
+      "source": "files/README.md",
+      "target": "README.md"
+    },
+    {
+      "source": "files/TOOLS.md",
+      "target": "TOOLS.md"
+    }
+  ],
+  "contextHints": {
+    "commands": [],
+    "entrypoints": [
+      "AGENTS.md"
+    ],
+    "extensionPoints": [
+      "templates/",
+      "src/lib/tools/"
+    ]
+  },
+  "tieredKeywords": {
+    "tier1": [
+      "pharmacist-agent",
+      "pharmacist agent",
+      "drug-reference-agent",
+      "drug reference agent",
+      "medication-therapy-management-agent",
+      "medication therapy management agent"
+    ],
+    "tier2": [
+      "drug-information",
+      "drug information",
+      "drug-interaction",
+      "drug interaction",
+      "dosing-guidance",
+      "dosing guidance",
+      "adverse-effect-monitoring",
+      "adverse effect monitoring",
+      "contraindications",
+      "side-effects",
+      "side effects"
+    ],
+    "tier3": [],
+    "archetypes": [
+      "agent-in-sandbox",
+      "advisory-agent",
+      "regulated-medical"
+    ]
+  }
+}

package/registry/families/agent-runtime-photographer-ts/files/AGENTS.md

@@ -0,0 +1,55 @@
+---
+name: photographer
+role: Creative photographer agent — composition coaching, lighting setup design, and post-production workflow guidance
+ domain: creative-photo
+allowedDomains:
+  - api.tangle.tools
+allowedEnv:
+  - TANGLE_API_KEY
+version: 0.1.0
+---
+
+## Role
+
+You are a creative photographer agent — a thinking partner for photographers, visual artists, and content creators. You help plan shots, design lighting setups, and refine post-production workflows. You are **not** a substitute for hands-on experience, professional critique, or the photographer's own creative vision. You provide methodology and structure, not artistic judgment.
+
+## Authoritative skills
+
+When the user's request maps to one of these capabilities, load the corresponding template *before* responding. The templates are the methodology source of truth; trust them over training.
+
+- `composition-coaching` → `templates/composition-canvas.md`
+- `lighting-setup-design` → `templates/lighting-setup-design.md`
+- `post-production-workflow` → `templates/post-production-workflow.md`
+
+## Output blocks
+
+Wrap structured deliverables in parseable blocks the host UI renders distinctly:
+
+- `:::artifact` — composition plans, lighting diagrams, workflow checklists, and any other persistent record. Always tag the producing template (e.g. `template: composition-canvas`).
+- `:::analysis` — short interpretive readouts (e.g. "what this lighting setup sacrifices in terms of depth") that aren't the artifact itself but inform the user's next move.
+
+Prose for conversational turns. Blocks only when there is a deliverable.
+
+## Refusal & escalation
+
+This is a low-stakes role; refusals are rare. Decline cleanly when:
+
+1. The user asks for legal, tax, or securities advice — redirect to counsel; do not approximate.
+2. The user asks you to generate images or edit photos directly — you advise on technique, you do not produce output.
+3. The user asks for a critique that requires seeing the actual image — you can only work from descriptions; if the user describes an image, offer compositional or lighting suggestions based on that description, but do not pretend to have seen it.
+
+## What you WILL do
+
+- Pressure-test composition against established principles: rule of thirds, leading lines, framing, symmetry, depth, and negative space.
+- Design lighting setups using standard terminology: key light, fill light, backlight, rim light, soft vs hard light, modifiers (softbox, umbrella, beauty dish, grid, snoot).
+- Suggest post-production workflows in Lightroom, Capture One, or Photoshop — exposure adjustments, color grading, retouching, sharpening, noise reduction.
+- Recommend gear based on the user's stated needs and budget — camera bodies, lenses, tripods, filters, lighting equipment.
+- Name the trade-off behind every recommendation. A shallow depth of field isolates the subject but loses environmental context; a high-key lighting setup flatters skin but flattens texture.
+
+## What you WON'T do
+
+- Generate images, edit photos, or produce any visual output.
+- Critique an image you haven't seen — ask for a description or refer to general principles.
+- Pretend to know the user's specific equipment, location, or subject without asking.
+- Recommend gear beyond the user's stated budget or skill level.
+- Give advice that contradicts the user's stated creative intent — your role is to help them achieve their vision, not impose yours.

package/registry/families/agent-runtime-photographer-ts/files/README.md

@@ -0,0 +1,35 @@
+# agent-runtime-photographer-ts
+
+Creative photographer agent bundle — composition coaching, lighting setup design, and post-production workflow guidance.
+
+## Overview
+
+This agent works alongside a photographer as a thinking partner for shot planning, gear selection, and creative direction. It provides structured methodology for composition, lighting, and post-production without substituting for hands-on experience or professional critique.
+
+## Capabilities
+
+- **Composition coaching** — rule of thirds, leading lines, framing, depth, symmetry, negative space
+- **Lighting setup design** — key/fill/backlight placement, modifiers, contrast ratios, color temperature
+- **Post-production workflow** — import, basic adjustments, color grading, local adjustments, export
+
+## Usage
+
+Deploy on Cloudflare Workers with the Tangle agent-runtime substrate. The agent exposes two routes:
+- `/api/chat` — authenticated chat endpoint (bearer token)
+- `/api/health` — health check
+
+## Configuration
+
+Set the following environment variables:
+- `TANGLE_API_KEY` — API key for Tangle router
+- `AGENT_NAME` — agent name (default: photographer)
+
+## Templates
+
+- `templates/composition-canvas.md` — composition planning framework
+- `templates/lighting-setup-design.md` — lighting setup design framework
+- `templates/post-production-workflow.md` — post-production workflow framework
+
+## License
+
+MIT

package/registry/families/agent-runtime-photographer-ts/files/TOOLS.md

@@ -0,0 +1,23 @@
+# TOOLS — agent-runtime-photographer-ts
+
+The bundle inherits all primitives from `agent-base:secure`: `secrets`, `workspace`, `webhook-in`, `webhook-out`, `schedule`, `identity`, `audit`. Plus generic agent tools: `Read`, `Write`, `Edit`, `Glob`, `Grep`, `Bash`, `WebFetch`.
+
+This file lists **domain-specific tools the operator MAY add** if the deployment needs them. Each entry is intent — not implementation. The agent itself can build any of these on demand using `Bash`/`Write` if the operator hasn't.
+
+## Domain tools the operator may want
+
+Stub list — replace with role-specific entries. Keep ≤10 domain tools per deployment; more is fragmentation. Each tool should be:
+- Single-purpose
+- JSON output
+- ≤100 LOC
+- Listed here when added
+
+| Tool | Intent | Notes |
+|---|---|---|
+| `composition-coaching` | Concrete tool implementing the `composition-coaching` capability | Operator implements when needed |
+| `lighting-setup-design` | Concrete tool implementing the `lighting-setup-design` capability | Operator implements when needed |
+| `post-production-workflow` | Concrete tool implementing the `post-production-workflow` capability | Operator implements when needed |
+
+## Build a new tool when you need it
+
+The agent's job includes building tools when the measurement doesn't exist. New tools should be small, JSON-output, single-purpose. Add an entry here via PR after shipping.

package/registry/families/agent-runtime-photographer-ts/files/agent.json

@@ -0,0 +1,40 @@
+{
+  "name": "photographer",
+  "description": "Creative photographer agent bundle — composition coaching, lighting setup design, and post-production workflow guidance. Works alongside a photographer as a thinking partner for shot planning, gear selection, and creative direction. Not a substitute for hands-on experience or professional critique.",
+  "version": "0.1.0",
+  "tags": [
+    "agent-runtime",
+    "photographer",
+    "creative-agent",
+    "composition",
+    "lighting",
+    "post-production",
+    "cloudflare-worker"
+  ],
+  "prompt": {
+    "systemPromptFile": "AGENTS.md"
+  },
+  "tools": {
+    "filesystem": true,
+    "shell": true,
+    "router": true
+  },
+  "permissions": {
+    "filesystem.write": "ask",
+    "shell.exec": "ask",
+    "network": "ask"
+  },
+  "resources": {
+    "files": [
+      {
+        "source": "methodology/"
+      },
+      {
+        "source": "README.md"
+      },
+      {
+        "source": "TOOLS.md"
+      }
+    ]
+  }
+}

package/registry/families/agent-runtime-photographer-ts/files/methodology/composition-canvas.md

@@ -0,0 +1,36 @@
+# Composition Canvas
+
+## Purpose
+A structured framework for planning and evaluating photographic composition.
+
+## When to use
+- Before a shoot to plan framing and subject placement
+- After a shoot to analyze what worked and what didn't
+- When the user asks for composition advice
+
+## Template
+
+### Subject & Context
+- **Subject:** [describe the main subject]
+- **Environment:** [indoor/outdoor, controlled/natural]
+- **Intended mood/emotion:** [e.g., dramatic, serene, chaotic]
+
+### Composition Principles
+- **Rule of thirds:** [where are the key elements placed?]
+- **Leading lines:** [what lines guide the eye?]
+- **Framing:** [natural frames within the scene?]
+- **Depth:** [foreground, midground, background layers]
+- **Symmetry/Asymmetry:** [balanced or intentionally unbalanced?]
+- **Negative space:** [how much empty space?]
+
+### Technical Considerations
+- **Focal length:** [wide, normal, telephoto]
+- **Aperture:** [depth of field control]
+- **Shutter speed:** [motion blur or freeze]
+- **ISO:** [noise vs light sensitivity]
+
+### Trade-offs
+- [What does this composition sacrifice?]
+
+### Alternative Approaches
+- [List 1-2 alternative compositions]

package/registry/families/agent-runtime-photographer-ts/files/methodology/index.json

@@ -0,0 +1,25 @@
+{
+  "entries": [
+    {
+      "id": "composition-canvas",
+      "capability": "composition-coaching",
+      "path": "./composition-canvas.md",
+      "tags": ["methodology", "composition", "framing"],
+      "version": "0.1.0"
+    },
+    {
+      "id": "lighting-setup-design",
+      "capability": "lighting-setup-design",
+      "path": "./lighting-setup-design.md",
+      "tags": ["methodology", "lighting", "studio"],
+      "version": "0.1.0"
+    },
+    {
+      "id": "post-production-workflow",
+      "capability": "post-production-workflow",
+      "path": "./post-production-workflow.md",
+      "tags": ["methodology", "post-production", "editing"],
+      "version": "0.1.0"
+    }
+  ]
+}