expandai 0.0.0 → 0.0.2

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

@@ -0,0 +1,92 @@
+// MCP-facing result wrappers that add a ready-made `citationUrl` to every search snippet, so the
+// agent can hand the user an auditable playground link without assembling URLs itself. Wraps the
+// SDK's `json`-recovering decode types (`@expandai/sdk/FetchJson`) and reuses generated leaf
+// schemas; `Generated.ts` is left untouched.
+import * as Generated from '@expandai/sdk/Generated';
+import { citationUrl, playgroundBase, resolvePlaygroundHost } from '@expandai/sdk/Playground';
+import { Schema as S } from 'effect';
+export class CitedSnippet extends S.Class('CitedSnippet')({
+    type: S.optionalWith(S.Literal('text'), { nullable: true, default: () => 'text' }),
+    source: S.Literal('markdown', 'appendix', 'statejson'),
+    text: S.String,
+    json: S.optionalWith(S.Unknown, { nullable: true }),
+    score: S.Number.pipe(S.greaterThanOrEqualTo(0), S.lessThanOrEqualTo(1)),
+    location: S.optionalWith(Generated.FetchSearchSnippetLocation, { nullable: true }),
+    citationUrl: S.String.annotations({
+        description: 'Public playground link auditing this exact snippet. Return it to the user verbatim.',
+    }),
+}) {
+}
+export class CitedSearchResult extends S.Class('CitedSearchResult')({
+    query: S.String,
+    snippets: S.Array(CitedSnippet),
+    meta: S.optionalWith(Generated.FetchSearchMeta, { nullable: true }),
+}) {
+}
+export class CitedObjectModeResult extends S.Class('CitedObjectModeResult')({
+    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')({
+    snapshotId: S.String.pipe(S.minLength(1)),
+    response: Generated.ResponseInfo,
+    search: CitedSearchResult,
+    durationMs: S.Number.pipe(S.greaterThanOrEqualTo(0)),
+    playground: S.String.annotations({ description: 'Public playground link for the whole snapshot.' }),
+}) {
+}
+function toCitedSnippet(snapshotId, host, snippet) {
+    return new CitedSnippet({
+        type: snippet.type,
+        source: snippet.source,
+        text: snippet.text,
+        json: snippet.json,
+        score: snippet.score,
+        location: snippet.location,
+        citationUrl: citationUrl(snapshotId, snippet.source, snippet.location, host),
+    });
+}
+function toCitedSearch(snapshotId, host, search) {
+    return new CitedSearchResult({
+        query: search.query,
+        snippets: search.snippets.map((snippet) => toCitedSnippet(snapshotId, host, snippet)),
+        meta: search.meta,
+    });
+}
+/** Add `citationUrl` to each snippet of an object-mode fetch result. */
+export function enrichObjectModeResult(result, fallbackHost) {
+    // `meta.playground` is server-resolved (staging-safe); fall back to the configured host only if
+    // it is somehow not a parseable URL.
+    const host = resolvePlaygroundHost(result.meta.playground, fallbackHost);
+    const data = result.data;
+    return new CitedObjectModeResult({
+        meta: result.meta,
+        markdown: result.markdown,
+        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),
+            },
+    });
+}
+/** Add `citationUrl` to each snippet of a snapshot-search result (no server `meta.playground`). */
+export function enrichSnapshotSearchResult(result, host) {
+    return new CitedSnapshotSearchResult({
+        snapshotId: result.snapshotId,
+        response: result.response,
+        search: toCitedSearch(result.snapshotId, host, result.search),
+        durationMs: result.durationMs,
+        playground: playgroundBase(result.snapshotId, host),
+    });
+}
+//# sourceMappingURL=Citations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Citations.js","sourceRoot":"","sources":["../../../../src/Mcp/tools/Citations.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,iGAAiG;AACjG,6FAA6F;AAC7F,6CAA6C;AAG7C,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAC7F,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,QAAQ,CAAA;AAEpC,MAAM,OAAO,YAAa,SAAQ,CAAC,CAAC,KAAK,CAAe,cAAc,CAAC,CAAC;IACvE,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAe,EAAE,CAAC;IAC3F,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC;IACtD,IAAI,EAAE,CAAC,CAAC,MAAM;IACd,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACnD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACvE,QAAQ,EAAE,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,0BAA0B,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAClF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;QACjC,WAAW,EAAE,qFAAqF;KAClG,CAAC;CACF,CAAC;CAAG;AAEL,MAAM,OAAO,iBAAkB,SAAQ,CAAC,CAAC,KAAK,CAAoB,mBAAmB,CAAC,CAAC;IACtF,KAAK,EAAE,CAAC,CAAC,MAAM;IACf,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;CACnE,CAAC;CAAG;AAEL,MAAM,OAAO,qBAAsB,SAAQ,CAAC,CAAC,KAAK,CAAwB,uBAAuB,CAAC,CAAC;IAClG,IAAI,EAAE,SAAS,CAAC,mBAAmB;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM;IAClB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,uBAAuB,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,YAAY,CACnB,CAAC,CAAC,MAAM,CAAC;QACR,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,mBAAmB,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAClF,gBAAgB,EAAE,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACpF,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KAC7D,CAAC,EACF,EAAE,QAAQ,EAAE,IAAI,EAAE,CAClB;CACD,CAAC;CAAG;AAEL,MAAM,OAAO,yBAA0B,SAAQ,CAAC,CAAC,KAAK,CAA4B,2BAA2B,CAAC,CAAC;IAC9G,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACzC,QAAQ,EAAE,SAAS,CAAC,YAAY;IAChC,MAAM,EAAE,iBAAiB;IACzB,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACpD,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,gDAAgD,EAAE,CAAC;CACnG,CAAC;CAAG;AAKL,SAAS,cAAc,CAAC,UAAkB,EAAE,IAAY,EAAE,OAAwB;IACjF,OAAO,IAAI,YAAY,CAAC;QACvB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;KAC5E,CAAC,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CAAC,UAAkB,EAAE,IAAY,EAAE,MAA4B;IACpF,OAAO,IAAI,iBAAiB,CAAC;QAC5B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACrF,IAAI,EAAE,MAAM,CAAC,IAAI;KACjB,CAAC,CAAA;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,sBAAsB,CACrC,MAAqC,EACrC,YAAoB;IAEpB,gGAAgG;IAChG,qCAAqC;IACrC,MAAM,IAAI,GAAG,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;IACxE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IACxB,OAAO,IAAI,qBAAqB,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EACH,IAAI,IAAI,IAAI;YACX,CAAC,CAAC,IAAI;YACN,CAAC,CAAC;gBACA,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;gBACvC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;aACpG;KACJ,CAAC,CAAA;AACH,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,0BAA0B,CACzC,MAAyC,EACzC,IAAY;IAEZ,OAAO,IAAI,yBAAyB,CAAC;QACpC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;QAC7D,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC;KACnD,CAAC,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,141 @@
+import { Tool } from '@effect/ai';
+import { Effect, Schema, String } from 'effect';
+import { ApiClient } from '../../ApiClient.js';
+import { ConfigManager } from '../../Config.js';
+import { CitedObjectModeResult, CitedSnapshotSearchResult, enrichObjectModeResult, enrichSnapshotSearchResult, } from './Citations.js';
+export class FetchSearchParams extends Schema.Class('FetchSearchParams')({
+    query: Schema.NonEmptyTrimmedString.annotations({
+        description: 'Search query. When provided, fetch returns search results only.',
+    }),
+    maxResults: Schema.optionalWith(Schema.Int.pipe(Schema.between(1, 50)), { default: () => 5 }).annotations({
+        description: 'Maximum snippets to return.',
+        default: 5,
+    }),
+    minScore: Schema.optionalWith(Schema.Number.pipe(Schema.between(0, 1)), { default: () => 0 }).annotations({
+        description: 'Minimum snippet relevance score from 0 to 1.',
+        default: 0,
+    }),
+}) {
+}
+export class FetchParams extends Schema.Class('FetchParams')({
+    url: Schema.String.annotations({
+        description: 'The URL to fetch content from',
+    }),
+    search: Schema.optional(FetchSearchParams).annotations({
+        description: 'Semantic search configuration. When provided, the API returns snippets under data.search.snippets.',
+    }),
+    includeMeta: Schema.optionalWith(Schema.Boolean, { default: () => false }).annotations({
+        description: 'Include page meta tags (title, description, Open Graph)',
+        default: false,
+    }),
+    includeAppendix: Schema.optionalWith(Schema.Boolean, { default: () => false }).annotations({
+        description: 'Include extracted links and sidebar content',
+        default: false,
+    }),
+    includeJson: Schema.optionalWith(Schema.Boolean, { default: () => true }).annotations({
+        description: 'Include JSON extracted from network responses and DOM',
+        default: true,
+    }),
+}) {
+}
+export class FetchSnapshotSearchParams extends Schema.Class('FetchSnapshotSearchParams')({
+    snapshotId: Schema.NonEmptyString.annotations({
+        description: 'Snapshot ID returned by a previous fetch response.',
+    }),
+    search: FetchSearchParams.annotations({
+        description: 'Semantic search configuration. Returns snippets from stored fetch artifacts.',
+    }),
+    includeMarkdown: Schema.optionalWith(Schema.Boolean, { default: () => true }).annotations({
+        description: 'Search the stored markdown corpus.',
+        default: true,
+    }),
+    includeAppendix: Schema.optionalWith(Schema.Boolean, { default: () => false }).annotations({
+        description: 'Search extracted appendix content.',
+        default: false,
+    }),
+    includeJson: Schema.optionalWith(Schema.Boolean, { default: () => true }).annotations({
+        description: 'Search stored State JSON.',
+        default: true,
+    }),
+}) {
+}
+export const FetchTool = Tool.make('fetch', {
+    description: String.stripMargin(`
+		|Fetch and extract content from any URL.
+		|
+		|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.`),
+    parameters: FetchParams.fields,
+    success: CitedObjectModeResult,
+    failure: Schema.Defect,
+    failureMode: 'return',
+})
+    .annotate(Tool.Readonly, true)
+    .annotate(Tool.Destructive, false);
+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.`),
+    parameters: FetchSnapshotSearchParams.fields,
+    success: CitedSnapshotSearchResult,
+    failure: Schema.Defect,
+    failureMode: 'return',
+})
+    .annotate(Tool.Readonly, true)
+    .annotate(Tool.Destructive, false);
+export class Fetch extends Effect.Service()('@expandai/cli/Mcp/Fetch', {
+    dependencies: [ApiClient.Default, ConfigManager.Default],
+    scoped: Effect.gen(function* () {
+        const client = yield* ApiClient;
+        const configManager = yield* ConfigManager;
+        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 }));
+            const includeParam = includeAppendix && includeJson
+                ? 'appendix,statejson'
+                : includeAppendix
+                    ? 'appendix'
+                    : includeJson
+                        ? undefined
+                        : '';
+            const result = yield* client.fetchFetchJson({
+                params: { include: includeParam },
+                payload: {
+                    url,
+                    include: {
+                        markdown: true,
+                        meta: includeMeta,
+                        json: includeJson,
+                        appendix: includeAppendix,
+                    },
+                    search,
+                },
+            });
+            yield* Effect.logDebug(`Fetched successfully: ${result.meta.url}`);
+            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 }));
+            const result = yield* client.fetchFetchSearch({
+                snapshotId,
+                search,
+                include: {
+                    markdown: includeMarkdown,
+                    json: includeJson,
+                    appendix: includeAppendix,
+                },
+            });
+            return enrichSnapshotSearchResult(result, playgroundHost);
+        });
+        return { fetch, fetchSearch };
+    }),
+}) {
+}
+//# sourceMappingURL=Fetch.js.map

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

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

package/build/esm/Snippets.js

@@ -0,0 +1,18 @@
+import { citationUrl } from '@expandai/sdk/Playground';
+import { Schema } from 'effect';
+const encodeJson = Schema.encodeSync(Schema.parseJson(Schema.Unknown, { space: 2 }));
+/**
+ * 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.
+ */
+export function renderSnippets(snapshotId, host, snippets) {
+    return snippets
+        .map((snippet) => {
+        const url = citationUrl(snapshotId, snippet.source, 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}`;
+    })
+        .join('\n\n---\n\n');
+}
+//# sourceMappingURL=Snippets.js.map

