helipod-mcp 0.5.2 → 0.5.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -35018,7 +35018,7 @@ var containerTools = [
35018
35018
  title: "Update / rename service",
35019
35019
  kind: "write",
35020
35020
  idempotent: true,
35021
- description: "Rename a service or change its start command, root directory, health check or startup dependencies. Settings apply on the next deploy (needsRedeploy). Renaming breaks references like ${{oldName.KEY}} in other services' variables: show the user the returned warnings and fix those variables (set_variables / set_project_variables) before redeploying.",
35021
+ description: "Rename a service or change its start command, root directory, health check or startup dependencies. Settings apply on the next deploy (needsRedeploy). Renaming breaks references like ${{oldName.KEY}} in other services' variables: the response lists them in warnings.",
35022
35022
  input: {
35023
35023
  serviceId: id("Service"),
35024
35024
  name: exports_external.string().regex(/^[A-Za-z][A-Za-z0-9_-]{0,39}$/).optional().describe("New service name (letters, digits, _ -; starts with a letter; unique in the environment)"),
@@ -35042,7 +35042,7 @@ var containerTools = [
35042
35042
  name: "delete_service",
35043
35043
  title: "Delete service",
35044
35044
  kind: "destructive",
35045
- description: "Stop and delete a service with its domains and volumes. Volume data is lost. Confirm with the user first.",
35045
+ description: "Stop and delete a service with its domains and volumes. Volume data is lost.",
35046
35046
  input: { serviceId: id("Service") },
35047
35047
  run: (a, api2) => api2.api("DELETE", `${C}/services/${a.serviceId}`)
35048
35048
  }),
@@ -35050,7 +35050,7 @@ var containerTools = [
35050
35050
  name: "deploy_service",
35051
35051
  title: "Deploy service",
35052
35052
  kind: "write",
35053
- description: "Start a new deployment (Git services build the latest commit). COSTS MONEY: charges today's cost when the build starts, refunded if it fails. dryRun=true returns the cost only. Then poll get_deployment.",
35053
+ description: "Start a new deployment (Git services build the latest commit). COSTS MONEY: charges today's cost when the build starts, refunded if it fails. dryRun=true returns the cost only. The deployment runs in the background; get_deployment returns its status.",
35054
35054
  input: { serviceId: id("Service"), dryRun, idempotencyKey: idem },
35055
35055
  run: (a, api2) => api2.api("POST", `${C}/services/${a.serviceId}/deployments`, { query: { dryRun: a.dryRun ? "true" : undefined }, idempotencyKey: a.idempotencyKey })
35056
35056
  }),
