@nac3/forge-cli 0.2.0-alpha.9 → 1.0.0

package/dist/chat/semantic_graph_ingest.d.ts

@@ -0,0 +1,39 @@
+export interface IngestedNode {
+    id: string;
+    kind: 'library';
+    name: string;
+    version: string | null;
+    source: 'package.json';
+    purpose: string;
+    solves: string[];
+    do_not_invent: string[];
+    api_surface: string[];
+    confidence: 'auto';
+    weight: number;
+    project_slug: string;
+}
+/** Parse package.json deps + devDeps + optionalDeps. When
+ *  enrich=true (default), each node's purpose is filled from
+ *  the npm registry (cache-first; offline-graceful). Pass
+ *  enrich=false to skip the network (used by --dry-run and
+ *  tests that don't want a live fetch). */
+export declare function ingestFromPackageJson(opts: {
+    project_root: string;
+    project_slug?: string;
+    /** PND-020 Phase 3 -- npm registry summary lookup. Default true.
+     *  Honors YF_NPM_ENRICH=0 env var. */
+    enrich?: boolean;
+    /** Test seam for the npm registry fetcher. */
+    fetchImpl?: typeof fetch;
+}): Promise<IngestedNode[]>;
+/** "1.2.3", "^1.2.3", "~1.2.3", ">=1.2.3 <2.0.0" -> "1.2.3" or null. */
+declare function cleanVersion(v: string): string | null;
+/** npm package names like "@scope/foo-bar" -> "scope-foo-bar" for
+ *  graph node IDs (dotted, lowercase, alphanumeric+dashes only). */
+declare function sanitiseId(name: string): string;
+export declare const _internal: {
+    cleanVersion: typeof cleanVersion;
+    sanitiseId: typeof sanitiseId;
+};
+export {};
+//# sourceMappingURL=semantic_graph_ingest.d.ts.map

package/dist/chat/semantic_graph_ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic_graph_ingest.d.ts","sourceRoot":"","sources":["../../src/chat/semantic_graph_ingest.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAa,MAAM,CAAC;IACtB,IAAI,EAAW,SAAS,CAAC;IACzB,IAAI,EAAW,MAAM,CAAC;IACtB,OAAO,EAAQ,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAS,cAAc,CAAC;IAC9B,OAAO,EAAQ,MAAM,CAAC;IACtB,MAAM,EAAS,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAI,MAAM,EAAE,CAAC;IACxB,UAAU,EAAK,MAAM,CAAC;IACtB,MAAM,EAAS,MAAM,CAAC;IACtB,YAAY,EAAG,MAAM,CAAC;CACvB;AAED;;;;2CAI2C;AAC3C,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;0CACsC;IACtC,MAAM,CAAC,EAAO,OAAO,CAAC;IACtB,8CAA8C;IAC9C,SAAS,CAAC,EAAI,OAAO,KAAK,CAAC;CAC5B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA8C1B;AAED,wEAAwE;AACxE,iBAAS,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG9C;AAED;oEACoE;AACpE,iBAAS,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMxC;AAGD,eAAO,MAAM,SAAS;;;CAA+B,CAAC"}

package/dist/chat/semantic_graph_ingest.js

