expandai 0.0.2 → 0.0.3

package/build/esm/Mcp/tools/Citations.js

@@ -5,6 +5,7 @@
 import * as Generated from '@expandai/sdk/Generated';
 import { citationUrl, playgroundBase, resolvePlaygroundHost } from '@expandai/sdk/Playground';
 import { Schema as S } from 'effect';
+export const FetchInvocationPath = S.Literal('cli-recovery', 'mcp-fetch-search');
 export class CitedSnippet extends S.Class('CitedSnippet')({
     type: S.optionalWith(S.Literal('text'), { nullable: true, default: () => 'text' }),
     source: S.Literal('markdown', 'appendix', 'statejson'),
@@ -17,6 +18,85 @@ export class CitedSnippet extends S.Class('CitedSnippet')({
     }),
 }) {
 }
+/**
+ * Carried in the tool result itself, not only in `SKILL.md`. A harness may not load
+ * skills at all, and the hook's snapshot note never reaches this path — so without
+ * this the model receives perfect `citationUrl`s and no instruction to use them, and
+ * answers with no citation. Observed on OpenCode before this was added.
+ */
+export const CITATION_INSTRUCTIONS = 'Cite every claim you take from this result. Append the ready-made `citationBlock` from this ' +
+    'result to the end of your answer. Delete every entry whose marker you did not actually place ' +
+    'in your text, and renumber what remains from [1] — an entry with no matching marker is not a ' +
+    'citation, it is clutter. Do not ' +
+    'retype the URLs, do not substitute the page you fetched, and do not build a link yourself — ' +
+    "the citation points at expand.ai's stored capture, not at the original site. Never invent an " +
+    'evidence id and never reuse one from different text. A link without `?id=` is not a citation.';
+const CitationInstructionsField = S.optionalWith(S.String, { default: () => CITATION_INSTRUCTIONS }).annotations({
+    description: 'How to cite this result back to the user. Follow it exactly.',
+});
+const CitationBlockField = S.optionalWith(S.String, { default: () => '' }).annotations({
+    description: 'Ready-to-append citation block, one entry per citable snippet. Copy it to the end of your ' +
+        'answer, keeping only the entries whose markers you placed in your text and renumbering ' +
+        'from [1]. You may also correct the page title.',
+});
+/**
+ * Prebuilds the citation markdown instead of asking the model to assemble it.
+ * Selecting `citationUrl` out of a JSON result and pasting it correctly is the step
+ * weaker models get wrong — observed repeatedly on OpenCode, which substituted the
+ * fetched page URL for the capture link. Copying one block has no such failure mode.
+ */
+const MAX_CITATION_MARKERS = 3;
+const EVIDENCE_MARKER = /\{(\d{1,6})\}/gu;
+/**
+ * Citation URLs for a plain fetch with no search. The markdown still stamps evidence
+ * ids, so a citation is always possible — without this a `fetch` called without a
+ * query produced an empty block and the model answered uncited.
+ */
+function markdownCitationUrls(markdown, snapshotId, host) {
+    const urls = [];
+    for (const match of markdown.matchAll(EVIDENCE_MARKER)) {
+        const id = Number(match[1]);
+        if (!Number.isFinite(id))
+            continue;
+        const url = citationUrl(snapshotId, { evidenceId: id }, host);
+        if (!urls.includes(url))
+            urls.push(url);
+        if (urls.length >= MAX_CITATION_MARKERS)
+            break;
+    }
+    return urls;
+}
+/**
+ * `statejson` snippets are extracted page state — arrays of routes, config blobs — not
+ * prose anyone can quote. Offering one as a citable source produced a `Sources` entry
+ * pointing at a list of URLs, so only quotable text earns a citation.
+ */
+function isQuotable(snippet) {
+    return snippet.source !== 'statejson';
+}
+function citationBlock(sourceLabel, snippets, fallback = []) {
+    const urls = [];
+    for (const snippet of snippets) {
+        if (!isQuotable(snippet))
+            continue;
+        if (snippet.citationUrl.length > 0 && !urls.includes(snippet.citationUrl))
+            urls.push(snippet.citationUrl);
+    }
+    if (urls.length === 0)
+        urls.push(...fallback);
+    if (urls.length === 0)
+        return '';
+    // One linked source line per marker.
+    // Grouping all the sources first and all the links after loses every link when a
+    // model copies only the opening lines — observed on OpenCode.
+    const lines = ['**Sources**'];
+    urls.slice(0, MAX_CITATION_MARKERS).forEach((url, index) => {
+        if (index > 0)
+            lines.push('');
+        lines.push(`[${index + 1}] [${sourceLabel}](${url})`);
+    });
+    return lines.join('\n');
+}
 export class CitedSearchResult extends S.Class('CitedSearchResult')({
     query: S.String,
     snippets: S.Array(CitedSnippet),
@@ -24,17 +104,22 @@ export class CitedSearchResult extends S.Class('CitedSearchResult')({
 }) {
 }
 export class CitedObjectModeResult extends S.Class('CitedObjectModeResult')({
+    invocationPath: S.Literal('mcp-fetch-search'),
+    citationInstructions: CitationInstructionsField,
+    citationBlock: CitationBlockField,
     meta: Generated.FetchObjectModeMeta,
     markdown: S.String,
     json: S.Array(Generated.FetchObjectModeEvidence),
     data: S.optionalWith(S.Struct({
         assets: S.optionalWith(S.Array(Generated.FetchAssetReference), { nullable: true }),
-        captureTelemetry: S.optionalWith(Generated.CaptureTelemetryInfo, { nullable: true }),
         search: S.optionalWith(CitedSearchResult, { nullable: true }),
     }), { nullable: true }),
 }) {
 }
 export class CitedSnapshotSearchResult extends S.Class('CitedSnapshotSearchResult')({
+    invocationPath: FetchInvocationPath,
+    citationInstructions: CitationInstructionsField,
+    citationBlock: CitationBlockField,
     snapshotId: S.String.pipe(S.minLength(1)),
     response: Generated.ResponseInfo,
     search: CitedSearchResult,
@@ -50,7 +135,7 @@ function toCitedSnippet(snapshotId, host, snippet) {
         json: snippet.json,
         score: snippet.score,
         location: snippet.location,
-        citationUrl: citationUrl(snapshotId, snippet.source, snippet.location, host),
+        citationUrl: citationUrl(snapshotId, snippet.location, host),
     });
 }
 function toCitedSearch(snapshotId, host, search) {
@@ -66,25 +151,41 @@ export function enrichObjectModeResult(result, fallbackHost) {
     // it is somehow not a parseable URL.
     const host = resolvePlaygroundHost(result.meta.playground, fallbackHost);
     const data = result.data;
+    const citedSearch = data?.search == null ? undefined : toCitedSearch(result.meta.snapshotId, host, data.search);
+    const block = citationBlock(result.meta.url, citedSearch?.snippets ?? [], markdownCitationUrls(result.markdown, result.meta.snapshotId, host));
     return new CitedObjectModeResult({
+        invocationPath: 'mcp-fetch-search',
+        citationInstructions: CITATION_INSTRUCTIONS,
+        citationBlock: block,
         meta: result.meta,
-        markdown: result.markdown,
+        // The block is appended to the content, not just offered as a sibling field.
+        // A model summarising `markdown` carries an inline footer through; a separate
+        // JSON field it has to notice and copy gets dropped — repeatedly, on OpenCode.
+        markdown: block.length === 0 ? result.markdown : `${result.markdown.trimEnd()}\n\n---\n\n${block}\n`,
         json: result.json,
         data: data == null
             ? data
             : {
                 assets: data.assets,
-                captureTelemetry: data.captureTelemetry,
-                search: data.search == null ? data.search : toCitedSearch(result.meta.snapshotId, host, data.search),
+                search: citedSearch,
             },
     });
 }
-/** Add `citationUrl` to each snippet of a snapshot-search result (no server `meta.playground`). */
-export function enrichSnapshotSearchResult(result, host) {
+/** Add `citationUrl` to each snippet of a snapshot-search result. */
+export function enrichSnapshotSearchResult(result, fallbackHost, invocationPath = 'mcp-fetch-search') {
+    // `playground` is server-resolved (staging-safe), exactly like `meta.playground`
+    // above; fall back to the configured host only if it is somehow not a parseable
+    // URL. The playground is a separate deployment from the API, so the server is
+    // the only component that can say where its snapshots are publicly served.
+    const host = resolvePlaygroundHost(result.playground, fallbackHost);
+    const citedSearch = toCitedSearch(result.snapshotId, host, result.search);
     return new CitedSnapshotSearchResult({
+        invocationPath,
+        citationInstructions: CITATION_INSTRUCTIONS,
+        citationBlock: citationBlock(result.response.url, citedSearch.snippets),
         snapshotId: result.snapshotId,
         response: result.response,
-        search: toCitedSearch(result.snapshotId, host, result.search),
+        search: citedSearch,
         durationMs: result.durationMs,
         playground: playgroundBase(result.snapshotId, host),
     });

package/build/esm/Mcp/tools/Citations.js.map

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

package/build/esm/Mcp/tools/Fetch.js

@@ -2,6 +2,7 @@ import { Tool } from '@effect/ai';
 import { Effect, Schema, String } from 'effect';
 import { ApiClient } from '../../ApiClient.js';
 import { ConfigManager } from '../../Config.js';
+import { Telemetry } from '../../Telemetry.js';
 import { CitedObjectModeResult, CitedSnapshotSearchResult, enrichObjectModeResult, enrichSnapshotSearchResult, } from './Citations.js';
 export class FetchSearchParams extends Schema.Class('FetchSearchParams')({
     query: Schema.NonEmptyTrimmedString.annotations({
@@ -63,11 +64,15 @@ export const FetchTool = Tool.make('fetch', {
     description: String.stripMargin(`
 		|Fetch and extract content from any URL.
 		|
+		|You MUST cite what you take from the result. The result carries a ready-made
+		|'citationBlock' — append it verbatim to the end of your answer. Do not retype it, do not
+		|substitute the URL you fetched, and do not build a link yourself: the citation points at
+		|expand.ai's stored capture, not at the original site. Drop only the markers you did not use.
+		|A 'Verify it' link without '?id=' is not a citation. Never invent or reuse an evidence id.
+		|
 		|Returns object-mode output with markdown, front-matter metadata, and optional extracted JSON.
 		|When 'search' is set, the response also carries ranked snippets under data.search.snippets.
-		|Each snippet has a 'citationUrl' — a public playground link auditing that exact passage — and,
-		|for State JSON sources, the extracted 'json' value. Return the citationUrl to the user so they
-		|can verify the source.`),
+		|For State JSON sources each snippet also carries the extracted 'json' value.`),
     parameters: FetchParams.fields,
     success: CitedObjectModeResult,
     failure: Schema.Defect,
@@ -79,10 +84,15 @@ export const FetchSearchTool = Tool.make('fetch_search', {
     description: String.stripMargin(`
 		|Search a previous fetch by snapshotId without starting a new capture.
 		|
-		|Returns ranked snippets from stored markdown, appendix, or State JSON artifacts. Each snippet
-		|has a 'citationUrl' — a public playground link auditing that exact passage — and, for State JSON
-		|sources, the extracted 'json' value. The result also includes a whole-snapshot 'playground' link.
-		|Return the citationUrl to the user so they can verify the source.`),
+		|You MUST cite what you take from the result. The result carries a ready-made
+		|'citationBlock' — append it verbatim to the end of your answer. Do not retype it, do not
+		|substitute the URL you fetched, and do not build a link yourself: the citation points at
+		|expand.ai's stored capture, not at the original site. Drop only the markers you did not use.
+		|A 'Verify it' link without '?id=' is not a citation. Never invent or reuse an evidence id.
+		|
+		|Returns ranked snippets from stored markdown, appendix, or State JSON artifacts. For State JSON
+		|sources each snippet also carries the extracted 'json' value. The result also includes a
+		|whole-snapshot 'playground' link.`),
     parameters: FetchSnapshotSearchParams.fields,
     success: CitedSnapshotSearchResult,
     failure: Schema.Defect,
@@ -91,13 +101,21 @@ export const FetchSearchTool = Tool.make('fetch_search', {
     .annotate(Tool.Readonly, true)
     .annotate(Tool.Destructive, false);
 export class Fetch extends Effect.Service()('@expandai/cli/Mcp/Fetch', {
-    dependencies: [ApiClient.Default, ConfigManager.Default],
+    dependencies: [ApiClient.Default, ConfigManager.Default, Telemetry.Default],
     scoped: Effect.gen(function* () {
         const client = yield* ApiClient;
         const configManager = yield* ConfigManager;
+        const telemetry = yield* Telemetry;
         const playgroundHost = yield* configManager.getPlaygroundHost();
         const fetch = Effect.fn('Fetch.fetch')(function* ({ url, search, includeMeta, includeAppendix, includeJson, }) {
-            yield* Effect.logDebug(`Fetching: ${url}`).pipe(Effect.annotateLogs({ search: search?.query, includeMeta, includeAppendix, includeJson }));
+            yield* Effect.logDebug('MCP fetch started').pipe(Effect.annotateLogs({
+                operation: 'fetch',
+                hasSearch: search !== undefined,
+                includeMeta,
+                includeAppendix,
+                includeJson,
+            }));
+            yield* telemetry.capture('mcp_tool_called', { tool: 'fetch', has_search: search !== undefined });
             const includeParam = includeAppendix && includeJson
                 ? 'appendix,statejson'
                 : includeAppendix
@@ -118,11 +136,17 @@ export class Fetch extends Effect.Service()('@expandai/cli/Mcp/Fetch', {
                     search,
                 },
             });
-            yield* Effect.logDebug(`Fetched successfully: ${result.meta.url}`);
+            yield* Effect.logDebug('MCP fetch completed').pipe(Effect.annotateLogs({
+                operation: 'fetch',
+                hasSearch: search !== undefined,
+                searchResultCount: result.data?.search?.snippets.length ?? 0,
+                jsonEvidenceCount: result.json.length,
+            }));
             return enrichObjectModeResult(result, playgroundHost);
         });
         const fetchSearch = Effect.fn('Fetch.fetchSearch')(function* ({ snapshotId, search, includeMarkdown, includeAppendix, includeJson, }) {
-            yield* Effect.logDebug(`Searching fetch snapshot: ${snapshotId}`).pipe(Effect.annotateLogs({ search: search.query, includeMarkdown, includeAppendix, includeJson }));
+            yield* Effect.logDebug('MCP snapshot search started').pipe(Effect.annotateLogs({ operation: 'fetch_search', includeMarkdown, includeAppendix, includeJson }));
+            yield* telemetry.capture('mcp_tool_called', { tool: 'fetch_search', has_search: true });
             const result = yield* client.fetchFetchSearch({
                 snapshotId,
                 search,
@@ -132,7 +156,7 @@ export class Fetch extends Effect.Service()('@expandai/cli/Mcp/Fetch', {
                     appendix: includeAppendix,
                 },
             });
-            return enrichSnapshotSearchResult(result, playgroundHost);
+            return enrichSnapshotSearchResult(result, playgroundHost, 'mcp-fetch-search');
         });
         return { fetch, fetchSearch };
     }),

package/build/esm/Mcp/tools/Fetch.js.map

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

package/build/esm/SecureFile.js

@@ -0,0 +1,36 @@
+import { Effect, Exit, Option } from 'effect';
+/** Creates a file exclusively and binds its identity to the opened handle before writing bytes. */
+export function createExclusiveFile(fileSystem, targetPath, contents, mode) {
+    return Effect.scoped(Effect.gen(function* () {
+        const file = yield* fileSystem.open(targetPath, { flag: 'wx', mode });
+        const info = yield* file.stat;
+        const identity = {
+            dev: info.dev,
+            ino: Option.getOrUndefined(info.ino),
+            mode: info.mode,
+            type: info.type,
+        };
+        const writeExit = yield* Effect.exit(file.writeAll(new TextEncoder().encode(contents)).pipe(Effect.zipRight(file.sync)));
+        if (Exit.isFailure(writeExit))
+            return { identity, writeExit, pathMatchesHandle: false };
+        // Validate while the creating handle is still open. In particular, Windows
+        // may reuse a deleted file's numeric identifier immediately after its final
+        // handle closes, making a later pathname-only comparison ambiguous.
+        const pathInfo = yield* fileSystem.stat(targetPath);
+        const pathMatchesHandle = matchesCreatedFile(identity, {
+            exists: true,
+            dev: pathInfo.dev,
+            ino: Option.getOrUndefined(pathInfo.ino),
+            type: pathInfo.type,
+        });
+        return { identity, writeExit, pathMatchesHandle };
+    }));
+}
+/** Compares a pathname snapshot with identity captured from the creating file handle. */
+export function matchesCreatedFile(identity, pathIdentity) {
+    return (pathIdentity.exists &&
+        pathIdentity.dev === identity.dev &&
+        pathIdentity.ino === identity.ino &&
+        pathIdentity.type === identity.type);
+}
+//# sourceMappingURL=SecureFile.js.map

package/build/esm/SecureFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecureFile.js","sourceRoot":"","sources":["../../src/SecureFile.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAe7C,mGAAmG;AACnG,MAAM,UAAU,mBAAmB,CAClC,UAAiC,EACjC,UAAkB,EAClB,QAAgB,EAChB,IAAY;IAEZ,OAAO,MAAM,CAAC,MAAM,CACnB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACrE,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAA;QAC7B,MAAM,QAAQ,GAAwB;YACrC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC;YACpC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;SACf,CAAA;QACD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACnC,IAAI,CAAC,QAAQ,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAClF,CAAA;QACD,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAW,CAAA;QAEhG,2EAA2E;QAC3E,4EAA4E;QAC5E,oEAAoE;QACpE,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACnD,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,QAAQ,EAAE;YACtD,MAAM,EAAE,IAAI;YACZ,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,GAAG,EAAE,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC;YACxC,IAAI,EAAE,QAAQ,CAAC,IAAI;SACnB,CAAC,CAAA;QACF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,iBAAiB,EAAW,CAAA;IAC3D,CAAC,CAAC,CACF,CAAA;AACF,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,kBAAkB,CACjC,QAA6B,EAC7B,YAKC;IAED,OAAO,CACN,YAAY,CAAC,MAAM;QACnB,YAAY,CAAC,GAAG,KAAK,QAAQ,CAAC,GAAG;QACjC,YAAY,CAAC,GAAG,KAAK,QAAQ,CAAC,GAAG;QACjC,YAAY,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CACnC,CAAA;AACF,CAAC"}

package/build/esm/Snippets.js

@@ -1,6 +1,17 @@
 import { citationUrl } from '@expandai/sdk/Playground';
 import { Schema } from 'effect';
 const encodeJson = Schema.encodeSync(Schema.parseJson(Schema.Unknown, { space: 2 }));
+/**
+ * Attaches the public citation link to each snippet. JSON consumers get the same
+ * auditable URL the text renderer prints in its header — without it, a caller has
+ * the snapshot and the evidence id but no host to build a link against.
+ */
+export function withCitationUrls(snapshotId, host, snippets) {
+    return snippets.map((snippet) => ({
+        ...snippet,
+        citationUrl: citationUrl(snapshotId, snippet.location, host),
+    }));
+}
 /**
  * Render search snippets as auditable text blocks: a header carrying the source, score, and
  * citation link, the snippet text, and — for State JSON snippets — the extracted JSON value.
@@ -8,7 +19,7 @@ const encodeJson = Schema.encodeSync(Schema.parseJson(Schema.Unknown, { space: 2
 export function renderSnippets(snapshotId, host, snippets) {
     return snippets
         .map((snippet) => {
-        const url = citationUrl(snapshotId, snippet.source, snippet.location, host);
+        const url = citationUrl(snapshotId, snippet.location, host);
         const header = `[${snippet.source} · score ${snippet.score.toFixed(2)}] ${url}`;
         const json = snippet.json == null ? '' : `\n\n${encodeJson(snippet.json)}`;
         return `${header}\n\n${snippet.text}${json}`;

package/build/esm/Snippets.js.map

@@ -1 +1 @@
-{"version":3,"file":"Snippets.js","sourceRoot":"","sources":["../../src/Snippets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AAepF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,IAAY,EAAE,QAA0C;IAC1G,OAAO,QAAQ;SACb,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAChB,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC3E,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC,MAAM,YAAY,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAA;QAC/E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAA;QAC1E,OAAO,GAAG,MAAM,OAAO,OAAO,CAAC,IAAI,GAAG,IAAI,EAAE,CAAA;IAC7C,CAAC,CAAC;SACD,IAAI,CAAC,aAAa,CAAC,CAAA;AACtB,CAAC"}
+{"version":3,"file":"Snippets.js","sourceRoot":"","sources":["../../src/Snippets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AAKpF;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC/B,UAAkB,EAClB,IAAY,EACZ,QAA0B;IAE1B,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjC,GAAG,OAAO;QACV,WAAW,EAAE,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;KAC5D,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,IAAY,EAAE,QAA0C;IAC1G,OAAO,QAAQ;SACb,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAChB,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC3D,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC,MAAM,YAAY,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAA;QAC/E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAA;QAC1E,OAAO,GAAG,MAAM,OAAO,OAAO,CAAC,IAAI,GAAG,IAAI,EAAE,CAAA;IAC7C,CAAC,CAAC;SACD,IAAI,CAAC,aAAa,CAAC,CAAA;AACtB,CAAC"}

package/build/esm/Telemetry.js

@@ -0,0 +1,157 @@
+/**
+ * Anonymous usage telemetry (PostHog). Events carry a persisted machine UUID,
+ * the invoking harness, and coarse feature usage — never URLs, queries,
+ * keys, or tokens.
+ *
+ * Delivery is fire-and-forget: each capture forks into a FiberSet and `flush`
+ * caps shutdown at one second, so telemetry can never block a command, delay
+ * an MCP/hook payload, or write to stdout (stdout is a protocol surface).
+ *
+ * Settings live in the config file (`telemetry.enabled` / `distinctId` /
+ * `noticeShown`). `DO_NOT_TRACK` / `EXPANDAI_NO_TELEMETRY`, or a non-default
+ * effective API URL (env or config file — dev traffic), disable capture per
+ * invocation without touching the file. A config file that fails to parse
+ * also disables telemetry for the invocation and is never written to.
+ */
+import { randomUUID } from 'node:crypto';
+import { HttpClient, HttpClientRequest } from '@effect/platform';
+import { NodeHttpClient } from '@effect/platform-node';
+import { Config, Console, Effect, FiberSet, Layer, Option } from 'effect';
+import { ConfigManager, DEFAULT_API_URL, envFlag, envLiteral } from './Config.js';
+import { Harness } from './Install/Domain.js';
+import { CLI_VERSION } from './Version.js';
+// Every field reads leniently (envFlag / envLiteral / plain strings) so a
+// malformed env var can never fail service construction — telemetry must
+// silently degrade, not crash the CLI.
+export const TelemetryEnvironment = Config.all({
+    // PostHog project write-only key — safe to embed as the default (it ships
+    // in every browser bundle that uses posthog-js) and only permits ingestion.
+    apiKey: Config.string('POSTHOG_API_KEY').pipe(Config.withDefault('phc_sffcV4skT33mMKmo0BenNoE7t7AghUrOugyW9qSx43B')),
+    host: Config.string('POSTHOG_HOST').pipe(Config.withDefault('https://us.i.posthog.com')),
+    doNotTrack: envFlag('DO_NOT_TRACK'),
+    noTelemetry: envFlag('EXPANDAI_NO_TELEMETRY'),
+    apiUrl: Config.string('EXPAND_API_URL').pipe(Config.option),
+    // Baked into MCP/hook configs at install time; wins over ambient signals.
+    // An unrecognized value (e.g. written by a newer installer) reads as None.
+    harnessOverride: envLiteral('EXPANDAI_HARNESS', Harness),
+    claudeCode: envFlag('CLAUDECODE'),
+    cursor: Config.string('CURSOR_TRACE_ID').pipe(Config.option, Config.map(Option.isSome)),
+    codex: Config.string('CODEX_RUN_ID').pipe(Config.option, Config.map(Option.isSome)),
+});
+function detectHarness(environment) {
+    if (Option.isSome(environment.harnessOverride))
+        return environment.harnessOverride.value;
+    if (environment.claudeCode)
+        return 'claude-code';
+    if (environment.cursor)
+        return 'cursor';
+    if (environment.codex)
+        return 'codex';
+    return 'unknown';
+}
+const generateDistinctId = Effect.sync(() => randomUUID());
+// Lenient normalization for the non-default-API comparison: `new URL()` adds
+// the trailing slash a bare origin string lacks, and a value that doesn't
+// parse compares as non-default — never crash construction, and treat unknown
+// endpoints as non-production traffic.
+function normalizeApiUrl(url) {
+    try {
+        return new URL(url).toString();
+    }
+    catch {
+        return `unparseable:${url}`;
+    }
+}
+export class Telemetry extends Effect.Service()('@expandai/cli/Telemetry', {
+    dependencies: [ConfigManager.Default, NodeHttpClient.layer],
+    scoped: Effect.gen(function* () {
+        const configManager = yield* ConfigManager;
+        const httpClient = yield* HttpClient.HttpClient;
+        const fibers = yield* FiberSet.make();
+        const environment = yield* TelemetryEnvironment;
+        // EXPAND_API_KEY overrides the config file for requests (see ConfigManager),
+        // so it must win here too or env-key users all report 'none'.
+        const envApiKey = yield* Config.string('EXPAND_API_KEY').pipe(Config.option, Config.map(Option.isSome));
+        // The config file is read best-effort: telemetry must work (or silently
+        // no-op) before login and survive an unreadable config. A parse failure
+        // disables capture for the invocation — an unreadable file must never be
+        // mistaken for an empty one, and never be written to.
+        const { config, parseFailed } = yield* configManager.readConfigFile();
+        const settings = config.telemetry;
+        // Same env-over-file precedence as ConfigManager: a self-hosted apiUrl in
+        // the config file is dev traffic too. Deliberately not Config.url /
+        // getApiUrl — those fail on a malformed env value, and telemetry must
+        // degrade instead of crashing the CLI.
+        const effectiveApiUrl = Option.firstSomeOf([
+            environment.apiUrl,
+            Option.map(Option.fromNullable(config.apiUrl), (url) => url.toString()),
+        ]);
+        const nonDefaultApi = Option.match(effectiveApiUrl, {
+            onNone: () => false,
+            onSome: (url) => normalizeApiUrl(url) !== normalizeApiUrl(DEFAULT_API_URL),
+        });
+        const enabled = !environment.doNotTrack &&
+            !environment.noTelemetry &&
+            !nonDefaultApi &&
+            !parseFailed &&
+            settings?.enabled !== false;
+        const harness = detectHarness(environment);
+        const authMethod = envApiKey
+            ? 'api-key'
+            : config.authMethod?._tag === 'ApiKey'
+                ? 'api-key'
+                : config.authMethod?._tag === 'OAuth'
+                    ? 'oauth'
+                    : 'none';
+        const persistNewDistinctId = Effect.fnUntraced(function* () {
+            const generated = yield* generateDistinctId;
+            // Best-effort persistence — an unwritable config yields a per-run id.
+            yield* configManager.updateConfig({ telemetry: { ...settings, distinctId: generated } }).pipe(Effect.ignore);
+            return generated;
+        });
+        // Disabled runs never write: DO_NOT_TRACK users don't get an id persisted,
+        // and after a parse failure a write would clobber the original file.
+        const distinctId = settings?.distinctId ?? (enabled ? yield* persistNewDistinctId() : yield* generateDistinctId);
+        const capture = Effect.fn('Telemetry.capture')(function* (event, properties) {
+            if (!enabled)
+                return;
+            const post = HttpClientRequest.post(`${environment.host}/i/v0/e`).pipe(HttpClientRequest.bodyJson({
+                api_key: environment.apiKey,
+                event,
+                distinct_id: distinctId,
+                timestamp: new Date().toISOString(),
+                properties: {
+                    $lib: 'expandai-cli',
+                    $lib_version: CLI_VERSION,
+                    version: CLI_VERSION,
+                    harness,
+                    auth_method: authMethod,
+                    ...properties,
+                },
+            }));
+            yield* FiberSet.run(fibers, post.pipe(Effect.flatMap((request) => httpClient.execute(request)), Effect.scoped, Effect.timeout('2 seconds'), Effect.ignore));
+        });
+        // Cap delivery at flush time so short-lived processes get events out
+        // without ever holding the process open noticeably.
+        const flush = FiberSet.awaitEmpty(fibers).pipe(Effect.timeout('1 second'), Effect.ignore);
+        const showNoticeIfNeeded = Effect.fn('Telemetry.showNoticeIfNeeded')(function* () {
+            if (!enabled || settings?.noticeShown === true)
+                return;
+            yield* Console.error('expandai collects anonymous usage data to improve the CLI. Opt out with `expandai telemetry disable` or EXPANDAI_NO_TELEMETRY=1.');
+            yield* configManager
+                .updateConfig({ telemetry: { ...settings, distinctId, noticeShown: true } })
+                .pipe(Effect.ignore);
+        });
+        return { capture, flush, showNoticeIfNeeded, enabled, distinctId };
+    }),
+}) {
+    /** A side-effect-free telemetry service for commands whose contract is read-only. */
+    static DISABLED = Layer.succeed(Telemetry, Telemetry.make({
+        capture: () => Effect.void,
+        flush: Effect.void,
+        showNoticeIfNeeded: () => Effect.void,
+        enabled: false,
+        distinctId: 'disabled',
+    }));
+}
+//# sourceMappingURL=Telemetry.js.map

package/build/esm/Telemetry.js.map

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

package/build/esm/Version.js

@@ -0,0 +1,4 @@
+// Single source of truth for the CLI version. Keep in sync with package.json —
+// the compiled binary cannot read package.json at runtime.
+export const CLI_VERSION = '0.0.3';
+//# sourceMappingURL=Version.js.map

package/build/esm/Version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Version.js","sourceRoot":"","sources":["../../src/Version.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAA"}

package/build/esm/Xdg.js

@@ -0,0 +1,15 @@
+import { homedir } from 'node:os';
+import { Path } from '@effect/platform';
+import { Config, Effect } from 'effect';
+/**
+ * XDG base-directory lookup, shared by everything that persists CLI state so
+ * the fallback rules cannot drift apart. The spec treats an unset and an empty
+ * variable identically: fall back to `$HOME/.config`. Without the empty check,
+ * `XDG_CONFIG_HOME=` resolves paths relative to the working directory — which
+ * would drop credentials inside whatever project the CLI happens to run in.
+ */
+export const xdgConfigDirectory = Effect.gen(function* () {
+    const path = yield* Path.Path;
+    return yield* Config.string('XDG_CONFIG_HOME').pipe(Config.withDefault(''), Config.map((directory) => (directory.trim() === '' ? path.join(homedir(), '.config') : directory)));
+});
+//# sourceMappingURL=Xdg.js.map

package/build/esm/Xdg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Xdg.js","sourceRoot":"","sources":["../../src/Xdg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEvC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IACrD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAA;IAC7B,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAClD,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,EACtB,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAClG,CAAA;AACF,CAAC,CAAC,CAAA"}