@major-tech/agents-client 0.1.1

package/dist/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Configuration accepted by `createAgentsClient` / `new AgentsClient(...)`.
+ *
+ * In a deployed Major app every field has a sensible default sourced from
+ * platform-managed env vars and the Next.js request context.
+ */
+export interface AgentsClientConfig {
+    /** Base URL of the Major API. Defaults to `process.env.MAJOR_API_BASE_URL`. */
+    baseUrl?: string;
+    /**
+     * Deployment-identity JWT. Defaults to `process.env.MAJOR_JWT_TOKEN`. Sent as
+     * the `x-major-jwt` header on every request.
+     */
+    majorJwtToken?: string;
+    /**
+     * Returns extra headers for each outbound call. The
+     * `@major-tech/agents-client/next` entry defaults this to lift
+     * `x-major-user-jwt` from the current request so per-user-OAuth agents work
+     * transparently. Override (e.g. return `{}`) outside a Next.js request scope.
+     */
+    getHeaders?: () => Promise<Record<string, string>> | Record<string, string>;
+    /** Custom fetch implementation. Defaults to `globalThis.fetch`. */
+    fetch?: typeof fetch;
+}
+/**
+ * Request input for `AgentsClient.run`. Mirrors the body the Major API expects
+ * at `POST /agents/:agentId/runs`.
+ */
+export interface RunAgentRequest {
+    /** Stable id of the agent to invoke. */
+    agentId: string;
+    /** Prompt the agent should act on. */
+    prompt: string;
+    /** Optional human-readable name for the run. Shown in the Major UI. */
+    name?: string;
+    /** Optional description for the run. */
+    description?: string;
+    /** Optional structured context forwarded to the agent. */
+    payload?: Record<string, unknown>;
+}
+/** Successful response from `AgentsClient.run`. */
+export interface RunAgentResponse {
+    /** Chat thread the run is associated with; also the `runId` for run-ops. */
+    chatThreadId: string;
+    /** Run lifecycle status. V1 only emits `"started"`. */
+    status: "started";
+}
+/** Response from `AgentsClient.sendMessage`. */
+export interface SendMessageResponse {
+    /** The message was accepted and enqueued to the run. */
+    status: "queued";
+}
+/**
+ * Response from `AgentsClient.stopAgent`. Idempotent: stopping an
+ * already-finished run still reports `"stopped"`.
+ */
+export interface StopRunResponse {
+    status: "stopped";
+}
+/** A run started by this app, as returned by `getRunningInstancesOfAgent`. */
+export interface AgentRun {
+    /** The run id (= chat thread id). */
+    runId: string;
+    /** Agent the run is executing. */
+    agentId: string;
+    /** Live status. Only currently-running runs are returned. */
+    status: "running";
+    /** ISO-8601 start time. */
+    startedAt: string;
+}
+/**
+ * One message in a run's thread, as returned by `getAgentContent`. Mirrors the
+ * Major chat-message envelope; `content` is left loose because its shape varies
+ * by `type` (`message` / `thinking` / `tool_use` / `tool_result` / ...).
+ */
+export interface AgentMessage {
+    role: "user" | "assistant" | "system";
+    type: string;
+    content: unknown;
+    timestamp: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5E,mEAAmE;IACnE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,8EAA8E;AAC9E,MAAM,WAAW,QAAQ;IACvB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,MAAM,EAAE,SAAS,CAAC;IAClB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@major-tech/agents-client",
+  "version": "0.1.1",
+  "description": "TypeScript client for triggering and interacting with Major agents from a deployed Major app",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./next": {
+      "types": "./dist/next/index.d.ts",
+      "import": "./dist/next/index.js",
+      "require": "./dist/next/index.cjs",
+      "default": "./dist/next/index.js"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "pnpm clean && tsc && node scripts/build.mjs",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm run typecheck && pnpm run build"
+  },
+  "keywords": [
+    "major",
+    "agents",
+    "client"
+  ],
+  "author": "Major Technology",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/major-technology/public-packages.git",
+    "directory": "agents-client"
+  },
+  "homepage": "https://github.com/major-technology/public-packages/tree/main/agents-client#readme",
+  "bugs": {
+    "url": "https://github.com/major-technology/public-packages/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.24.0",
+    "next": "^14.0.0",
+    "react": "^18.0.0",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "next": ">=14.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    }
+  }
+}