ask-marcel-office-cli 0.5.5 → 1.0.0

package/dist/use-cases/commands/embedded-item-to-markdown.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Render an itemAttachment's inner resource (a `microsoft.graph.message`,
+ * `event`, or `contact`) directly to markdown — no RTF round-trip, no
+ * Graph conversion call.
+ *
+ * Each renderer emits a small header block (`**Subject:** …`, etc.) and
+ * appends the body run through htmlToMarkdown when the inner resource
+ * has one. Callers (the convert-mail-attachment-to-markdown command)
+ * choose the right renderer by branching on `item['@odata.type']`.
+ */
+type EmailAddress = {
+    readonly name?: string;
+    readonly address?: string;
+};
+type Recipient = {
+    readonly emailAddress?: EmailAddress;
+};
+type Body = {
+    readonly contentType?: string;
+    readonly content?: string;
+};
+type EmbeddedMessage = {
+    readonly subject?: string;
+    readonly from?: Recipient;
+    readonly toRecipients?: ReadonlyArray<Recipient>;
+    readonly sentDateTime?: string;
+    readonly body?: Body;
+};
+declare const embeddedMessageToMarkdown: (m: EmbeddedMessage) => string;
+type EventDateTime = {
+    readonly dateTime?: string;
+    readonly timeZone?: string;
+};
+type Location = {
+    readonly displayName?: string;
+};
+type EmbeddedEvent = {
+    readonly subject?: string;
+    readonly start?: EventDateTime;
+    readonly end?: EventDateTime;
+    readonly location?: Location;
+    readonly organizer?: Recipient;
+    readonly attendees?: ReadonlyArray<Recipient>;
+    readonly body?: Body;
+};
+declare const embeddedEventToMarkdown: (e: EmbeddedEvent) => string;
+type EmbeddedContact = {
+    readonly displayName?: string;
+    readonly emailAddresses?: ReadonlyArray<{
+        address?: string;
+    }>;
+    readonly businessPhones?: ReadonlyArray<string>;
+    readonly mobilePhone?: string;
+    readonly companyName?: string;
+    readonly jobTitle?: string;
+};
+declare const embeddedContactToMarkdown: (c: EmbeddedContact) => string;
+export { embeddedContactToMarkdown, embeddedEventToMarkdown, embeddedMessageToMarkdown };
+export type { EmbeddedContact, EmbeddedEvent, EmbeddedMessage };

package/dist/use-cases/commands/excel-error.d.ts

@@ -0,0 +1,6 @@
+import type { Result } from '../../domain/result.js';
+import type { GraphClient, GraphError } from '../../infra/graph-client.js';
+declare const mapWacError: (e: GraphError) => GraphError;
+type ExecuteFn = (graph: GraphClient, params: Record<string, string>) => Promise<Result<unknown, GraphError>>;
+declare const wrapExcelExecute: (inner: ExecuteFn) => ExecuteFn;
+export { mapWacError, wrapExcelExecute };

package/dist/use-cases/commands/extract-sharepoint-links-in-mail.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import type { Result } from '../../domain/result.js';
+import type { GraphClient, GraphError } from '../../infra/graph-client.js';
+import type { CommandMeta } from './command-types.js';
+type ResolvedLink = {
+    readonly url: string;
+    readonly driveId?: string;
+    readonly itemId?: string;
+    readonly name?: string;
+    readonly webUrl?: string;
+    readonly error?: string;
+};
+type LinkExtractionSummary = {
+    readonly messageId: string;
+    readonly subject?: string;
+    readonly links: ReadonlyArray<ResolvedLink>;
+    readonly truncated: boolean;
+    readonly skippedCount: number;
+};
+declare const schema: z.ZodObject<{
+    messageId: z.ZodString;
+}, z.core.$strip>;
+declare const execute: (graph: GraphClient, params: Record<string, string>) => Promise<Result<LinkExtractionSummary, GraphError>>;
+declare const meta: CommandMeta;
+export { execute, meta, schema };
+export type { LinkExtractionSummary, ResolvedLink };

package/dist/use-cases/commands/fetch-raw-bytes.d.ts

