@zackbart/connecta 0.34.1 → 0.36.0

package/dist/providers/wispr-flow/index.d.ts

@@ -1,14 +0,0 @@
-import { type RemoteMcpAuth } from "../../connectors/remote-mcp.js";
-import { type ProviderOptions } from "../../provider.js";
-/** Wispr Flow's hosted Streamable HTTP endpoint, without a trailing slash. */
-export declare const WISPR_FLOW_MCP_ENDPOINT = "https://api.wisprflow.ai/connect/mcp";
-type WisprFlowOAuth = Extract<RemoteMcpAuth, {
-    type: "oauth";
-}>;
-export interface WisprFlowOptions extends ProviderOptions {
-    /** OAuth only; defaults to browser authorization with the advertised scopes. */
-    auth?: WisprFlowOAuth;
-}
-/** A maintained Wispr Flow Notetaker hosted-MCP connection. */
-export declare const wisprFlow: import("../../provider.js").ProviderFactory<WisprFlowOptions>;
-export {};

package/dist/providers/wispr-flow/index.js

@@ -1,117 +0,0 @@
-import { remoteMcp } from "../../connectors/remote-mcp.js";
-import { keys, optionsOf, variants } from "../../config-schema.js";
-import { defineProvider, PROVIDER_COMMON } from "../../provider.js";
-import { skill } from "./skill.generated.js";
-/** Wispr Flow's hosted Streamable HTTP endpoint, without a trailing slash. */
-export const WISPR_FLOW_MCP_ENDPOINT = "https://api.wisprflow.ai/connect/mcp";
-/**
- * Reviewed public-source superset, 2026-10-13. Scalekit documents 14 reads;
- * Claude's connector directory adds four task tools. Wispr's own help page
- * describes read-only access, so the task writes remain classified even if
- * this account never exposes them. No authenticated catalog or schemas were
- * captured. Vendor names, schemas and results remain live.
- */
-const CLASSIFICATION = {
-    tools: {
-        get_account_info: { verdict: "read", reason: "Returns the signed-in identity and calendar display-name aliases." },
-        get_calendar_event: { verdict: "read", reason: "Retrieves an existing calendar event and its attendees." },
-        get_meeting: {
-            verdict: "read",
-            reason: "Retrieves recorded notes, the summary, attendees and requested transcript ranges.",
-        },
-        get_meeting_by_calendar_id: {
-            verdict: "read",
-            reason: "Finds the existing recording linked to a calendar event and reads its content.",
-        },
-        get_meeting_participants_enriched: {
-            verdict: "read",
-            reason: "Reads participant information and identifies the signed-in attendee.",
-        },
-        get_scratchpad_note: { verdict: "read", reason: "Returns a bounded range of an existing Scratchpad note." },
-        get_upcoming_meeting: {
-            verdict: "read",
-            reason: "Reads an upcoming event and an available pre-read without generating one.",
-        },
-        list_meeting_series: {
-            verdict: "read",
-            reason: "Lists recorded occurrences of an existing recurring meeting series.",
-        },
-        list_upcoming_meetings: {
-            verdict: "read",
-            reason: "Lists upcoming calendar events and already-available pre-reads.",
-        },
-        resolve_calendar_link: {
-            verdict: "read",
-            reason: "Matches a pasted calendar or conference URL to an existing event.",
-        },
-        resolve_share_link: {
-            verdict: "read",
-            reason: "Reads an accessible shared note without creating a link or changing sharing permissions.",
-        },
-        search_calendar_events: { verdict: "read", reason: "Finds existing calendar events by date, attendees or text." },
-        search_meetings: {
-            verdict: "read",
-            reason: "Finds recorded meetings by title, summary, notes, dates or linked attendees.",
-        },
-        search_scratchpad_notes: { verdict: "read", reason: "Finds existing Scratchpad notes by text." },
-        get_task: { verdict: "read", reason: "Retrieves an existing task without changing its state." },
-        search_tasks: { verdict: "read", reason: "Finds existing tasks without changing them." },
-        add_task: {
-            verdict: "write",
-            reason: "Creates a new task; the reviewed operation appends rather than replacing an existing task.",
-        },
-        update_task: { verdict: "destructive", reason: "Changes the state or fields of an existing task." },
-    },
-};
-const OPTIONS = optionsOf()({
-    ...PROVIDER_COMMON,
-    auth: variants("type", {
-        oauth: optionsOf()({
-            ...keys("type", "clientMetadataUrl", "scope"),
-            client: optionsOf()(keys("issuer", "clientId", "clientSecret", "tokenEndpointAuthMethod")),
-        }).shape,
-    }),
-});
-function accountSummary(purpose) {
-    const summary = `Account-wide Notetaker access: ${purpose}`;
-    const bytes = new TextEncoder().encode(summary);
-    if (bytes.byteLength <= 120)
-        return summary;
-    // Streaming decode drops an incomplete final code point; reserve three bytes for the ellipsis.
-    return `${new TextDecoder().decode(bytes.subarray(0, 117), { stream: true }).trimEnd()}…`;
-}
-/** A maintained Wispr Flow Notetaker hosted-MCP connection. */
-export const wisprFlow = defineProvider({
-    name: "wispr-flow",
-    title: "Wispr Flow",
-    kind: "mcp",
-    readme: "Wispr Flow",
-    skill,
-    classify: CLASSIFICATION,
-    options: OPTIONS,
-    bundle: {
-        baselineGzip: 169009,
-        maxGzip: 229009,
-        note: "./providers/wispr-flow initial measured baseline is 169,009 B gzip for the hosted-MCP wrapper; the cap retains the existing baseline + 60,000 B provider headroom policy.",
-    },
-    create(id, options, provider) {
-        const ownership = options.authScope === "personal"
-            ? "Each person authorizes separately and may reach a different account."
-            : "One shared authorization selects the account for everyone using this connector.";
-        return remoteMcp(id, {
-            url: WISPR_FLOW_MCP_ENDPOINT,
-            ...provider.connectorOptions,
-            title: options.title ?? "Wispr Flow",
-            description: `Wispr Flow Notetaker meetings, Scratchpad notes, calendar events and tasks: ${options.purpose}`,
-            auth: { type: "oauth", scope: "openid offline_access", ...options.auth },
-            requireHttps: true,
-            classify: provider.classify,
-            usageGuide: provider.usageGuide({
-                context: [
-                    `Account-wide Notetaker access: ${options.purpose}. Personal and work accounts hold separate content. ${ownership} Confirm the identity with get_account_info. Dictation history and Notetaker chat history are unavailable.`,
-                ],
-                summary: accountSummary(options.purpose),
-            }),
-        });
-    },
-});

