@meetopenbot/plugin-sdk 0.1.0

package/README.md

@@ -0,0 +1,128 @@
+# OpenBot Plugin SDK
+
+The official SDK for building plugins for [OpenBot](https://meetopenbot.com). This SDK provides the types and helpers needed to create plugins that can handle events, interact with storage, and render UI widgets within the OpenBot ecosystem.
+
+## Installation
+
+```bash
+npm install @meetopenbot/plugin-sdk
+```
+
+## How it Works
+
+OpenBot plugins operate on an event-driven architecture powered by [Melony](https://github.com/meetopenbot/melony). 
+
+1.  **Registration**: The host loads your plugin and calls the `factory` function with a `PluginContext`.
+2.  **Subscription**: Your `factory` function uses the `MelonyBuilder` to subscribe to specific events (e.g., `agent:invoke`).
+3.  **Processing**: When an event occurs, your handler is called. You can perform logic, interact with `storage`, or call external APIs.
+4.  **Publication**: Your handler can publish new events back to the bus (e.g., `agent:output` or `client:ui:widget`) to communicate with the user or other plugins.
+
+## Core Concepts
+
+### Plugin
+
+A plugin is defined by the `Plugin` interface. It requires an `id`, `name`, `description`, and a `factory` function.
+
+```typescript
+import { Plugin, PluginContext, MelonyPlugin, OpenBotState, OpenBotEvent } from '@meetopenbot/plugin-sdk';
+
+export const myPlugin: Plugin = {
+  id: 'my-plugin',
+  name: 'My Plugin',
+  description: 'A simple example plugin',
+  configSchema: {
+    type: 'object',
+    properties: {
+      apiKey: { type: 'string', description: 'Your API Key', format: 'password' }
+    },
+    required: ['apiKey']
+  },
+  toolDefinitions: {
+    'get_weather': {
+      description: 'Get the current weather',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          location: { type: 'string' }
+        }
+      }
+    }
+  },
+  factory: (context: PluginContext): MelonyPlugin<OpenBotState, OpenBotEvent> => {
+    return (builder) => {
+      // Handle events here
+    };
+  },
+};
+```
+
+### Configuration & Tools
+
+- **`configSchema`**: Defines the configuration options for your plugin. The host uses this to validate the configuration provided in `AGENT.md`.
+- **`toolDefinitions`**: Defines the tools your plugin provides. Other plugins (like a runtime plugin) can use these definitions to call your plugin's tools.
+
+### Events
+
+Plugins communicate via an event bus. Common event types include:
+
+- `agent:invoke`: Dispatched when a user sends a message to the agent.
+- `agent:output`: Emitted by the agent to send a message back to the user.
+- `client:ui:widget`: Used to render a UI widget in the client.
+- `action:<toolName>`: Dispatched when a runtime requests a tool call.
+- `action:<toolName>:result`: Emitted when a tool handler finishes.
+
+### Storage
+
+The `PluginContext` provides access to the `storage` interface, allowing plugins to interact with:
+
+- **Channels & Threads**: Manage conversation contexts.
+- **Agents**: Access and update agent details.
+- **Variables**: Store configuration or secrets.
+- **Files**: Read and list files in the channel's workspace.
+- **Memories**: Store and retrieve long-term memory records.
+
+### UI Widgets
+
+Plugins can render interactive UI widgets using the `uiWidget` helper. Supported widget types include:
+
+- `message`: Simple text message with optional actions.
+- `choice`: A set of buttons for the user to choose from.
+- `form`: A form with various field types (text, number, select, etc.).
+- `list`: A list of items with status indicators.
+
+## Example: Hello World Plugin
+
+This plugin responds to any message with "Hello, World!".
+
+```typescript
+import { Plugin, shouldHandleInvoke, agentOutput } from '@meetopenbot/plugin-sdk';
+
+export const helloWorldPlugin: Plugin = {
+  id: 'hello-world',
+  name: 'Hello World',
+  description: 'Responds with Hello World',
+  factory: (context) => (builder) => {
+    builder.on('agent:invoke', async (event, { bus }) => {
+      if (shouldHandleInvoke(event, context.agentId)) {
+        await bus.publish(agentOutput({
+          agentId: context.agentId,
+          content: 'Hello, World!',
+          threadId: event.meta?.threadId,
+        }));
+      }
+    });
+  },
+};
+```
+
+## API Reference
+
+- [Plugin & Context](./src/plugin.ts)
+- [Events & State](./src/events.ts)
+- [Storage Interface](./src/storage.ts)
+- [UI Widget Specs](./src/ui.ts)
+- [Helpers](./src/helpers.ts)
+
+## License
+
+MIT

package/dist/events.d.ts

@@ -0,0 +1,95 @@
+import type { AgentDetails, ChannelDetails, ThreadDetails } from './storage.js';
+import type { UIWidgetSpec } from './ui.js';
+export type EventMeta = {
+    agentId?: string;
+    threadId?: string;
+    toolCallId?: string;
+    [key: string]: unknown;
+};
+export type BaseEvent = {
+    id?: string;
+    type: string;
+    meta?: EventMeta;
+};
+export type AgentInvokeEvent = BaseEvent & {
+    type: 'agent:invoke';
+    data: {
+        role?: 'user' | 'assistant' | 'system';
+        content: string;
+        agentId?: string;
+    };
+};
+export type AgentOutputEvent = BaseEvent & {
+    type: 'agent:output';
+    data: {
+        content: string;
+    };
+    meta: EventMeta & {
+        agentId: string;
+    };
+};
+export type UIWidgetEvent = BaseEvent & {
+    type: 'client:ui:widget';
+    data: UIWidgetSpec;
+    meta: EventMeta & {
+        agentId: string;
+    };
+};
+export type UIWidgetResponseEvent = BaseEvent & {
+    type: 'client:ui:widget:response';
+    data: {
+        widgetId: string;
+        actionId: string;
+        values?: Record<string, unknown>;
+        metadata?: Record<string, unknown>;
+    };
+};
+/** `action:<toolName>` dispatched when a runtime requests a tool call. */
+export type ToolActionEvent<TData = unknown> = BaseEvent & {
+    type: `action:${string}`;
+    data: TData;
+    meta?: EventMeta;
+};
+/** `action:<toolName>:result` emitted when a tool handler finishes. */
+export type ToolResultEvent<TData = unknown> = BaseEvent & {
+    type: `action:${string}:result`;
+    data: TData;
+    meta?: EventMeta;
+};
+/**
+ * Narrow event union for common plugin authoring paths.
+ * The host bus accepts additional event types at runtime.
+ */
+export type PluginEvent = AgentInvokeEvent | AgentOutputEvent | UIWidgetEvent | UIWidgetResponseEvent | ToolActionEvent | ToolResultEvent;
+export type OpenBotEvent = PluginEvent | (BaseEvent & {
+    data?: unknown;
+});
+export type ShortTermMessage = {
+    role: 'system';
+    content: string;
+} | {
+    role: 'user';
+    content: string;
+} | {
+    role: 'assistant';
+    content: string;
+    toolCalls?: unknown[];
+} | {
+    role: 'tool';
+    content: string;
+    toolCallId: string;
+    toolName: string;
+};
+/** Runtime state available on Melony handler contexts. */
+export interface OpenBotState {
+    agentId: string;
+    runId: string;
+    channelId: string;
+    threadId?: string;
+    agentDetails?: AgentDetails;
+    channelDetails?: ChannelDetails;
+    threadDetails?: ThreadDetails;
+    triggerEvent?: OpenBotEvent;
+    shortTermMessages?: ShortTermMessage[];
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":""}

package/dist/helpers.d.ts

@@ -0,0 +1,31 @@
+import type { AgentInvokeEvent, AgentOutputEvent, EventMeta, ToolResultEvent, UIWidgetEvent } from './events.js';
+import type { UIWidgetSpec } from './ui.js';
+/** Return true when this agent should handle an `agent:invoke` event. */
+export declare function shouldHandleInvoke(event: AgentInvokeEvent, agentId: string): boolean;
+/** Build an `agent:output` event. */
+export declare function agentOutput(args: {
+    agentId: string;
+    content: string;
+    threadId?: string;
+    meta?: EventMeta;
+}): AgentOutputEvent;
+/** Build an `action:<toolName>:result` event while preserving request meta. */
+export declare function toolResult<TData>(toolName: string, request: {
+    meta?: EventMeta;
+}, data: TData): ToolResultEvent<TData>;
+/** Build a `client:ui:widget` event. */
+export declare function uiWidget(args: {
+    agentId: string;
+    widget: UIWidgetSpec;
+    threadId?: string;
+    meta?: EventMeta;
+}): UIWidgetEvent;
+/** Copy `meta` from a source bus event onto a new event payload. */
+export declare function withMeta<T extends {
+    meta?: EventMeta;
+}>(source: {
+    meta?: EventMeta;
+}, event: T): T & {
+    meta?: EventMeta;
+};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAGpF;AAED,qCAAqC;AACrC,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB,GAAG,gBAAgB,CAUnB;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,KAAK,EAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,EAC7B,IAAI,EAAE,KAAK,GACV,eAAe,CAAC,KAAK,CAAC,CAMxB;AAED,wCAAwC;AACxC,wBAAgB,QAAQ,CAAC,IAAI,EAAE;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB,GAAG,aAAa,CAUhB;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,EACrD,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,EAC5B,KAAK,EAAE,CAAC,GACP,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,CAS1B"}

package/dist/helpers.js

@@ -0,0 +1,50 @@
+/** Return true when this agent should handle an `agent:invoke` event. */
+export function shouldHandleInvoke(event, agentId) {
+    const routedTo = event.data?.agentId;
+    return !(typeof routedTo === 'string' && routedTo && routedTo !== agentId);
+}
+/** Build an `agent:output` event. */
+export function agentOutput(args) {
+    return {
+        type: 'agent:output',
+        data: { content: args.content },
+        meta: {
+            ...(args.meta ?? {}),
+            agentId: args.agentId,
+            ...(args.threadId ? { threadId: args.threadId } : {}),
+        },
+    };
+}
+/** Build an `action:<toolName>:result` event while preserving request meta. */
+export function toolResult(toolName, request, data) {
+    return {
+        type: `action:${toolName}:result`,
+        data,
+        meta: request.meta,
+    };
+}
+/** Build a `client:ui:widget` event. */
+export function uiWidget(args) {
+    return {
+        type: 'client:ui:widget',
+        data: args.widget,
+        meta: {
+            ...(args.meta ?? {}),
+            agentId: args.agentId,
+            ...(args.threadId ? { threadId: args.threadId } : {}),
+        },
+    };
+}
+/** Copy `meta` from a source bus event onto a new event payload. */
+export function withMeta(source, event) {
+    if (!source.meta)
+        return event;
+    return {
+        ...event,
+        meta: {
+            ...source.meta,
+            ...(event.meta ?? {}),
+        },
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AASA,yEAAyE;AACzE,MAAM,UAAU,kBAAkB,CAAC,KAAuB,EAAE,OAAe;IACzE,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC;IACrC,OAAO,CAAC,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,IAAI,QAAQ,KAAK,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,WAAW,CAAC,IAK3B;IACC,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;QAC/B,IAAI,EAAE;YACJ,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YACpB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD;KACF,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,OAA6B,EAC7B,IAAW;IAEX,OAAO;QACL,IAAI,EAAE,UAAU,QAAQ,SAAS;QACjC,IAAI;QACJ,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC;AACJ,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,QAAQ,CAAC,IAKxB;IACC,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,IAAI,CAAC,MAAM;QACjB,IAAI,EAAE;YACJ,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YACpB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD;KACF,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,QAAQ,CACtB,MAA4B,EAC5B,KAAQ;IAER,IAAI,CAAC,MAAM,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO;QACL,GAAG,KAAK;QACR,IAAI,EAAE;YACJ,GAAG,MAAM,CAAC,IAAI;YACd,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;SACtB;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { z } from 'zod';
+export * from './runtime.js';
+export * from './plugin.js';
+export * from './events.js';
+export * from './ui.js';
+export * from './storage.js';
+export * from './helpers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { z } from 'zod';
+export * from './runtime.js';
+export * from './plugin.js';
+export * from './events.js';
+export * from './ui.js';
+export * from './storage.js';
+export * from './helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,56 @@
+import type { AgentDetails } from './storage.js';
+import type { Storage } from './storage.js';
+import type { PluginFactory } from './runtime.js';
+/** Plugin reference from AGENT.md frontmatter. */
+export interface PluginRef {
+    id: string;
+    config?: Record<string, unknown>;
+}
+/** JSON-schema-like description of per-plugin config in AGENT.md. */
+export type ConfigSchema = {
+    type: 'object';
+    properties: {
+        [key: string]: {
+            type: 'string' | 'number' | 'boolean' | 'integer';
+            description?: string;
+            default?: unknown;
+            enum?: unknown[];
+            minimum?: number;
+            maximum?: number;
+            format?: 'password' | 'url' | 'email';
+        };
+    };
+    required?: string[];
+};
+/** Tool metadata merged across plugins and exposed to runtime plugins. */
+export interface ToolDefinition {
+    description: string;
+    inputSchema: unknown;
+}
+/** Context passed to `factory` when the host wires a plugin onto the bus. */
+export interface PluginContext {
+    agentId: string;
+    agentDetails: AgentDetails;
+    config: Record<string, unknown>;
+    storage: Storage;
+    tools: Record<string, ToolDefinition>;
+}
+/**
+ * Plugin contract expected by the OpenBot host.
+ * Roles (runtime, tool, middleware) are defined by which events `factory` handles.
+ */
+export interface Plugin {
+    id: string;
+    name: string;
+    description: string;
+    image?: string;
+    configSchema?: ConfigSchema;
+    toolDefinitions?: Record<string, ToolDefinition>;
+    factory: (context: PluginContext) => PluginFactory;
+}
+/** Community plugin module export. The host assigns `id` from the npm package name. */
+export type PluginModule = Omit<Plugin, 'id'>;
+/** Define a plugin with full OpenBot typing. */
+export declare function definePlugin<T extends PluginModule>(definition: T): T;
+export declare function definePlugin<T extends Plugin>(definition: T): T;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +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,YAAY,GAAG;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE;QACV,CAAC,GAAG,EAAE,MAAM,GAAG;YACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;YAClD,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,UAAU,GAAG,KAAK,GAAG,OAAO,CAAC;SACvC,CAAC;KACH,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

@@ -0,0 +1,4 @@
+export function definePlugin(definition) {
+    return definition;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,9 @@
+import type { MelonyBuilder, MelonyPlugin, RuntimeContext } from 'melony';
+import type { OpenBotEvent, OpenBotState } from './events.js';
+/** Context passed to plugin event handlers. */
+export type PluginHandlerContext = RuntimeContext<OpenBotState, OpenBotEvent>;
+/** Fluent builder surface exposed to plugin factories. */
+export type PluginBuilder = MelonyBuilder<OpenBotState, OpenBotEvent>;
+/** Function returned from `Plugin.factory` to register handlers on the bus. */
+export type PluginFactory = MelonyPlugin<OpenBotState, OpenBotEvent>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE9D,+CAA+C;AAC/C,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;AAE9E,0DAA0D;AAC1D,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;AAEtE,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC"}

package/dist/runtime.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":""}

package/dist/storage.d.ts

@@ -0,0 +1,164 @@
+import type { PluginRef } from './plugin.js';
+export type Agent = {
+    id: string;
+    name: string;
+    description: string;
+    image?: string;
+    plugins: string[];
+    createdAt: Date;
+    updatedAt: Date;
+};
+export type AgentDetails = Agent & {
+    instructions: string;
+    pluginRefs: PluginRef[];
+};
+export type Channel = {
+    id: string;
+    name: string;
+    description: string;
+    cwd?: string;
+    createdAt: Date;
+    updatedAt: Date;
+};
+export type Thread = {
+    id: string;
+    title: string;
+    createdAt: Date;
+    updatedAt: Date;
+};
+export type ThreadDetails = {
+    id: string;
+    title: string;
+    spec: string;
+    state: unknown;
+};
+export type ChannelDetails = {
+    id: string;
+    name: string;
+    spec: string;
+    state: unknown;
+    cwd?: string;
+    threads?: Thread[];
+};
+export type MemoryRecord = {
+    id: string;
+    scope: string;
+    content: string;
+    tags?: string[];
+    createdAt: string;
+    updatedAt: string;
+};
+export type ListMemoriesArgs = {
+    scopes?: string[];
+    query?: string;
+    tag?: string;
+    limit?: number;
+};
+/** Storage surface available on `PluginContext.storage`. */
+export interface Storage {
+    getChannels: () => Promise<Channel[]>;
+    createChannel: (args: {
+        channelId: string;
+        spec?: string;
+        initialState?: Record<string, unknown>;
+        cwd?: string;
+    }) => Promise<void>;
+    createThread: (args: {
+        channelId: string;
+        threadId: string;
+        threadTitle?: string;
+        spec?: string;
+        initialState?: Record<string, unknown>;
+    }) => Promise<void>;
+    getThreads: (args: {
+        channelId: string;
+    }) => Promise<Thread[]>;
+    getThreadDetails: (args: {
+        channelId: string;
+        threadId: string;
+    }) => Promise<ThreadDetails>;
+    getAgents: () => Promise<Agent[]>;
+    getAgentDetails: (args: {
+        agentId: string;
+    }) => Promise<AgentDetails>;
+    createAgent: (args: {
+        agentId: string;
+        name: string;
+        description?: string;
+        instructions: string;
+        plugins: PluginRef[];
+    }) => Promise<void>;
+    updateAgent: (args: {
+        agentId: string;
+        name?: string;
+        description?: string;
+        instructions?: string;
+        plugins?: PluginRef[];
+    }) => Promise<void>;
+    deleteAgent: (args: {
+        agentId: string;
+    }) => Promise<void>;
+    getEvents: (args: {
+        channelId: string;
+        threadId?: string;
+    }) => Promise<unknown[]>;
+    getChannelDetails: (args: {
+        channelId: string;
+    }) => Promise<ChannelDetails>;
+    patchChannelState: (args: {
+        channelId: string;
+        state: unknown;
+    }) => Promise<void>;
+    patchThreadState: (args: {
+        channelId: string;
+        threadId: string;
+        state: unknown;
+    }) => Promise<void>;
+    patchChannelSpec: (args: {
+        channelId: string;
+        spec: string;
+    }) => Promise<void>;
+    patchThreadSpec: (args: {
+        channelId: string;
+        threadId: string;
+        spec: string;
+    }) => Promise<void>;
+    getVariables: () => Promise<Record<string, string | {
+        value: string;
+        secret: boolean;
+    }>>;
+    createVariable: (args: {
+        key: string;
+        value: string;
+        secret?: boolean;
+    }) => Promise<void>;
+    deleteVariable: (args: {
+        key: string;
+    }) => Promise<void>;
+    listFiles: (args: {
+        channelId: string;
+        path?: string;
+    }) => Promise<Array<{
+        name: string;
+        isDirectory: boolean;
+    }>>;
+    readFile: (args: {
+        channelId: string;
+        path: string;
+    }) => Promise<string>;
+    appendMemory: (args: {
+        scope: string;
+        content: string;
+        tags?: string[];
+    }) => Promise<MemoryRecord>;
+    listMemories: (args?: ListMemoriesArgs) => Promise<MemoryRecord[]>;
+    deleteMemory: (args: {
+        id: string;
+    }) => Promise<boolean>;
+    updateMemory: (args: {
+        id: string;
+        content?: string;
+        tags?: string[];
+    }) => Promise<boolean>;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

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

package/dist/storage.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":""}

package/dist/ui.d.ts

@@ -0,0 +1,71 @@
+export type UIWidgetAction = {
+    id: string;
+    label: string;
+    value?: unknown;
+    variant?: 'primary' | 'secondary' | 'danger';
+    disabled?: boolean;
+};
+export type UIWidgetField = {
+    id: string;
+    label: string;
+    type: 'text' | 'textarea' | 'number' | 'boolean' | 'select' | 'multiselect' | 'date';
+    description?: string;
+    placeholder?: string;
+    required?: boolean;
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    defaultValue?: unknown;
+};
+export type UIWidgetListItem = {
+    id: string;
+    label: string;
+    description?: string;
+    status?: 'pending' | 'in_progress' | 'done' | 'error' | 'cancelled';
+    metadata?: Record<string, unknown>;
+};
+export type UIWidgetBase = {
+    widgetId: string;
+    title?: string;
+    description?: string;
+    body?: string;
+    state?: 'open' | 'submitted' | 'cancelled' | 'error';
+    metadata?: Record<string, unknown>;
+};
+export type UIMessageWidget = UIWidgetBase & {
+    kind: 'message';
+    actions?: UIWidgetAction[];
+};
+export type UIChoiceWidget = UIWidgetBase & {
+    kind: 'choice';
+    actions: UIWidgetAction[];
+};
+export type UIFormWidget = UIWidgetBase & {
+    kind: 'form';
+    fields: UIWidgetField[];
+    submitLabel?: string;
+    actions?: UIWidgetAction[];
+};
+export type UIListWidget = UIWidgetBase & {
+    kind: 'list';
+    items: UIWidgetListItem[];
+    actions?: UIWidgetAction[];
+};
+export type UIWidgetSpec = UIMessageWidget | UIChoiceWidget | UIFormWidget | UIListWidget;
+export type RenderUIWidgetData = (Omit<UIMessageWidget, 'widgetId'> & {
+    widgetId?: string;
+}) | (Omit<UIChoiceWidget, 'widgetId'> & {
+    widgetId?: string;
+}) | (Omit<UIFormWidget, 'widgetId'> & {
+    widgetId?: string;
+}) | (Omit<UIListWidget, 'widgetId'> & {
+    widgetId?: string;
+}) | {
+    kind: 'approval' | 'todo_list';
+    widgetId?: string;
+    title?: string;
+    props?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+};
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

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

package/dist/ui.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@meetopenbot/plugin-sdk",
+  "version": "0.1.0",
+  "description": "Types and helpers for building OpenBot plugins on the event bus.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "melony": "^0.3.7",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "melony": "^0.3.7",
+    "typescript": "^5.0.0",
+    "zod": "^4.3.5",
+    "@types/node": "^20.0.0"
+  }
+}