@@ -0,0 +1,90 @@
+/**
+ * Semantic graph auto-ingest from project state.
+ *
+ * Walks package.json deps + devDeps + optionalDeps -> one library
+ * node per entry. As of PND-020 Phase 3 (z.184), node `purpose` is
+ * enriched via npm registry lookup (cache-first; offline-graceful).
+ *
+ * Output: array of nodes ready to upsertNodes against the local
+ * SQLite store. Confidence: 'auto' by default. User promotes to
+ * 'verified' via `yf graph review` or `yf graph add-node` override.
+ *
+ * Spec: docs/SEMANTIC_GRAPH_SPEC_2026_06_02.md sec 4.1 + Phase 3.
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { enrichNodes } from '../semantic_graph/npm_enrich.js';
+/** Parse package.json deps + devDeps + optionalDeps. When
+ *  enrich=true (default), each node's purpose is filled from
+ *  the npm registry (cache-first; offline-graceful). Pass
+ *  enrich=false to skip the network (used by --dry-run and
+ *  tests that don't want a live fetch). */
+export async function ingestFromPackageJson(opts) {
+    const pkgPath = path.join(opts.project_root, 'package.json');
+    let raw;
+    try {
+        raw = await fs.readFile(pkgPath, 'utf-8');
+    }
+    catch {
+        return []; // no package.json -> nothing to ingest
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    const slug = opts.project_slug ?? '';
+    const sections = ['dependencies', 'devDependencies', 'optionalDependencies'];
+    for (const section of sections) {
+        const obj = pkg[section];
+        if (!obj || typeof obj !== 'object')
+            continue;
+        for (const [name, version] of Object.entries(obj)) {
+            if (typeof name !== 'string' || !name)
+                continue;
+            const v = typeof version === 'string' ? cleanVersion(version) : null;
+            const sanitised = sanitiseId(name);
+            out.push({
+                id: 'lib.' + sanitised,
+                kind: 'library',
+                name,
+                version: v,
+                source: 'package.json',
+                purpose: name + ' (npm package, ' + section + '). Auto-ingested; review + add do_not_invent via `yf graph show`.',
+                solves: [],
+                do_not_invent: [],
+                api_surface: [],
+                confidence: 'auto',
+                weight: section === 'dependencies' ? 0.6 : 0.4,
+                project_slug: slug,
+            });
+        }
+    }
+    if (opts.enrich !== false && out.length > 0) {
+        /* Phase 3 -- best-effort npm registry enrichment. Failures are
+         * absorbed; the placeholder purpose survives intact. */
+        await enrichNodes(out, opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}).catch(() => undefined);
+    }
+    return out;
+}
+/** "1.2.3", "^1.2.3", "~1.2.3", ">=1.2.3 <2.0.0" -> "1.2.3" or null. */
+function cleanVersion(v) {
+    const m = v.match(/(\d+\.\d+\.\d+(?:-[a-zA-Z0-9.]+)?)/);
+    return m ? (m[1] ?? null) : null;
+}
+/** npm package names like "@scope/foo-bar" -> "scope-foo-bar" for
+ *  graph node IDs (dotted, lowercase, alphanumeric+dashes only). */
+function sanitiseId(name) {
+    return name
+        .replace(/^@/, '')
+        .replace(/[\/]/g, '-')
+        .replace(/[^a-z0-9\-_]/gi, '-')
+        .toLowerCase();
+}
+/* Test seam. */
+export const _internal = { cleanVersion, sanitiseId };
+//# sourceMappingURL=semantic_graph_ingest.js.map

package/dist/chat/semantic_graph_ingest.js.map

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

package/dist/chat/semantic_graph_inject.d.ts

@@ -0,0 +1,31 @@
+import type { GraphNodeKind } from '../semantic_graph/types.js';
+export interface InjectOptions {
+    intent: string;
+    project_slug?: string;
+    limit?: number;
+    include_auto?: boolean;
+    token_budget?: number;
+    /** Restrict by node kind (default: all kinds). */
+    kinds?: GraphNodeKind[];
+    /** Retained for source-compat with pre-z.182 callers. Ignored. */
+    timeout_ms?: number;
+}
+export interface InjectResult {
+    rendered_text: string;
+    pool_size: number;
+    estimated_tokens: number;
+    /** Always 'local' or 'none' as of z.182. The 'worker' source is
+     *  parked until PND-016 + slice 181. */
+    source: 'local' | 'none';
+    /** When false, no graph section is available for this turn.
+     *  rendered_text is '' in that case. */
+    ok: boolean;
+}
+/** Fetch the relevant graph section + return as text ready to embed
+ *  in the system prompt. Empty string when no graph or on any
+ *  failure (graceful, never throws). */
+export declare function fetchGraphSection(opts: InjectOptions): Promise<InjectResult>;
+/** YF_SEMANTIC_GRAPH_DISABLED gates injection. Default ON; set to
+ *  '1' / 'true' / 'yes' to disable. */
+export declare function injectionEnabled(): boolean;
+//# sourceMappingURL=semantic_graph_inject.d.ts.map