package/build/esm/Snippets.js.map

@@ -0,0 +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"}

package/build/esm/index.js

@@ -0,0 +1,2 @@
+export * from './Mcp/Server.js';
+//# sourceMappingURL=index.js.map

package/build/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA"}

package/build/esm/main.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+import { CliConfig, Command, ValidationError } from '@effect/cli';
+import { Terminal } from '@effect/platform';
+import { NodeContext, NodeRuntime } from '@effect/platform-node';
+import { Cause, Config, Console, Effect, Layer, Logger, LogLevel, Option, Schema, String } from 'effect';
+import { Authentication, LoginCommand, LogoutCommand, WhoamiCommand } from './Authentication.js';
+import { FetchCommand } from './Commands/Fetch.js';
+import { AgentHookCommand, HumanHookCommand } from './Commands/Hook.js';
+import { InstallSubCommand, UninstallSubCommand } from './Commands/Mcp.js';
+import { McpRunCommand } from './Commands/McpRun.js';
+import { SearchCommand } from './Commands/Search.js';
+import { SkillCommand } from './Commands/Skill.js';
+import { UninstallCommand } from './Commands/Uninstall.js';
+import { ConfigManager } from './Config.js';
+import { ClaudeHook } from './Hook/Claude.js';
+import { OpencodeHook } from './Hook/Opencode.js';
+import { HookInstaller } from './Install/Hook.js';
+import { Mcp } from './Install/Mcp.js';
+import { Skill as SkillInstaller } from './Install/Skill.js';
+import { Uninstall } from './Install/Uninstall.js';
+/**
+ * Where this process is running:
+ *  - 'human': interactive terminal use. Setup commands (`mcp install`, `skill install`) are visible.
+ *  - 'agent': an agent host (Claude Code / Cursor / Codex) or the expandai skill is invoking
+ *            the CLI. Setup commands are hidden because the integration is already wired up.
+ *  - 'mcp':   the binary is serving as the MCP transport. MCP only runs in agents.
+ */
+const EnvironmentSignals = Config.all({
+    override: Schema.Config('EXPANDAI_CLI_CONTEXT', Schema.Literal('human', 'agent')).pipe(Config.option),
+    mcpTransport: Config.string('MCP_TRANSPORT').pipe(Config.option, Config.map(Option.isSome)),
+    claudeCode: Config.boolean('CLAUDECODE').pipe(Config.withDefault(false)),
+    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)),
+});
+const detectContext = Effect.gen(function* () {
+    const signals = yield* EnvironmentSignals;
+    const mcp = signals.mcpTransport ? Option.some('mcp') : Option.none();
+    // Authentication.logout uses both stdout and stdin TTY checks because Prompt
+    // reads from stdin; for context detection a non-TTY stdout alone is enough
+    // to identify a non-interactive caller.
+    const agent = signals.claudeCode || signals.cursor || signals.codex || !process.stdout.isTTY
+        ? Option.some('agent')
+        : Option.none();
+    return Option.firstSomeOf([mcp, signals.override, agent]).pipe(Option.getOrElse(() => 'human'));
+});
+const HumanMcp = Command.make('mcp').pipe(Command.withDescription('Run or install the expandai MCP server'), Command.withSubcommands([McpRunCommand, InstallSubCommand, UninstallSubCommand]));
+const AgentMcp = Command.make('mcp').pipe(Command.withDescription('Run the expandai MCP server'), Command.withSubcommands([McpRunCommand]));
+const HumanCli = Command.make('expandai').pipe(Command.withDescription('expand.ai CLI and MCP server'), Command.withSubcommands([
+    FetchCommand,
+    SearchCommand,
+    LoginCommand,
+    WhoamiCommand,
+    LogoutCommand,
+    UninstallCommand,
+    HumanMcp,
+    SkillCommand,
+    HumanHookCommand,
+]), Command.provide(Layer.mergeAll(ConfigManager.Default, Authentication.Default, Mcp.Default, HookInstaller.Default, SkillInstaller.Default, Uninstall.Default, ClaudeHook.Default, OpencodeHook.Default)));
+const AgentCli = Command.make('expandai').pipe(Command.withDescription('expand.ai CLI and MCP server'), Command.withSubcommands([
+    FetchCommand,
+    SearchCommand,
+    LoginCommand,
+    WhoamiCommand,
+    LogoutCommand,
+    AgentMcp,
+    AgentHookCommand,
+]), Command.provide(Layer.mergeAll(ConfigManager.Default, Authentication.Default, ClaudeHook.Default, OpencodeHook.Default)));
+const LoggerLive = Layer.unwrapEffect(Effect.gen(function* () {
+    const isDebug = yield* Config.boolean('DEBUG').pipe(Config.withDefault(false));
+    return Logger.minimumLogLevel(isDebug ? LogLevel.All : LogLevel.Info);
+}));
+const Env = Layer.mergeAll(NodeContext.layer, CliConfig.layer({ showBuiltIns: false }), LoggerLive);
+const program = Effect.gen(function* () {
+    const context = yield* detectContext;
+    const cli = context === 'human' ? HumanCli : AgentCli;
+    return yield* Command.run(cli, { name: 'expand.ai CLI', version: '0.0.1' })(process.argv);
+}).pipe(Effect.catchAllCause((cause) => {
+    const failure = Cause.failureOption(cause);
+    // Ctrl-C during a `Prompt` surfaces as a `QuitException` failure rather
+    // than a pure interrupt; treat it the same as an interrupt so we exit
+    // cleanly instead of printing a blank "Error: " (QuitException has no message).
+    if (Cause.isInterruptedOnly(cause) || (Option.isSome(failure) && Terminal.isQuitException(failure.value))) {
+        return Effect.void;
+    }
+    // `@effect/cli` already printed a help/usage message before failing with
+    // a `ValidationError`; we only need to propagate the non-zero exit.
+    const print = Option.match(failure, {
+        onSome: (error) => ValidationError.isValidationError(error) ? Effect.void : Console.error(`Error: ${error.message}`),
+        onNone: () => Console.error(String.stripMargin(`
+						|Unexpected failure:
+						|${Cause.pretty(cause)}`)),
+    });
+    const debug = Effect.logDebug('Error cause').pipe(Effect.annotateLogs({ cause: Cause.pretty(cause) }));
+    return print.pipe(Effect.zipRight(debug), Effect.zipRight(Effect.failCause(cause)));
+}), Effect.provide(Env));
+NodeRuntime.runMain(program, { disableErrorReporting: true });
+//# sourceMappingURL=main.js.map

