@okdoc-ai/plugin-sdk 1.4.0

package/dist/okdoc-iframe-sdk-global.d.ts

@@ -0,0 +1,116 @@
+// ============================================================================
+// @okdoc-ai/plugin-sdk — Iframe SDK Global Type Declarations (AUTO-GENERATED)
+//
+// DO NOT EDIT THIS FILE MANUALLY.
+// Generated by scripts/build-iframe-sdk.mjs from src/iframe-sdk-types.ts.
+// To update, edit that file and run:  npm run build:all
+//
+// Usage in iframe plugin projects:
+//   Copy this file into your project's src/ directory, OR reference it
+//   in tsconfig.json → "include": ["path/to/okdoc-iframe-sdk-global.d.ts"]
+// ============================================================================
+interface OkDocJsonSchemaProperty {
+    type?: string | string[];
+    description?: string;
+    enum?: unknown[];
+    const?: unknown;
+    default?: unknown;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    minimum?: number;
+    maximum?: number;
+    items?: OkDocJsonSchemaProperty | OkDocJsonSchemaProperty[];
+    minItems?: number;
+    maxItems?: number;
+    properties?: Record<string, OkDocJsonSchemaProperty>;
+    required?: string[];
+    additionalProperties?: boolean | OkDocJsonSchemaProperty;
+    oneOf?: OkDocJsonSchemaProperty[];
+    anyOf?: OkDocJsonSchemaProperty[];
+    allOf?: OkDocJsonSchemaProperty[];
+    not?: OkDocJsonSchemaProperty;
+    [key: string]: unknown;
+}
+interface OkDocToolInputSchema {
+    type: 'object';
+    properties?: Record<string, OkDocJsonSchemaProperty>;
+    required?: string[];
+}
+interface OkDocAnnotations {
+    audience?: ('user' | 'assistant')[];
+    priority?: number;
+    lastModified?: string;
+}
+interface OkDocToolAnnotations {
+    title?: string;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+}
+interface OkDocContentBlock {
+    type: 'text' | 'image' | 'audio' | 'resource' | 'resource_link';
+    text?: string;
+    data?: string;
+    mimeType?: string;
+    uri?: string;
+    name?: string;
+    description?: string;
+    resource?: {
+        uri: string;
+        mimeType?: string;
+        text?: string;
+        blob?: string;
+    };
+    annotations?: OkDocAnnotations;
+}
+interface OkDocToolResult {
+    content: OkDocContentBlock[];
+    structuredContent?: Record<string, unknown>;
+    isError?: boolean;
+}
+interface OkDocToolConfig {
+    description: string;
+    inputSchema?: OkDocToolInputSchema;
+    annotations?: OkDocToolAnnotations;
+    handler: (args: Record<string, unknown>) => Promise<OkDocToolResult>;
+}
+interface OkDocInitOptions {
+    /** Unique plugin identifier */
+    id: string;
+    /** Display name shown in the Plugin Store */
+    name: string;
+    /** Short description */
+    description?: string;
+    /** Semver version of the plugin */
+    version: string;
+    /** Ionicon name for the store card */
+    icon?: string;
+    /** MCP namespace prefix for all tools */
+    namespace: string;
+    /** Display mode: foreground (visible UI) or background (hidden) */
+    mode?: 'foreground' | 'background';
+    /** Allowed origins for the host handshake. If omitted, any origin is accepted. */
+    allowedOrigins?: string[];
+}
+interface OkDocIframeSDK {
+    /** Initialize the plugin with its manifest. Must be called before registerTool(). */
+    init(options: OkDocInitOptions): void;
+    /** Register a tool that the host app (AI) can call. */
+    registerTool(name: string, config: OkDocToolConfig): void;
+    /**
+     * Send a notification message to the AI.
+     * Only works after the host has connected via handshake.
+     */
+    notify(message: string): void;
+    /** Clean up the SDK: remove event listeners, close port, clear state. */
+    destroy(): void;
+    /** Current iframe protocol version */
+    readonly version: number;
+    /** MCP protocol version this SDK targets */
+    readonly mcpProtocolVersion: string;
+}
+
+declare var OkDoc: OkDocIframeSDK;

package/dist/okdoc-iframe-sdk.js