@@ -0,0 +1,56 @@
+import type { Result } from '../../domain/result.js';
+import type { GraphClient, GraphError } from '../../infra/graph-client.js';
+/**
+ * Helpers that consolidate the "Graph hands you a 302, follow the CDN
+ * redirect, return the bytes" dance used by every command that needs
+ * raw file content.
+ *
+ * Real Graph responses for `/drives/{id}/items/{id}/content` (and the
+ * `?format=pdf` / `?format=html` variants) are 302 redirects to a CDN URL.
+ * `getBinary` captures the redirect and returns
+ * `{ '@microsoft.graph.downloadUrl': '...' }` — NOT inline bytes. To get
+ * the bytes we have to follow the URL via `fetchUrl`, which is host-allow-
+ * listed for SharePoint / ODSP / Microsoft media-transform domains.
+ *
+ * Two shapes for the return value depending on what the caller needs:
+ *   - `fetchRawBytes(graph, path, opts)` → `Uint8Array` for local
+ *     conversion (mammoth / sheetjs / turndown).
+ *   - `inlineBinary(graph, path, opts)` → `{ contentType, size, base64 }`
+ *     for "stream the bytes back through the JSON envelope" workflows
+ *     (PDF conversion, image attachments, anything the LLM consumer
+ *     either pipes to disk or saves via --output-path).
+ *
+ * The historical-version commands pass `elevated: true` so that the
+ * initial Graph call is signed with an M365ChatClient token (on the
+ * ODSP `logicalPermissions` allow-list); without that, Graph's 302
+ * redirects to a streamContent URL whose embedded tempauth is signed
+ * by Teams web client identity and rejected by SharePoint with 403.
+ */
+export type FetchOptions = {
+    readonly elevated?: boolean;
+};
+export type InlineBinary = {
+    readonly contentType: string;
+    readonly size: number;
+    readonly base64: string;
+};
+export declare const fetchRawBytes: (graph: GraphClient, contentPath: string, opts?: FetchOptions) => Promise<Result<Uint8Array, GraphError>>;
+export declare const inlineBinary: (graph: GraphClient, contentPath: string, opts?: FetchOptions) => Promise<Result<InlineBinary, GraphError>>;
+/**
+ * Detect Graph's silent-raw-bytes fallback on `?format=pdf` requests.
+ *
+ * When `format=pdf` succeeds, the response contentType is `application/pdf`.
+ * For some inputs (notably historical-version pptx on certain tenants, or
+ * reference-attachment edge cases) Graph silently falls back to returning
+ * the raw source bytes — same envelope shape, but contentType is the
+ * source MIME (or `application/octet-stream`). The audit (round-5 #2)
+ * caught this happening on `download-drive-item-version-as-pdf` for v79
+ * of a pptx: the response said `contentType: "application/octet-stream"`
+ * with the exact source byte size, and an LLM that saved it as `.pdf`
+ * would have had a corrupt file.
+ *
+ * Tag the result with `passthrough: true` and a sharp note so the LLM
+ * knows the conversion didn't run and saves the bytes with the source
+ * extension instead of `.pdf`.
+ */
+export declare const tagPdfPassthrough: (result: Result<InlineBinary, GraphError>, sourceLabel: string) => Result<unknown, GraphError>;

package/dist/use-cases/commands/format-zod-error.d.ts

@@ -0,0 +1,14 @@
+import type { z } from 'zod';
+/**
+ * Render a Zod validation error as a single human-readable line keyed off the
+ * CLI flag name. The audit's gripe with the previous formatter
+ * (`messageRuleId: Too small: expected string to have >=1 characters`) was
+ * that an LLM piping the JSON envelope through jq sees Zod jargon plus the
+ * camelCase schema key — neither matches what the user typed on the command
+ * line. This formatter prepends `--<kebab-case-flag>` and translates the two
+ * common Zod codes to plain English: missing values become `is missing`,
+ * empty strings become `is empty`. Multi-issue failures join with `; ` to
+ * stay on one line.
+ */
+declare const formatZodError: (error: z.ZodError) => string;
+export { formatZodError };

package/dist/use-cases/commands/get-calendar-event.d.ts

@@ -1,8 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    eventId: z.ZodString;
-}, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-calendar-view.d.ts

@@ -1,9 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    startDateTime: z.ZodString;
-    endDateTime: z.ZodString;
-}, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-channel-files-folder.d.ts

@@ -0,0 +1,4 @@
+import type { CommandMeta } from './command-types.js';
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-chat.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import type { CommandMeta } from './command-types.js';
+declare const schema: z.ZodObject<{
+    chatId: z.ZodString;
+}, z.core.$strip>;
+declare const execute: import("./command-types.js").CommandExecute;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-current-user.d.ts

@@ -1,6 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{}, z.core.$strict>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-drive-delta.d.ts

@@ -1,9 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    driveId: z.ZodString;
-    itemId: z.ZodString;
-}, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-drive-item-analytics.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import type { CommandMeta } from './command-types.js';
+declare const schema: z.ZodObject<{
+    driveId: z.ZodString;
+    itemId: z.ZodString;
+}, z.core.$strip>;
+declare const execute: import("./command-types.js").CommandExecute;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-drive-item-created-by-user.d.ts

