@tangle-network/starter-foundry 0.7.2 → 0.13.0

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

@@ -0,0 +1,33 @@
+# agent-runtime-nutritionist-ts
+
+## Overview
+
+A nutrition advisor agent bundle that provides evidence-based dietary guidance, meal planning, and macro targeting. This agent is designed to work alongside users who want to improve their nutrition but is **not a substitute for a licensed registered dietitian, doctor, or therapist**.
+
+## Features
+
+- **Meal Planning**: Generate flexible, personalized meal plans based on macro targets and dietary preferences.
+- **Macro Targeting**: Calculate personalized macronutrient targets for weight management, performance, or general health.
+- **Dietary Assessment**: Evaluate current dietary intake and provide actionable recommendations.
+
+## Usage
+
+Deploy as a Cloudflare Worker. The agent exposes two routes:
+
+- `POST /api/chat` — Main chat endpoint (requires bearer token)
+- `GET /api/health` — Health check
+
+## Configuration
+
+Set the following environment variables:
+
+- `TANGLE_API_KEY` — API key for Tangle router
+- `AGENT_NAME` — Agent name (default: "nutritionist")
+
+## Disclaimer
+
+This agent provides general nutrition information and is not a substitute for professional medical advice, diagnosis, or treatment. Always seek the advice of your physician or other qualified health provider with any questions you may have regarding a medical condition or dietary changes.
+
+## License
+
+Proprietary.

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

@@ -0,0 +1,23 @@
+# TOOLS — agent-runtime-nutritionist-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 |
+|---|---|---|
+| `meal-planning` | Concrete tool implementing the `meal-planning` capability | Operator implements when needed |
+| `macro-targeting` | Concrete tool implementing the `macro-targeting` capability | Operator implements when needed |
+| `dietary-assessment` | Concrete tool implementing the `dietary-assessment` 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-nutritionist-ts/files/agent.json

