@memberjunction/messaging-adapters 0.0.1 → 5.18.0

package/dist/teams/teams-card-builder.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @module @memberjunction/messaging-adapters
+ * @description Rich Adaptive Card builder functions for Teams agent responses.
+ *
+ * Composes structured Adaptive Card v1.4 layouts from agent execution results,
+ * including agent identity headers, text content, action buttons, explorer
+ * deep-links, and metadata footers.
+ *
+ * Mirrors the layout and feature parity of `slack-block-builder.ts` using
+ * Microsoft Adaptive Card elements instead of Slack Block Kit.
+ *
+ * @see https://adaptivecards.io/designer/
+ * @see https://learn.microsoft.com/en-us/adaptive-cards/
+ */
+import { ExecuteAgentResult, MJAIAgentEntityExtended, ActionableCommand, AgentResponseForm } from '@memberjunction/ai-core-plus';
+/**
+ * Options for building a rich Adaptive Card response.
+ */
+export interface BuildRichCardOptions {
+    /** Base URL of MJ Explorer for deep-linking. */
+    explorerBaseURL?: string;
+    /** MJ Conversation Artifact ID — links to the artifact viewer. */
+    artifactId?: string;
+    /** MJ Conversation ID — links to the conversation in MJ Explorer. */
+    conversationId?: string;
+}
+/**
+ * Build the complete Adaptive Card for an agent response.
+ *
+ * Layout:
+ * ```
+ * ┌─────────────────────────────────┐
+ * │ [Avatar] **Agent Name**         │  ← ColumnSet (agent header)
+ * │─────────────────────────────────│  ← separator on next element
+ * │ Response text (TextBlocks)      │  ← from splitMarkdownIntoSections
+ * │                                 │
+ * │ ┌─ Artifact link ─────────────┐ │  ← Container (if artifact/conversation)
+ * │ │ View in MJ Explorer         │ │
+ * │ └─────────────────────────────┘ │
+ * │                                 │
+ * │ Completed in 4.2s · 1,240 tok  │  ← TextBlock (subtle footer)
+ * ├─────────────────────────────────┤
+ * │ [Action1] [Action2] [Explorer]  │  ← actions[] array
+ * └─────────────────────────────────┘
+ * ```
+ */
+export declare function buildRichAdaptiveCard(result: ExecuteAgentResult | null, agent: MJAIAgentEntityExtended, responseText: string, options?: BuildRichCardOptions): Record<string, unknown>;
+/**
+ * Build a ColumnSet showing the agent's avatar and name.
+ */
+export declare function buildAgentHeader(agent: MJAIAgentEntityExtended): Record<string, unknown>;
+/**
+ * Convert markdown text to Adaptive Card TextBlock elements.
+ * Uses `splitMarkdownIntoSections` from the shared message formatter.
+ */
+export declare function buildTextBody(markdown: string): Record<string, unknown>[];
+/**
+ * Build an Adaptive Card Container linking to the artifact in MJ Explorer.
+ * Returns null if no explorer URL or neither artifact/conversation ID is available.
+ */
+export declare function buildArtifactCard(artifactId: string, explorerBaseURL: string): Record<string, unknown>;
+/**
+ * Build Action.OpenUrl buttons from actionable commands.
+ * Handles `open:url` and `open:resource` command types.
+ * Returns at most 5 action buttons.
+ */
+export declare function buildActionButtons(commands: ActionableCommand[], explorerBaseURL?: string): Record<string, unknown>[];
+/**
+ * Build an "Open in MJ Explorer" Action.OpenUrl.
+ * Prefers artifact link; falls back to conversation link.
+ * Returns null if neither ID is available or no explorer URL.
+ */
+export declare function buildExplorerLink(explorerBaseURL?: string, artifactId?: string, conversationId?: string): Record<string, unknown> | null;
+/**
+ * Build a subtle metadata footer with timing and token info.
+ */
+export declare function buildMetadataFooter(result: ExecuteAgentResult): Record<string, unknown>;
+/**
+ * Build a full Adaptive Card for an error message.
+ */
+export declare function buildErrorCard(errorMessage: string): Record<string, unknown>;
+/**
+ * Build response form elements from an AgentResponseForm.
+ *
+ * Adaptive Cards support native input elements (Input.Text, Input.Number,
+ * Input.Date, Input.Time, Input.ChoiceSet) so we render the form inline
+ * in the card body rather than requiring a separate modal.
+ *
+ * Note: Action.Submit handlers are out of scope — forms are rendered
+ * read-only as a summary for now. Full interactivity is follow-up work
+ * (requires Task Modules or Action.Submit webhook handling).
+ */
+export declare function buildResponseFormElements(form: AgentResponseForm): Record<string, unknown>[];
+//# sourceMappingURL=teams-card-builder.d.ts.map

package/dist/teams/teams-card-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams-card-builder.d.ts","sourceRoot":"","sources":["../../src/teams/teams-card-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,iBAAiB,EAAsD,iBAAiB,EAAgB,MAAM,8BAA8B,CAAC;AAoBnM;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACjC,MAAM,EAAE,kBAAkB,GAAG,IAAI,EACjC,KAAK,EAAE,uBAAuB,EAC9B,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuDzB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmCxF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CA6CzE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBzB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAC9B,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,eAAe,CAAC,EAAE,MAAM,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAwB3B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC7B,eAAe,CAAC,EAAE,MAAM,EACxB,UAAU,CAAC,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAuBhC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsCvF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAe5E;AAmCD;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAgD5F"}