@absolutejs/meeting 0.0.1-beta.4 → 0.0.1-beta.6

package/dist/manifest.json

@@ -0,0 +1,247 @@
+{
+	"contract": 1,
+	"identity": {
+		"accent": "#f97316",
+		"category": "voice",
+		"description": "Meeting-bot core: join a call through a `MeetingSource` platform adapter (`@absolutejs/meeting-*`), transcribe it live with the `@absolutejs/voice` scribe, and surface diarized turns, the participant roster, and call chat for analysis (deal coaching, summaries, action items). The bot can also speak into the call and post chat where the platform allows.",
+		"docsUrl": "https://github.com/absolutejs/meeting",
+		"name": "@absolutejs/meeting",
+		"tagline": "Put a bot in your meetings — live transcripts and analysis."
+	},
+	"implements": [
+		{
+			"contract": "meeting/source",
+			"factory": "createBufferMeetingSource",
+			"from": "@absolutejs/meeting",
+			"settings": {
+				"type": "object",
+				"properties": {
+					"chunkMs": {
+						"description": "How often a slice of the buffer is emitted, in milliseconds. Default 40.",
+						"minimum": 1,
+						"title": "Chunk cadence",
+						"type": "number"
+					}
+				}
+			},
+			"title": "In-memory audio buffer (testing without a live platform)",
+			"wiring": {
+				"code": "createBufferMeetingSource({\n\tchunkMs: ${settings.chunkMs},\n\tformat: { channels: 1, container: 'raw', encoding: 'pcm_s16le', sampleRateHz: 16000 },\n\t// TODO: supply raw PCM matching `format` (e.g. a recorded test fixture).\n\tpcm: new Uint8Array(0)\n})",
+				"imports": [
+					{
+						"from": "@absolutejs/meeting",
+						"names": [
+							"createBufferMeetingSource"
+						]
+					}
+				]
+			}
+		}
+	],
+	"settings": {
+		"type": "object",
+		"properties": {
+			"languageStrategy": {
+				"description": "What languages the calls are in. Auto-detect works for most teams; pin a language for better accuracy in single-language calls.",
+				"title": "Meeting languages",
+				"anyOf": [
+					{
+						"type": "object",
+						"required": [
+							"mode"
+						],
+						"properties": {
+							"allowedLanguages": {
+								"type": "array",
+								"items": {
+									"type": "string"
+								}
+							},
+							"mode": {
+								"const": "auto-detect",
+								"type": "string"
+							}
+						}
+					},
+					{
+						"type": "object",
+						"required": [
+							"mode",
+							"primaryLanguage"
+						],
+						"properties": {
+							"mode": {
+								"const": "fixed",
+								"type": "string"
+							},
+							"primaryLanguage": {
+								"type": "string"
+							},
+							"secondaryLanguages": {
+								"type": "array",
+								"items": {
+									"type": "string"
+								}
+							}
+						}
+					},
+					{
+						"type": "object",
+						"required": [
+							"mode",
+							"secondaryLanguages"
+						],
+						"properties": {
+							"mode": {
+								"const": "allow-switching",
+								"type": "string"
+							},
+							"primaryLanguage": {
+								"type": "string"
+							},
+							"secondaryLanguages": {
+								"type": "array",
+								"items": {
+									"type": "string"
+								}
+							}
+						}
+					}
+				]
+			},
+			"phraseHints": {
+				"description": "Names, products, and jargon the transcriber should recognize — improves accuracy on words unique to your business.",
+				"title": "Vocabulary hints",
+				"type": "array",
+				"items": {
+					"type": "object",
+					"required": [
+						"text"
+					],
+					"properties": {
+						"aliases": {
+							"type": "array",
+							"items": {
+								"type": "string"
+							}
+						},
+						"boost": {
+							"type": "number"
+						},
+						"text": {
+							"type": "string"
+						}
+					}
+				}
+			}
+		}
+	},
+	"slots": {
+		"source": {
+			"configPath": "source",
+			"contract": "meeting/source",
+			"description": "The platform the bot joins calls on",
+			"known": [
+				"@absolutejs/meeting-recall",
+				"@absolutejs/meeting-discord",
+				"@absolutejs/meeting#buffer"
+			],
+			"required": true
+		},
+		"stt": {
+			"configPath": "stt",
+			"contract": "voice/stt",
+			"description": "Who turns the call audio into text",
+			"known": [
+				"@absolutejs/voice-deepgram"
+			],
+			"required": true
+		}
+	},
+	"wiring": [
+		{
+			"description": "The bot joins the call via the source adapter; the scribe streams back diarized turns and the final transcript.",
+			"id": "default",
+			"server": {
+				"code": "const meeting = await createMeeting({\n\tlanguageStrategy: ${settings.languageStrategy},\n\tphraseHints: ${settings.phraseHints},\n\tsessionId: crypto.randomUUID(),\n\tsource: ${slot.source},\n\tstt: ${slot.stt}\n});\n\nmeeting.on('turn', ({ turn }) => {\n\t// TODO: stream diarized turns to your analyzer / UI.\n});\nmeeting.on('end', ({ transcript }) => {\n\t// TODO: persist or analyze the full transcript.\n});\n\nawait meeting.start(); // the bot joins the call",
+				"imports": [
+					{
+						"from": "@absolutejs/meeting",
+						"names": [
+							"createMeeting"
+						]
+					}
+				],
+				"placement": "module-scope"
+			},
+			"title": "Join a call and transcribe it live"
+		}
+	],
+	"tools": {
+		"leave_meeting": {
+			"annotations": {
+				"destructiveHint": true,
+				"idempotentHint": true
+			},
+			"description": "Make the bot leave the call, finalize the transcript, and end the session.",
+			"input": {
+				"type": "object",
+				"properties": {
+					"reason": {
+						"type": "string"
+					}
+				}
+			},
+			"kind": "runtime"
+		},
+		"meeting_participants": {
+			"annotations": {
+				"readOnlyHint": true
+			},
+			"description": "List the participants the call platform has reported for this meeting.",
+			"input": {
+				"type": "object",
+				"properties": {}
+			},
+			"kind": "runtime"
+		},
+		"meeting_transcript": {
+			"annotations": {
+				"readOnlyHint": true
+			},
+			"description": "Read the diarized transcript so far — the most recent turns, each with its speaker and (when known) the resolved participant.",
+			"input": {
+				"type": "object",
+				"properties": {
+					"limit": {
+						"default": 50,
+						"maximum": 200,
+						"minimum": 1,
+						"type": "integer"
+					}
+				}
+			},
+			"kind": "runtime"
+		},
+		"send_chat_message": {
+			"annotations": {
+				"openWorldHint": true
+			},
+			"description": "Post a text message into the call chat as the bot. Fails cleanly when the platform adapter can't write chat (check first: not every source supports it).",
+			"input": {
+				"type": "object",
+				"required": [
+					"text"
+				],
+				"properties": {
+					"text": {
+						"maxLength": 2000,
+						"minLength": 1,
+						"type": "string"
+					}
+				}
+			},
+			"kind": "runtime"
+		}
+	}
+}