@@ -0,0 +1 @@
+"use strict";var _okdocIframeSDK=(()=>{var f="2025-03-26",s=null,a=null,c=new Map,t=null,i=null;function m(){let o=[];return c.forEach((n,e)=>{let r={name:e,description:n.description};n.inputSchema&&(r.inputSchema=n.inputSchema),n.annotations&&(r.annotations=n.annotations),o.push(r)}),o}function p(o){s&&o.postMessage({type:"okdoc:manifest",sdkVersion:2,manifest:{...s,description:s.description??"",tools:m(),sdkVersion:"1.4.0",mcpProtocolVersion:f}})}function d(){!t||!s||(i!==null&&clearTimeout(i),i=setTimeout(()=>{i=null,t&&s&&p(t)},150))}async function y(o,n,e,r){let u=c.get(e);if(!u){o.postMessage({type:"okdoc:result",id:n,result:{content:[{type:"text",text:`Tool "${e}" not found in this plugin.`}],isError:!0}});return}try{let l=await u.handler(r);o.postMessage({type:"okdoc:result",id:n,result:l})}catch(l){let O=l instanceof Error?l.message:String(l);o.postMessage({type:"okdoc:result",id:n,result:{content:[{type:"text",text:`Tool "${e}" error: ${O}`}],isError:!0}})}}function S(o){let n=o.data;!n||typeof n.type!="string"||n.type==="okdoc:call"&&y(t,n.id,n.tool,n.args??{})}function g(o){let n=o.data;if(!(!n||n.type!=="okdoc:handshake")&&!(!o.ports||o.ports.length===0)){if(a){if(!a.includes(o.origin)){console.warn(`[OkDoc SDK] Rejected handshake from untrusted origin: ${o.origin}`);return}}else console.warn("[OkDoc SDK] No allowedOrigins configured \u2014 accepting handshake from any origin. Set allowedOrigins in OkDoc.init() for production use.");t=o.ports[0],t.onmessage=S,p(t)}}window.addEventListener("message",g);var h={init(o){let{allowedOrigins:n,...e}=o;s=e,a=n??null,d()},registerTool(o,n){c.set(o,n),d()},notify(o){t?(console.log("[OkDoc SDK] Sending notification to host:",o),t.postMessage({type:"okdoc:notify",message:o})):console.warn("[OkDoc SDK] notify() called but no port connected \u2014 handshake not completed yet.")},destroy(){window.removeEventListener("message",g),i!==null&&(clearTimeout(i),i=null),t&&(t.close(),t=null),s=null,a=null,c.clear()},version:2,mcpProtocolVersion:f};Object.defineProperty(window,"OkDoc",{value:Object.freeze(h),writable:!1,configurable:!1});})();

package/dist/register-remote.d.ts

@@ -0,0 +1,50 @@
+import { RemotePluginBundle, RemotePluginManifest, McpStaticToolDeclaration, OkDocPluginGlobal } from './types.js';
+/**
+ * Input type for registerRemotePlugin — tools are optional because the SDK
+ * can derive them from toolHandlers keys. After registration the manifest
+ * is guaranteed to have tools populated.
+ */
+export type RemotePluginBundleInput = {
+    manifest: Omit<RemotePluginManifest, 'tools'> & {
+        tools?: McpStaticToolDeclaration[];
+    };
+    toolHandlers: RemotePluginBundle['toolHandlers'];
+};
+declare global {
+    interface Window {
+        __OKDOC_PLUGINS__?: OkDocPluginGlobal;
+    }
+}
+/**
+ * Register a remote plugin so the OkDoc host app can discover it.
+ *
+ * Call this at the end of your plugin bundle after calling
+ * `customElements.define(...)`. The host reads the registered bundle
+ * to obtain the manifest (identity + tool declarations) and tool handlers.
+ *
+ * @example
+ * ```ts
+ * import { registerRemotePlugin } from '@okdoc-ai/plugin-sdk';
+ *
+ * customElements.define('okdoc-my-plugin', MyPluginElement);
+ *
+ * registerRemotePlugin({
+ *   manifest: {
+ *     id: 'my-plugin',
+ *     name: 'My Plugin',
+ *     description: 'Does cool stuff',
+ *     version: '1.0.0',
+ *     icon: 'sparkles-outline',
+ *     namespace: 'my_plugin',
+ *     elementTag: 'okdoc-my-plugin',
+ *   },
+ *   toolHandlers: {
+ *     do_something: async (args) => ({
+ *       content: [{ type: 'text', text: 'Done!' }],
+ *     }),
+ *   },
+ * });
+ * ```
+ */
+export declare function registerRemotePlugin(bundle: RemotePluginBundleInput): void;
+//# sourceMappingURL=register-remote.d.ts.map

