@major-tech/agents-client 0.1.1

package/dist/client.d.ts

@@ -0,0 +1,57 @@
+import type { AgentsClientConfig, RunAgentRequest, RunAgentResponse, SendMessageResponse, StopRunResponse, AgentRun, AgentMessage } from "./types";
+/**
+ * Client for triggering and interacting with Major agents from a deployed app.
+ *
+ * Prefer the `createAgentsClient()` factory — it reads platform-managed env
+ * vars and (when imported from `@major-tech/agents-client/next`) wires up
+ * auto-forwarding of the inbound viewer JWT.
+ *
+ * A "run" is a Major chat thread; the `chatThreadId` returned by `run()` is the
+ * `runId` the run-ops methods (`sendMessage` / `stopAgent` / `getAgentContent`)
+ * accept.
+ */
+export declare class AgentsClient {
+    private readonly baseUrl;
+    private readonly majorJwtToken;
+    private readonly getHeaders;
+    private readonly fetchImpl;
+    constructor(config?: AgentsClientConfig);
+    /**
+     * Start an agent run. Fire-and-forget: returns as soon as the server has
+     * created the chat thread and accepted the run; the agent itself runs
+     * asynchronously. The returned `chatThreadId` is the `runId` for run-ops.
+     */
+    run(request: RunAgentRequest): Promise<RunAgentResponse>;
+    /**
+     * Send a follow-up message to a run this app started. Throws
+     * {@link AgentRunNotActiveError} if the run has already finished — call
+     * `run()` again to start a new one.
+     */
+    sendMessage(runId: string, message: string): Promise<SendMessageResponse>;
+    /**
+     * Stop a run this app started. Idempotent: stopping an already-finished run
+     * succeeds and reports `"stopped"`.
+     */
+    stopAgent(runId: string): Promise<StopRunResponse>;
+    /**
+     * List runs this app started that are still executing, optionally filtered to
+     * a single agent. "Live" means the run's session has not ended.
+     */
+    getRunningInstancesOfAgent(agentId?: string): Promise<AgentRun[]>;
+    /**
+     * Read the most recent messages of a run's thread. `n` caps how many trailing
+     * messages are returned (the server default applies when omitted).
+     */
+    getAgentContent(runId: string, n?: number): Promise<AgentMessage[]>;
+    private request;
+}
+/**
+ * Factory mirroring the convention used by `@major-tech/resource-client`.
+ * Equivalent to `new AgentsClient(config)`.
+ *
+ * In Next.js apps, prefer `createAgentsClient` from
+ * `@major-tech/agents-client/next` — it auto-forwards `x-major-user-jwt` from
+ * the inbound request headers.
+ */
+export declare function createAgentsClient(config?: AgentsClientConfig): AgentsClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,QAAQ,EACR,YAAY,EACb,MAAM,SAAS,CAAC;AAUjB;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiE;IAC5F,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,MAAM,GAAE,kBAAuB;IAqB3C;;;;OAIG;IACG,GAAG,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkB9D;;;;OAIG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAe/E;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAYxD;;;OAGG;IACG,0BAA0B,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAevE;;;OAGG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YAoB3D,OAAO;CAuCtB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,kBAAuB,GAAG,YAAY,CAEhF"}

