@theia/ai-tool-sketchpad 1.74.0-next.53

package/src/browser/style/index.css

@@ -0,0 +1,387 @@
+/********************************************************************************
+ * Copyright (C) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+ ********************************************************************************/
+
+/* ===== Main Layout ===== */
+.ai-sketchpad-widget {
+    height: 100%;
+}
+
+.ai-sketchpad-container {
+    display: flex;
+    flex-direction: row;
+    height: 100%;
+    overflow: hidden;
+}
+
+/* ===== List Panel ===== */
+.ai-sketchpad-list {
+    width: 240px;
+    min-width: 180px;
+    max-width: 320px;
+    border-right: var(--theia-border-width) solid var(--theia-widget-border);
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+}
+
+.ai-sketchpad-list ul {
+    list-style: none;
+    padding: 0;
+    margin: 0;
+    flex: 1;
+    overflow-y: auto;
+}
+
+.ai-sketchpad-list-empty {
+    flex: 1;
+    padding: var(--theia-ui-padding);
+    color: var(--theia-descriptionForeground);
+    font-style: italic;
+}
+
+.ai-sketchpad-list .theia-TreeNode {
+    display: flex;
+    align-items: center;
+    gap: calc(var(--theia-ui-padding) * 0.75);
+    padding: calc(var(--theia-ui-padding) * 0.75) var(--theia-ui-padding);
+    cursor: pointer;
+    user-select: none;
+}
+
+.ai-sketchpad-list .theia-TreeNode:hover {
+    background-color: var(--theia-list-hoverBackground);
+}
+
+.ai-sketchpad-list .theia-TreeNode.theia-mod-selected {
+    background-color: var(--theia-list-activeSelectionBackground);
+    color: var(--theia-list-activeSelectionForeground);
+}
+
+.ai-sketchpad-list-item-icon {
+    flex: 0 0 auto;
+    color: var(--theia-icon-foreground);
+    opacity: 0.8;
+}
+
+.ai-sketchpad-list-item-text {
+    display: flex;
+    flex-direction: column;
+    flex: 1;
+    min-width: 0;
+    line-height: 1.3;
+}
+
+.ai-sketchpad-list-item-label {
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+.ai-sketchpad-list-item-meta {
+    font-size: var(--theia-ui-font-size0);
+    color: var(--theia-descriptionForeground);
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+/* Keep icon and meta legible against the selection highlight. */
+.ai-sketchpad-list .theia-TreeNode.theia-mod-selected .ai-sketchpad-list-item-icon,
+.ai-sketchpad-list .theia-TreeNode.theia-mod-selected .ai-sketchpad-list-item-meta {
+    color: inherit;
+    opacity: 0.75;
+}
+
+.ai-sketchpad-delete-icon {
+    opacity: 0;
+    cursor: pointer;
+    color: var(--theia-icon-foreground);
+    padding: calc(var(--theia-ui-padding) / 3);
+    border-radius: calc(var(--theia-ui-padding) / 2);
+    transition: opacity 0.15s, background-color 0.15s;
+}
+
+.ai-sketchpad-list .theia-TreeNode:hover .ai-sketchpad-delete-icon {
+    opacity: 0.6;
+}
+
+.ai-sketchpad-list .theia-TreeNode:hover .ai-sketchpad-delete-icon:hover {
+    opacity: 1;
+    background-color: var(--theia-list-hoverBackground);
+    color: var(--theia-errorForeground);
+}
+
+.ai-sketchpad-add-button {
+    padding: var(--theia-ui-padding);
+    border-top: var(--theia-border-width) solid var(--theia-widget-border);
+}
+
+.ai-sketchpad-add-button button {
+    width: 100%;
+    margin-left: 0;
+}
+
+/* ===== Detail Panel ===== */
+.ai-sketchpad-detail {
+    flex: 1;
+    overflow-y: auto;
+    padding: calc(var(--theia-ui-padding) * 2);
+    min-width: 0;
+}
+
+.ai-sketchpad-empty-state {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    gap: var(--theia-ui-padding);
+    height: 100%;
+    text-align: center;
+}
+
+.ai-sketchpad-empty-icon {
+    font-size: 32px;
+    color: var(--theia-descriptionForeground);
+    opacity: 0.5;
+}
+
+.ai-sketchpad-empty-message {
+    max-width: 260px;
+    color: var(--theia-descriptionForeground);
+    font-style: italic;
+}
+
+/* ===== Form ===== */
+.ai-sketchpad-form {
+    max-width: 700px;
+    display: flex;
+    flex-direction: column;
+    gap: calc(var(--theia-ui-padding) * 2);
+}
+
+/* ===== Detail header (live tool signature) ===== */
+.ai-sketchpad-tool-header {
+    display: flex;
+    flex-direction: column;
+    gap: calc(var(--theia-ui-padding) * 0.75);
+    padding-bottom: calc(var(--theia-ui-padding) * 1.5);
+    border-bottom: var(--theia-border-width) solid var(--theia-widget-border);
+}
+
+.ai-sketchpad-tool-title {
+    display: flex;
+    align-items: center;
+    gap: calc(var(--theia-ui-padding) * 0.75);
+    min-width: 0;
+}
+
+.ai-sketchpad-tool-title-icon {
+    flex: 0 0 auto;
+    font-size: var(--theia-ui-font-size3);
+    color: var(--theia-icon-foreground);
+}
+
+.ai-sketchpad-tool-title-name {
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    font-size: var(--theia-ui-font-size3);
+    font-weight: 600;
+}
+
+.ai-sketchpad-mode-badge {
+    flex: 0 0 auto;
+    margin-left: auto;
+    padding: 1px calc(var(--theia-ui-padding) * 0.75);
+    border-radius: 999px;
+    font-size: var(--theia-ui-font-size0);
+    white-space: nowrap;
+    background-color: var(--theia-badge-background);
+    color: var(--theia-badge-foreground);
+}
+
+.ai-sketchpad-tool-signature {
+    overflow-x: auto;
+    white-space: pre;
+    padding: calc(var(--theia-ui-padding) * 0.5) calc(var(--theia-ui-padding) * 0.75);
+    border-left: 2px solid var(--theia-focusBorder);
+    border-radius: calc(var(--theia-ui-padding) / 2);
+    font-family: var(--theia-code-font-family);
+    font-size: var(--theia-code-font-size);
+    color: var(--theia-descriptionForeground);
+    background-color: var(--theia-textCodeBlock-background);
+}
+
+.ai-sketchpad-form-field {
+    display: flex;
+    flex-direction: column;
+    gap: calc(var(--theia-ui-padding) * 0.5);
+}
+
+.ai-sketchpad-form-field > label {
+    font-weight: 600;
+    font-size: var(--theia-ui-font-size2);
+    color: var(--theia-foreground);
+}
+
+.ai-sketchpad-textarea {
+    resize: vertical;
+    min-height: 60px;
+}
+
+.ai-sketchpad-textarea-code {
+    font-family: var(--theia-code-font-family);
+    font-size: var(--theia-code-font-size);
+}
+
+.ai-sketchpad-hint {
+    font-size: var(--theia-ui-font-size0);
+    color: var(--theia-descriptionForeground);
+    font-style: italic;
+    margin-top: calc(var(--theia-ui-padding) * 0.25);
+}
+
+/* ===== Parameters ===== */
+.ai-sketchpad-no-params {
+    color: var(--theia-descriptionForeground);
+    font-style: italic;
+    padding: calc(var(--theia-ui-padding) * 0.5) 0;
+}
+
+.ai-sketchpad-param-list {
+    display: flex;
+    flex-direction: column;
+    gap: calc(var(--theia-ui-padding) * 0.5);
+}
+
+.ai-sketchpad-param-item {
+    border: var(--theia-border-width) solid var(--theia-widget-border);
+    border-radius: calc(var(--theia-ui-padding) * 2 / 3);
+    padding: calc(var(--theia-ui-padding) * 0.75);
+    background-color: var(--theia-editor-background);
+}
+
+.ai-sketchpad-param-row {
+    display: flex;
+    align-items: center;
+    gap: calc(var(--theia-ui-padding) * 0.5);
+    flex-wrap: wrap;
+}
+
+.ai-sketchpad-param-name {
+    flex: 1;
+    min-width: 100px;
+    max-width: 160px;
+}
+
+.ai-sketchpad-param-desc {
+    flex: 2;
+    min-width: 120px;
+}
+
+.ai-sketchpad-param-type {
+    width: 100px;
+    height: stretch;
+}
+
+.ai-sketchpad-param-required {
+    display: inline-flex;
+    align-items: center;
+    gap: calc(var(--theia-ui-padding) * 2 / 3);
+    padding-left: var(--theia-ui-padding);
+    cursor: pointer;
+    user-select: none;
+    font-size: var(--theia-ui-font-size0);
+    color: var(--theia-descriptionForeground);
+    white-space: nowrap;
+}
+
+.ai-sketchpad-param-required input[type="checkbox"] {
+    margin: 0;
+}
+
+.ai-sketchpad-param-delete {
+    cursor: pointer;
+    color: var(--theia-icon-foreground);
+    padding: calc(var(--theia-ui-padding) / 3);
+    border-radius: calc(var(--theia-ui-padding) / 2);
+    transition: background-color 0.15s;
+}
+
+.ai-sketchpad-param-delete:hover {
+    background-color: var(--theia-list-hoverBackground);
+    color: var(--theia-errorForeground);
+}
+
+/* ===== Nested Parameters ===== */
+.ai-sketchpad-param-nested {
+    margin-top: calc(var(--theia-ui-padding) * 0.5);
+    padding-left: calc(var(--theia-ui-padding) * 1.5);
+    border-left: calc(var(--theia-border-width) * 2) solid var(--theia-widget-border);
+}
+
+.ai-sketchpad-param-depth-1 {
+    margin-left: calc(var(--theia-ui-padding) * 3);
+}
+
+.ai-sketchpad-param-depth-2 {
+    margin-left: calc(var(--theia-ui-padding) * 6);
+}
+
+.ai-sketchpad-add-nested-btn {
+    margin-top: calc(var(--theia-ui-padding) * 0.5);
+    align-self: flex-start;
+}
+
+.ai-sketchpad-add-param-btn {
+    margin-top: calc(var(--theia-ui-padding) * 0.5);
+    align-self: flex-start;
+}
+
+/* ===== Array Item Type ===== */
+.ai-sketchpad-param-array-type {
+    display: flex;
+    align-items: center;
+    gap: calc(var(--theia-ui-padding) * 0.5);
+    margin-top: calc(var(--theia-ui-padding) * 0.5);
+    padding-left: calc(var(--theia-ui-padding) * 1.5);
+    font-size: var(--theia-ui-font-size0);
+    color: var(--theia-descriptionForeground);
+}
+
+.ai-sketchpad-param-array-type select {
+    width: 100px;
+}
+
+/* ===== Validation ===== */
+.ai-sketchpad-input-error {
+    border-color: var(--theia-inputValidation-errorBorder) !important;
+}
+
+.ai-sketchpad-error {
+    margin-top: calc(var(--theia-ui-padding) * 0.5);
+    font-size: var(--theia-ui-font-size0);
+    color: var(--theia-errorForeground);
+}
+
+/* ===== Actions ===== */
+.ai-sketchpad-actions {
+    display: flex;
+    justify-content: flex-end;
+    gap: var(--theia-ui-padding);
+    padding-top: var(--theia-ui-padding);
+    border-top: var(--theia-border-width) solid var(--theia-widget-border);
+}

package/src/common/index.ts

@@ -0,0 +1,17 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+export * from './sketched-tool';

package/src/common/sketched-tool.ts

@@ -0,0 +1,118 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { Event, nls } from '@theia/core';
+
+export type SketchedToolParameterType = 'string' | 'number' | 'integer' | 'boolean' | 'object' | 'array';
+
+export type SketchedToolReturnMode = 'static' | 'askAtRuntime';
+
+export interface SketchedToolParameterDefinition {
+    name: string;
+    description: string;
+    type: SketchedToolParameterType;
+    required?: boolean;
+    /** For type 'object': nested properties (max 2 levels) */
+    properties?: SketchedToolParameterDefinition[];
+    /** For type 'array': item type */
+    itemType?: 'string' | 'number' | 'integer' | 'boolean' | 'object';
+    /** For type 'array' with itemType 'object': properties of the item object */
+    itemProperties?: SketchedToolParameterDefinition[];
+}
+
+export interface SketchedToolDefinition {
+    id: string;
+    name: string;
+    description: string;
+    parameters: SketchedToolParameterDefinition[];
+    returnMode: SketchedToolReturnMode;
+    staticReturn: string;
+}
+
+export namespace SketchedToolDefinition {
+    export function is(obj: unknown): obj is SketchedToolDefinition {
+        // eslint-disable-next-line no-null/no-null
+        if (typeof obj !== 'object' || obj === null) {
+            return false;
+        }
+        const candidate = obj as Record<string, unknown>;
+        if (typeof candidate.id !== 'string' || typeof candidate.name !== 'string') {
+            return false;
+        }
+        if (typeof candidate.description !== 'string') {
+            return false;
+        }
+        if (!Array.isArray(candidate.parameters)) {
+            return false;
+        }
+        if (candidate.returnMode !== undefined && candidate.returnMode !== 'static' && candidate.returnMode !== 'askAtRuntime') {
+            return false;
+        }
+        // returnMode and staticReturn are optional here; normalize() fills in defaults.
+        if (candidate.staticReturn !== undefined && typeof candidate.staticReturn !== 'string') {
+            return false;
+        }
+        return true;
+    }
+
+    export function normalize(obj: SketchedToolDefinition): SketchedToolDefinition {
+        return {
+            ...obj,
+            returnMode: obj.returnMode ?? 'static',
+            staticReturn: obj.staticReturn ?? ''
+        };
+    }
+
+    /**
+     * Pattern accepted as a tool name by most LLM providers (e.g. OpenAI, Anthropic).
+     * The name is also used as the id under which the tool is registered, so it must be unique.
+     */
+    export const NAME_PATTERN = /^[a-zA-Z0-9_-]{1,128}$/;
+
+    /**
+     * Validates a tool name for use as a registered tool id.
+     *
+     * @param name the name to validate
+     * @param existingTools the currently defined tools, used to check for name collisions
+     * @param selfId the id of the tool being edited, so it is not compared against itself
+     * @returns a localized error message if the name is invalid, otherwise `undefined`
+     */
+    export function validateName(name: string, existingTools: SketchedToolDefinition[], selfId?: string): string | undefined {
+        const trimmed = name.trim();
+        if (!trimmed) {
+            return nls.localize('theia/ai-tool-sketchpad/nameEmpty', 'Tool name must not be empty.');
+        }
+        if (!NAME_PATTERN.test(trimmed)) {
+            return nls.localize('theia/ai-tool-sketchpad/nameInvalid',
+                'Tool name may only contain letters, digits, underscores and hyphens (1-128 characters).');
+        }
+        if (existingTools.some(tool => tool.id !== selfId && tool.name.trim() === trimmed)) {
+            return nls.localize('theia/ai-tool-sketchpad/nameDuplicate', 'A tool with this name already exists.');
+        }
+        return undefined;
+    }
+}
+
+export const SKETCHED_TOOLS_PROVIDER_NAME = 'ai-tool-sketchpad';
+
+export const SketchedToolService = Symbol('SketchedToolService');
+export interface SketchedToolService {
+    getSketchedTools(): SketchedToolDefinition[];
+    addSketchedTool(tool: SketchedToolDefinition): Promise<void>;
+    updateSketchedTool(tool: SketchedToolDefinition): Promise<void>;
+    removeSketchedTool(toolId: string): Promise<void>;
+    onDidChangeSketchedTools: Event<void>;
+}

package/src/package.spec.ts

@@ -0,0 +1,25 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+/*
+ * This is a placeholder for tests that the extension package should implement
+ * but as yet does not.
+ * Please delete this file when a real test is implemented.
+ */
+
+describe('ai-tool-sketchpad package', () => {
+    it('placeholder to enable mocha', () => true);
+});