package/build/esm/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACxG,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACtC,OAAO,EAAE,KAAK,IAAI,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAElD;;;;;;GAMG;AAEH,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IACrG,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3F,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACxE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvF,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CACnF,CAAC,CAAA;AAEF,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,kBAAkB,CAAA;IAEzC,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAS,CAAA;IACrF,6EAA6E;IAC7E,2EAA2E;IAC3E,wCAAwC;IACxC,MAAM,KAAK,GACV,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;QAC7E,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAgB,CAAC;QAC/B,CAAC,CAAC,MAAM,CAAC,IAAI,EAAW,CAAA;IAE1B,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,OAAgB,CAAC,CAAC,CAAA;AACzG,CAAC,CAAC,CAAA;AAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CACxC,OAAO,CAAC,eAAe,CAAC,wCAAwC,CAAC,EACjE,OAAO,CAAC,eAAe,CAAC,CAAC,aAAa,EAAE,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAChF,CAAA;AAED,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CACxC,OAAO,CAAC,eAAe,CAAC,6BAA6B,CAAC,EACtD,OAAO,CAAC,eAAe,CAAC,CAAC,aAAa,CAAC,CAAC,CACxC,CAAA;AAED,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAC7C,OAAO,CAAC,eAAe,CAAC,8BAA8B,CAAC,EACvD,OAAO,CAAC,eAAe,CAAC;IACvB,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,aAAa;IACb,aAAa;IACb,gBAAgB;IAChB,QAAQ;IACR,YAAY;IACZ,gBAAgB;CAChB,CAAC,EACF,OAAO,CAAC,OAAO,CACd,KAAK,CAAC,QAAQ,CACb,aAAa,CAAC,OAAO,EACrB,cAAc,CAAC,OAAO,EACtB,GAAG,CAAC,OAAO,EACX,aAAa,CAAC,OAAO,EACrB,cAAc,CAAC,OAAO,EACtB,SAAS,CAAC,OAAO,EACjB,UAAU,CAAC,OAAO,EAClB,YAAY,CAAC,OAAO,CACpB,CACD,CACD,CAAA;AAED,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAC7C,OAAO,CAAC,eAAe,CAAC,8BAA8B,CAAC,EACvD,OAAO,CAAC,eAAe,CAAC;IACvB,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,aAAa;IACb,aAAa;IACb,QAAQ;IACR,gBAAgB;CAChB,CAAC,EACF,OAAO,CAAC,OAAO,CACd,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,CACvG,CACD,CAAA;AAED,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,CACpC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IACnB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAA;IAC9E,OAAO,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AACtE,CAAC,CAAC,CACF,CAAA;AAED,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,CAAA;AAEnG,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,aAAa,CAAA;IACpC,MAAM,GAAG,GAAG,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAA;IACrD,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AAC1F,CAAC,CAAC,CAAC,IAAI,CACN,MAAM,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;IAC1C,wEAAwE;IACxE,sEAAsE;IACtE,gFAAgF;IAChF,IAAI,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC3G,OAAO,MAAM,CAAC,IAAI,CAAA;IACnB,CAAC;IACD,yEAAyE;IACzE,oEAAoE;IACpE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;QACnC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,eAAe,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,UAAW,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7G,MAAM,EAAE,GAAG,EAAE,CACZ,OAAO,CAAC,KAAK,CACZ,MAAM,CAAC,WAAW,CAAC;;SAEf,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAC1B;KACF,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;IACtG,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AACpF,CAAC,CAAC,EACF,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CACnB,CAAA;AAED,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAA"}