package/dist/meeting.d.ts

@@ -1,5 +1,5 @@
 import { type STTAdapter, type VoiceLanguageStrategy, type VoiceLexiconEntry, type VoicePhraseHint, type VoiceScribeTurn } from "@absolutejs/voice";
-import type { MeetingParticipant, MeetingSource, SpeakAudio } from "./source";
+import type { ChatMessage, MeetingCapabilities, MeetingParticipant, MeetingSource, SpeakAudio } from "./source";
 export type MeetingTurn = VoiceScribeTurn & {
     /** Resolved participant for this turn, when the source identified speakers. */
     participant?: MeetingParticipant;
@@ -8,8 +8,15 @@ export type MeetingEventMap = {
     turn: {
         turn: MeetingTurn;
     };
+    /** Roster update. `status` mirrors the source: "joined"/absent on appear,
+     *  "left" when a participant leaves the call. */
     participant: {
         participant: MeetingParticipant;
+        status?: "joined" | "left";
+    };
+    /** A text message arrived in the call chat. */
+    chat: {
+        message: ChatMessage;
     };
     end: {
         reason?: string;
@@ -34,6 +41,16 @@ export type MeetingSession = {
     /** Cut the bot's in-progress speech (barge-in). No-op when the source can't
      *  inject/stop audio or nothing is playing. */
     stopSpeaking: () => Promise<void>;
+    /**
+     * Post a text message INTO the call chat. Delegates to the source; throws if
+     * the underlying adapter doesn't implement `sendChat`. `opts.system` is a hint
+     * for platforms that distinguish system messages (ignored elsewhere).
+     */
+    sendChat: (text: string, opts?: {
+        system?: boolean;
+    }) => Promise<void>;
+    /** What the underlying source can do (speak / chat). */
+    readonly capabilities: MeetingCapabilities;
     getTranscript: () => MeetingTurn[];
     getParticipants: () => MeetingParticipant[];
 };

package/dist/source.d.ts

@@ -7,6 +7,36 @@ export type MeetingParticipant = {
     platform?: string;
     metadata?: Record<string, unknown>;
 };
+/**
+ * A text message in the call's chat. `kind` distinguishes ordinary messages
+ * from emoji reactions and platform/system notices; everything but `text` is
+ * best-effort and may be absent depending on what the source can report.
+ */
+export type ChatMessage = {
+    /** The message body (or reaction emoji / system text). */
+    text: string;
+    /** What sort of chat event this is. Defaults to a normal "message". */
+    kind?: "message" | "reaction" | "system";
+    /** Resolved sender, when the source identified them. */
+    author?: MeetingParticipant;
+    /** Raw platform sender id, even when the full participant isn't resolved. */
+    authorId?: string;
+    /** Epoch ms the message was sent, when the source reports it. */
+    timestamp?: number;
+    /** Platform channel/thread id the message belongs to, when applicable. */
+    channelId?: string;
+};
+/**
+ * Which in-call outputs a source supports. Mirrors the optional `speak` /
+ * `sendChat` members so a consumer can branch on capabilities up front instead
+ * of probing for thrown "not implemented" errors.
+ */
+export type MeetingCapabilities = {
+    /** The bot can play audio INTO the call (`speak`). */
+    canSpeak: boolean;
+    /** The bot can post text into the call chat (`sendChat`). */
+    canChat: boolean;
+};
 /**
  * Audio the bot wants to play INTO the call. Adapters declare which formats
  * they accept (Recall: mp3; Discord: pcm); a TypeError is the right signal
@@ -29,9 +59,16 @@ export type MeetingSourceEventMap = {
         chunk: AudioChunk;
         participant?: string;
     };
-    /** Roster update — someone joined / was identified. */
+    /** Roster update — someone joined / left / was identified. `status` signals
+     *  the transition: "joined" (or absent — the historical behavior) when a
+     *  participant appears/is identified, "left" when they leave the call. */
     participant: {
         participant: MeetingParticipant;
+        status?: "joined" | "left";
+    };
+    /** A text message arrived in the call chat. */
+    chat: {
+        message: ChatMessage;
     };
     /** The call ended (everyone left, host stopped, etc.). */
     end: {
@@ -68,4 +105,18 @@ export type MeetingSource = {
      * `meeting.stopSpeaking()` then no-ops.
      */
     stopSpeaking?: () => Promise<void>;
+    /**
+     * Post a text message INTO the call chat. Optional — adapters that can't write
+     * chat simply don't implement it; `meeting.sendChat()` will throw a clear
+     * error in that case. `opts.system` is a hint for platforms that distinguish
+     * system/announcement messages from ordinary ones (ignored elsewhere).
+     */
+    sendChat?: (text: string, opts?: {
+        system?: boolean;
+    }) => Promise<void>;
+    /**
+     * What this source can do (speak / chat). Optional — when absent, consumers
+     * fall back to probing the presence of `speak` / `sendChat`.
+     */
+    readonly capabilities?: MeetingCapabilities;
 };

package/package.json

@@ -1,11 +1,15 @@
 {
 	"name": "@absolutejs/meeting",
-	"version": "0.0.1-beta.4",
+	"version": "0.0.1-beta.6",
 	"description": "Meeting-bot core for AbsoluteJS — join a call (via a source adapter), transcribe it live with the voice scribe, and surface diarized turns + participants for analysis",
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/absolutejs/meeting.git"
 	},
+	"homepage": "https://github.com/absolutejs/meeting",
+	"bugs": {
+		"url": "https://github.com/absolutejs/meeting/issues"
+	},
 	"files": [
 		"dist",
 		"README.md"
@@ -16,19 +20,29 @@
 		".": {
 			"import": "./dist/index.js",
 			"types": "./dist/index.d.ts"
-		}
+		},
+		"./manifest": {
+			"import": "./dist/manifest.js",
+			"types": "./dist/manifest.d.ts"
+		},
+		"./manifest.json": "./dist/manifest.json"
 	},
 	"license": "BSL-1.1",
 	"author": "Alex Kahn",
+	"absolutejs": {
+		"manifestContract": 1
+	},
 	"scripts": {
-		"build": "rm -rf dist && bun build ./src/index.ts --outdir dist --target bun --external @absolutejs/voice && tsc --emitDeclarationOnly --project tsconfig.json",
+		"build": "rm -rf dist && bun build ./src/index.ts ./src/manifest.ts --outdir dist --root src --target bun --external @absolutejs/voice && tsc --emitDeclarationOnly --project tsconfig.json && absolute-manifest emit",
 		"format": "prettier --write \"./**/*.{js,ts,json,md}\"",
 		"release": "bun run format && bun run build && bun publish",
 		"test": "bun test",
 		"typecheck": "bun run tsc --noEmit"
 	},
 	"dependencies": {
-		"@absolutejs/voice": "0.0.22-beta.550"
+		"@absolutejs/manifest": "^0.1.0",
+		"@absolutejs/voice": "0.0.22-beta.550",
+		"@sinclair/typebox": "^0.34.0"
 	},
 	"devDependencies": {
 		"@types/bun": "1.3.9",