@amerged/ohmyhost-mcp 0.1.19 → 0.1.21

package/src/packages/contracts/operation-failure.ts

@@ -1,7 +1,7 @@
 const failures = {
   operation_abandoned: [
     "The operation stopped renewing its execution lease and was ended.",
-    "Inspect project status and deployment diagnostics before creating a fresh plan. Keep this operation ID; the expired execution cannot resume.",
+    "Inspect project status and, when this operation names a deployment_id, its diagnostics with 'ohmyhost deployment logs --project PROJECT_ULID --deployment DEPLOYMENT_ULID --follow --json' or MCP deployment_logs before creating a fresh plan. Keep this operation ID; the expired execution cannot resume.",
   ],
   database_write_rejected: [
     "The database rejected this write; it was not committed.",
@@ -66,7 +66,7 @@ const failures = {
   ],
   build_failed: [
     "The build did not produce a verified deployable artifact.",
-    "Inspect the deployment build diagnostics and verify the install and build commands for the admitted commit. Correct the reported failure before planning a new deployment.",
+    "Read the BUILD_FAILED diagnostic of this operation's deployment_id with 'ohmyhost deployment logs --project PROJECT_ULID --deployment DEPLOYMENT_ULID --follow --json' or MCP deployment_logs; its excerpt is the tail of the install and build output. Correct that failure and verify the commands for the admitted commit before planning a new deployment.",
   ],
   insufficient_organization_credits: [
     "The organization does not have sufficient available credits for this operation.",
@@ -82,7 +82,7 @@ const failures = {
   ],
   runtime_candidate_failed: [
     "The deployed candidate failed its runtime checks.",
-    "Inspect deployment runtime diagnostics, required secrets and the health-check route before creating a new deployment plan.",
+    "Read the HEALTH_CHECK_FAILED diagnostic of this operation's deployment_id with 'ohmyhost deployment logs --project PROJECT_ULID --deployment DEPLOYMENT_ULID --follow --json' or MCP deployment_logs. Its route must answer 2xx to a cookieless GET without a redirect; status_code and, for owners, excerpt show what it answered. Fix that, often a missing secret or a redirect, then plan a new deployment.",
   ],
   runtime_candidate_rejected: [
     "The runtime rejected the built Worker script.",

package/src/packages/sdk-ts/generated/index.ts

@@ -45,12 +45,14 @@ export {
   getOrganizationAccount,
   getOrganizationCredits,
   getOrganizationCreditUsage,
+  getOrganizationReferral,
   getPaidProjectDomain,
   getProject,
   getProjectContext,
   getProjectCreditBudget,
   getProjectExport,
   getProjectHandleAvailability,
+  getProjectPoweredByFlag,
   getProjectSource,
   getProjectSourceAutoDeploy,
   getProjectStatus,
@@ -87,6 +89,7 @@ export {
   setProjectCreditBudget,
   setProjectDevAccessMode,
   setProjectNotes,
+  setProjectPoweredByFlag,
   streamDeploymentLogs,
   streamOperationEvents,
   submitContactRequest,
@@ -364,6 +367,11 @@ export type {
   GetOrganizationCreditUsageErrors,
   GetOrganizationCreditUsageResponse,
   GetOrganizationCreditUsageResponses,
+  GetOrganizationReferralData,
+  GetOrganizationReferralError,
+  GetOrganizationReferralErrors,
+  GetOrganizationReferralResponse,
+  GetOrganizationReferralResponses,
   GetPaidProjectDomainData,
   GetPaidProjectDomainError,
   GetPaidProjectDomainErrors,
@@ -392,6 +400,11 @@ export type {
   GetProjectHandleAvailabilityErrors,
   GetProjectHandleAvailabilityResponse,
   GetProjectHandleAvailabilityResponses,
+  GetProjectPoweredByFlagData,
+  GetProjectPoweredByFlagError,
+  GetProjectPoweredByFlagErrors,
+  GetProjectPoweredByFlagResponse,
+  GetProjectPoweredByFlagResponses,
   GetProjectResponse,
   GetProjectResponses,
   GetProjectSourceAutoDeployData,
@@ -493,6 +506,7 @@ export type {
   OrganizationAccount,
   OrganizationCredits,
   OrganizationCreditUsage,
+  OrganizationReferral,
   PaidDomain,
   PaidDomainPlan,
   PaidDomainRequest,
@@ -522,6 +536,7 @@ export type {
   PlanProjectDeletionErrors,
   PlanProjectDeletionResponse,
   PlanProjectDeletionResponses,
+  PoweredByFlag,
   PrepareManagedMailWebhookData,
   PrepareManagedMailWebhookError,
   PrepareManagedMailWebhookErrors,
@@ -623,6 +638,7 @@ export type {
   RotateProjectDevShareLinkResponses,
   SecretName,
   SetDevAccessModeRequest,
+  SetPoweredByFlagRequest,
   SetProjectCreditBudgetData,
   SetProjectCreditBudgetError,
   SetProjectCreditBudgetErrors,
@@ -639,6 +655,11 @@ export type {
   SetProjectNotesErrors,
   SetProjectNotesResponse,
   SetProjectNotesResponses,
+  SetProjectPoweredByFlagData,
+  SetProjectPoweredByFlagError,
+  SetProjectPoweredByFlagErrors,
+  SetProjectPoweredByFlagResponse,
+  SetProjectPoweredByFlagResponses,
   Sha256Digest,
   SourceAutoDeploy,
   SourceDeploymentId,

package/src/packages/sdk-ts/generated/sdk.gen.ts

@@ -106,6 +106,8 @@ import type {
   GetOrganizationCreditsResponses,
   GetOrganizationCreditUsageErrors,
   GetOrganizationCreditUsageResponses,
+  GetOrganizationReferralErrors,
+  GetOrganizationReferralResponses,
   GetPaidProjectDomainErrors,
   GetPaidProjectDomainResponses,
   GetProjectContextErrors,
@@ -117,6 +119,8 @@ import type {
   GetProjectExportResponses,
   GetProjectHandleAvailabilityErrors,
   GetProjectHandleAvailabilityResponses,
+  GetProjectPoweredByFlagErrors,
+  GetProjectPoweredByFlagResponses,
   GetProjectResponses,
   GetProjectSourceAutoDeployErrors,
   GetProjectSourceAutoDeployResponses,
@@ -192,6 +196,7 @@ import type {
   RotateProjectDevShareLinkErrors,
   RotateProjectDevShareLinkResponses,
   SetDevAccessModeRequest,
+  SetPoweredByFlagRequest,
   SetProjectCreditBudgetErrors,
   SetProjectCreditBudgetRequest,
   SetProjectCreditBudgetResponses,
@@ -199,6 +204,8 @@ import type {
   SetProjectDevAccessModeResponses,
   SetProjectNotesErrors,
   SetProjectNotesResponses,
+  SetProjectPoweredByFlagErrors,
+  SetProjectPoweredByFlagResponses,
   StreamDeploymentLogsErrors,
   StreamDeploymentLogsResponse,
   StreamDeploymentLogsResponses,
@@ -375,6 +382,48 @@ export const getGithubOrganizationConnection = <ThrowOnError extends boolean = t
   });
 };
 
+/**
+ * Read the workspace's referral link
+ *
+ * Any member may share it. A new user whose first workspace comes from this link starts with 30 days of Paid access and 1,000 credits; that workspace's first payment gives this workspace 1,000 credits and 30 more days of granted Paid access.
+ */
+export const getOrganizationReferral = <ThrowOnError extends boolean = true>(
+  parameters: {
+    "X-Request-Id"?: string;
+    organization_id: Ulid;
+  },
+  options?: Options<never, ThrowOnError>,
+): RequestResult<
+  GetOrganizationReferralResponses,
+  GetOrganizationReferralErrors,
+  ThrowOnError,
+  "data"
+> => {
+  const params = buildClientParams(
+    [parameters],
+    [
+      {
+        args: [
+          { in: "headers", key: "X-Request-Id" },
+          { in: "path", key: "organization_id" },
+        ],
+      },
+    ],
+  );
+  return (options?.client ?? client).get<
+    GetOrganizationReferralResponses,
+    GetOrganizationReferralErrors,
+    ThrowOnError,
+    "data"
+  >({
+    responseStyle: "data",
+    security: [{ scheme: "bearer", type: "http" }],
+    url: "/v1/organizations/{organization_id}/referral",
+    ...options,
+    ...params,
+  });
+};
+
 /**
  * Read effective plan and monthly versus one-time credit balance
  */
@@ -1974,6 +2023,99 @@ export const setProjectDevAccessMode = <ThrowOnError extends boolean = true>(
   });
 };
 
+/**
+ * Read the "Powered by ohmyho.st" flag
+ *
+ * Whether the production site shows the opt-in flag for the current owner organization.
+ */
+export const getProjectPoweredByFlag = <ThrowOnError extends boolean = true>(
+  parameters: {
+    "X-Request-Id"?: string;
+    project_id: Ulid;
+  },
+  options?: Options<never, ThrowOnError>,
+): RequestResult<
+  GetProjectPoweredByFlagResponses,
+  GetProjectPoweredByFlagErrors,
+  ThrowOnError,
+  "data"
+> => {
+  const params = buildClientParams(
+    [parameters],
+    [
+      {
+        args: [
+          { in: "headers", key: "X-Request-Id" },
+          { in: "path", key: "project_id" },
+        ],
+      },
+    ],
+  );
+  return (options?.client ?? client).get<
+    GetProjectPoweredByFlagResponses,
+    GetProjectPoweredByFlagErrors,
+    ThrowOnError,
+    "data"
+  >({
+    responseStyle: "data",
+    security: [{ scheme: "bearer", type: "http" }],
+    url: "/v1/projects/{project_id}/powered-by-flag",
+    ...options,
+    ...params,
+  });
+};
+
+/**
+ * Show or hide the "Powered by ohmyho.st" flag
+ *
+ * Owner-only. The production site shows a small flag on its right edge that links to ohmyho.st. While it is on, a Free workspace may connect its own domain to this project and the custom-hostname fee is waived; Paid periods receive bonus credits. Hiding it is refused while a Free workspace's domain depends on it. A retry with the same Idempotency-Key and body returns the first result without switching again; a changed request under a used key returns idempotency_key_reused (409).
+ */
+export const setProjectPoweredByFlag = <ThrowOnError extends boolean = true>(
+  parameters: {
+    "X-Request-Id"?: string;
+    "Idempotency-Key": string;
+    project_id: Ulid;
+    setPoweredByFlagRequest: SetPoweredByFlagRequest;
+  },
+  options?: Options<never, ThrowOnError>,
+): RequestResult<
+  SetProjectPoweredByFlagResponses,
+  SetProjectPoweredByFlagErrors,
+  ThrowOnError,
+  "data"
+> => {
+  const params = buildClientParams(
+    [parameters],
+    [
+      {
+        args: [
+          { in: "headers", key: "X-Request-Id" },
+          { in: "headers", key: "Idempotency-Key" },
+          { in: "path", key: "project_id" },
+          { key: "setPoweredByFlagRequest", map: "body" },
+        ],
+      },
+    ],
+  );
+  return (options?.client ?? client).put<
+    SetProjectPoweredByFlagResponses,
+    SetProjectPoweredByFlagErrors,
+    ThrowOnError,
+    "data"
+  >({
+    responseStyle: "data",
+    security: [{ scheme: "bearer", type: "http" }],
+    url: "/v1/projects/{project_id}/powered-by-flag",
+    ...options,
+    ...params,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers,
+      ...params.headers,
+    },
+  });
+};
+
 /**
  * Create a single-use dev access ticket
  *

package/src/packages/sdk-ts/generated/types.gen.ts

@@ -569,13 +569,17 @@ export type DeploymentDiagnostic = {
   trace_id?: string;
   duration_ms?: number;
   /**
-   * The sanitized tail of the customer's own install/build output, newest lines last. Present only on a BUILD_FAILED diagnostic; terminal escapes and control characters are removed before storage.
+   * The customer's own output with control characters removed before storage: on BUILD_FAILED the tail of the install/build output (newest lines last), on HEALTH_CHECK_FAILED the head of the body the health check was answered with (at most 4096 characters, never a header). A running application holds its environment's secrets and this answer is not scanned for them, so, like a query of the project's database, a HEALTH_CHECK_FAILED excerpt is returned only to an owner of the project; never answer a health check with a secret.
    */
   excerpt?: string;
   /**
-   * Whether earlier build output was omitted from excerpt. Present exactly when excerpt is present.
+   * Whether output was omitted from excerpt (earlier build output, or the rest of the health answer). Present exactly when excerpt is present.
    */
   excerpt_truncated?: boolean;
+  /**
+   * The HTTP status the health check was answered with; present only on HEALTH_CHECK_FAILED. The probe is a cookieless GET of route that follows no redirect, so a 3xx is unhealthy too.
+   */
+  status_code?: number;
   occurred_at: string;
 };
 
@@ -670,6 +674,24 @@ export type SetDevAccessModeRequest = {
   mode: "protected" | "public";
 };
 
+export type OrganizationReferral = {
+  organization_id: Ulid;
+  referral_url: string;
+};
+
+export type SetPoweredByFlagRequest = {
+  enabled: boolean;
+};
+
+export type PoweredByFlag = {
+  project_id: Ulid;
+  enabled: boolean;
+  /**
+   * When the current owner switched the flag on; null while it is hidden.
+   */
+  enabled_at: string | null;
+};
+
 export type DevAccessState = {
   project_id: Ulid;
   mode: "protected" | "public";
@@ -1076,6 +1098,7 @@ export type ProblemDetails = {
     | "cloudflare_authorization_closed"
     | "project_notes_conflict"
     | "project_export_not_ready"
+    | "powered_by_flag_required"
     | "interactive_login_required"
     | "api_key_creation_uncertain"
     | "api_key_permissions_unavailable"
@@ -1098,6 +1121,10 @@ export type Operation = {
    * The active operation holding this queued operation's project mutation claim.
    */
   blocking_operation_id?: Ulid;
+  /**
+   * The deployment this operation created (deploy, promotion or rollback), in every state. After a failure, read its diagnostics with deployment logs.
+   */
+  deployment_id?: Ulid;
   id: Ulid;
   state: "queued" | "running" | "succeeded" | "failed" | "cancelled";
   created_at: string;
@@ -1641,6 +1668,61 @@ export type GetGithubOrganizationConnectionResponses = {
 export type GetGithubOrganizationConnectionResponse =
   GetGithubOrganizationConnectionResponses[keyof GetGithubOrganizationConnectionResponses];
 
+export type GetOrganizationReferralData = {
+  body?: never;
+  headers?: {
+    /**
+     * Optional caller-provided correlation identifier.
+     */
+    "X-Request-Id"?: string;
+  };
+  path: {
+    organization_id: Ulid;
+  };
+  query?: never;
+  url: "/v1/organizations/{organization_id}/referral";
+};
+
+export type GetOrganizationReferralErrors = {
+  /**
+   * The request failed.
+   */
+  400: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  401: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  403: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  404: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  429: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  503: ProblemDetails;
+};
+
+export type GetOrganizationReferralError =
+  GetOrganizationReferralErrors[keyof GetOrganizationReferralErrors];
+
+export type GetOrganizationReferralResponses = {
+  /**
+   * The workspace's referral link.
+   */
+  200: OrganizationReferral;
+};
+
+export type GetOrganizationReferralResponse =
+  GetOrganizationReferralResponses[keyof GetOrganizationReferralResponses];
+
 export type GetOrganizationAccountData = {
   body?: never;
   path: {
@@ -3751,6 +3833,122 @@ export type SetProjectDevAccessModeResponses = {
 export type SetProjectDevAccessModeResponse =
   SetProjectDevAccessModeResponses[keyof SetProjectDevAccessModeResponses];
 
+export type GetProjectPoweredByFlagData = {
+  body?: never;
+  headers?: {
+    /**
+     * Optional caller-provided correlation identifier.
+     */
+    "X-Request-Id"?: string;
+  };
+  path: {
+    /**
+     * Project identifier.
+     */
+    project_id: Ulid;
+  };
+  query?: never;
+  url: "/v1/projects/{project_id}/powered-by-flag";
+};
+
+export type GetProjectPoweredByFlagErrors = {
+  /**
+   * The request failed.
+   */
+  400: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  401: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  403: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  404: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  503: ProblemDetails;
+};
+
+export type GetProjectPoweredByFlagError =
+  GetProjectPoweredByFlagErrors[keyof GetProjectPoweredByFlagErrors];
+
+export type GetProjectPoweredByFlagResponses = {
+  /**
+   * Current flag state.
+   */
+  200: PoweredByFlag;
+};
+
+export type GetProjectPoweredByFlagResponse =
+  GetProjectPoweredByFlagResponses[keyof GetProjectPoweredByFlagResponses];
+
+export type SetProjectPoweredByFlagData = {
+  body: SetPoweredByFlagRequest;
+  headers: {
+    /**
+     * Optional caller-provided correlation identifier.
+     */
+    "X-Request-Id"?: string;
+    /**
+     * Identifies one mutation and its canonical request payload.
+     */
+    "Idempotency-Key": string;
+  };
+  path: {
+    /**
+     * Project identifier.
+     */
+    project_id: Ulid;
+  };
+  query?: never;
+  url: "/v1/projects/{project_id}/powered-by-flag";
+};
+
+export type SetProjectPoweredByFlagErrors = {
+  /**
+   * The request failed.
+   */
+  400: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  401: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  403: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  404: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  409: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  503: ProblemDetails;
+};
+
+export type SetProjectPoweredByFlagError =
+  SetProjectPoweredByFlagErrors[keyof SetProjectPoweredByFlagErrors];
+
+export type SetProjectPoweredByFlagResponses = {
+  /**
+   * Current flag state.
+   */
+  200: PoweredByFlag;
+};
+
+export type SetProjectPoweredByFlagResponse =
+  SetProjectPoweredByFlagResponses[keyof SetProjectPoweredByFlagResponses];
+
 export type CreateProjectDevAccessTicketData = {
   body?: never;
   headers?: {