tranquil-licorice-d72166.netlify.app

{
  "name": "discover_product_topology",
  "kind": "answer",
  "impl": "imperative",
  "description": "Return the FULL cost topology for product app1: (1) the in-project resources it owns or shares (GKE, Pub/Sub, Dataflow, Cloud SQL, Firestore, Storage, Monitoring), and (2) the downstream GLOBAL services in other projects that its order flow calls — currently fraud-check and payments-gateway in the shared-platform project. Every order hits those global services; their cost IS attributed to app1 (by OTel baggage), so they are part of app1’s cost model. Also returns how each item is attributed. Read-only. For the per-hop cross-project breakdown, use trace_product_flow.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "product": {
        "type": "string",
        "enum": [
          "app1"
        ]
      }
    },
    "required": [
      "product"
    ]
  }
}

{
  "name": "get_allocation_policy",
  "kind": "answer",
  "impl": "imperative",
  "description": "Return the allocation methodology the human currently has selected on the page, plus active guardrails (approval requirement, prod-protection). Shared-cost splits and unit cost depend on this policy.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}

{
  "name": "set_allocation_policy",
  "kind": "act",
  "impl": "imperative",
  "description": "Change the shared-cost allocation methodology. Valid values: cpu_request, cpu_actual, memory, pod_count. This reallocates every shared resource and recomputes the unit cost live on screen. Use when the human questions or overrides how shared infrastructure should be split.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "method": {
        "type": "string",
        "enum": [
          "cpu_request",
          "cpu_actual",
          "memory",
          "pod_count"
        ]
      }
    },
    "required": [
      "method"
    ]
  }
}

{
  "name": "compute_unit_cost",
  "kind": "act",
  "impl": "imperative",
  "description": "Compute what one completed app1 order costs under the current allocation policy. Returns the per-resource cost breakdown, the monthly total attributed to app1, the order volume, and the resulting cost per order.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "businessUnit": {
        "type": "string",
        "enum": [
          "completed_order"
        ]
      }
    }
  }
}

{
  "name": "set_business_volume",
  "kind": "act",
  "impl": "imperative",
  "description": "Change the business-volume denominator used to compute unit cost — the number of completed app1 orders per month. Recomputes cost-per-order live. Use for what-if volume modelling (\"what would an order cost at 300k orders?\") or to re-baseline. This mutates the unit-cost model. Range 1,000–2,000,000.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "completedOrders": {
        "type": "number",
        "minimum": 1000,
        "maximum": 2000000
      }
    },
    "required": [
      "completedOrders"
    ]
  }
}

{
  "name": "trace_product_flow",
  "kind": "answer",
  "impl": "imperative",
  "description": "AUTHORITATIVE source for anything about app1’s DOWNSTREAM or CROSS-PROJECT costs — the global fraud-check and payments-gateway services in the shared-platform project that every app1 order calls. Call this whenever the question mentions the fraud service, payments, a downstream service, a global/shared service, another project, or \"cost across projects.\" These services DO exist and their cost IS attributed to app1 — do not answer that app1 has no such service; call this tool to get the truth. Returns each downstream hop, its calls per order, how it is attributed to app1 (OpenTelemetry baggage product=app1, because a resource label is common to all callers), and its cost per order. Read-only.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "product": {
        "type": "string",
        "enum": [
          "app1"
        ]
      }
    },
    "required": [
      "product"
    ]
  }
}

{
  "name": "explain_allocation",
  "kind": "act",
  "impl": "imperative",
  "description": "Explain, in plain language, how one shared resource is split between app1 and app2. For the GKE cluster the split is governed by the compute allocation policy; for throughput resources like Pub/Sub or Monitoring the split is by a single fixed signal (messages, log lines) and does not change with the policy. Use to justify a number the human is questioning.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "resourceId": {
        "type": "string",
        "enum": [
          "gke-shared",
          "pubsub-shared",
          "obs-shared"
        ]
      }
    },
    "required": [
      "resourceId"
    ]
  }
}

{
  "name": "compare_unit_cost_periods",
  "kind": "act",
  "impl": "imperative",
  "description": "Compare this month’s app1 cost-per-order against last month and identify the main driver of the change. Read-only.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}

{
  "name": "simulate_optimization",
  "kind": "act",
  "impl": "imperative",
  "description": "Model the unit-cost impact of improving utilization of app1’s Dataflow enrich-stream job by a given percent (0–100). Respects page guardrails: if \"require approval\" is on, the change is STAGED for the human to approve on screen rather than applied. If \"protect prod\" is on, it refuses to auto-apply because this Dataflow job is prod-tagged — it still returns the projected number and stages it. Never silently mutates protected state.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "utilizationGainPct": {
        "type": "number",
        "minimum": 0,
        "maximum": 100
      }
    },
    "required": [
      "utilizationGainPct"
    ]
  }
}

{
  "name": "propose_guardrail_change",
  "kind": "act",
  "impl": "imperative",
  "description": "Propose changing one of the human’s governance guardrails (\"protectProd\" or \"requireApproval\"). The agent CANNOT flip a guardrail itself — this stages the proposed change on screen for the human to confirm or decline. Use when a guardrail is blocking an action the human asked for and the agent needs to ask permission to proceed (e.g. the human wants an optimization applied but \"protect prod\" is on). This is negotiation: the agent proposes, the human governs.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "guardrail": {
        "type": "string",
        "enum": [
          "protectProd",
          "requireApproval"
        ]
      },
      "enable": {
        "type": "boolean",
        "description": "true to turn the guardrail ON (tighten), false to turn it OFF (relax)"
      },
      "reason": {
        "type": "string"
      }
    },
    "required": [
      "guardrail",
      "enable"
    ]
  }
}

{
  "name": "draft_finops_summary",
  "kind": "act",
  "impl": "imperative",
  "description": "Produce a short written unit-economics summary for app1 under the current policy — suitable for pasting into a ticket or exec note. Read-only.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}