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

package/dist/manifest.js

@@ -0,0 +1,268 @@
+// @bun
+// src/manifest.ts
+import {
+  defineImplementation,
+  defineManifest,
+  toolFactory
+} from "@absolutejs/manifest";
+import { Type } from "@sinclair/typebox";
+var tool = toolFactory();
+var MAX_TRANSCRIPT_TURNS = 200;
+var DEFAULT_TRANSCRIPT_TURNS = 50;
+var MAX_CHAT_LENGTH = 2000;
+var manifest = defineManifest()({
+  contract: 2,
+  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 \u2014 live transcripts and analysis."
+  },
+  implements: [
+    defineImplementation()({
+      contract: "meeting/source-factory",
+      factory: "createBufferMeetingSourceFactory",
+      from: "@absolutejs/meeting",
+      settings: Type.Object({
+        chunkMs: Type.Optional(Type.Number({
+          description: "How often a slice of the buffer is emitted, in milliseconds. Default 40.",
+          minimum: 1,
+          title: "Chunk cadence"
+        }))
+      }),
+      title: "In-memory audio buffer (testing without a live platform)",
+      wiring: {
+        code: [
+          "createBufferMeetingSourceFactory({",
+          "\tchunkMs: ${settings.chunkMs},",
+          "\tformat: { channels: 1, container: 'raw', encoding: 'pcm_s16le', sampleRateHz: 16000 },",
+          "\t// TODO: supply raw PCM matching `format` (e.g. a recorded test fixture).",
+          "\tpcm: new Uint8Array(0)",
+          "})"
+        ].join(`
+`),
+        imports: [
+          {
+            from: "@absolutejs/meeting",
+            names: ["createBufferMeetingSourceFactory"]
+          }
+        ]
+      }
+    })
+  ],
+  settings: Type.Object({
+    languageStrategy: Type.Optional(Type.Union([
+      Type.Object({
+        allowedLanguages: Type.Optional(Type.Array(Type.String())),
+        mode: Type.Literal("auto-detect")
+      }),
+      Type.Object({
+        mode: Type.Literal("fixed"),
+        primaryLanguage: Type.String(),
+        secondaryLanguages: Type.Optional(Type.Array(Type.String()))
+      }),
+      Type.Object({
+        mode: Type.Literal("allow-switching"),
+        primaryLanguage: Type.Optional(Type.String()),
+        secondaryLanguages: Type.Array(Type.String())
+      })
+    ], {
+      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"
+    })),
+    phraseHints: Type.Optional(Type.Array(Type.Object({
+      aliases: Type.Optional(Type.Array(Type.String())),
+      boost: Type.Optional(Type.Number()),
+      text: Type.String()
+    }), {
+      description: "Names, products, and jargon the transcriber should recognize \u2014 improves accuracy on words unique to your business.",
+      title: "Vocabulary hints"
+    }))
+  }),
+  slots: {
+    source: {
+      configPath: "source",
+      contract: "meeting/source-factory",
+      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
+    }
+  },
+  tools: {
+    join_meeting: tool.runtime({
+      annotations: { idempotentHint: true, openWorldHint: true },
+      authorization: {
+        approval: "policy",
+        audience: "owner",
+        destinations: ["configured-meeting-platform"],
+        effects: ["write", "external-network"],
+        idempotency: { mode: "resource" },
+        requiredScopes: ["meeting:join"],
+        resource: { idField: "sessionId", type: "active-meeting" },
+        reversible: false
+      },
+      description: "Join one call through the configured platform adapter. The target is adapter-defined: a Meet/Zoom/Teams URL for Recall or a voice-channel id for Discord.",
+      handler: async ({ sessionId, target }, meetings) => {
+        await meetings.start({ sessionId, target });
+        return `joined meeting ${sessionId}`;
+      },
+      input: Type.Object({
+        sessionId: Type.String({ minLength: 1 }),
+        target: Type.String({ maxLength: 2048, minLength: 1 })
+      })
+    }),
+    leave_meeting: tool.runtime({
+      annotations: { destructiveHint: true, idempotentHint: true },
+      authorization: {
+        approval: "policy",
+        audience: "owner",
+        destinations: ["configured-meeting-platform"],
+        effects: ["write", "send", "external-network"],
+        idempotency: { mode: "resource" },
+        requiredScopes: ["meeting:leave"],
+        resource: { idField: "sessionId", type: "active-meeting" },
+        reversible: false
+      },
+      description: "Make the bot leave the call, finalize the transcript, and end the session.",
+      handler: async ({ reason, sessionId }, meetings) => {
+        const stopped = await meetings.stop(sessionId, reason);
+        return stopped ? "left the meeting" : "meeting is not active";
+      },
+      input: Type.Object({
+        reason: Type.Optional(Type.String()),
+        sessionId: Type.String({ minLength: 1 })
+      })
+    }),
+    active_meetings: tool.runtime({
+      annotations: { readOnlyHint: true },
+      authorization: {
+        approval: "never",
+        audience: "owner",
+        effects: ["read"],
+        requiredScopes: ["meeting:read"]
+      },
+      description: "List active meeting session identities and targets.",
+      handler: (_input, meetings) => JSON.stringify(meetings.list().map(({ sessionId, target }) => ({
+        sessionId,
+        target
+      }))),
+      input: Type.Object({})
+    }),
+    meeting_participants: tool.runtime({
+      annotations: { readOnlyHint: true },
+      authorization: {
+        approval: "never",
+        audience: "owner",
+        effects: ["read"],
+        requiredScopes: ["meeting:read"]
+      },
+      description: "List the participants the call platform has reported for this meeting.",
+      handler: ({ sessionId }, meetings) => {
+        const meeting = meetings.get(sessionId);
+        if (meeting === undefined)
+          return "meeting is not active";
+        return JSON.stringify(meeting.getParticipants().map((participant) => ({
+          id: participant.id,
+          name: participant.name ?? null,
+          platform: participant.platform ?? null
+        })));
+      },
+      input: Type.Object({ sessionId: Type.String({ minLength: 1 }) })
+    }),
+    meeting_transcript: tool.runtime({
+      annotations: { readOnlyHint: true },
+      authorization: {
+        approval: "never",
+        audience: "owner",
+        effects: ["read"],
+        requiredScopes: ["meeting:read"]
+      },
+      description: "Read the diarized transcript so far \u2014 the most recent turns, each with its speaker and (when known) the resolved participant.",
+      handler: ({ limit, sessionId }, meetings) => {
+        const meeting = meetings.get(sessionId);
+        if (meeting === undefined)
+          return "meeting is not active";
+        const turns = meeting.getTranscript();
+        return JSON.stringify(turns.slice(-(limit ?? DEFAULT_TRANSCRIPT_TURNS)).map((turn) => ({
+          participant: turn.participant?.name ?? null,
+          speaker: turn.speaker,
+          text: turn.text
+        })));
+      },
+      input: Type.Object({
+        limit: Type.Optional(Type.Integer({
+          default: DEFAULT_TRANSCRIPT_TURNS,
+          maximum: MAX_TRANSCRIPT_TURNS,
+          minimum: 1
+        })),
+        sessionId: Type.String({ minLength: 1 })
+      })
+    }),
+    send_chat_message: tool.runtime({
+      annotations: { openWorldHint: true },
+      authorization: {
+        approval: "policy",
+        audience: "owner",
+        destinations: ["configured-meeting-platform"],
+        effects: ["send", "external-network"],
+        idempotency: { mode: "resource" },
+        requiredScopes: ["meeting:chat:send"],
+        resource: { idField: "sessionId", type: "active-meeting" },
+        reversible: false
+      },
+      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).",
+      handler: async ({ sessionId, text }, meetings) => {
+        const meeting = meetings.get(sessionId);
+        if (meeting === undefined)
+          return "meeting is not active";
+        if (!meeting.capabilities.canChat) {
+          return "this meeting's platform adapter can't post to the call chat";
+        }
+        await meeting.sendChat(text);
+        return "chat message sent";
+      },
+      input: Type.Object({
+        sessionId: Type.String({ minLength: 1 }),
+        text: Type.String({ maxLength: MAX_CHAT_LENGTH, minLength: 1 })
+      })
+    })
+  },
+  wiring: [
+    {
+      description: "Create a multi-session meeting manager. Joining a specific call is an explicit governed action, so installation never contacts a meeting platform.",
+      id: "default",
+      server: {
+        code: [
+          "const meetings = createMeetingManager({",
+          "\tlanguageStrategy: ${settings.languageStrategy},",
+          "\tphraseHints: ${settings.phraseHints},",
+          "\tsource: ${slot.source},",
+          "\tstt: ${slot.stt}",
+          "});"
+        ].join(`
+`),
+        imports: [
+          { from: "@absolutejs/meeting", names: ["createMeetingManager"] }
+        ],
+        placement: "module-scope"
+      },
+      title: "Create the meeting manager"
+    }
+  ]
+});
+export {
+  manifest
+};