package/dist/chat/semantic_graph_inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic_graph_inject.d.ts","sourceRoot":"","sources":["../../src/chat/semantic_graph_inject.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAS,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAS,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,KAAK,CAAC,EAAS,aAAa,EAAE,CAAC;IAC/B,kEAAkE;IAClE,UAAU,CAAC,EAAI,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAK,MAAM,CAAC;IACzB,SAAS,EAAS,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB;4CACwC;IACxC,MAAM,EAAY,OAAO,GAAG,MAAM,CAAC;IACnC;4CACwC;IACxC,EAAE,EAAgB,OAAO,CAAC;CAC3B;AAED;;wCAEwC;AACxC,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CA0BlF;AAED;uCACuC;AACvC,wBAAgB,gBAAgB,IAAI,OAAO,CAI1C"}

package/dist/chat/semantic_graph_inject.js

@@ -0,0 +1,63 @@
+/**
+ * Semantic graph inject -- LOCAL ONLY as of alpha.59z.182.
+ *
+ * Reads the per-project SQLite graph at
+ *   ~/.yujin-forge/projects/<slug>/semantic_graph.db
+ * + renders it locally. Empty rendered_text when the project has
+ * no graph yet (chat continues without the section).
+ *
+ * Per Pablo (2026-06-07): the D1 worker stays dormant until
+ * PND-016 closes the P3 Platform billing/auth/tier decisions.
+ * Until then, BYOK plain = 100% local, no Yujin infra in the
+ * hot path of any chat turn. The worker code path is gone from
+ * this module on purpose -- slice 181 (gated by PND-016) will
+ * reintroduce it under the P3 tier with proper plan gating.
+ *
+ * Failure mode: graceful. Always returns ok-shaped result; never
+ * throws.
+ *
+ * ASCII-only.
+ */
+import { listRelevant } from '../semantic_graph/store.js';
+import { renderLocalGraphSection } from '../semantic_graph/render.js';
+/** Fetch the relevant graph section + return as text ready to embed
+ *  in the system prompt. Empty string when no graph or on any
+ *  failure (graceful, never throws). */
+export async function fetchGraphSection(opts) {
+    const slug = opts.project_slug ?? '';
+    if (!slug)
+        return { rendered_text: '', pool_size: 0, estimated_tokens: 0, source: 'none', ok: false };
+    try {
+        const nodes = await listRelevant(slug, {
+            text: opts.intent,
+            limit: opts.limit ?? 8,
+            ...(opts.kinds ? { kinds: opts.kinds } : {}),
+            min_confidence: opts.include_auto ? 'claimed' : 'auto',
+        });
+        if (nodes.length === 0) {
+            return { rendered_text: '', pool_size: 0, estimated_tokens: 0, source: 'none', ok: false };
+        }
+        const r = renderLocalGraphSection(nodes, {
+            char_budget: (opts.token_budget ?? 500) * 4,
+        });
+        return {
+            rendered_text: r.rendered_text,
+            pool_size: nodes.length,
+            estimated_tokens: r.estimated_tokens,
+            source: 'local',
+            ok: true,
+        };
+    }
+    catch {
+        return { rendered_text: '', pool_size: 0, estimated_tokens: 0, source: 'none', ok: false };
+    }
+}
+/** YF_SEMANTIC_GRAPH_DISABLED gates injection. Default ON; set to
+ *  '1' / 'true' / 'yes' to disable. */
+export function injectionEnabled() {
+    const v = process.env['YF_SEMANTIC_GRAPH_DISABLED'];
+    if (v === '1' || v === 'true' || v === 'yes')
+        return false;
+    return true;
+}
+//# sourceMappingURL=semantic_graph_inject.js.map

package/dist/chat/semantic_graph_inject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic_graph_inject.js","sourceRoot":"","sources":["../../src/chat/semantic_graph_inject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AA2BtE;;wCAEwC;AACxC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAmB;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;IACtG,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE;YACrC,IAAI,EAAG,IAAI,CAAC,MAAM;YAClB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;YACtB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5C,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;SACvD,CAAC,CAAC;QACH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QAC7F,CAAC;QACD,MAAM,CAAC,GAAG,uBAAuB,CAAC,KAAK,EAAE;YACvC,WAAW,EAAE,CAAC,IAAI,CAAC,YAAY,IAAI,GAAG,CAAC,GAAG,CAAC;SAC5C,CAAC,CAAC;QACH,OAAO;YACL,aAAa,EAAK,CAAC,CAAC,aAAa;YACjC,SAAS,EAAS,KAAK,CAAC,MAAM;YAC9B,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;YACpC,MAAM,EAAY,OAAO;YACzB,EAAE,EAAgB,IAAI;SACvB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;IAC7F,CAAC;AACH,CAAC;AAED;uCACuC;AACvC,MAAM,UAAU,gBAAgB;IAC9B,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/chat/server.d.ts

