@cuylabs/channel-teams-agent-core 0.4.0

package/dist/proactive.d.ts

@@ -0,0 +1,40 @@
+import { TurnContext } from '@microsoft/agents-hosting';
+import { Conversation } from '@cuylabs/channel-m365-agent-core/proactive';
+export { Conversation, ConversationBuilder, ConversationClaims, ConversationReference, ConversationReferenceBuilder, CreateConversationOptions, CreateConversationOptionsBuilder, M365ConversationInput, M365ConversationRecord, ProactiveIdentity, captureM365ConversationReference, continueM365Conversation, restoreM365ConversationReference } from '@cuylabs/channel-m365-agent-core/proactive';
+import { TeamsActivityInfo } from '@cuylabs/channel-teams';
+
+/**
+ * Proactive messaging primitives for the Teams channel.
+ *
+ * Re-exports the M365 proactive bridge so Teams consumers have a single
+ * import surface, plus a Teams-specific helper that captures a
+ * {@link Conversation} together with the parsed Teams metadata most apps
+ * need at replay time (tenant, surface, team, channel thread, meeting id).
+ *
+ * Use this module when an app needs to send a message into Teams without an
+ * inbound turn — async tool completions, mail dispatcher results,
+ * notifications, scheduled reminders.
+ */
+
+/**
+ * Captured Teams conversation reference plus parsed channel metadata.
+ *
+ * The {@link Conversation} is what `continueM365Conversation` needs to replay
+ * a turn; `teams` is the parsed {@link TeamsActivityInfo} so callers can
+ * persist surface / tenant / team / channel ids alongside the reference for
+ * later routing decisions.
+ */
+interface TeamsProactiveCapture {
+    conversation: Conversation;
+    teams: TeamsActivityInfo;
+}
+/**
+ * Capture a serializable {@link Conversation} from a live Teams turn alongside
+ * the parsed Teams metadata. Validates the captured reference.
+ *
+ * Persist the result to your storage of choice; replay later through
+ * `continueM365Conversation(adapter, capture.conversation, async (ctx) => …)`.
+ */
+declare function captureTeamsConversationReference(context: TurnContext): TeamsProactiveCapture;
+
+export { type TeamsProactiveCapture, captureTeamsConversationReference };

package/dist/proactive.js

@@ -0,0 +1,20 @@
+import {
+  Conversation,
+  ConversationBuilder,
+  ConversationReferenceBuilder,
+  CreateConversationOptionsBuilder,
+  captureM365ConversationReference,
+  captureTeamsConversationReference,
+  continueM365Conversation,
+  restoreM365ConversationReference
+} from "./chunk-ZULHZARA.js";
+export {
+  Conversation,
+  ConversationBuilder,
+  ConversationReferenceBuilder,
+  CreateConversationOptionsBuilder,
+  captureM365ConversationReference,
+  captureTeamsConversationReference,
+  continueM365Conversation,
+  restoreM365ConversationReference
+};

package/docs/README.md

@@ -0,0 +1,16 @@
+# @cuylabs/channel-teams-agent-core Docs
+
+This package contains the Teams adapter for `@cuylabs/agent-core`.
+
+## Concepts
+
+- `createTeamsChannelAdapter` wraps the generic M365 adapter with Teams routing.
+- `mountTeamsAgent` mounts the adapter behind an Express route.
+- Teams handlers can answer invoke activities directly with `ctx.sendInvoke`.
+- Teams handlers can call `ctx.runAgent(...)` to start an agent turn inside the
+  active Teams request context.
+- `currentTeamsTurnContext()` exposes parsed Teams metadata to tools and
+  middleware during a turn.
+
+For Teams primitives without an agent runtime dependency, use
+`@cuylabs/channel-teams`.

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "@cuylabs/channel-teams-agent-core",
+  "version": "0.4.0",
+  "description": "Teams adapter for @cuylabs/agent-core built on @cuylabs/channel-teams",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./extensions": {
+      "types": "./dist/extensions.d.ts",
+      "import": "./dist/extensions.js",
+      "default": "./dist/extensions.js"
+    },
+    "./proactive": {
+      "types": "./dist/proactive.d.ts",
+      "import": "./dist/proactive.js",
+      "default": "./dist/proactive.js"
+    }
+  },
+  "files": [
+    "dist",
+    "docs",
+    "README.md"
+  ],
+  "dependencies": {
+    "@cuylabs/agent-core": "^7.2.0",
+    "@cuylabs/channel-m365-agent-core": "^0.4.0",
+    "@cuylabs/channel-teams": "^0.4.0"
+  },
+  "peerDependencies": {
+    "@microsoft/agents-activity": "^1.5.0",
+    "@microsoft/agents-hosting": "^1.5.0",
+    "@microsoft/agents-hosting-extensions-teams": "^1.5.0",
+    "@microsoft/agents-telemetry": "^1.5.0",
+    "express": ">=4.21.0 || >=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@microsoft/agents-telemetry": {
+      "optional": true
+    },
+    "express": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@microsoft/agents-activity": "^1.5.3",
+    "@microsoft/agents-hosting": "^1.5.3",
+    "@microsoft/agents-hosting-extensions-teams": "^1.5.3",
+    "@microsoft/agents-telemetry": "^1.5.3",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "express": "^5.2.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  },
+  "keywords": [
+    "agent",
+    "teams",
+    "microsoft",
+    "m365",
+    "channel",
+    "adapter",
+    "agent-core"
+  ],
+  "author": "cuylabs",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cuylabs-ai/agent-channels-ts.git",
+    "directory": "packages/channel-teams-agent-core"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/extensions.ts src/proactive.ts --format esm --dts --clean",
+    "clean": "rm -rf dist",
+    "dev": "tsup src/index.ts src/extensions.ts src/proactive.ts --format esm --dts --watch",
+    "lint": "eslint \"src/**/*.{ts,tsx}\" \"tests/**/*.{ts,tsx}\" --max-warnings=0",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}