@@ -35127,7 +35127,7 @@ var containerTools = [
35127
35127
  name: "add_service_domain",
35128
35128
  title: "Add domain to service",
35129
35129
  kind: "write",
35130
- description: "Add a free *.helipod.app domain (kind=helipod) or your own domain (kind=custom) to a port. For custom domains, tell the user to create the DNS record from the response's dns field.",
35130
+ description: "Add a free *.helipod.app domain (kind=helipod) or your own domain (kind=custom) to a port. For custom domains, the response's dns field is the DNS record the domain needs.",
35131
35131
  input: {
35132
35132
  serviceId: id("Service"),
35133
35133
  kind: exports_external.enum(["helipod", "custom"]),
@@ -35198,7 +35198,7 @@ var containerTools = [
35198
35198
  name: "delete_volume",
35199
35199
  title: "Delete volume",
35200
35200
  kind: "destructive",
35201
- description: "Remove a volume; its data is lost on the next deploy. Confirm with the user first.",
35201
+ description: "Remove a volume; its data is lost on the next deploy.",
35202
35202
  input: { serviceId: id("Service"), volumeId: id("Volume") },
35203
35203
  run: (a, api2) => api2.api("DELETE", `${C}/services/${a.serviceId}/volumes/${a.volumeId}`)
35204
35204
  }),
@@ -35206,7 +35206,7 @@ var containerTools = [
35206
35206
  name: "resize_volume",
35207
35207
  title: "Resize volume",
35208
35208
  kind: "write",
35209
- description: "Change a volume's size (1-50 GB; never below the space already used). A larger volume COSTS MONEY: it raises the daily cost, charged pro rata when the service is redeployed and in full from the next renewal. Call with dryRun=true first, show currentDailyCost vs newDailyCost (IDR) and wait for the user's yes. Applies on the next deploy.",
35209
+ description: "Change a volume's size (1-50 GB; never below the space already used). A larger volume COSTS MONEY: it raises the daily cost, charged pro rata when the service is redeployed and in full from the next renewal. dryRun=true returns currentDailyCost and newDailyCost (IDR) without changing anything. Applies on the next deploy.",
35210
35210
  input: {
35211
35211
  serviceId: id("Service"),
35212
35212
  volumeId: id("Volume"),
@@ -35245,7 +35245,7 @@ var containerTools = [
35245
35245
  title: "Save function source",
35246
35246
  kind: "write",
35247
35247
  idempotent: true,
35248
- description: "Replace the whole source code of a function service (up to 512 KB). The previous code is overwritten: read get_function_code first when editing. Runs after the next deploy (deploy_service).",
35248
+ description: "Replace the whole source code of a function service (up to 512 KB). The previous code is overwritten (get_function_code returns the current code). Runs after the next deploy (deploy_service).",
35249
35249
  input: { serviceId: id("Service"), code: exports_external.string().min(1).max(512 * 1024) },
35250
35250
  run: (a, api2) => api2.api("PUT", `${C}/services/${a.serviceId}/function`, { body: { code: a.code } })
35251
35251
  }),
@@ -35261,7 +35261,7 @@ var containerTools = [
35261
35261
  name: "add_secret_file",
35262
35262
  title: "Add secret file",
35263
35263
  kind: "write",
35264
- description: "Upload a file (certificate, key, credentials JSON, config) that is mounted read-only into the service at mountPath. Content is base64 of the file's bytes, at most 10 MB; it is stored as a secret and can never be read back. Applies on the next deploy. Don't echo the contents in chat.",
35264
+ description: "Upload a file (certificate, key, credentials JSON, config) that is mounted read-only into the service at mountPath. Content is base64 of the file's bytes, at most 10 MB; it is stored as a secret and can never be read back. Applies on the next deploy.",
35265
35265
  input: {
35266
35266
  serviceId: id("Service"),
35267
35267
  fileName: exports_external.string().min(1).max(200).describe("e.g. service-account.json"),
@@ -35291,7 +35291,7 @@ var containerTools = [
35291
35291
  name: "delete_secret_file",
35292
35292
  title: "Delete secret file",
35293
35293
  kind: "destructive",
35294
- description: "Delete a secret file; it is gone from the service after the next deploy and cannot be recovered (contents are never readable). Confirm with the user.",
35294
+ description: "Delete a secret file; it is gone from the service after the next deploy and cannot be recovered (contents are never readable).",
35295
35295
  input: { serviceId: id("Service"), fileId: id("File") },
35296
35296
  run: (a, api2) => api2.api("DELETE", `${C}/services/${a.serviceId}/files/${a.fileId}`)
35297
35297
  }),
@@ -35328,7 +35328,7 @@ var containerTools = [
35328
35328
  name: "deploy_template",
35329
35329
  title: "Deploy template",
35330
35330
  kind: "write",
35331
- description: "Create every service of a template in an environment and deploy them. COSTS MONEY (each service is billed daily). Confirm with the user first.",
35331
+ description: "Create every service of a template in an environment and deploy them. COSTS MONEY (each service is billed daily).",
35332
35332
  input: {
35333
35333
  environmentId: id("Environment"),
35334
35334
  slug: exports_external.string().regex(/^[a-z0-9][a-z0-9-]{0,79}$/),
@@ -35359,7 +35359,7 @@ var containerTools = [
35359
35359
  ];
35360
35360
 
35361
35361
  // src/tools/vps.ts
35362
- var vpsId = exports_external.string().describe("VPS id");
35362
+ var vpsId = exports_external.string().describe("VPS id from list_vps (not the name or hostname)");
35363
35363
  var password = exports_external.string().min(12).max(30).describe("12-30 characters with upper and lower case letters, a digit and one of ! @ # $ % ^ *");
35364
35364
  var period = exports_external.enum(["monthly", "3month", "6month", "yearly"]);
35365
35365
  var pointId = exports_external.string().describe("Restore point id (from list_vps_restore_points)");
@@ -35377,7 +35377,7 @@ var vpsTools = [
35377
35377
  name: "list_vps",
35378
35378
  title: "List VPS",
35379
35379
  kind: "read",
35380
- description: "Servers this key can reach, with status and public IP.",
35380
+ description: "Every server this key can reach (all kinds), with status, providerCode (1 = shares a public address, 2/3 = own IP) and access: the host and SSH port to connect to.",
35381
35381
  input: { status: exports_external.string().optional().describe("e.g. running, stopped"), projectId: exports_external.string().uuid().optional() },
35382
35382
  run: (a, api2) => api2.api("GET", "/vps", { query: { status: a.status, projectId: a.projectId } })
35383
35383
  }),
@@ -35385,7 +35385,7 @@ var vpsTools = [
35385
35385
  name: "get_vps",
35386
35386
  title: "Get VPS",
35387
35387
  kind: "read",
35388
- description: "One server: status, IP, size, plan, expiry, last job. Poll it after an action until status is running, stopped, terminated or error.",
35388
+ description: "One server: status, access (host and SSH port), providerCode, size, plan, expiry, last job. Poll it after an action until status is running, stopped, terminated or error.",
35389
35389
  input: { vpsId },
35390
35390
  run: (a, api2) => api2.api("GET", `/vps/${a.vpsId}`)
35391
35391
  }),
@@ -35409,7 +35409,7 @@ var vpsTools = [
35409
35409
  name: "vps_power",
35410
35410
  title: "Start / stop / restart VPS",
35411
35411
  kind: "destructive",
35412
- description: "Power action on a server. stop and restart interrupt whatever runs on it: confirm with the user.",
35412
+ description: "Power action on a server. stop and restart interrupt whatever runs on it.",
35413
35413
  input: { vpsId, action: exports_external.enum(["start", "stop", "restart"]) },
35414
35414
  run: (a, api2) => api2.api("POST", `/vps/${a.vpsId}/${a.action}`)
35415
35415
  }),
@@ -35417,7 +35417,7 @@ var vpsTools = [
35417
35417
  name: "reinstall_vps",
35418
35418
  title: "Reinstall VPS",
35419
35419
  kind: "destructive",
35420
- description: "Wipe the disk and install an operating system. ALL DATA ON THE SERVER IS LOST. Get explicit confirmation.",
35420
+ description: "Wipe the disk and install an operating system. ALL DATA ON THE SERVER IS LOST.",
35421
35421
  input: { vpsId, osType: exports_external.string(), osVersion: exports_external.string(), rootPassword: password },
35422
35422
  run: (a, api2) => api2.api("POST", `/vps/${a.vpsId}/reinstall`, { body: { osType: a.osType, osVersion: a.osVersion, rootPassword: a.rootPassword } })
35423
35423
  }),
@@ -35433,7 +35433,7 @@ var vpsTools = [
35433
35433
  name: "get_vps_credentials",
35434
35434
  title: "Get VPS login",
35435
35435
  kind: "read",
35436
- description: "Login details: host, user (root, or Administrator on Windows), port, protocol (ssh or rdp) and password. Treat the password as a secret: don't echo it unless the user asks.",
35436
+ description: "Login details: host, user (root, or Administrator on Windows), port, protocol (ssh or rdp) and password. The response contains the root password. Only servers with providerCode 2 keep it (others: 409 FEATURE_NOT_AVAILABLE; the password is the one set at create or reset).",
35437
35437
  input: { vpsId },
35438
35438
  run: (a, api2) => api2.api("GET", `/vps/${a.vpsId}/credentials`)
35439
35439
  }),
@@ -35441,7 +35441,7 @@ var vpsTools = [
35441
35441
  name: "terminate_vps",
35442
35442
  title: "Terminate VPS",
35443
35443
  kind: "destructive",
35444
- description: "Delete a server permanently. ALL DATA IS LOST and there is no refund for the remaining period. Get explicit confirmation.",
35444
+ description: "Delete a server permanently. ALL DATA IS LOST and there is no refund for the remaining period.",
35445
35445
  input: { vpsId },
35446
35446
  run: (a, api2) => api2.api("DELETE", `/vps/${a.vpsId}`)
35447
35447
  }),