package/build/skills/expandai/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: expandai
+description: Fetch any URL as clean markdown using the `expandai` CLI. Use when reading documentation, articles, GitHub READMEs, blog posts, or any web page — the output is rendered from the live page so it handles SPAs and bot-protected sites that plain `curl` does not.
+---
+
+# expandai
+
+Fetch any URL as clean markdown.
+
+```bash
+expandai fetch <url>
+```
+
+## When to use
+
+Use `expandai fetch` instead of `curl` or `WebFetch` when you need to read web content. It renders the live page (handles JavaScript, SPAs, bot protection) and returns markdown rather than raw HTML.
+
+## Usage
+
+```bash
+expandai fetch https://docs.example.com/api
+expandai fetch github.com/owner/repo            # https:// is added automatically
+expandai fetch https://example.com --format json  # object-mode { meta, markdown, json }
+```
+
+## Output
+
+- Default (`--format text`): full markdown document — pipe to grep, less, or write to a file.
+- `--format json`: object-mode response with `meta`, `markdown`, and `json`. The handle for
+  later searches is `meta.snapshotId`.
+
+## Search a page you already fetched
+
+Every fetch produces a snapshot handle (`meta.snapshotId`). When the WebFetch hook serves a
+page, it injects that handle as a note at the top of the markdown. Once a page is captured,
+extract specific passages by **searching the snapshot by handle** — don't fetch the URL again:
+
+```bash
+expandai search <snapshotId> "your query"            # snippets from the stored snapshot
+expandai search <snapshotId> "your query" --format json --max-results 10 --min-score 0.5
+```
+
+Agents with the expandai MCP server can call the `fetch_search` tool with the same
+`snapshotId` instead.
+
+Use `expandai fetch <url> --search "query"` only for a one-shot fetch+search of a URL you
+have not captured yet — it starts a new browser capture. If you already have a `snapshotId`,
+prefer `expandai search` (or `fetch_search`), which reuses the existing capture.
+
+## Citations
+
+Search results include enough location data to audit the cited passage. In text output,
+`expandai search` and `expandai fetch --search` print a public playground citation link above
+each snippet. MCP tool results expose `citationUrl` fields directly.
+
+## Common patterns
+
+```bash
+# Read a doc page
+expandai fetch https://effect.website/docs/getting-started
+
+# Save to a file
+expandai fetch https://example.com > page.md
+
+# Inspect object-mode output, including State JSON when present
+expandai fetch https://docs.example.com/api --format json
+```
+
+## Failure modes
+
+- Exit code non-zero with `Not authenticated` — the user has not run `expandai login`. Tell them to run it; do not attempt to authenticate yourself.
+- Empty markdown output — try `--format json` to inspect the response shape.

