@industry-theme/xterm-terminal-panel 0.1.0 → 0.1.1

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export { TerminalPanel } from './src/panels/TerminalPanel';
 export { TabbedTerminalPanel } from './src/panels/TabbedTerminalPanel';
 export type { TerminalTabContentRef } from './src/panels/TabbedTerminalPanel';
 export { panels, onPackageLoad, onPackageUnload } from './src/panel-exports';
+export { terminalPanelTools, terminalPanelToolsMetadata, createTerminalSessionTool, writeToTerminalTool, closeTerminalSessionTool, clearTerminalTool, focusTerminalTool, } from './src/panel-exports';
 export type { PanelDefinition, PanelMetadata, PanelComponentProps, PanelContextValue, PanelActions, PanelEventEmitter, TerminalSessionInfo, CreateTerminalSessionOptions, TerminalPanelActions, TerminalEventType, TerminalScope, TerminalPanelProps, TerminalTab, TabbedTerminalPanelProps, OwnershipStatus, OwnershipResult, PortReadyData, } from './src/panel-types';
 export { getTerminalSessions, getTerminalSession, isTerminalLoading, getRepositoryPath, getWorkspacePath, getTerminalDirectory, getTerminalSlice, } from './src/panel-types';
 export type { Theme } from '@principal-ade/industry-theme';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AAGzF,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,YAAY,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAG7E,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAOnC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,YAAY,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAG9E,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG7E,YAAY,EACV,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,4BAA4B,EAC5B,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,aAAa,GACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAO3B,YAAY,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAG3D,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AAGzF,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,YAAY,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAG7E,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAOnC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,YAAY,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAG9E,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG7E,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,4BAA4B,EAC5B,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,aAAa,GACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAO3B,YAAY,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAG3D,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1882,6 +1882,154 @@ var TabbedTerminalPanel = ({
   });
 };
 TabbedTerminalPanel.displayName = "TabbedTerminalPanel";
