@lydt/geogebra-studio 0.0.0-stage → 0.4.0-rc.2

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import 'dotenv/config';
+export { McpServer } from './server';
+export { toolRegistry } from './tools';
+export * from './types/mcp';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAoEvB,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,84 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolRegistry = exports.McpServer = void 0;
+require("dotenv/config");
+const server_1 = require("./server");
+const logger_1 = __importDefault(require("./utils/logger"));
+const app_info_1 = require("./utils/app-info");
+/**
+ * Main entry point for the GeoGebra Studio server
+ */
+async function main() {
+    try {
+        const appInfo = (0, app_info_1.getAppInfo)();
+        // Server configuration
+        const config = {
+            name: 'GeoGebra Studio',
+            version: appInfo.version,
+            description: appInfo.description,
+            logLevel: process.env['LOG_LEVEL'] || 'info'
+        };
+        // Create and start the MCP server
+        const server = new server_1.McpServer(config);
+        // Set up graceful shutdown
+        const shutdown = async (signal) => {
+            logger_1.default.info(`Received ${signal}, shutting down gracefully...`);
+            try {
+                await server.stop();
+                process.exit(0);
+            }
+            catch (error) {
+                logger_1.default.error('Error during shutdown:', error);
+                process.exit(1);
+            }
+        };
+        // Handle shutdown signals
+        process.on('SIGTERM', () => shutdown('SIGTERM'));
+        process.on('SIGINT', () => shutdown('SIGINT'));
+        // Handle uncaught exceptions
+        process.on('uncaughtException', (error) => {
+            logger_1.default.error('Uncaught exception:', error);
+            process.exit(1);
+        });
+        process.on('unhandledRejection', (reason, promise) => {
+            logger_1.default.error('Unhandled rejection at:', promise, 'reason:', reason);
+            process.exit(1);
+        });
+        // Start the server
+        await server.start();
+    }
+    catch (error) {
+        logger_1.default.error('Failed to start server:', error);
+        process.exit(1);
+    }
+}
+// Start the application
+if (require.main === module) {
+    main().catch((error) => {
+        logger_1.default.error('Application startup failed:', error);
+        process.exit(1);
+    });
+}
+var server_2 = require("./server");
+Object.defineProperty(exports, "McpServer", { enumerable: true, get: function () { return server_2.McpServer; } });
+var tools_1 = require("./tools");
+Object.defineProperty(exports, "toolRegistry", { enumerable: true, get: function () { return tools_1.toolRegistry; } });
+__exportStar(require("./types/mcp"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA,yBAAuB;AACvB,qCAAqC;AAErC,4DAAoC;AACpC,+CAA8C;AAE9C;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,qBAAU,GAAE,CAAC;QAE7B,uBAAuB;QACvB,MAAM,MAAM,GAAoB;YAC9B,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,QAAQ,EAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAyC,IAAI,MAAM;SACtF,CAAC;QAEF,kCAAkC;QAClC,MAAM,MAAM,GAAG,IAAI,kBAAS,CAAC,MAAM,CAAC,CAAC;QAErC,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;YACxC,gBAAM,CAAC,IAAI,CAAC,YAAY,MAAM,+BAA+B,CAAC,CAAC;YAC/D,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,gBAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;gBAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC;QAEF,0BAA0B;QAC1B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QACjD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAE/C,6BAA6B;QAC7B,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;YACxC,gBAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;YACnD,gBAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,mBAAmB;QACnB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAEvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gBAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,wBAAwB;AACxB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACrB,gBAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mCAAqC;AAA5B,mGAAA,SAAS,OAAA;AAClB,iCAAuC;AAA9B,qGAAA,YAAY,OAAA;AACrB,8CAA4B"}

package/dist/server.d.ts

@@ -0,0 +1,35 @@
+import { EventEmitter } from 'events';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { McpServerConfig } from './types/mcp';
+/** Official SDK owns framing, negotiation, notifications, and transport lifecycle. */
+export declare class McpServer extends EventEmitter {
+    private config;
+    private sdk?;
+    private http?;
+    private connections;
+    private running;
+    private queue;
+    constructor(config: McpServerConfig);
+    createProtocolServer(): Server;
+    start(): Promise<void>;
+    /** Loopback-only, single-user HTTP. Deploy behind HTTPS + authentication for remote use. */
+    startHttp(port: number): Promise<void>;
+    stop(): Promise<void>;
+    getStatus(): {
+        isRunning: boolean;
+        toolCount: number;
+        uptime: number;
+        name: string;
+        version: string;
+        description: string;
+        logLevel?: "error" | "warn" | "info" | "debug";
+    };
+    getConfig(): {
+        name: string;
+        version: string;
+        description: string;
+        logLevel?: "error" | "warn" | "info" | "debug";
+    };
+    isServerRunning(): boolean;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAMtC,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAWnE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAY9C,sFAAsF;AACtF,qBAAa,SAAU,SAAQ,YAAY;IAM7B,OAAO,CAAC,MAAM;IAL1B,OAAO,CAAC,GAAG,CAAC,CAAS;IACrB,OAAO,CAAC,IAAI,CAAC,CAAa;IAC1B,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAuC;gBAChC,MAAM,EAAE,eAAe;IAE3C,oBAAoB,IAAI,MAAM;IA6ExB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,4FAA4F;IACtF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,SAAS;;;;;;;;;IACT,SAAS;;;;;;IACT,eAAe;CAChB"}

package/dist/server.js

@@ -0,0 +1,187 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpServer = void 0;
+const events_1 = require("events");
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const url_1 = require("url");
+const workspace_1 = require("./export/workspace");
+const http_1 = require("http");
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const ajv_1 = __importDefault(require("ajv"));
+const tools_1 = require("./tools");
+const geogebra_tools_1 = require("./tools/geogebra-tools");
+const instance_pool_1 = require("./utils/performance/instance-pool");
+const guidance = 'Use geogebra_build_artifact by default to produce a checked local HTML with a packed editable GGB and preview. geogebra_create_html is an unverified command-template alternative. ' +
+    'When saving files, pass workspace as the absolute user project directory; never use the installed plugin cache as the output directory. MCP roots are used when available. ' +
+    'For server-side work use geogebra_eval_commands, then native exports. ' +
+    'All TikZ exports use native PGF followed by Gikz; never return raw PGF as a final export. ' +
+    'Use geogebra_get_semantic_scene before semantic export; report unsupported objects and coordinate fallbacks. ' +
+    'Use geogebra_api_list_methods and geogebra_api_call for public Apps API methods not covered by focused tools. ' +
+    'All server-side tools share one construction. Do not interleave independent diagrams.';
+/** Official SDK owns framing, negotiation, notifications, and transport lifecycle. */
+class McpServer extends events_1.EventEmitter {
+    config;
+    sdk;
+    http;
+    connections = new Set();
+    running = false;
+    queue = Promise.resolve();
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    createProtocolServer() {
+        const sdk = new index_js_1.Server({ name: this.config.name, version: this.config.version }, {
+            capabilities: { tools: {}, resources: {}, prompts: {} }, instructions: guidance,
+        });
+        const ajv = new ajv_1.default({ strict: false, allErrors: true });
+        const core = new Set(['geogebra_build_artifact', 'server_info', 'geogebra_eval_commands', 'geogebra_clear_construction',
+            'geogebra_get_objects', 'geogebra_instance_status', 'geogebra_auto_zoom', 'geogebra_load_ggb',
+            'geogebra_export_ggb', 'geogebra_export_png', 'geogebra_export_svg', 'geogebra_export_pdf',
+            'geogebra_create_html', 'geogebra_export_html', 'geogebra_get_semantic_scene',
+            'geogebra_export_source', 'geogebra_export_tikz', 'geogebra_clean_tikz', 'geogebra_api_list_methods', 'geogebra_api_call', 'geogebra_api_get_callback_events']);
+        const tools = tools_1.toolRegistry.getTools().filter(t => process.env['GEOGEBRA_TOOL_PROFILE'] !== 'core' || core.has(t.name))
+            .map(tool => tool.inputSchema.properties['filename'] ? { ...tool, inputSchema: { ...tool.inputSchema, properties: { ...tool.inputSchema.properties, workspace: { type: 'string', description: 'Absolute user workspace directory for saved files. Pass this when the client does not provide MCP roots; never use the plugin cache directory.' } } } } : tool)
+            .sort((a, b) => a.name.localeCompare(b.name));
+        const validators = new Map(tools.map(t => [t.name, ajv.compile(t.inputSchema)]));
+        sdk.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({ tools }));
+        sdk.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+            const { name, arguments: args = {} } = request.params;
+            const validate = validators.get(name);
+            if (!validate)
+                throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidParams, `Unknown tool: ${name}`);
+            if (!validate(args))
+                throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidParams, ajv.errorsText(validate.errors));
+            // Queue the entire operation, including export, to avoid cross-request mutation races.
+            const operation = this.queue.then(async () => {
+                try {
+                    let workspace = args['workspace'];
+                    if (args['filename'] !== undefined && !workspace && sdk.getClientCapabilities()?.roots) {
+                        const roots = await sdk.listRoots({}, { timeout: 5000 });
+                        const folders = roots.roots.filter(root => root.uri.startsWith('file:')).map(root => (0, url_1.fileURLToPath)(root.uri));
+                        workspace = folders.length === 1 ? folders[0] : folders.find(root => typeof args['filename'] === 'string' && path_1.default.isAbsolute(args['filename']) && args['filename'].startsWith(root + path_1.default.sep));
+                    }
+                    if (args['filename'] !== undefined && !workspace && process.env['GEOGEBRA_PLUGIN_RUNTIME'] === '1' && !process.env['VSCODE_WORKSPACE_FOLDER'])
+                        throw new Error('Provide workspace as the absolute user project directory. The plugin cache is not an output workspace.');
+                    const result = await (0, workspace_1.inWorkspace)(workspace, () => tools_1.toolRegistry.executeTool(name, args));
+                    if (!result.structuredContent && result.content.length === 1 && result.content[0]?.text) {
+                        try {
+                            const value = JSON.parse(result.content[0].text);
+                            if (value && typeof value === 'object' && !Array.isArray(value)) {
+                                return { ...result, structuredContent: value };
+                            }
+                        }
+                        catch { /* Existing plain text tools remain valid. */ }
+                    }
+                    return result;
+                }
+                catch (error) {
+                    return { content: [{ type: 'text', text: error instanceof Error ? error.message : String(error) }], isError: true };
+                }
+            });
+            this.queue = operation.catch(() => undefined);
+            return operation;
+        });
+        sdk.setRequestHandler(types_js_1.ListResourcesRequestSchema, async () => ({ resources: [{
+                    uri: 'geogebra://guide', name: 'GeoGebra construction and export guide', mimeType: 'text/plain',
+                }, { uri: 'ui://geogebra/preview.html', name: 'GeoGebra preview', mimeType: 'text/html;profile=mcp-app' }] }));
+        sdk.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (request) => {
+            if (request.params.uri === 'ui://geogebra/preview.html')
+                return { contents: [{
+                            uri: request.params.uri, mimeType: 'text/html;profile=mcp-app',
+                            text: (0, fs_1.readFileSync)(path_1.default.join(__dirname, 'widget.html'), 'utf8'),
+                            _meta: { ui: { csp: {
+                                        resourceDomains: ['https://www.geogebra.org', 'https://geogebra.org', 'https://cdn.geogebra.org'],
+                                        connectDomains: ['https://www.geogebra.org', 'https://geogebra.org', 'https://cdn.geogebra.org'],
+                                    } } },
+                        }] };
+            if (request.params.uri !== 'geogebra://guide')
+                throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidParams, 'Unknown resource');
+            return { contents: [{ uri: 'geogebra://guide', mimeType: 'text/plain', text: guidance }] };
+        });
+        sdk.setRequestHandler(types_js_1.ListPromptsRequestSchema, async () => ({ prompts: [{
+                    name: 'construct-geometry', description: 'Build an editable, print-style GeoGebra construction',
+                    arguments: [{ name: 'problem', description: 'Geometry definitions and target exports', required: true }],
+                }] }));
+        sdk.setRequestHandler(types_js_1.GetPromptRequestSchema, async (request) => {
+            if (request.params.name !== 'construct-geometry' || !request.params.arguments?.['problem']) {
+                throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidParams, 'construct-geometry requires problem');
+            }
+            return { messages: [{ role: 'user', content: { type: 'text',
+                            text: `${guidance}\n\n${request.params.arguments['problem']}` } }] };
+        });
+        return sdk;
+    }
+    async start() {
+        if (this.running)
+            return;
+        this.sdk = this.createProtocolServer();
+        this.sdk.onclose = () => { if (this.running)
+            void this.stop(); };
+        await this.sdk.connect(new stdio_js_1.StdioServerTransport());
+        this.running = true;
+        this.emit('started');
+    }
+    /** Loopback-only, single-user HTTP. Deploy behind HTTPS + authentication for remote use. */
+    async startHttp(port) {
+        if (!Number.isInteger(port) || port < 1 || port > 65535)
+            throw new Error('Invalid HTTP port');
+        this.http = (0, http_1.createServer)(async (req, res) => {
+            if (req.url !== '/mcp') {
+                res.writeHead(404).end();
+                return;
+            }
+            if (req.headers.origin && ![`http://localhost:${port}`, `http://127.0.0.1:${port}`].includes(req.headers.origin)) {
+                res.writeHead(403).end('Origin forbidden');
+                return;
+            }
+            const host = req.headers.host;
+            if (!host || ![`localhost:${port}`, `127.0.0.1:${port}`].includes(host)) {
+                res.writeHead(403).end('Host forbidden');
+                return;
+            }
+            const sdk = this.createProtocolServer();
+            const transport = new streamableHttp_js_1.StreamableHTTPServerTransport({ enableJsonResponse: true });
+            this.connections.add(sdk);
+            res.on('close', () => { void sdk.close(); this.connections.delete(sdk); });
+            try {
+                await sdk.connect(transport);
+                await transport.handleRequest(req, res);
+            }
+            catch {
+                if (!res.headersSent)
+                    res.writeHead(500).end('MCP request failed');
+            }
+        });
+        await new Promise((resolve, reject) => {
+            this.http.once('error', reject);
+            this.http.listen(port, '127.0.0.1', resolve);
+        });
+        this.running = true;
+        this.emit('started');
+    }
+    async stop() {
+        this.running = false;
+        await this.queue;
+        await this.sdk?.close();
+        await Promise.all([...this.connections].map(s => s.close()));
+        if (this.http)
+            await new Promise((resolve, reject) => this.http.close(e => e ? reject(e) : resolve()));
+        await geogebra_tools_1.instancePool.cleanup();
+        await instance_pool_1.optimizedInstancePool.cleanup();
+        this.running = false;
+        this.emit('stopped');
+    }
+    getStatus() { return { ...this.config, isRunning: this.running, toolCount: tools_1.toolRegistry.getToolCount(), uptime: this.running ? process.uptime() : 0 }; }
+    getConfig() { return { ...this.config }; }
+    isServerRunning() { return this.running; }
+}
+exports.McpServer = McpServer;
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/studio/artifact.d.ts

