@wingmanjs/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eric Hansen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/client.d.ts

@@ -0,0 +1,55 @@
+/**
+ * WingmanClient — Core wrapper around the GitHub Copilot SDK's CopilotClient.
+ *
+ * Manages the CopilotClient singleton lifecycle, creates and resumes sessions,
+ * and orchestrates MCP discovery, tools, and event routing.
+ */
+import type { WingmanConfig, AgentMode } from './types.js';
+import { type EventCallbacks } from './events.js';
+export interface SendMessageOptions extends Partial<EventCallbacks> {
+    /** Timeout in milliseconds for sendAndWait. Default: 300_000 (5 min). */
+    timeout?: number;
+}
+export interface WingmanClientOptions {
+    config?: WingmanConfig;
+}
+export declare class WingmanClient {
+    private client;
+    private config;
+    private telemetry;
+    constructor(options?: WingmanClientOptions);
+    /** Lazily initialize the CopilotClient singleton. */
+    private getClient;
+    /**
+     * Create or resume a session. If a sessionId is provided and a cached
+     * session exists, reuses it to prevent listener duplication.
+     */
+    getSession(sessionId?: string): Promise<import("@github/copilot-sdk").CopilotSession>;
+    /**
+     * Send a message and stream events to the provided callbacks.
+     * Handles the full lifecycle: listener setup, sendAndWait, cleanup.
+     */
+    sendMessage(sessionId: string | undefined, message: string, callbacks?: SendMessageOptions): Promise<string>;
+    /** Extract session ID from a session object. */
+    private getSessionId;
+    /** Build MCP server configs from discovery + user config. */
+    private buildMCPServers;
+    /** Gracefully shut down the client. */
+    stop(): Promise<void>;
+    /** Get the resolved configuration. */
+    getConfig(): Required<WingmanConfig>;
+    /** List available models from the SDK. */
+    listModels(): Promise<Array<{
+        id: string;
+        name: string;
+    }>>;
+    /** Switch the model for an active session. */
+    switchModel(sessionId: string, modelId: string): Promise<void>;
+    /** Get the current agent mode for a session. */
+    getMode(sessionId: string): Promise<string>;
+    /** Set the agent mode for a session. */
+    setMode(sessionId: string, mode: AgentMode): Promise<void>;
+    /** Get account quota information. */
+    getQuota(): Promise<Record<string, unknown> | null>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG3D,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAmB/D,MAAM,WAAW,kBAAmB,SAAQ,OAAO,CAAC,cAAc,CAAC;IACjE,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,SAAS,CAAkC;gBAEvC,OAAO,GAAE,oBAAyB;IAK9C,qDAAqD;IACrD,OAAO,CAAC,SAAS;IAOjB;;;OAGG;IACG,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM;IAwCnC;;;OAGG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,kBAAuB;IA+CpC,gDAAgD;IAEhD,OAAO,CAAC,YAAY;IAIpB,6DAA6D;YAC/C,eAAe;IAI7B,uCAAuC;IACjC,IAAI;IAQV,sCAAsC;IACtC,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;IAQpC,0CAA0C;IACpC,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAShE,8CAA8C;IACxC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpE,gDAAgD;IAC1C,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMjD,wCAAwC;IAClC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhE,qCAAqC;IAC/B,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAM1D"}

package/dist/client.js

@@ -0,0 +1,227 @@
+/**
+ * WingmanClient — Core wrapper around the GitHub Copilot SDK's CopilotClient.
+ *
+ * Manages the CopilotClient singleton lifecycle, creates and resumes sessions,
+ * and orchestrates MCP discovery, tools, and event routing.
+ */
+import { CopilotClient, approveAll } from '@github/copilot-sdk';
+import { resolveConfig } from './config.js';
+import { discoverMCPServers } from './mcp.js';
+import { EventRouter } from './events.js';
+import { createTracer } from './telemetry.js';
+// ---------------------------------------------------------------------------
+// Session cache — prevents duplicate events on resume
+// ---------------------------------------------------------------------------
+/**
+ * The SDK's `resumeSession()` creates a new CopilotSession object that shares
+ * the same backend session. Both objects receive events from the same JSON-RPC
+ * connection, so listeners accumulate and events fire twice.
+ *
+ * Workaround: cache the original session object by ID and reuse it.
+ */
+const sessionCache = new Map();
+export class WingmanClient {
+    client = null;
+    config;
+    telemetry;
+    constructor(options = {}) {
+        this.config = resolveConfig(options.config ?? {});
+        this.telemetry = createTracer(this.config.telemetry);
+    }
+    /** Lazily initialize the CopilotClient singleton. */
+    getClient() {
+        if (!this.client) {
+            this.client = new CopilotClient();
+        }
+        return this.client;
+    }
+    /**
+     * Create or resume a session. If a sessionId is provided and a cached
+     * session exists, reuses it to prevent listener duplication.
+     */
+    async getSession(sessionId) {
+        const client = this.getClient();
+        // Resume from cache if possible
+        if (sessionId && sessionCache.has(sessionId)) {
+            const cached = sessionCache.get(sessionId);
+            // Clean up previous listener before attaching a new one
+            if (cached.unsubscribe) {
+                cached.unsubscribe();
+                cached.unsubscribe = null;
+            }
+            return cached.session;
+        }
+        // Build MCP server configurations
+        const mcpServers = await this.buildMCPServers();
+        const sessionConfig = {
+            model: this.config.model,
+            streaming: true,
+            systemMessage: { content: this.config.systemPrompt },
+            mcpServers,
+            skillDirectories: this.config.skillDirectories,
+            onPermissionRequest: approveAll,
+        };
+        let session;
+        if (sessionId) {
+            session = await client.resumeSession(sessionId, sessionConfig);
+        }
+        else {
+            session = await client.createSession(sessionConfig);
+        }
+        // Cache the session
+        const sid = this.getSessionId(session);
+        sessionCache.set(sid, { session, unsubscribe: null });
+        return session;
+    }
+    /**
+     * Send a message and stream events to the provided callbacks.
+     * Handles the full lifecycle: listener setup, sendAndWait, cleanup.
+     */
+    async sendMessage(sessionId, message, callbacks = {}) {
+        const session = await this.getSession(sessionId);
+        const sid = this.getSessionId(session);
+        const cached = sessionCache.get(sid);
+        // Clean up any previous listener
+        if (cached?.unsubscribe) {
+            cached.unsubscribe();
+            cached.unsubscribe = null;
+        }
+        // Create telemetry callbacks for this turn
+        const telemetryCallbacks = this.telemetry.createCallbacks(sid, this.config.model);
+        // Compose user callbacks with telemetry callbacks
+        const composedCallbacks = composeCallbacks(callbacks, telemetryCallbacks);
+        // Wire up event router with composed callbacks
+        const router = new EventRouter(composedCallbacks);
+        const unsubscribe = session.on((event) => {
+            router.route(event);
+        });
+        // Track this specific unsubscribe by reference so the finally block
+        // only cleans up its own listener, not a concurrent turn's listener.
+        const myUnsubscribe = unsubscribe;
+        if (cached) {
+            cached.unsubscribe = unsubscribe;
+        }
+        const timeout = callbacks.timeout ?? 300_000;
+        try {
+            await session.sendAndWait({ prompt: message }, timeout);
+        }
+        finally {
+            // Only unsubscribe our own listener — if a concurrent turn replaced
+            // cached.unsubscribe, we must not null it out.
+            myUnsubscribe();
+            if (cached && cached.unsubscribe === myUnsubscribe) {
+                cached.unsubscribe = null;
+            }
+        }
+        return sid;
+    }
+    /** Extract session ID from a session object. */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getSessionId(session) {
+        return session.sessionId ?? session.id ?? 'unknown';
+    }
+    /** Build MCP server configs from discovery + user config. */
+    async buildMCPServers() {
+        return discoverMCPServers(this.config.mcpServers);
+    }
+    /** Gracefully shut down the client. */
+    async stop() {
+        if (this.client) {
+            await this.client.stop();
+            this.client = null;
+        }
+        sessionCache.clear();
+    }
+    /** Get the resolved configuration. */
+    getConfig() {
+        return this.config;
+    }
+    // -------------------------------------------------------------------------
+    // RPC methods — expose SDK RPC surface for UI controls
+    // -------------------------------------------------------------------------
+    /** List available models from the SDK. */
+    async listModels() {
+        const client = this.getClient();
+        const result = await client.rpc.models.list();
+        return result.models.map((m) => ({
+            id: m.id,
+            name: m.id,
+        }));
+    }
+    /** Switch the model for an active session. */
+    async switchModel(sessionId, modelId) {
+        const session = await this.getSession(sessionId);
+        await session.rpc.model.switchTo({ modelId });
+    }
+    /** Get the current agent mode for a session. */
+    async getMode(sessionId) {
+        const session = await this.getSession(sessionId);
+        const result = await session.rpc.mode.get();
+        return result.mode;
+    }
+    /** Set the agent mode for a session. */
+    async setMode(sessionId, mode) {
+        const session = await this.getSession(sessionId);
+        await session.rpc.mode.set({ mode });
+    }
+    /** Get account quota information. */
+    async getQuota() {
+        const client = this.getClient();
+        const result = await client.rpc.account.getQuota();
+        const quotaSnapshots = result?.quotaSnapshots;
+        return quotaSnapshots != null ? quotaSnapshots : null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Callback composition — merges user + telemetry callbacks
+// ---------------------------------------------------------------------------
+/**
+ * Compose two sets of EventCallbacks so both fire for each event.
+ * Primary (user) callbacks fire first, then secondary (telemetry).
+ * Telemetry callbacks are wrapped in try/catch — they must never
+ * break user-facing streaming.
+ */
+function composeCallbacks(primary, secondary) {
+    const composed = {};
+    const allKeys = new Set([
+        ...Object.keys(primary),
+        ...Object.keys(secondary),
+    ]);
+    for (const key of allKeys) {
+        const primaryValue = primary[key];
+        const secondaryValue = secondary[key];
+        const pFn = typeof primaryValue === 'function'
+            ? primaryValue
+            : undefined;
+        const sFn = typeof secondaryValue === 'function'
+            ? secondaryValue
+            : undefined;
+        if (pFn && sFn) {
+            composed[key] = (...args) => {
+                pFn(...args);
+                try {
+                    sFn(...args);
+                }
+                catch (err) {
+                    console.debug('Telemetry callback error:', key, err);
+                }
+            };
+        }
+        else if (pFn) {
+            composed[key] = pFn;
+        }
+        else if (sFn) {
+            const wrappedSFn = sFn;
+            composed[key] = (...args) => {
+                try {
+                    wrappedSFn(...args);
+                }
+                catch (err) {
+                    console.debug('Telemetry callback error:', key, err);
+                }
+            };
+        }
+    }
+    return composed;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Wingman configuration loader.
+ *
+ * Provides `defineConfig()` for type-safe configuration and `resolveConfig()`
+ * to deep-merge user config with defaults.
+ */
+import type { WingmanConfig } from './types.js';
+/** Type-safe config helper — provides autocomplete and validation. */
+export declare function defineConfig(config: WingmanConfig): WingmanConfig;
+/** Default configuration values. */
+export declare const DEFAULT_CONFIG: Required<WingmanConfig>;
+/** Deep-merge user config with defaults. */
+export declare function resolveConfig(userConfig: WingmanConfig): Required<WingmanConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAEjE;AAED,oCAAoC;AACpC,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,aAAa,CAgClD,CAAC;AAEF,4CAA4C;AAC5C,wBAAgB,aAAa,CAAC,UAAU,EAAE,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,CAQhF"}

package/dist/config.js

@@ -0,0 +1,55 @@
+/**
+ * Wingman configuration loader.
+ *
+ * Provides `defineConfig()` for type-safe configuration and `resolveConfig()`
+ * to deep-merge user config with defaults.
+ */
+/** Type-safe config helper — provides autocomplete and validation. */
+export function defineConfig(config) {
+    return config;
+}
+/** Default configuration values. */
+export const DEFAULT_CONFIG = {
+    systemPrompt: 'You are a helpful assistant.',
+    model: 'claude-sonnet-4',
+    reasoningEffort: 'medium',
+    mcpServers: {},
+    skillDirectories: [],
+    customAgents: [],
+    tools: [],
+    ui: {
+        title: 'Wingman',
+        theme: 'system',
+        logo: undefined,
+        welcomeMessage: 'How can I help?',
+        suggestions: [],
+        colors: {},
+        showTokenUsage: true,
+        showModelPicker: true,
+        showModeSwitcher: true,
+        showDebugPanel: false,
+    },
+    server: {
+        port: 3000,
+        cors: true,
+        transport: 'sse',
+    },
+    telemetry: {
+        enabled: false,
+        exporter: 'console',
+        endpoint: undefined,
+        serviceName: 'wingman',
+        captureContent: false,
+    },
+};
+/** Deep-merge user config with defaults. */
+export function resolveConfig(userConfig) {
+    return {
+        ...DEFAULT_CONFIG,
+        ...userConfig,
+        ui: { ...DEFAULT_CONFIG.ui, ...userConfig.ui },
+        server: { ...DEFAULT_CONFIG.server, ...userConfig.server },
+        telemetry: { ...DEFAULT_CONFIG.telemetry, ...userConfig.telemetry },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,sEAAsE;AACtE,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,oCAAoC;AACpC,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD,YAAY,EAAE,8BAA8B;IAC5C,KAAK,EAAE,iBAAiB;IACxB,eAAe,EAAE,QAAQ;IACzB,UAAU,EAAE,EAAE;IACd,gBAAgB,EAAE,EAAE;IACpB,YAAY,EAAE,EAAE;IAChB,KAAK,EAAE,EAAE;IACT,EAAE,EAAE;QACF,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,SAAS;QACf,cAAc,EAAE,iBAAiB;QACjC,WAAW,EAAE,EAAE;QACf,MAAM,EAAE,EAAE;QACV,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,IAAI;QACtB,cAAc,EAAE,KAAK;KACtB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,IAAI;QACV,SAAS,EAAE,KAAK;KACjB;IACD,SAAS,EAAE;QACT,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,SAAS;QACtB,cAAc,EAAE,KAAK;KACtB;CACF,CAAC;AAEF,4CAA4C;AAC5C,MAAM,UAAU,aAAa,CAAC,UAAyB;IACrD,OAAO;QACL,GAAG,cAAc;QACjB,GAAG,UAAU;QACb,EAAE,EAAE,EAAE,GAAG,cAAc,CAAC,EAAE,EAAE,GAAG,UAAU,CAAC,EAAE,EAAE;QAC9C,MAAM,EAAE,EAAE,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE;QAC1D,SAAS,EAAE,EAAE,GAAG,cAAc,CAAC,SAAS,EAAE,GAAG,UAAU,CAAC,SAAS,EAAE;KACpE,CAAC;AACJ,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,77 @@
+/**
+ * EventRouter — Routes all 51 SDK event types to typed callbacks.
+ *
+ * Clean-room implementation that exhaustively handles every event type
+ * the Copilot SDK emits. No event is silently dropped.
+ */
+import type { UsageData, ToolExecution } from './types.js';
+export interface EventCallbacks {
+    onDelta?: (content: string) => void;
+    onReasoningDelta?: (content: string, reasoningId?: string) => void;
+    onReasoning?: (content: string, reasoningId?: string) => void;
+    onUsage?: (usage: UsageData) => void;
+    onTurnStart?: (turnId: string) => void;
+    onTurnEnd?: (turnId: string) => void;
+    onIntent?: (intent: string) => void;
+    onToolStart?: (tool: Pick<ToolExecution, 'toolCallId' | 'toolName' | 'arguments'> & {
+        mcpServerName?: string;
+        mcpToolName?: string;
+    }) => void;
+    onToolComplete?: (toolCallId: string, toolName: string, result: string) => void;
+    onToolProgress?: (toolCallId: string, message: string) => void;
+    onToolPartialResult?: (toolCallId: string, result: string) => void;
+    onToolUserRequested?: (toolCallId: string, toolName: string) => void;
+    onSkillInvoked?: (name: string, pluginName?: string, path?: string) => void;
+    onSubagentStarted?: (toolCallId: string, name: string, displayName?: string, description?: string) => void;
+    onSubagentCompleted?: (toolCallId: string, name: string, displayName?: string) => void;
+    onSubagentFailed?: (toolCallId: string, name: string, error?: string) => void;
+    onSubagentSelected?: (name: string) => void;
+    onSubagentDeselected?: (name: string) => void;
+    onSessionStart?: (sessionId: string) => void;
+    onSessionResume?: (sessionId: string) => void;
+    onSessionShutdown?: () => void;
+    onSessionIdle?: () => void;
+    onError?: (message: string) => void;
+    onInfo?: (infoType: string, message: string) => void;
+    onWarning?: (warningType: string, message: string) => void;
+    onModelChange?: (model: string) => void;
+    onTruncation?: (data: Record<string, unknown>) => void;
+    onCompactionStart?: () => void;
+    onCompactionComplete?: () => void;
+    onContextChanged?: (data: Record<string, unknown>) => void;
+    onModeChanged?: (mode: string) => void;
+    onPlanChanged?: (plan: unknown) => void;
+    onTitleChanged?: (title: string) => void;
+    onPermissionRequested?: (data: Record<string, unknown>) => void;
+    onPermissionCompleted?: (data: Record<string, unknown>) => void;
+    onElicitationRequested?: (data: Record<string, unknown>) => void;
+    onElicitationCompleted?: (data: Record<string, unknown>) => void;
+    onUserInputRequested?: (data: Record<string, unknown>) => void;
+    onUserInputCompleted?: (data: Record<string, unknown>) => void;
+    onUserMessage?: (content: string) => void;
+    onSystemMessage?: (content: string) => void;
+    onAssistantMessage?: (content: string) => void;
+    onPendingMessagesModified?: (data: Record<string, unknown>) => void;
+    onWorkspaceFileChanged?: (path: string) => void;
+    onSnapshotRewind?: (data: Record<string, unknown>) => void;
+    onHookStart?: (name: string) => void;
+    onHookEnd?: (name: string) => void;
+    onTaskComplete?: (data: Record<string, unknown>) => void;
+    onHandoff?: (data: Record<string, unknown>) => void;
+    onUsageInfo?: (data: Record<string, unknown>) => void;
+    onUnhandledEvent?: (type: string, data: Record<string, unknown>) => void;
+}
+export declare class EventRouter {
+    private callbacks;
+    private debug;
+    constructor(callbacks: EventCallbacks, debug?: boolean);
+    /**
+     * Route a SessionEvent to the appropriate callback.
+     * Every event type is explicitly handled — nothing is silently dropped.
+     */
+    route(event: {
+        type: string;
+        data?: any;
+    }): void;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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