package/dist/providers/wispr-flow/skill.generated.js

@@ -1,8 +0,0 @@
-// Generated by scripts/generate-providers.mjs; do not edit.
-export const skill = {
-    "content": "- This connection reaches Notetaker meetings, summaries, notes, transcripts, participants and their email addresses, and tasks; Scratchpad notes; calendar events and linked recordings; upcoming meetings with available pre-reads; recurring series; accessible shared notes; and account identity. Meeting results name folders you own or that are shared with you; meetings outside folders list none. Another account needs another authorization. Use `get_account_info` to check which identity this grant reaches.\n- OAuth browser authorization is the only supported auth method. There is no API key. Prefer Google, Apple, Microsoft or enterprise SSO and finish sign-in within about five minutes. Email-and-password sign-in may not complete authorization; Wispr's help pages disagree. Consent covers the account's existing content, without per-meeting consent.\n- Search first, then retrieve by the returned id: `search_meetings` → `get_meeting`, `search_scratchpad_notes` → `get_scratchpad_note`, or `search_calendar_events` → `get_calendar_event`. Resolve pasted URLs with `resolve_calendar_link` or `resolve_share_link` instead of guessing ids. Use `get_meeting_by_calendar_id` for the recording linked to an event; an event without a recording is not missing meeting content. `get_upcoming_meeting` is for future events. For `list_meeting_series`, \"no earlier occurrence\" can mean a one-off meeting or a recording without a linked calendar event, not a failure.\n- `search_meetings` matches titles, summaries and notes, not transcripts. Set `field` to `title`, `content` or `both`; use `query`, `since` and `until` to narrow the request. `attendee_emails` with `attendee_match` set to `any` or `all` only finds recordings linked to calendar events. A missing attendee-filter match does not prove a person never attended. Results include an excerpt and up to five attendees; retrieve the meeting for full content and attendees.\n- List and search tools page with `cursor` and `limit`, normally 25 items and at most 200. Pass the returned `next_cursor` verbatim while `has_more` is true. `list_upcoming_meetings` allows at most 50 items and `window_hours` defaults to 24 with a maximum of 168. A `truncated` result needs a narrower query, even after paging. Reduce results inside `execute_code` before returning them.\n- Notes and transcripts are character-bounded. Read the continuation marker and repeat with `view_content.start_char` or `view_transcript.start_char` set to its exact offset. Request `view_transcript: {}` when source detail matters, then continue through the required ranges. Enterprise note and transcript reads are recorded in audit logs; do not read transcripts speculatively. Summaries are complete. Transcript retention deletes transcripts and audio, not summaries; an unavailable transcript may have expired.\n- Shared-note links require your own meeting-access permissions. If a link copied from email is rejected, ask the user to open it in a browser and pass the final Wispr Flow URL. Transcripts require ownership or an explicit email invitation plus the owner's organization allowing transcript sharing. Domain, team or anyone-with-link access yields summaries only. Reauthorization cannot widen those permissions. Return the provided `share_link` when asked for a link; never fabricate one or assume the link changes who can read it.\n- Timestamps are UTC. Present them in the user's time zone. For a whole local day, supply `since` at local midnight with its UTC offset and `until` at the next local midnight; the upper bound is exclusive. Upcoming pre-reads may be absent because the desktop app generates them on demand; these reads do not generate them.\n- Both official help articles describe read-only access and list tasks or action items as readable, while Wispr's own Claude directory listing advertises \"Create, update, and search action items\" and names `add_task` and `update_task`. Discover this account's actual tools before using them. If exposed, `get_task` and `search_tasks` read, `add_task` creates a new task and is a write, and `update_task` changes existing task state and is destructive. Unknown tools without an explicit, uncontradicted read annotation fail closed.\n- Mac and Windows accounts need Notetaker and MCP access. Personal or organization HIPAA BAA coverage removes all MCP tools. Enterprise administrators can disable MCP or require an approved IP network; Scratchpad and cloud-access policies may further restrict results. An empty catalog or policy denial requires checking account access, not repeated authorization.\n- For \"Too many requests\" or repeated searches that temporarily fail without explanation, wait about one minute before retrying and avoid speculative fan-out. There is no maintained per-runtime admission default; the operator may configure `callAdmission` for this deployment.\n- An `auth_required` failure means this connector's Wispr Flow authorization is missing or expired: run `authorize_connector` for this connector id, then retry the same call unchanged. For guest calls, classification and routing, fetch `skills({ name: \"usage\" })`.\n",
-    "instructionsHeading": "Account instructions",
-    "fragments": {
-        "content": "- This connection reaches Notetaker meetings, summaries, notes, transcripts, participants and their email addresses, and tasks; Scratchpad notes; calendar events and linked recordings; upcoming meetings with available pre-reads; recurring series; accessible shared notes; and account identity. Meeting results name folders you own or that are shared with you; meetings outside folders list none. Another account needs another authorization. Use `get_account_info` to check which identity this grant reaches.\n- OAuth browser authorization is the only supported auth method. There is no API key. Prefer Google, Apple, Microsoft or enterprise SSO and finish sign-in within about five minutes. Email-and-password sign-in may not complete authorization; Wispr's help pages disagree. Consent covers the account's existing content, without per-meeting consent.\n- Search first, then retrieve by the returned id: `search_meetings` → `get_meeting`, `search_scratchpad_notes` → `get_scratchpad_note`, or `search_calendar_events` → `get_calendar_event`. Resolve pasted URLs with `resolve_calendar_link` or `resolve_share_link` instead of guessing ids. Use `get_meeting_by_calendar_id` for the recording linked to an event; an event without a recording is not missing meeting content. `get_upcoming_meeting` is for future events. For `list_meeting_series`, \"no earlier occurrence\" can mean a one-off meeting or a recording without a linked calendar event, not a failure.\n- `search_meetings` matches titles, summaries and notes, not transcripts. Set `field` to `title`, `content` or `both`; use `query`, `since` and `until` to narrow the request. `attendee_emails` with `attendee_match` set to `any` or `all` only finds recordings linked to calendar events. A missing attendee-filter match does not prove a person never attended. Results include an excerpt and up to five attendees; retrieve the meeting for full content and attendees.\n- List and search tools page with `cursor` and `limit`, normally 25 items and at most 200. Pass the returned `next_cursor` verbatim while `has_more` is true. `list_upcoming_meetings` allows at most 50 items and `window_hours` defaults to 24 with a maximum of 168. A `truncated` result needs a narrower query, even after paging. Reduce results inside `execute_code` before returning them.\n- Notes and transcripts are character-bounded. Read the continuation marker and repeat with `view_content.start_char` or `view_transcript.start_char` set to its exact offset. Request `view_transcript: {}` when source detail matters, then continue through the required ranges. Enterprise note and transcript reads are recorded in audit logs; do not read transcripts speculatively. Summaries are complete. Transcript retention deletes transcripts and audio, not summaries; an unavailable transcript may have expired.\n- Shared-note links require your own meeting-access permissions. If a link copied from email is rejected, ask the user to open it in a browser and pass the final Wispr Flow URL. Transcripts require ownership or an explicit email invitation plus the owner's organization allowing transcript sharing. Domain, team or anyone-with-link access yields summaries only. Reauthorization cannot widen those permissions. Return the provided `share_link` when asked for a link; never fabricate one or assume the link changes who can read it.\n- Timestamps are UTC. Present them in the user's time zone. For a whole local day, supply `since` at local midnight with its UTC offset and `until` at the next local midnight; the upper bound is exclusive. Upcoming pre-reads may be absent because the desktop app generates them on demand; these reads do not generate them.\n- Both official help articles describe read-only access and list tasks or action items as readable, while Wispr's own Claude directory listing advertises \"Create, update, and search action items\" and names `add_task` and `update_task`. Discover this account's actual tools before using them. If exposed, `get_task` and `search_tasks` read, `add_task` creates a new task and is a write, and `update_task` changes existing task state and is destructive. Unknown tools without an explicit, uncontradicted read annotation fail closed.\n- Mac and Windows accounts need Notetaker and MCP access. Personal or organization HIPAA BAA coverage removes all MCP tools. Enterprise administrators can disable MCP or require an approved IP network; Scratchpad and cloud-access policies may further restrict results. An empty catalog or policy denial requires checking account access, not repeated authorization.\n- For \"Too many requests\" or repeated searches that temporarily fail without explanation, wait about one minute before retrying and avoid speculative fan-out. There is no maintained per-runtime admission default; the operator may configure `callAdmission` for this deployment.\n- An `auth_required` failure means this connector's Wispr Flow authorization is missing or expired: run `authorize_connector` for this connector id, then retry the same call unchanged. For guest calls, classification and routing, fetch `skills({ name: \"usage\" })`.\n"
-    }
-};