@@ -35465,7 +35465,7 @@ var vpsTools = [
35465
35465
  name: "upgrade_vps",
35466
35466
  title: "Upgrade VPS plan",
35467
35467
  kind: "write",
35468
- description: "Move a server to a larger plan in the same family and region. COSTS MONEY (the difference for the days left) and restarts the server. Call get_vps_upgrade_options first: use only a planId it lists, tell the user its price in IDR and that the server restarts, and wait for an explicit yes.",
35468
+ description: "Move a server to a larger plan in the same family and region. COSTS MONEY (the difference for the days left) and restarts the server. planId must be one listed by get_vps_upgrade_options, which also gives the price in IDR; the server restarts during the upgrade. Servers with providerCode 2 only.",
35469
35469
  input: { vpsId, planId: exports_external.string() },
35470
35470
  run: (a, api2) => api2.api("POST", `/vps/${a.vpsId}/upgrade`, { body: { planId: a.planId } })
35471
35471
  }),
@@ -35473,7 +35473,7 @@ var vpsTools = [
35473
35473
  name: "get_vps_upgrade_options",
35474
35474
  title: "VPS upgrade options",
35475
35475
  kind: "read",
35476
- description: "Plans this server can move to (same family and region) with the price to pay now for the days left (IDR). Call it before upgrade_vps.",
35476
+ description: "Plans this server can move to (same family and region) with the price to pay now for the days left (IDR). upgrade_vps accepts only a planId from this list. Servers with providerCode 2 only.",
35477
35477
  input: { vpsId },
35478
35478
  run: (a, api2) => api2.api("GET", `/vps/${a.vpsId}/upgrade-options`)
35479
35479
  }),
@@ -35506,7 +35506,7 @@ var vpsTools = [
35506
35506
  name: "list_firewall_rules",
35507
35507
  title: "List firewall rules",
35508
35508
  kind: "read",
35509
- description: "Inbound firewall rules of a server.",
35509
+ description: "Inbound firewall rules of a server. Servers with their own IP only (providerCode 2 or 3); shared-address servers use port forwards.",
35510
35510
  input: { vpsId },
35511
35511
  run: (a, api2) => api2.api("GET", `/vps/${a.vpsId}/firewall`)
35512
35512
  }),
@@ -35562,7 +35562,7 @@ var vpsTools = [
35562
35562
  name: "remove_vps_port",
35563
35563
  title: "Remove port forward",
35564
35564
  kind: "destructive",
35565
- description: "Remove a port forward (id from list_vps_ports). Whatever reaches the server through it stops working: confirm with the user.",
35565
+ description: "Remove a port forward (id from list_vps_ports). Whatever reaches the server through it stops working.",
35566
35566
  input: { vpsId, allocationId: exports_external.string().uuid().describe("Port forward id from list_vps_ports") },
35567
35567
  run: (a, api2) => api2.api("DELETE", `/vps/${a.vpsId}/ports/${a.allocationId}`)
35568
35568
  }),
@@ -35586,7 +35586,7 @@ var vpsTools = [
35586
35586
  name: "remove_vps_ssh_key",
35587
35587
  title: "Remove SSH key",
35588
35588
  kind: "destructive",
35589
- description: "Remove an SSH key by fingerprint (from list_vps_ssh_keys). Whoever logs in with it loses access; make sure the user keeps another way in (another key or the root password).",
35589
+ description: "Remove an SSH key by fingerprint (from list_vps_ssh_keys). Whoever logs in with it loses access (another key or the root password still works).",
35590
35590
  input: { vpsId, fingerprint: exports_external.string().min(8).max(100).describe("e.g. SHA256:abc…+/= as listed") },
35591
35591
  run: (a, api2) => api2.api("DELETE", `/vps/${a.vpsId}/ssh-keys/${a.fingerprint.trim().replace(/^SHA256:/, "").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "")}`)
35592
35592
  }),
@@ -35595,7 +35595,7 @@ var vpsTools = [
35595
35595
  title: "Turn SSH on / off",
35596
35596
  kind: "write",
35597
35597
  idempotent: true,
35598
- description: "Turn SSH access to the server on or off (no change when it is already in that state). Turning it off locks out every SSH session and key: confirm with the user first. The server must be running.",
35598
+ description: "Turn SSH access to the server on or off (no change when it is already in that state). Turning it off locks out every SSH session and key. The server must be running.",
35599
35599
  input: { vpsId, enabled: exports_external.boolean() },
35600
35600
  run: (a, api2) => api2.api("POST", `/vps/${a.vpsId}/ssh`, { body: { enabled: a.enabled } })
35601
35601
  }),
@@ -35603,7 +35603,7 @@ var vpsTools = [
35603
35603
  name: "list_snapshots",
35604
35604
  title: "List snapshots",
35605
35605
  kind: "read",
35606
- description: "Disk snapshots of a server.",
35606
+ description: "Disk snapshots of a server. Servers with their own IP only (providerCode 2 or 3).",
35607
35607
  input: { vpsId },
35608
35608
  run: (a, api2) => api2.api("GET", `/vps/${a.vpsId}/snapshots`)
35609
35609
  }),
@@ -35619,7 +35619,7 @@ var vpsTools = [
35619
35619
  name: "apply_snapshot",
35620
35620
  title: "Roll back to snapshot",
35621
35621
  kind: "destructive",
35622
- description: "Roll the server's disk back to a snapshot. Everything written since is lost. Get explicit confirmation.",
35622
+ description: "Roll the server's disk back to a snapshot. Everything written since is lost.",
35623
35623
  input: { vpsId, snapshotId: exports_external.string() },
35624
35624
  run: (a, api2) => api2.api("POST", `/vps/${a.vpsId}/snapshots/${a.snapshotId}/apply`)
35625
35625
  }),