@@ -0,0 +1,37 @@
+import { HtmlOptions } from '../export/html';
+/** Isolated native execution → packed GGB → reopen final viewer → save, never a shared pool reset. */
+export declare function buildArtifact(options: HtmlOptions & {
+    filename: string;
+}): Promise<{
+    content: ({
+        type: "text";
+        text: string;
+        mimeType?: never;
+        data?: never;
+    } | {
+        type: "image";
+        mimeType: string;
+        data: string;
+        text?: never;
+    })[];
+    structuredContent: {
+        success: boolean;
+        format: string;
+        filename: string;
+        previewFilename: string | undefined;
+        html: string;
+        engineVerified: boolean;
+        packedGgbVerified: boolean;
+        layoutChecks: {
+            loaded: boolean;
+            equalAxes: true;
+            viewWidth: number;
+            viewHeight: number;
+        };
+        renderVerified: boolean;
+        requiresNetwork: boolean;
+        objectCount: number;
+        note: string;
+    };
+}>;
+//# sourceMappingURL=artifact.d.ts.map

package/dist/studio/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../src/studio/artifact.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE/D,sGAAsG;AACtG,wBAAsB,aAAa,CAAC,OAAO,EAAC,WAAW,GAAG;IAAC,QAAQ,EAAC,MAAM,CAAA;CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2C1E"}

