ask-marcel-office-cli 0.5.5 → 1.0.0

package/dist/use-cases/commands/list-sharepoint-site-drives.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/list-sharepoint-site-list-items.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/list-sharepoint-site-lists.d.ts

@@ -1,8 +1,13 @@
 import { z } from 'zod';
-import type { CommandMeta } from './command-types.js';
+import type { Command, CommandMeta } from './command-types.js';
 declare const schema: z.ZodObject<{
     siteId: z.ZodString;
+    filter: z.ZodOptional<z.ZodString>;
+    select: z.ZodOptional<z.ZodString>;
+    top: z.ZodOptional<z.ZodString>;
+    orderby: 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/list-sharepoint-site-onenote-notebook-sections.d.ts

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

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

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

package/dist/use-cases/commands/list-sharepoint-site-onenote-section-pages.d.ts

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

package/dist/use-cases/commands/list-sharepoint-site-pages.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/list-site-columns.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/list-site-content-types.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/list-specific-calendar-events.d.ts

@@ -1,8 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    calendarId: 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/list-team-channels.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/list-team-installed-apps.d.ts

@@ -0,0 +1,8 @@
+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 meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/list-todo-linked-resources.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/list-todo-task-lists.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/list-todo-tasks-delta.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import type { CommandMeta } from './command-types.js';
+declare const schema: z.ZodObject<{
+    todoTaskListId: 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/list-todo-tasks.d.ts

@@ -1,8 +1,14 @@
 import { z } from 'zod';
-import type { CommandMeta } from './command-types.js';
+import type { Command, CommandMeta } from './command-types.js';
 declare const schema: z.ZodObject<{
     todoTaskListId: z.ZodString;
+    top: z.ZodOptional<z.ZodString>;
+    skip: z.ZodOptional<z.ZodString>;
+    select: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    orderby: 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/list-trending-insights.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/list-user-direct-reports.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/markdown-pipeline.d.ts

@@ -0,0 +1,23 @@
+import type { Result } from '../../domain/result.js';
+import type { GraphClient, GraphError } from '../../infra/graph-client.js';
+import { type InlineAttachment } from './inline-image-embedder.js';
+/**
+ * Orchestrate the four steps that turn a Graph `?format=html` content
+ * call into a markdown envelope:
+ *
+ *   1. getBinary(contentPath)
+ *   2. if Graph returned a 302 downloadUrl, follow via fetchUrl (host
+ *      allow-list enforced inside fetchUrl, Hardening #3)
+ *   3. embedInlineImages over any cid: refs (Hardening #1: image/* only)
+ *   4. htmlToMarkdown via turndown
+ *
+ * Returns `{ contentType: 'text/markdown', size, text }` on success.
+ */
+type MarkdownEnvelope = {
+    readonly contentType: 'text/markdown';
+    readonly size: number;
+    readonly text: string;
+};
+declare const convertToMarkdown: (graph: GraphClient, contentPath: string, inlineAttachments?: ReadonlyArray<InlineAttachment>) => Promise<Result<MarkdownEnvelope, GraphError>>;
+export { convertToMarkdown };
+export type { MarkdownEnvelope };

package/dist/use-cases/commands/microsoft-search-query.d.ts

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

package/dist/use-cases/commands/my-quick-context.d.ts

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

package/dist/use-cases/commands/next-page.d.ts

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import type { CommandMeta } from './command-types.js';
+import type { Command, CommandMeta } from './command-types.js';
 declare const schema: z.ZodObject<{
     url: 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/odata-query.d.ts

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+import type { CommandOptionMeta } from './command-types.js';
+declare const odataQuerySchema: z.ZodObject<{
+    top: z.ZodOptional<z.ZodString>;
+    skip: z.ZodOptional<z.ZodString>;
+    select: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    orderby: z.ZodOptional<z.ZodString>;
+    expand: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ODataQueryParams = z.infer<typeof odataQuerySchema>;
+declare const appendOData: (path: string, params: ODataQueryParams) => string;
+declare const odataQueryOptions: ReadonlyArray<CommandOptionMeta>;
+/**
+ * Subset for single-resource GETs that support `$select` and `$expand` but
+ * have no collection to slice (`$top`/`$skip`/`$filter`/`$orderby` make no
+ * sense). Keeping this as a separate Zod fragment lets `buildSelectableCommand`
+ * advertise only the two relevant flags in `--help`.
+ */
+declare const selectExpandSchema: z.ZodObject<{
+    select: z.ZodOptional<z.ZodString>;
+    expand: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type SelectExpandParams = z.infer<typeof selectExpandSchema>;
+declare const selectExpandOptions: ReadonlyArray<CommandOptionMeta>;
+/**
+ * Subset for collection endpoints that Microsoft documents as supporting only
+ * `$filter` + `$select` (e.g. `/teams/{id}/channels`). Advertising the other
+ * OData passthroughs would be a usability lie since Graph rejects them with
+ * `BadRequest`.
+ */
+declare const filterSelectSchema: z.ZodObject<{
+    filter: z.ZodOptional<z.ZodString>;
+    select: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type FilterSelectParams = z.infer<typeof filterSelectSchema>;
+declare const filterSelectOptions: ReadonlyArray<CommandOptionMeta>;
+/**
+ * Subset for collection endpoints that REJECT `$skip` with
+ * `invalidRequest: $skip is not supported on this API. Only URLs returned
+ * by the API can be used to page.` (e.g. `/sites/{id}/lists`). Drop --skip
+ * from the advertised flags; pagination still works via `nextLink` →
+ * `next-page`.
+ */
+declare const noSkipShape: Omit<typeof odataQuerySchema.shape, "skip">;
+declare const noSkipOptions: ReadonlyArray<CommandOptionMeta>;
+type ODataKey = keyof typeof odataQuerySchema.shape;
+/**
+ * Returns a zod-extension shape containing ONLY the named OData fields.
+ * Use for endpoints where Graph silently ignores some passthroughs — the
+ * CLI advertises only the ones the endpoint honors.
+ */
+declare const pickODataShape: <K extends ODataKey>(keys: ReadonlyArray<K>) => Pick<typeof odataQuerySchema.shape, K>;
+/**
+ * Returns the matching CommandOptionMeta entries for use in `meta.options`.
+ * Order is preserved from the canonical `odataQueryOptions` definition.
+ */
+declare const pickODataOptions: (keys: ReadonlyArray<ODataKey>) => ReadonlyArray<CommandOptionMeta>;
+/**
+ * Subset for delta-tracking endpoints where Graph silently ignores every
+ * OData passthrough except `$top` (which itself must be translated to a
+ * `Prefer: odata.maxpagesize` header — `$top` as a query parameter returns
+ * `ErrorInvalidUrlQuery`). The CLI keeps `--top` as the user-facing flag
+ * and drops the others rather than advertising no-ops.
+ */
+declare const topOnlyShape: Pick<{
+    top: z.ZodOptional<z.ZodString>;
+    skip: z.ZodOptional<z.ZodString>;
+    select: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    orderby: z.ZodOptional<z.ZodString>;
+    expand: z.ZodOptional<z.ZodString>;
+}, "top">;
+declare const topOnlyOptions: readonly CommandOptionMeta[];
+/**
+ * Subset for endpoints where Graph honors ONLY `$select` (e.g.
+ * `/me/planner/plans`, `/planner/plans/{id}/buckets` — the other OData
+ * passthroughs are silently dropped server-side).
+ */
+declare const selectOnlyShape: Pick<{
+    top: z.ZodOptional<z.ZodString>;
+    skip: z.ZodOptional<z.ZodString>;
+    select: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    orderby: z.ZodOptional<z.ZodString>;
+    expand: z.ZodOptional<z.ZodString>;
+}, "select">;
+declare const selectOnlyOptions: readonly CommandOptionMeta[];
+export { appendOData, filterSelectOptions, filterSelectSchema, noSkipOptions, noSkipShape, odataQueryOptions, odataQuerySchema, pickODataOptions, pickODataShape, selectExpandOptions, selectExpandSchema, selectOnlyOptions, selectOnlyShape, topOnlyOptions, topOnlyShape, };
+export type { FilterSelectParams, ODataKey, ODataQueryParams, SelectExpandParams };

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

@@ -0,0 +1,6 @@
+import type { Result } from '../../domain/result.js';
+import type { GraphClient, GraphError } from '../../infra/graph-client.js';
+import type { FetchOptions } from './fetch-raw-bytes.js';
+declare const officeToMarkdown: (graph: GraphClient, contentPath: string, filename: string, opts?: FetchOptions) => Promise<Result<unknown, GraphError>>;
+export { officeToMarkdown };
+export type { FetchOptions };

package/dist/use-cases/commands/onenote-5k-limit.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from './command-types.js';
+declare const wrapOnenote5kLimit: (inner: Command["execute"]) => Command["execute"];
+export { wrapOnenote5kLimit };

package/dist/use-cases/commands/output-path.d.ts

@@ -0,0 +1,37 @@
+import type { Result } from '../../domain/result.js';
+import type { FileSystem } from '../ports/filesystem.js';
+/**
+ * Generic interceptor used by the global `--output-path` flag in `cli.ts`.
+ *
+ * Given a use-case's success value, if the user passed `--output-path
+ * <path>` the CLI calls this helper to land the inlined bytes on disk
+ * and rewrite the envelope so the LLM never sees a multi-MB base64
+ * string in stdout.
+ *
+ * Two recognized inline shapes — both produced by `inlineBinary` and
+ * `office-to-markdown`:
+ *
+ *   1. `{ contentType, size, base64 }` — written via `fs.writeBytes`,
+ *      with `base64` replaced by `savedTo`.
+ *   2. `{ contentType, size, text }`    — written via `fs.writeText`,
+ *      with `text` replaced by `savedTo`.
+ *
+ * Anything else (plain JSON gets, error envelopes, etc.) returns
+ * `no_inlined_bytes` so the CLI can surface a clear error rather than
+ * silently no-op'ing.
+ */
+export type OutputPathError = {
+    readonly type: 'no_inlined_bytes';
+} | {
+    readonly type: 'write_failed';
+    readonly message: string;
+} | {
+    readonly type: 'empty_path';
+} | {
+    readonly type: 'is_directory';
+} | {
+    readonly type: 'passthrough_extension_mismatch';
+    readonly contentType: string;
+    readonly requestedExtension: string;
+};
+export declare const persistIfRequested: (fs: FileSystem, outputPath: string | undefined, data: unknown) => Promise<Result<unknown, OutputPathError>>;

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

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

package/dist/use-cases/commands/search-mail-messages.d.ts

@@ -1,8 +1,5 @@
-import { z } from 'zod';
-import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    query: 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/search-my-documents.d.ts

@@ -1,8 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    query: 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/search-onedrive-files.d.ts

@@ -1,11 +1,4 @@
-import { z } from 'zod';
-import type { Result } from '../../domain/result.js';
-import type { GraphClient } from '../../infra/graph-client.js';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    driveId: z.ZodString;
-    query: z.ZodString;
-}, z.core.$strip>;
-declare const execute: (graph: GraphClient, params: Record<string, string>) => Promise<Result<unknown, import("../../infra/graph-client.js").GraphError>>;
+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/search-onenote-pages.d.ts

@@ -1,8 +1,13 @@
 import { z } from 'zod';
-import type { CommandMeta } from './command-types.js';
+import type { Command, CommandMeta } from './command-types.js';
 declare const schema: z.ZodObject<{
     titleSubstring: z.ZodString;
+    select: z.ZodOptional<z.ZodString>;
+    top: z.ZodOptional<z.ZodString>;
+    skip: z.ZodOptional<z.ZodString>;
+    orderby: 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/search-sharepoint-sites-by-name.d.ts

@@ -1,8 +1,4 @@
-import { z } from 'zod';
 import type { CommandMeta } from './command-types.js';
-declare const schema: z.ZodObject<{
-    query: 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/sharepoint-link-extractor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Pure helpers for `extract-sharepoint-links-in-mail`.
+ *
+ * `extractSharepointUrls(htmlBody)` finds every `https://*.sharepoint.com/...`
+ * URL inside an HTML mail body — both `<a href=...>` and bare-text
+ * occurrences — and returns the deduplicated list.
+ *
+ * `buildShareToken(url)` encodes a URL for Graph's `/shares/{token}`
+ * resolver per [shares-get](https://learn.microsoft.com/en-us/graph/api/shares-get):
+ * `u!` + base64url(url) with no padding.
+ */
+declare const extractSharepointUrls: (htmlBody: string) => ReadonlyArray<string>;
+declare const buildShareToken: (url: string) => string;
+export { buildShareToken, extractSharepointUrls };

package/dist/use-cases/commands/text-passthrough.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Microsoft Graph's `?format=pdf` / `?format=html` conversion accepts a
+ * fixed set of source extensions. For anything outside that whitelist
+ * Graph (or its downstream Office Online sandbox) returns a 4xx, which
+ * is a cryptic failure mode for an LLM agent.
+ *
+ * The conversion commands short-circuit on the extensions below and
+ * return the raw bytes instead of attempting (and wasting) a Graph
+ * round-trip:
+ *
+ *   - PLAIN_TEXT_EXTENSIONS: extensions that are themselves plain text
+ *     (txt/md/json/yaml/etc.) — turning these through `?format=pdf` or
+ *     `?format=html` is meaningless; just return the bytes.
+ *
+ *   - `pdf`: the `*-as-pdf` commands ask Graph to convert TO pdf, but
+ *     `pdf` is NOT in Graph's `format=pdf` source-input list (verified
+ *     2026-05 against svc.ms; CDN responds 406 InputFormatNotSupported).
+ *     The user wanted a PDF and the source IS a PDF, so return its
+ *     bytes directly.
+ */
+declare const PLAIN_TEXT_EXTENSIONS: ReadonlySet<string>;
+declare const isPlainTextFilename: (name: string) => boolean;
+declare const isPdfSource: (name: string) => boolean;
+export { isPdfSource, isPlainTextFilename, PLAIN_TEXT_EXTENSIONS };

package/dist/use-cases/commands/version-id.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Graph's historical-version endpoints template `{version-id}` as a string
+ * that must look like a stringified float (`"79.0"`, `"4.0"`). An LLM
+ * (reasonably) types `79`, and the response is wildly inconsistent across
+ * the three sibling commands:
+ *
+ *   - download-drive-item-version-content        → `invalidRequest`
+ *   - download-drive-item-version-as-markdown    → `invalidRequest`
+ *   - download-drive-item-version-as-pdf         → accepts (Graph quirk)
+ *
+ * Audit round-6 §1.4 caught the inconsistency. Normalize at the CLI
+ * boundary: a pure-integer version-id gets `.0` appended before path
+ * substitution, so all three commands accept both spellings.
+ *
+ * Already-floated values (`79.0`, `12.5`, `4.1`) and non-numeric values
+ * (a bad input the schema will then reject) pass through unchanged.
+ */
+export declare const normalizeVersionId: (raw: string) => string;

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

@@ -0,0 +1,6 @@
+import type { Result } from '../../domain/result.js';
+import type { GraphError } from '../../infra/graph-client.js';
+import type { MarkdownEnvelope } from './docx-to-markdown.js';
+declare const csvToMarkdownTable: (csv: string) => string;
+declare const xlsxToMarkdown: (bytes: Uint8Array) => Result<MarkdownEnvelope, GraphError>;
+export { csvToMarkdownTable, xlsxToMarkdown };

package/dist/use-cases/ports/filesystem.d.ts

@@ -11,5 +11,13 @@ export type FileSystemError = {
 export type FileSystem = {
     readonly readJson: <T>(path: string) => Promise<Result<T, FileSystemError>>;
     readonly writeText: (path: string, content: string) => Promise<Result<void, FileSystemError>>;
+    readonly writeBytes: (path: string, bytes: Uint8Array) => Promise<Result<void, FileSystemError>>;
     readonly deleteIfExists: (path: string) => Promise<Result<void, FileSystemError>>;
+    /**
+     * Recursively delete a directory (and all its contents). Used by `logout`
+     * to wipe the Playwright persistent browser profile so stale auth cookies
+     * don't survive across login attempts. Returns ok even when the
+     * directory does not exist — semantics mirror `deleteIfExists`.
+     */
+    readonly deleteDirIfExists: (path: string) => Promise<Result<void, FileSystemError>>;
 };