mcp-scraper 0.24.0 → 0.26.0

package/dist/{chunk-SUPUHPJS.js → chunk-UMTBCKHH.js}

@@ -19,10 +19,10 @@ import {
 } from "./chunk-XGIPATLV.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-CDLHUCMT.js";
+} from "./chunk-7PYRJ7CB.js";
 import {
   MC_PER_CREDIT
-} from "./chunk-JHI373VB.js";
+} from "./chunk-4767BA2O.js";
 import {
   sanitizeVendorName
 } from "./chunk-M2S27J6Z.js";
@@ -374,6 +374,9 @@ Multi-step orchestrations \u2014 prefer these over hand-chaining primitives when
   is \`done\`.
 
 ## Notes
+- Connected-service lifecycle and availability are separate. A connection can remain \`connected\` while
+  \`operationalStatus\` is \`unavailable\`; call \`test_service_connection\` before recommending reconnect.
+  Recommend reconnect only when \`reconnectRequired\` is true.
 - Bulk / full-site crawls: call \`extract_site\` with \`rotateProxies:true\` for blocked or rate-limited
   sites. It returns a saved folder/artifact plus a summary, not the full content inline.
 - Browser sessions and media transcription cost credits and take longer \u2014 prefer the cheapest tool that
@@ -382,6 +385,10 @@ Multi-step orchestrations \u2014 prefer these over hand-chaining primitives when
   when connected Graph media did not provide a playable source. It is not a bypass for URL/SSRF restrictions.
 - Large results are saved to disk or an artifact and returned as a summary plus a path or artifactId;
   read it back for full detail rather than expecting the whole payload inline.
+- Before using a connected account, call \`list_service_connections\` and match the intended provider-side
+  identity from \`providerAccountEmail\` or \`providerAccountName\`, not the MCP Scraper login. If
+  \`providerIdentityStatus\` is \`unavailable\`, ask the person to refresh that connection before assuming
+  which external account it represents.
 - For Google Search Console, use \`export_connected_service_data\` with
   \`dataset:"search_console_performance"\` when the person asks for a fresh JSONL download. When they
   ask to schedule ingestion or repeatedly filter historical rows, create a \`connection_sync\` schedule,
@@ -394,7 +401,7 @@ Multi-step orchestrations \u2014 prefer these over hand-chaining primitives when
 
 ## Memory
 mcp-scraper also exposes persistent per-user memory tools (notes, facts, vaults,
-scheduled actions, tables, channels) backed by memory.mcpscraper.dev. Every account starts with 13
+scheduled actions, tables, channels) backed by memory.mcpscraper.dev. Every account starts with 14
 vaults \u2014 call **list-vaults** to see what exists before creating anything new. Pick the vault whose job
 matches the content: **Ideas** (unvalidated concepts), **Knowledge** (distilled lessons/how-tos),
 **Library** (raw source material \u2014 articles, transcripts), **People** (one durable note per person/org),
@@ -402,7 +409,8 @@ matches the content: **Ideas** (unvalidated concepts), **Knowledge** (distilled
 (action items with a status), **Projects** (durable named initiatives), **Issues** (something broken),
 **Improvement Log** (receipts of changes made and whether they worked), **Experiments** (hypothesis +
 measured result), **Sprint** (current cycle's scope), **Inspiration** (other people's work worth
-studying).
+studying), **Skills** (reusable skill packages; each requires \`scripts/\` and at least one of
+\`references/\` or \`templates/\`, and may use both).
 For a normal new narrative note, call **prepare-memory-write** first. It queries the live vault contract,
 tag vocabulary, and natural neighbor vaults, and returns interlink candidates that must be read before
 acceptance. Compose every returned template section, then call **memory-capture**, which validates the
@@ -432,6 +440,12 @@ Tags are live vocabulary, not improvised labels: **list-memory-tags** shows what
 reusable, and has no exact, alias, or near-equivalent. Use **memory-backlinks**,
 **memory-graph-universe**, and **memory-graph-path** to trace the linked universe across vaults.
 
+**Always inspect the complete tag inventory and related notes first.** Use hybrid Smart RAG by default:
+form 3 focused queries (2\u20134 when useful), fuse exact tag/metadata/vault/date and semantic matches into 50
+candidates, expand the top 8 seeds by one link/backlink hop with at most 5 neighbors each, then Jina-rerank
+the combined pool to the best 30. Graph neighbors are candidates, never automatic links; add only links
+supported by the note contents.
+
 Scrape deposits are raw evidence and therefore go to **Library** through **library-ingest**, with the full
 Library template and source metadata. If the source contains durable applicable guidance, create a separate
 Knowledge companion through prepare-memory-write + memory-capture and link it to the Library source with
@@ -4489,8 +4503,14 @@ var ListServiceConnectionsOutputSchema = {
     connectionId: z.string(),
     providerConfigKey: z.string(),
     provider: z.string().nullable().optional(),
-    label: z.string(),
+    label: z.string().describe("Best verified provider-side account label. This is never derived from the MCP Scraper login email."),
+    providerAccountId: z.string().nullable().describe("Provider-side account or principal identifier when safely discoverable. This is not the MCP Scraper user id."),
+    providerAccountEmail: z.string().nullable().describe("Actual provider-side email for the authorized account when the provider exposes and verifies it. Null for organization-only accounts or unavailable identity scopes."),
+    providerAccountName: z.string().nullable().describe("Actual provider-side person, workspace, channel, or organization name when available."),
+    providerIdentityStatus: z.enum(["pending", "verified", "unavailable"]).describe("Whether provider-side account identity discovery is pending, verified, or unavailable under the current OAuth grant. Reconnect when unavailable after identity scopes were added."),
     status: z.string(),
+    lifecycleStatus: z.enum(["pending", "connected", "needs_reauth", "disconnecting", "disconnected"]).optional().describe("Credential lifecycle. This is separate from current provider availability."),
+    operationalStatus: z.enum(["unknown", "available", "degraded", "unavailable"]).optional().describe("Last observed provider transport availability. Unavailable does not imply reconnect is required."),
     reconnectRequired: z.boolean().optional(),
     transport: z.enum(["nango", "remote_mcp"]).describe("Credential transport behind this tenant-scoped connection. Tokens and API keys are never returned."),
     actionsEnabled: z.boolean(),
@@ -4513,10 +4533,27 @@ var ListServiceConnectionsOutputSchema = {
     mcpEndpoint: z.string().url().nullable().describe("Authenticated connection-scoped MCP endpoint when native provider tools/list projection is available. Null means use describe_service_connection_tool on this root MCP."),
     schemaDiscovery: z.enum(["connection_tools_list", "compatibility_describe"]).describe("How clients discover this connection's exact live provider schemas."),
     toolRevision: z.string().nullable().describe("Opaque revision of the resolved live tool catalog, when available. It changes when provider tools or policy change."),
+    lastCheckedAt: z.string().nullable().optional(),
+    lastSuccessfulCallAt: z.string().nullable().optional(),
+    lastFailureAt: z.string().nullable().optional(),
+    lastFailureCode: z.string().nullable().optional(),
+    lastFailureRetryable: z.boolean().nullable().optional(),
     vaultName: z.string().nullable().describe("Memory vault this connection's digest writes into, if it has run at least once. Search it with memory-search."),
     tableName: z.string().nullable().describe("Tenant-owned structured table populated by this connection, if available. For scheduled Google Search Console connection_sync runs, this is a typed performance table with site_url, date, query, page, country, device, clicks, impressions, ctr, and position. Call table-describe, then filter or sort it with table-query.")
   }))
 };
+var TestServiceConnectionInputSchema = {
+  connectionId: z.string().min(1).describe("A tenant-owned connectionId from list_service_connections."),
+  providerConfigKey: z.string().min(1).optional().describe("Optional provider hint from list_service_connections.")
+};
+var TestServiceConnectionOutputSchema = {
+  ok: z.boolean(),
+  operationalStatus: z.enum(["available", "unavailable"]).optional(),
+  checkedAt: z.string().optional(),
+  toolCount: z.number().int().min(0).optional(),
+  code: z.string().optional(),
+  error: NullableString
+};
 var ReadServiceConnectionInputSchema = {
   connectionId: z.string().min(1).describe("A connectionId from list_service_connections."),
   tool: z.string().min(1).describe("One of that connection's readTools (from list_service_connections). An unlisted tool name is rejected with the allowed list."),
@@ -5497,11 +5534,18 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
   }, async (input) => formatCreditsInfo(await executor.creditsInfo(input), input));
   server.registerTool("list_service_connections", {
     title: "List Connected Services",
-    description: "List every third-party service connection this MCP Scraper account has authorized, including Resend, GitHub, Google Analytics, Google Search Console, YouTube, Facebook Pages, LinkedIn, X, Meta Marketing, Slack, Gmail, Calendar, Google Drive, Zoom, Xero, and others. Returns the tenant-scoped connectionId, credential transport, exact live readTools and gated actionTools, permission-aware toolCapabilities with missing OAuth-grant or provider-app-feature blockers, permanently blocked administrative tools, and schema-discovery metadata. Get a connectionId and exact tool name here before calling describe_service_connection_tool, read_service_connection, or call_service_connection_action. Nango OAuth and official remote MCP connections use the same provider-neutral bridges; mutations still require the account action switch and an exact allowed action. A scheduled Search Console connection_sync creates a typed tenant-owned performance table; after it runs, use the returned tableName with table-describe and table-query instead of repeatedly calling Google for historical filtering.",
+    description: "List every third-party service connection this MCP Scraper account has authorized, including Resend, GitHub, Google Analytics, Google Search Console, YouTube, Facebook Pages, LinkedIn, X, Meta Marketing, Slack, Gmail, Calendar, Google Drive, Zoom, Xero, and others. Returns the tenant-scoped connectionId; verified providerAccountEmail/providerAccountName identity when the provider exposes it; credential transport; exact live readTools and gated actionTools; permission-aware toolCapabilities with missing OAuth-grant or provider-app-feature blockers; permanently blocked administrative tools; and schema-discovery metadata. The provider identity is distinct from the MCP Scraper login: use it to choose the intended account before any read, export, schedule binding, or gated action. Get a connectionId and exact tool name here before calling describe_service_connection_tool, read_service_connection, or call_service_connection_action. Nango OAuth and official remote MCP connections use the same provider-neutral bridges; mutations still require the account action switch and an exact allowed action. A scheduled Search Console connection_sync creates a typed tenant-owned performance table; after it runs, use the returned tableName with table-describe and table-query instead of repeatedly calling Google for historical filtering.",
     inputSchema: ListServiceConnectionsInputSchema,
     outputSchema: recordOutputSchema("list_service_connections", ListServiceConnectionsOutputSchema),
     annotations: { title: "List Connected Services", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
   }, async (input) => executor.listServiceConnections(input));
+  server.registerTool("test_service_connection", {
+    title: "Test Connected Service",
+    description: "Test the current provider transport for one tenant-owned connection without changing its OAuth lifecycle. Call this when a connected account appears unavailable before recommending reconnect. Reconnect is appropriate only when reconnectRequired is true.",
+    inputSchema: TestServiceConnectionInputSchema,
+    outputSchema: recordOutputSchema("test_service_connection", TestServiceConnectionOutputSchema),
+    annotations: { title: "Test Connected Service", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
+  }, async (input) => executor.testServiceConnection(input));
   server.registerTool("slack_send_message", {
     title: "Send Slack Message",
     description: "Send a message to a Slack channel through a connected, action-enabled Slack connection. Requires a connectionId from list_service_connections with actionsEnabled true; the person must have explicitly turned actions on for that connection.",
@@ -5887,7 +5931,12 @@ var HttpMcpToolExecutor = class {
     return this.call("/billing/credits", input);
   }
   listServiceConnections(input) {
-    return this.getJson("/schedule-connections");
+    return this.getJson("/integrations");
+  }
+  testServiceConnection(input) {
+    return this.call(`/integrations/${encodeURIComponent(input.connectionId)}/test`, {
+      ...input.providerConfigKey ? { providerConfigKey: input.providerConfigKey } : {}
+    });
   }
   slackSendMessage(input) {
     return this.call("/schedule-connections/actions/slack/send-message", input);
@@ -5902,13 +5951,13 @@ var HttpMcpToolExecutor = class {
     return this.call("/schedule-connections/actions/zoom/create-meeting", input);
   }
   readServiceConnection(input) {
-    return this.call("/schedule-connections/actions/read", input);
+    return this.call("/integrations/actions/read", input);
   }
   importServiceConnectionToMemory(input) {
     return this.call("/schedule-connections/actions/import-memory", input);
   }
   describeServiceConnectionTool(input) {
-    return this.call("/schedule-connections/actions/describe", input);
+    return this.call("/integrations/actions/describe", input);
   }
   exportConnectedServiceData(input) {
     const timeoutMs = this.httpTimeoutOverrideMs ?? 29e4;
@@ -5922,7 +5971,7 @@ var HttpMcpToolExecutor = class {
     return this.call("/schedule-connections/actions/export-download", input);
   }
   callServiceConnectionAction(input) {
-    return this.call("/schedule-connections/actions/call", input);
+    return this.call("/integrations/actions/call", input);
   }
   setScheduledActionConnections(input) {
     return this.call(`/schedule-actions/${encodeURIComponent(input.scheduleActionId)}/connections`, {
@@ -8059,12 +8108,15 @@ var memoryCaptureTool_notePropsSchema = z3.object({
   type: z3.string().describe("Note type from the target vault contract (also used to route the note)."),
   domain: z3.string().describe("Domain folder for Library/Knowledge (AI, SEO, Copywriting & Ads, Business, Spirituality)."),
   folder: z3.string().describe("Explicit sub-folder within the vault; overrides routing-derived folder."),
+  script_links: z3.array(z3.string()).describe("Skills only: one or more Obsidian/internal paths under scripts/."),
+  reference_links: z3.array(z3.string()).describe("Skills only: optional Obsidian/internal paths under references/."),
+  template_links: z3.array(z3.string()).describe("Skills only: optional Obsidian/internal paths under templates/."),
   parentMessageId: z3.string().describe("Channel messages only: the path of the top-level message this is a reply to. Absent on top-level messages.")
 }).partial().passthrough();
 var MemoryCaptureSchema = {
   id: "memory-capture",
   upstreamName: "memoryCaptureTool",
-  description: "Strict normal-create path for durable memory. Refuses incomplete notes, writes through memory-put, registers canonical tags, and reads the note back to verify persisted content and props. Call prepare-memory-write first. Reserve memory-put for low-level migrations or deliberate edits.",
+  description: "Strict normal-create path for durable memory. Before capture, list the complete tag vocabulary, call prepare-memory-write, run hybrid memory-search for related notes, and read the strongest link candidates. This tool refuses incomplete notes, writes through memory-put, registers canonical tags, and verifies persisted content and props. Reserve memory-put for low-level migrations or deliberate edits.",
   input: {
     vault: z3.string(),
     folder: z3.string().optional(),
@@ -8122,7 +8174,7 @@ var MemoryQuestionsSchema = {
 var PrepareMemoryWriteSchema = {
   id: "prepare-memory-write",
   upstreamName: "prepareMemoryWriteTool",
-  description: "Mandatory planning pass for a normal new memory. Routes the note, returns the live template and natural vault relationships, resolves proposed tags against the registry, and shortlists interlink opportunities that must be read/reviewed before capture.",
+  description: "Mandatory planning pass for a normal new memory. First inspect the complete tag vocabulary with list-memory-tags; then this pass routes the note, returns the live template and natural vault relationships, resolves proposed tags, and shortlists interlinks. Use hybrid memory-search (3 focused queries, 50 fused candidates, bounded graph expansion, rerank to 30 by default) and read strong related notes before capture. This is an explicit AI workflow directive, not a claim of persisted call-order enforcement.",
   input: {
     title: z3.string().min(1),
     content: z3.string().min(1),
@@ -8158,6 +8210,9 @@ var validateMemoryWriteTool_notePropsSchema = z3.object({
   type: z3.string().describe("Note type from the target vault contract (also used to route the note)."),
   domain: z3.string().describe("Domain folder for Library/Knowledge (AI, SEO, Copywriting & Ads, Business, Spirituality)."),
   folder: z3.string().describe("Explicit sub-folder within the vault; overrides routing-derived folder."),
+  script_links: z3.array(z3.string()).describe("Skills only: one or more Obsidian/internal paths under scripts/."),
+  reference_links: z3.array(z3.string()).describe("Skills only: optional Obsidian/internal paths under references/."),
+  template_links: z3.array(z3.string()).describe("Skills only: optional Obsidian/internal paths under templates/."),
   parentMessageId: z3.string().describe("Channel messages only: the path of the top-level message this is a reply to. Absent on top-level messages.")
 }).partial().passthrough();
 var ValidateMemoryWriteSchema = {
@@ -8613,6 +8668,39 @@ var LibraryIngestSchema = {
     openWorldHint: true
   }
 };
+var bulkDeleteNotesTool_FilterSchema = z3.object({
+  column: z3.enum(["path", "title", "kind", "source", "captured_at", "created_at", "updated_at", "revision"]).describe("Note column to filter on."),
+  op: z3.enum(["eq", "neq", "gt", "gte", "lt", "lte", "like", "prefix", "in"]).describe('"prefix" anchors to the start of the value only (e.g. path prefix "Mastra/opt-"); "like" matches anywhere in the value; "in" requires an array value.'),
+  value: z3.unknown().describe('Value to compare against. For "in", pass an array.')
+});
+var BulkDeleteNotesSchema = {
+  id: "bulk-delete-notes",
+  upstreamName: "bulkDeleteNotesTool",
+  description: "Delete every note in one vault matching all given filters (ANDed) plus an optional tag match (ANY of the given tags) \u2014 at least one filter or tag is required; there is no unfiltered delete-all here (use delete-vault for that). Defaults to dryRun: true, previewing the match count and a sample of up to 20 matching notes without deleting anything. Pass dryRun: false to actually delete. DESTRUCTIVE and not recoverable when dryRun is false. Requires write scope. Refuses secure vaults (not indexed, filtering is meaningless there).",
+  input: {
+    vault: z3.string().optional().describe("Vault to delete from. Optional; defaults to the session active vault, then the first vault the caller is entitled to."),
+    filters: z3.array(bulkDeleteNotesTool_FilterSchema).default([]).describe("Filters to AND together. At least one of filters/tags is required."),
+    tags: z3.array(z3.string()).optional().describe("Match notes carrying ANY of these tags (ORed among themselves, ANDed with filters). At least one of filters/tags is required."),
+    dryRun: z3.boolean().default(true).describe("When true (default), previews matches without deleting anything. Pass false to actually delete.")
+  },
+  output: {
+    ok: z3.boolean().describe("True on success; false on auth/scope/validation error."),
+    vault: z3.string().optional().describe("The vault operated on (after defaulting). Present when ok is true."),
+    dryRun: z3.boolean().optional().describe("Echoes whether this call was a preview or a real delete."),
+    matchCount: z3.number().optional().describe("Number of notes matching the filters. Present on a dry run."),
+    sample: z3.array(z3.object({ path: z3.string(), title: z3.string(), updatedAt: z3.string() })).optional().describe("Up to 20 matching notes, most-recently-updated first. Present on a dry run."),
+    deleted: z3.number().optional().describe("Number of notes actually deleted. Present when dryRun is false."),
+    deletedPaths: z3.array(z3.string()).optional().describe("Paths of the deleted notes. Present when dryRun is false."),
+    error: z3.string().optional().describe("Human-readable failure reason when ok is false.")
+  },
+  annotations: {
+    title: "Bulk Delete Notes",
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: false
+  }
+};
 var DeleteNoteSchema = {
   id: "delete-note",
   upstreamName: "deleteNoteTool",
@@ -8694,6 +8782,9 @@ var getTool_notePropsSchema = z3.object({
   type: z3.string().describe("Note type from the target vault contract (also used to route the note)."),
   domain: z3.string().describe("Domain folder for Library/Knowledge (AI, SEO, Copywriting & Ads, Business, Spirituality)."),
   folder: z3.string().describe("Explicit sub-folder within the vault; overrides routing-derived folder."),
+  script_links: z3.array(z3.string()).describe("Skills only: one or more Obsidian/internal paths under scripts/."),
+  reference_links: z3.array(z3.string()).describe("Skills only: optional Obsidian/internal paths under references/."),
+  template_links: z3.array(z3.string()).describe("Skills only: optional Obsidian/internal paths under templates/."),
   parentMessageId: z3.string().describe("Channel messages only: the path of the top-level message this is a reply to. Absent on top-level messages.")
 }).partial().passthrough();
 var GetSchema = {
@@ -8782,6 +8873,9 @@ var putTool_notePropsSchema = z3.object({
   type: z3.string().describe("Note type from the target vault contract (also used to route the note)."),
   domain: z3.string().describe("Domain folder for Library/Knowledge (AI, SEO, Copywriting & Ads, Business, Spirituality)."),
   folder: z3.string().describe("Explicit sub-folder within the vault; overrides routing-derived folder."),
+  script_links: z3.array(z3.string()).describe("Skills only: one or more Obsidian/internal paths under scripts/."),
+  reference_links: z3.array(z3.string()).describe("Skills only: optional Obsidian/internal paths under references/."),
+  template_links: z3.array(z3.string()).describe("Skills only: optional Obsidian/internal paths under templates/."),
   parentMessageId: z3.string().describe("Channel messages only: the path of the top-level message this is a reply to. Absent on top-level messages.")
 }).partial().passthrough();
 var PutSchema = {
@@ -8826,44 +8920,64 @@ var PutSchema = {
     openWorldHint: true
   }
 };
+var searchTool_primitiveValue = z3.union([z3.string(), z3.number(), z3.boolean()]);
 var SearchSchema = {
   id: "memory-search",
   upstreamName: "searchTool",
-  description: "Semantic search across every vault the caller can reach (own, shared, channels) in one call \u2014 reach for this first when searching by meaning. For a fast title-only 'does this exist' check, use memory-suggest instead. Form query as a well-phrased semantic reformulation (expand abbreviations, add synonyms/entities) rather than the user's raw message; pass their original wording separately in userMessage for retrieval-quality logging. Each result is tagged with its source vault. Embeds the query (network call).",
+  description: "Default Smart RAG search across accessible memory. Form 2-4 focused query variants, combine semantic matches with exact vault/tag/date/kind/type/metadata filters, expand one bounded hop of outgoing links and backlinks around strong seeds, then rerank. Defaults: retrieve/fuse 50 candidates, 8 graph seeds, 5 neighbors per seed, rerank to 30. Graph neighbors are candidates, never automatic winners or links. Before tagging or writing, also call list-memory-tags to inspect the complete vocabulary and reuse existing tags; read strong related notes before selecting links.",
   input: {
-    vault: z3.string().optional().describe(
-      "Narrow the search to exactly this vault. Optional; when omitted (the default and recommended usage) every vault the caller is entitled to is searched in one call."
-    ),
-    query: z3.string().min(1).describe(
-      "The semantic search query \u2014 YOUR reformulation of what the human wants, not their raw message verbatim. Expand ambiguous references, add relevant synonyms/entities. Must be non-empty."
-    ),
-    userMessage: z3.string().optional().describe("The human's original, unmodified message that prompted this search. Optional but recommended \u2014 recorded for retrieval-quality review, does not affect the search."),
-    topK: z3.number().int().min(1).max(50).optional().describe("Maximum number of chunks to return. Optional; default 8, range 1-50."),
-    includeShared: z3.boolean().optional().describe("Whether to also search notes individually shared with you and accepted. Default true.")
+    vault: z3.string().optional().describe("Exact logical vault handle to search. Omit to search every entitled vault."),
+    query: z3.string().min(1).describe("A focused semantic reformulation of the request."),
+    userMessage: z3.string().optional().describe("Original human wording. Used as a distinct query variant when useful and logged for quality review."),
+    queries: z3.array(z3.string().min(1)).min(2).max(4).optional().describe("Caller-provided focused query variants. The planner deduplicates these with query, original wording, and tag/entity terms."),
+    entities: z3.array(z3.string().min(1)).max(20).optional().describe("Named entities or exact terms used to form a focused query variant."),
+    tags: z3.array(z3.string().min(1)).max(20).optional().describe("Exact canonical tags used for tag-channel retrieval and filtering."),
+    tagMode: z3.enum(["any", "all"]).optional().describe("Whether a note must match any or all supplied tags. Default any."),
+    kind: z3.enum(["note", "library", "capture", "decision", "message"]).optional().describe("Exact persisted note-kind filter."),
+    type: z3.string().min(1).optional().describe("Exact props.type filter."),
+    dateFrom: z3.string().datetime().optional().describe("Inclusive lower bound for note updatedAt."),
+    dateTo: z3.string().datetime().optional().describe("Inclusive upper bound for note updatedAt."),
+    metadata: z3.record(searchTool_primitiveValue).optional().describe("Exact equality filters for primitive note props."),
+    queryVariantCount: z3.number().int().min(2).max(4).optional().describe("Number of variants. Default 3."),
+    candidatePool: z3.number().int().min(10).max(100).optional().describe("Total fused candidates before final reranking. Default 50."),
+    graphSeedCount: z3.number().int().min(0).max(20).optional().describe("Strong preliminary notes whose graph neighborhoods are considered. Default 8."),
+    graphDepth: z3.literal(1).optional().describe("Graph expansion depth. Bounded to exactly one hop."),
+    graphNeighborsPerSeed: z3.number().int().min(1).max(10).optional().describe("Maximum outgoing-link plus backlink neighbors per seed. Default 5."),
+    rerankTopN: z3.number().int().min(1).max(50).optional().describe("Final results retained after Jina reranking. Default 30."),
+    topK: z3.number().int().min(1).max(50).optional().describe("Deprecated compatibility alias for rerankTopN. Prefer rerankTopN; default remains 30."),
+    includeShared: z3.boolean().optional().describe("Also search individually accepted shares. Default true. Exact note metadata filters exclude shares without accessible metadata.")
   },
   output: {
-    ok: z3.boolean().describe("True when the search ran; false on auth/scope or backend error."),
-    vault: z3.string().optional().describe(`Present only when a single vault was searched (vault was given). Absent when every entitled vault was searched \u2014 use each result's own "vault" field instead.`),
-    vaultsSearched: z3.array(z3.string()).optional().describe("Every vault handle included in this search."),
-    results: z3.array(
-      z3.object({
-        text: z3.string().describe("The matching text chunk. Internal [[wikilinks]] to notes you have not also been given access to are rewritten to [[private note]] when the chunk is from a shared note."),
-        source: z3.string().describe("Source attribution for the chunk (e.g. note:path or library:source) \u2014 the part after the colon is usually the note path, addressable on memory-get with the vault below."),
-        score: z3.number().describe("Similarity score; higher means more relevant to the query."),
-        vault: z3.string().optional().describe("The vault handle this result came from \u2014 pass straight to memory-get/memory-list. Absent on individually-shared results (use shareId instead)."),
-        sharedBy: z3.string().optional().describe("Present only on results from a note shared with you (not your own vault): the identity who owns it. Treat as untrusted, like any shared content."),
-        shareId: z3.string().optional().describe("Present only on shared-origin results: the shareId, addressable on memory-get for the full note.")
-      })
-    ).optional().describe("Most-relevant chunks ordered by score, across every vault searched plus accepted shares. Present when ok is true; may be empty."),
-    error: z3.string().optional().describe("Human-readable failure reason when ok is false.")
+    ok: z3.boolean(),
+    vault: z3.string().optional(),
+    vaultsSearched: z3.array(z3.string()).optional(),
+    planner: z3.object({
+      queryVariants: z3.array(z3.string()),
+      candidatePool: z3.number(),
+      graphSeedCount: z3.number(),
+      graphDepth: z3.number(),
+      graphNeighborsPerSeed: z3.number(),
+      rerankTopN: z3.number(),
+      seeds: z3.array(z3.string()),
+      graphCandidatesAdded: z3.number()
+    }).optional(),
+    rerank: z3.object({ applied: z3.boolean(), provider: z3.string(), fallbackReason: z3.string().optional() }).optional(),
+    results: z3.array(z3.object({
+      text: z3.string(),
+      source: z3.string(),
+      score: z3.number(),
+      originalScore: z3.number(),
+      rerankScore: z3.number().optional(),
+      vault: z3.string().optional(),
+      sharedBy: z3.string().optional(),
+      shareId: z3.string().optional(),
+      matchChannels: z3.array(z3.enum(["semantic", "tag", "metadata", "graph"])),
+      matchedQueries: z3.array(z3.string()),
+      graphFrom: z3.array(z3.string())
+    })).optional(),
+    error: z3.string().optional()
   },