+// src/tools/index.ts
+var createTerminalSessionTool = {
+  name: "create_terminal_session",
+  description: "Creates a new terminal session in the specified directory",
+  inputs: {
+    type: "object",
+    properties: {
+      cwd: {
+        type: "string",
+        description: "The working directory for the terminal session"
+      },
+      name: {
+        type: "string",
+        description: "Optional name for the terminal session"
+      }
+    },
+    required: ["cwd"]
+  },
+  outputs: {
+    type: "object",
+    properties: {
+      success: { type: "boolean" },
+      sessionId: { type: "string" }
+    }
+  },
+  tags: ["terminal", "session", "create"],
+  tool_call_template: {
+    call_template_type: "panel_event",
+    event_type: "industry-theme.terminal-panel:create-session"
+  }
+};
+var writeToTerminalTool = {
+  name: "write_to_terminal",
+  description: "Writes data to an active terminal session",
+  inputs: {
+    type: "object",
+    properties: {
+      sessionId: {
+        type: "string",
+        description: "The ID of the terminal session to write to"
+      },
+      data: {
+        type: "string",
+        description: "The data to write to the terminal"
+      }
+    },
+    required: ["sessionId", "data"]
+  },
+  outputs: {
+    type: "object",
+    properties: {
+      success: { type: "boolean" }
+    }
+  },
+  tags: ["terminal", "write", "input"],
+  tool_call_template: {
+    call_template_type: "panel_event",
+    event_type: "industry-theme.terminal-panel:write"
+  }
+};
+var closeTerminalSessionTool = {
+  name: "close_terminal_session",
+  description: "Closes an active terminal session",
+  inputs: {
+    type: "object",
+    properties: {
+      sessionId: {
+        type: "string",
+        description: "The ID of the terminal session to close"
+      }
+    },
+    required: ["sessionId"]
+  },
+  outputs: {
+    type: "object",
+    properties: {
+      success: { type: "boolean" }
+    }
+  },
+  tags: ["terminal", "session", "close"],
+  tool_call_template: {
+    call_template_type: "panel_event",
+    event_type: "industry-theme.terminal-panel:close-session"
+  }
+};
+var clearTerminalTool = {
+  name: "clear_terminal",
+  description: "Clears the terminal screen",
+  inputs: {
+    type: "object",
+    properties: {
+      sessionId: {
+        type: "string",
+        description: "The ID of the terminal session to clear"
+      }
+    },
+    required: ["sessionId"]
+  },
+  outputs: {
+    type: "object",
+    properties: {
+      success: { type: "boolean" }
+    }
+  },
+  tags: ["terminal", "clear"],
+  tool_call_template: {
+    call_template_type: "panel_event",
+    event_type: "industry-theme.terminal-panel:clear"
+  }
+};
+var focusTerminalTool = {
+  name: "focus_terminal",
+  description: "Focuses the terminal panel and brings it to the foreground",
+  inputs: {
+    type: "object",
+    properties: {
+      sessionId: {
+        type: "string",
+        description: "The ID of the terminal session to focus"
+      }
+    }
+  },
+  outputs: {
+    type: "object",
+    properties: {
+      success: { type: "boolean" }
+    }
+  },
+  tags: ["terminal", "focus", "navigation"],
+  tool_call_template: {
+    call_template_type: "panel_event",
+    event_type: "industry-theme.terminal-panel:focus"
+  }
+};
+var terminalPanelTools = [
+  createTerminalSessionTool,
+  writeToTerminalTool,
+  closeTerminalSessionTool,
+  clearTerminalTool,
+  focusTerminalTool
+];
+var terminalPanelToolsMetadata = {
+  id: "industry-theme.terminal-panel",
+  name: "Terminal Panel",
+  description: "Tools provided by the xterm terminal panel extension",
+  tools: terminalPanelTools
+};
+
 // src/panel-exports.ts
 var panels = [
   {
@@ -1892,7 +2040,8 @@ var panels = [
       version: "0.1.0",
       author: "Principal",
       description: "Integrated terminal emulator with industry theming",
-      slices: ["terminal"]
+      slices: ["terminal"],
+      tools: terminalPanelTools
     },
     component: TerminalPanel,
     onMount: async (context) => {
@@ -1913,7 +2062,10 @@ var onPackageUnload = async () => {
   console.log("Panel package unloading - Terminal Panel Extension");
 };
 export {
+  writeToTerminalTool,
   useThemedTerminal,
+  terminalPanelToolsMetadata,
+  terminalPanelTools,
   panels,
   onPackageUnload,
   onPackageLoad,
@@ -1925,7 +2077,11 @@ export {
   getTerminalDirectory,
   getTerminalCSSVariables,
   getRepositoryPath,
+  focusTerminalTool,
   createTerminalTheme,
+  createTerminalSessionTool,
+  closeTerminalSessionTool,
+  clearTerminalTool,
   ThemedTerminalWithProvider,
   ThemedTerminal,
   TerminalPanel,

package/dist/src/panel-exports.d.ts

@@ -4,4 +4,5 @@ export declare const panels: PanelDefinition[];
 export declare const onPackageLoad: () => Promise<void>;
 export declare const onPackageUnload: () => Promise<void>;
 export { TabbedTerminalPanel };
+export { terminalPanelTools, terminalPanelToolsMetadata, createTerminalSessionTool, writeToTerminalTool, closeTerminalSessionTool, clearTerminalTool, focusTerminalTool, } from './tools';
 //# sourceMappingURL=panel-exports.d.ts.map

package/dist/src/panel-exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"panel-exports.d.ts","sourceRoot":"","sources":["../../src/panel-exports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,eAAe,CAAC;AAMxE,eAAO,MAAM,MAAM,EAAE,eAAe,EAkCnC,CAAC;AAMF,eAAO,MAAM,aAAa,qBAGzB,CAAC;AAMF,eAAO,MAAM,eAAe,qBAG3B,CAAC;AAGF,OAAO,EAAE,mBAAmB,EAAE,CAAC"}
+{"version":3,"file":"panel-exports.d.ts","sourceRoot":"","sources":["../../src/panel-exports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,eAAe,CAAC;AAOxE,eAAO,MAAM,MAAM,EAAE,eAAe,EAmCnC,CAAC;AAMF,eAAO,MAAM,aAAa,qBAGzB,CAAC;AAMF,eAAO,MAAM,eAAe,qBAG3B,CAAC;AAGF,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAG/B,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,SAAS,CAAC"}

package/dist/src/tools/index.d.ts

@@ -0,0 +1,9 @@
+import type { PanelTool, PanelToolsMetadata } from '@principal-ade/utcp-panel-event';
+export declare const createTerminalSessionTool: PanelTool;
+export declare const writeToTerminalTool: PanelTool;
+export declare const closeTerminalSessionTool: PanelTool;
+export declare const clearTerminalTool: PanelTool;
+export declare const focusTerminalTool: PanelTool;
+export declare const terminalPanelTools: PanelTool[];
+export declare const terminalPanelToolsMetadata: PanelToolsMetadata;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAKrF,eAAO,MAAM,yBAAyB,EAAE,SA6BvC,CAAC;AAKF,eAAO,MAAM,mBAAmB,EAAE,SA4BjC,CAAC;AAKF,eAAO,MAAM,wBAAwB,EAAE,SAwBtC,CAAC;AAKF,eAAO,MAAM,iBAAiB,EAAE,SAwB/B,CAAC;AAKF,eAAO,MAAM,iBAAiB,EAAE,SAuB/B,CAAC;AAKF,eAAO,MAAM,kBAAkB,EAAE,SAAS,EAMzC,CAAC;AAKF,eAAO,MAAM,0BAA0B,EAAE,kBAKxC,CAAC"}

package/dist/tools.bundle.js

@@ -0,0 +1,156 @@
+// src/tools/index.ts
+var createTerminalSessionTool = {
+  name: "create_terminal_session",
+  description: "Creates a new terminal session in the specified directory",
+  inputs: {
+    type: "object",
+    properties: {
+      cwd: {
+        type: "string",
+        description: "The working directory for the terminal session"
+      },
+      name: {
+        type: "string",
+        description: "Optional name for the terminal session"
+      }
+    },
+    required: ["cwd"]
+  },
+  outputs: {
+    type: "object",
+    properties: {
+      success: { type: "boolean" },
+      sessionId: { type: "string" }
+    }
+  },
+  tags: ["terminal", "session", "create"],
+  tool_call_template: {
+    call_template_type: "panel_event",
+    event_type: "industry-theme.terminal-panel:create-session"
+  }
+};
+var writeToTerminalTool = {
+  name: "write_to_terminal",
+  description: "Writes data to an active terminal session",
+  inputs: {
+    type: "object",
+    properties: {
+      sessionId: {
+        type: "string",
+        description: "The ID of the terminal session to write to"
+      },
+      data: {
+        type: "string",
+        description: "The data to write to the terminal"
+      }
+    },
+    required: ["sessionId", "data"]
+  },
+  outputs: {
+    type: "object",
+    properties: {
+      success: { type: "boolean" }
+    }
+  },
+  tags: ["terminal", "write", "input"],
+  tool_call_template: {
+    call_template_type: "panel_event",
+    event_type: "industry-theme.terminal-panel:write"
+  }
+};
+var closeTerminalSessionTool = {
+  name: "close_terminal_session",
+  description: "Closes an active terminal session",
+  inputs: {
+    type: "object",
+    properties: {
+      sessionId: {
+        type: "string",
+        description: "The ID of the terminal session to close"
+      }
+    },
+    required: ["sessionId"]
+  },
+  outputs: {
+    type: "object",
+    properties: {
+      success: { type: "boolean" }
+    }
+  },
+  tags: ["terminal", "session", "close"],
+  tool_call_template: {
+    call_template_type: "panel_event",
+    event_type: "industry-theme.terminal-panel:close-session"
+  }
+};
+var clearTerminalTool = {
+  name: "clear_terminal",
+  description: "Clears the terminal screen",
+  inputs: {
+    type: "object",
+    properties: {
+      sessionId: {
+        type: "string",
+        description: "The ID of the terminal session to clear"
+      }
+    },
+    required: ["sessionId"]
+  },
+  outputs: {
+    type: "object",
+    properties: {
+      success: { type: "boolean" }
+    }
+  },
+  tags: ["terminal", "clear"],
+  tool_call_template: {
+    call_template_type: "panel_event",
+    event_type: "industry-theme.terminal-panel:clear"
+  }
+};
+var focusTerminalTool = {
+  name: "focus_terminal",
+  description: "Focuses the terminal panel and brings it to the foreground",
+  inputs: {
+    type: "object",
+    properties: {
+      sessionId: {
+        type: "string",
+        description: "The ID of the terminal session to focus"
+      }
+    }
+  },
+  outputs: {
+    type: "object",
+    properties: {
+      success: { type: "boolean" }
+    }
+  },
+  tags: ["terminal", "focus", "navigation"],
+  tool_call_template: {
+    call_template_type: "panel_event",
+    event_type: "industry-theme.terminal-panel:focus"
+  }
+};
+var terminalPanelTools = [
+  createTerminalSessionTool,
+  writeToTerminalTool,
+  closeTerminalSessionTool,
+  clearTerminalTool,
+  focusTerminalTool
+];
+var terminalPanelToolsMetadata = {
+  id: "industry-theme.terminal-panel",
+  name: "Terminal Panel",
+  description: "Tools provided by the xterm terminal panel extension",
+  tools: terminalPanelTools
+};
+export {
+  writeToTerminalTool,
+  terminalPanelToolsMetadata,
+  terminalPanelTools,
+  focusTerminalTool,
+  createTerminalSessionTool,
+  closeTerminalSessionTool,
+  clearTerminalTool
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@industry-theme/xterm-terminal-panel",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Industry-themed xterm.js terminal components with panel framework integration",
   "type": "module",
   "main": "dist/index.js",
@@ -13,12 +13,19 @@
       "require": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools.bundle.js",
+      "require": "./dist/tools.bundle.js",
+      "default": "./dist/tools.bundle.js"
+    },
     "./styles.css": "./dist/styles.css",
     "./package.json": "./package.json"
   },
   "scripts": {
-    "build": "bun run clean && bun run build:esm && bun run build:types && bun run build:styles",
+    "build": "bun run clean && bun run build:esm && bun run build:tools && bun run build:types && bun run build:styles",
     "build:esm": "NODE_ENV=production bun build ./index.ts --outdir ./dist --entry-naming [dir]/[name].[ext] --format esm --target browser --external react --external react-dom --external @xterm/xterm --external @xterm/addon-fit --external @xterm/addon-search --external @xterm/addon-web-links --external @xterm/addon-unicode11 --external @xterm/addon-webgl --external @principal-ade/industry-theme --external @principal-ade/panel-framework-core --external lucide-react --external clsx",
+    "build:tools": "bun build ./src/tools/index.ts --outfile ./dist/tools.bundle.js --format esm --target browser",
     "build:types": "tsc --project tsconfig.build.json --emitDeclarationOnly --declaration --declarationMap",
     "build:styles": "cp src/styles/terminal-theme.css dist/styles.css",
     "dev": "bun run build --watch",
@@ -41,13 +48,15 @@
     "theme",
     "industry",
     "panel",
-    "panel-framework"
+    "panel-framework",
+    "panel-extension"
   ],
   "author": "Principal ADE Team",
   "license": "MIT",
   "dependencies": {
-    "@principal-ade/industry-theme": "^0.1.2",
-    "@principal-ade/panel-framework-core": "^0.1.2",
+    "@principal-ade/industry-theme": "^0.1.3",
+    "@principal-ade/panel-framework-core": "^0.1.5",
+    "@principal-ade/utcp-panel-event": "^0.1.0",
     "clsx": "^2.1.1"
   },
   "peerDependencies": {
@@ -73,15 +82,12 @@
     }
   },
   "devDependencies": {
+    "@chromatic-com/storybook": "^4.1.3",
     "@eslint/js": "^9.32.0",
-    "@storybook/addon-essentials": "^8.6.0",
-    "@storybook/addon-interactions": "^8.6.0",
-    "@storybook/addon-links": "^8.6.0",
-    "@storybook/addon-onboarding": "^8.6.0",
-    "@storybook/blocks": "^8.6.0",
-    "@storybook/react": "^8.6.0",
-    "@storybook/react-vite": "^8.6.0",
-    "@storybook/test": "^8.6.0",
+    "@storybook/addon-docs": "10.1.2",
+    "@storybook/addon-links": "10.1.2",
+    "@storybook/addon-onboarding": "10.1.2",
+    "@storybook/react-vite": "10.1.2",
     "@types/bun": "latest",
     "@types/node": "^22.15.26",
     "@types/react": "^19.1.12",
@@ -102,12 +108,12 @@
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-react": "^7.37.2",
     "eslint-plugin-react-hooks": "^5.0.0",
-    "eslint-plugin-storybook": "^0.11.1",
+    "eslint-plugin-storybook": "10.1.2",
     "lucide-react": "^0.552.0",
     "prettier": "^3.6.2",
     "react": "^19.1.1",
     "react-dom": "^19.1.1",
-    "storybook": "^8.6.0",
+    "storybook": "10.1.2",
     "typescript": "^5.0.4",
     "typescript-eslint": "^8.38.0",
     "vite": "^6.0.7"