package/dist/studio/artifact.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildArtifact = buildArtifact;
+const promises_1 = require("fs/promises");
+const geogebra_instance_1 = require("../utils/geogebra-instance");
+const html_1 = require("../export/html");
+const files_1 = require("../export/files");
+/** Isolated native execution → packed GGB → reopen final viewer → save, never a shared pool reset. */
+async function buildArtifact(options) {
+    if (!/\.html$/i.test(options.filename))
+        throw new Error('filename must end in .html');
+    if (!options.ggbBase64 && !options.commands?.length)
+        throw new Error('Provide nonempty commands or a packed ggbBase64');
+    const engine = new geogebra_instance_1.GeoGebraInstance({ width: options.width || 1000, height: options.height || 800 });
+    let filename;
+    let previewFilename;
+    let committed = false;
+    try {
+        await engine.initialize();
+        await engine.renderHtml((0, html_1.constructionHtml)(options));
+        const checks = await engine.debugEvaluate(() => {
+            const api = window.ggbApplet, names = api.getAllObjectNames();
+            return { objects: names.length, undefinedVisibleObjects: names.filter((name) => api.getVisible(name) && !api.isDefined(name)) };
+        });
+        if (checks.undefinedVisibleObjects.length)
+            throw new Error('Undefined visible objects: ' + checks.undefinedVisibleObjects.join(', '));
+        const ggbBase64 = await engine.exportGGB();
+        const html = (0, html_1.constructionHtml)({ ...options, commands: [], ggbBase64 });
+        filename = await (0, files_1.saveText)(options.filename, html);
+        if (!filename)
+            throw new Error('Unable to save the final HTML artifact');
+        // Reopen the exact bytes written to disk so the preview and verification describe
+        // the delivered file, including its packed GGB payload.
+        await engine.renderHtml(await (0, promises_1.readFile)(filename, 'utf8'));
+        const layout = await engine.debugEvaluate(() => {
+            const api = window.ggbApplet, view = JSON.parse(api.getViewProperties(1));
+            return { ready: window.ggbReady === true, error: window.ggbError || null,
+                equalAxes: Math.abs(view.invXscale / view.invYscale - 1) < 1e-6, viewWidth: view.width, viewHeight: view.height };
+        });
+        if (!layout.ready || layout.error || !layout.equalAxes || layout.viewWidth <= 0 || layout.viewHeight <= 0)
+            throw new Error('Final HTML viewer verification failed: ' + JSON.stringify(layout));
+        const packedObjects = await engine.getAllObjectNames();
+        if (packedObjects.length !== checks.objects)
+            throw new Error('Packed GGB round trip changed object count');
+        const preview = await engine.capturePreview();
+        previewFilename = await (0, files_1.saveFile)(options.filename.replace(/\.html$/i, '.preview.png'), preview);
+        committed = true;
+        const data = { success: true, format: 'html', filename, previewFilename, html, engineVerified: true, packedGgbVerified: true,
+            layoutChecks: { loaded: true, equalAxes: layout.equalAxes, viewWidth: layout.viewWidth, viewHeight: layout.viewHeight }, renderVerified: true, requiresNetwork: true, objectCount: checks.objects,
+            note: 'Native execution, saved HTML reopen, packed GGB, equal axes and preview capture passed. Inspect the attached preview for visual quality.' };
+        return { content: [{ type: 'text', text: JSON.stringify(data) }, { type: 'image', mimeType: 'image/png', data: Buffer.from(preview).toString('base64') }], structuredContent: data };
+    }
+    finally {
+        if (!committed && previewFilename)
+            await (0, promises_1.unlink)(previewFilename);
+        if (!committed && filename)
+            await (0, promises_1.unlink)(filename);
+        await engine.cleanup();
+    }
+}
+//# sourceMappingURL=artifact.js.map