@@ -35651,7 +35651,7 @@ var vpsTools = [
35651
35651
  name: "activate_vps_backup",
35652
35652
  title: "Turn on VPS backups",
35653
35653
  kind: "write",
35654
- description: "Turn on daily backups for a running Linux server. COSTS MONEY right away: the whole period (1 or 12 months) is charged from the wallet and there is no dry run. Get priceMonthly / priceYearly from list_backup_plans, tell the user the price in IDR and wait for an explicit yes. The server must be running.",
35654
+ description: "Turn on daily backups for a running Linux server. COSTS MONEY right away: the whole period (1 or 12 months) is charged from the wallet and there is no dry run. Prices (priceMonthly / priceYearly, IDR) are in list_backup_plans. The server must be running.",
35655
35655
  input: {
35656
35656
  vpsId,
35657
35657
  planCode: exports_external.string().max(30).describe("Plan code from list_backup_plans"),
@@ -35678,7 +35678,7 @@ var vpsTools = [
35678
35678
  name: "cancel_vps_backup",
35679
35679
  title: "Cancel VPS backups",
35680
35680
  kind: "destructive",
35681
- description: "Stop renewing the server's backups. Backups keep running until the paid period ends; after that and a grace period the backups are DELETED and can no longer be restored. Confirm with the user. (update_vps_backup autoRenew=true undoes it before the end.)",
35681
+ description: "Stop renewing the server's backups. Backups keep running until the paid period ends; after that and a grace period the backups are DELETED and can no longer be restored. (update_vps_backup autoRenew=true undoes it before the end.)",
35682
35682
  input: { vpsId },
35683
35683
  run: (a, api2) => api2.api("DELETE", `/vps/${a.vpsId}/backup`)
35684
35684
  }),
@@ -35718,7 +35718,7 @@ var vpsTools = [
35718
35718
  name: "restore_vps_backup",
35719
35719
  title: "Restore VPS from backup",
35720
35720
  kind: "destructive",
35721
- description: "Restore from a restore point. mode=full puts the WHOLE disk back to that moment: everything written since is LOST and the server is offline while it restores. mode=files restores 1-50 paths: target=folder (default) puts them in a separate folder on the server, target=inplace OVERWRITES the current files. Name what will be overwritten and get explicit confirmation. Runs in the background: follow it with list_vps_backup_runs.",
35721
+ description: "Restore from a restore point. mode=full puts the WHOLE disk back to that moment: everything written since is LOST and the server is offline while it restores. mode=files restores 1-50 paths: target=folder (default) puts them in a separate folder on the server, target=inplace OVERWRITES the current files. Files at those paths are overwritten. Runs in the background: follow it with list_vps_backup_runs.",
35722
35722
  input: {
35723
35723
  vpsId,
35724
35724
  pointId,
@@ -35740,7 +35740,7 @@ var vpsTools = [
35740
35740
  name: "get_vps_backup_download",
35741
35741
  title: "Get backup download link",
35742
35742
  kind: "read",
35743
- description: "Status of a prepared backup download; when ready, a short-lived url for the user to open (it expires at expiresAt). Give the user the link; do not download it yourself.",
35743
+ description: "Status of a prepared backup download; when ready, a short-lived url for the user to open (it expires at expiresAt). The link is for the user to download in a browser.",
35744
35744
  input: { vpsId, downloadId: exports_external.string() },
35745
35745
  run: (a, api2) => api2.api("GET", `/vps/${a.vpsId}/backup/downloads/${a.downloadId}`)
35746
35746
  })
@@ -35750,7 +35750,7 @@ var vpsTools = [
35750
35750
  var domainId = exports_external.number().int().positive().describe("Domain id (number, from list_my_domains)");
35751
35751
  var hostId = exports_external.number().int().positive().describe("Child nameserver id (from list_child_nameservers)");
35752
35752
  var dryRun2 = exports_external.boolean().optional().describe("true = return the exact price (IDR, VAT included) and the wallet balance after it; nothing is charged or registered");
35753
- var DRY = "Call with dryRun=true first, tell the user the price and walletBalanceAfter, and wait for an explicit yes before the real call.";
35753
+ var DRY = "dryRun=true returns the price and walletBalanceAfter without charging or changing anything.";
35754
35754
  var record3 = exports_external.object({
35755
35755
  name: exports_external.string().describe('"@" for the domain itself, or a label like "www"'),
35756
35756
  type: exports_external.enum(["A", "AAAA", "MX", "MXE", "CNAME", "SPF", "TXT"]),
@@ -35803,7 +35803,7 @@ var domainTools = [
35803
35803
  title: "Update owner details",
35804
35804
  kind: "write",
35805
35805
  idempotent: true,
35806
- description: "Set the account's domain owner (registrant) details the registrar needs: name, phone, addressLine1, city, state, countryCode and postalCode are required for a complete profile (organization, addressLine2 and fax are optional). Send only fields to change. This is personal data: use only what the user gave you, never invent or guess it, and don't repeat it back needlessly. The answer says whether the details are now complete and which fields are still missing (it never echoes them).",
35806
+ description: "Set the account's domain owner (registrant) details the registrar needs: name, phone, addressLine1, city, state, countryCode and postalCode are required for a complete profile (organization, addressLine2 and fax are optional). Send only fields to change. These are personal details of the domain owner, stored as given. The answer says whether the details are now complete and which fields are still missing (it never echoes them).",
35807
35807
  input: {
35808
35808
  name: exports_external.string().min(1).max(255).optional().describe("Owner's full name"),
35809
35809
  organization: exports_external.string().max(255).optional().describe("Company / organization (optional)"),
@@ -35863,7 +35863,7 @@ var domainTools = [
35863
35863
  name: "set_dns_records",
35864
35864
  title: "Replace DNS records",
35865
35865
  kind: "destructive",
35866
- description: "Replace ALL DNS records of the domain with this list. Read list_dns_records first and include every record to keep.",
35866
+ description: "Replace ALL DNS records of the domain with this list. Records not included are deleted (list_dns_records returns the current ones).",
35867
35867
  input: { domainId, records: exports_external.array(record3).min(1) },
35868
35868
  run: (a, api2) => api2.api("POST", `/domains/${a.domainId}/dns`, { body: { records: a.records } })
35869
35869
  }),
@@ -35888,7 +35888,7 @@ var domainTools = [
35888
35888
  name: "enable_whois_privacy",
35889
35889
  title: "Enable WHOIS privacy",
35890
35890
  kind: "write",
35891
- description: "Hide the owner's details in WHOIS. COSTS MONEY (the whois_protection price per year). Confirm with the user.",
35891
+ description: "Hide the owner's details in WHOIS. COSTS MONEY (the whois_protection price per year).",
35892
35892
  input: { domainId },
35893
35893
  run: (a, api2) => api2.api("POST", `/domains/${a.domainId}/whois-protection`)
35894
35894
  }),
@@ -35904,7 +35904,7 @@ var domainTools = [
35904
35904
  name: "whois_lookup",
35905
35905
  title: "WHOIS lookup",
35906
35906
  kind: "read",
35907
- description: "Public WHOIS record of any domain name: registrar, dates, status, nameservers. Use search_domain to check availability instead.",
35907
+ description: "Public WHOIS record of any domain name: registrar, dates, status, nameservers. Availability is checked by search_domain.",
35908
35908
  input: { domain: exports_external.string().describe("e.g. example.com") },
35909
35909
  run: (a, api2) => api2.api("GET", "/domains/whois", { query: { domain: a.domain } })
35910
35910
  }),
@@ -35913,7 +35913,7 @@ var domainTools = [
35913
35913
  title: "Update one DNS record",
35914
35914
  kind: "write",
35915
35915
  idempotent: true,
35916
- description: "Set one DNS record (by name and type) to new content, leaving the other records as they are. Safer than set_dns_records for a single change; read list_dns_records first.",
35916
+ description: "Set one DNS record (by name and type) to new content, leaving the other records as they are. Changes one record and leaves the others as they are (list_dns_records returns record ids).",
35917
35917
  input: { domainId, ...record3.shape },
35918
35918
  run: (a, api2) => api2.api("PUT", `/domains/${a.domainId}/dns`, { body: { name: a.name, type: a.type, content: a.content, ttl: a.ttl } })
35919
35919
  }),
@@ -35962,7 +35962,7 @@ var domainTools = [
35962
35962
  name: "disable_whois_privacy",
35963
35963
  title: "Disable WHOIS privacy",
35964
35964
  kind: "destructive",
35965
- description: "Turn WHOIS privacy off: the owner's name, address, email and phone become PUBLIC in WHOIS (no refund; turning it back on with enable_whois_privacy costs money). Get explicit confirmation.",
35965
+ description: "Turn WHOIS privacy off: the owner's name, address, email and phone become PUBLIC in WHOIS (no refund; turning it back on with enable_whois_privacy costs money).",
35966
35966
  input: { domainId },
35967
35967
  run: (a, api2) => api2.api("DELETE", `/domains/${a.domainId}/whois-protection`)
35968
35968
  })
@@ -35997,10 +35997,10 @@ var message = exports_external.object({
35997
35997
  });
35998
35998
  var dryRun3 = exports_external.boolean().optional().describe("true = return the price (IDR) and the wallet balance after it; nothing is charged or changed");
35999
35999
  var idem2 = exports_external.string().regex(/^[A-Za-z0-9_.:-]{8,128}$/).optional().describe("Idempotency-Key for the real purchase. Generated when omitted; pass the same value when retrying so it is never charged twice");
36000
- var MONEY = "COSTS MONEY from the wallet. Call with dryRun=true first, tell the user the charge (IDR) and walletBalanceAfter, and wait for an explicit yes before the real call.";
36000
+ var MONEY = "COSTS MONEY from the wallet. dryRun=true returns the charge (IDR) and walletBalanceAfter without charging or changing anything.";
36001
36001
  var planCode = exports_external.string().min(1).max(50).describe("Plan code from list_email_plans");
36002
36002
  var folder = exports_external.enum(["inbox", "spam", "archive", "trash"]);
36003
- var AUDIENCE = "Before it goes out, tell the user how many people it reaches: get_email_broadcast for its segmentId/topicId, then the segment's contactCount (list_email_segments) or preview_email_segment with no rules for all contacts (unsubscribed and suppressed addresses are skipped).";
36003
+ var AUDIENCE = "It goes to every contact in the broadcast's segment or topic (unsubscribed and suppressed addresses are skipped); the audience size is the segment's contactCount in list_email_segments, or preview_email_segment with no rules for all contacts.";
36004
36004
  var emailTools = [
36005
36005
  defineTool({
36006
36006
  name: "email_status",
@@ -36069,7 +36069,7 @@ var emailTools = [
36069
36069
  name: "buy_email_inbox_addon",
36070
36070
  title: "Set inbox add-ons",
36071
36071
  kind: "write",
36072
- description: `Set the TOTAL extra mailboxes and extra inbox storage on the active paid plan (absolute numbers, not additions: read get_email_plan first and add to the current values). Increases are charged now, prorated to the plan's end date, then renew with the plan; decreases must still fit what is in use. ${MONEY}`,
36072
+ description: `Set the TOTAL extra mailboxes and extra inbox storage on the active paid plan (absolute numbers, not additions; get_email_plan returns the current values). Increases are charged now, prorated to the plan's end date, then renew with the plan; decreases must still fit what is in use. ${MONEY}`,
36073
36073
  input: {
36074
36074
  projectId,
36075
36075
  extraMailboxes: exports_external.number().int().min(0).max(50).describe("Total extra mailboxes wanted (0-50)"),
@@ -36134,7 +36134,7 @@ var emailTools = [
36134
36134
  name: "add_email_domain",
36135
36135
  title: "Add sending domain",
36136
36136
  kind: "write",
36137
- description: "Add a sending domain; the response lists the DNS records the user must create, then call verify_email_domain.",
36137
+ description: "Add a sending domain; the response lists the DNS records the domain needs; verify_email_domain checks them.",
36138
36138
  input: { projectId, domain: exports_external.string() },
36139
36139
  run: (a, api2) => api2.email("POST", "/domains", { body: { domain: a.domain }, project: a.projectId })
36140
36140
  }),
@@ -36198,7 +36198,7 @@ var emailTools = [
36198
36198
  name: "delete_email_domain",
36199
36199
  title: "Delete sending domain",
36200
36200
  kind: "destructive",
36201
- description: "Remove a sending domain: email can no longer be sent from its addresses. Confirm with the user.",
36201
+ description: "Remove a sending domain: email can no longer be sent from its addresses.",
36202
36202
  input: { projectId, domainId: exports_external.string() },
36203
36203
  run: (a, api2) => api2.email("DELETE", `/domains/${a.domainId}`, { project: a.projectId })
36204
36204
  }),
@@ -36244,7 +36244,7 @@ var emailTools = [
36244
36244
  name: "delete_email_template",
36245
36245
  title: "Delete email template",
36246
36246
  kind: "destructive",
36247
- description: "Delete a template. Code that still sends with its templateId will fail. Confirm with the user.",
36247
+ description: "Delete a template. Code that still sends with its templateId will fail.",
36248
36248
  input: { projectId, templateId: exports_external.string() },
36249
36249
  run: (a, api2) => api2.email("DELETE", `/templates/${a.templateId}`, { project: a.projectId })
36250
36250
  }),
@@ -36300,7 +36300,7 @@ var emailTools = [
36300
36300
  name: "delete_email_contact",
36301
36301
  title: "Delete email contact",
36302
36302
  kind: "destructive",
36303
- description: "Delete a contact and its history. To stop emailing someone, prefer unsubscribe_email_contact (keeps the opt-out on record). Confirm with the user.",
36303
+ description: "Delete a contact and its history. unsubscribe_email_contact stops emails and keeps the opt-out on record; this deletes the contact.",
36304
36304
  input: { projectId, contactId: uid("Contact") },
36305
36305
  run: (a, api2) => api2.email("DELETE", `/contacts/${a.contactId}`, { project: a.projectId })
36306
36306
  }),
@@ -36357,7 +36357,7 @@ var emailTools = [
36357
36357
  name: "delete_email_segment",
36358
36358
  title: "Delete segment",
36359
36359
  kind: "destructive",
36360
- description: "Delete a segment (its contacts are kept). Confirm with the user.",
36360
+ description: "Delete a segment (its contacts are kept).",
36361
36361
  input: { projectId, segmentId: uid("Segment") },
36362
36362
  run: (a, api2) => api2.email("DELETE", `/segments/${a.segmentId}`, { project: a.projectId })
36363
36363
  }),
@@ -36397,7 +36397,7 @@ var emailTools = [
36397
36397
  name: "delete_email_topic",
36398
36398
  title: "Delete topic",
36399
36399
  kind: "destructive",
36400
- description: "Delete a topic and every contact's subscription to it. Confirm with the user.",
36400
+ description: "Delete a topic and every contact's subscription to it.",
36401
36401
  input: { projectId, topicId: uid("Topic") },
36402
36402
  run: (a, api2) => api2.email("DELETE", `/topics/${a.topicId}`, { project: a.projectId })
36403
36403
  }),
@@ -36507,7 +36507,7 @@ var emailTools = [
36507
36507
  name: "delete_email_suppression",
36508
36508
  title: "Remove suppression",
36509
36509
  kind: "destructive",
36510
- description: "Allow an address to be emailed again. Only when the person asked for it or the bounce was fixed: emailing addresses that bounced or complained hurts the project's sending reputation. Confirm with the user.",
36510
+ description: "Allow an address to be emailed again. Only when the person asked for it or the bounce was fixed: emailing addresses that bounced or complained hurts the project's sending reputation.",
36511
36511
  input: { projectId, suppressionId: exports_external.string() },
36512
36512
  run: (a, api2) => api2.email("DELETE", `/suppressions/${a.suppressionId}`, { project: a.projectId })
36513
36513
  }),