@@ -12,17 +12,37 @@
  * leak the API key + the project source-aware system prompt.
  */
 import { type Server } from 'node:http';
-import { ClaudeClient } from './claude.js';
+import { type ChatLLMClient } from './claude.js';
 import { TranscriptStore } from './persistence.js';
+import { type ForgeMode } from '../core/mode.js';
 import { VoiceRouter } from '../voice/router.js';
 export interface StartOptions {
     projectRoot: string;
     port: number;
     /** Test injection -- defaults to a real ClaudeClient. */
-    claude?: ClaudeClient;
+    claude?: ChatLLMClient;
+    /** Provider for chat LLM calls. Defaults to 'anthropic-api' (the
+     *  classic ClaudeClient over the Anthropic HTTP API, billed against
+     *  Console). Set to 'claude-code-cli' to route every chat turn
+     *  through the `claude -p` subprocess instead, which bills against
+     *  the user's Claude Code subscription (apiKeySource: none). The
+     *  subprocess path uses Claude Code's native tool surface (Read,
+     *  Edit, Write, Bash, Glob, Grep) instead of NAC3 invoke -- the
+     *  caller's `tools` + `runTool` are ignored under this provider.
+     *  Ignored when `claude` is injected explicitly. */
+    chatProvider?: 'anthropic-api' | 'claude-code-cli';
+    /** Additional directories the claude-code-cli provider may operate
+     *  in (passed through to `--add-dir`). Useful for orchestrating a
+     *  build against a workspace outside `projectRoot`. */
+    chatProviderAddDirs?: string[];
     /** Test injection -- defaults to a real VoiceRouter with the
      *  three production providers wired in. */
     voice?: VoiceRouter;
+    /** Director sprint slice 5 -- agent runtime. When present, the
+     *  panel exposes /api/agent/state, /api/agent/run, and
+     *  /api/agent/events (SSE). When absent, those endpoints return
+     *  503 so the UI can render a "runtime not started" state. */
+    runtime?: import('../agents/runtime.js').Runtime;
 }
 export interface StartedServer {
     server: Server;
@@ -31,4 +51,81 @@ export interface StartedServer {
     close: () => Promise<void>;
 }
 export declare function startChatServer(opts: StartOptions): Promise<StartedServer>;
+interface Ctx {
+    projectRoot: string;
+    projectName: string;
+    projectSlug: string;
+    port: number;
+    claude: ChatLLMClient;
+    voice: VoiceRouter;
+    store: TranscriptStore;
+    runtime?: import('../agents/runtime.js').Runtime;
+    chatProvider?: 'anthropic-api' | 'claude-code-cli';
+    panelPushToken?: string;
+    reanchor?: (newRoot: string) => Promise<{
+        projectRoot: string;
+        projectName: string;
+        projectSlug: string;
+    }>;
+    setBrainProvider?: (mode: 'plan' | 'console') => Promise<boolean>;
+}
+export declare function buildSystemPrompt(ctx: Ctx, mode?: ForgeMode, pilotState?: {
+    pilot_completed: boolean;
+    target_pending: boolean;
+    mode_pending: boolean;
+}, 
+/** alpha.58 -- which brain tier + provider + model is serving
+ *  this turn. Allows the LLM (especially eco-tier ones like
+ *  Gemini Flash Lite) to know its own role and be more
+ *  cautious / defer to nac3_invoke when in doubt. */
+brain?: {
+    tier: 'eco' | 'frontier';
+    provider: string;
+    model: string;
+}, 
+/** alpha.59z.15 HITO 6.3 -- the GLOBAL LEARNINGS section,
+ *  pre-fetched async by the caller via
+ *  buildGlobalLearningsSection() from learnings_client.ts.
+ *  Empty string -> no learnings (worker unreachable or no
+ *  active lessons). buildSystemPrompt stays sync; the caller
+ *  awaits the fetch before invoking us. */
+globalLearningsSection?: string, 
+/** alpha.59z.26 F101 slice 2 -- whether MCP bridges are
+ *  discovered in the current session. When false (default),
+ *  the manifest stub filters out every yujin.mcp.* verb so
+ *  the LLM never sees them (Invariant 1: Forge without MCP
+ *  behaves identically to pre-F101). When true, the LLM gets
+ *  the MCP-meta verbs (list-bridges, show-tools, toggle,
+ *  set-creds, discover-tools) in its stub. The caller
+ *  prefetches via getActiveBridges() before invoking us. */
+mcpAvailable?: boolean, 
+/** alpha.59z.37 NAC-3 v3.x backend tools (task #23) -- pre-built
+ *  app.* verbs section, ready to splice into the prompt. The
+ *  caller prefetches via loadBackendCatalogue() +
+ *  buildBackendToolsSection() before invoking us so the prompt
+ *  build stays sync. Empty string -> no section appears
+ *  (Invariant: identical prompt to v3.0 when adopter does not
+ *  declare nac3_backend). Slice 1 only surfaces the verbs in
+ *  the stub; slice 2 wires dispatch + auth + audit. */
+backendToolsSection?: string, 
+/** alpha.59z.172 PND-022 -- first user message of the active turn.
+ *  When the pilot warmup would fire and the message is detected
+ *  out-of-scope (music, poetry, image, abstract explanation,
+ *  casual chat), welcomePromptSuffix returns empty so the user
+ *  is not asked target/mode for content unrelated to software. */
+firstUserMessage?: string, 
+/** PND-064 -- how the pizarron is reachable in the ACTIVE mode:
+ *   - 'native'     : anthropic-api / yujin_managed. The server
+ *                    runs runTool and the panel intercepts
+ *                    nac3_panel_dispatch. Use yujin.pizarron.*.
+ *   - 'mcp-bridge' : claude-code-cli WITH the panel MCP bridge
+ *                    (slice B). The subprocess reaches the
+ *                    pizarron via the pizarron_create_tab MCP
+ *                    tool, NOT the yujin.pizarron.* verbs.
+ *   - 'none'       : claude-code-cli WITHOUT a working bridge.
+ *                    The pizarron is unreachable; the model must
+ *                    not claim it created a tab or verified the
+ *                    panel. */
+panelMode?: 'native' | 'mcp-bridge' | 'none'): string;
+export {};
 //# sourceMappingURL=server.d.ts.map

package/dist/chat/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/chat/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAA2D,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAGjG,OAAO,EAAE,YAAY,EAAwD,MAAM,aAAa,CAAC;AAEjG,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAqBnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAuBjD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;+CAC2C;IAC3C,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAqFhF"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/chat/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAA2D,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAKjG,OAAO,EAAoD,KAAK,aAAa,EAAoB,MAAM,aAAa,CAAC;AAErH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAInD,OAAO,EAEL,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAC;AAczB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAkCjD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;;;;;;;wDAQoD;IACpD,YAAY,CAAC,EAAE,eAAe,GAAG,iBAAiB,CAAC;IACnD;;2DAEuD;IACvD,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B;+CAC2C;IAC3C,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;;kEAG8D;IAC9D,OAAO,CAAC,EAAE,OAAO,sBAAsB,EAAE,OAAO,CAAC;CAClD;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAwVhF;AAED,UAAU,GAAG;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC;IAIvB,OAAO,CAAC,EAAE,OAAO,sBAAsB,EAAE,OAAO,CAAC;IAMjD,YAAY,CAAC,EAAE,eAAe,GAAG,iBAAiB,CAAC;IAKnD,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAG3G,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACnE;AAkrID,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,GAAG,EACR,IAAI,GAAE,SAAuB,EAC7B,UAAU,GAAE;IAAE,eAAe,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAErF;AACD;;;qDAGqD;AACrD,KAAK,CAAC,EAAE;IAAE,IAAI,EAAE,KAAK,GAAG,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AACrE;;;;;2CAK2C;AAC3C,sBAAsB,GAAE,MAAW;AACnC;;;;;;;4DAO4D;AAC5D,YAAY,GAAE,OAAe;AAC7B;;;;;;;uDAOuD;AACvD,mBAAmB,GAAE,MAAW;AAChC;;;;kEAIkE;AAClE,gBAAgB,GAAE,MAAW;AAC7B;;;;;;;;;;;+BAW+B;AAC/B,SAAS,GAAE,QAAQ,GAAG,YAAY,GAAG,MAAiB,GACrD,MAAM,CAqdR"}