@unboundai/tb-ppt-mgagent 0.1.0 → 0.1.1

package/README.md

@@ -15,7 +15,9 @@ Built against the official Managed Agents docs (session creation, session operat
 
 ## What's still an assumption
 
-Everything above matches the documented API and SDK method signatures verbatim (verified against platform.claude.com/docs/en/managed-agents/\* while building this). The one thing **not** confirmed against a real response is the exact `filename`/path convention the Files API returns for a file the agent wrote to its outputs directory — the code guesses by matching `/outputs?[\/]/i` against the filename and falling back to any `.pptx` file on the session if nothing matches that pattern. If a real run's file list looks different, adjust the filter in `get_tb_powerpoint_result` in `src/index.ts`.
+Every SDK call in `src/index.ts` (`sessions.create`, `sessions.events.send`, `sessions.retrieve`, `sessions.events.list`, `files.list`, `files.download`) is checked against `@anthropic-ai/sdk`'s own `.d.ts`/source (installed version, not just the docs prose) — that's how a real bug was caught in 0.1.0: the docs' TypeScript sample for downloading a file shows `content.writeToFile(path)`, but that method doesn't exist on the installed SDK. `files.download()` actually resolves to a plain `Response`; 0.1.1 fixes this by reading it with `.arrayBuffer()` and writing the bytes directly.
+
+The one thing still **not** confirmed against a real response is the exact `filename`/path convention the Files API returns for a file the agent wrote to its outputs directory — the code guesses by matching `/outputs?[\/]/i` against the filename and falling back to any `.pptx` file on the session if nothing matches that pattern. If a real run's file list looks different, adjust the filter in `get_tb_powerpoint_result` in `src/index.ts`.
 
 ## Setup
 
@@ -37,13 +39,14 @@ Everything above matches the documented API and SDK method signatures verbatim (
    - `TB_PPT_OUTPUT_DIR` — required for `get_tb_powerpoint_result`. Local folder that's synced to GCS by something outside this server; finished `.pptx` files are written here.
    - `TB_PPT_PUBLIC_URL_BASE` — required for `get_tb_powerpoint_result`. Base URL the synced folder is served from (e.g. `https://storage.googleapis.com/bucket/prefix`), used to build the returned download link.
 
-4. **Register with your MCP client** (Claude Desktop / TypingMind's local MCP connector — same pattern as this repo's siblings, e.g. `tb-gcs-assembly-mcp`):
+4. **Register with your MCP client** (Claude Desktop / TypingMind's local MCP connector — same pattern as this repo's siblings, e.g. `tb-gcs-assembly-mcp`). Published to npm as [`@unboundai/tb-ppt-mgagent`](https://www.npmjs.com/package/@unboundai/tb-ppt-mgagent), so `npx` can run it without a local checkout:
 
    ```json
    "tb-ppt-mgagent": {
-     "command": "node",
+     "command": "npx",
      "args": [
-       "/path/to/tb-ppt-mgAgent/build/index.js"
+       "-y",
+       "@unboundai/tb-ppt-mgagent"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "sk-ant-...",
@@ -55,6 +58,25 @@ Everything above matches the documented API and SDK method signatures verbatim (
    }
    ```
 
+   Or, from a local checkout of this repo:
+
+   ```json
+   "tb-ppt-mgagent": {
+     "command": "node",
+     "args": [
+       "/path/to/tb-ppt-mgAgent/build/index.js"
+     ],
+     "env": { "...": "same as above" }
+   }
+   ```
+
+   ### Publishing a new version
+
+   ```bash
+   npm version patch   # or minor/major
+   npm publish         # prepublishOnly rebuilds automatically; will prompt for a 2FA OTP
+   ```
+
 ## Development
 
 ```bash

package/build/index.js

@@ -19,11 +19,13 @@
  * automatically for session endpoints. The Files API additionally takes an
  * explicit `betas` array on list/download, per the docs' own example.
  *
- * A couple of the beta SDK's exact TypeScript types for newer event/file
- * fields (stop_reason, processed_at, filename) aren't fully pinned down
- * here - those spots are narrowed with `as any` and a comment rather than
- * guessed field names baked into strict types, so a real API response can't
- * silently mismatch a wrong compile-time shape.
+ * Every call here is checked against @anthropic-ai/sdk's own .d.ts/source
+ * (v0.120.0, the latest published at the time of writing) rather than taken
+ * on faith from the docs prose - the docs' TypeScript sample for downloading
+ * a file shows `content.writeToFile(path)`, but that method does not exist
+ * on the installed SDK: `files.download()` resolves to a plain `Response`,
+ * read with `.arrayBuffer()` below. If a future SDK version reintroduces a
+ * writeToFile-style helper, this can simplify back down.
  *
  * Environment variables:
  * - ANTHROPIC_API_KEY: required. Anthropic API key with Managed Agents access.
@@ -218,16 +220,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
             }
             // Find the most recent session.status_idle event to read its stop_reason.
-            // (Its exact field shape isn't pinned down in our TS types yet - see file header.)
             let latestIdleEvent = null;
             for await (const event of client.beta.sessions.events.list(sessionId)) {
                 if (event.type === "session.status_idle") {
-                    if (!latestIdleEvent || (event.processed_at ?? "") > (latestIdleEvent.processed_at ?? "")) {
+                    if (!latestIdleEvent || event.processed_at > latestIdleEvent.processed_at) {
                         latestIdleEvent = event;
                     }
                 }
             }
-            const stopReasonType = latestIdleEvent?.stop_reason?.type;
+            const stopReasonType = latestIdleEvent?.stop_reason.type;
             if (stopReasonType !== "end_turn") {
                 return {
                     content: [{
@@ -246,9 +247,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 scope_id: sessionId,
                 betas: [MANAGED_AGENTS_BETA]
             });
-            const fileList = files.data ?? [];
-            const pptxFiles = fileList.filter((f) => /\.pptx$/i.test(f.filename ?? ""));
-            const outputPptxFiles = pptxFiles.filter((f) => /outputs?[\\/]/i.test(f.filename ?? ""));
+            const fileList = files.data;
+            const pptxFiles = fileList.filter((f) => /\.pptx$/i.test(f.filename));
+            const outputPptxFiles = pptxFiles.filter((f) => /outputs?[\\/]/i.test(f.filename));
             const chosen = outputPptxFiles[0] ?? pptxFiles[0];
             if (!chosen) {
                 return {
@@ -267,9 +268,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             const { outputDir, publicUrlBase } = requireOutputConfig();
             const safeName = path.basename(chosen.filename || `${sessionId}.pptx`);
             const destPath = path.join(outputDir, safeName);
+            // files.download() resolves to a plain Response on this SDK version - no
+            // writeToFile() helper (see file header). Read the bytes and write them ourselves.
+            const response = await client.beta.files.download(chosen.id, {
+                betas: [MANAGED_AGENTS_BETA]
+            });
+            const arrayBuffer = await response.arrayBuffer();
             fs.mkdirSync(outputDir, { recursive: true });
-            const content = await client.beta.files.download(chosen.id);
-            await content.writeToFile(destPath);
+            fs.writeFileSync(destPath, Buffer.from(arrayBuffer));
             const downloadUrl = `${publicUrlBase.replace(/\/$/, "")}/${encodeURIComponent(safeName)}`;
             return {
                 content: [{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundai/tb-ppt-mgagent",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MCP server that hands a presentation outline to the Traffic Builders PowerPoint Managed Agent, then retrieves the finished .pptx",
   "main": "build/index.js",
   "bin": {