@absolutejs/meeting 0.0.1-beta.0 → 0.0.1-beta.10

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 } 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;
@@ -25,6 +32,25 @@ export type MeetingSession = {
     start: () => Promise<void>;
     /** Leave the call, finalize, and emit `end` with the full transcript. */
     stop: (reason?: string) => Promise<void>;
+    /**
+     * Play audio INTO the call (the bot speaks). Delegates to the source; throws
+     * if the underlying adapter doesn't implement `speak`. See `SpeakAudio` for
+     * the formats each adapter accepts (Recall: mp3; Discord: pcm).
+     */
+    speak: (audio: SpeakAudio) => Promise<void>;
+    /** 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,50 @@ 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
+ * when an adapter is handed a format it cannot play.
+ */
+export type SpeakAudio = {
+    format: "mp3";
+    data: ArrayBuffer | Uint8Array;
+} | {
+    format: "pcm";
+    data: ArrayBuffer | Uint8Array;
+    sampleRateHz: number;
+    channels: number;
+};
 export type MeetingSourceEventMap = {
     /** A chunk of call audio (in `format`). `participant` is set when the source
      *  knows who is speaking for this chunk (per-user streams); otherwise omit it
@@ -15,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: {
@@ -41,4 +92,31 @@ export type MeetingSource = {
     start: () => Promise<void>;
     /** Leave the call / stop streaming. */
     stop: (reason?: string) => Promise<void>;
+    /**
+     * Play audio INTO the call (the bot speaks). Optional — adapters that can't
+     * inject audio simply don't implement it; `meeting.speak()` will throw a
+     * clear error in that case. Resolves when playback finishes (or as soon as
+     * the platform has accepted it, for fire-and-forget transports).
+     */
+    speak?: (audio: SpeakAudio) => Promise<void>;
+    /**
+     * Stop any in-progress `speak()` output immediately (barge-in / ducking).
+     * Optional — sources that can't inject audio (or can't stop it) omit it;
+     * `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,37 +1,72 @@
 {
-	"name": "@absolutejs/meeting",
-	"version": "0.0.1-beta.0",
-	"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"
-	},
-	"files": [
-		"dist",
-		"README.md"
-	],
-	"main": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"exports": {
-		".": {
-			"import": "./dist/index.js",
-			"types": "./dist/index.d.ts"
-		}
-	},
-	"license": "CC BY-NC 4.0",
-	"author": "Alex Kahn",
-	"scripts": {
-		"build": "rm -rf dist && bun build ./src/index.ts --outdir dist --target bun --external @absolutejs/voice && tsc --emitDeclarationOnly --project tsconfig.json",
-		"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"
-	},
-	"devDependencies": {
-		"@types/bun": "1.3.9",
-		"typescript": "^5.9.3"
-	}
+  "name": "@absolutejs/meeting",
+  "version": "0.0.1-beta.10",
+  "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": "git+https://github.com/absolutejs/meeting.git"
+  },
+  "homepage": "https://github.com/absolutejs/meeting",
+  "bugs": {
+    "url": "https://github.com/absolutejs/meeting/issues"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "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": 2,
+    "runtimePeers": {
+      "@absolutejs/voice": {
+        "artifactImports": [
+          "@absolutejs/voice"
+        ],
+        "buildExternals": [
+          "@absolutejs/voice",
+          "@absolutejs/voice/*"
+        ],
+        "optional": false,
+        "range": ">=0.0.22-beta.647 <0.1",
+        "tested": "0.0.22-beta.647"
+      }
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist && bun build ./src/index.ts ./src/manifest.ts --outdir dist --root src --target bun --external @absolutejs/manifest --external '@absolutejs/manifest/*' --external @absolutejs/voice --external '@absolutejs/voice/*' --external @sinclair/typebox --external '@sinclair/typebox/*' && tsc --emitDeclarationOnly --project tsconfig.json && absolute-manifest emit",
+    "format": "prettier --write \"./**/*.{js,ts,json,md}\"",
+    "release": "bun run check:package && npm publish --access public --tag beta",
+    "test": "bun test",
+    "typecheck": "bun run tsc --noEmit",
+    "verify-package": "absolute-manifest verify-package",
+    "check:package": "bun run format && bun run typecheck && bun run test && bun run verify-package && bun run build && bun run verify-package --artifacts"
+  },
+  "dependencies": {
+    "@absolutejs/manifest": "0.7.2",
+    "@sinclair/typebox": "0.34.52"
+  },
+  "devDependencies": {
+    "@absolutejs/voice": "0.0.22-beta.647",
+    "@types/bun": "1.3.14",
+    "elysia": "1.4.29",
+    "prettier": "3.9.6",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "@absolutejs/voice": ">=0.0.22-beta.647 <0.1"
+  }
 }