package/dist/studio/artifact.js.map

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

package/dist/studio/browser.d.ts

@@ -0,0 +1,7 @@
+export declare const browserCache: () => string;
+export declare const managedBrowserPath: () => string;
+export declare function browserCandidates(): string[];
+/** Runtime lookup is cheap; installation/doctor additionally probes launch compatibility. */
+export declare function resolveBrowser(): string;
+export declare function prepareBrowser(download?: boolean): Promise<string>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/studio/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/studio/browser.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,YAAY,cAAwH,CAAC;AAClJ,eAAO,MAAM,kBAAkB,cAAmH,CAAC;AACnJ,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAS5C;AACD,6FAA6F;AAC7F,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAED,wBAAsB,cAAc,CAAC,QAAQ,UAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUpE"}

package/dist/studio/browser.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.managedBrowserPath = exports.browserCache = void 0;
+exports.browserCandidates = browserCandidates;
+exports.resolveBrowser = resolveBrowser;
+exports.prepareBrowser = prepareBrowser;
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+const puppeteer_core_1 = __importDefault(require("puppeteer-core"));
+const { PUPPETEER_REVISIONS } = require('puppeteer-core');
+const browsers_1 = require("@puppeteer/browsers");
+const browserCache = () => path_1.default.join(process.env['GEOGEBRA_STUDIO_HOME'] || path_1.default.join(os_1.default.homedir(), '.cache', 'geogebra-studio'), 'browsers');
+exports.browserCache = browserCache;
+const managedBrowserPath = () => (0, browsers_1.computeExecutablePath)({ cacheDir: (0, exports.browserCache)(), browser: browsers_1.Browser.CHROME, buildId: PUPPETEER_REVISIONS.chrome });
+exports.managedBrowserPath = managedBrowserPath;
+function browserCandidates() {
+    const explicit = process.env['PUPPETEER_EXECUTABLE_PATH'];
+    if (explicit)
+        return [explicit];
+    return [
+        ...(process.platform === 'darwin' ? ['/Applications/Google Chrome.app/Contents/MacOS/Google Chrome', path_1.default.join(os_1.default.homedir(), 'Applications/Google Chrome.app/Contents/MacOS/Google Chrome')] : []),
+        ...(process.platform === 'win32' ? [process.env['PROGRAMFILES'], process.env['PROGRAMFILES(X86)'], process.env['LOCALAPPDATA']].filter((v) => !!v).map(v => path_1.default.join(v, 'Google', 'Chrome', 'Application', 'chrome.exe')) : []),
+        ...(process.platform === 'linux' ? ['/usr/bin/google-chrome', '/usr/bin/google-chrome-stable', '/usr/bin/chromium', '/usr/bin/chromium-browser'] : []),
+        (0, exports.managedBrowserPath)(),
+    ].filter((value, index, all) => all.indexOf(value) === index);
+}
+/** Runtime lookup is cheap; installation/doctor additionally probes launch compatibility. */
+function resolveBrowser() {
+    if (!process.env['PUPPETEER_EXECUTABLE_PATH']) {
+        try {
+            const selected = (0, fs_1.readFileSync)(path_1.default.join((0, exports.browserCache)(), 'selected.txt'), 'utf8').trim();
+            if ((0, fs_1.existsSync)(selected))
+                return selected;
+        }
+        catch { /* No prepared runtime yet. */ }
+    }
+    const executable = browserCandidates().find(file => (0, fs_1.existsSync)(file));
+    if (!executable)
+        throw new Error('Chrome is unavailable. Run: npx @lydt/geogebra-studio browser install');
+    return executable;
+}
+async function rememberBrowser(file) { await (0, promises_1.mkdir)((0, exports.browserCache)(), { recursive: true }); await (0, promises_1.writeFile)(path_1.default.join((0, exports.browserCache)(), 'selected.txt'), file, 'utf8'); return file; }
+async function prepareBrowser(download = false) {
+    const failures = [];
+    for (const file of browserCandidates().filter(file => (0, fs_1.existsSync)(file))) {
+        try {
+            const browser = await puppeteer_core_1.default.launch({ executablePath: file, headless: true, timeout: 15000 });
+            await browser.close();
+            return rememberBrowser(file);
+        }
+        catch (error) {
+            failures.push(`${file}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (!download)
+        throw new Error('No usable Chrome. Run: npx @lydt/geogebra-studio browser install. ' + failures.join('; '));
+    const installed = await (0, browsers_1.install)({ browser: browsers_1.Browser.CHROME, buildId: PUPPETEER_REVISIONS.chrome, cacheDir: (0, exports.browserCache)() });
+    const browser = await puppeteer_core_1.default.launch({ executablePath: installed.executablePath, headless: true, timeout: 15000 });
+    await browser.close();
+    return rememberBrowser(installed.executablePath);
+}
+//# sourceMappingURL=browser.js.map

package/dist/studio/browser.js.map

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

package/dist/studio/install.d.ts

@@ -0,0 +1,4 @@
+export declare function run(command: string, args: string[], cwd?: string): Promise<void>;
+/** A persistent catalog uses an npm source, never the temporary npx package directory. */
+export declare function installPlugin(local?: boolean): Promise<void>;
+//# sourceMappingURL=install.d.ts.map

package/dist/studio/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/studio/install.ts"],"names":[],"mappings":"AAKA,wBAAsB,GAAG,CAAC,OAAO,EAAC,MAAM,EAAC,IAAI,EAAC,MAAM,EAAE,EAAC,GAAG,CAAC,EAAC,MAAM,GAAE,OAAO,CAAC,IAAI,CAAC,CAKhF;AACD,0FAA0F;AAC1F,wBAAsB,aAAa,CAAC,KAAK,UAAM,GAAE,OAAO,CAAC,IAAI,CAAC,CA8B7D"}

package/dist/studio/install.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+exports.installPlugin = installPlugin;
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const promises_1 = require("fs/promises");
+const child_process_1 = require("child_process");
+const browser_1 = require("./browser");
+async function run(command, args, cwd) {
+    await new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)(command, args, { stdio: 'inherit', shell: false, ...(cwd ? { cwd } : {}) });
+        child.once('error', reject);
+        child.once('close', code => code === 0 ? resolve() : reject(new Error(`${command} exited with ${code}`)));
+    });
+}
+/** A persistent catalog uses an npm source, never the temporary npx package directory. */
+async function installPlugin(local = false) {
+    const metadata = JSON.parse(await (0, promises_1.readFile)(path_1.default.join(__dirname, '../../package.json'), 'utf8'));
+    const home = process.env['CODEX_HOME'] || path_1.default.join(os_1.default.homedir(), '.codex');
+    const root = path_1.default.join(home, 'geogebra-studio', 'marketplace');
+    await (0, promises_1.mkdir)(path_1.default.join(root, '.agents', 'plugins'), { recursive: true });
+    let source = { source: 'npm', package: metadata.name, version: metadata.version };
+    if (local) {
+        // Explicit authoring mode copies release files to a stable location and installs runtime deps.
+        const target = path_1.default.join(root, 'plugin');
+        try {
+            await (0, promises_1.access)(path_1.default.join(target, 'package.json'));
+            throw new Error(`Local package already exists: ${target}. Use a fresh CODEX_HOME for a clean test.`);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+        }
+        await (0, promises_1.mkdir)(target, { recursive: true });
+        const packageRoot = path_1.default.join(__dirname, '../..');
+        for (const entry of ['dist', 'runtime', 'gikz', 'skills', 'docs', 'plugin.json', 'mcp.json', '.codex-plugin', '.mcp.json', 'package.json', 'LICENSE', 'LICENSE-MIT', 'THIRD_PARTY_NOTICES.md'])
+            await (0, promises_1.cp)(path_1.default.join(packageRoot, entry), path_1.default.join(target, entry), { recursive: true });
+        const localPackagePath = path_1.default.join(target, 'package.json');
+        const localPackage = JSON.parse(await (0, promises_1.readFile)(localPackagePath, 'utf8'));
+        delete localPackage.devDependencies;
+        await (0, promises_1.writeFile)(localPackagePath, JSON.stringify(localPackage, null, 2) + '\n');
+        await run(process.platform === 'win32' ? 'npm.cmd' : 'npm', ['install', '--omit=dev', '--ignore-scripts', '--no-audit', '--no-fund'], target);
+        // Authoring mode tests the CLI installed at this stable path. Keep its command
+        // portable and resolve the entry point from the plugin root.
+        const localServer = { command: 'node', args: ['dist/cli.js', 'mcp'], cwd: './', env: { GEOGEBRA_TOOL_PROFILE: 'core', GEOGEBRA_PLUGIN_RUNTIME: '1' } };
+        await (0, promises_1.writeFile)(path_1.default.join(target, 'mcp.json'), JSON.stringify({ $schema: 'https://agent-plugins.org/schemas/1.0.0/mcp.schema.json', mcpServers: { geogebra: { type: 'stdio', ...localServer } } }, null, 2) + '\n');
+        await (0, promises_1.writeFile)(path_1.default.join(target, '.mcp.json'), JSON.stringify({ mcpServers: { geogebra: localServer } }, null, 2) + '\n');
+        source = { source: 'local', path: './plugin' };
+    }
+    await (0, promises_1.writeFile)(path_1.default.join(root, '.agents/plugins/marketplace.json'), JSON.stringify({ name: 'geogebra-studio', interface: { displayName: 'GeoGebra Studio' }, plugins: [{ name: 'geogebra-studio', source, policy: { installation: 'AVAILABLE', authentication: 'ON_INSTALL' }, category: 'Education' }] }, null, 2) + '\n');
+    await run('codex', ['plugin', 'marketplace', 'add', root]);
+    await run('codex', ['plugin', 'add', 'geogebra-studio@geogebra-studio']);
+    const executable = await (0, browser_1.prepareBrowser)(true);
+    console.log(`GeoGebra Studio ${metadata.version} installed. Browser: ${executable}\nStart a new Codex session and invoke @geogebra-studio. Existing geogebra-geometry installations were not removed.`);
+}
+//# sourceMappingURL=install.js.map