package/dist/errors.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Error hierarchy for the Major agents client. Every error extends
+ * {@link AgentsClientError}, which carries the HTTP status (when the failure
+ * came from a response) and the server's `x-request-id` for support/debugging.
+ */
+export declare class AgentsClientError extends Error {
+    readonly httpStatus?: number;
+    readonly requestId?: string;
+    constructor(message: string, httpStatus?: number, requestId?: string);
+}
+/** The request was rejected as invalid (HTTP 400). */
+export declare class AgentsValidationError extends AgentsClientError {
+    constructor(message: string, requestId?: string);
+}
+/** Authentication or authorization failed (HTTP 401/403). */
+export declare class AgentsAuthError extends AgentsClientError {
+    constructor(message: string, httpStatus?: number, requestId?: string);
+}
+/** The agent or run could not be found, or is not owned by this app (HTTP 404). */
+export declare class AgentNotFoundError extends AgentsClientError {
+    constructor(message: string, requestId?: string);
+}
+/** A run could not be started, or a transport error prevented the request. */
+export declare class AgentRunNotStartedError extends AgentsClientError {
+    constructor(message: string, httpStatus?: number, requestId?: string);
+}
+/**
+ * The targeted run is no longer active, so the operation (e.g. `sendMessage`)
+ * cannot be applied (HTTP 409). Re-trigger the agent with `run()` to start a
+ * new run.
+ */
+export declare class AgentRunNotActiveError extends AgentsClientError {
+    constructor(message: string, requestId?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAMrE;AAED,sDAAsD;AACtD,qBAAa,qBAAsB,SAAQ,iBAAiB;gBAC9C,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAED,6DAA6D;AAC7D,qBAAa,eAAgB,SAAQ,iBAAiB;gBACxC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIrE;AAED,mFAAmF;AACnF,qBAAa,kBAAmB,SAAQ,iBAAiB;gBAC3C,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAED,8EAA8E;AAC9E,qBAAa,uBAAwB,SAAQ,iBAAiB;gBAChD,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIrE;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,iBAAiB;gBAC/C,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD"}

package/dist/index.cjs

@@ -0,0 +1,248 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AgentNotFoundError: () => AgentNotFoundError,
+  AgentRunNotActiveError: () => AgentRunNotActiveError,
+  AgentRunNotStartedError: () => AgentRunNotStartedError,
+  AgentsAuthError: () => AgentsAuthError,
+  AgentsClient: () => AgentsClient,
+  AgentsClientError: () => AgentsClientError,
+  AgentsValidationError: () => AgentsValidationError,
+  createAgentsClient: () => createAgentsClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var AgentsClientError = class extends Error {
+  httpStatus;
+  requestId;
+  constructor(message, httpStatus, requestId) {
+    super(message);
+    this.name = "AgentsClientError";
+    this.httpStatus = httpStatus;
+    this.requestId = requestId;
+  }
+};
+var AgentsValidationError = class extends AgentsClientError {
+  constructor(message, requestId) {
+    super(message, 400, requestId);
+    this.name = "AgentsValidationError";
+  }
+};
+var AgentsAuthError = class extends AgentsClientError {
+  constructor(message, httpStatus, requestId) {
+    super(message, httpStatus, requestId);
+    this.name = "AgentsAuthError";
+  }
+};
+var AgentNotFoundError = class extends AgentsClientError {
+  constructor(message, requestId) {
+    super(message, 404, requestId);
+    this.name = "AgentNotFoundError";
+  }
+};
+var AgentRunNotStartedError = class extends AgentsClientError {
+  constructor(message, httpStatus, requestId) {
+    super(message, httpStatus, requestId);
+    this.name = "AgentRunNotStartedError";
+  }
+};
+var AgentRunNotActiveError = class extends AgentsClientError {
+  constructor(message, requestId) {
+    super(message, 409, requestId);
+    this.name = "AgentRunNotActiveError";
+  }
+};
+
+// src/client.ts
+var AgentsClient = class {
+  baseUrl;
+  majorJwtToken;
+  getHeaders;
+  fetchImpl;
+  constructor(config = {}) {
+    const baseUrl = config.baseUrl ?? process.env.MAJOR_API_BASE_URL;
+    if (!baseUrl) {
+      throw new AgentsClientError(
+        "AgentsClient: baseUrl is required (set MAJOR_API_BASE_URL or pass baseUrl explicitly)."
+      );
+    }
+    const majorJwtToken = config.majorJwtToken ?? process.env.MAJOR_JWT_TOKEN;
+    if (!majorJwtToken) {
+      throw new AgentsClientError(
+        "AgentsClient: majorJwtToken is required (set MAJOR_JWT_TOKEN or pass majorJwtToken explicitly)."
+      );
+    }
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.majorJwtToken = majorJwtToken;
+    this.getHeaders = config.getHeaders ?? (() => ({}));
+    this.fetchImpl = config.fetch ?? globalThis.fetch;
+  }
+  /**
+   * Start an agent run. Fire-and-forget: returns as soon as the server has
+   * created the chat thread and accepted the run; the agent itself runs
+   * asynchronously. The returned `chatThreadId` is the `runId` for run-ops.
+   */
+  async run(request) {
+    if (!request.agentId) {
+      throw new AgentsValidationError("AgentsClient.run: agentId is required.");
+    }
+    if (!request.prompt) {
+      throw new AgentsValidationError("AgentsClient.run: prompt is required.");
+    }
+    const { agentId, ...body } = request;
+    return this.request(
+      "POST",
+      `/agents/${encodeURIComponent(agentId)}/runs`,
+      body,
+      (message) => new AgentRunNotStartedError(`Failed to reach Major API: ${message}`)
+    );
+  }
+  /**
+   * Send a follow-up message to a run this app started. Throws
+   * {@link AgentRunNotActiveError} if the run has already finished — call
+   * `run()` again to start a new one.
+   */
+  async sendMessage(runId, message) {
+    if (!runId) {
+      throw new AgentsValidationError("AgentsClient.sendMessage: runId is required.");
+    }
+    if (!message) {
+      throw new AgentsValidationError("AgentsClient.sendMessage: message is required.");
+    }
+    return this.request(
+      "POST",
+      `/agents/runs/${encodeURIComponent(runId)}/messages`,
+      { message }
+    );
+  }
+  /**
+   * Stop a run this app started. Idempotent: stopping an already-finished run
+   * succeeds and reports `"stopped"`.
+   */
+  async stopAgent(runId) {
+    if (!runId) {
+      throw new AgentsValidationError("AgentsClient.stopAgent: runId is required.");
+    }
+    return this.request(
+      "POST",
+      `/agents/runs/${encodeURIComponent(runId)}/stop`,
+      void 0
+    );
+  }
+  /**
+   * List runs this app started that are still executing, optionally filtered to
+   * a single agent. "Live" means the run's session has not ended.
+   */
+  async getRunningInstancesOfAgent(agentId) {
+    const params = new URLSearchParams({ status: "active" });
+    if (agentId) {
+      params.set("agentId", agentId);
+    }
+    const result = await this.request(
+      "GET",
+      `/agents/runs?${params.toString()}`,
+      void 0
+    );
+    return result.runs;
+  }
+  /**
+   * Read the most recent messages of a run's thread. `n` caps how many trailing
+   * messages are returned (the server default applies when omitted).
+   */
+  async getAgentContent(runId, n) {
+    if (!runId) {
+      throw new AgentsValidationError("AgentsClient.getAgentContent: runId is required.");
+    }
+    const params = new URLSearchParams();
+    if (n !== void 0) {
+      params.set("n", String(n));
+    }
+    const query = params.toString();
+    const result = await this.request(
+      "GET",
+      `/agents/runs/${encodeURIComponent(runId)}/messages${query ? `?${query}` : ""}`,
+      void 0
+    );
+    return result.messages;
+  }
+  async request(method, path, body, onTransportError = (message) => new AgentsClientError(`Failed to reach Major API: ${message}`)) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json",
+      "x-major-jwt": this.majorJwtToken
+    };
+    Object.assign(headers, await this.getHeaders());
+    let response;
+    try {
+      response = await this.fetchImpl(url, {
+        method,
+        headers,
+        body: body === void 0 ? void 0 : JSON.stringify(body)
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      throw onTransportError(message);
+    }
+    const requestId = response.headers.get("x-request-id") ?? void 0;
+    if (response.ok) {
+      if (response.status === 204) {
+        return void 0;
+      }
+      return await response.json();
+    }
+    const errorMessage = await readErrorMessage(response);
+    throw toAgentsError(response.status, errorMessage, requestId);
+  }
+};
+function createAgentsClient(config = {}) {
+  return new AgentsClient(config);
+}
+function toAgentsError(status, message, requestId) {
+  if (status === 400) {
+    return new AgentsValidationError(message, requestId);
+  }
+  if (status === 401 || status === 403) {
+    return new AgentsAuthError(message, status, requestId);
+  }
+  if (status === 404) {
+    return new AgentNotFoundError(message, requestId);
+  }
+  if (status === 409) {
+    return new AgentRunNotActiveError(message, requestId);
+  }
+  return new AgentRunNotStartedError(message, status, requestId);
+}
+async function readErrorMessage(response) {
+  try {
+    const data = await response.json();
+    if (typeof data.message === "string") {
+      return data.message;
+    }
+    if (typeof data.error === "string") {
+      return data.error;
+    }
+  } catch {
+  }
+  return `Major API responded with HTTP ${response.status}`;
+}
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../src/errors.ts", "../src/client.ts"],
+  "sourcesContent": ["export { AgentsClient, createAgentsClient } from \"./client\";\nexport type {\n  AgentsClientConfig,\n  RunAgentRequest,\n  RunAgentResponse,\n  SendMessageResponse,\n  StopRunResponse,\n  AgentRun,\n  AgentMessage,\n} from \"./types\";\nexport {\n  AgentsClientError,\n  AgentsValidationError,\n  AgentsAuthError,\n  AgentNotFoundError,\n  AgentRunNotStartedError,\n  AgentRunNotActiveError,\n} from \"./errors\";\n", "/**\n * Error hierarchy for the Major agents client. Every error extends\n * {@link AgentsClientError}, which carries the HTTP status (when the failure\n * came from a response) and the server's `x-request-id` for support/debugging.\n */\nexport class AgentsClientError extends Error {\n  readonly httpStatus?: number;\n  readonly requestId?: string;\n\n  constructor(message: string, httpStatus?: number, requestId?: string) {\n    super(message);\n    this.name = \"AgentsClientError\";\n    this.httpStatus = httpStatus;\n    this.requestId = requestId;\n  }\n}\n\n/** The request was rejected as invalid (HTTP 400). */\nexport class AgentsValidationError extends AgentsClientError {\n  constructor(message: string, requestId?: string) {\n    super(message, 400, requestId);\n    this.name = \"AgentsValidationError\";\n  }\n}\n\n/** Authentication or authorization failed (HTTP 401/403). */\nexport class AgentsAuthError extends AgentsClientError {\n  constructor(message: string, httpStatus?: number, requestId?: string) {\n    super(message, httpStatus, requestId);\n    this.name = \"AgentsAuthError\";\n  }\n}\n\n/** The agent or run could not be found, or is not owned by this app (HTTP 404). */\nexport class AgentNotFoundError extends AgentsClientError {\n  constructor(message: string, requestId?: string) {\n    super(message, 404, requestId);\n    this.name = \"AgentNotFoundError\";\n  }\n}\n\n/** A run could not be started, or a transport error prevented the request. */\nexport class AgentRunNotStartedError extends AgentsClientError {\n  constructor(message: string, httpStatus?: number, requestId?: string) {\n    super(message, httpStatus, requestId);\n    this.name = \"AgentRunNotStartedError\";\n  }\n}\n\n/**\n * The targeted run is no longer active, so the operation (e.g. `sendMessage`)\n * cannot be applied (HTTP 409). Re-trigger the agent with `run()` to start a\n * new run.\n */\nexport class AgentRunNotActiveError extends AgentsClientError {\n  constructor(message: string, requestId?: string) {\n    super(message, 409, requestId);\n    this.name = \"AgentRunNotActiveError\";\n  }\n}\n", "import type {\n  AgentsClientConfig,\n  RunAgentRequest,\n  RunAgentResponse,\n  SendMessageResponse,\n  StopRunResponse,\n  AgentRun,\n  AgentMessage,\n} from \"./types\";\nimport {\n  AgentsClientError,\n  AgentsValidationError,\n  AgentsAuthError,\n  AgentNotFoundError,\n  AgentRunNotStartedError,\n  AgentRunNotActiveError,\n} from \"./errors\";\n\n/**\n * Client for triggering and interacting with Major agents from a deployed app.\n *\n * Prefer the `createAgentsClient()` factory \u2014 it reads platform-managed env\n * vars and (when imported from `@major-tech/agents-client/next`) wires up\n * auto-forwarding of the inbound viewer JWT.\n *\n * A \"run\" is a Major chat thread; the `chatThreadId` returned by `run()` is the\n * `runId` the run-ops methods (`sendMessage` / `stopAgent` / `getAgentContent`)\n * accept.\n */\nexport class AgentsClient {\n  private readonly baseUrl: string;\n  private readonly majorJwtToken: string;\n  private readonly getHeaders: () => Promise<Record<string, string>> | Record<string, string>;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(config: AgentsClientConfig = {}) {\n    const baseUrl = config.baseUrl ?? process.env.MAJOR_API_BASE_URL;\n    if (!baseUrl) {\n      throw new AgentsClientError(\n        \"AgentsClient: baseUrl is required (set MAJOR_API_BASE_URL or pass baseUrl explicitly).\",\n      );\n    }\n\n    const majorJwtToken = config.majorJwtToken ?? process.env.MAJOR_JWT_TOKEN;\n    if (!majorJwtToken) {\n      throw new AgentsClientError(\n        \"AgentsClient: majorJwtToken is required (set MAJOR_JWT_TOKEN or pass majorJwtToken explicitly).\",\n      );\n    }\n\n    this.baseUrl = baseUrl.replace(/\\/$/, \"\");\n    this.majorJwtToken = majorJwtToken;\n    this.getHeaders = config.getHeaders ?? (() => ({}));\n    this.fetchImpl = config.fetch ?? globalThis.fetch;\n  }\n\n  /**\n   * Start an agent run. Fire-and-forget: returns as soon as the server has\n   * created the chat thread and accepted the run; the agent itself runs\n   * asynchronously. The returned `chatThreadId` is the `runId` for run-ops.\n   */\n  async run(request: RunAgentRequest): Promise<RunAgentResponse> {\n    if (!request.agentId) {\n      throw new AgentsValidationError(\"AgentsClient.run: agentId is required.\");\n    }\n    if (!request.prompt) {\n      throw new AgentsValidationError(\"AgentsClient.run: prompt is required.\");\n    }\n\n    const { agentId, ...body } = request;\n\n    return this.request<RunAgentResponse>(\n      \"POST\",\n      `/agents/${encodeURIComponent(agentId)}/runs`,\n      body,\n      (message) => new AgentRunNotStartedError(`Failed to reach Major API: ${message}`),\n    );\n  }\n\n  /**\n   * Send a follow-up message to a run this app started. Throws\n   * {@link AgentRunNotActiveError} if the run has already finished \u2014 call\n   * `run()` again to start a new one.\n   */\n  async sendMessage(runId: string, message: string): Promise<SendMessageResponse> {\n    if (!runId) {\n      throw new AgentsValidationError(\"AgentsClient.sendMessage: runId is required.\");\n    }\n    if (!message) {\n      throw new AgentsValidationError(\"AgentsClient.sendMessage: message is required.\");\n    }\n\n    return this.request<SendMessageResponse>(\n      \"POST\",\n      `/agents/runs/${encodeURIComponent(runId)}/messages`,\n      { message },\n    );\n  }\n\n  /**\n   * Stop a run this app started. Idempotent: stopping an already-finished run\n   * succeeds and reports `\"stopped\"`.\n   */\n  async stopAgent(runId: string): Promise<StopRunResponse> {\n    if (!runId) {\n      throw new AgentsValidationError(\"AgentsClient.stopAgent: runId is required.\");\n    }\n\n    return this.request<StopRunResponse>(\n      \"POST\",\n      `/agents/runs/${encodeURIComponent(runId)}/stop`,\n      undefined,\n    );\n  }\n\n  /**\n   * List runs this app started that are still executing, optionally filtered to\n   * a single agent. \"Live\" means the run's session has not ended.\n   */\n  async getRunningInstancesOfAgent(agentId?: string): Promise<AgentRun[]> {\n    const params = new URLSearchParams({ status: \"active\" });\n    if (agentId) {\n      params.set(\"agentId\", agentId);\n    }\n\n    const result = await this.request<{ runs: AgentRun[] }>(\n      \"GET\",\n      `/agents/runs?${params.toString()}`,\n      undefined,\n    );\n\n    return result.runs;\n  }\n\n  /**\n   * Read the most recent messages of a run's thread. `n` caps how many trailing\n   * messages are returned (the server default applies when omitted).\n   */\n  async getAgentContent(runId: string, n?: number): Promise<AgentMessage[]> {\n    if (!runId) {\n      throw new AgentsValidationError(\"AgentsClient.getAgentContent: runId is required.\");\n    }\n\n    const params = new URLSearchParams();\n    if (n !== undefined) {\n      params.set(\"n\", String(n));\n    }\n    const query = params.toString();\n\n    const result = await this.request<{ messages: AgentMessage[] }>(\n      \"GET\",\n      `/agents/runs/${encodeURIComponent(runId)}/messages${query ? `?${query}` : \"\"}`,\n      undefined,\n    );\n\n    return result.messages;\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body: unknown,\n    onTransportError: (message: string) => AgentsClientError = (message) =>\n      new AgentsClientError(`Failed to reach Major API: ${message}`),\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      \"x-major-jwt\": this.majorJwtToken,\n    };\n    Object.assign(headers, await this.getHeaders());\n\n    let response: Response;\n    try {\n      response = await this.fetchImpl(url, {\n        method,\n        headers,\n        body: body === undefined ? undefined : JSON.stringify(body),\n      });\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      throw onTransportError(message);\n    }\n\n    const requestId = response.headers.get(\"x-request-id\") ?? undefined;\n\n    if (response.ok) {\n      if (response.status === 204) {\n        return undefined as T;\n      }\n\n      return (await response.json()) as T;\n    }\n\n    const errorMessage = await readErrorMessage(response);\n    throw toAgentsError(response.status, errorMessage, requestId);\n  }\n}\n\n/**\n * Factory mirroring the convention used by `@major-tech/resource-client`.\n * Equivalent to `new AgentsClient(config)`.\n *\n * In Next.js apps, prefer `createAgentsClient` from\n * `@major-tech/agents-client/next` \u2014 it auto-forwards `x-major-user-jwt` from\n * the inbound request headers.\n */\nexport function createAgentsClient(config: AgentsClientConfig = {}): AgentsClient {\n  return new AgentsClient(config);\n}\n\nfunction toAgentsError(status: number, message: string, requestId?: string): AgentsClientError {\n  if (status === 400) {\n    return new AgentsValidationError(message, requestId);\n  }\n  if (status === 401 || status === 403) {\n    return new AgentsAuthError(message, status, requestId);\n  }\n  if (status === 404) {\n    return new AgentNotFoundError(message, requestId);\n  }\n  if (status === 409) {\n    return new AgentRunNotActiveError(message, requestId);\n  }\n  return new AgentRunNotStartedError(message, status, requestId);\n}\n\nasync function readErrorMessage(response: Response): Promise<string> {\n  try {\n    const data = (await response.json()) as { message?: unknown; error?: unknown };\n    if (typeof data.message === \"string\") {\n      return data.message;\n    }\n    if (typeof data.error === \"string\") {\n      return data.error;\n    }\n  } catch {\n    // Non-JSON error body \u2014 fall through to the generic message.\n  }\n\n  return `Major API responded with HTTP ${response.status}`;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { AgentsClient, createAgentsClient } from "./client";
+export type { AgentsClientConfig, RunAgentRequest, RunAgentResponse, SendMessageResponse, StopRunResponse, AgentRun, AgentMessage, } from "./types";
+export { AgentsClientError, AgentsValidationError, AgentsAuthError, AgentNotFoundError, AgentRunNotStartedError, AgentRunNotActiveError, } from "./errors";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC5D,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,QAAQ,EACR,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,225 @@
+// src/errors.ts
+var AgentsClientError = class extends Error {
+  httpStatus;
+  requestId;
+  constructor(message, httpStatus, requestId) {
+    super(message);
+    this.name = "AgentsClientError";
+    this.httpStatus = httpStatus;
+    this.requestId = requestId;
+  }
+};
+var AgentsValidationError = class extends AgentsClientError {
+  constructor(message, requestId) {
+    super(message, 400, requestId);
+    this.name = "AgentsValidationError";
+  }
+};
+var AgentsAuthError = class extends AgentsClientError {
+  constructor(message, httpStatus, requestId) {
+    super(message, httpStatus, requestId);
+    this.name = "AgentsAuthError";
+  }
+};
+var AgentNotFoundError = class extends AgentsClientError {
+  constructor(message, requestId) {
+    super(message, 404, requestId);
+    this.name = "AgentNotFoundError";
+  }
+};
+var AgentRunNotStartedError = class extends AgentsClientError {
+  constructor(message, httpStatus, requestId) {
+    super(message, httpStatus, requestId);
+    this.name = "AgentRunNotStartedError";
+  }
+};
+var AgentRunNotActiveError = class extends AgentsClientError {
+  constructor(message, requestId) {
+    super(message, 409, requestId);
+    this.name = "AgentRunNotActiveError";
+  }
+};
+
+// src/client.ts
+var AgentsClient = class {
+  baseUrl;
+  majorJwtToken;
+  getHeaders;
+  fetchImpl;
+  constructor(config = {}) {
+    const baseUrl = config.baseUrl ?? process.env.MAJOR_API_BASE_URL;
+    if (!baseUrl) {
+      throw new AgentsClientError(
+        "AgentsClient: baseUrl is required (set MAJOR_API_BASE_URL or pass baseUrl explicitly)."
+      );
+    }
+    const majorJwtToken = config.majorJwtToken ?? process.env.MAJOR_JWT_TOKEN;
+    if (!majorJwtToken) {
+      throw new AgentsClientError(
+        "AgentsClient: majorJwtToken is required (set MAJOR_JWT_TOKEN or pass majorJwtToken explicitly)."
+      );
+    }
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.majorJwtToken = majorJwtToken;
+    this.getHeaders = config.getHeaders ?? (() => ({}));
+    this.fetchImpl = config.fetch ?? globalThis.fetch;
+  }
+  /**
+   * Start an agent run. Fire-and-forget: returns as soon as the server has
+   * created the chat thread and accepted the run; the agent itself runs
+   * asynchronously. The returned `chatThreadId` is the `runId` for run-ops.
+   */
+  async run(request) {
+    if (!request.agentId) {
+      throw new AgentsValidationError("AgentsClient.run: agentId is required.");
+    }
+    if (!request.prompt) {
+      throw new AgentsValidationError("AgentsClient.run: prompt is required.");
+    }
+    const { agentId, ...body } = request;
+    return this.request(
+      "POST",
+      `/agents/${encodeURIComponent(agentId)}/runs`,
+      body,
+      (message) => new AgentRunNotStartedError(`Failed to reach Major API: ${message}`)
+    );
+  }
+  /**
+   * Send a follow-up message to a run this app started. Throws
+   * {@link AgentRunNotActiveError} if the run has already finished — call
+   * `run()` again to start a new one.
+   */
+  async sendMessage(runId, message) {
+    if (!runId) {
+      throw new AgentsValidationError("AgentsClient.sendMessage: runId is required.");
+    }
+    if (!message) {
+      throw new AgentsValidationError("AgentsClient.sendMessage: message is required.");
+    }
+    return this.request(
+      "POST",
+      `/agents/runs/${encodeURIComponent(runId)}/messages`,
+      { message }
+    );
+  }
+  /**
+   * Stop a run this app started. Idempotent: stopping an already-finished run
+   * succeeds and reports `"stopped"`.
+   */
+  async stopAgent(runId) {
+    if (!runId) {
+      throw new AgentsValidationError("AgentsClient.stopAgent: runId is required.");
+    }
+    return this.request(
+      "POST",
+      `/agents/runs/${encodeURIComponent(runId)}/stop`,
+      void 0
+    );
+  }
+  /**
+   * List runs this app started that are still executing, optionally filtered to
+   * a single agent. "Live" means the run's session has not ended.
+   */
+  async getRunningInstancesOfAgent(agentId) {
+    const params = new URLSearchParams({ status: "active" });
+    if (agentId) {
+      params.set("agentId", agentId);
+    }
+    const result = await this.request(
+      "GET",
+      `/agents/runs?${params.toString()}`,
+      void 0
+    );
+    return result.runs;
+  }
+  /**
+   * Read the most recent messages of a run's thread. `n` caps how many trailing
+   * messages are returned (the server default applies when omitted).
+   */
+  async getAgentContent(runId, n) {
+    if (!runId) {
+      throw new AgentsValidationError("AgentsClient.getAgentContent: runId is required.");
+    }
+    const params = new URLSearchParams();
+    if (n !== void 0) {
+      params.set("n", String(n));
+    }
+    const query = params.toString();
+    const result = await this.request(
+      "GET",
+      `/agents/runs/${encodeURIComponent(runId)}/messages${query ? `?${query}` : ""}`,
+      void 0
+    );
+    return result.messages;
+  }
+  async request(method, path, body, onTransportError = (message) => new AgentsClientError(`Failed to reach Major API: ${message}`)) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json",
+      "x-major-jwt": this.majorJwtToken
+    };
+    Object.assign(headers, await this.getHeaders());
+    let response;
+    try {
+      response = await this.fetchImpl(url, {
+        method,
+        headers,
+        body: body === void 0 ? void 0 : JSON.stringify(body)
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      throw onTransportError(message);
+    }
+    const requestId = response.headers.get("x-request-id") ?? void 0;
+    if (response.ok) {
+      if (response.status === 204) {
+        return void 0;
+      }
+      return await response.json();
+    }
+    const errorMessage = await readErrorMessage(response);
+    throw toAgentsError(response.status, errorMessage, requestId);
+  }
+};
+function createAgentsClient(config = {}) {
+  return new AgentsClient(config);
+}
+function toAgentsError(status, message, requestId) {
+  if (status === 400) {
+    return new AgentsValidationError(message, requestId);
+  }
+  if (status === 401 || status === 403) {
+    return new AgentsAuthError(message, status, requestId);
+  }
+  if (status === 404) {
+    return new AgentNotFoundError(message, requestId);
+  }
+  if (status === 409) {
+    return new AgentRunNotActiveError(message, requestId);
+  }
+  return new AgentRunNotStartedError(message, status, requestId);
+}
+async function readErrorMessage(response) {
+  try {
+    const data = await response.json();
+    if (typeof data.message === "string") {
+      return data.message;
+    }
+    if (typeof data.error === "string") {
+      return data.error;
+    }
+  } catch {
+  }
+  return `Major API responded with HTTP ${response.status}`;
+}
+export {
+  AgentNotFoundError,
+  AgentRunNotActiveError,
+  AgentRunNotStartedError,
+  AgentsAuthError,
+  AgentsClient,
+  AgentsClientError,
+  AgentsValidationError,
+  createAgentsClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/errors.ts", "../src/client.ts"],
+  "sourcesContent": ["/**\n * Error hierarchy for the Major agents client. Every error extends\n * {@link AgentsClientError}, which carries the HTTP status (when the failure\n * came from a response) and the server's `x-request-id` for support/debugging.\n */\nexport class AgentsClientError extends Error {\n  readonly httpStatus?: number;\n  readonly requestId?: string;\n\n  constructor(message: string, httpStatus?: number, requestId?: string) {\n    super(message);\n    this.name = \"AgentsClientError\";\n    this.httpStatus = httpStatus;\n    this.requestId = requestId;\n  }\n}\n\n/** The request was rejected as invalid (HTTP 400). */\nexport class AgentsValidationError extends AgentsClientError {\n  constructor(message: string, requestId?: string) {\n    super(message, 400, requestId);\n    this.name = \"AgentsValidationError\";\n  }\n}\n\n/** Authentication or authorization failed (HTTP 401/403). */\nexport class AgentsAuthError extends AgentsClientError {\n  constructor(message: string, httpStatus?: number, requestId?: string) {\n    super(message, httpStatus, requestId);\n    this.name = \"AgentsAuthError\";\n  }\n}\n\n/** The agent or run could not be found, or is not owned by this app (HTTP 404). */\nexport class AgentNotFoundError extends AgentsClientError {\n  constructor(message: string, requestId?: string) {\n    super(message, 404, requestId);\n    this.name = \"AgentNotFoundError\";\n  }\n}\n\n/** A run could not be started, or a transport error prevented the request. */\nexport class AgentRunNotStartedError extends AgentsClientError {\n  constructor(message: string, httpStatus?: number, requestId?: string) {\n    super(message, httpStatus, requestId);\n    this.name = \"AgentRunNotStartedError\";\n  }\n}\n\n/**\n * The targeted run is no longer active, so the operation (e.g. `sendMessage`)\n * cannot be applied (HTTP 409). Re-trigger the agent with `run()` to start a\n * new run.\n */\nexport class AgentRunNotActiveError extends AgentsClientError {\n  constructor(message: string, requestId?: string) {\n    super(message, 409, requestId);\n    this.name = \"AgentRunNotActiveError\";\n  }\n}\n", "import type {\n  AgentsClientConfig,\n  RunAgentRequest,\n  RunAgentResponse,\n  SendMessageResponse,\n  StopRunResponse,\n  AgentRun,\n  AgentMessage,\n} from \"./types\";\nimport {\n  AgentsClientError,\n  AgentsValidationError,\n  AgentsAuthError,\n  AgentNotFoundError,\n  AgentRunNotStartedError,\n  AgentRunNotActiveError,\n} from \"./errors\";\n\n/**\n * Client for triggering and interacting with Major agents from a deployed app.\n *\n * Prefer the `createAgentsClient()` factory \u2014 it reads platform-managed env\n * vars and (when imported from `@major-tech/agents-client/next`) wires up\n * auto-forwarding of the inbound viewer JWT.\n *\n * A \"run\" is a Major chat thread; the `chatThreadId` returned by `run()` is the\n * `runId` the run-ops methods (`sendMessage` / `stopAgent` / `getAgentContent`)\n * accept.\n */\nexport class AgentsClient {\n  private readonly baseUrl: string;\n  private readonly majorJwtToken: string;\n  private readonly getHeaders: () => Promise<Record<string, string>> | Record<string, string>;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(config: AgentsClientConfig = {}) {\n    const baseUrl = config.baseUrl ?? process.env.MAJOR_API_BASE_URL;\n    if (!baseUrl) {\n      throw new AgentsClientError(\n        \"AgentsClient: baseUrl is required (set MAJOR_API_BASE_URL or pass baseUrl explicitly).\",\n      );\n    }\n\n    const majorJwtToken = config.majorJwtToken ?? process.env.MAJOR_JWT_TOKEN;\n    if (!majorJwtToken) {\n      throw new AgentsClientError(\n        \"AgentsClient: majorJwtToken is required (set MAJOR_JWT_TOKEN or pass majorJwtToken explicitly).\",\n      );\n    }\n\n    this.baseUrl = baseUrl.replace(/\\/$/, \"\");\n    this.majorJwtToken = majorJwtToken;\n    this.getHeaders = config.getHeaders ?? (() => ({}));\n    this.fetchImpl = config.fetch ?? globalThis.fetch;\n  }\n\n  /**\n   * Start an agent run. Fire-and-forget: returns as soon as the server has\n   * created the chat thread and accepted the run; the agent itself runs\n   * asynchronously. The returned `chatThreadId` is the `runId` for run-ops.\n   */\n  async run(request: RunAgentRequest): Promise<RunAgentResponse> {\n    if (!request.agentId) {\n      throw new AgentsValidationError(\"AgentsClient.run: agentId is required.\");\n    }\n    if (!request.prompt) {\n      throw new AgentsValidationError(\"AgentsClient.run: prompt is required.\");\n    }\n\n    const { agentId, ...body } = request;\n\n    return this.request<RunAgentResponse>(\n      \"POST\",\n      `/agents/${encodeURIComponent(agentId)}/runs`,\n      body,\n      (message) => new AgentRunNotStartedError(`Failed to reach Major API: ${message}`),\n    );\n  }\n\n  /**\n   * Send a follow-up message to a run this app started. Throws\n   * {@link AgentRunNotActiveError} if the run has already finished \u2014 call\n   * `run()` again to start a new one.\n   */\n  async sendMessage(runId: string, message: string): Promise<SendMessageResponse> {\n    if (!runId) {\n      throw new AgentsValidationError(\"AgentsClient.sendMessage: runId is required.\");\n    }\n    if (!message) {\n      throw new AgentsValidationError(\"AgentsClient.sendMessage: message is required.\");\n    }\n\n    return this.request<SendMessageResponse>(\n      \"POST\",\n      `/agents/runs/${encodeURIComponent(runId)}/messages`,\n      { message },\n    );\n  }\n\n  /**\n   * Stop a run this app started. Idempotent: stopping an already-finished run\n   * succeeds and reports `\"stopped\"`.\n   */\n  async stopAgent(runId: string): Promise<StopRunResponse> {\n    if (!runId) {\n      throw new AgentsValidationError(\"AgentsClient.stopAgent: runId is required.\");\n    }\n\n    return this.request<StopRunResponse>(\n      \"POST\",\n      `/agents/runs/${encodeURIComponent(runId)}/stop`,\n      undefined,\n    );\n  }\n\n  /**\n   * List runs this app started that are still executing, optionally filtered to\n   * a single agent. \"Live\" means the run's session has not ended.\n   */\n  async getRunningInstancesOfAgent(agentId?: string): Promise<AgentRun[]> {\n    const params = new URLSearchParams({ status: \"active\" });\n    if (agentId) {\n      params.set(\"agentId\", agentId);\n    }\n\n    const result = await this.request<{ runs: AgentRun[] }>(\n      \"GET\",\n      `/agents/runs?${params.toString()}`,\n      undefined,\n    );\n\n    return result.runs;\n  }\n\n  /**\n   * Read the most recent messages of a run's thread. `n` caps how many trailing\n   * messages are returned (the server default applies when omitted).\n   */\n  async getAgentContent(runId: string, n?: number): Promise<AgentMessage[]> {\n    if (!runId) {\n      throw new AgentsValidationError(\"AgentsClient.getAgentContent: runId is required.\");\n    }\n\n    const params = new URLSearchParams();\n    if (n !== undefined) {\n      params.set(\"n\", String(n));\n    }\n    const query = params.toString();\n\n    const result = await this.request<{ messages: AgentMessage[] }>(\n      \"GET\",\n      `/agents/runs/${encodeURIComponent(runId)}/messages${query ? `?${query}` : \"\"}`,\n      undefined,\n    );\n\n    return result.messages;\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body: unknown,\n    onTransportError: (message: string) => AgentsClientError = (message) =>\n      new AgentsClientError(`Failed to reach Major API: ${message}`),\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      \"x-major-jwt\": this.majorJwtToken,\n    };\n    Object.assign(headers, await this.getHeaders());\n\n    let response: Response;\n    try {\n      response = await this.fetchImpl(url, {\n        method,\n        headers,\n        body: body === undefined ? undefined : JSON.stringify(body),\n      });\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      throw onTransportError(message);\n    }\n\n    const requestId = response.headers.get(\"x-request-id\") ?? undefined;\n\n    if (response.ok) {\n      if (response.status === 204) {\n        return undefined as T;\n      }\n\n      return (await response.json()) as T;\n    }\n\n    const errorMessage = await readErrorMessage(response);\n    throw toAgentsError(response.status, errorMessage, requestId);\n  }\n}\n\n/**\n * Factory mirroring the convention used by `@major-tech/resource-client`.\n * Equivalent to `new AgentsClient(config)`.\n *\n * In Next.js apps, prefer `createAgentsClient` from\n * `@major-tech/agents-client/next` \u2014 it auto-forwards `x-major-user-jwt` from\n * the inbound request headers.\n */\nexport function createAgentsClient(config: AgentsClientConfig = {}): AgentsClient {\n  return new AgentsClient(config);\n}\n\nfunction toAgentsError(status: number, message: string, requestId?: string): AgentsClientError {\n  if (status === 400) {\n    return new AgentsValidationError(message, requestId);\n  }\n  if (status === 401 || status === 403) {\n    return new AgentsAuthError(message, status, requestId);\n  }\n  if (status === 404) {\n    return new AgentNotFoundError(message, requestId);\n  }\n  if (status === 409) {\n    return new AgentRunNotActiveError(message, requestId);\n  }\n  return new AgentRunNotStartedError(message, status, requestId);\n}\n\nasync function readErrorMessage(response: Response): Promise<string> {\n  try {\n    const data = (await response.json()) as { message?: unknown; error?: unknown };\n    if (typeof data.message === \"string\") {\n      return data.message;\n    }\n    if (typeof data.error === \"string\") {\n      return data.error;\n    }\n  } catch {\n    // Non-JSON error body \u2014 fall through to the generic message.\n  }\n\n  return `Major API responded with HTTP ${response.status}`;\n}\n"],
+  "mappings": "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",
+  "names": []
+}