@@ -36523,7 +36523,7 @@ var emailTools = [
36523
36523
  name: "create_email_webhook",
36524
36524
  title: "Create email webhook",
36525
36525
  kind: "write",
36526
- description: "POST email events to an HTTPS URL. The response holds the signing secret ONCE: tell the user to store it (e.g. as a secret variable), don't print it elsewhere.",
36526
+ description: "POST email events to an HTTPS URL. The response holds the signing secret ONCE: it is not shown again.",
36527
36527
  input: {
36528
36528
  projectId,
36529
36529
  url: exports_external.string().min(8).max(2000),
@@ -36535,7 +36535,7 @@ var emailTools = [
36535
36535
  name: "delete_email_webhook",
36536
36536
  title: "Delete email webhook",
36537
36537
  kind: "destructive",
36538
- description: "Stop sending events to a webhook URL. Confirm with the user.",
36538
+ description: "Stop sending events to a webhook URL.",
36539
36539
  input: { projectId, webhookId: uid("Webhook") },
36540
36540
  run: (a, api2) => api2.email("DELETE", `/webhooks/${a.webhookId}`, { project: a.projectId })
36541
36541
  }),
@@ -36584,7 +36584,7 @@ var emailTools = [
36584
36584
  name: "delete_inbox_address",
36585
36585
  title: "Delete inbox address",
36586
36586
  kind: "destructive",
36587
- description: "Delete a receiving address: mail to it is no longer accepted (messages already received are kept). Confirm with the user.",
36587
+ description: "Delete a receiving address: mail to it is no longer accepted (messages already received are kept).",
36588
36588
  input: { projectId, addressId: uid("Address") },
36589
36589
  run: (a, api2) => api2.email("DELETE", `/inbound/addresses/${a.addressId}`, { project: a.projectId })
36590
36590
  }),
