kumbukaproject.vercel.app

{
  "name": "add_activity_record",
  "kind": "act",
  "impl": "imperative",
  "description": "Add a new activity record to Kumbuka (a mining-site activity tracker). Use \"expense\" when money left the site (e.g. paying a worker or supplier), \"income\" when money came in (e.g. selling output), or \"activity\" for a general work log entry with no money attached.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "type": {
        "type": "string",
        "enum": [
          "expense",
          "income",
          "activity",
          "other"
        ],
        "description": "Kind of record: expense, income, activity, or other."
      },
      "person": {
        "type": "string",
        "description": "Person involved, if any (payer, payee, worker name)."
      },
      "amount": {
        "type": "number",
        "description": "Amount of money in Tanzanian Shillings (TSh), if applicable."
      },
      "item": {
        "type": "string",
        "description": "Item, goods, or task the record refers to (e.g. \"diesel\", \"cement\", \"loading truck\")."
      },
      "unit": {
        "type": "string",
        "description": "Unit for the item quantity, if any (e.g. \"bags\", \"liters\", \"kg\")."
      },
      "note": {
        "type": "string",
        "description": "Free-text note or extra detail about the record."
      }
    },
    "required": [
      "type"
    ]
  },
  "page": "/"
}

{
  "name": "list_activity_records",
  "kind": "answer",
  "impl": "imperative",
  "description": "List Kumbuka activity records, optionally filtered by type, person, or a date range (unix ms timestamps).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "type": {
        "type": "string",
        "enum": [
          "expense",
          "income",
          "activity",
          "other"
        ]
      },
      "person": {
        "type": "string",
        "description": "Filter by person name (partial match, case-insensitive)."
      },
      "startDate": {
        "type": "number",
        "description": "Unix ms timestamp for range start."
      },
      "endDate": {
        "type": "number",
        "description": "Unix ms timestamp for range end."
      },
      "limit": {
        "type": "number",
        "description": "Max number of records to return. Default 50."
      }
    },
    "required": []
  },
  "page": "/"
}

{
  "name": "search_activity_records",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search Kumbuka records by keyword across the original text, person, item, and note fields. Useful for answering questions like \"how much did we pay John\" or \"what happened last Tuesday\".",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Keyword or phrase to search for."
      },
      "limit": {
        "type": "number",
        "description": "Max number of matches to return. Default 20."
      }
    },
    "required": [
      "query"
    ]
  },
  "page": "/"
}

{
  "name": "get_summary_report",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get a financial and activity summary for a time range: total money out, total money in, balance, record counts by type, and totals by person.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "range": {
        "type": "string",
        "enum": [
          "day",
          "week",
          "month"
        ],
        "description": "Reporting period, relative to today. Default \"week\"."
      }
    },
    "required": []
  },
  "page": "/"
}

{
  "name": "delete_activity_record",
  "kind": "transact",
  "impl": "imperative",
  "description": "Delete a Kumbuka activity record by its id.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "description": "The record id to delete."
      }
    },
    "required": [
      "id"
    ]
  },
  "page": "/"
}