agentuity-vscode 0.0.86
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.vscode/launch.json +26 -0
- package/.vscode/tasks.json +22 -0
- package/.vscodeignore +22 -0
- package/LICENSE +21 -0
- package/README.md +156 -0
- package/package.json +476 -0
- package/resources/icon.png +0 -0
- package/resources/icon.svg +1 -0
- package/src/core/auth.ts +128 -0
- package/src/core/baseTreeDataProvider.ts +92 -0
- package/src/core/cliClient.ts +777 -0
- package/src/core/index.ts +5 -0
- package/src/core/project.ts +98 -0
- package/src/core/readonlyDocument.ts +57 -0
- package/src/core/service.ts +208 -0
- package/src/extension.ts +260 -0
- package/src/features/agentExplorer/agentTreeData.ts +149 -0
- package/src/features/agentExplorer/index.ts +105 -0
- package/src/features/chat/agentuityParticipant.ts +838 -0
- package/src/features/chat/cliTool.ts +91 -0
- package/src/features/chat/index.ts +2 -0
- package/src/features/codeLens/agentCodeLensProvider.ts +116 -0
- package/src/features/codeLens/index.ts +132 -0
- package/src/features/dataExplorer/dataTreeData.ts +480 -0
- package/src/features/dataExplorer/index.ts +362 -0
- package/src/features/deploymentExplorer/deploymentTreeData.ts +238 -0
- package/src/features/deploymentExplorer/index.ts +107 -0
- package/src/features/devServer/devServerManager.ts +258 -0
- package/src/features/devServer/index.ts +52 -0
- package/src/features/workbench/index.ts +19 -0
- package/tsconfig.json +20 -0
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": "0.2.0",
|
|
3
|
+
"configurations": [
|
|
4
|
+
{
|
|
5
|
+
"name": "Run Extension",
|
|
6
|
+
"type": "extensionHost",
|
|
7
|
+
"request": "launch",
|
|
8
|
+
"args": [
|
|
9
|
+
"--extensionDevelopmentPath=${workspaceFolder}",
|
|
10
|
+
"${workspaceFolder}/../../apps/testing/auth-app"
|
|
11
|
+
],
|
|
12
|
+
"outFiles": ["${workspaceFolder}/dist/**/*.js"],
|
|
13
|
+
"preLaunchTask": "bun: compile"
|
|
14
|
+
},
|
|
15
|
+
{
|
|
16
|
+
"name": "Run Extension (No Build)",
|
|
17
|
+
"type": "extensionHost",
|
|
18
|
+
"request": "launch",
|
|
19
|
+
"args": [
|
|
20
|
+
"--extensionDevelopmentPath=${workspaceFolder}",
|
|
21
|
+
"${workspaceFolder}/../../apps/testing/auth-app"
|
|
22
|
+
],
|
|
23
|
+
"outFiles": ["${workspaceFolder}/dist/**/*.js"]
|
|
24
|
+
}
|
|
25
|
+
]
|
|
26
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": "2.0.0",
|
|
3
|
+
"tasks": [
|
|
4
|
+
{
|
|
5
|
+
"type": "shell",
|
|
6
|
+
"command": "bun run compile",
|
|
7
|
+
"problemMatcher": [],
|
|
8
|
+
"label": "bun: compile",
|
|
9
|
+
"group": {
|
|
10
|
+
"kind": "build",
|
|
11
|
+
"isDefault": true
|
|
12
|
+
}
|
|
13
|
+
},
|
|
14
|
+
{
|
|
15
|
+
"type": "shell",
|
|
16
|
+
"command": "bun run watch",
|
|
17
|
+
"problemMatcher": [],
|
|
18
|
+
"label": "bun: watch",
|
|
19
|
+
"isBackground": true
|
|
20
|
+
}
|
|
21
|
+
]
|
|
22
|
+
}
|
package/.vscodeignore
ADDED
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Source files (not needed in extension)
|
|
2
|
+
src/**
|
|
3
|
+
**/*.ts
|
|
4
|
+
!dist/**
|
|
5
|
+
|
|
6
|
+
# Config files
|
|
7
|
+
tsconfig.json
|
|
8
|
+
.vscode/**
|
|
9
|
+
.vscode-test/**
|
|
10
|
+
|
|
11
|
+
# Build artifacts and dev files
|
|
12
|
+
bun.lockb
|
|
13
|
+
*.log
|
|
14
|
+
node_modules/.cache/**
|
|
15
|
+
|
|
16
|
+
# Git
|
|
17
|
+
.git/**
|
|
18
|
+
.github/**
|
|
19
|
+
.gitignore
|
|
20
|
+
|
|
21
|
+
# Development documentation
|
|
22
|
+
PLAN.md
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2024 Agentuity
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,156 @@
|
|
|
1
|
+
# Agentuity VSCode Extension
|
|
2
|
+
|
|
3
|
+
Build, deploy, and manage AI agents with Agentuity directly from VSCode.
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
### Manual Installation (.vsix)
|
|
8
|
+
|
|
9
|
+
1. Download the latest `agentuity-vscode-<version>.vsix` from [GitHub Releases](https://github.com/agentuity/sdk/releases)
|
|
10
|
+
|
|
11
|
+
2. In VS Code:
|
|
12
|
+
- Open the **Extensions** view (`Ctrl+Shift+X` / `Cmd+Shift+X`)
|
|
13
|
+
- Click the **⋯** menu in the top-right
|
|
14
|
+
- Choose **Install from VSIX...**
|
|
15
|
+
- Select the downloaded `.vsix` file
|
|
16
|
+
|
|
17
|
+
Or via command line:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
code --install-extension agentuity-vscode-<version>.vsix
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Prerequisites
|
|
24
|
+
|
|
25
|
+
- [Agentuity CLI](https://agentuity.com/docs/cli) must be installed
|
|
26
|
+
- VSCode 1.90.0 or later
|
|
27
|
+
|
|
28
|
+
## Features
|
|
29
|
+
|
|
30
|
+
### Agent Explorer
|
|
31
|
+
View all agents in your Agentuity project in the sidebar.
|
|
32
|
+
|
|
33
|
+
### Data Explorer
|
|
34
|
+
Browse cloud data resources:
|
|
35
|
+
- **Key-Value** - View namespaces and keys
|
|
36
|
+
- **Object Store** - View buckets and objects
|
|
37
|
+
- **Vector** - View vector indexes
|
|
38
|
+
|
|
39
|
+
### Dev Server
|
|
40
|
+
Start, stop, and monitor the development server with status bar integration.
|
|
41
|
+
|
|
42
|
+
### Workbench Integration
|
|
43
|
+
Open the Agentuity Workbench in your browser with one click.
|
|
44
|
+
|
|
45
|
+
### AI Commands (for Coding Agents)
|
|
46
|
+
The extension exposes commands that AI coding tools (Claude Code, Cursor, Amp) can use:
|
|
47
|
+
|
|
48
|
+
```typescript
|
|
49
|
+
// Get AI capabilities as JSON
|
|
50
|
+
const capabilities = await vscode.commands.executeCommand('agentuity.getAiCapabilities');
|
|
51
|
+
|
|
52
|
+
// Get AI schema as JSON
|
|
53
|
+
const schema = await vscode.commands.executeCommand('agentuity.getAiSchema');
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
### Chat Participant
|
|
57
|
+
Use `@agentuity` in GitHub Copilot Chat to get help with your agents:
|
|
58
|
+
|
|
59
|
+
- "What agents are available?"
|
|
60
|
+
- "Show me the AI capabilities"
|
|
61
|
+
- "How do I get started?"
|
|
62
|
+
|
|
63
|
+
## Commands
|
|
64
|
+
|
|
65
|
+
| Command | Description |
|
|
66
|
+
|---------|-------------|
|
|
67
|
+
| `Agentuity: Login` | Login via CLI in terminal |
|
|
68
|
+
| `Agentuity: Logout` | Logout from Agentuity |
|
|
69
|
+
| `Agentuity: Who Am I?` | Show current user |
|
|
70
|
+
| `Agentuity: Start Dev Server` | Start the dev server |
|
|
71
|
+
| `Agentuity: Stop Dev Server` | Stop the dev server |
|
|
72
|
+
| `Agentuity: Open Workbench` | Open Workbench in browser |
|
|
73
|
+
| `Agentuity: Deploy` | Deploy to Agentuity Cloud |
|
|
74
|
+
| `Agentuity: Refresh` | Refresh auth and project state |
|
|
75
|
+
|
|
76
|
+
## Configuration
|
|
77
|
+
|
|
78
|
+
| Setting | Default | Description |
|
|
79
|
+
|---------|---------|-------------|
|
|
80
|
+
| `agentuity.cliPath` | `""` | Custom path to CLI executable |
|
|
81
|
+
| `agentuity.devServer.port` | `3500` | Default dev server port |
|
|
82
|
+
|
|
83
|
+
## Development
|
|
84
|
+
|
|
85
|
+
### Prerequisites
|
|
86
|
+
|
|
87
|
+
1. **Agentuity CLI installed globally**: `bun install -g @agentuity/cli`
|
|
88
|
+
2. **Logged in to Agentuity**: `agentuity auth login`
|
|
89
|
+
3. **A test project**: The `apps/testing/auth-app` directory is a good test project
|
|
90
|
+
|
|
91
|
+
### Setup
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
# From the SDK root
|
|
95
|
+
cd packages/vscode
|
|
96
|
+
bun install
|
|
97
|
+
bun run compile
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
### Running the Extension Locally
|
|
101
|
+
|
|
102
|
+
1. Open the `packages/vscode` folder in VSCode (or the SDK root)
|
|
103
|
+
2. Press `F5` to launch the Extension Development Host
|
|
104
|
+
3. In the new VSCode window, open an Agentuity project folder (e.g., `apps/testing/auth-app`)
|
|
105
|
+
4. The Agentuity sidebar should appear with Agents, Deployments, Sessions, and Data panels
|
|
106
|
+
|
|
107
|
+
### Testing Features
|
|
108
|
+
|
|
109
|
+
**Agent Explorer**: Should list agents from your project after the project is detected.
|
|
110
|
+
|
|
111
|
+
**Data Explorer**:
|
|
112
|
+
- Expand "Key-Value" to see namespaces and keys
|
|
113
|
+
- Expand "Object Store" to see buckets and objects
|
|
114
|
+
- Click on a key to view its contents
|
|
115
|
+
|
|
116
|
+
**Deployments & Sessions**: Lists recent deployments and sessions for your project.
|
|
117
|
+
|
|
118
|
+
**Dev Server**: Use Command Palette (`Cmd+Shift+P`) → "Agentuity: Start Dev Server"
|
|
119
|
+
|
|
120
|
+
**Deploy**: Use Command Palette → "Agentuity: Deploy" (runs in terminal)
|
|
121
|
+
|
|
122
|
+
### Build Commands
|
|
123
|
+
|
|
124
|
+
```bash
|
|
125
|
+
bun run build # Compile the extension
|
|
126
|
+
bun run typecheck # Run TypeScript type checking
|
|
127
|
+
bun run watch # Watch mode for development
|
|
128
|
+
bun run clean # Remove build artifacts
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
### Debugging
|
|
132
|
+
|
|
133
|
+
- View CLI output: Open the "Agentuity CLI" output channel in VSCode
|
|
134
|
+
- View extension logs: Open the "Agentuity" output channel
|
|
135
|
+
- If the extension fails to activate, check the "Extension Host" output channel
|
|
136
|
+
|
|
137
|
+
### Important Notes
|
|
138
|
+
|
|
139
|
+
- The extension requires the Agentuity CLI to be installed and accessible
|
|
140
|
+
- Project detection requires an `agentuity.json` file in the workspace root
|
|
141
|
+
- All CLI commands use `--json` flag for structured output
|
|
142
|
+
- External dependencies (`vscode`, `jsonc-parser`) are not bundled
|
|
143
|
+
|
|
144
|
+
## Packaging
|
|
145
|
+
|
|
146
|
+
To build the extension and create a `.vsix` for distribution:
|
|
147
|
+
|
|
148
|
+
```bash
|
|
149
|
+
bun run package # Builds and creates agentuity-vscode-<version>.vsix
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
The version is kept in sync with the SDK monorepo version.
|
|
153
|
+
|
|
154
|
+
## License
|
|
155
|
+
|
|
156
|
+
MIT
|