@@ -36620,7 +36620,7 @@ var emailTools = [
36620
36620
  name: "reply_inbox_message",
36621
36621
  title: "Reply to inbox message",
36622
36622
  kind: "write",
36623
- description: "Send a threaded reply to a received message (counts against the sending quota). Show the user the reply text before sending.",
36623
+ description: "Send a threaded reply to a received message (counts against the sending quota). The reply is sent from the inbox address.",
36624
36624
  input: {
36625
36625
  projectId,
36626
36626
  messageId: uid("Message"),
@@ -36635,7 +36635,7 @@ var emailTools = [
36635
36635
  name: "delete_inbox_message",
36636
36636
  title: "Delete inbox message",
36637
36637
  kind: "destructive",
36638
- description: "Delete a received message permanently. Confirm with the user.",
36638
+ description: "Delete a received message permanently.",
36639
36639
  input: { projectId, messageId: uid("Message") },
36640
36640
  run: (a, api2) => api2.email("DELETE", `/inbound/messages/${a.messageId}`, { project: a.projectId })
36641
36641
  })
@@ -36716,7 +36716,7 @@ var databaseTools = [
36716
36716
  name: "delete_database_branch",
36717
36717
  title: "Delete database branch",
36718
36718
  kind: "destructive",
36719
- description: "Delete an environment's branch and its data. The primary (production) branch cannot be deleted. Confirm with the user.",
36719
+ description: "Delete an environment's branch and its data. The primary (production) branch cannot be deleted.",
36720
36720
  input: { databaseId, environmentId: exports_external.string().uuid() },
36721
36721
  run: (a, api2) => api2.api("DELETE", `/databases/${a.databaseId}/branches/${a.environmentId}`)
36722
36722
  }),