package/dist/register-remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-remote.d.ts","sourceRoot":"","sources":["../src/register-remote.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,iBAAiB,EAAiD,MAAM,YAAY,CAAC;AAElK;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC,QAAQ,EAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,wBAAwB,EAAE,CAAA;KAAE,CAAC;IACvF,YAAY,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC;CACpD,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;KACzC;CACJ;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAqD1E"}

package/dist/register-remote.js

@@ -0,0 +1,84 @@
+// ============================================================================
+// @okdoc-ai/plugin-sdk — Remote Plugin Registration
+//
+// Call registerRemotePlugin() at the end of your plugin bundle's entry point
+// to make it discoverable by the OkDoc host application.
+// ============================================================================
+import { OKDOC_SDK_VERSION, OKDOC_MCP_PROTOCOL_VERSION } from './types.js';
+const ELEMENT_TAG_RE = /^[a-z][a-z0-9]*-[a-z0-9-]*$/;
+const NAMESPACE_RE = /^[a-z][a-z0-9_]*$/;
+/**
+ * Register a remote plugin so the OkDoc host app can discover it.
+ *
+ * Call this at the end of your plugin bundle after calling
+ * `customElements.define(...)`. The host reads the registered bundle
+ * to obtain the manifest (identity + tool declarations) and tool handlers.
+ *
+ * @example
+ * ```ts
+ * import { registerRemotePlugin } from '@okdoc-ai/plugin-sdk';
+ *
+ * customElements.define('okdoc-my-plugin', MyPluginElement);
+ *
+ * registerRemotePlugin({
+ *   manifest: {
+ *     id: 'my-plugin',
+ *     name: 'My Plugin',
+ *     description: 'Does cool stuff',
+ *     version: '1.0.0',
+ *     icon: 'sparkles-outline',
+ *     namespace: 'my_plugin',
+ *     elementTag: 'okdoc-my-plugin',
+ *   },
+ *   toolHandlers: {
+ *     do_something: async (args) => ({
+ *       content: [{ type: 'text', text: 'Done!' }],
+ *     }),
+ *   },
+ * });
+ * ```
+ */
+export function registerRemotePlugin(bundle) {
+    const m = bundle.manifest;
+    if (!m?.id) {
+        throw new Error('[OkDoc SDK] registerRemotePlugin: manifest.id is required');
+    }
+    if (!m.elementTag) {
+        throw new Error('[OkDoc SDK] registerRemotePlugin: manifest.elementTag is required');
+    }
+    if (!ELEMENT_TAG_RE.test(m.elementTag)) {
+        throw new Error(`[OkDoc SDK] registerRemotePlugin: elementTag "${m.elementTag}" must be a valid custom element name (lowercase, must contain a hyphen)`);
+    }
+    if (m.namespace && !NAMESPACE_RE.test(m.namespace)) {
+        throw new Error(`[OkDoc SDK] registerRemotePlugin: namespace "${m.namespace}" must be lowercase alphanumeric with underscores`);
+    }
+    // Auto-populate SDK version info
+    if (!m.sdkVersion)
+        m.sdkVersion = OKDOC_SDK_VERSION;
+    if (!m.mcpProtocolVersion)
+        m.mcpProtocolVersion = OKDOC_MCP_PROTOCOL_VERSION;
+    // Auto-populate tools from handler keys if not declared
+    if (!m.tools || m.tools.length === 0) {
+        m.tools = Object.keys(bundle.toolHandlers).map(name => ({
+            name,
+            description: `Tool "${name}" from ${m.name}`,
+        }));
+    }
+    // Warn if toolHandlers don't match declared tools
+    if (m.tools && m.tools.length > 0) {
+        const declaredNames = new Set(m.tools.map(t => t.name));
+        for (const handlerName of Object.keys(bundle.toolHandlers)) {
+            if (!declaredNames.has(handlerName)) {
+                console.warn(`[OkDoc SDK] registerRemotePlugin: toolHandler "${handlerName}" has no matching tool declaration in manifest.tools`);
+            }
+        }
+    }
+    if (!window.__OKDOC_PLUGINS__) {
+        window.__OKDOC_PLUGINS__ = {};
+    }
+    if (window.__OKDOC_PLUGINS__[m.id]) {
+        console.warn(`[OkDoc SDK] registerRemotePlugin: plugin "${m.id}" is already registered, overwriting`);
+    }
+    window.__OKDOC_PLUGINS__[m.id] = bundle;
+}
+//# sourceMappingURL=register-remote.js.map