@@ -0,0 +1,40 @@
+{
+  "name": "nutritionist",
+  "description": "Registered-dietitian-level nutrition advisor agent bundle — meal planning, macro targets, and evidence-based dietary guidance. Explicitly NOT a licensed RD, not a doctor, not a therapist. Advisory only — never replaces the user's physician, RD, or mental-health professional. Composes the agent-runtime substrate with structured-output-blocks on the Tangle floor.",
+  "version": "0.1.0",
+  "tags": [
+    "agent-runtime",
+    "nutritionist",
+    "dietitian",
+    "meal-planning",
+    "macros",
+    "advisory",
+    "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-nutritionist-ts/files/methodology/dietary-assessment.md

@@ -0,0 +1,153 @@
+# Dietary Assessment Template
+
+## Purpose
+Evaluate a user's current dietary intake against evidence-based
+guidelines, identify the highest-leverage gaps, and produce
+realistic recommendations the user will actually follow. Advisory
+only — never replaces a registered dietitian (RD/RDN) for
+medical-nutrition therapy.
+
+## When to use
+Trigger when the user shares a food log, asks "is my diet okay,"
+or wants to know what to change. For specific macro targets, use
+macro-targets.md. For meal planning, use meal-plan.md.
+
+## Inputs
+- 24-hour recall *or* 3–7 day food log (more days = more
+  accurate; one day is anecdote).
+- Goals: weight management, performance, lab markers, condition
+  management, energy.
+- Conditions known: diabetes, CKD, GI disorders, food allergies,
+  pregnancy, eating-disorder history.
+- Lifestyle: activity level, sleep, alcohol, schedule
+  constraints.
+- Cultural / religious / ethical context that shapes food choice.
+
+## Method
+
+1. **Estimate intake.** From the recall or log:
+   - Total energy (kcal/day, with 7-day average if available).
+   - Protein, carb, fat in grams and as % of energy.
+   - Fiber (g).
+   - Saturated fat, sodium, added sugar.
+   - Estimated micronutrients of interest (calcium, iron,
+     B12, vitamin D, folate, magnesium, potassium, omega-3) —
+     order-of-magnitude only; precise micronutrient analysis
+     requires a tool.
+2. **Compare against AMDRs and DRIs.**
+   - **AMDR** (Acceptable Macronutrient Distribution Range):
+     protein 10–35%, carb 45–65%, fat 20–35% of total energy.
+   - **DRI** (Dietary Reference Intake) for individual
+     micronutrients by age / sex.
+   - **Fiber**: 25 g/day for women, 38 g/day for men (~14 g
+     per 1000 kcal).
+   - **Saturated fat**: <10% of energy.
+   - **Sodium**: <2300 mg/day for general population.
+   - **Added sugar**: <10% of energy (AHA: <6% for women,
+     <9% for men).
+3. **Pattern check.** Look for the typical patterns rather than
+   nutrient-by-nutrient:
+   - Low vegetable / fruit intake (most common gap).
+   - Insufficient protein at breakfast.
+   - Skipped meals → late-day overeating.
+   - High ultra-processed-food share (UPF; correlates with
+     poor outcomes independent of macro composition).
+   - Alcohol displacing food.
+   - Frequent sugary drinks.
+   - Imbalance: e.g., high meat / low plant; high refined
+     carb / low fiber.
+4. **Compare to a credible eating pattern.** Rather than
+   nitpicking nutrients, check fit against:
+   - **Dietary Guidelines for Americans** (DGA): half plate
+     fruits/veg, lean protein, whole grain.
+   - **Mediterranean** pattern: olive oil, fish, legumes,
+     whole grain, nuts, vegetables.
+   - **DASH** (for hypertension): low sodium, high potassium,
+     vegetable-forward.
+   - **Plate method** (diabetes): ½ non-starchy veg, ¼ protein,
+     ¼ carb.
+5. **Prioritize changes.** Rank by:
+   - **Impact** on the user's stated goal.
+   - **Feasibility** given their schedule, budget, and
+     preferences.
+   - **Adherence likelihood**: small specific changes beat
+     dramatic overhauls (one new vegetable per dinner > "eat
+     Mediterranean").
+   Cap recommendations at **3** for the first session — more
+   produces fewer changes adopted.
+6. **Strength-based delivery.**
+   - Lead with what the user is already doing well.
+   - Frame changes as additions where possible ("add a serving
+     of legumes" is easier than "cut red meat").
+   - Don't moralize.
+7. **Lab and condition flags.**
+   - If the user shares labs (lipids, A1c, ferritin, B12,
+     vitamin D, eGFR), incorporate but flag that interpretation
+     is the clinician's.
+   - If conditions warrant medical-nutrition therapy
+     (diagnosed CKD, T1D, IBD, eating disorder), refuse
+     prescriptive advice and refer to RD.
+
+## Common assessment failures
+
+1. **Snapshot-from-one-day.** A 24-hour recall has high
+   variance; treat as a starting point, not a verdict.
+2. **Numbers without pattern.** "High sodium" missed; the user
+   has a high-canned-soup habit. Pattern reveals the lever.
+3. **Overhaul advice.** "Switch to Mediterranean" — collapses
+   in 2 weeks. Smaller adjacent changes stick.
+4. **Diagnosing deficiency from diet.** Diet predicts risk, not
+   status. Refer for labs if in doubt.
+5. **Ignoring culture / budget / access.** Recommendations the
+   user can't execute are worse than no recommendation.
+6. **Toxic-positivity reframing.** Pretending "any food is
+   fine" when the user has a measurable issue.
+7. **Diagnostic framing for eating disorders.** Calorie-counting
+   prescriptions can harm someone with restrictive-ED history.
+   Screen lightly before prescribing.
+
+## Output
+
+```
+:::artifact
+template: dietary-assessment
+intake-estimate:
+  kcal: ...
+  protein-g: ...
+  carb-g: ...
+  fat-g: ...
+  fiber-g: ...
+  saturated-fat-pct: ...
+  sodium-mg: ...
+  added-sugar-pct: ...
+pattern-flags:
+  - "low vegetable intake (~1.5 servings/day vs 2.5–4 recommended)"
+  - "protein concentrated at dinner; <10g at breakfast"
+strengths:
+  - "consistent meal timing"
+  - "good fish 2×/week"
+recommendations:
+  - { rank: 1, action: "add a vegetable serving to lunch", rationale: "biggest gap; low effort" }
+  - { rank: 2, action: "add 20g protein to breakfast (yogurt or eggs)", rationale: "supports satiety and energy" }
+  - { rank: 3, action: "swap sweetened soda for sparkling water 4 days/week", rationale: "removes added sugar load" }
+labs-flagged: []
+follow-up: "re-assess in 4 weeks"
+:::
+```
+
+## Refusal triggers
+
+The agent will:
+- **Refuse** to diagnose a deficiency from diet alone — refer
+  to clinician for labs.
+- **Refuse** to provide medical-nutrition therapy for
+  diagnosed conditions (CKD, T1D, IBD, oncology, eating
+  disorders) — refer to RD.
+- **Refuse** to prescribe extreme restriction (very-low-calorie
+  diets, prolonged fasting) — these require clinical
+  supervision.
+- **Escalate** to a behavioral / eating-disorder professional
+  if the user describes restrictive, binge, purge, or
+  obsessive food behavior; surface NEDA helpline (US:
+  1-800-931-2237).
+- **Escalate** to clinician if user shares concerning labs.

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

@@ -0,0 +1,25 @@
+{
+  "entries": [
+    {
+      "id": "meal-plan",
+      "capability": "meal-planning",
+      "path": "./meal-plan.md",
+      "tags": ["methodology", "meal-planning", "macros"],
+      "version": "0.1.0"
+    },
+    {
+      "id": "macro-targets",
+      "capability": "macro-targeting",
+      "path": "./macro-targets.md",
+      "tags": ["methodology", "macros", "tdde"],
+      "version": "0.1.0"
+    },
+    {
+      "id": "dietary-assessment",
+      "capability": "dietary-assessment",
+      "path": "./dietary-assessment.md",
+      "tags": ["methodology", "assessment", "micronutrients"],
+      "version": "0.1.0"
+    }
+  ]
+}

package/registry/families/agent-runtime-nutritionist-ts/files/methodology/macro-targets.md

@@ -0,0 +1,171 @@
+# Macro Targets Template
+
+## Purpose
+Calculate personalized macronutrient targets — total energy and
+grams of protein, fat, and carbohydrate — based on the user's
+goals, activity, and body composition. Output is a target range,
+not a precise prescription. Advisory only; specific medical
+conditions require an RD.
+
+## When to use
+Trigger when the user asks "how much protein/carb/fat should I
+eat" or "how many calories." For an overall food-pattern
+assessment, use dietary-assessment.md. For meal planning, use
+meal-plan.md.
+
+## Inputs
+- Age, sex (biological), height, weight, body composition if
+  known.
+- Activity level (sedentary / light / moderate / heavy /
+  athlete) and exercise specifics if performance is the goal.
+- Goal: weight loss, maintenance, muscle gain (lean
+  hypertrophy), athletic performance, body recomposition,
+  health markers.
+- Conditions: any that affect macro guidelines (T2D, CKD, IBD,
+  pregnancy, lactation, hormonal therapy).
+- Preferences / restrictions (vegetarian, vegan, kosher, halal,
+  allergies).
+
+## Method
+
+1. **Estimate TDEE.** Use Mifflin-St Jeor BMR + activity
+   multiplier:
+
+   - **BMR (men)**: `(10 × kg) + (6.25 × cm) − (5 × age) + 5`
+   - **BMR (women)**: `(10 × kg) + (6.25 × cm) − (5 × age) − 161`
+   - Activity multipliers:
+     | Level     | Multiplier |
+     |-----------|------------|
+     | Sedentary | 1.2        |
+     | Light (1–3 d/wk) | 1.375 |
+     | Moderate (3–5 d/wk) | 1.55 |
+     | Heavy (6–7 d/wk) | 1.725 |
+     | Athlete (2× day) | 1.9 |
+
+   For known body composition, use Katch-McArdle:
+   `BMR = 370 + (21.6 × LBM_kg)`. More accurate when body fat
+   % is reliable.
+
+2. **Set calorie target** by goal:
+   - **Maintenance**: TDEE.
+   - **Lean fat loss**: −15% to −25% of TDEE (typically −300
+     to −500 kcal/day). Larger deficits accelerate loss but
+     erode lean mass and adherence.
+   - **Lean muscle gain**: +5% to +15% of TDEE (typically
+     +250 to +500 kcal/day). Larger surpluses inflate fat
+     gain.
+   - **Recomposition** (gain muscle, lose fat simultaneously):
+     near maintenance with high protein; works best for novice
+     trainees and returnees.
+   - **Athletic performance**: at or slightly above TDEE;
+     timing matters more than magnitude.
+
+3. **Set protein target.**
+   - **Sedentary / general health**: 0.8–1.2 g/kg (RDA is
+     0.8 g/kg as a minimum to prevent deficiency, not optimum).
+   - **Active / fat-loss preserving lean mass**: 1.6–2.2 g/kg.
+   - **Bodybuilding / hypertrophy / cutting**: 2.0–2.4 g/kg
+     of fat-free mass (or use total weight for simplicity if
+     LBM unknown).
+   - **Older adults (≥65)**: 1.2–1.6 g/kg (anabolic resistance).
+   - **Endurance athletes**: 1.4–1.8 g/kg.
+
+4. **Set fat target.**
+   - **Minimum**: 0.5–1.0 g/kg to support hormones.
+   - **Range**: 20–35% of total energy.
+   - **Quality**: prioritize unsaturated (olive, avocado,
+     nuts, fatty fish); cap saturated at <10% of energy;
+     minimize trans.
+   - **Omega-3**: 250–500 mg combined EPA+DHA/day (general);
+     higher for cardiometabolic indications under clinician
+     supervision.
+
+5. **Set carb target** = remaining energy after protein + fat.
+   - 1 g protein = 4 kcal, 1 g carb = 4 kcal, 1 g fat = 9 kcal.
+   - **Endurance athletes**: prioritize carb at 5–10 g/kg
+     depending on session intensity / duration.
+   - **Strength athletes**: 3–6 g/kg.
+   - **Sedentary**: lower carb works fine; balance with fat.
+   - **Insulin resistance / T2D** (advisory only): lower-carb
+     pattern often improves markers; refer to clinician /
+     RD before titrating.
+
+6. **Fiber target.**
+   - 25 g/day women, 38 g/day men, or 14 g per 1000 kcal.
+   - Most users will fall short; surface this explicitly.
+
+7. **Hydration target.**
+   - 30–40 mL/kg/day baseline; +500–1000 mL per hour of
+     intense exercise.
+   - Higher in heat / altitude / lactation.
+
+8. **Output a range, not a point.** Calorie and macro targets
+   are estimates with ±10% real-world variance. Give the user
+   a daily band rather than a single number.
+
+## Sanity bounds and refusal
+
+- **Do not recommend below BMR** for sustained calorie target
+  without medical supervision (very-low-calorie diet =
+  clinician-supervised territory).
+- **Pregnancy / lactation**: do not prescribe deficits;
+  defer to OB/GYN + RD.
+- **History of restrictive ED**: avoid exact calorie targets;
+  refer to behavioral support and intuitive-eating-aware RD.
+- **Adolescents**: refer to pediatrician + RD for weight
+  goals.
+- **Diagnosed CKD**: protein target is restricted; clinician
+  prescribes — agent does not.
+
+## Output
+
+```
+:::artifact
+template: macro-targets
+inputs:
+  age: ...
+  sex: ...
+  height-cm: ...
+  weight-kg: ...
+  activity: "moderate"
+  goal: "lean fat loss"
+estimates:
+  bmr: ...
+  tdee: ...
+  goal-calories: { low: ..., target: ..., high: ... }
+  protein-g: { low: ..., target: ..., high: ... }
+  fat-g: { low: ..., target: ..., high: ... }
+  carb-g: { low: ..., target: ..., high: ... }
+  fiber-g: ...
+  fluid-ml: ...
+notes:
+  - "Targets are ranges; track 7-day average, not daily exactness."
+  - "Re-evaluate in 4 weeks if weight trend doesn't match goal by ±0.5%/week."
+referral-flags: []
+:::
+```
+
+## Common target-setting failures
+
+1. **Single-number prescriptions.** Variance is real; ranges
+   adhere better.
+2. **Ignoring lean mass.** Calculations on total weight at high
+   body fat overstate protein need; underweight users may need
+   more.
+3. **Excessive deficits.** -1000 kcal/day often backfires:
+   muscle loss, hunger, adherence collapse.
+4. **Skipping fat floor.** Below 0.5 g/kg of fat for sustained
+   periods affects hormones — especially in women.
+5. **No re-evaluation cadence.** Targets calibrate over weeks;
+   set a re-check.
+6. **Disregarding context.** Targets ignored if they conflict
+   with the user's culture / schedule / preferences.
+
+## Refusal
+
+- Refuse calorie targets below BMR for sustained use.
+- Refuse exact targets for users with eating-disorder history
+  unless they explicitly request and are working with a
+  behavioral provider.
+- Refuse to override clinician-prescribed targets (CKD,
+  diabetes, oncology).

package/registry/families/agent-runtime-nutritionist-ts/files/methodology/meal-plan.md

@@ -0,0 +1,33 @@
+# Meal Plan Template
+
+## Purpose
+Generate a structured, flexible meal plan aligned with the user's macro targets, dietary preferences, and lifestyle.
+
+## Inputs
+- Daily calorie target
+- Macro split (protein, carbs, fat)
+- Dietary restrictions (vegetarian, vegan, gluten-free, etc.)
+- Food preferences (likes, dislikes)
+- Meal frequency (3 meals, 4 meals, etc.)
+- Cooking ability and time available
+
+## Process
+1. **Calculate per-meal macros** based on meal frequency and total daily targets.
+2. **Select food sources** for each macro: lean proteins, whole grains, healthy fats, fruits, vegetables.
+3. **Build meals** that are balanced, satisfying, and varied across the week.
+4. **Include snacks** if desired, fitting within remaining macros.
+5. **Provide alternatives** for each meal to allow flexibility.
+
+## Output
+A weekly meal plan with daily breakdowns, including:
+- Meal name and description
+- Portion sizes (grams, cups, or common measures)
+- Macro breakdown per meal
+- Total daily macros
+- Optional: grocery list
+
+## Constraints
+- Do not recommend extreme restriction or elimination of food groups without medical reason.
+- Ensure micronutrient adequacy (fiber, vitamins, minerals).
+- Avoid foods the user has explicitly ruled out.
+- Keep plans realistic for the user's cooking skill and time.

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

@@ -0,0 +1,145 @@
+{
+  "id": "agent-runtime-nutritionist-ts",
+  "description": "Registered-dietitian-level nutrition advisor agent bundle \u2014 meal planning, macro targets, and evidence-based dietary guidance. Explicitly NOT a licensed RD, not a doctor, not a therapist. Advisory only \u2014 never replaces the user's physician, RD, or mental-health professional. Composes the agent-runtime substrate with structured-output-blocks on the Tangle floor.",
+  "tags": [
+    "agent-runtime",
+    "nutritionist",
+    "dietitian",
+    "meal-planning",
+    "macros",
+    "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-nutritionist",
+    "agentName": "nutritionist",
+    "publicVars": [
+      "AGENT_NAME"
+    ],
+    "routes": [
+      {
+        "path": "/api/chat",
+        "auth": "bearer",
+        "callsTools": [
+          "meal-plan",
+          "macro-targets",
+          "dietary-assessment"
+        ]
+      },
+      {
+        "path": "/api/health",
+        "auth": "none",
+        "callsTools": []
+      }
+    ],
+    "declaredCapabilities": [
+      "meal-planning",
+      "macro-targeting",
+      "dietary-assessment"
+    ],
+    "runtime": {
+      "sandbox": "tangle",
+      "noNewPrivileges": true,
+      "capDrop": "ALL"
+    },
+    "stakes": "moderate",
+    "advisoryOnly": true,
+    "outboundDomains": [
+      "api.tangle.tools"
+    ],
+    "secrets": [
+      "TANGLE_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/meal-plan.md",
+      "target": "methodology/meal-plan.md"
+    },
+    {
+      "source": "files/methodology/macro-targets.md",
+      "target": "methodology/macro-targets.md"
+    },
+    {
+      "source": "files/methodology/dietary-assessment.md",
+      "target": "methodology/dietary-assessment.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": [
+      "nutritionist-agent",
+      "nutritionist agent",
+      "rd-agent",
+      "rd agent",
+      "dietitian-agent",
+      "dietitian agent",
+      "nutrition-coach",
+      "nutrition coach"
+    ],
+    "tier2": [
+      "macro-targets",
+      "macro targets",
+      "dietary-assessment",
+      "dietary assessment",
+      "evidence-based-nutrition",
+      "evidence based nutrition",
+      "supplement-advice",
+      "supplement advice"
+    ],
+    "tier3": [],
+    "archetypes": [
+      "agent-in-sandbox",
+      "advisory-agent"
+    ]
+  }
+}