{
  "format": "zambo.workflow-recipe",
  "version": "1.0.0",
  "updated_at": "2026-11-08",
  "title": "Find and track local service leads",
  "slug": "contractor-lead-engine",
  "purpose": "A local contractor wants to discover potential leads and keep owner-approved follow-up notes in one work session.",
  "audience": "Local service businesses",
  "status": "illustrative_not_executed",
  "validated_against": {
    "live_catalog": "https://zambo.dev/mcp?full=true",
    "checked_at": "2026-11-08"
  },
  "mapping_legend": {
    "$from_user": "Use the named user input; ask instead of guessing.",
    "$from_step": "Read a dotted field path from that earlier step's observed JSON result.",
    "$from_current_job": "Use the current connected job/session value.",
    "$from_each_item": "Use one item from the named user list for a step marked repeat_only_for; preserve the results in iteration order."
  },
  "client_compatibility": {
    "protocol": "MCP Streamable HTTP",
    "endpoint": "https://zambo.dev/mcp",
    "tested_clients": [],
    "note": "Not executed in a connected AI client. Client-specific compatibility is unverified."
  },
  "user_inputs": [
    "trade",
    "city_and_state",
    "approved_private_note",
    "completed_action",
    "redacted_summary"
  ],
  "input_guidance": "Inputs referenced by conditional steps are only needed when those steps apply. Ask the user before optional memory, journal, sharing, or public-repository actions.",
  "steps": [
    {
      "id": "leads",
      "tool": "leadsignal",
      "action": "Search for leads using the user's trade and city.",
      "arguments_template": {
        "trade": {
          "$from_user": "trade"
        },
        "city": {
          "$from_user": "city_and_state"
        }
      },
      "authorization": {
        "mcp_access": "Public MCP endpoint; a specific tool may have separate limits or require user confirmation.",
        "user_approval": "Required before any write, sharing, payment, or external action.",
        "secrets": "Never include provider keys, passwords, or other secrets."
      },
      "expected_output": "The live lead results and any source notes returned by the tool.",
      "stop_and_resume": "Stop on an error, missing permission, unexpected output, or unavailable tool. Do not claim success. Resume only from the last confirmed step using its actual returned values."
    },
    {
      "id": "memory",
      "tool": "memory_remember",
      "action": "Save a short, user-approved private note for later recall.",
      "arguments_template": {
        "_session_id": {
          "$from_current_job": "session_id"
        },
        "fact": {
          "$from_user": "approved_private_note"
        }
      },
      "authorization": {
        "mcp_access": "Public MCP endpoint; a specific tool may have separate limits or require user confirmation.",
        "user_approval": "Required before any write, sharing, payment, or external action.",
        "secrets": "Never include provider keys, passwords, or other secrets."
      },
      "expected_output": "A private memory confirmation; keep the returned code private.",
      "run_only_when": "Only if the user explicitly requests saving a note and approves its exact text.",
      "stop_and_resume": "Stop on an error, missing permission, unexpected output, or unavailable tool. Do not claim success. Resume only from the last confirmed step using its actual returned values."
    },
    {
      "id": "journal",
      "tool": "journal_log",
      "action": "Record an action only after it actually happened, without raw personal data.",
      "arguments_template": {
        "job_id": {
          "$from_current_job": "session_id"
        },
        "executor_identity": "user-approved contractor workflow",
        "action": {
          "$from_user": "completed_action"
        },
        "metadata": {
          "$from_user": "redacted_summary"
        }
      },
      "authorization": {
        "mcp_access": "Public MCP endpoint; a specific tool may have separate limits or require user confirmation.",
        "user_approval": "Required before any write, sharing, payment, or external action.",
        "secrets": "Never include provider keys, passwords, or other secrets."
      },
      "expected_output": "A receipt recording the reported action; it does not independently verify an outside contact.",
      "run_only_when": "Only if an outside action actually happened and the user approves a redacted log entry.",
      "stop_and_resume": "Stop on an error, missing permission, unexpected output, or unavailable tool. Do not claim success. Resume only from the last confirmed step using its actual returned values."
    },
    {
      "id": "recent",
      "tool": "continuity_get_recent",
      "action": "Review recent receipt-backed activity for this same job.",
      "arguments_template": {
        "session_id": {
          "$from_current_job": "session_id"
        },
        "limit": 20
      },
      "authorization": {
        "mcp_access": "Public MCP endpoint; a specific tool may have separate limits or require user confirmation.",
        "user_approval": "Required before any write, sharing, payment, or external action.",
        "secrets": "Never include provider keys, passwords, or other secrets."
      },
      "expected_output": "The job events visible to this caller.",
      "stop_and_resume": "Stop on an error, missing permission, unexpected output, or unavailable tool. Do not claim success. Resume only from the last confirmed step using its actual returned values."
    }
  ],
  "safety": {
    "no_payment_or_external_action": true,
    "privacy": "Use only owner-approved, client-safe inputs. Public receipts may expose call details; keep sensitive data out.",
    "receipt_scope": "Receipts record Zambo-observed calls. They do not prove answer correctness, participant identity, or an outside outcome."
  },
  "pricing": [
    "Free access: 20 metered calls per UTC day, shared across tools, plus one free wrap-up handover each day.",
    "Day Pass: $0.99 for 24 hours, one payment.",
    "Zambo Pass: $29 for 30 days, one payment.",
    "Lifetime: $250 one payment while Zambo operates. It includes current Level 2 features, not future features or third-party provider costs.",
    "No subscription or automatic renewal. A pass does not pay for third-party AI plans or external services."
  ]
}