package/dist/register-remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-remote.js","sourceRoot":"","sources":["../src/register-remote.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,oDAAoD;AACpD,EAAE;AACF,6EAA6E;AAC7E,yDAAyD;AACzD,+EAA+E;AAE/E,OAAO,EAAyF,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAkBlK,MAAM,cAAc,GAAG,6BAA6B,CAAC;AACrD,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA+B;IAChE,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;IAE1B,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACX,iDAAiD,CAAC,CAAC,UAAU,0EAA0E,CAC1I,CAAC;IACN,CAAC;IACD,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACX,gDAAgD,CAAC,CAAC,SAAS,mDAAmD,CACjH,CAAC;IACN,CAAC;IAED,iCAAiC;IACjC,IAAI,CAAC,CAAC,CAAC,UAAU;QAAE,CAAC,CAAC,UAAU,GAAG,iBAAiB,CAAC;IACpD,IAAI,CAAC,CAAC,CAAC,kBAAkB;QAAE,CAAC,CAAC,kBAAkB,GAAG,0BAA0B,CAAC;IAE7E,wDAAwD;IACxD,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpD,IAAI;YACJ,WAAW,EAAE,SAAS,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE;SAC/C,CAAC,CAAC,CAAC;IACR,CAAC;IAED,kDAAkD;IAClD,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,IAAI,CACR,kDAAkD,WAAW,sDAAsD,CACtH,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC5B,MAAM,CAAC,iBAAiB,GAAG,EAAE,CAAC;IAClC,CAAC;IAED,IAAI,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC,EAAE,sCAAsC,CAAC,CAAC;IAC1G,CAAC;IAED,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAA4B,CAAC;AAClE,CAAC"}

package/dist/symbols.d.ts

@@ -0,0 +1,5 @@
+/** Symbol key for @OkDocPlugin metadata stored on the class constructor */
+export declare const OKDOC_PLUGIN_KEY: unique symbol;
+/** Symbol key for @McpTool metadata stored on the class prototype */
+export declare const MCP_TOOLS_KEY: unique symbol;
+//# sourceMappingURL=symbols.d.ts.map

package/dist/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../src/symbols.ts"],"names":[],"mappings":"AAIA,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,EAAE,OAAO,MAA8B,CAAC;AAErE,qEAAqE;AACrE,eAAO,MAAM,aAAa,EAAE,OAAO,MAA2B,CAAC"}

package/dist/symbols.js

@@ -0,0 +1,8 @@
+// ============================================================================
+// @okdoc-ai/plugin-sdk — Metadata keys (Symbols)
+// ============================================================================
+/** Symbol key for @OkDocPlugin metadata stored on the class constructor */
+export const OKDOC_PLUGIN_KEY = Symbol('OkDocPlugin');
+/** Symbol key for @McpTool metadata stored on the class prototype */
+export const MCP_TOOLS_KEY = Symbol('McpTools');
+//# sourceMappingURL=symbols.js.map

