reportflow-mcp 1.1.3 → 1.2.0

package/dist/server.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.startServer = void 0;
+exports.startServer = exports.createMcpServer = exports.contentDtoSchema = void 0;
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const zod_1 = require("zod");
@@ -17,17 +17,28 @@ const suggest_params_js_1 = require("./tools/suggest-params.js");
 const index_js_1 = require("./prompts/index.js");
 const index_js_2 = require("./resources/index.js");
 const index_js_3 = require("./roots/index.js");
+const index_js_4 = require("./telemetry/index.js");
 // eslint-disable-next-line @typescript-eslint/no-require-imports
 const pkg = require('../package.json');
 // ─── Common Zod Schemas ───────────────────────────────────
 const designIdSchema = zod_1.z.string().describe('デザインID（UUID形式）');
 const versionSchema = zod_1.z.number().int().describe('デザインバージョン番号');
-const contentDtoSchema = zod_1.z.object({
+exports.contentDtoSchema = zod_1.z.object({
     fileName: zod_1.z.string().describe('出力ファイル名（例: invoice.pdf）'),
     shareType: zod_1.z
-        .enum(['private', 'public'])
-        .optional()
-        .describe('共有タイプ（省略時はprivate）'),
+        .union([
+        zod_1.z
+            .literal('01')
+            .describe('ワークスペース内共有: 同一ワークスペースのメンバーのみアクセス可能（デフォルト）'),
+        zod_1.z
+            .literal('02')
+            .describe('招待者共有: 招待されたメールアドレスを持つユーザーのみアクセス可能'),
+        zod_1.z
+            .literal('03')
+            .describe('公開URL共有: URL を知る誰でもアクセス可能（オプションでパスコード保護）'),
+    ])
+        .default('01')
+        .describe("共有タイプ（数値コード）。省略時は '01'。レスポンスの share.shareType は 'workspace'/'invited'/'public' で返る。"),
     passcodeEnabled: zod_1.z.boolean().optional().describe('パスコード保護の有効化'),
     params: zod_1.z
         .record(zod_1.z.unknown())
@@ -37,22 +48,31 @@ const outputDirSchema = zod_1.z
     .string()
     .optional()
     .describe('出力先ディレクトリ (相対/絶対)。未指定時はクライアントのワークスペース (Roots) または現在の作業ディレクトリに保存。ユーザーが場所を指定した場合のみセットすること。');
+const includePreviewSchema = zod_1.z
+    .boolean()
+    .optional()
+    .describe('true 指定時のみ EmbeddedResource (application/pdf, base64 blob) を応答に含める。claude.ai は現状 PDF resource を inline 表示しないため、通常は省略 (false) で fileUrl のみを利用するのが効率的。');
 const singlePdfSchema = {
     designId: designIdSchema,
     version: versionSchema,
-    content: contentDtoSchema.describe('PDF生成コンテンツ'),
+    content: exports.contentDtoSchema.describe('PDF生成コンテンツ'),
+};
+const singlePdfSyncHttpSchema = {
+    ...singlePdfSchema,
+    includePreview: includePreviewSchema,
 };
 const multiplePdfSchema = {
     designId: designIdSchema,
     version: versionSchema,
     contents: zod_1.z
-        .array(contentDtoSchema)
+        .array(exports.contentDtoSchema)
         .min(1)
         .describe('PDF生成コンテンツの配列（複数ファイル）'),
 };
 const singlePdfSyncSchema = {
     ...singlePdfSchema,
     outputDir: outputDirSchema,
+    includePreview: includePreviewSchema,
 };
 const multiplePdfSyncSchema = {
     ...multiplePdfSchema,
@@ -62,62 +82,90 @@ const multiplePdfSyncSchema = {
         .optional()
         .describe('出力 ZIP のファイル名 (省略時は download.zip)'),
 };
-const startServer = async () => {
+/**
+ * 全ツール / Prompts / Resources を登録した McpServer を生成して返す。
+ * Transport への接続は呼び出し側で行う（stdio: index.ts、HTTP: http-server.ts）。
+ */
+const createMcpServer = (opts = {}) => {
+    const mode = opts.mode ?? 'stdio';
+    const telemetry = opts.telemetry ?? (0, index_js_4.telemetryClientFromEnv)();
     const server = new mcp_js_1.McpServer({
         name: pkg.name,
         version: pkg.version,
     });
-    // authenticate (OAuth2 PKCE flow — call this first or when other tools error with auth)
-    server.tool(authenticate_js_1.authenticateTool.name, authenticate_js_1.authenticateTool.description, {
-        force: zod_1.z
-            .boolean()
-            .optional()
-            .describe('既存トークンを破棄して再認証する場合 true'),
-    }, async (input) => (0, authenticate_js_1.handleAuthenticate)(input));
+    // authenticate (OAuth2 PKCE flow — stdio モードのみ提供)
+    if (mode === 'stdio') {
+        server.tool(authenticate_js_1.authenticateTool.name, authenticate_js_1.authenticateTool.description, {
+            force: zod_1.z
+                .boolean()
+                .optional()
+                .describe('既存トークンを破棄して再認証する場合 true'),
+        }, (0, index_js_4.withTelemetry)(telemetry, authenticate_js_1.authenticateTool.name, async (input) => (0, authenticate_js_1.handleAuthenticate)(input)));
+    }
     // get_design_parameters
     server.tool(get_design_parameters_js_1.getDesignParametersTool.name, get_design_parameters_js_1.getDesignParametersTool.description, {
         designId: designIdSchema,
         version: versionSchema
             .optional()
             .describe('バージョン番号（省略時は最新版）'),
-    }, async (input) => (0, get_design_parameters_js_1.handleGetDesignParameters)(input));
+    }, (0, index_js_4.withTelemetry)(telemetry, get_design_parameters_js_1.getDesignParametersTool.name, async (input) => (0, get_design_parameters_js_1.handleGetDesignParameters)(input)));
     // list_templates
-    server.tool(list_templates_js_1.listTemplatesTool.name, list_templates_js_1.listTemplatesTool.description, {}, async (input) => (0, list_templates_js_1.handleListTemplates)(input));
-    // generate_pdf_sync (Roots-aware)
-    server.tool(generate_pdf_sync_js_1.generatePdfSyncTool.name, generate_pdf_sync_js_1.generatePdfSyncTool.description, singlePdfSyncSchema, async (input) => (0, generate_pdf_sync_js_1.handleGeneratePdfSync)(input, {
-        resolveOutputDir: () => (0, index_js_3.resolveDefaultOutputDir)(server),
-    }));
-    // generate_pdf_async
-    server.tool(generate_pdf_async_js_1.generatePdfAsyncTool.name, generate_pdf_async_js_1.generatePdfAsyncTool.description, singlePdfSchema, async (input) => (0, generate_pdf_async_js_1.handleGeneratePdfAsync)(input));
-    // generate_pdfs_sync (Roots-aware)
-    server.tool(generate_pdfs_sync_js_1.generatePdfsSyncTool.name, generate_pdfs_sync_js_1.generatePdfsSyncTool.description, multiplePdfSyncSchema, async (input) => (0, generate_pdfs_sync_js_1.handleGeneratePdfsSync)(input, {
-        resolveOutputDir: () => (0, index_js_3.resolveDefaultOutputDir)(server),
-    }));
-    // generate_pdfs_async
-    server.tool(generate_pdfs_async_js_1.generatePdfsAsyncTool.name, generate_pdfs_async_js_1.generatePdfsAsyncTool.description, multiplePdfSchema, async (input) => (0, generate_pdfs_async_js_1.handleGeneratePdfsAsync)(input));
-    // download_file
-    server.tool(download_file_js_1.downloadFileTool.name, download_file_js_1.downloadFileTool.description, {
-        requestId: zod_1.z
-            .string()
-            .describe('generate_pdf_asyncで返されたrequestId（UUID）'),
-        fileId: zod_1.z.string().describe('generate_pdf_asyncのfiles[].fileId'),
-        fileName: zod_1.z
-            .string()
-            .optional()
-            .describe('保存ファイル名（省略時はfileId.pdf）'),
-        outputDir: outputDirSchema,
-    }, async (input) => (0, download_file_js_1.handleDownloadFile)(input));
-    // download_zip
-    server.tool(download_zip_js_1.downloadZipTool.name, download_zip_js_1.downloadZipTool.description, {
-        requestId: zod_1.z
-            .string()
-            .describe('generate_pdfs_asyncで返されたrequestId（UUID）'),
-        fileName: zod_1.z
-            .string()
-            .optional()
-            .describe('保存ファイル名（省略時はrequestId.zip）'),
-        outputDir: outputDirSchema,
-    }, async (input) => (0, download_zip_js_1.handleDownloadZip)(input));
+    server.tool(list_templates_js_1.listTemplatesTool.name, list_templates_js_1.listTemplatesTool.description, {}, (0, index_js_4.withTelemetry)(telemetry, list_templates_js_1.listTemplatesTool.name, async (input) => (0, list_templates_js_1.handleListTemplates)(input)));
+    // ─── generate_pdf_sync (両モード共通) ──────────────────────────────────
+    // HTTP モードでは EmbeddedResource (application/pdf, base64 blob) のみを返し、
+    // サーバー側 filesystem には保存しない (コンテナ内パスはクライアント不可達)。
+    // stdio モードでは従来通り Roots/outputDir に保存 + EmbeddedResource も併せて返す。
+    if (mode === 'stdio') {
+        server.tool(generate_pdf_sync_js_1.generatePdfSyncTool.name, generate_pdf_sync_js_1.generatePdfSyncTool.description, singlePdfSyncSchema, (0, index_js_4.withTelemetry)(telemetry, generate_pdf_sync_js_1.generatePdfSyncTool.name, async (input) => (0, generate_pdf_sync_js_1.handleGeneratePdfSync)(input, {
+            mode: 'stdio',
+            resolveOutputDir: () => (0, index_js_3.resolveDefaultOutputDir)(server),
+        })));
+    }
+    else {
+        // HTTP モード: outputDir は除外、代わりに includePreview を受け付ける
+        server.tool(generate_pdf_sync_js_1.generatePdfSyncTool.name, generate_pdf_sync_js_1.generatePdfSyncTool.description, singlePdfSyncHttpSchema, (0, index_js_4.withTelemetry)(telemetry, generate_pdf_sync_js_1.generatePdfSyncTool.name, async (input) => (0, generate_pdf_sync_js_1.handleGeneratePdfSync)(input, { mode: 'http' })));
+    }
+    // ─── 他の filesystem-writing tools は stdio モード専用 ──────────────────
+    // generate_pdfs_sync (ZIP) と download_* は claude.ai 等のリモートクライアントから
+    // プレビュー対象にならないため、HTTP モードでは async 版のみ提供する。
+    if (mode === 'stdio') {
+        // generate_pdfs_sync (Roots-aware)
+        server.tool(generate_pdfs_sync_js_1.generatePdfsSyncTool.name, generate_pdfs_sync_js_1.generatePdfsSyncTool.description, multiplePdfSyncSchema, (0, index_js_4.withTelemetry)(telemetry, generate_pdfs_sync_js_1.generatePdfsSyncTool.name, async (input) => (0, generate_pdfs_sync_js_1.handleGeneratePdfsSync)(input, {
+            resolveOutputDir: () => (0, index_js_3.resolveDefaultOutputDir)(server),
+        })));
+        // download_file
+        server.tool(download_file_js_1.downloadFileTool.name, download_file_js_1.downloadFileTool.description, {
+            requestId: zod_1.z
+                .string()
+                .describe('generate_pdf_asyncで返されたrequestId（UUID）'),
+            fileId: zod_1.z.string().describe('generate_pdf_asyncのfiles[].fileId'),
+            fileName: zod_1.z
+                .string()
+                .optional()
+                .describe('保存ファイル名（省略時はfileId.pdf）'),
+            outputDir: outputDirSchema,
+        }, (0, index_js_4.withTelemetry)(telemetry, download_file_js_1.downloadFileTool.name, async (input) => (0, download_file_js_1.handleDownloadFile)(input)));
+        // download_zip
+        server.tool(download_zip_js_1.downloadZipTool.name, download_zip_js_1.downloadZipTool.description, {
+            requestId: zod_1.z
+                .string()
+                .describe('generate_pdfs_asyncで返されたrequestId（UUID）'),
+            fileName: zod_1.z
+                .string()
+                .optional()
+                .describe('保存ファイル名（省略時はrequestId.zip）'),
+            outputDir: outputDirSchema,
+        }, (0, index_js_4.withTelemetry)(telemetry, download_zip_js_1.downloadZipTool.name, async (input) => (0, download_zip_js_1.handleDownloadZip)(input)));
+        // generate_pdf_async は HTTP モードでは非公開化 (sync が data+fileUrl+fileId を
+        // 1 リクエストで返せるため、リモートクライアント側で async を呼び分ける合理性が
+        // 薄く、Claude がツール選択を誤る原因になる)。stdio モードでは Claude Desktop /
+        // Code 内のローカル開発で個別生成 → download_file の組み合わせを使うケースが
+        // あるため引き続き提供。
+        server.tool(generate_pdf_async_js_1.generatePdfAsyncTool.name, generate_pdf_async_js_1.generatePdfAsyncTool.description, singlePdfSchema, (0, index_js_4.withTelemetry)(telemetry, generate_pdf_async_js_1.generatePdfAsyncTool.name, async (input) => (0, generate_pdf_async_js_1.handleGeneratePdfAsync)(input)));
+    }
+    // generate_pdfs_async (両モード共通: 複数 PDF を非同期生成。
+    // 単数 sync では捌けない bulk 用途のため HTTP モードでも残す)
+    server.tool(generate_pdfs_async_js_1.generatePdfsAsyncTool.name, generate_pdfs_async_js_1.generatePdfsAsyncTool.description, multiplePdfSchema, (0, index_js_4.withTelemetry)(telemetry, generate_pdfs_async_js_1.generatePdfsAsyncTool.name, async (input) => (0, generate_pdfs_async_js_1.handleGeneratePdfsAsync)(input)));
     // suggest_params (Sampling-backed)
     server.tool(suggest_params_js_1.suggestParamsTool.name, suggest_params_js_1.suggestParamsTool.description, {
         designId: designIdSchema,
@@ -127,11 +175,20 @@ const startServer = async () => {
         description: zod_1.z
             .string()
             .describe('帳票の内容を自然文で記述（例: "請求書、宛先A社、合計1万円"）'),
-    }, async (input) => (0, suggest_params_js_1.handleSuggestParams)(server, input));
+    }, (0, index_js_4.withTelemetry)(telemetry, suggest_params_js_1.suggestParamsTool.name, async (input) => (0, suggest_params_js_1.handleSuggestParams)(server, input)));
     // Prompts (recipe cards) & Resources (read-only data) — 各 register 関数が
     // 内部で server.prompt() / server.resource() を呼んで capability を自動登録します。
     (0, index_js_1.registerPrompts)(server);
     (0, index_js_2.registerResources)(server, pkg);
+    return server;
+};
+exports.createMcpServer = createMcpServer;
+/**
+ * stdio エントリ用の従来 API。createMcpServer() で生成したインスタンスを
+ * StdioServerTransport に connect する。HTTP モードはこの関数を使わない。
+ */
+const startServer = async () => {
+    const server = (0, exports.createMcpServer)();
     const transport = new stdio_js_1.StdioServerTransport();
     await server.connect(transport);
 };

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/telemetry/client.d.ts

@@ -0,0 +1,30 @@
+export declare const TELEMETRY_SECRET_HEADER = "X-Telemetry-Secret";
+export declare const TELEMETRY_DEFAULT_TIMEOUT_MS = 2000;
+export type TelemetryPropertyValue = string | number | boolean | null | ReadonlyArray<string | number | boolean | null>;
+export type TelemetryProperties = Record<string, TelemetryPropertyValue>;
+export interface TelemetryEvent {
+    event: string;
+    userId?: string;
+    workspaceId?: string;
+    properties?: TelemetryProperties;
+    timestamp?: number;
+}
+export interface TelemetryClientOptions {
+    endpointUrl: string;
+    sharedSecret?: string;
+    timeoutMs?: number;
+    logger?: Pick<Console, 'warn'>;
+}
+export interface TelemetryClient {
+    track(event: TelemetryEvent): void;
+    /** Resolves once any spawned background sends settle (test-only). */
+    flush(): Promise<void>;
+}
+export declare const createTelemetryClient: (options: Partial<TelemetryClientOptions>) => TelemetryClient;
+/**
+ * Build a client from environment variables. Returns a no-op client when
+ * `TELEMETRY_ENDPOINT_URL` is unset so MCP usage is never impacted by
+ * misconfiguration.
+ */
+export declare const telemetryClientFromEnv: () => TelemetryClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/telemetry/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/telemetry/client.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAC5D,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,aAAa,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;AAEpD,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IACnC,qEAAqE;IACrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAkED,eAAO,MAAM,qBAAqB,GAChC,SAAS,OAAO,CAAC,sBAAsB,CAAC,KACvC,eAMF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAO,eAItC,CAAC"}

package/dist/telemetry/client.js

@@ -0,0 +1,85 @@
+"use strict";
+// Fire-and-forget HTTP client for the Report Flow event telemetry collector.
+//
+// Schema spec: developer-docs/docs/internals/event-telemetry-schema.md (PRJ-3-375).
+// TODO(PRJ-3-379): replace the locally-defined types with imports from
+// @monepla/report-flow-core/telemetry once that subpath is published.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.telemetryClientFromEnv = exports.createTelemetryClient = exports.TELEMETRY_DEFAULT_TIMEOUT_MS = exports.TELEMETRY_SECRET_HEADER = void 0;
+exports.TELEMETRY_SECRET_HEADER = 'X-Telemetry-Secret';
+exports.TELEMETRY_DEFAULT_TIMEOUT_MS = 2000;
+class NoopTelemetryClient {
+    track() { }
+    async flush() { }
+}
+class HttpTelemetryClient {
+    endpoint;
+    secret;
+    timeoutMs;
+    logger;
+    inflight = new Set();
+    constructor(opts) {
+        this.endpoint = opts.endpointUrl;
+        this.secret = opts.sharedSecret;
+        this.timeoutMs = opts.timeoutMs ?? exports.TELEMETRY_DEFAULT_TIMEOUT_MS;
+        this.logger = opts.logger ?? console;
+    }
+    track(event) {
+        const send = this.send(event);
+        this.inflight.add(send);
+        void send.finally(() => this.inflight.delete(send));
+    }
+    async flush() {
+        await Promise.allSettled(Array.from(this.inflight));
+    }
+    async send(event) {
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (this.secret)
+            headers[exports.TELEMETRY_SECRET_HEADER] = this.secret;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(this.endpoint, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(event),
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                this.logger.warn(`[telemetry] non-success response: status=${res.status} event=${event.event}`);
+            }
+        }
+        catch (err) {
+            // Captures synchronous throws from fetch (e.g., bad URL, fetch
+            // undefined in non-fetch environments) and async rejections in one
+            // place so the caller never sees a top-level Promise rejection.
+            const message = err instanceof Error ? err.message : String(err);
+            this.logger.warn(`[telemetry] send failed: ${message} event=${event.event}`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+const createTelemetryClient = (options) => {
+    const endpoint = options.endpointUrl?.trim();
+    if (!endpoint)
+        return new NoopTelemetryClient();
+    // Spread `options` first so the trimmed `endpointUrl` wins; an untrimmed
+    // copy in `options.endpointUrl` would otherwise clobber it.
+    return new HttpTelemetryClient({ ...options, endpointUrl: endpoint });
+};
+exports.createTelemetryClient = createTelemetryClient;
+/**
+ * Build a client from environment variables. Returns a no-op client when
+ * `TELEMETRY_ENDPOINT_URL` is unset so MCP usage is never impacted by
+ * misconfiguration.
+ */
+const telemetryClientFromEnv = () => (0, exports.createTelemetryClient)({
+    endpointUrl: process.env.TELEMETRY_ENDPOINT_URL,
+    sharedSecret: process.env.TELEMETRY_SHARED_SECRET,
+});
+exports.telemetryClientFromEnv = telemetryClientFromEnv;
+//# sourceMappingURL=client.js.map

package/dist/telemetry/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/telemetry/client.ts"],"names":[],"mappings":"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"}

package/dist/telemetry/index.d.ts

@@ -0,0 +1,4 @@
+export { TELEMETRY_SECRET_HEADER, TELEMETRY_DEFAULT_TIMEOUT_MS, createTelemetryClient, telemetryClientFromEnv, } from './client.js';
+export type { TelemetryClient, TelemetryClientOptions, TelemetryEvent, TelemetryProperties, TelemetryPropertyValue, } from './client.js';
+export { withTelemetry } from './interceptor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/telemetry/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withTelemetry = exports.telemetryClientFromEnv = exports.createTelemetryClient = exports.TELEMETRY_DEFAULT_TIMEOUT_MS = exports.TELEMETRY_SECRET_HEADER = void 0;
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "TELEMETRY_SECRET_HEADER", { enumerable: true, get: function () { return client_js_1.TELEMETRY_SECRET_HEADER; } });
+Object.defineProperty(exports, "TELEMETRY_DEFAULT_TIMEOUT_MS", { enumerable: true, get: function () { return client_js_1.TELEMETRY_DEFAULT_TIMEOUT_MS; } });
+Object.defineProperty(exports, "createTelemetryClient", { enumerable: true, get: function () { return client_js_1.createTelemetryClient; } });
+Object.defineProperty(exports, "telemetryClientFromEnv", { enumerable: true, get: function () { return client_js_1.telemetryClientFromEnv; } });
+var interceptor_js_1 = require("./interceptor.js");
+Object.defineProperty(exports, "withTelemetry", { enumerable: true, get: function () { return interceptor_js_1.withTelemetry; } });
+//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":";;;AAAA,yCAKqB;AAJnB,oHAAA,uBAAuB,OAAA;AACvB,yHAAA,4BAA4B,OAAA;AAC5B,kHAAA,qBAAqB,OAAA;AACrB,mHAAA,sBAAsB,OAAA;AASxB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA"}

package/dist/telemetry/interceptor.d.ts

@@ -0,0 +1,9 @@
+import type { TelemetryClient } from './client.js';
+type ToolHandler<I, R> = (input: I) => Promise<R>;
+type ToolResultLike = {
+    isError?: boolean;
+    [key: string]: unknown;
+};
+export declare const withTelemetry: <I, R extends ToolResultLike>(client: TelemetryClient, toolName: string, handler: ToolHandler<I, R>) => ToolHandler<I, R>;
+export {};
+//# sourceMappingURL=interceptor.d.ts.map

package/dist/telemetry/interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../src/telemetry/interceptor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,KAAK,WAAW,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAElD,KAAK,cAAc,GAAG;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AA0BF,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,SAAS,cAAc,EACvD,QAAQ,eAAe,EACvB,UAAU,MAAM,EAChB,SAAS,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,KACzB,WAAW,CAAC,CAAC,EAAE,CAAC,CAsClB,CAAC"}

package/dist/telemetry/interceptor.js

@@ -0,0 +1,72 @@
+"use strict";
+// Wraps MCP tool handlers with fire-and-forget telemetry.
+//
+// Emits `integration.mcp.invoked` with { tool, durationMs, success, errorClass? }
+// after every tool call (success or failure). Never mutates the handler return
+// value, so existing callers see identical behavior.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withTelemetry = void 0;
+// None of today's tool schemas declare `workspaceId` (the workspace is
+// implicit in the OAuth token / keychain entry), so this helper currently
+// returns `undefined` for every production call. Kept defensively so a
+// future tool that exposes `workspaceId` to the model surfaces it
+// automatically — and so the field can be re-pointed at the OAuth /
+// keychain auth context once that is threaded into createMcpServer
+// (Codex P2 on PR #38).
+const extractWorkspaceId = (input) => {
+    if (!input || typeof input !== 'object')
+        return undefined;
+    const value = input.workspaceId;
+    return typeof value === 'string' ? value : undefined;
+};
+const inferErrorClass = (result, error) => {
+    if (error instanceof Error)
+        return error.name || 'Error';
+    if (typeof error === 'string')
+        return 'Error';
+    const r = result;
+    if (r?.isError)
+        return 'ToolError';
+    return undefined;
+};
+const withTelemetry = (client, toolName, handler) => {
+    return async (input) => {
+        const startedAt = Date.now();
+        const workspaceId = extractWorkspaceId(input);
+        try {
+            const result = await handler(input);
+            client.track({
+                event: 'integration.mcp.invoked',
+                workspaceId,
+                // Stamp client-side ingest time so events from clock-skewed clients
+                // remain orderable in Analytics Engine (matches schema §6).
+                timestamp: Date.now(),
+                properties: {
+                    tool: toolName,
+                    durationMs: Date.now() - startedAt,
+                    success: !result.isError,
+                    ...(result.isError
+                        ? { errorClass: inferErrorClass(result, undefined) ?? 'ToolError' }
+                        : {}),
+                },
+            });
+            return result;
+        }
+        catch (err) {
+            client.track({
+                event: 'integration.mcp.invoked',
+                workspaceId,
+                timestamp: Date.now(),
+                properties: {
+                    tool: toolName,
+                    durationMs: Date.now() - startedAt,
+                    success: false,
+                    errorClass: inferErrorClass(undefined, err) ?? 'Error',
+                },
+            });
+            throw err;
+        }
+    };
+};
+exports.withTelemetry = withTelemetry;
+//# sourceMappingURL=interceptor.js.map

package/dist/telemetry/interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.js","sourceRoot":"","sources":["../../src/telemetry/interceptor.ts"],"names":[],"mappings":";AAAA,0DAA0D;AAC1D,EAAE;AACF,kFAAkF;AAClF,+EAA+E;AAC/E,qDAAqD;;;AAWrD,uEAAuE;AACvE,0EAA0E;AAC1E,uEAAuE;AACvE,kEAAkE;AAClE,oEAAoE;AACpE,mEAAmE;AACnE,wBAAwB;AACxB,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAAsB,EAAE;IAChE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,KAAK,GAAI,KAAiC,CAAC,WAAW,CAAC;IAC7D,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CACtB,MAAe,EACf,KAAc,EACM,EAAE;IACtB,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAC9C,MAAM,CAAC,GAAG,MAAoC,CAAC;IAC/C,IAAI,CAAC,EAAE,OAAO;QAAE,OAAO,WAAW,CAAC;IACnC,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEK,MAAM,aAAa,GAAG,CAC3B,MAAuB,EACvB,QAAgB,EAChB,OAA0B,EACP,EAAE;IACrB,OAAO,KAAK,EAAE,KAAQ,EAAc,EAAE;QACpC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC;gBACX,KAAK,EAAE,yBAAyB;gBAChC,WAAW;gBACX,oEAAoE;gBACpE,4DAA4D;gBAC5D,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO;oBACxB,GAAG,CAAC,MAAM,CAAC,OAAO;wBAChB,CAAC,CAAC,EAAE,UAAU,EAAE,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,WAAW,EAAE;wBACnE,CAAC,CAAC,EAAE,CAAC;iBACR;aACF,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC;gBACX,KAAK,EAAE,yBAAyB;gBAChC,WAAW;gBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,OAAO,EAAE,KAAK;oBACd,UAAU,EAAE,eAAe,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,OAAO;iBACvD;aACF,CAAC,CAAC;YACH,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC,CAAC;AA1CW,QAAA,aAAa,iBA0CxB"}

package/dist/tools/generate-pdf-sync.d.ts

@@ -8,21 +8,45 @@ export type GeneratePdfSyncInput = {
     version: number;
     content: ContentDto;
     outputDir?: string;
+    /**
+     * true を指定すると EmbeddedResource (application/pdf, base64 blob) も返却する。
+     * デフォルト false。claude.ai が PDF resource を inline 表示するように対応した
+     * 段階で true を推奨に変更する想定。
+     */
+    includePreview?: boolean;
 };
 export type GeneratePdfSyncDeps = {
     /**
-     * outputDir 未指定時に呼ばれるフォールバック。
+     * stdio: 'stdio' (デフォルト) — ローカルファイル保存 + 戻り値に filePath を含める
+     * http : 'http'  — ローカル保存をスキップ
+     */
+    mode?: 'stdio' | 'http';
+    /**
+     * outputDir 未指定時のフォールバック (stdio モード専用)。
      * server.ts で Roots を見てデフォルトディレクトリを返すために使う。
-     * 未指定の場合は client 側が process.cwd() にフォールバックする。
      */
     resolveOutputDir?: () => Promise<string | undefined>;
 };
-export type GeneratePdfSyncResult = {
-    content: [{
-        type: 'text';
-        text: string;
-    }];
+type TextContent = {
+    type: 'text';
+    text: string;
+};
+type EmbeddedResource = {
+    type: 'resource';
+    resource: {
+        uri: string;
+        mimeType: string;
+        blob: string;
+    };
+};
+/**
+ * Tool 層の戻り値型。`client.ts` の `GeneratePdfSyncResult`
+ * ({ data, filePath? }) と区別するため `Tool` を付ける。
+ */
+export type GeneratePdfSyncToolResult = {
+    content: Array<TextContent | EmbeddedResource>;
     isError?: true;
 };
-export declare const handleGeneratePdfSync: (input: GeneratePdfSyncInput, deps?: GeneratePdfSyncDeps) => Promise<GeneratePdfSyncResult>;
+export declare const handleGeneratePdfSync: (input: GeneratePdfSyncInput, deps?: GeneratePdfSyncDeps) => Promise<GeneratePdfSyncToolResult>;
+export {};
 //# sourceMappingURL=generate-pdf-sync.d.ts.map

package/dist/tools/generate-pdf-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-pdf-sync.d.ts","sourceRoot":"","sources":["../../src/tools/generate-pdf-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,UAAU,EAAE,MAAM,cAAc,CAAC;AAE3D,eAAO,MAAM,mBAAmB;;;CAI/B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,OAAO,oBAAoB,EAC3B,OAAM,mBAAwB,KAC7B,OAAO,CAAC,qBAAqB,CAmB/B,CAAC"}
+{"version":3,"file":"generate-pdf-sync.d.ts","sourceRoot":"","sources":["../../src/tools/generate-pdf-sync.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,UAAU,EAAE,MAAM,cAAc,CAAC;AAE3D,eAAO,MAAM,mBAAmB;;;CAI/B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACtD,CAAC;AAEF,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAClD,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,KAAK,CAAC,WAAW,GAAG,gBAAgB,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB,CAAC;AA0CF,eAAO,MAAM,qBAAqB,GAChC,OAAO,oBAAoB,EAC3B,OAAM,mBAAwB,KAC7B,OAAO,CAAC,yBAAyB,CAgEnC,CAAC"}