mindsim 0.1.0 → 0.1.2

package/src/cli.ts

@@ -1,24 +1,63 @@
 #!/usr/bin/env node
 
-import { Command } from "commander";
+import fs from "node:fs";
+import path from "node:path";
+import { Command, Option } from "commander";
 import { login } from "./auth";
+import { MindSim } from "./index";
 import { checkForUpdates, getPackageVersion, updateSdk } from "./version";
 
 const program = new Command();
 
+/**
+ * Helper to instantiate the SDK or fail gracefully if not authenticated
+ */
+const getSDK = () => {
+  try {
+    return new MindSim();
+  } catch (error) {
+    console.error("❌ Authentication required.");
+    console.error("Please run 'mindsim auth' or set MINDSIM_API_KEY environment variable.");
+    process.exit(1);
+  }
+};
+
+/**
+ * Helper to print JSON output
+ */
+const printOutput = (data: any) => {
+  console.log(JSON.stringify(data, null, 2));
+};
+
+/**
+ * Helper to handle errors uniformly
+ */
+const handleError = (error: any) => {
+  if (error.response) {
+    // Axios error
+    console.error(`❌ API Error (${error.response.status}):`);
+    console.error(JSON.stringify(error.response.data, null, 2));
+  } else {
+    console.error("❌ Error:", error.message || error);
+  }
+  process.exit(1);
+};
+
 const main = async () => {
-  program.name("mindsim").description("CLI for Mindsim SDK").version(getPackageVersion()); // Use the reusable extractor
+  program.name("mindsim").description("CLI for Mindsim SDK").version(getPackageVersion());
+
+  // ==========================================
+  // CORE COMMANDS
+  // ==========================================
 
   program
     .command("version")
     .description("Output your current MindSim CLI version and check for updates")
     .action(async () => {
-      // When explicitly asking for version, be verbose about update status
       console.log(getPackageVersion());
       await checkForUpdates(true);
     });
 
-  // The Auth Command
   program
     .command("auth")
     .description("Login to Mindsim via browser")
@@ -27,7 +66,6 @@ const main = async () => {
       await login();
     });
 
-  // NEW: The Update Command
   program
     .command("update")
     .description("Auto-update the MindSim SDK to the latest version")
@@ -35,6 +73,437 @@ const main = async () => {
       await updateSdk();
     });
 
