@hyperstar/mcp 0.1.0

package/dist/http.d.ts

@@ -0,0 +1,24 @@
+import { type HyperstarMcpConfig } from "./config.js";
+export type JsonValue = null | boolean | number | string | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+export type JsonObject = {
+    readonly [key: string]: JsonValue;
+};
+export declare class HyperstarApiError extends Error {
+    readonly status: number;
+    readonly detail: JsonValue;
+    readonly retryable: boolean;
+    constructor(status: number, detail: JsonValue);
+}
+export type HyperstarClient = {
+    readonly get: (path: string, query?: URLSearchParams) => Promise<JsonValue>;
+    readonly post: (path: string, body?: JsonObject, headers?: Record<string, string>) => Promise<JsonValue>;
+    readonly patch: (path: string, body?: JsonObject) => Promise<JsonValue>;
+};
+type Fetcher = (input: URL, init: RequestInit) => Promise<Response>;
+export declare function createHyperstarClient(options: {
+    readonly config: HyperstarMcpConfig;
+    readonly fetcher?: Fetcher | undefined;
+}): HyperstarClient;
+export {};

package/dist/http.js

@@ -0,0 +1,131 @@
+import { redactSecret } from "./config.js";
+export class HyperstarApiError extends Error {
+    status;
+    detail;
+    retryable;
+    constructor(status, detail) {
+        super(typeof detail === "string"
+            ? detail
+            : `Hyperstar API request failed with status ${status}`);
+        this.name = "HyperstarApiError";
+        this.status = status;
+        this.detail = detail;
+        this.retryable = status === 429 || status >= 500;
+    }
+}
+export function createHyperstarClient(options) {
+    const fetcher = options.fetcher ?? fetch;
+    async function request(method, path, body, extraHeaders = {}, query) {
+        const url = buildApiUrl(options.config.apiBaseUrl, path);
+        if (query !== undefined) {
+            url.search = query.toString();
+        }
+        const baseHeaders = {
+            ...extraHeaders,
+            accept: "application/json",
+        };
+        const secretsToRedact = [];
+        let retryCliAccessToken;
+        if (options.config.authMode === "service_account") {
+            baseHeaders["x-hyperstar-api-key"] = options.config.apiKey;
+            secretsToRedact.push(options.config.apiKey);
+        }
+        else {
+            const selectedOrganizationId = await options.config.workspaceSelection.getSelectedOrganizationId();
+            assertSelectedWorkspace(selectedOrganizationId, path);
+            const accessToken = await options.config.accessTokenProvider.getAccessToken();
+            baseHeaders.Authorization = `Bearer ${accessToken}`;
+            secretsToRedact.push(accessToken, `Bearer ${accessToken}`);
+            if (selectedOrganizationId !== undefined) {
+                baseHeaders["X-Hyperstar-Organization-Id"] = selectedOrganizationId;
+            }
+            retryCliAccessToken =
+                options.config.accessTokenProvider.refreshAccessToken;
+        }
+        const init = { method, headers: baseHeaders };
+        if (body !== undefined) {
+            baseHeaders["content-type"] = "application/json";
+            init.body = JSON.stringify(body);
+        }
+        let response = await fetcher(url, init);
+        const payload = await readJson(response);
+        if (response.status === 401 && retryCliAccessToken !== undefined) {
+            const refreshedAccessToken = await retryCliAccessToken();
+            const retryHeaders = {
+                ...baseHeaders,
+                Authorization: `Bearer ${refreshedAccessToken}`,
+            };
+            secretsToRedact.push(refreshedAccessToken, `Bearer ${refreshedAccessToken}`);
+            response = await fetcher(url, { ...init, headers: retryHeaders });
+            const retryPayload = await readJson(response);
+            if (response.ok) {
+                return retryPayload;
+            }
+            throw new HyperstarApiError(response.status, redactSecrets(extractDetail(retryPayload), secretsToRedact));
+        }
+        if (!response.ok) {
+            throw new HyperstarApiError(response.status, redactSecrets(extractDetail(payload), secretsToRedact));
+        }
+        return payload;
+    }
+    return {
+        get: (path, query) => request("GET", path, undefined, {}, query),
+        post: (path, body, headers) => request("POST", path, body, headers),
+        patch: (path, body) => request("PATCH", path, body),
+    };
+}
+function buildApiUrl(apiBaseUrl, path) {
+    if (!path.startsWith("/") || path.startsWith("//") || path.includes("\\")) {
+        throw new Error("Hyperstar API path must be root-relative");
+    }
+    const baseUrl = new URL(apiBaseUrl);
+    const url = new URL(path, `${apiBaseUrl}/`);
+    if (url.origin !== baseUrl.origin) {
+        throw new Error("Hyperstar API path must preserve the configured origin");
+    }
+    return url;
+}
+/** Require an explicit workspace for CLI-authenticated Product API routes. */
+function assertSelectedWorkspace(selectedOrganizationId, path) {
+    if (selectedOrganizationId !== undefined || path === "/v1/workspaces") {
+        return;
+    }
+    throw new Error("Run `hyperstar workspaces use <workspace_id>` before calling Product API routes");
+}
+async function readJson(response) {
+    const text = await response.text();
+    if (text.trim().length === 0) {
+        return null;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function extractDetail(payload) {
+    if (isJsonObject(payload) && "detail" in payload) {
+        return payload.detail;
+    }
+    return payload;
+}
+function isJsonObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function redactSecrets(value, secrets) {
+    if (typeof value === "string") {
+        return secrets.reduce((redacted, secret) => redacted.split(secret).join(redactSecret(secret)), value);
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => redactSecrets(item, secrets));
+    }
+    if (isJsonObject(value)) {
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [
+            redactSecrets(key, secrets),
+            redactSecrets(item, secrets),
+        ]));
+    }
+    return value;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig } from "./config.js";
+import { createHyperstarMcpServer } from "./server.js";
+/** Start the stdio MCP server process. */
+async function main() {
+    const config = loadConfig();
+    const server = createHyperstarMcpServer(config);
+    await server.connect(new StdioServerTransport());
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`Failed to start Hyperstar MCP server: ${message}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,0CAA0C;AAC1C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,OAAO,IAAI,CAAC,CAAC;IAC3E,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,61 @@
+import { z } from "zod";
+export type JsonValue = null | boolean | number | string | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+export type JsonObject = {
+    readonly [key: string]: JsonValue;
+};
+export declare const JsonValueSchema: z.ZodType<JsonValue>;
+export declare const JsonObjectSchema: z.ZodType<JsonObject>;
+export declare const WhoamiResponseSchema: z.ZodObject<{
+    actor_type: z.ZodEnum<{
+        service_account: "service_account";
+        user: "user";
+    }>;
+    user_id: z.ZodNullable<z.ZodString>;
+    service_account_id: z.ZodNullable<z.ZodString>;
+    organization_id: z.ZodString;
+    scopes: z.ZodArray<z.ZodString>;
+    capabilities: z.ZodObject<{
+        search: z.ZodBoolean;
+        campaigns_read: z.ZodBoolean;
+        campaigns_write: z.ZodBoolean;
+        bulk_email: z.ZodBoolean;
+        inbox_read: z.ZodBoolean;
+        inbox_write: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type WhoamiResponse = z.infer<typeof WhoamiResponseSchema>;
+export declare const WorkspaceSchema: z.ZodObject<{
+    organization_id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const WorkspaceListResponseSchema: z.ZodObject<{
+    workspaces: z.ZodArray<z.ZodObject<{
+        organization_id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const SearchCreatedResponseSchema: z.ZodObject<{
+    search_id: z.ZodUUID;
+}, z.core.$strip>;
+export declare const SearchResultsResponseSchema: z.ZodObject<{
+    creators: z.ZodArray<z.ZodType<JsonObject, unknown, z.core.$ZodTypeInternals<JsonObject, unknown>>>;
+    total: z.ZodNumber;
+    offset: z.ZodNumber;
+    limit: z.ZodNumber;
+}, z.core.$strip>;
+export declare const CampaignCreatorsResponseSchema: z.ZodObject<{
+    influencers: z.ZodArray<z.ZodType<JsonObject, unknown, z.core.$ZodTypeInternals<JsonObject, unknown>>>;
+    total: z.ZodNumber;
+    limit: z.ZodNumber;
+    offset: z.ZodNumber;
+}, z.core.$strip>;
+export declare const CampaignImportResponseSchema: z.ZodType<JsonObject, unknown, z.core.$ZodTypeInternals<JsonObject, unknown>>;
+export declare const BulkEmailReadinessResponseSchema: z.ZodType<JsonObject, unknown, z.core.$ZodTypeInternals<JsonObject, unknown>>;
+export declare const BulkEmailJobResponseSchema: z.ZodType<JsonObject, unknown, z.core.$ZodTypeInternals<JsonObject, unknown>>;
+export declare const InboxThreadPageResponseSchema: z.ZodType<JsonObject, unknown, z.core.$ZodTypeInternals<JsonObject, unknown>>;
+export declare const InboxAggregatesResponseSchema: z.ZodType<JsonObject, unknown, z.core.$ZodTypeInternals<JsonObject, unknown>>;
+export declare const InboxWorkspaceStateResponseSchema: z.ZodType<JsonObject, unknown, z.core.$ZodTypeInternals<JsonObject, unknown>>;

package/dist/schemas.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+export const JsonValueSchema = z.lazy(() => z.union([
+    z.null(),
+    z.boolean(),
+    z.number().finite(),
+    z.string(),
+    z.array(JsonValueSchema),
+    JsonObjectSchema,
+]));
+export const JsonObjectSchema = z.record(z.string(), JsonValueSchema);
+const NonNegativeIntegerSchema = z.number().int().min(0);
+const PositiveIntegerSchema = z.number().int().min(1);
+export const WhoamiResponseSchema = z.object({
+    actor_type: z.enum(["user", "service_account"]),
+    user_id: z.string().nullable(),
+    service_account_id: z.string().nullable(),
+    organization_id: z.string(),
+    scopes: z.array(z.string()),
+    capabilities: z.object({
+        search: z.boolean(),
+        campaigns_read: z.boolean(),
+        campaigns_write: z.boolean(),
+        bulk_email: z.boolean(),
+        inbox_read: z.boolean(),
+        inbox_write: z.boolean(),
+    }),
+});
+export const WorkspaceSchema = z.object({
+    organization_id: z.string().min(1),
+    name: z.string().min(1).optional(),
+    role: z.string().min(1).optional(),
+});
+export const WorkspaceListResponseSchema = z.object({
+    workspaces: z.array(WorkspaceSchema),
+});
+export const SearchCreatedResponseSchema = z.object({
+    search_id: z.uuid(),
+});
+export const SearchResultsResponseSchema = z.object({
+    creators: z.array(JsonObjectSchema),
+    total: NonNegativeIntegerSchema,
+    offset: NonNegativeIntegerSchema,
+    limit: PositiveIntegerSchema,
+});
+export const CampaignCreatorsResponseSchema = z.object({
+    influencers: z.array(JsonObjectSchema),
+    total: NonNegativeIntegerSchema,
+    limit: PositiveIntegerSchema,
+    offset: NonNegativeIntegerSchema,
+});
+export const CampaignImportResponseSchema = JsonObjectSchema;
+export const BulkEmailReadinessResponseSchema = JsonObjectSchema;
+export const BulkEmailJobResponseSchema = JsonObjectSchema;
+export const InboxThreadPageResponseSchema = JsonObjectSchema;
+export const InboxAggregatesResponseSchema = JsonObjectSchema;
+export const InboxWorkspaceStateResponseSchema = JsonObjectSchema;
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { HyperstarMcpConfig } from "./config.js";
+/** Create the Hyperstar MCP server and register HTTP-backed workflow tools. */
+export declare function createHyperstarMcpServer(config: HyperstarMcpConfig): McpServer;

package/dist/server.js

@@ -0,0 +1,12 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { createHyperstarClient } from "./http.js";
+import { registerHyperstarTools } from "./tools.js";
+/** Create the Hyperstar MCP server and register HTTP-backed workflow tools. */
+export function createHyperstarMcpServer(config) {
+    const server = new McpServer({ name: "hyperstar", version: "0.1.0" });
+    registerHyperstarTools(server, createHyperstarClient({ config }), config.authMode === "cli"
+        ? { workspaceSelection: config.workspaceSelection }
+        : {});
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,+EAA+E;AAC/E,MAAM,UAAU,wBAAwB,CACtC,MAA0B;IAE1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACtE,sBAAsB,CACpB,MAAM,EACN,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC,EACjC,MAAM,CAAC,QAAQ,KAAK,KAAK;QACvB,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,EAAE;QACnD,CAAC,CAAC,EAAE,CACP,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tool-inputs.d.ts

@@ -0,0 +1,254 @@
+import { z } from "zod";
+import type { JsonObject } from "./http.js";
+export declare const SearchCreatorsInputSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        semantic: "semantic";
+        reference: "reference";
+    }>;
+    platform: z.ZodEnum<{
+        tiktok: "tiktok";
+        instagram: "instagram";
+    }>;
+    region: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+    filters: z.ZodOptional<z.ZodType<import("./schemas.js").JsonObject, unknown, z.core.$ZodTypeInternals<import("./schemas.js").JsonObject, unknown>>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    reference: z.ZodOptional<z.ZodType<import("./schemas.js").JsonObject, unknown, z.core.$ZodTypeInternals<import("./schemas.js").JsonObject, unknown>>>;
+    sort_by: z.ZodOptional<z.ZodEnum<{
+        relevance: "relevance";
+        matchScore: "matchScore";
+        follower_count: "follower_count";
+        engagement_rate: "engagement_rate";
+        avg_views: "avg_views";
+        views_growth_rate: "views_growth_rate";
+        gmv: "gmv";
+        gpm: "gpm";
+    }>>;
+    sort_order: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+}, z.core.$strict>;
+export declare const WhoamiInputSchema: z.ZodObject<{}, z.core.$strict>;
+export declare const ListWorkspacesInputSchema: z.ZodObject<{}, z.core.$strict>;
+export declare const SelectWorkspaceInputSchema: z.ZodObject<{
+    organization_id: z.ZodString;
+}, z.core.$strict>;
+export declare const WorkflowGuideInputSchema: z.ZodObject<{}, z.core.$strict>;
+export declare const GetSearchResultsInputSchema: z.ZodObject<{
+    search_id: z.ZodUUID;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const SaveSearchResultsToCampaignInputSchema: z.ZodObject<{
+    campaign_id: z.ZodNumber;
+    search_id: z.ZodUUID;
+    excluded_origin_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    reference_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const CampaignCreatorsInputSchema: z.ZodObject<{
+    campaign_id: z.ZodNumber;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const CheckBulkEmailReadinessInputSchema: z.ZodObject<{
+    campaign_id: z.ZodNumber;
+    campaign_creator_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    campaign_creator_selection: z.ZodOptional<z.ZodObject<{
+        workflow_filter: z.ZodOptional<z.ZodEnum<{
+            email: "email";
+            content: "content";
+            all: "all";
+            email_not_sent: "email_not_sent";
+            email_sent: "email_sent";
+            replied: "replied";
+            negotiating: "negotiating";
+            rejected_hold: "rejected_hold";
+            rejected: "rejected";
+            hold: "hold";
+            contract: "contract";
+            contracted: "contracted";
+            draft: "draft";
+            final_approved: "final_approved";
+            posted: "posted";
+        }>>;
+        outreach_stage: z.ZodOptional<z.ZodString>;
+        platform: z.ZodOptional<z.ZodEnum<{
+            tiktok: "tiktok";
+            instagram: "instagram";
+        }>>;
+        country: z.ZodOptional<z.ZodString>;
+        has_video: z.ZodOptional<z.ZodBoolean>;
+        source_type: z.ZodOptional<z.ZodEnum<{
+            saved_list: "saved_list";
+            file_upload: "file_upload";
+            manual_add: "manual_add";
+            form_submission: "form_submission";
+            discovery_search: "discovery_search";
+        }>>;
+        search: z.ZodOptional<z.ZodString>;
+        excluded_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const StartBulkEmailInputSchema: z.ZodObject<{
+    campaign_id: z.ZodNumber;
+    subject: z.ZodString;
+    body_text: z.ZodString;
+    from_email: z.ZodOptional<z.ZodString>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    campaign_creator_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    campaign_creator_selection: z.ZodOptional<z.ZodObject<{
+        workflow_filter: z.ZodOptional<z.ZodEnum<{
+            email: "email";
+            content: "content";
+            all: "all";
+            email_not_sent: "email_not_sent";
+            email_sent: "email_sent";
+            replied: "replied";
+            negotiating: "negotiating";
+            rejected_hold: "rejected_hold";
+            rejected: "rejected";
+            hold: "hold";
+            contract: "contract";
+            contracted: "contracted";
+            draft: "draft";
+            final_approved: "final_approved";
+            posted: "posted";
+        }>>;
+        outreach_stage: z.ZodOptional<z.ZodString>;
+        platform: z.ZodOptional<z.ZodEnum<{
+            tiktok: "tiktok";
+            instagram: "instagram";
+        }>>;
+        country: z.ZodOptional<z.ZodString>;
+        has_video: z.ZodOptional<z.ZodBoolean>;
+        source_type: z.ZodOptional<z.ZodEnum<{
+            saved_list: "saved_list";
+            file_upload: "file_upload";
+            manual_add: "manual_add";
+            form_submission: "form_submission";
+            discovery_search: "discovery_search";
+        }>>;
+        search: z.ZodOptional<z.ZodString>;
+        excluded_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strict>>;
+    form_id: z.ZodOptional<z.ZodNumber>;
+    form_language: z.ZodOptional<z.ZodEnum<{
+        en: "en";
+        ko: "ko";
+        jp: "jp";
+    }>>;
+    idempotency_key: z.ZodString;
+}, z.core.$strict>;
+export declare const BulkEmailJobInputSchema: z.ZodObject<{
+    job_id: z.ZodString;
+}, z.core.$strict>;
+export declare const InboxFiltersInputSchema: z.ZodObject<{
+    platforms: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        tiktok: "tiktok";
+        instagram: "instagram";
+        buyer: "buyer";
+    }>>>;
+    campaign_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    outreach_stages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    label_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    bulk_job_ids: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+    unread_only: z.ZodOptional<z.ZodBoolean>;
+    actionable_only: z.ZodOptional<z.ZodBoolean>;
+    attention: z.ZodOptional<z.ZodBoolean>;
+    archived: z.ZodOptional<z.ZodBoolean>;
+    snoozed: z.ZodOptional<z.ZodBoolean>;
+    has_attachments: z.ZodOptional<z.ZodBoolean>;
+    search: z.ZodOptional<z.ZodString>;
+    last_message_at_from: z.ZodOptional<z.ZodISODateTime>;
+    last_message_at_to: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strict>;
+export declare const ListInboxThreadsInputSchema: z.ZodObject<{
+    platforms: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        tiktok: "tiktok";
+        instagram: "instagram";
+        buyer: "buyer";
+    }>>>;
+    campaign_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    outreach_stages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    label_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    bulk_job_ids: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+    unread_only: z.ZodOptional<z.ZodBoolean>;
+    actionable_only: z.ZodOptional<z.ZodBoolean>;
+    attention: z.ZodOptional<z.ZodBoolean>;
+    archived: z.ZodOptional<z.ZodBoolean>;
+    snoozed: z.ZodOptional<z.ZodBoolean>;
+    has_attachments: z.ZodOptional<z.ZodBoolean>;
+    search: z.ZodOptional<z.ZodString>;
+    last_message_at_from: z.ZodOptional<z.ZodISODateTime>;
+    last_message_at_to: z.ZodOptional<z.ZodISODateTime>;
+    sort_field: z.ZodOptional<z.ZodEnum<{
+        last_message_at: "last_message_at";
+    }>>;
+    sort_descending: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const UpdateInboxThreadStateInputSchema: z.ZodObject<{
+    platform: z.ZodEnum<{
+        tiktok: "tiktok";
+        instagram: "instagram";
+        buyer: "buyer";
+    }>;
+    thread_id: z.ZodNumber;
+    archived: z.ZodOptional<z.ZodBoolean>;
+    snoozed_until: z.ZodOptional<z.ZodISODateTime>;
+    clear_snooze: z.ZodOptional<z.ZodBoolean>;
+    starred: z.ZodOptional<z.ZodBoolean>;
+    read_state: z.ZodOptional<z.ZodEnum<{
+        read: "read";
+        unread: "unread";
+    }>>;
+    clear_read_state: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const SendInboxReplyInputSchema: z.ZodObject<{
+    platform: z.ZodEnum<{
+        tiktok: "tiktok";
+        instagram: "instagram";
+        buyer: "buyer";
+    }>;
+    thread_id: z.ZodNumber;
+    subject: z.ZodString;
+    body_text: z.ZodString;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    campaign_creator_id: z.ZodOptional<z.ZodNumber>;
+    idempotency_key: z.ZodString;
+}, z.core.$strict>;
+type SearchCreatorsInput = z.infer<typeof SearchCreatorsInputSchema>;
+type ListWorkspacesInput = z.infer<typeof ListWorkspacesInputSchema>;
+type SelectWorkspaceInput = z.infer<typeof SelectWorkspaceInputSchema>;
+type WorkflowGuideInput = z.infer<typeof WorkflowGuideInputSchema>;
+type GetSearchResultsInput = z.infer<typeof GetSearchResultsInputSchema>;
+type SaveSearchResultsToCampaignInput = z.infer<typeof SaveSearchResultsToCampaignInputSchema>;
+type CampaignCreatorsInput = z.infer<typeof CampaignCreatorsInputSchema>;
+type CheckBulkEmailReadinessInput = z.infer<typeof CheckBulkEmailReadinessInputSchema>;
+type StartBulkEmailInput = z.infer<typeof StartBulkEmailInputSchema>;
+type BulkEmailJobInput = z.infer<typeof BulkEmailJobInputSchema>;
+type InboxFiltersInput = z.infer<typeof InboxFiltersInputSchema>;
+type ListInboxThreadsInput = z.infer<typeof ListInboxThreadsInputSchema>;
+type UpdateInboxThreadStateInput = z.infer<typeof UpdateInboxThreadStateInputSchema>;
+type SendInboxReplyInput = z.infer<typeof SendInboxReplyInputSchema>;
+export type HyperstarToolHandlers = {
+    readonly hyperstarWhoami: () => Promise<JsonObject>;
+    readonly listWorkspaces: (input?: ListWorkspacesInput) => Promise<JsonObject>;
+    readonly selectWorkspace: (input: SelectWorkspaceInput) => Promise<JsonObject>;
+    readonly getHyperstarWorkflowGuide: (input?: WorkflowGuideInput) => Promise<JsonObject>;
+    readonly searchCreators: (input: SearchCreatorsInput) => Promise<JsonObject>;
+    readonly getSearchResults: (input: GetSearchResultsInput) => Promise<JsonObject>;
+    readonly saveSearchResultsToCampaign: (input: SaveSearchResultsToCampaignInput) => Promise<JsonObject>;
+    readonly listCampaignCreators: (input: CampaignCreatorsInput) => Promise<JsonObject>;
+    readonly checkBulkEmailReadiness: (input: CheckBulkEmailReadinessInput) => Promise<JsonObject>;
+    readonly startBulkEmail: (input: StartBulkEmailInput) => Promise<JsonObject>;
+    readonly getBulkEmailJob: (input: BulkEmailJobInput) => Promise<JsonObject>;
+    readonly listInboxThreads: (input: ListInboxThreadsInput) => Promise<JsonObject>;
+    readonly getInboxAggregates: (input: InboxFiltersInput) => Promise<JsonObject>;
+    readonly updateInboxThreadState: (input: UpdateInboxThreadStateInput) => Promise<JsonObject>;
+    readonly sendInboxReply: (input: SendInboxReplyInput) => Promise<JsonObject>;
+};
+export {};