ask-marcel-office-cli 0.1.0 → 1.0.0

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

@@ -0,0 +1,5 @@
+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

@@ -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/search-onedrive-files.d.ts

@@ -1,9 +1,4 @@
-import { z } from 'zod';
-import type { Result } from '../../domain/result.js';
-import type { GraphClient } from '../../infra/graph-client.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>>;
-export { execute, schema };
+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/search-onenote-pages.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+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: Command['execute'];
+declare const meta: CommandMeta;
+export { execute, meta, schema };

package/dist/use-cases/commands/search-sharepoint-sites-by-name.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/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/update.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import type { Result } from '../../domain/result.js';
+import type { ProcessRunner } from '../ports/process-runner.js';
+export type UpdateError = {
+    type: 'spawn_failed';
+    message: string;
+} | {
+    type: 'install_failed';
+    exitCode: number;
+};
+export type PackageManager = 'npm' | 'bun';
+declare const schema: z.ZodObject<{}, z.core.$strict>;
+declare const execute: (runner: ProcessRunner, manager: PackageManager) => Promise<Result<{
+    readonly exitCode: number;
+}, UpdateError>>;
+export { execute, schema };

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>>;
 };

package/dist/use-cases/ports/process-runner.d.ts

@@ -0,0 +1,11 @@
+import type { Result } from '../../domain/result.js';
+export type ProcessRunnerError = {
+    type: 'spawn_failed';
+    message: string;
+};
+export type ProcessRunResult = {
+    readonly exitCode: number;
+};
+export type ProcessRunner = {
+    readonly runInherit: (command: string, args: ReadonlyArray<string>) => Promise<Result<ProcessRunResult, ProcessRunnerError>>;
+};