package/dist/symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../src/symbols.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,iDAAiD;AACjD,+EAA+E;AAE/E,2EAA2E;AAC3E,MAAM,CAAC,MAAM,gBAAgB,GAAkB,MAAM,CAAC,aAAa,CAAC,CAAC;AAErE,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAAkB,MAAM,CAAC,UAAU,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,298 @@
+/** The MCP protocol version this SDK targets */
+export declare const OKDOC_MCP_PROTOCOL_VERSION = "2025-03-26";
+/** The OkDoc SDK version (semver) — auto-generated from package.json by stamp-version */
+export { OKDOC_SDK_VERSION } from './version.js';
+/**
+ * Current protocol version for iframe plugin communication.
+ * Bumped (integer) only on breaking changes to the message format.
+ */
+export declare const OKDOC_IFRAME_PROTOCOL_VERSION = 2;
+/** A JSON Schema property definition (subset of JSON Schema 2020-12). */
+export interface JsonSchemaProperty {
+    type?: string | string[];
+    description?: string;
+    enum?: unknown[];
+    const?: unknown;
+    default?: unknown;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    multipleOf?: number;
+    items?: JsonSchemaProperty | JsonSchemaProperty[];
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+    properties?: Record<string, JsonSchemaProperty>;
+    required?: string[];
+    additionalProperties?: boolean | JsonSchemaProperty;
+    oneOf?: JsonSchemaProperty[];
+    anyOf?: JsonSchemaProperty[];
+    allOf?: JsonSchemaProperty[];
+    not?: JsonSchemaProperty;
+    [key: string]: unknown;
+}
+/**
+ * JSON Schema for MCP tool input parameters.
+ * Must be `type: 'object'` at the root level per MCP spec.
+ */
+export interface McpToolInputSchema {
+    type: 'object';
+    properties?: Record<string, JsonSchemaProperty>;
+    required?: string[];
+    additionalProperties?: boolean | JsonSchemaProperty;
+    $schema?: string;
+}
+/** Optional annotations on content blocks and resources. */
+export interface McpAnnotations {
+    /** Intended audience(s) for the content. */
+    audience?: ('user' | 'assistant')[];
+    /** Importance hint, 0 (least) to 1 (most). */
+    priority?: number;
+    /** ISO 8601 timestamp for the most recent modification. */
+    lastModified?: string;
+}
+/** Text provided to or from the LLM. */
+export interface McpTextContent {
+    type: 'text';
+    text: string;
+    annotations?: McpAnnotations;
+}
+/** An image (base64-encoded). */
+export interface McpImageContent {
+    type: 'image';
+    data: string;
+    /** MIME type of the image (required per MCP spec). */
+    mimeType: string;
+    annotations?: McpAnnotations;
+}
+/** Audio data (base64-encoded). */
+export interface McpAudioContent {
+    type: 'audio';
+    data: string;
+    /** MIME type of the audio (required per MCP spec). */
+    mimeType: string;
+    annotations?: McpAnnotations;
+}
+/** The contents of a resource, embedded into a tool result. */
+export interface McpEmbeddedResource {
+    type: 'resource';
+    resource: {
+        uri: string;
+        mimeType?: string;
+        text?: string;
+        blob?: string;
+    };
+    annotations?: McpAnnotations;
+}
+/** A resource link (2025-11-25). */
+export interface McpResourceLink {
+    type: 'resource_link';
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+    annotations?: McpAnnotations;
+}
+/** Union of all MCP content block types. */
+export type McpContentBlock = McpTextContent | McpImageContent | McpAudioContent | McpEmbeddedResource | McpResourceLink;
+/**
+ * Additional properties describing a Tool to clients.
+ * All properties are **hints** — not guaranteed to be faithful.
+ */
+export interface McpToolAnnotations {
+    /** A human-readable title for the tool. */
+    title?: string;
+    /** If true, the tool does not modify its environment. Default: false. */
+    readOnlyHint?: boolean;
+    /** If true, the tool may perform destructive updates. Default: true. */
+    destructiveHint?: boolean;
+    /** If true, calling repeatedly with same args has no additional effect. Default: false. */
+    idempotentHint?: boolean;
+    /** If true, the tool may interact with an open world of external entities. Default: true. */
+    openWorldHint?: boolean;
+}
+/** Result returned by a tool handler. */
+export interface McpToolResult {
+    content: McpContentBlock[];
+    /** Structured output matching `outputSchema`, if declared (2025-11-25). */
+    structuredContent?: Record<string, unknown>;
+    /** Whether the tool call ended in an error. */
+    isError?: boolean;
+}
+/** Metadata stored by @OkDocPlugin on the class constructor. */
+export interface OkDocPluginMetadata {
+    /** Unique plugin identifier (e.g. 'simple-audio-player') */
+    id: string;
+    /** Display name shown in the Plugin Store */
+    name: string;
+    /** Short description shown in the Plugin Store */
+    description: string;
+    /** Semver version string */
+    version: string;
+    /** Ionicon name for the store card (e.g. 'musical-notes-outline') */
+    icon?: string;
+    /** MCP namespace prefix for all tools (e.g. 'audio_player') */
+    namespace: string;
+    /** Semver of the @okdoc-ai/plugin-sdk this plugin was built with */
+    sdkVersion?: string;
+    /** MCP protocol version this plugin conforms to (e.g. '2025-03-26') */
+    mcpProtocolVersion?: string;
+}
+/** Metadata stored by @McpTool on each method. */
+export interface McpToolMetadata {
+    /** Method name on the class (set by the decorator) */
+    methodName: string;
+    /** Tool name override. Defaults to methodName. */
+    name?: string;
+    /** Human-readable description for the AI */
+    description: string;
+    /** JSON Schema for tool arguments */
+    inputSchema?: McpToolInputSchema;
+    /** Additional tool annotations (hints for clients) */
+    annotations?: McpToolAnnotations;
+}
+/** Static tool declaration (no handler) — derived from @McpTool metadata. */
+export interface McpStaticToolDeclaration {
+    name: string;
+    description: string;
+    inputSchema?: McpToolInputSchema;
+    /** Output schema for typed results (2025-11-25). */
+    outputSchema?: McpToolInputSchema;
+    /** Additional tool annotations (hints for clients). */
+    annotations?: McpToolAnnotations;
+}
+/**
+ * A resolved plugin manifest: identity metadata + tool declarations.
+ *
+ * This is the base for all concrete manifest types (remote, iframe, host-side).
+ * Unlike `OkDocPluginMetadata` (which is the decorator config and has no tools),
+ * a manifest always carries its tool declarations.
+ */
+export interface OkDocPluginManifest extends OkDocPluginMetadata {
+    /** Static tool declarations for this plugin */
+    tools: McpStaticToolDeclaration[];
+}
+/**
+ * Manifest for a remotely-loaded plugin (Web Component boundary).
+ *
+ * Unlike bundled plugins (which use @OkDocPlugin decorator on an Angular class),
+ * remote plugins register via `window.__OKDOC_PLUGINS__[id]` and render as
+ * Custom Elements. This manifest describes the plugin for the host app.
+ */
+export interface RemotePluginManifest extends OkDocPluginManifest {
+    /** Custom element tag name (must contain a hyphen, e.g. 'okdoc-timer') */
+    elementTag: string;
+    /** Framework used to build the plugin (informational) */
+    framework?: 'angular' | 'react' | 'vanilla';
+}
+/**
+ * The bundle object that a remote plugin registers on `window.__OKDOC_PLUGINS__`.
+ *
+ * Plugin developers call `registerRemotePlugin(bundle)` at the end of their
+ * bundle's entry point.
+ */
+export interface RemotePluginBundle {
+    /** Plugin manifest with identity, tools, and element tag */
+    manifest: RemotePluginManifest;
+    /** Map of tool name → handler function. Tool names must match manifest tool names. */
+    toolHandlers: Record<string, (args: Record<string, unknown>) => Promise<McpToolResult>>;
+}
+/** Shape of the global plugin registry on `window`. */
+export interface OkDocPluginGlobal {
+    [pluginId: string]: RemotePluginBundle;
+}
+/**
+ * Manifest for an iframe-based plugin.
+ *
+ * Iframe plugins run inside a cross-origin `<iframe>`. The host discovers
+ * tools via a MessageChannel handshake, then destroys the iframe. On tool
+ * call the iframe is re-created and the tool is invoked via the port.
+ */
+export interface IframePluginManifest extends OkDocPluginManifest {
+    /** Display mode: foreground (visible UI) or background (hidden) */
+    mode?: 'foreground' | 'background';
+}
+/** Host → iframe: initial handshake (sent via window.postMessage with port2). */
+export interface OkDocIframeHandshake {
+    type: 'okdoc:handshake';
+    /** Iframe protocol version the host supports */
+    version: number;
+    /** MCP protocol version the host supports */
+    mcpProtocolVersion?: string;
+    /** SDK version the host is running */
+    hostSdkVersion?: string;
+}
+/** iframe → host: manifest response (sent on the MessageChannel port). */
+export interface OkDocIframeManifestMessage {
+    type: 'okdoc:manifest';
+    /** Protocol version the iframe SDK implements */
+    sdkVersion: number;
+    /** Plugin manifest with tool declarations */
+    manifest: IframePluginManifest;
+}
+/** host → iframe: tool call request (sent on the MessageChannel port). */
+export interface OkDocIframeCallMessage {
+    type: 'okdoc:call';
+    /** Unique call ID for correlating the response */
+    id: string;
+    /** Tool name (within namespace, e.g. 'getWeather') */
+    tool: string;
+    /** Tool arguments */
+    args: Record<string, unknown>;
+}
+/** iframe → host: tool call result (sent on the MessageChannel port). */
+export interface OkDocIframeResultMessage {
+    type: 'okdoc:result';
+    /** Correlates with the call ID */
+    id: string;
+    /** Tool execution result */
+    result: McpToolResult;
+}
+/** iframe → host: push notification to AI (sent on the MessageChannel port). */
+export interface OkDocIframeNotifyMessage {
+    type: 'okdoc:notify';
+    /** Notification text for the AI */
+    message: string;
+}
+/** Union of all messages that flow over the MessageChannel port. */
+export type OkDocIframePortMessage = OkDocIframeManifestMessage | OkDocIframeCallMessage | OkDocIframeResultMessage | OkDocIframeNotifyMessage;
+/**
+ * Contract that plugin components/services implement to expose MCP tools.
+ * The host registry reads tools from this interface during registration.
+ */
+export interface McpToolProvider {
+    getMcpTools(): McpToolDefinition[];
+}
+/**
+ * A single tool definition exposed by a plugin at runtime.
+ *
+ * Extends the static declaration with host-side fields: a namespace,
+ * a fully-qualified name, and an optional live handler.
+ */
+export interface McpToolDefinition {
+    /** Tool name within namespace (e.g. 'play') */
+    name: string;
+    /** Fully qualified name (e.g. 'audio_player_play'). Set by the host registry. */
+    fullName?: string;
+    /** Namespace this tool belongs to. Set by the host registry. */
+    namespace?: string;
+    /** Human-readable description for the AI */
+    description: string;
+    /** JSON Schema describing input parameters (omit for no-arg tools) */
+    inputSchema?: McpToolInputSchema;
+    /** Tool annotations — hints for AI clients (readOnlyHint, destructiveHint, etc.) */
+    annotations?: McpToolAnnotations;
+    /** The handler function invoked when the AI calls this tool. Absent for deferred (manifest-only) tools. */
+    handler?: (args: Record<string, unknown>) => Promise<McpToolResult>;
+}
+/** Configuration passed when registering a plugin component with the host registry. */
+export interface McpComponentConfig {
+    /** Namespace prefix for tool names (e.g. 'audio_player') */
+    namespace: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,17 @@
+// ============================================================================
+// @okdoc-ai/plugin-sdk — Types
+//
+// Aligned with MCP spec 2025-03-26 (baseline) with forward hooks
+// for 2025-11-25 features (outputSchema, structuredContent, resource_link).
+// ============================================================================
+// ── Version Constants ───────────────────────────────────────────────────────
+/** The MCP protocol version this SDK targets */
+export const OKDOC_MCP_PROTOCOL_VERSION = '2025-03-26';
+/** The OkDoc SDK version (semver) — auto-generated from package.json by stamp-version */
+export { OKDOC_SDK_VERSION } from './version.js';
+/**
+ * Current protocol version for iframe plugin communication.
+ * Bumped (integer) only on breaking changes to the message format.
+ */
+export const OKDOC_IFRAME_PROTOCOL_VERSION = 2;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,+BAA+B;AAC/B,EAAE;AACF,iEAAiE;AACjE,4EAA4E;AAC5E,+EAA+E;AAE/E,+EAA+E;AAE/E,gDAAgD;AAChD,MAAM,CAAC,MAAM,0BAA0B,GAAG,YAAY,CAAC;AAEvD,yFAAyF;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const OKDOC_SDK_VERSION = "1.4.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,4 @@
+// AUTO-GENERATED by scripts/stamp-version.mjs — do not edit manually.
+// Source of truth: package.json "version" field.
+export const OKDOC_SDK_VERSION = '1.4.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,iDAAiD;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC"}