helipod-mcp 0.5.2 → 0.5.3
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/http.js +60 -59
- package/dist/index.js +60 -59
- package/dist/stdio.js +60 -59
- package/package.json +1 -1
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:
|
|
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.
|
|
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.
|
|
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,
|
|
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.
|
|
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.
|
|
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
|
|
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.
|
|
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).
|
|
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).
|
|
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}$/),
|
|
@@ -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
|
|
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.
|
|
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.
|
|
35436
|
+
description: "Login details: host, user (root, or Administrator on Windows), port, protocol (ssh or rdp) and password. The response contains the root password.",
|
|
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.
|
|
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.
|
|
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.",
|
|
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).
|
|
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.",
|
|
35477
35477
|
input: { vpsId },
|
|
35478
35478
|
run: (a, api2) => api2.api("GET", `/vps/${a.vpsId}/upgrade-options`)
|
|
35479
35479
|
}),
|
|
@@ -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
|
|
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
|
|
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
|
|
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
|
}),
|
|
@@ -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.
|
|
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.
|
|
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.
|
|
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.
|
|
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).
|
|
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 = "
|
|
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.
|
|
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.
|
|
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).
|
|
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.
|
|
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.
|
|
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).
|
|
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.
|
|
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 = "
|
|
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
|
|
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
|
|
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.
|
|
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.
|
|
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.
|
|
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).
|
|
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.
|
|
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.
|
|
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:
|
|
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.
|
|
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).
|
|
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).
|
|
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.
|
|
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.
|
|
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).
|
|
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
|
|
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
|
|
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.
|
|
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…).
|
|
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).
|
|
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;
|
|
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).
|
|
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).
|
|
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.
|
|
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
|
|
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.
|
|
37129
|
+
var VERSION = "0.5.3";
|
|
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.
|