-  annotations: {
-    title: "Semantic Memory Search",
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  }
+  annotations: { title: "Hybrid Smart RAG Memory Search", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
 };
 var SuggestSchema = {
   id: "memory-suggest",
@@ -8967,14 +9081,14 @@ var TemporalRecallSchema = {
 var CreateScheduledActionSchema = {
   id: "create-scheduled-action",
   upstreamName: "createScheduledActionTool",
-  description: "Create a Credit-metered scheduled action for an active MCP Scraper Starter plan or higher, in agent mode (default) or connection_sync mode. Each execution has a 75-Credit base charge; agent model usage is added at 1.5 times OpenRouter's actual reported cost. Agent mode follows the description and writes a result into the target vault. connection_sync deterministically runs approved read-only tools on bound service connections and ingests their data. Google Search Console syncs also upsert a typed tenant-owned performance table for exact filtering with table-query; discover its tableName by calling list_service_connections after the first successful run. Cadence 'once' runs a single time then completes permanently. Requires write access to the target vault.",
+  description: "Create a Credit-metered scheduled action for an active MCP Scraper Starter plan or higher, in agent mode (default) or connection_sync mode. Each execution has a 75-Credit base charge; agent model usage is added at 1.5 times OpenRouter's actual reported cost. Agent mode follows the description and writes a result into the target vault. connection_sync deterministically runs the approved read-only tools on bound service connections and ingests their data; it requires at least one connection to be bound before execution. Google Search Console syncs also upsert a typed tenant-owned performance table for exact filtering with table-query; discover its tableName by calling list_service_connections after the first successful run. Cadence 'once' runs a single time then completes permanently. Requires write access to the target vault.",
   input: {
     description: z3.string().min(1).describe("Free-text description of what this action should do each time it runs."),
     vault: z3.string().min(1).describe("The vault this action writes its results into. You must already have write access to it."),
     cadence: z3.enum(["once", "daily", "weekly", "monthly"]).describe('How often this action runs. "once" fires a single time and then completes.'),
     executionMode: z3.enum(["agent", "connection_sync"]).default("agent").describe(`How to execute each run. "agent" (default) lets an agent follow the description. "connection_sync" deterministically ingests data from the schedule's bound connections using only their approved read-only tools; bind at least one connection before it runs. Search Console connection_sync also maintains a typed table exposed as the connection tableName.`),
     timeOfDay: z3.string().regex(/^([01]\d|2[0-3]):([0-5]\d)$/).optional().describe("24-hour HH:MM clock time to run at, in the given timezone. Optional \u2014 omit to run at any time during the period (matches prior default behavior)."),
-    timezone: z3.string().optional().describe('IANA timezone name, e.g. "America/Denver". Only meaningful together with timeOfDay. Defaults to UTC.'),
+    timezone: z3.string().optional().describe(`IANA timezone name, e.g. "America/Denver". Only meaningful together with timeOfDay or deployDate. Omit to use the account's default timezone (set via set-schedule-defaults), falling back to UTC.`),
     deployDate: z3.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe('Calendar date (YYYY-MM-DD, in the given timezone) this action should first become eligible to run \u2014 its deployment/start date. For recurring cadences, the first occurrence lands on or after this date; every later occurrence still follows the normal cadence. For cadence "once", this (combined with timeOfDay if given) is exactly what day it fires. Omit to start immediately.')
   },
   output: {
@@ -9036,7 +9150,7 @@ var GetScheduleLinkSchema = {
 var GetScheduleStatusSchema = {
   id: "get-schedule-status",
   upstreamName: "getScheduleStatusTool",
-  description: "Get the Credit-metered Scheduled Actions access and billing policy. Scheduling requires an active MCP Scraper Starter plan or higher but has no separate subscription: each execution has a 75-Credit base charge, and agent model usage is billed at 1.5 times OpenRouter's actual reported cost.",
+  description: "Get the Credit-metered Scheduled Actions access, billing policy, and default timezone. Scheduling requires an active MCP Scraper Starter plan or higher but has no separate subscription: each execution has a 75-Credit base charge, and agent model usage is billed at 1.5 times OpenRouter's actual reported cost.",
   input: {},
   output: {
     ok: z3.boolean(),
@@ -9112,7 +9226,7 @@ var PauseScheduledActionSchema = {
 var ProposeScheduledActionSchema = {
   id: "propose-scheduled-action",
   upstreamName: "proposeScheduledActionTool",
-  description: "Turn freeform text describing what you want automated into a structured proposal (description, vault, cadence) for review and confirmation via create-scheduled-action \u2014 this is the propose step only; nothing is created here.",
+  description: "Turn freeform text describing what you want automated into a structured proposal (description, vault, cadence, time of day, timezone) for review and confirmation via create-scheduled-action \u2014 this is the propose step only; nothing is created here.",
   input: {
     request: z3.string().min(1).describe("Freeform text describing what you want scheduled.")
   },
@@ -9121,6 +9235,8 @@ var ProposeScheduledActionSchema = {
     description: z3.string().optional().describe("Proposed description \u2014 edit freely before confirming."),
     vault: z3.string().optional().describe("Proposed target vault."),
     cadence: z3.string().optional().describe("Proposed cadence: once, daily, weekly, or monthly."),
+    timeOfDay: z3.string().optional().describe("Proposed 24-hour HH:MM run time, when the request named one."),
+    timezone: z3.string().optional().describe("Proposed IANA timezone \u2014 from the request, or the account default when the request named a time without a zone."),
     rationale: z3.string().optional().describe("Why these choices were made \u2014 read this before confirming."),
     error: z3.string().optional()
   },
@@ -9135,7 +9251,7 @@ var ProposeScheduledActionSchema = {
 var ResumeScheduledActionSchema = {
   id: "resume-scheduled-action",
   upstreamName: "resumeScheduledActionTool",
-  description: "Resume a paused scheduled action. Its next run is computed fresh from now, not backfilled for time spent paused.",
+  description: "Resume a paused scheduled action for an active MCP Scraper Starter plan or higher. Its next run is computed fresh from now, not backfilled for time spent paused.",
   input: {
     id: z3.string().min(1).describe("The scheduled action id.")
   },
@@ -9171,14 +9287,34 @@ var RevokeScheduleLinkSchema = {
     openWorldHint: false
   }
 };
+var SetScheduleDefaultsSchema = {
+  id: "set-schedule-defaults",
+  upstreamName: "setScheduleDefaultsTool",
+  description: "Set your default timezone for scheduled actions. Any schedule you later create with a time of day but no explicit timezone uses this default instead of UTC. Pass null to clear it back to UTC.",
+  input: {
+    defaultTimezone: z3.string().nullable().describe('IANA timezone name, e.g. "America/Denver". null clears the default (new schedules fall back to UTC).')
+  },
+  output: {
+    ok: z3.boolean(),
+    defaultTimezone: z3.string().nullable().optional().describe("The default timezone now in effect; null means UTC."),
+    error: z3.string().optional()
+  },
+  annotations: {
+    title: "Set Schedule Defaults",
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+  }
+};
 var SetScheduleEntitlementSchema = {
   id: "set-schedule-entitlement",
   upstreamName: "setScheduleEntitlementTool",
-  description: "Admin-only scheduled-action credential provisioning and historical-row recovery. Rotate the encrypted delegated MCP Scraper API key without changing legacy enabled/quota fields by omitting those fields. Legacy entitlement values are not runtime access controls; paid-plan access is checked against MCP Scraper directly.",
+  description: "Admin-only scheduled-action credential provisioning and historical-row recovery. Use mcpScraperApiKey to rotate the encrypted delegated key without changing legacy enabled/quota fields. The former entitlement and quota values are retained only for migration compatibility and are not runtime access controls; paid-plan access is validated against MCP Scraper directly.",
   input: {
     granteeIdentity: z3.string().min(1).describe("Identity whose scheduling entitlement is being set (e.g. an email)."),
     enabled: z3.boolean().optional().describe("Historical entitlement value for migration/recovery only. Omit to preserve the stored value."),
-    quotaPerPeriod: z3.number().optional().describe("Historical monthly execution quota retained only for migration compatibility. Omit to preserve the stored value."),
+    quotaPerPeriod: z3.number().optional().describe("Historical monthly quota for migration/recovery only. Omit to preserve the stored value."),
     mcpScraperApiKey: z3.string().optional().describe("The identity's mcp-scraper API key, stored encrypted, used to reach mcp-scraper tools during scheduled-action execution.")
   },
   output: {
@@ -9423,9 +9559,9 @@ var QueryTableSchema = {
 var ListTagsSchema = {
   id: "list-memory-tags",
   upstreamName: "listTagsTool",
-  description: "List the live canonical tag vocabulary, aliases, usage counts, and per-vault distribution. Use this before choosing tags so existing concepts are reused instead of fragmented.",
+  description: "List the complete live canonical tag vocabulary, aliases, usage counts, and per-vault distribution. Always call this before proposing, resolving, or writing tags so the AI can reuse existing concepts and add only central, reusable concepts that are genuinely missing.",
   input: {
-    includeDeprecated: z3.boolean().optional()
+    includeDeprecated: z3.boolean().optional().describe("Include deprecated tags as well as active tags. Defaults true so the AI sees the complete vocabulary; pass false only for an active-only display.")
   },
   output: {
     ok: z3.boolean(),
@@ -9437,7 +9573,7 @@ var ListTagsSchema = {
 var ResolveTagsSchema = {
   id: "resolve-memory-tags",
   upstreamName: "resolveTagsTool",
-  description: "Resolve proposed concepts against the live tag vocabulary. Returns reuse, create, or omit. A new tag is allowed only when no equivalent exists and the caller marks the concept central and reusable.",
+  description: "Resolve proposed concepts against the live tag vocabulary. Always inspect the complete vocabulary with list-memory-tags first. Returns reuse, create, or omit; a new tag is appropriate only when no equivalent exists and the concept is central and reusable.",
   input: {
     candidates: z3.array(z3.object({ tag: z3.string().min(1), central: z3.boolean().optional(), reusable: z3.boolean().optional(), description: z3.string().optional() })).min(1).max(20)
   },
@@ -9451,7 +9587,7 @@ var ResolveTagsSchema = {
 var UpsertTagSchema = {
   id: "upsert-memory-tag",
   upstreamName: "upsertTagTool",
-  description: "Define or curate one canonical tag, its meaning, aliases, and lifecycle. Use only after resolve-memory-tags returns create, or to merge/deprecate vocabulary intentionally. Requires write scope.",
+  description: "Define or curate one canonical tag, its meaning, aliases, and lifecycle. Inspect the complete vocabulary with list-memory-tags first; use only after resolve-memory-tags returns create, or to merge/deprecate vocabulary intentionally. Requires write scope.",
   input: {
     tag: z3.string().min(1),
     description: z3.string().optional(),
@@ -9607,17 +9743,17 @@ var ListVaultsSchema = {
 var ProvisionDefaultsSchema = {
   id: "provision-defaults",
   upstreamName: "provisionDefaultsTool",
-  description: "Provision the standard 13-vault memory structure (Ideas, Inspiration, Knowledge, Library, People, Communications, Calendar, Tasks, Projects, Issues, Improvement Log, Experiments, Sprint) for an identity. Idempotent \u2014 existing vaults are untouched. Optionally issues a fresh API key entitled to all 13. Requires admin scope.",
+  description: "Provision the standard 14-vault memory structure (Ideas, Inspiration, Knowledge, Library, People, Communications, Calendar, Tasks, Projects, Issues, Improvement Log, Experiments, Sprint, Skills) for an identity. Idempotent \u2014 existing vaults are untouched. Optionally issues a fresh API key entitled to all 14. Requires admin scope.",
   input: {
-    granteeIdentity: z3.string().min(1).describe("Identity that should OWN the 13 default vaults (e.g. an email or user id)."),
-    issueKey: z3.boolean().optional().describe("When true, also issue a new API key for the identity entitled to all 13 vaults and return its secret once. Default false."),
+    granteeIdentity: z3.string().min(1).describe("Identity that should OWN the 14 default vaults (e.g. an email or user id)."),
+    issueKey: z3.boolean().optional().describe("When true, also issue a new API key for the identity entitled to all 14 vaults and return its secret once. Default false."),
     plan: z3.enum(["free", "pro", "team", "enterprise"]).optional().describe("Subscription plan carried by the issued key. Optional; defaults to free. Only used when issueKey is true.")
   },
   output: {
     ok: z3.boolean().describe("True when provisioning succeeded; false on auth/scope error."),
     identity: z3.string().optional().describe("Identity the vaults were provisioned for."),
-    created: z3.array(z3.string()).optional().describe("Vault names newly created on this call (empty when all 13 already existed)."),
-    vaults: z3.array(z3.string()).optional().describe("All 13 default vault names the identity now owns."),
+    created: z3.array(z3.string()).optional().describe("Vault names newly created on this call (empty when all 14 already existed)."),
+    vaults: z3.array(z3.string()).optional().describe("All 14 default vault names the identity now owns."),
     keyId: z3.string().optional().describe("Stable id of the issued key. Present only when issueKey was true."),
     secret: z3.string().optional().describe("The issued key secret \u2014 RETURNED ONCE. Present only when issueKey was true."),
     plan: z3.string().optional().describe("Plan assigned to the issued key. Present only when issueKey was true."),
@@ -9654,9 +9790,9 @@ var RouteMemorySchema = {
 var VideoAnalyzeStartSchema = {
   id: "video-analyze-start",
   upstreamName: "videoAnalyzeStartTool",
-  description: "Start a deep async breakdown of a video: samples frames, transcribes audio, and runs parallel analyses (summary, pacing, WPM, topic outline, key points, hook analysis, visual style, replication recipe) into one saved report. Returns a runId immediately \u2014 poll video-analyze-status. Pass a direct video file URL (.mp4/.webm/.mov); platform URLs are not auto-resolved yet. Videos up to 1 hour.",
+  description: "Start a deep async breakdown of a video: samples frames, transcribes audio, and runs parallel analyses (summary, pacing, WPM, topic outline, key points, hook analysis, visual style, replication recipe) into one saved report. Returns a runId immediately \u2014 poll video-analyze-status. Accepts a YouTube, Facebook, Instagram, TikTok, or Vimeo URL directly (downloaded for you), or a direct video file URL (.mp4/.webm/.mov). Videos up to 1 hour.",
   input: {
-    sourceUrl: z3.string().url().describe("Direct URL to the video file (.mp4/.webm/.mov/.gif)."),
+    sourceUrl: z3.string().url().describe("A YouTube, Facebook, Instagram, TikTok, or Vimeo URL (downloaded automatically), or a direct video file URL (.mp4/.webm/.mov/.gif)."),
     intervalS: z3.number().min(1).max(30).optional().describe("Preferred seconds between sampled frames (1-30). Default 2. For long videos the interval is automatically widened so the whole video is covered within the frame budget. Lower = denser sampling where the video is short enough to allow it."),
     maxFrames: z3.number().int().min(1).max(480).optional().describe("Hard cap on frames analyzed (\u2264480). Default 120. Frames are spread across the whole duration; lowest sampling interval is 1 second, so short videos cannot use more frames than their length in seconds."),
     detail: z3.enum(["fast", "standard", "deep"]).optional().describe("Analysis depth. Default standard."),
@@ -9793,6 +9929,7 @@ var MEMORY_TOOL_SCHEMAS = [
   GraphPathSchema,
   GraphUniverseSchema,
   LibraryIngestSchema,
+  BulkDeleteNotesSchema,
   DeleteNoteSchema,
   ExportSchema,
   GetSchema,
@@ -9811,6 +9948,7 @@ var MEMORY_TOOL_SCHEMAS = [
   ProposeScheduledActionSchema,
   ResumeScheduledActionSchema,
   RevokeScheduleLinkSchema,
+  SetScheduleDefaultsSchema,
   SetScheduleEntitlementSchema,
   CostUsageSchema,
   StorageUsageSchema,
@@ -9916,4 +10054,4 @@ export {
   registerMemoryMcpTools,
   MemoryMcpToolExecutor
 };
-//# sourceMappingURL=chunk-SUPUHPJS.js.map
+//# sourceMappingURL=chunk-UMTBCKHH.js.map