@@ -36757,7 +36757,7 @@ var databaseTools = [
36757
36757
  name: "suspend_database",
36758
36758
  title: "Suspend database",
36759
36759
  kind: "destructive",
36760
- description: "Stop the database's compute (connections fail until resumed). Confirm with the user.",
36760
+ description: "Stop the database's compute (connections fail until resumed).",
36761
36761
  input: { databaseId },
36762
36762
  run: (a, api2) => api2.api("POST", `/databases/${a.databaseId}/suspend`)
36763
36763
  }),
@@ -36818,7 +36818,7 @@ var databaseTools = [
36818
36818
  name: "browse_database_table",
36819
36819
  title: "Browse table rows",
36820
36820
  kind: "read",
36821
- description: "Rows of a table, a page at a time (limit up to 200, offset to page). Read-only. Rows are the customer's data: don't repeat sensitive columns (passwords, tokens) unless the user asks.",
36821
+ description: "Rows of a table, a page at a time (limit up to 200, offset to page). Read-only. Rows are returned as stored, including any sensitive columns.",
36822
36822
  input: {
36823
36823
  databaseId,
36824
36824
  table: exports_external.string().min(1).max(63),
@@ -36832,7 +36832,7 @@ var databaseTools = [
36832
36832
  name: "query_database",
36833
36833
  title: "Query database (read-only)",
36834
36834
  kind: "read",
36835
- description: "Run a read-only SQL statement (SELECT, EXPLAIN, SHOW…) in a read-only transaction; up to 200 rows. Use $1, $2… placeholders with params. Statements that change data are refused: use execute_database_sql.",
36835
+ description: "Run a read-only SQL statement (SELECT, EXPLAIN, SHOW…) in a read-only transaction; up to 200 rows. Use $1, $2… placeholders with params. Statements that change data are refused (execute_database_sql runs those).",
36836
36836
  input: { databaseId, sql: exports_external.string().min(1).max(1e4), params: exports_external.array(exports_external.any()).max(100).optional(), environmentId: environmentId.optional() },
36837
36837
  run: (a, api2) => api2.api("POST", `/databases/${a.databaseId}/query`, { body: { sql: a.sql, params: a.params, environmentId: a.environmentId } })
36838
36838
  }),
@@ -36840,7 +36840,7 @@ var databaseTools = [
36840
36840
  name: "classify_database_sql",
36841
36841
  title: "Classify SQL (no run)",
36842
36842
  kind: "read",
36843
- description: "What a SQL statement is (command, e.g. select / update / drop) and whether it writes, WITHOUT running it. Call it before execute_database_sql to tell the user exactly what will change; readOnly statements go to query_database.",
36843
+ description: "What a SQL statement is (command, e.g. select / update / drop) and whether it writes, WITHOUT running it. It reports what a statement would change before execute_database_sql runs it; readOnly statements can run with query_database.",
36844
36844
  input: { databaseId, sql: exports_external.string().min(1).max(1e4) },
36845
36845
  run: (a, api2) => api2.api("POST", `/databases/${a.databaseId}/query/classify`, { body: { sql: a.sql } })
36846
36846
  }),
@@ -36848,7 +36848,7 @@ var databaseTools = [
36848
36848
  name: "execute_database_sql",
36849
36849
  title: "Execute SQL (writes)",
36850
36850
  kind: "destructive",
36851
- description: "Run a statement that changes data or schema (INSERT, UPDATE, DELETE, CREATE, ALTER, DROP…). First call classify_database_sql to see what the statement does (a read-only one belongs in query_database). Then show the statement, what it changes and the target environment to the user and get explicit confirmation; prefer a staging branch for migrations.",
36851
+ description: "Run a statement that changes data or schema (INSERT, UPDATE, DELETE, CREATE, ALTER, DROP…). classify_database_sql reports what a statement does without running it. It runs on the chosen environment's branch.",
36852
36852
  input: { databaseId, sql: exports_external.string().min(1).max(1e4), params: exports_external.array(exports_external.any()).max(100).optional(), environmentId: environmentId.optional() },
36853
36853
  run: (a, api2) => api2.api("POST", `/databases/${a.databaseId}/query`, { body: { sql: a.sql, params: a.params, environmentId: a.environmentId, allowWrite: true } })
36854
36854
  })
@@ -36938,7 +36938,7 @@ var accountTools = [
36938
36938
  title: "Mark all notifications read",
36939
36939
  kind: "write",
36940
36940
  idempotent: true,
36941
- description: "Mark every unread notification as read (a project key: its project's only). Ask the user first: they may want to read them in the dashboard.",
36941
+ description: "Mark every unread notification as read (a project key: its project's only). Marks every notification as read.",
36942
36942
  input: {},
36943
36943
  run: (_a3, api2) => api2.api("POST", "/account/notifications/read-all")
36944
36944
  }),
