@meetopenbot/plugin-sdk 0.2.0 → 0.4.0

package/dist/model-registry.js

@@ -0,0 +1,109 @@
+const DEFAULT_REGISTRY_URL = 'https://raw.githubusercontent.com/meetopenbot/openbot-registry/main/registry.json';
+export const API_KEY_PROVIDER_IDS = ['openai', 'anthropic', 'google', 'deepseek'];
+export const PROVIDER_API_KEY_LINKS = {
+    openai: 'https://platform.openai.com/api-keys',
+    anthropic: 'https://console.anthropic.com/settings/keys',
+    google: 'https://aistudio.google.com/app/apikey',
+    deepseek: 'https://platform.deepseek.com/api_keys',
+};
+const FALLBACK_PROVIDERS = [
+    { id: 'openai', label: 'OpenAI' },
+    { id: 'anthropic', label: 'Anthropic' },
+    { id: 'google', label: 'Google' },
+    { id: 'deepseek', label: 'DeepSeek' },
+];
+let cachedRegistry;
+export async function fetchModelRegistry() {
+    if (cachedRegistry !== undefined)
+        return cachedRegistry;
+    const url = process.env.OPENBOT_MODEL_REGISTRY_URL?.trim() || DEFAULT_REGISTRY_URL;
+    try {
+        const response = await fetch(url, {
+            headers: { Accept: 'application/json' },
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!response.ok) {
+            cachedRegistry = null;
+            return null;
+        }
+        cachedRegistry = (await response.json());
+        return cachedRegistry;
+    }
+    catch {
+        cachedRegistry = null;
+        return null;
+    }
+}
+/** Test-only: drop the in-memory registry cache. */
+export function resetModelRegistryCache() {
+    cachedRegistry = undefined;
+}
+export function listApiKeyProviders(registry) {
+    if (!registry?.providers)
+        return FALLBACK_PROVIDERS;
+    const providers = API_KEY_PROVIDER_IDS.flatMap((id) => {
+        const provider = registry.providers?.[id];
+        return provider ? [{ id, label: provider.label }] : [];
+    });
+    return providers.length > 0 ? providers : FALLBACK_PROVIDERS;
+}
+export function getProviderModelOptions(registry, provider) {
+    const models = registry?.providers?.[provider]?.models;
+    if (!models?.length)
+        return undefined;
+    return models.map((model) => ({ label: model.label, value: model.id }));
+}
+function modelValue(providerId, modelId, format) {
+    return format === 'raw' ? modelId : `${providerId}/${modelId}`;
+}
+/** Registry-backed `configSchema` model field (`enum` + labeled `options`). */
+export async function modelConfigField(options) {
+    const valueFormat = options.valueFormat ?? 'prefixed';
+    const fallback = {
+        type: 'string',
+        description: options.fallbackDescription ??
+            options.description ??
+            'Model id from the OpenBot registry.',
+        ...(options.defaultValue ? { default: options.defaultValue } : {}),
+        ...(options.override ? { override: true } : {}),
+    };
+    const registry = await fetchModelRegistry();
+    const fieldOptions = [
+        ...(options.extraOptions ?? []),
+    ];
+    for (const providerId of options.providers) {
+        const provider = registry?.providers?.[providerId];
+        if (!provider)
+            continue;
+        for (const model of provider.models ?? []) {
+            fieldOptions.push({
+                value: modelValue(providerId, model.id, valueFormat),
+                label: options.providers.length > 1
+                    ? `${provider.label} — ${model.label}`
+                    : model.label,
+                description: model.description,
+            });
+        }
+    }
+    const extraCount = options.extraOptions?.length ?? 0;
+    if (fieldOptions.length <= extraCount)
+        return fallback;
+    const modelOptions = fieldOptions.slice(extraCount);
+    const matched = (options.defaultMatch
+        ? modelOptions.find((option) => options.defaultMatch?.test(option.value))
+        : undefined) ??
+        (options.defaultValue
+            ? modelOptions.find((option) => option.value === options.defaultValue)
+            : undefined) ??
+        modelOptions[0];
+    const defaultValue = options.extraOptions?.[0]?.value ?? matched?.value ?? options.defaultValue;
+    return {
+        type: 'string',
+        description: options.description ?? 'Model from the OpenBot registry.',
+        ...(defaultValue ? { default: defaultValue } : {}),
+        ...(options.override ? { override: true } : {}),
+        enum: fieldOptions.map((option) => option.value),
+        options: fieldOptions,
+    };
+}
+//# sourceMappingURL=model-registry.js.map

package/dist/model-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-registry.js","sourceRoot":"","sources":["../src/model-registry.ts"],"names":[],"mappings":"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"}

package/dist/openai-model.d.ts

@@ -0,0 +1,4 @@
+import type { LanguageModel } from 'ai';
+/** OpenAI-compatible LanguageModel using BYOK or OpenBot Credits. */
+export declare function resolveOpenAiModel(model: string): LanguageModel;
+//# sourceMappingURL=openai-model.d.ts.map

package/dist/openai-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-model.d.ts","sourceRoot":"","sources":["../src/openai-model.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAGxC,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAO/D"}

package/dist/openai-model.js

@@ -0,0 +1,13 @@
+import { creditsOpenAiClientOptions, llmAuthNotConfiguredMessage, } from './credits-auth.js';
+import { createOpenAI } from '@ai-sdk/openai';
+import { vendorModelId } from './helpers.js';
+/** OpenAI-compatible LanguageModel using BYOK or OpenBot Credits. */
+export function resolveOpenAiModel(model) {
+    const modelId = vendorModelId(model) ?? model;
+    const transport = creditsOpenAiClientOptions();
+    if (!transport) {
+        throw new Error(llmAuthNotConfiguredMessage());
+    }
+    return createOpenAI(transport)(modelId);
+}
+//# sourceMappingURL=openai-model.js.map

package/dist/openai-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-model.js","sourceRoot":"","sources":["../src/openai-model.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,qEAAqE;AACrE,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;IAC9C,MAAM,SAAS,GAAG,0BAA0B,EAAE,CAAC;IAC/C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,2BAA2B,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,YAAY,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC"}

package/dist/plugin.d.ts

@@ -22,6 +22,12 @@ export type ConfigSchemaProperty = {
     format?: 'password' | 'url' | 'email';
     /** When true, the field may be overridden per `agent:invoke` from the composer. */
     override?: boolean;
+    /** Labeled select options (preferred over bare `enum` when present). */
+    options?: Array<{
+        label: string;
+        value: string;
+        description?: string;
+    }>;
 };
 /** JSON-schema-like description of per-plugin config in AGENT.md. */
 export type ConfigSchema = {

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,kDAAkD;AAClD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,qEAAqE;AACrE,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjF,6DAA6D;AAC7D,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,sBAAsB,GAAG,OAAO,GAAG,QAAQ,CAAC;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,sBAAsB,CAAC;KAC9B,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,GAAG,KAAK,GAAG,OAAO,CAAC;IACtC,mFAAmF;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE;QACV,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAAC;KACrC,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACjD,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,aAAa,CAAC;CACpD;AAED,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAE9C,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;AACvE,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,kDAAkD;AAClD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,qEAAqE;AACrE,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjF,6DAA6D;AAC7D,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,sBAAsB,GAAG,OAAO,GAAG,QAAQ,CAAC;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,sBAAsB,CAAC;KAC9B,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,GAAG,KAAK,GAAG,OAAO,CAAC;IACtC,mFAAmF;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzE,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE;QACV,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAAC;KACrC,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACjD,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,aAAa,CAAC;CACpD;AAED,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAE9C,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;AACvE,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC"}

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAyEA,MAAM,UAAU,YAAY,CAAkC,UAAa;IACzE,OAAO,UAAU,CAAC;AACpB,CAAC"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AA2EA,MAAM,UAAU,YAAY,CAAkC,UAAa;IACzE,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/text-reply.d.ts

@@ -0,0 +1,30 @@
+import type { AgentTurnYield } from './agent-plugin.js';
+/** How a stream event maps onto a text reply. */
+export type TextReplyHint = {
+    type: 'delta';
+    text: string;
+} | {
+    type: 'text';
+    text: string;
+} | {
+    type: 'flush';
+} | {
+    type: 'skip';
+};
+/** `{ kind: 'reply' }` yield for `defineAgentPlugin`. */
+export declare function textReply(content: string): AgentTurnYield;
+/**
+ * Collect text deltas and emit one `{ kind: 'reply' }` per completed reply.
+ *
+ * - `delta`: append to the current reply
+ * - `text`: complete snapshot — drop in-progress deltas and yield immediately
+ * - `flush`: yield collected deltas (reply boundary)
+ * - `skip`: ignore
+ */
+export declare function createTextReplyBuffer(): {
+    apply: (hint: TextReplyHint) => Generator<AgentTurnYield>;
+    end: () => Generator<AgentTurnYield>;
+};
+/** Classify each stream event and yield completed text as it lands. */
+export declare function emitTextReplies<T>(events: AsyncIterable<T>, classify: (event: T) => TextReplyHint): AsyncGenerator<AgentTurnYield>;
+//# sourceMappingURL=text-reply.d.ts.map

package/dist/text-reply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-reply.d.ts","sourceRoot":"","sources":["../src/text-reply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,iDAAiD;AACjD,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAEzD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB;kBAGb,aAAa,KAAG,SAAS,CAAC,cAAc,CAAC;eAuB9C,SAAS,CAAC,cAAc,CAAC;EAK3C;AAED,uEAAuE;AACvE,wBAAuB,eAAe,CAAC,CAAC,EACtC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,aAAa,GACpC,cAAc,CAAC,cAAc,CAAC,CAMhC"}

package/dist/text-reply.js

@@ -0,0 +1,53 @@
+/** `{ kind: 'reply' }` yield for `defineAgentPlugin`. */
+export function textReply(content) {
+    return { kind: 'reply', content };
+}
+/**
+ * Collect text deltas and emit one `{ kind: 'reply' }` per completed reply.
+ *
+ * - `delta`: append to the current reply
+ * - `text`: complete snapshot — drop in-progress deltas and yield immediately
+ * - `flush`: yield collected deltas (reply boundary)
+ * - `skip`: ignore
+ */
+export function createTextReplyBuffer() {
+    let buffer = '';
+    function* apply(hint) {
+        switch (hint.type) {
+            case 'delta': {
+                if (hint.text)
+                    buffer += hint.text;
+                return;
+            }
+            case 'text': {
+                buffer = '';
+                const content = hint.text.trim();
+                if (content)
+                    yield textReply(content);
+                return;
+            }
+            case 'flush': {
+                const content = buffer.trim();
+                buffer = '';
+                if (content)
+                    yield textReply(content);
+                return;
+            }
+            case 'skip':
+                return;
+        }
+    }
+    function* end() {
+        yield* apply({ type: 'flush' });
+    }
+    return { apply, end };
+}
+/** Classify each stream event and yield completed text as it lands. */
+export async function* emitTextReplies(events, classify) {
+    const replies = createTextReplyBuffer();
+    for await (const event of events) {
+        yield* replies.apply(classify(event));
+    }
+    yield* replies.end();
+}
+//# sourceMappingURL=text-reply.js.map

package/dist/text-reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-reply.js","sourceRoot":"","sources":["../src/text-reply.ts"],"names":[],"mappings":"AASA,yDAAyD;AACzD,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAmB;QACjC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,IAAI,IAAI,CAAC,IAAI;oBAAE,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC;gBACnC,OAAO;YACT,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,GAAG,EAAE,CAAC;gBACZ,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACjC,IAAI,OAAO;oBAAE,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;gBACtC,OAAO;YACT,CAAC;YACD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC9B,MAAM,GAAG,EAAE,CAAC;gBACZ,IAAI,OAAO;oBAAE,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;gBACtC,OAAO;YACT,CAAC;YACD,KAAK,MAAM;gBACT,OAAO;QACX,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,CAAC,GAAG;QACX,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AACxB,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,eAAe,CACpC,MAAwB,EACxB,QAAqC;IAErC,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;IACxC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;AACvB,CAAC"}

package/dist/thread-context.d.ts

@@ -0,0 +1,15 @@
+import type { Storage } from './storage.js';
+export declare const MAX_THREAD_CONTEXT_LINES = 20;
+export type ThreadContextLine = {
+    role: 'user' | 'assistant';
+    content: string;
+};
+export declare function threadEventsToContextLines(events: unknown[], agentId: string): ThreadContextLine[];
+export declare function formatThreadContext(lines: ThreadContextLine[]): string;
+export declare function loadThreadContext(storage: Storage, args: {
+    channelId?: string;
+    threadId: string;
+    agentId: string;
+    currentMessage?: string;
+}): Promise<string>;
+//# sourceMappingURL=thread-context.d.ts.map

package/dist/thread-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-context.d.ts","sourceRoot":"","sources":["../src/thread-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAQF,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,EAAE,MAAM,GACd,iBAAiB,EAAE,CAsCrB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAKtE;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE;IACJ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,OAAO,CAAC,MAAM,CAAC,CAsBjB"}

package/dist/thread-context.js

@@ -0,0 +1,69 @@
+export const MAX_THREAD_CONTEXT_LINES = 20;
+export function threadEventsToContextLines(events, agentId) {
+    const lines = [];
+    for (const raw of events) {
+        if (!raw || typeof raw !== 'object')
+            continue;
+        const event = raw;
+        if (event.meta?.parentToolCallId)
+            continue;
+        switch (event.type) {
+            case 'agent:invoke': {
+                const role = event.data?.role ?? 'user';
+                const content = typeof event.data?.content === 'string' ? event.data.content.trim() : '';
+                if (role === 'user' && content) {
+                    lines.push({ role: 'user', content });
+                }
+                break;
+            }
+            case 'agent:output': {
+                if (event.meta?.agentId !== agentId)
+                    break;
+                const content = typeof event.data?.content === 'string' ? event.data.content.trim() : '';
+                if (!content)
+                    break;
+                const last = lines[lines.length - 1];
+                if (last?.role === 'assistant') {
+                    last.content += content;
+                }
+                else {
+                    lines.push({ role: 'assistant', content });
+                }
+                break;
+            }
+        }
+    }
+    if (lines.length > MAX_THREAD_CONTEXT_LINES) {
+        return lines.slice(-MAX_THREAD_CONTEXT_LINES);
+    }
+    return lines;
+}
+export function formatThreadContext(lines) {
+    if (lines.length === 0)
+        return '';
+    const jsonl = lines.map((line) => JSON.stringify(line)).join('\n');
+    return `Previous conversation context (most recent last):\n${jsonl}`;
+}
+export async function loadThreadContext(storage, args) {
+    if (!args.channelId)
+        return '';
+    try {
+        const events = await storage.getEvents({
+            channelId: args.channelId,
+            threadId: args.threadId,
+        });
+        let lines = threadEventsToContextLines(events, args.agentId);
+        const currentMessage = args.currentMessage?.trim();
+        if (currentMessage) {
+            const last = lines[lines.length - 1];
+            if (last?.role === 'user' && last.content === currentMessage) {
+                lines = lines.slice(0, -1);
+            }
+        }
+        return formatThreadContext(lines);
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=thread-context.js.map

package/dist/thread-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-context.js","sourceRoot":"","sources":["../src/thread-context.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meetopenbot/plugin-sdk",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Types and helpers for building OpenBot plugins on the event bus.",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,6 +22,11 @@
     "melony": "^0.3.7",
     "zod": "^4.3.5"
   },
+  "dependencies": {
+    "@ai-sdk/mcp": "^2.0.14",
+    "@ai-sdk/openai": "^4.0.15",
+    "ai": "^7.0.29"
+  },
   "devDependencies": {
     "melony": "^0.3.7",
     "typescript": "^5.0.0",
@@ -32,6 +37,6 @@
     "build": "tsc",
     "dev": "tsc --watch --preserveWatchOutput",
     "typecheck": "tsc --noEmit",
-    "test": "node --experimental-strip-types --test src/diff.test.ts"
+    "test": "node --experimental-strip-types --test src/*.test.ts"
   }
 }