package/dist/manifest.json

@@ -0,0 +1,408 @@
+{
+	"contract": 2,
+	"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",
+			"factory": "createBufferMeetingSourceFactory",
+			"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": "createBufferMeetingSourceFactory({\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": [
+							"createBufferMeetingSourceFactory"
+						]
+					}
+				]
+			}
+		}
+	],
+	"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-factory",
+			"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": "Create a multi-session meeting manager. Joining a specific call is an explicit governed action, so installation never contacts a meeting platform.",
+			"id": "default",
+			"server": {
+				"code": "const meetings = createMeetingManager({\n\tlanguageStrategy: ${settings.languageStrategy},\n\tphraseHints: ${settings.phraseHints},\n\tsource: ${slot.source},\n\tstt: ${slot.stt}\n});",
+				"imports": [
+					{
+						"from": "@absolutejs/meeting",
+						"names": [
+							"createMeetingManager"
+						]
+					}
+				],
+				"placement": "module-scope"
+			},
+			"title": "Create the meeting manager"
+		}
+	],
+	"tools": {
+		"join_meeting": {
+			"annotations": {
+				"idempotentHint": true,
+				"openWorldHint": true
+			},
+			"authorization": {
+				"approval": "policy",
+				"audience": "owner",
+				"destinations": [
+					"configured-meeting-platform"
+				],
+				"effects": [
+					"write",
+					"external-network"
+				],
+				"idempotency": {
+					"mode": "resource"
+				},
+				"requiredScopes": [
+					"meeting:join"
+				],
+				"resource": {
+					"idField": "sessionId",
+					"type": "active-meeting"
+				},
+				"reversible": false
+			},
+			"description": "Join one call through the configured platform adapter. The target is adapter-defined: a Meet/Zoom/Teams URL for Recall or a voice-channel id for Discord.",
+			"input": {
+				"type": "object",
+				"required": [
+					"sessionId",
+					"target"
+				],
+				"properties": {
+					"sessionId": {
+						"minLength": 1,
+						"type": "string"
+					},
+					"target": {
+						"maxLength": 2048,
+						"minLength": 1,
+						"type": "string"
+					}
+				}
+			},
+			"kind": "runtime"
+		},
+		"leave_meeting": {
+			"annotations": {
+				"destructiveHint": true,
+				"idempotentHint": true
+			},
+			"authorization": {
+				"approval": "policy",
+				"audience": "owner",
+				"destinations": [
+					"configured-meeting-platform"
+				],
+				"effects": [
+					"write",
+					"send",
+					"external-network"
+				],
+				"idempotency": {
+					"mode": "resource"
+				},
+				"requiredScopes": [
+					"meeting:leave"
+				],
+				"resource": {
+					"idField": "sessionId",
+					"type": "active-meeting"
+				},
+				"reversible": false
+			},
+			"description": "Make the bot leave the call, finalize the transcript, and end the session.",
+			"input": {
+				"type": "object",
+				"required": [
+					"sessionId"
+				],
+				"properties": {
+					"reason": {
+						"type": "string"
+					},
+					"sessionId": {
+						"minLength": 1,
+						"type": "string"
+					}
+				}
+			},
+			"kind": "runtime"
+		},
+		"active_meetings": {
+			"annotations": {
+				"readOnlyHint": true
+			},
+			"authorization": {
+				"approval": "never",
+				"audience": "owner",
+				"effects": [
+					"read"
+				],
+				"requiredScopes": [
+					"meeting:read"
+				]
+			},
+			"description": "List active meeting session identities and targets.",
+			"input": {
+				"type": "object",
+				"properties": {}
+			},
+			"kind": "runtime"
+		},
+		"meeting_participants": {
+			"annotations": {
+				"readOnlyHint": true
+			},
+			"authorization": {
+				"approval": "never",
+				"audience": "owner",
+				"effects": [
+					"read"
+				],
+				"requiredScopes": [
+					"meeting:read"
+				]
+			},
+			"description": "List the participants the call platform has reported for this meeting.",
+			"input": {
+				"type": "object",
+				"required": [
+					"sessionId"
+				],
+				"properties": {
+					"sessionId": {
+						"minLength": 1,
+						"type": "string"
+					}
+				}
+			},
+			"kind": "runtime"
+		},
+		"meeting_transcript": {
+			"annotations": {
+				"readOnlyHint": true
+			},
+			"authorization": {
+				"approval": "never",
+				"audience": "owner",
+				"effects": [
+					"read"
+				],
+				"requiredScopes": [
+					"meeting:read"
+				]
+			},
+			"description": "Read the diarized transcript so far — the most recent turns, each with its speaker and (when known) the resolved participant.",
+			"input": {
+				"type": "object",
+				"required": [
+					"sessionId"
+				],
+				"properties": {
+					"limit": {
+						"default": 50,
+						"maximum": 200,
+						"minimum": 1,
+						"type": "integer"
+					},
+					"sessionId": {
+						"minLength": 1,
+						"type": "string"
+					}
+				}
+			},
+			"kind": "runtime"
+		},
+		"send_chat_message": {
+			"annotations": {
+				"openWorldHint": true
+			},
+			"authorization": {
+				"approval": "policy",
+				"audience": "owner",
+				"destinations": [
+					"configured-meeting-platform"
+				],
+				"effects": [
+					"send",
+					"external-network"
+				],
+				"idempotency": {
+					"mode": "resource"
+				},
+				"requiredScopes": [
+					"meeting:chat:send"
+				],
+				"resource": {
+					"idField": "sessionId",
+					"type": "active-meeting"
+				},
+				"reversible": false
+			},
+			"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": [
+					"sessionId",
+					"text"
+				],
+				"properties": {
+					"sessionId": {
+						"minLength": 1,
+						"type": "string"
+					},
+					"text": {
+						"maxLength": 2000,
+						"minLength": 1,
+						"type": "string"
+					}
+				}
+			},
+			"kind": "runtime"
+		}
+	}
+}