@@ -36976,7 +36976,7 @@ var accountTools = [
36976
36976
  name: "create_support_ticket",
36977
36977
  title: "Open support ticket",
36978
36978
  kind: "write",
36979
- description: `Open a ticket with Helipod support (at most 5 an hour; reply to an open ticket instead of opening another). Show the user the subject and message before sending, and never include passwords, API keys or other secrets. ${ACCOUNT_KEY}`,
36979
+ description: `Open a ticket with Helipod support (at most 5 an hour; replies go to an open ticket with reply_support_ticket). The subject and message are sent to Helipod support as written. ${ACCOUNT_KEY}`,
36980
36980
  input: {
36981
36981
  subject: exports_external.string().min(3).max(255),
36982
36982
  category: exports_external.enum(["billing", "technical", "feature_request", "other"]),
@@ -36998,7 +36998,7 @@ var accountTools = [
36998
36998
  title: "Close support ticket",
36999
36999
  kind: "write",
37000
37000
  idempotent: true,
37001
- description: `Close a support ticket once the issue is solved (a closed ticket takes no more replies). Ask the user first. ${ACCOUNT_KEY}`,
37001
+ description: `Close a support ticket once the issue is solved (a closed ticket takes no more replies). ${ACCOUNT_KEY}`,
37002
37002
  input: { ticketId: uid2("Ticket") },
37003
37003
  run: (a, api2) => api2.api("POST", `/account/tickets/${a.ticketId}/close`)
37004
37004
  })
@@ -37055,7 +37055,7 @@ var aiTools = [
37055
37055
  name: "revoke_ai_key",
37056
37056
  title: "Revoke AI key",
37057
37057
  kind: "destructive",
37058
- description: "Revoke an AI key permanently: every app using it stops working at once and it cannot be restored (a new key must be made in the dashboard and deployed). Name the key and get explicit confirmation.",
37058
+ description: "Revoke an AI key permanently: every app using it stops working at once and it cannot be restored (a new key must be made in the dashboard and deployed).",
37059
37059
  input: { keyId: exports_external.string().uuid().describe("AI key id from list_ai_keys") },
37060
37060
  run: (a, api2) => api2.api("DELETE", `/ai/keys/${a.keyId}`)
37061
37061
  }),
@@ -37063,7 +37063,7 @@ var aiTools = [
37063
37063
  name: "topup_ai_balance",
37064
37064
  title: "Top up AI balance",
37065
37065
  kind: "write",
37066
- description: `Move money from the wallet to the AI balance, by pack (packId from get_ai_overview, may include a bonus) or by amount (IDR, at least minTopup). COSTS MONEY from the wallet. Call with dryRun=true first, tell the user the amount, bonus and balances after, and wait for an explicit yes before the real call. ${ACCOUNT_KEY2}`,
37066
+ description: `Move money from the wallet to the AI balance, by pack (packId from get_ai_overview, may include a bonus) or by amount (IDR, at least minTopup). COSTS MONEY from the wallet. dryRun=true returns the amount, bonus and balances after without charging. ${ACCOUNT_KEY2}`,
37067
37067
  input: {
37068
37068
  packId: exports_external.string().min(1).max(64).optional(),
37069
37069
  amount: exports_external.number().min(1).max(1e9).optional().describe("IDR"),
@@ -37085,7 +37085,7 @@ var aiTools = [
37085
37085
  title: "Set AI auto top-up",
37086
37086
  kind: "write",
37087
37087
  idempotent: true,
37088
- description: `Automatic top-up: when the AI balance falls below threshold (IDR), amount (IDR) is moved from the wallet. Enabling it COSTS MONEY later, without asking each time: call with dryRun=true first, tell the user the current and new settings, and wait for an explicit yes. enabled=false turns it off. ${ACCOUNT_KEY2}`,
37088
+ description: `Automatic top-up: when the AI balance falls below threshold (IDR), amount (IDR) is moved from the wallet. Enabling it COSTS MONEY later: top-ups then run automatically. dryRun=true returns the current and new settings without changing them. enabled=false turns it off. ${ACCOUNT_KEY2}`,
37089
37089
  input: {
37090
37090
  enabled: exports_external.boolean(),
37091
37091
  threshold: exports_external.number().min(1).optional().describe("Top up when the AI balance is below this (IDR)"),
@@ -37126,12 +37126,13 @@ var generalTools = [
37126
37126
  ];
37127
37127
 
37128
37128
  // src/server.ts
37129
- var VERSION = "0.5.2";
37129
+ var VERSION = "0.5.4";
37130
37130
  var INSTRUCTIONS = `Helipod is a cloud platform (Indonesia): containers, managed Postgres databases, VPS, domains, email and an AI gateway, billed from a prepaid wallet in Rupiah.
37131
37131
  - Start with list_projects to find projects and environment ids. Account tools (get_wallet, invoices, statements, notifications, get_project_activity, support tickets) cover the account; AI tools (list_ai_models, get_ai_overview, get_ai_usage, AI keys, top-ups) cover the AI gateway.
37132
37132
  - Anything that costs money (create/deploy/scale services, resize volumes, upgrade a database plan, create/renew/upgrade VPS, VPS backups, register/renew/transfer domains, email plans and inbox add-ons, AI top-ups and auto top-up): call it with dryRun=true first (or the price lookup when it has no dry run), tell the user the cost in IDR and the wallet balance after, and wait for an explicit yes before the real call. Never treat silence or an earlier general OK as a yes.
37133
37133
  - Destructive tools (delete, terminate, reinstall, rollback, restore a backup, replace DNS, revoke a key, remove an SSH key or port forward, send a broadcast, execute_database_sql): confirm with the user and name what will be lost. Before execute_database_sql, run classify_database_sql.
37134
37134
  - Email: when a project has no email yet (email_status shows activated false) or its plan ended, start it with buy_email_plan (dryRun first; the FREE plan costs nothing, still confirm). That also sets email up for the project; then add and verify a sending domain.
37135
+ - Before replacing all DNS records (set_dns_records), read list_dns_records and keep every record the user still needs. Before sending or scheduling a broadcast, tell the user how many contacts it reaches. Before deleting or replacing code, files or variables, read the current value. After renaming a service, fix the variable references listed in warnings.
37135
37136
  - Databases: get_database_connection returns a password; put it in a secret variable (DATABASE_URL) instead of code or chat.
37136
37137
  - Deploys and VPS actions run in the background: poll get_deployment / get_vps until they settle; on a failed deploy read get_deployment_logs.
37137
37138
  - Never print secrets (passwords, secret variable values, secret files) unless the user asks for them. Domain owner details are personal data: use only what the user gave.