@@ -0,0 +1,4 @@
+import type { CommandMeta } from './command-types.js';
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-drive-item-last-modified-by-user.d.ts

@@ -0,0 +1,4 @@
+import type { CommandMeta } from './command-types.js';
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-drive-item-list-item.d.ts

@@ -0,0 +1,4 @@
+import type { CommandMeta } from './command-types.js';
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-drive-item.d.ts

@@ -1,9 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    driveId: z.ZodString;
-    itemId: z.ZodString;
-}, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-drive-root-delta.d.ts

@@ -0,0 +1,4 @@
+import type { CommandMeta } from './command-types.js';
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-drive-root-item.d.ts

@@ -1,8 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    driveId: z.ZodString;
-}, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-drive-special-folder.d.ts

@@ -0,0 +1,4 @@
+import type { CommandMeta } from './command-types.js';
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-excel-range.d.ts

@@ -6,6 +6,6 @@ declare const schema: z.ZodObject<{
     worksheetId: z.ZodString;
     address: z.ZodString;
 }, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: (graph: import("../../index.js").GraphClient, params: Record<string, string>) => Promise<import("../../index.js").Result<unknown, import("../../index.js").GraphError>>;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-excel-table.d.ts

@@ -5,6 +5,6 @@ declare const schema: z.ZodObject<{
     itemId: z.ZodString;
     tableId: z.ZodString;
 }, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: (graph: import("../../index.js").GraphClient, params: Record<string, string>) => Promise<import("../../index.js").Result<unknown, import("../../index.js").GraphError>>;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-excel-used-range.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import type { CommandMeta } from './command-types.js';
+declare const schema: z.ZodObject<{
+    driveId: z.ZodString;
+    itemId: z.ZodString;
+    worksheetId: z.ZodString;
+}, z.core.$strip>;
+declare const execute: (graph: import("../../index.js").GraphClient, params: Record<string, string>) => Promise<import("../../index.js").Result<unknown, import("../../index.js").GraphError>>;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-group-calendar-view.d.ts

@@ -0,0 +1,4 @@
+import type { CommandMeta } from './command-types.js';
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-group.d.ts

@@ -0,0 +1,4 @@
+import type { CommandMeta } from './command-types.js';
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-mail-attachment.d.ts

@@ -1,9 +1,11 @@
 import { z } from 'zod';
-import type { CommandMeta } from './command-types.js';
+import type { Command, CommandMeta } from './command-types.js';
 declare const schema: z.ZodObject<{
     messageId: z.ZodString;
     attachmentId: z.ZodString;
+    select: z.ZodOptional<z.ZodString>;
+    expand: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: Command['execute'];
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-mail-message-mime.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import type { Command, CommandMeta } from './command-types.js';
+declare const schema: z.ZodObject<{
+    messageId: z.ZodString;
+}, z.core.$strip>;
+declare const execute: Command['execute'];
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-mail-message.d.ts

@@ -1,8 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    messageId: z.ZodString;
-}, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-mail-rule.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import type { CommandMeta } from './command-types.js';
+declare const schema: z.ZodObject<{
+    mailFolderId: z.ZodDefault<z.ZodString>;
+    messageRuleId: z.ZodString;
+}, z.core.$strip>;
+declare const execute: import("./command-types.js").CommandExecute;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-mailbox-settings.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{}, z.core.$strict>;
+declare const schema: z.ZodObject<{}, z.core.$strip>;
 declare const execute: import("./command-types.js").CommandExecute;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-my-calendar.d.ts

@@ -0,0 +1,4 @@
+import type { CommandMeta } from './command-types.js';
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-my-manager.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import type { Command, CommandMeta } from './command-types.js';
+declare const schema: z.ZodObject<{
+    select: z.ZodOptional<z.ZodString>;
+    expand: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const execute: Command['execute'];
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-onenote-page-as-markdown.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import type { Result } from '../../domain/result.js';
+import type { GraphClient, GraphError } from '../../infra/graph-client.js';
+import type { CommandMeta } from './command-types.js';
+declare const schema: z.ZodObject<{
+    onenotePageId: z.ZodString;
+}, z.core.$strip>;
+declare const execute: (graph: GraphClient, params: Record<string, string>) => Promise<Result<unknown, GraphError>>;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-organization.d.ts

@@ -0,0 +1,4 @@
+import type { CommandMeta } from './command-types.js';
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-shared-calendar-view.d.ts

@@ -0,0 +1,4 @@
+import type { CommandMeta } from './command-types.js';
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-shared-mailbox-message.d.ts

@@ -0,0 +1,4 @@
+import type { CommandMeta } from './command-types.js';
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-sharepoint-list-column.d.ts

@@ -0,0 +1,4 @@
+import type { CommandMeta } from './command-types.js';
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-sharepoint-site-drive-by-id.d.ts

@@ -1,9 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    siteId: z.ZodString;
-    driveId: z.ZodString;
-}, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-sharepoint-site-list-item.d.ts