+  // ==========================================
+  // MINDS RESOURCES
+  // ==========================================
+  const minds = program.command("minds").description("Manage digital minds");
+
+  minds
+    .command("list")
+    .description("List all minds")
+    .option("-t, --tags <tags>", "Comma-separated list of tags to filter by")
+    .action(async (options) => {
+      try {
+        const client = getSDK();
+        const tagList = options.tags ? options.tags.split(",") : undefined;
+        const result = await client.minds.list({ tags: tagList });
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  minds
+    .command("get")
+    .description("Get details of a specific mind")
+    .argument("<mindId>", "ID of the mind")
+    .action(async (mindId) => {
+      try {
+        const client = getSDK();
+        const result = await client.minds.get(mindId);
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  minds
+    .command("create")
+    .description("Create a new mind")
+    .requiredOption("-n, --name <name>", "Name of the mind")
+    .option("-e, --email <email>", "Email associated with the mind")
+    .option("-t, --tags <tags>", "Comma-separated list of tags")
+    .action(async (options) => {
+      try {
+        const client = getSDK();
+        const tagList = options.tags ? options.tags.split(",") : undefined;
+        const result = await client.minds.create({
+          name: options.name,
+          email: options.email,
+          tags: tagList,
+        });
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  minds
+    .command("update")
+    .description("Update an existing mind")
+    .argument("<mindId>", "ID of the mind to update")
+    .option("-n, --name <name>", "New name")
+    .option("-e, --email <email>", "New email")
+    .option("-t, --tags <tags>", "New comma-separated list of tags (replaces existing)")
+    .action(async (mindId, options) => {
+      try {
+        const client = getSDK();
+        const tagList = options.tags ? options.tags.split(",") : undefined;
+        const result = await client.minds.update(mindId, {
+          name: options.name,
+          email: options.email,
+          tags: tagList,
+        });
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  minds
+    .command("delete")
+    .description("Delete a mind")
+    .argument("<mindId>", "ID of the mind to delete")
+    .action(async (mindId) => {
+      try {
+        const client = getSDK();
+        const result = await client.minds.delete(mindId);
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  minds
+    .command("search")
+    .description("Search for minds by query string")
+    .argument("<query>", "Search query (e.g., email or name)")
+    .action(async (query) => {
+      try {
+        const client = getSDK();
+        const result = await client.minds.search({ query });
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  minds
+    .command("set-tags")
+    .description("Replace tags for a specific mind")
+    .argument("<mindId>", "ID of the mind")
+    .requiredOption("-t, --tags <tags>", "Comma-separated list of tags")
+    .action(async (mindId, options) => {
+      try {
+        const client = getSDK();
+        const tagList = options.tags ? options.tags.split(",") : [];
+        const result = await client.minds.setTags(mindId, { tags: tagList });
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  // ==========================================
+  // SNAPSHOTS RESOURCES
+  // ==========================================
+  const snapshots = program.command("snapshots").description("Manage mind snapshots/training data");
+
+  snapshots
+    .command("list")
+    .description("List snapshots for a specific mind")
+    .argument("<mindId>", "ID of the mind")
+    .action(async (mindId) => {
+      try {
+        const client = getSDK();
+        const result = await client.snapshots.list(mindId);
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  snapshots
+    .command("get")
+    .description("Get snapshot detail")
+    .argument("<mindId>", "ID of the mind")
+    .argument("<snapshotId>", "ID of the snapshot")
+    .option("--transcript", "Include transcript")
+    .option("--psychometrics", "Include psychometrics")
+    .action(async (mindId, snapshotId, options) => {
+      try {
+        const client = getSDK();
+        const result = await client.snapshots.getDetail(mindId, snapshotId, {
+          includeTranscript: options.transcript,
+          includePsychometrics: options.psychometrics,
+        });
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  snapshots
+    .command("create")
+    .description("Upload a file to create a snapshot")
+    .argument("<mindId>", "ID of the mind")
+    .requiredOption("-f, --file <path>", "Path to the file (pdf, vtt, txt, etc.)")
+    .option("-d, --date <date>", "Mindset date (YYYY-MM-DD)")
+    .action(async (mindId, options) => {
+      try {
+        const client = getSDK();
+        const filePath = path.resolve(options.file);
+
+        if (!fs.existsSync(filePath)) {
+          throw new Error(`File not found: ${filePath}`);
+        }
+
+        const fileName = path.basename(filePath);
+        const fileBuffer = fs.readFileSync(filePath);
+
+        console.log(`Uploading ${fileName}...`);
+
+        const result = await client.snapshots.create(mindId, {
+          file: fileBuffer,
+          fileName: fileName,
+          mindsetDate: options.date,
+          contentType: "", // Let SDK infer from fileName extension
+        });
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  snapshots
+    .command("status")
+    .description("Check the processing status of a snapshot")
+    .argument("<mindId>", "ID of the mind")
+    .argument("<snapshotId>", "ID of the snapshot (mindAssessmentId)")
+    .action(async (mindId, snapshotId) => {
+      try {
+        const client = getSDK();
+        const result = await client.snapshots.getStatus(mindId, snapshotId);
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  snapshots
+    .command("delete")
+    .description("Delete a snapshot")
+    .argument("<mindId>", "ID of the mind")
+    .argument("<snapshotId>", "ID of the snapshot")
+    .action(async (mindId, snapshotId) => {
+      try {
+        const client = getSDK();
+        const result = await client.snapshots.delete(mindId, snapshotId);
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  snapshots
+    .command("link")
+    .description("Link snapshot to digital twin")
+    .argument("<mindId>", "ID of the mind")
+    .argument("<snapshotId>", "ID of the snapshot")
+    .action(async (mindId, snapshotId) => {
+      try {
+        const client = getSDK();
+        const result = await client.snapshots.link(mindId, snapshotId);
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  snapshots
+    .command("unlink")
+    .description("Unlink snapshot from digital twin")
+    .argument("<mindId>", "ID of the mind")
+    .argument("<snapshotId>", "ID of the snapshot")
+    .action(async (mindId, snapshotId) => {
+      try {
+        const client = getSDK();
+        const result = await client.snapshots.unlink(mindId, snapshotId);
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  // ==========================================
+  // SIMULATIONS RESOURCES
+  // ==========================================
+  const simulations = program.command("simulations").description("Run and manage simulations");
+
+  simulations
+    .command("run")
+    .description("Run a simulation against a mind")
+    .argument("<mindId>", "ID of the mind")
+    .requiredOption("-m, --message <message>", "The scenario/prompt message")
+    .option("-b, --background", "Run in background (async)", false)
+    .action(async (mindId, options) => {
+      try {
+        const client = getSDK();
+        const result = await client.simulations.run({
+          mindId,
+          scenario: {
+            message: options.message,
+          },
+          runInBackground: options.background,
+        });
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  simulations
+    .command("list")
+    .description("List simulation history")
+    .option("-l, --limit <number>", "Number of items to return", "20")
+    .option("-o, --offset <number>", "Pagination offset", "0")
+    .action(async (options) => {
+      try {
+        const client = getSDK();
+        const result = await client.simulations.list({
+          limit: Number.parseInt(options.limit, 10),
+          offset: Number.parseInt(options.offset, 10),
+        });
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  simulations
+    .command("get")
+    .description("Get full details of a simulation")
+    .argument("<simulationId>", "ID of the simulation")
+    .action(async (simulationId) => {
+      try {
+        const client = getSDK();
+        const result = await client.simulations.get(simulationId);
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  simulations
+    .command("delete")
+    .description("Delete a simulation record")
+    .argument("<simulationId>", "ID of the simulation")
+    .action(async (simulationId) => {
+      try {
+        const client = getSDK();
+        const result = await client.simulations.delete(simulationId);
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  // ==========================================
+  // TAGS RESOURCES
+  // ==========================================
+  const tags = program.command("tags").description("Manage tags");
+
+  tags
+    .command("list")
+    .description("List all available tags")
+    .action(async () => {
+      try {
+        const client = getSDK();
+        const result = await client.tags.list();
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  tags
+    .command("update")
+    .description("Update a tag name")
+    .argument("<tagId>", "ID of the tag")
+    .requiredOption("-n, --name <name>", "New name for the tag")
+    .action(async (tagId, options) => {
+      try {
+        const client = getSDK();
+        const result = await client.tags.update(tagId, { name: options.name });
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  tags
+    .command("delete")
+    .description("Delete a tag")
+    .argument("<tagId>", "ID of the tag")
+    .action(async (tagId) => {
+      try {
+        const client = getSDK();
+        const result = await client.tags.delete(tagId);
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  // ==========================================
+  // PSYCHOMETRICS RESOURCES
+  // ==========================================
+  const psychometrics = program.command("psychometrics").description("Retrieve psychometric data");
+
+  psychometrics
+    .command("get")
+    .description("Get psychometrics for a specific snapshot")
+    .argument("<snapshotId>", "ID of the snapshot")
+    .action(async (snapshotId) => {
+      try {
+        const client = getSDK();
+        const result = await client.psychometrics.get(snapshotId);
+        printOutput(result);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  psychometrics
+    .command("topics")
+    .description("Get topic analysis")
+    .argument("<snapshotId>")
+    .action(async (sid) => {
+      try {
+        const client = getSDK();
+        printOutput(await client.mindTopics.get(sid));
+      } catch (e) {
+        handleError(e);
+      }
+    });
+
+  // USAGE & USERS
+  program
+    .command("usage")
+    .description("Get API key usage")
+    .option("--from <date>", "From date (YYYY-MM-DD)")
+    .option("--to <date>", "To date (YYYY-MM-DD)")
+    .action(async (opts) => {
+      try {
+        const client = getSDK();
+        printOutput(await client.usage.get({ from: opts.from, to: opts.to }));
+      } catch (e) {
+        handleError(e);
+      }
+    });
+
+  program
+    .command("users")
+    .description("List organization users")
+    .action(async () => {
+      try {
+        const client = getSDK();
+        printOutput(await client.users.list());
+      } catch (e) {
+        handleError(e);
+      }
+    });
+
   program.parse(process.argv);
 };
 

package/src/index.ts

@@ -1,11 +1,14 @@
 import axios, { type AxiosInstance } from "axios";
 import { getApiBaseUrl, loadApiKey } from "./config";
 import { ArtifactsResource } from "./resources/artifacts";
+import { MindTopicsResource } from "./resources/mind-topics";
 import { MindsResource } from "./resources/minds";
 import { PsychometricsResource } from "./resources/psychometrics";
 import { SimulationsResource } from "./resources/simulations";
 import { SnapshotsResource } from "./resources/snapshots";
 import { TagsResource } from "./resources/tags";
+import { UsageResource } from "./resources/usage";
+import { UsersResource } from "./resources/users";
 import { checkForUpdates, getPackageVersion } from "./version";
 
 export class MindSim {
@@ -13,10 +16,13 @@ export class MindSim {
 
   public artifacts: ArtifactsResource;
   public minds: MindsResource;
+  public mindTopics: MindTopicsResource;
   public psychometrics: PsychometricsResource;
   public snapshots: SnapshotsResource;
   public simulations: SimulationsResource;
   public tags: TagsResource;
+  public usage: UsageResource;
+  public users: UsersResource;
 
   constructor(apiKey?: string, options?: { apiBaseUrl?: string }) {
     // 1. Trigger the auto-update check (Fire and forget, do not await)
@@ -48,10 +54,13 @@ export class MindSim {
 
     this.artifacts = new ArtifactsResource(this.client);
     this.minds = new MindsResource(this.client);
+    this.mindTopics = new MindTopicsResource(this.client);
     this.psychometrics = new PsychometricsResource(this.client);
     this.snapshots = new SnapshotsResource(this.client);
     this.simulations = new SimulationsResource(this.client);
     this.tags = new TagsResource(this.client);
+    this.usage = new UsageResource(this.client);
+    this.users = new UsersResource(this.client);
   }
 }
 

package/src/resources/mind-topics.ts

@@ -0,0 +1,16 @@
+import type { AxiosInstance } from "axios";
+import type { GetMindTopicsResponse } from "../types";
+
+export class MindTopicsResource {
+  constructor(private client: AxiosInstance) {}
+
+  /**
+   * Get topic analysis for a specific snapshot
+   */
+  async get(snapshotId: string): Promise<GetMindTopicsResponse> {
+    const response = await this.client.get<GetMindTopicsResponse>(
+      `/snapshots/${snapshotId}/mind-topics`,
+    );
+    return response.data;
+  }
+}

package/src/resources/snapshots.ts

@@ -5,8 +5,10 @@ import type {
   CreateSnapshotFromFileParams,
   CreateSnapshotParams,
   CreateSnapshotResponse,
+  DigitalTwinMindAssessment,
   GetSignedUrlResponse,
   ListSnapshotsResponse,
+  SnapshotDetailResponse,
   SnapshotStatus,
 } from "../types";
 
@@ -41,6 +43,36 @@ export class SnapshotsResource {
     return response.data;
   }
 
+  /**
+   * Get details of a specific snapshot, optionally including transcripts and psychometrics
+   */
+  async getDetail(
+    mindId: string,
+    snapshotId: string,
+    options?: { includeTranscript?: boolean; includePsychometrics?: boolean },
+  ): Promise<SnapshotDetailResponse> {
+    const response = await this.client.get<SnapshotDetailResponse>(
+      `/minds/${mindId}/snapshots/${snapshotId}`,
+      {
+        params: options,
+      },
+    );
+    return response.data;
+  }
+
+  /**
+   * Delete a snapshot
+   */
+  async delete(
+    mindId: string,
+    snapshotId: string,
+  ): Promise<{ message: string; snapshotId: string }> {
+    const response = await this.client.delete<{ message: string; snapshotId: string }>(
+      `/minds/${mindId}/snapshots/${snapshotId}`,
+    );
+    return response.data;
+  }
+
   /**
    * Create a snapshot via a signed url. Recommended for large files.
    */
@@ -123,4 +155,32 @@ export class SnapshotsResource {
     );
     return response.data;
   }
+
+  /**
+   * Link a snapshot to the Digital Twin
+   */
+  async link(
+    mindId: string,
+    snapshotId: string,
+  ): Promise<{ message: string; snapshot: DigitalTwinMindAssessment }> {
+    const response = await this.client.post<{
+      message: string;
+      snapshot: DigitalTwinMindAssessment;
+    }>(`/minds/${mindId}/snapshots/${snapshotId}/link`);
+    return response.data;
+  }
+
+  /**
+   * Unlink a snapshot from the Digital Twin
+   */
+  async unlink(
+    mindId: string,
+    snapshotId: string,
+  ): Promise<{ message: string; snapshot: DigitalTwinMindAssessment[] }> {
+    const response = await this.client.post<{
+      message: string;
+      snapshot: DigitalTwinMindAssessment[];
+    }>(`/minds/${mindId}/snapshots/${snapshotId}/unlink`);
+    return response.data;
+  }
 }

package/src/resources/usage.ts

@@ -0,0 +1,16 @@
+import type { AxiosInstance } from "axios";
+import type { ApiKeyUsage } from "../types";
+
+export class UsageResource {
+  constructor(private client: AxiosInstance) {}
+
+  /**
+   * Get API Key Usage stats
+   */
+  async get(params?: { from?: string; to?: string }): Promise<ApiKeyUsage> {
+    const response = await this.client.get<ApiKeyUsage>("/usage", {
+      params,
+    });
+    return response.data;
+  }
+}

package/src/resources/users.ts

@@ -0,0 +1,16 @@
+import type { AxiosInstance } from "axios";
+import type { ListUsersResponse } from "../types";
+
+export class UsersResource {
+  constructor(private client: AxiosInstance) {}
+
+  /**
+   * List users in the organization
+   */
+  async list(params?: { limit?: number; offset?: number }): Promise<ListUsersResponse> {
+    const response = await this.client.get<ListUsersResponse>("/organizations/users", {
+      params,
+    });
+    return response.data;
+  }
+}