package/package.json

@@ -1,12 +1,74 @@
 {
-  "name": "expandai",
-  "module": "index.ts",
-  "type": "module",
-  "version": "0.0.0",
-  "devDependencies": {
-    "@types/bun": "latest"
-  },
-  "peerDependencies": {
-    "typescript": "^5.0.0"
-  }
+	"name": "expandai",
+	"type": "module",
+	"version": "0.0.2",
+	"private": false,
+	"description": "Unified CLI and MCP server for ExpandAI",
+	"author": "ExpandAI",
+	"license": "Apache-2.0",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/expandai/expandai-cli.git"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"files": [
+		"build/dts",
+		"build/esm",
+		"build/skills",
+		"src",
+		"!**/*.tsbuildinfo"
+	],
+	"bin": {
+		"expandai": "build/esm/main.js"
+	},
+	"exports": {
+		"./package.json": "./package.json",
+		".": {
+			"types": "./build/dts/index.d.ts",
+			"import": "./build/esm/index.js"
+		},
+		"./*": {
+			"types": "./build/dts/*.d.ts",
+			"import": "./build/esm/*.js"
+		}
+	},
+	"scripts": {
+		"dev": "tsx --watch src/main.ts",
+		"build": "tsc -b tsconfig.build.json && cp -R skills build/skills && cp src/Install/Opencode/expandai-webfetch.js build/esm/Install/Opencode/expandai-webfetch.js && chmod +x build/esm/main.js",
+		"build:bin": "bun ./scripts/build.ts --single",
+		"build:bin:all": "bun ./scripts/build.ts",
+		"check": "tsc -b tsconfig.json",
+		"check:test": "tsc -b tsconfig.test.json",
+		"lint": "biome check --write --no-errors-on-unmatched",
+		"lint:check": "biome check",
+		"format": "biome format --write",
+		"format:check": "biome format",
+		"test": "vitest run --exclude 'test/**/*.integration.test.ts'",
+		"test:integration": "bun run build && vitest run integration",
+		"coverage": "vitest --coverage"
+	},
+	"dependencies": {
+		"@effect/ai": "0.35.0",
+		"@effect/cli": "0.75.1",
+		"@effect/platform": "0.96.1",
+		"@effect/platform-node": "0.106.0",
+		"@expandai/sdk": "0.17.2",
+		"effect": "3.21.2",
+		"open": "^11.0.0",
+		"smol-toml": "^1.6.1"
+	},
+	"devDependencies": {
+		"@anthropic-ai/claude-agent-sdk": "0.3.150",
+		"@biomejs/biome": "^2.4.14",
+		"@effect/vitest": "0.29.0",
+		"@modelcontextprotocol/sdk": "1.29.0",
+		"@openai/codex-sdk": "^0.133.0",
+		"@opencode-ai/sdk": "1.15.10",
+		"@types/bun": "^1.3.14",
+		"@types/node": "^25.5.2",
+		"opencode-ai": "1.15.10",
+		"vitest": "4.1.4"
+	}
 }