@@ -1,10 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    siteId: z.ZodString;
-    listId: z.ZodString;
-    listItemId: z.ZodString;
-}, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-sharepoint-site-list.d.ts

@@ -1,9 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    siteId: z.ZodString;
-    listId: z.ZodString;
-}, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-sharepoint-site-onenote-page-content.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import type { CommandMeta } from './command-types.js';
+declare const schema: z.ZodObject<{
+    siteId: z.ZodString;
+    onenotePageId: z.ZodString;
+}, z.core.$strip>;
+declare const execute: import("./command-types.js").CommandExecute;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-sharepoint-site.d.ts

@@ -1,8 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    siteId: z.ZodString;
-}, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-site-analytics.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import type { CommandMeta } from './command-types.js';
+declare const schema: z.ZodObject<{
+    siteId: z.ZodString;
+}, z.core.$strip>;
+declare const execute: import("./command-types.js").CommandExecute;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-specific-calendar-event.d.ts

@@ -1,9 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    calendarId: z.ZodString;
-    eventId: z.ZodString;
-}, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-specific-calendar-view.d.ts

@@ -1,10 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    calendarId: z.ZodString;
-    startDateTime: z.ZodString;
-    endDateTime: z.ZodString;
-}, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-team-channel.d.ts

@@ -1,9 +1,5 @@
-import { z } from 'zod';
-import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    teamId: z.ZodString;
-    channelId: z.ZodString;
-}, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+import type { Command, CommandMeta } from './command-types.js';
+declare const execute: Command['execute'];
+declare const schema: import("./command-types.js").CommandSchema;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-team-primary-channel.d.ts

@@ -0,0 +1,4 @@
+import type { CommandMeta } from './command-types.js';
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/get-team.d.ts

@@ -1,8 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    teamId: z.ZodString;
-}, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-todo-task.d.ts

@@ -1,9 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    todoTaskListId: z.ZodString;
-    todoTaskId: z.ZodString;
-}, z.core.$strip>;
-declare const execute: import("./command-types.js").CommandExecute;
+declare const execute: import("./command-types.js").CommandExecute, schema: import("./command-types.js").CommandSchema;
 declare const meta: CommandMeta;
 export { execute, meta, schema };

package/dist/use-cases/commands/get-user-manager.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import type { Command, CommandMeta } from './command-types.js';
+declare const schema: z.ZodObject<{
+    userId: z.ZodString;
+    select: z.ZodOptional<z.ZodString>;
+    expand: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const execute: Command['execute'];
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/graph-scopes.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Central Microsoft Graph permission scope map (audit round-8 Wave C).
+ *
+ * Source of truth: Microsoft Graph permissions reference
+ * (https://learn.microsoft.com/en-us/graph/permissions-reference). Each
+ * command's `graphDocsUrl` Learn page documents the required scope(s).
+ *
+ * Convention: list the LEAST-PRIVILEGED scope Microsoft documents for the
+ * delegated permissions path. When multiple alternatives exist (e.g.
+ * `Mail.Read` OR `Mail.ReadBasic` OR `Mail.ReadWrite`) we pick the most
+ * read-only choice. The basic Teams web client token grants ~30 scopes
+ * (`User.Read`, `Mail.Read`, `Calendars.Read`, `Files.Read`, `Tasks.Read`,
+ * `Notes.Read.All`, `Sites.Read.All`, `Group.Read.All`, `Team.ReadBasic.All`,
+ * `Channel.ReadBasic.All`, `People.Read`, `MailboxSettings.Read`, etc.). The
+ * M365ChatClient elevated identity adds `Chat.ReadBasic` and ODSP allow-list
+ * access (covered by `needsElevatedToken: true` per command).
+ *
+ * Surface: this map is read by `docs.ts toEntry` at manifest-render time
+ * and merged into each command's `scopesRequired`. Per-command inline
+ * `meta.scopesRequired` takes precedence (so command files can override).
+ * An LLM uses this with `scopes-check` to predict 403s pre-flight.
+ *
+ * Lifecycle / meta commands intentionally absent (empty array would imply
+ * "no scope needed" which is true for them but also true of `update`,
+ * `docs`, `help-json` — none of which call Graph).
+ */
+declare const GRAPH_SCOPES_BY_COMMAND: Readonly<Record<string, ReadonlyArray<string>>>;
+declare const lookupScopes: (commandName: string) => ReadonlyArray<string> | undefined;
+export { GRAPH_SCOPES_BY_COMMAND, lookupScopes };