teams-api 0.5.2 → 0.7.0

package/README.md

@@ -25,19 +25,6 @@ Designed for autonomous AI agents that need to interact with Teams: read message
 
 The quickest way to get started is to click one of the install badges above, or follow the instructions for your editor below.
 
-#### Install as an agent skill
-
-The [SKILL.md](SKILL.md) teaches AI agents _how_ to use the MCP tools (when to call which tool, typical workflows, parameter guidance). Install it with the [`skills` CLI](https://github.com/vercel-labs/skills):
-
-```bash
-npx -y skills add Maxim-Mazurok/teams-api
-```
-
-This copies the skill into your agent's skills directory (Claude Code, Cursor, GitHub Copilot, Codex, and [many more](https://www.npmjs.com/package/skills#supported-agents)).
-
-> [!NOTE]
-> The skill is optional — the MCP tools work without it. The skill just gives agents extra context about when and how to use each tool.
-
 #### Editor-specific instructions
 
 <details>
@@ -393,7 +380,7 @@ All MCP tools accept an optional `format` parameter (`json`, `text`, `md`, or `t
 | `teams_get_transcript`     | Get a meeting transcript from a recorded conversation |
 | `teams_whoami`             | Get the authenticated user's display name             |
 
-See [SKILL.md](SKILL.md) for detailed tool descriptions and typical agent workflows.
+Workflow guidance, tips, and important notes are served automatically via the MCP server's `instructions` field — no separate skill file needed. For the same content on the CLI, run `teams-api guide`.
 
 ## API regions
 

package/dist/actions/conversation-resolution.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared conversation resolution logic for actions.
+ *
+ * Provides the standard parameter definitions for identifying a conversation
+ * and a resolver function that supports three identification strategies:
+ * direct ID, topic name match, or person name (1:1 lookup).
+ */
+import type { TeamsClient } from "../teams-client.js";
+import type { ActionParameter } from "./formatters.js";
+/** Shared parameter definitions for conversation identification. */
+export declare const conversationParameters: ActionParameter[];
+/**
+ * Resolve a conversation ID from the standard identification parameters.
+ *
+ * Supports three ways to identify a conversation:
+ *   1. conversationId — direct thread ID
+ *   2. chat — topic name (partial match via findConversation)
+ *   3. to — person name (1:1 lookup via findOneOnOneConversation)
+ *
+ * Returns both the resolved ID and a human-readable label.
+ */
+export declare function resolveConversationId(client: TeamsClient, parameters: Record<string, unknown>): Promise<{
+    conversationId: string;
+    label: string;
+}>;
+//# sourceMappingURL=conversation-resolution.d.ts.map

package/dist/actions/conversation-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-resolution.d.ts","sourceRoot":"","sources":["../../src/actions/conversation-resolution.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,EAAE,eAAe,EAoBnD,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA4CpD"}

package/dist/actions/conversation-resolution.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Shared conversation resolution logic for actions.
+ *
+ * Provides the standard parameter definitions for identifying a conversation
+ * and a resolver function that supports three identification strategies:
+ * direct ID, topic name match, or person name (1:1 lookup).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.conversationParameters = void 0;
+exports.resolveConversationId = resolveConversationId;
+/** Shared parameter definitions for conversation identification. */
+exports.conversationParameters = [
+    {
+        name: "chat",
+        type: "string",
+        description: "Find conversation by topic name (partial match), person name (1:1 fallback), or direct thread ID",
+        required: false,
+    },
+    {
+        name: "to",
+        type: "string",
+        description: "Find 1:1 conversation by person name",
+        required: false,
+    },
+    {
+        name: "conversationId",
+        type: "string",
+        description: "Direct conversation thread ID",
+        required: false,
+    },
+];
+/**
+ * Resolve a conversation ID from the standard identification parameters.
+ *
+ * Supports three ways to identify a conversation:
+ *   1. conversationId — direct thread ID
+ *   2. chat — topic name (partial match via findConversation)
+ *   3. to — person name (1:1 lookup via findOneOnOneConversation)
+ *
+ * Returns both the resolved ID and a human-readable label.
+ */
+async function resolveConversationId(client, parameters) {
+    const conversationId = parameters.conversationId;
+    const chat = parameters.chat;
+    const to = parameters.to;
+    if (conversationId) {
+        return { conversationId, label: conversationId };
+    }
+    if (chat) {
+        // If the value looks like a raw conversation ID, use it directly
+        if (chat.startsWith("19:") && chat.includes("@")) {
+            return { conversationId: chat, label: chat };
+        }
+        const conversation = await client.findConversation(chat);
+        if (conversation) {
+            return { conversationId: conversation.id, label: conversation.topic };
+        }
+        // Fall back to 1:1 resolution (covers person names passed to --chat)
+        const oneOnOne = await client.findOneOnOneConversation(chat);
+        if (oneOnOne) {
+            return {
+                conversationId: oneOnOne.conversationId,
+                label: oneOnOne.memberDisplayName,
+            };
+        }
+        throw new Error(`No conversation matching "${chat}" found.`);
+    }
+    if (to) {
+        const result = await client.findOneOnOneConversation(to);
+        if (!result) {
+            throw new Error(`No 1:1 conversation found with "${to}".`);
+        }
+        return {
+            conversationId: result.conversationId,
+            label: result.memberDisplayName,
+        };
+    }
+    throw new Error("One of --conversation-id, --chat, or --to is required.");
+}
+//# sourceMappingURL=conversation-resolution.js.map

package/dist/actions/conversation-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-resolution.js","sourceRoot":"","sources":["../../src/actions/conversation-resolution.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAsCH,sDA+CC;AAhFD,oEAAoE;AACvD,QAAA,sBAAsB,GAAsB;IACvD;QACE,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,kGAAkG;QACpG,QAAQ,EAAE,KAAK;KAChB;IACD;QACE,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,sCAAsC;QACnD,QAAQ,EAAE,KAAK;KAChB;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,+BAA+B;QAC5C,QAAQ,EAAE,KAAK;KAChB;CACF,CAAC;AAEF;;;;;;;;;GASG;AACI,KAAK,UAAU,qBAAqB,CACzC,MAAmB,EACnB,UAAmC;IAEnC,MAAM,cAAc,GAAG,UAAU,CAAC,cAAoC,CAAC;IACvE,MAAM,IAAI,GAAG,UAAU,CAAC,IAA0B,CAAC;IACnD,MAAM,EAAE,GAAG,UAAU,CAAC,EAAwB,CAAC;IAE/C,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IACnD,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACT,iEAAiE;QACjE,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACjD,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC/C,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC;QACxE,CAAC;QAED,qEAAqE;QACrE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO;gBACL,cAAc,EAAE,QAAQ,CAAC,cAAc;gBACvC,KAAK,EAAE,QAAQ,CAAC,iBAAiB;aAClC,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,UAAU,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,mCAAmC,EAAE,IAAI,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO;YACL,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,KAAK,EAAE,MAAM,CAAC,iBAAiB;SAChC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;AAC5E,CAAC"}

package/dist/actions/definitions.d.ts

@@ -0,0 +1,16 @@
+/**
+ * All action definitions for the Teams API.
+ *
+ * This is the single source of truth for all operations. CLI commands,
+ * MCP tools, and programmatic usage all derive from these definitions.
+ *
+ * Each action declares:
+ *   - name, title, description — shared help text and documentation
+ *   - parameters — typed parameter definitions with descriptions and defaults
+ *   - execute — the implementation, calling TeamsClient methods
+ *   - formatResult — human-readable output formatter (CLI without --json)
+ */
+import { type ActionDefinition } from "./formatters.js";
+/** All registered actions, derived from the registry map. */
+export declare const actions: ActionDefinition[];
+//# sourceMappingURL=definitions.d.ts.map

package/dist/actions/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/actions/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,OAAO,EACL,KAAK,gBAAgB,EAMtB,MAAM,iBAAiB,CAAC;AA27BzB,6DAA6D;AAC7D,eAAO,MAAM,OAAO,EAAE,gBAAgB,EAAwC,CAAC"}