@hyperstar/mcp 0.1.0

package/dist/workspaces.js

@@ -0,0 +1,77 @@
+import { WorkspaceListResponseSchema } from "./schemas.js";
+const CLI_WORKFLOW_SEQUENCE = [
+    "list_workspaces",
+    "select_workspace",
+    "hyperstar_whoami",
+    "search_creators",
+    "save_search_results_to_campaign",
+    "list_campaign_creators",
+    "check_bulk_email_readiness",
+    "WARNING: start_bulk_email and send_inbox_reply perform real sends.",
+];
+const SERVICE_ACCOUNT_WORKFLOW_SEQUENCE = [
+    "list_workspaces",
+    "hyperstar_whoami",
+    "search_creators",
+    "save_search_results_to_campaign",
+    "list_campaign_creators",
+    "check_bulk_email_readiness",
+    "WARNING: start_bulk_email and send_inbox_reply perform real sends.",
+];
+const CLI_SAFETY_NOTES = [
+    "Run list_workspaces and select_workspace before Product API calls that require workspace scope.",
+    "Run hyperstar_whoami after selecting a workspace to confirm the authenticated principal.",
+    "check_bulk_email_readiness is the final dry-run gate before any bulk send.",
+    "start_bulk_email and send_inbox_reply perform real sends.",
+];
+const SERVICE_ACCOUNT_SAFETY_NOTES = [
+    "Service-account auth is already workspace-scoped; select_workspace is only for local browser CLI auth.",
+    "Run list_workspaces and hyperstar_whoami before workflow tools to confirm the authenticated workspace.",
+    "check_bulk_email_readiness is the final dry-run gate before any bulk send.",
+    "start_bulk_email and send_inbox_reply perform real sends.",
+];
+/** List workspaces through the Product API workspace route. */
+export async function listAvailableWorkspaces(client) {
+    const payload = WorkspaceListResponseSchema.parse(await client.get("/v1/workspaces"));
+    return {
+        workspaces: payload.workspaces.map(workspaceJson),
+    };
+}
+/** Persist a selected workspace after verifying the Product API lists it. */
+export async function selectAvailableWorkspace(client, organizationId, options = {}) {
+    if (options.workspaceSelection === undefined) {
+        throw new Error("select_workspace requires local browser CLI auth");
+    }
+    const payload = WorkspaceListResponseSchema.parse(await client.get("/v1/workspaces"));
+    const selected = payload.workspaces.find((workspace) => workspace.organization_id === organizationId);
+    if (selected === undefined) {
+        throw new Error(`Workspace ${organizationId} is not available`);
+    }
+    await options.workspaceSelection.setSelectedOrganizationId(organizationId);
+    return {
+        selected_organization_id: organizationId,
+        workspace: workspaceJson(selected),
+    };
+}
+/** Return the recommended Hyperstar agent workflow and send-safety notes. */
+export function getHyperstarWorkflowGuide(options = {}) {
+    if (options.workspaceSelection === undefined) {
+        return {
+            sequence: [...SERVICE_ACCOUNT_WORKFLOW_SEQUENCE],
+            safety_notes: [...SERVICE_ACCOUNT_SAFETY_NOTES],
+        };
+    }
+    return {
+        sequence: [...CLI_WORKFLOW_SEQUENCE],
+        safety_notes: [...CLI_SAFETY_NOTES],
+    };
+}
+/** Convert a parsed workspace into JSON without undefined optional fields. */
+function workspaceJson(workspace) {
+    return {
+        organization_id: workspace.organization_id,
+        ...(workspace.name === undefined ? {} : { name: workspace.name }),
+        ...(workspace.role === undefined ? {} : { role: workspace.role }),
+    };
+}
+//# sourceMappingURL=workspaces.js.map

package/dist/workspaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaces.js","sourceRoot":"","sources":["../src/workspaces.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAM3D,MAAM,qBAAqB,GAAG;IAC5B,iBAAiB;IACjB,kBAAkB;IAClB,kBAAkB;IAClB,iBAAiB;IACjB,iCAAiC;IACjC,wBAAwB;IACxB,4BAA4B;IAC5B,oEAAoE;CAC5D,CAAC;AAEX,MAAM,iCAAiC,GAAG;IACxC,iBAAiB;IACjB,kBAAkB;IAClB,iBAAiB;IACjB,iCAAiC;IACjC,wBAAwB;IACxB,4BAA4B;IAC5B,oEAAoE;CAC5D,CAAC;AAEX,MAAM,gBAAgB,GAAG;IACvB,iGAAiG;IACjG,0FAA0F;IAC1F,4EAA4E;IAC5E,2DAA2D;CACnD,CAAC;AAEX,MAAM,4BAA4B,GAAG;IACnC,wGAAwG;IACxG,wGAAwG;IACxG,4EAA4E;IAC5E,2DAA2D;CACnD,CAAC;AAEX,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAuB;IAEvB,MAAM,OAAO,GAAG,2BAA2B,CAAC,KAAK,CAC/C,MAAM,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CACnC,CAAC;IACF,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAuB,EACvB,cAAsB,EACtB,UAAgC,EAAE;IAElC,IAAI,OAAO,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,OAAO,GAAG,2BAA2B,CAAC,KAAK,CAC/C,MAAM,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CACnC,CAAC;IACF,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CACtC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,eAAe,KAAK,cAAc,CAC5D,CAAC;IACF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,aAAa,cAAc,mBAAmB,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,OAAO,CAAC,kBAAkB,CAAC,yBAAyB,CAAC,cAAc,CAAC,CAAC;IAE3E,OAAO;QACL,wBAAwB,EAAE,cAAc;QACxC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC;KACnC,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,yBAAyB,CACvC,UAAgC,EAAE;IAElC,IAAI,OAAO,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;QAC7C,OAAO;YACL,QAAQ,EAAE,CAAC,GAAG,iCAAiC,CAAC;YAChD,YAAY,EAAE,CAAC,GAAG,4BAA4B,CAAC;SAChD,CAAC;IACJ,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,CAAC,GAAG,qBAAqB,CAAC;QACpC,YAAY,EAAE,CAAC,GAAG,gBAAgB,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,SAAS,aAAa,CAAC,SAItB;IACC,OAAO;QACL,eAAe,EAAE,SAAS,CAAC,eAAe;QAC1C,GAAG,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;QACjE,GAAG,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;KAClE,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@hyperstar/mcp",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "hyperstar-mcp": "./dist/index.js",
+    "hyperstar": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepack": "npm run build",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "prettier": "^3.6.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.2"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  }
+}