alt-plugin-sdk 0.2.0

package/dist/contracts.d.ts

@@ -0,0 +1,800 @@
+import { z } from 'zod';
+/**
+ * Major version of the plugin SDK that this host understands.
+ * A plugin whose manifest declares a higher major refuses to load.
+ */
+export declare const PLUGIN_HOST_SDK_MAJOR = 1;
+export declare const pluginPermissionSchema: z.ZodEnum<{
+    storage: "storage";
+    "appState:read": "appState:read";
+    "events:subscribe": "events:subscribe";
+    "ai:chat": "ai:chat";
+    "notes:read": "notes:read";
+    "actions:notes": "actions:notes";
+    "notes:write": "notes:write";
+    "notes:select": "notes:select";
+    "folders:write": "folders:write";
+    "recording:control": "recording:control";
+    "transcription:run": "transcription:run";
+    "files:read": "files:read";
+    "files:write": "files:write";
+    "settings:read": "settings:read";
+    "settings:write": "settings:write";
+}>;
+export declare const pluginEventSchema: z.ZodEnum<{
+    activeNoteChanged: "activeNoteChanged";
+    recordingStatusChanged: "recordingStatusChanged";
+    recordingLevel: "recordingLevel";
+    transcriptUpdated: "transcriptUpdated";
+    noteCreated: "noteCreated";
+    noteUpdated: "noteUpdated";
+    noteDeleted: "noteDeleted";
+    folderCreated: "folderCreated";
+    folderUpdated: "folderUpdated";
+    folderDeleted: "folderDeleted";
+    componentUpdated: "componentUpdated";
+    settingChanged: "settingChanged";
+}>;
+/**
+ * @deprecated Use the first-class methods `alt.notes.create()` / `alt.notes.select()`.
+ * Kept as a backwards-compatibility shim for plugins built against SDK v0.
+ */
+export declare const pluginActionSchema: z.ZodEnum<{
+    "notes.select": "notes.select";
+    "notes.create": "notes.create";
+}>;
+export declare const pluginManifestSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodString;
+    entry: z.ZodString;
+    permissions: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        storage: "storage";
+        "appState:read": "appState:read";
+        "events:subscribe": "events:subscribe";
+        "ai:chat": "ai:chat";
+        "notes:read": "notes:read";
+        "actions:notes": "actions:notes";
+        "notes:write": "notes:write";
+        "notes:select": "notes:select";
+        "folders:write": "folders:write";
+        "recording:control": "recording:control";
+        "transcription:run": "transcription:run";
+        "files:read": "files:read";
+        "files:write": "files:write";
+        "settings:read": "settings:read";
+        "settings:write": "settings:write";
+    }>>>;
+    description: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    sdkVersion: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Parse the major number out of a sdkVersion string. Returns NaN for malformed
+ * input — callers should treat NaN as "incompatible".
+ */
+export declare function parsePluginSdkMajor(sdkVersion: string): number;
+/**
+ * `actions:notes` was a single permission that gated both note creation and
+ * selection. The new split surface uses `notes:write` and `notes:select`.
+ * Existing plugins are migrated at runtime by expanding the legacy grant.
+ */
+export declare function expandLegacyPermissions(granted: readonly PluginPermission[]): PluginPermission[];
+export type PluginPermission = z.infer<typeof pluginPermissionSchema>;
+export type PluginEvent = z.infer<typeof pluginEventSchema>;
+export type PluginAction = z.infer<typeof pluginActionSchema>;
+export type PluginManifest = z.infer<typeof pluginManifestSchema>;
+export type PluginManifestInput = z.input<typeof pluginManifestSchema>;
+export type PluginStorageValue = string | number | boolean | null | PluginStorageValue[] | {
+    [key: string]: PluginStorageValue;
+};
+export declare const pluginStorageValueSchema: z.ZodType<PluginStorageValue>;
+export declare const pluginStorageKeySchema: z.ZodString;
+export declare const pluginSdkMethodSchema: z.ZodEnum<{
+    "events:subscribe": "events:subscribe";
+    "notes:select": "notes:select";
+    "files:read": "files:read";
+    "storage:get": "storage:get";
+    "storage:set": "storage:set";
+    "storage:delete": "storage:delete";
+    "storage:list": "storage:list";
+    "state:getActiveNoteSummary": "state:getActiveNoteSummary";
+    "events:unsubscribe": "events:unsubscribe";
+    "actions:invoke": "actions:invoke";
+    "ai:models:list": "ai:models:list";
+    "notes:listFolders": "notes:listFolders";
+    "notes:list": "notes:list";
+    "notes:getContent": "notes:getContent";
+    "notes:create": "notes:create";
+    "notes:update": "notes:update";
+    "notes:delete": "notes:delete";
+    "notes:setMemo": "notes:setMemo";
+    "notes:getMemo": "notes:getMemo";
+    "notes:setSummary": "notes:setSummary";
+    "notes:appendTranscriptLine": "notes:appendTranscriptLine";
+    "notes:listComponents": "notes:listComponents";
+    "notes:getComponent": "notes:getComponent";
+    "notes:upsertComponent": "notes:upsertComponent";
+    "notes:deleteComponent": "notes:deleteComponent";
+    "folders:create": "folders:create";
+    "folders:rename": "folders:rename";
+    "folders:move": "folders:move";
+    "folders:delete": "folders:delete";
+    "recording:start": "recording:start";
+    "recording:stop": "recording:stop";
+    "recording:getStatus": "recording:getStatus";
+    "ai:summarize": "ai:summarize";
+    "files:attach": "files:attach";
+    "files:list": "files:list";
+    "files:delete": "files:delete";
+    "settings:get": "settings:get";
+    "settings:list": "settings:list";
+}>;
+export type PluginSdkMethod = z.infer<typeof pluginSdkMethodSchema>;
+export declare const pluginSdkInvokeRequestSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    method: z.ZodEnum<{
+        "events:subscribe": "events:subscribe";
+        "notes:select": "notes:select";
+        "files:read": "files:read";
+        "storage:get": "storage:get";
+        "storage:set": "storage:set";
+        "storage:delete": "storage:delete";
+        "storage:list": "storage:list";
+        "state:getActiveNoteSummary": "state:getActiveNoteSummary";
+        "events:unsubscribe": "events:unsubscribe";
+        "actions:invoke": "actions:invoke";
+        "ai:models:list": "ai:models:list";
+        "notes:listFolders": "notes:listFolders";
+        "notes:list": "notes:list";
+        "notes:getContent": "notes:getContent";
+        "notes:create": "notes:create";
+        "notes:update": "notes:update";
+        "notes:delete": "notes:delete";
+        "notes:setMemo": "notes:setMemo";
+        "notes:getMemo": "notes:getMemo";
+        "notes:setSummary": "notes:setSummary";
+        "notes:appendTranscriptLine": "notes:appendTranscriptLine";
+        "notes:listComponents": "notes:listComponents";
+        "notes:getComponent": "notes:getComponent";
+        "notes:upsertComponent": "notes:upsertComponent";
+        "notes:deleteComponent": "notes:deleteComponent";
+        "folders:create": "folders:create";
+        "folders:rename": "folders:rename";
+        "folders:move": "folders:move";
+        "folders:delete": "folders:delete";
+        "recording:start": "recording:start";
+        "recording:stop": "recording:stop";
+        "recording:getStatus": "recording:getStatus";
+        "ai:summarize": "ai:summarize";
+        "files:attach": "files:attach";
+        "files:list": "files:list";
+        "files:delete": "files:delete";
+        "settings:get": "settings:get";
+        "settings:list": "settings:list";
+    }>;
+    params: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export type PluginSdkInvokeRequest = z.infer<typeof pluginSdkInvokeRequestSchema>;
+export declare const pluginAiModelIdSchema: z.ZodEnum<{
+    "gpt-5.4": "gpt-5.4";
+    auto: "auto";
+    local: "local";
+}>;
+export declare const pluginAiModelProviderSchema: z.ZodEnum<{
+    auto: "auto";
+    local: "local";
+    cloud: "cloud";
+}>;
+export declare const pluginAiModelAvailabilitySchema: z.ZodEnum<{
+    ready: "ready";
+    unavailable: "unavailable";
+}>;
+export declare const pluginAiEndpointSchema: z.ZodEnum<{
+    "chat.completions": "chat.completions";
+}>;
+export type PluginAiModelId = z.infer<typeof pluginAiModelIdSchema>;
+export type PluginAiModelProvider = z.infer<typeof pluginAiModelProviderSchema>;
+export type PluginAiModelAvailability = z.infer<typeof pluginAiModelAvailabilitySchema>;
+export type PluginAiEndpoint = z.infer<typeof pluginAiEndpointSchema>;
+export declare const pluginAiModelInfoSchema: z.ZodObject<{
+    id: z.ZodEnum<{
+        "gpt-5.4": "gpt-5.4";
+        auto: "auto";
+        local: "local";
+    }>;
+    name: z.ZodString;
+    provider: z.ZodEnum<{
+        auto: "auto";
+        local: "local";
+        cloud: "cloud";
+    }>;
+    supportsTools: z.ZodBoolean;
+    availability: z.ZodEnum<{
+        ready: "ready";
+        unavailable: "unavailable";
+    }>;
+}, z.core.$strip>;
+export type PluginAiModelInfo = z.infer<typeof pluginAiModelInfoSchema>;
+export declare const pluginAiStreamRequestSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    endpoint: z.ZodEnum<{
+        "chat.completions": "chat.completions";
+    }>;
+    model: z.ZodDefault<z.ZodEnum<{
+        "gpt-5.4": "gpt-5.4";
+        auto: "auto";
+        local: "local";
+    }>>;
+    method: z.ZodLiteral<"POST">;
+    headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodString;
+}, z.core.$strip>;
+export type PluginAiStreamRequest = z.infer<typeof pluginAiStreamRequestSchema>;
+export declare const pluginAiStreamStartSchema: z.ZodObject<{
+    status: z.ZodNumber;
+    headers: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+export type PluginAiStreamStart = z.infer<typeof pluginAiStreamStartSchema>;
+export declare const pluginAiStreamErrorCodeSchema: z.ZodEnum<{
+    FORBIDDEN: "FORBIDDEN";
+    MODEL_UNAVAILABLE: "MODEL_UNAVAILABLE";
+    INVALID_REQUEST: "INVALID_REQUEST";
+    PROXY_ERROR: "PROXY_ERROR";
+}>;
+export type PluginAiStreamErrorCode = z.infer<typeof pluginAiStreamErrorCodeSchema>;
+export declare const pluginAiStreamErrorSchema: z.ZodObject<{
+    code: z.ZodEnum<{
+        FORBIDDEN: "FORBIDDEN";
+        MODEL_UNAVAILABLE: "MODEL_UNAVAILABLE";
+        INVALID_REQUEST: "INVALID_REQUEST";
+        PROXY_ERROR: "PROXY_ERROR";
+    }>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export type PluginAiStreamError = z.infer<typeof pluginAiStreamErrorSchema>;
+export interface PluginAiStreamHandlers {
+    onStart(meta: PluginAiStreamStart): void;
+    onChunk(chunk: ArrayBuffer): void;
+    onEnd(): void;
+    onError(error: PluginAiStreamError): void;
+}
+export interface PluginAiStreamHandle {
+    cancel(): void;
+}
+export declare const pluginActionInvokeParamsSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        "notes.select": "notes.select";
+        "notes.create": "notes.create";
+    }>;
+    payload: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const pluginSelectNotePayloadSchema: z.ZodObject<{
+    noteId: z.ZodNumber;
+}, z.core.$strip>;
+export declare const pluginCreateNotePayloadSchema: z.ZodObject<{
+    title: z.ZodString;
+    folderId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type PluginSelectNotePayload = z.infer<typeof pluginSelectNotePayloadSchema>;
+export type PluginCreateNotePayload = z.infer<typeof pluginCreateNotePayloadSchema>;
+export interface PluginActiveNoteSummary {
+    id: number;
+    title: string;
+    status: 'draft' | 'in_progress' | 'completed';
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PluginCreatedNoteSummary {
+    id?: number;
+    title: string;
+    folder_id: number | null;
+    lecture_date: string;
+    status: 'draft' | 'in_progress' | 'completed';
+    created_at: string;
+    updated_at?: string;
+}
+export interface PluginActionPayloadMap {
+    'notes.select': PluginSelectNotePayload;
+    'notes.create': PluginCreateNotePayload;
+}
+export interface PluginActionResultMap {
+    'notes.select': {
+        ok: true;
+    };
+    'notes.create': PluginCreatedNoteSummary;
+}
+export declare const pluginRecordingPhaseSchema: z.ZodEnum<{
+    idle: "idle";
+    recording: "recording";
+    paused: "paused";
+}>;
+export type PluginRecordingPhase = z.infer<typeof pluginRecordingPhaseSchema>;
+export declare const pluginRecordingStatusSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        idle: "idle";
+        recording: "recording";
+        paused: "paused";
+    }>;
+    noteId: z.ZodNullable<z.ZodNumber>;
+    durationMs: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginRecordingStatus = z.infer<typeof pluginRecordingStatusSchema>;
+export declare const pluginRecordingLevelSchema: z.ZodObject<{
+    micDb: z.ZodNumber;
+    systemDb: z.ZodNumber;
+    timestamp: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginRecordingLevel = z.infer<typeof pluginRecordingLevelSchema>;
+export type PluginHostEventPayload = {
+    event: 'activeNoteChanged';
+    data: PluginActiveNoteSummary | null;
+} | {
+    event: 'recordingStatusChanged';
+    data: PluginRecordingStatus;
+} | {
+    event: 'recordingLevel';
+    data: PluginRecordingLevel;
+} | {
+    event: 'transcriptUpdated';
+    data: {
+        noteId: number;
+    };
+} | {
+    event: 'noteCreated';
+    data: PluginNoteSummary;
+} | {
+    event: 'noteUpdated';
+    data: PluginNoteSummary;
+} | {
+    event: 'noteDeleted';
+    data: {
+        noteId: number;
+    };
+} | {
+    event: 'folderCreated';
+    data: PluginFolderNode;
+} | {
+    event: 'folderUpdated';
+    data: PluginFolderNode;
+} | {
+    event: 'folderDeleted';
+    data: {
+        folderId: number;
+    };
+} | {
+    event: 'componentUpdated';
+    data: PluginNoteComponentSummary;
+} | {
+    event: 'settingChanged';
+    data: {
+        key: PluginAppSettingKey;
+        value: PluginAppSettingValue;
+    };
+};
+export type PluginEventData<TEvent extends PluginEvent> = Extract<PluginHostEventPayload, {
+    event: TEvent;
+}>['data'];
+export declare const pluginNoteStatusSchema: z.ZodEnum<{
+    draft: "draft";
+    in_progress: "in_progress";
+    completed: "completed";
+}>;
+export type PluginNoteStatus = z.infer<typeof pluginNoteStatusSchema>;
+export declare const pluginNoteSummarySchema: z.ZodObject<{
+    id: z.ZodNumber;
+    title: z.ZodString;
+    folderId: z.ZodNullable<z.ZodNumber>;
+    status: z.ZodEnum<{
+        draft: "draft";
+        in_progress: "in_progress";
+        completed: "completed";
+    }>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type PluginNoteSummary = z.infer<typeof pluginNoteSummarySchema>;
+export interface PluginFolderNode {
+    id: number;
+    name: string;
+    parentId: number | null;
+    children: PluginFolderNode[];
+}
+export declare const pluginFolderNodeSchema: z.ZodType<PluginFolderNode>;
+export declare const PLUGIN_NOTES_LIST_MAX_LIMIT = 200;
+export declare const PLUGIN_NOTES_LIST_DEFAULT_LIMIT = 50;
+export declare const pluginNotesListParamsSchema: z.ZodObject<{
+    folderId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    query: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type PluginNotesListParams = z.infer<typeof pluginNotesListParamsSchema>;
+export declare const pluginNoteContentSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    title: z.ZodString;
+    transcript: z.ZodString;
+    memo: z.ZodString;
+    summary: z.ZodString;
+}, z.core.$strip>;
+export type PluginNoteContent = z.infer<typeof pluginNoteContentSchema>;
+export declare const pluginGetNoteContentParamsSchema: z.ZodObject<{
+    noteId: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginGetNoteContentParams = z.infer<typeof pluginGetNoteContentParamsSchema>;
+/**
+ * Plugin-visible note component summary. Mirrors the shape exposed by the
+ * `componentUpdated` event so plugins can react to changes without re-listing.
+ *
+ * `componentType` lists every component the database supports today; new
+ * types may be added in future migrations and should be treated as opaque
+ * by plugins that don't recognize them.
+ */
+export declare const pluginNoteComponentTypeSchema: z.ZodEnum<{
+    recording: "recording";
+    slides: "slides";
+    memo: "memo";
+    transcript: "transcript";
+    summary: "summary";
+    slide_summary: "slide_summary";
+    meeting_notes: "meeting_notes";
+}>;
+export type PluginNoteComponentType = z.infer<typeof pluginNoteComponentTypeSchema>;
+export declare const pluginNoteComponentSummarySchema: z.ZodObject<{
+    id: z.ZodNumber;
+    noteId: z.ZodNumber;
+    componentType: z.ZodEnum<{
+        recording: "recording";
+        slides: "slides";
+        memo: "memo";
+        transcript: "transcript";
+        summary: "summary";
+        slide_summary: "slide_summary";
+        meeting_notes: "meeting_notes";
+    }>;
+    title: z.ZodString;
+    displayOrder: z.ZodNumber;
+    hasFile: z.ZodBoolean;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type PluginNoteComponentSummary = z.infer<typeof pluginNoteComponentSummarySchema>;
+export declare const pluginUpdateNoteParamsSchema: z.ZodObject<{
+    noteId: z.ZodNumber;
+    title: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        in_progress: "in_progress";
+        completed: "completed";
+    }>>;
+    folderId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type PluginUpdateNoteParams = z.infer<typeof pluginUpdateNoteParamsSchema>;
+export declare const pluginDeleteNoteParamsSchema: z.ZodObject<{
+    noteId: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginDeleteNoteParams = z.infer<typeof pluginDeleteNoteParamsSchema>;
+export declare const pluginSetMemoParamsSchema: z.ZodObject<{
+    noteId: z.ZodNumber;
+    markdown: z.ZodString;
+}, z.core.$strip>;
+export type PluginSetMemoParams = z.infer<typeof pluginSetMemoParamsSchema>;
+export declare const pluginGetMemoParamsSchema: z.ZodObject<{
+    noteId: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginGetMemoParams = z.infer<typeof pluginGetMemoParamsSchema>;
+export declare const pluginSetSummaryParamsSchema: z.ZodObject<{
+    noteId: z.ZodNumber;
+    markdown: z.ZodString;
+}, z.core.$strip>;
+export type PluginSetSummaryParams = z.infer<typeof pluginSetSummaryParamsSchema>;
+/**
+ * Single transcript line to append. Times are in milliseconds relative to the
+ * start of the note's recording. End is optional — when omitted, the line is
+ * treated as a point-in-time annotation rather than a duration.
+ */
+export declare const pluginAppendTranscriptLineParamsSchema: z.ZodObject<{
+    noteId: z.ZodNumber;
+    text: z.ZodString;
+    startMs: z.ZodNumber;
+    endMs: z.ZodOptional<z.ZodNumber>;
+    speaker: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PluginAppendTranscriptLineParams = z.infer<typeof pluginAppendTranscriptLineParamsSchema>;
+export declare const pluginListComponentsParamsSchema: z.ZodObject<{
+    noteId: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginListComponentsParams = z.infer<typeof pluginListComponentsParamsSchema>;
+export declare const pluginGetComponentParamsSchema: z.ZodObject<{
+    componentId: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginGetComponentParams = z.infer<typeof pluginGetComponentParamsSchema>;
+/**
+ * Plugin-visible note component, including raw content_text. Read-only — to
+ * mutate, use the type-specific methods (setMemo, setSummary, appendTranscriptLine)
+ * or upsertComponent for new text-based components.
+ */
+export declare const pluginNoteComponentSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    noteId: z.ZodNumber;
+    componentType: z.ZodEnum<{
+        recording: "recording";
+        slides: "slides";
+        memo: "memo";
+        transcript: "transcript";
+        summary: "summary";
+        slide_summary: "slide_summary";
+        meeting_notes: "meeting_notes";
+    }>;
+    title: z.ZodString;
+    displayOrder: z.ZodNumber;
+    hasFile: z.ZodBoolean;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    contentText: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type PluginNoteComponent = z.infer<typeof pluginNoteComponentSchema>;
+/**
+ * Text-based component types that plugins can create directly. File-based
+ * components (slides, recording) must go through `alt.files.attach` instead.
+ */
+export declare const pluginUpsertableComponentTypeSchema: z.ZodEnum<{
+    memo: "memo";
+    transcript: "transcript";
+    summary: "summary";
+    slide_summary: "slide_summary";
+    meeting_notes: "meeting_notes";
+}>;
+export type PluginUpsertableComponentType = z.infer<typeof pluginUpsertableComponentTypeSchema>;
+export declare const pluginUpsertComponentParamsSchema: z.ZodObject<{
+    noteId: z.ZodNumber;
+    componentId: z.ZodOptional<z.ZodNumber>;
+    componentType: z.ZodEnum<{
+        memo: "memo";
+        transcript: "transcript";
+        summary: "summary";
+        slide_summary: "slide_summary";
+        meeting_notes: "meeting_notes";
+    }>;
+    title: z.ZodString;
+    contentText: z.ZodString;
+    displayOrder: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type PluginUpsertComponentParams = z.infer<typeof pluginUpsertComponentParamsSchema>;
+export declare const pluginDeleteComponentParamsSchema: z.ZodObject<{
+    componentId: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginDeleteComponentParams = z.infer<typeof pluginDeleteComponentParamsSchema>;
+export declare const pluginCreateFolderParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+    parentId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type PluginCreateFolderParams = z.infer<typeof pluginCreateFolderParamsSchema>;
+export declare const pluginRenameFolderParamsSchema: z.ZodObject<{
+    folderId: z.ZodNumber;
+    name: z.ZodString;
+}, z.core.$strip>;
+export type PluginRenameFolderParams = z.infer<typeof pluginRenameFolderParamsSchema>;
+export declare const pluginMoveFolderParamsSchema: z.ZodObject<{
+    folderId: z.ZodNumber;
+    parentId: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type PluginMoveFolderParams = z.infer<typeof pluginMoveFolderParamsSchema>;
+export declare const pluginDeleteFolderParamsSchema: z.ZodObject<{
+    folderId: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginDeleteFolderParams = z.infer<typeof pluginDeleteFolderParamsSchema>;
+export declare const pluginRecordingStartParamsSchema: z.ZodObject<{
+    noteId: z.ZodNumber;
+    lectureLanguage: z.ZodOptional<z.ZodString>;
+    targetTranslationLanguage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    includeSystemAudio: z.ZodOptional<z.ZodBoolean>;
+    selectedDeviceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PluginRecordingStartParams = z.infer<typeof pluginRecordingStartParamsSchema>;
+/** Single segment of transcribed audio in milliseconds. */
+export declare const pluginTranscriptionSegmentSchema: z.ZodObject<{
+    startMs: z.ZodNumber;
+    endMs: z.ZodNumber;
+    text: z.ZodString;
+    speaker: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PluginTranscriptionSegment = z.infer<typeof pluginTranscriptionSegmentSchema>;
+export declare const pluginTranscribeFileRequestSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    filePath: z.ZodString;
+    language: z.ZodOptional<z.ZodString>;
+    diarization: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type PluginTranscribeFileRequest = z.infer<typeof pluginTranscribeFileRequestSchema>;
+export declare const pluginTranscribeNoteRequestSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    noteId: z.ZodNumber;
+    language: z.ZodOptional<z.ZodString>;
+    diarization: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type PluginTranscribeNoteRequest = z.infer<typeof pluginTranscribeNoteRequestSchema>;
+export declare const pluginTranscriptionStartSchema: z.ZodObject<{
+    durationMs: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type PluginTranscriptionStart = z.infer<typeof pluginTranscriptionStartSchema>;
+export declare const pluginTranscriptionProgressSchema: z.ZodObject<{
+    fraction: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginTranscriptionProgress = z.infer<typeof pluginTranscriptionProgressSchema>;
+export declare const pluginTranscriptionStreamErrorCodeSchema: z.ZodEnum<{
+    FORBIDDEN: "FORBIDDEN";
+    INVALID_REQUEST: "INVALID_REQUEST";
+    RECORDING_ACTIVE: "RECORDING_ACTIVE";
+    FILE_UNAVAILABLE: "FILE_UNAVAILABLE";
+    PIPELINE_ERROR: "PIPELINE_ERROR";
+}>;
+export type PluginTranscriptionStreamErrorCode = z.infer<typeof pluginTranscriptionStreamErrorCodeSchema>;
+export declare const pluginTranscriptionStreamErrorSchema: z.ZodObject<{
+    code: z.ZodEnum<{
+        FORBIDDEN: "FORBIDDEN";
+        INVALID_REQUEST: "INVALID_REQUEST";
+        RECORDING_ACTIVE: "RECORDING_ACTIVE";
+        FILE_UNAVAILABLE: "FILE_UNAVAILABLE";
+        PIPELINE_ERROR: "PIPELINE_ERROR";
+    }>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export type PluginTranscriptionStreamError = z.infer<typeof pluginTranscriptionStreamErrorSchema>;
+export interface PluginTranscriptionStreamHandlers {
+    onStart(meta: PluginTranscriptionStart): void;
+    onSegment(segment: PluginTranscriptionSegment): void;
+    onProgress(progress: PluginTranscriptionProgress): void;
+    onEnd(result: {
+        segments: PluginTranscriptionSegment[];
+    }): void;
+    onError(error: PluginTranscriptionStreamError): void;
+}
+export interface PluginTranscriptionStreamHandle {
+    cancel(): void;
+}
+export declare const pluginAiChatMessageRoleSchema: z.ZodEnum<{
+    system: "system";
+    user: "user";
+    assistant: "assistant";
+}>;
+export type PluginAiChatMessageRole = z.infer<typeof pluginAiChatMessageRoleSchema>;
+export declare const pluginAiChatMessageSchema: z.ZodObject<{
+    role: z.ZodEnum<{
+        system: "system";
+        user: "user";
+        assistant: "assistant";
+    }>;
+    content: z.ZodString;
+}, z.core.$strip>;
+export type PluginAiChatMessage = z.infer<typeof pluginAiChatMessageSchema>;
+export declare const pluginAiCompleteRequestSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    model: z.ZodDefault<z.ZodEnum<{
+        "gpt-5.4": "gpt-5.4";
+        auto: "auto";
+        local: "local";
+    }>>;
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<{
+            system: "system";
+            user: "user";
+            assistant: "assistant";
+        }>;
+        content: z.ZodString;
+    }, z.core.$strip>>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$strip>;
+export type PluginAiCompleteRequest = z.input<typeof pluginAiCompleteRequestSchema>;
+export declare const pluginAiCompleteResultSchema: z.ZodObject<{
+    text: z.ZodString;
+    finishReason: z.ZodNullable<z.ZodString>;
+    toolCalls: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$strip>;
+export type PluginAiCompleteResult = z.infer<typeof pluginAiCompleteResultSchema>;
+/**
+ * Plugin-facing summarize request. The host pulls the note's transcript and
+ * existing memo, runs them through Alt's built-in summarize prompt, and
+ * returns the final markdown.
+ */
+export declare const pluginAiSummarizeRequestSchema: z.ZodObject<{
+    noteId: z.ZodNumber;
+    style: z.ZodOptional<z.ZodString>;
+    outputLanguage: z.ZodOptional<z.ZodString>;
+    model: z.ZodDefault<z.ZodEnum<{
+        "gpt-5.4": "gpt-5.4";
+        auto: "auto";
+        local: "local";
+    }>>;
+}, z.core.$strip>;
+export type PluginAiSummarizeRequest = z.input<typeof pluginAiSummarizeRequestSchema>;
+export declare const pluginAiSummarizeResultSchema: z.ZodObject<{
+    noteId: z.ZodNumber;
+    text: z.ZodString;
+}, z.core.$strip>;
+export type PluginAiSummarizeResult = z.infer<typeof pluginAiSummarizeResultSchema>;
+/**
+ * File-based component types a plugin can attach. Mirrors the database
+ * constraint — only these two component_types may carry a file_inode.
+ */
+export declare const pluginAttachableComponentTypeSchema: z.ZodEnum<{
+    recording: "recording";
+    slides: "slides";
+}>;
+export type PluginAttachableComponentType = z.infer<typeof pluginAttachableComponentTypeSchema>;
+export declare const pluginAttachFileParamsSchema: z.ZodObject<{
+    noteId: z.ZodNumber;
+    fileName: z.ZodString;
+    data: z.ZodCustom<ArrayBuffer, ArrayBuffer>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    componentType: z.ZodEnum<{
+        recording: "recording";
+        slides: "slides";
+    }>;
+    title: z.ZodOptional<z.ZodString>;
+    displayOrder: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type PluginAttachFileParams = z.input<typeof pluginAttachFileParamsSchema>;
+export declare const pluginAttachedFileSchema: z.ZodObject<{
+    componentId: z.ZodNumber;
+    fileId: z.ZodNumber;
+    fileName: z.ZodString;
+    mimeType: z.ZodNullable<z.ZodString>;
+    sizeBytes: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginAttachedFile = z.infer<typeof pluginAttachedFileSchema>;
+export declare const pluginListFilesParamsSchema: z.ZodObject<{
+    noteId: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginListFilesParams = z.infer<typeof pluginListFilesParamsSchema>;
+export declare const pluginReadFileParamsSchema: z.ZodObject<{
+    fileId: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginReadFileParams = z.infer<typeof pluginReadFileParamsSchema>;
+export declare const pluginReadFileResultSchema: z.ZodObject<{
+    fileName: z.ZodString;
+    mimeType: z.ZodNullable<z.ZodString>;
+    sizeBytes: z.ZodNumber;
+    data: z.ZodCustom<ArrayBuffer, ArrayBuffer>;
+}, z.core.$strip>;
+export type PluginReadFileResult = z.infer<typeof pluginReadFileResultSchema>;
+export declare const pluginDeleteFileParamsSchema: z.ZodObject<{
+    componentId: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginDeleteFileParams = z.infer<typeof pluginDeleteFileParamsSchema>;
+/**
+ * Curated set of app-level setting keys plugins can read. Adding keys here
+ * is an explicit API decision — anything not listed is intentionally hidden
+ * from plugins.
+ */
+export declare const pluginAppSettingKeySchema: z.ZodEnum<{
+    theme: "theme";
+    language: "language";
+    "transcription.lectureLanguage": "transcription.lectureLanguage";
+    "transcription.diarizationEnabled": "transcription.diarizationEnabled";
+    "transcription.includeSystemAudio": "transcription.includeSystemAudio";
+}>;
+export type PluginAppSettingKey = z.infer<typeof pluginAppSettingKeySchema>;
+export declare const pluginAppSettingValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+export type PluginAppSettingValue = z.infer<typeof pluginAppSettingValueSchema>;
+export declare const pluginGetSettingParamsSchema: z.ZodObject<{
+    key: z.ZodEnum<{
+        theme: "theme";
+        language: "language";
+        "transcription.lectureLanguage": "transcription.lectureLanguage";
+        "transcription.diarizationEnabled": "transcription.diarizationEnabled";
+        "transcription.includeSystemAudio": "transcription.includeSystemAudio";
+    }>;
+}, z.core.$strip>;
+export type PluginGetSettingParams = z.infer<typeof pluginGetSettingParamsSchema>;
+export declare const pluginSettingsSnapshotSchema: z.ZodRecord<z.ZodEnum<{
+    theme: "theme";
+    language: "language";
+    "transcription.lectureLanguage": "transcription.lectureLanguage";
+    "transcription.diarizationEnabled": "transcription.diarizationEnabled";
+    "transcription.includeSystemAudio": "transcription.includeSystemAudio";
+}>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+export type PluginSettingsSnapshot = z.infer<typeof pluginSettingsSnapshotSchema>;
+//# sourceMappingURL=contracts.d.ts.map