blomios/IdeaSDK

Go to file

Blomios fdb3a907af merge(sdk): intègre feature/294-node-mcp-launch-docs — doc lancement serveurs MCP JS packagés #294 (QA verte: npm run check; vérifié contre hôte application/plugin/mod.rs)

2026-09-09 16:24:20 +02:00

docs(sdk): lancement des serveurs MCP JavaScript packagés — #294 (manifest: aucune substitution ${node}/${runtimeNode}/${hostNode} ni champ runtime, IdeA ne fournit pas de runtime Node plugin-scoped; command n'est pas du shell — démarrage direct avec args séparés, pas de fichiers de startup/alias/PATH du shell de login; command relatif résolu sous pluginRoot — command:"node" sans allowAbsoluteCommand devient ${pluginRoot}/node (cause ENOENT UnityPlugin #12 ); absolu littéral refusé sans allowAbsoluteCommand=true, command devenu absolu après substitution ${pluginRoot}/${appDataDir} passé tel quel; shebang #!/usr/bin/env node dépend du node visible du process app IdeA; recommandations: exécutable packagé incluant son runtime ou runtime géré sous stockage plugin/app pointé via ${pluginRoot}/${appDataDir}, sinon dépendance hôte explicite absolue /usr/bin/node avec allowAbsoluteCommand=true et scripts dans args; même règle pour command:"bash"; packaging-distribution: section Packaged Executables And Runtimes — bit exécutable et shebang valides dans le package installé, éviter le bare command:"node" en plugins distribués/multi-harness; services: distinction runCommand() (exécutable hôte de l'environnement task, aucune substitution) vs règles manifest mcpServers avec lien croisé; affirmations vérifiées par Git contre l'hôte crates/application/src/plugin/mod.rs:3199 substitution puis looks_absolute/allow_absolute_command sinon préfixage pluginRoot, et validation :3637 absolu littéral sans flag rejeté; QA verte reconfirmée par Git: npm run check — build, typecheck:examples, package:hello-plugin)

2026-09-09 16:24:16 +02:00

examples/hello-plugin

feat(sdk): pluginRoot officiel exposé dans activate(ctx) — #285 (src/runtime: champ pluginRoot = racine du package installé; docs activation-context/commands-and-feedback/services/manifest réécrits du constat d'absence vers le contrat d'usage officiel — runCommand reste project-scoped, pluginRoot utilisable dans command/args, substitution manifest ${pluginRoot}/${appDataDir} inchangée pour mcpServers; exemple hello-plugin: script packagé scripts/hello-task.mjs consommé via ctx.pluginRoot, packaging étendu; QA verte: npm run check — build, typecheck:examples, package:hello-plugin, artefact zip vérifié)

2026-09-08 18:35:24 +02:00

feat(sdk): pluginRoot officiel exposé dans activate(ctx) — #285 (src/runtime: champ pluginRoot = racine du package installé; docs activation-context/commands-and-feedback/services/manifest réécrits du constat d'absence vers le contrat d'usage officiel — runCommand reste project-scoped, pluginRoot utilisable dans command/args, substitution manifest ${pluginRoot}/${appDataDir} inchangée pour mcpServers; exemple hello-plugin: script packagé scripts/hello-task.mjs consommé via ctx.pluginRoot, packaging étendu; QA verte: npm run check — build, typecheck:examples, package:hello-plugin, artefact zip vérifié)

2026-09-08 18:35:24 +02:00

feat(sdk): pluginRoot officiel exposé dans activate(ctx) — #285 (src/runtime: champ pluginRoot = racine du package installé; docs activation-context/commands-and-feedback/services/manifest réécrits du constat d'absence vers le contrat d'usage officiel — runCommand reste project-scoped, pluginRoot utilisable dans command/args, substitution manifest ${pluginRoot}/${appDataDir} inchangée pour mcpServers; exemple hello-plugin: script packagé scripts/hello-task.mjs consommé via ctx.pluginRoot, packaging étendu; QA verte: npm run check — build, typecheck:examples, package:hello-plugin, artefact zip vérifié)

2026-09-08 18:35:24 +02:00

.gitignore

Initial commit: IdeaSDK TypeScript plugin SDK

2026-08-02 16:24:59 +02:00

package-lock.json

feat(runtime): résout react/react-dom vers l'instance host pour les layouts plugin

2026-08-04 00:39:25 +02:00

package.json

feat(runtime): résout react/react-dom vers l'instance host pour les layouts plugin

2026-08-04 00:39:25 +02:00

README.md

docs(sdk): schéma project-plugins.json v1 + assignation skills/tools agents — #283 (project-plugin-assignments: workflow install→enable→assign→relaunch, schéma complet plugins/agents/skills/tools camelCase, ordre d'injection natif puis plugin, tombstones inertes uninstall/reinstall, validation UI/API idempotente vs édition manuelle, reload plugin ≠ relance agent; liens croisés manifest/codex-skills/README; QA verte: npm run build, liens docs vérifiés)

2026-09-08 16:34:03 +02:00

tsconfig.json

Initial commit: IdeaSDK TypeScript plugin SDK

2026-08-02 16:24:59 +02:00

README.md

IdeA Plugin SDK

Public TypeScript SDK for IdeA plugins.

The SDK defines the stable manifest and runtime types used by plugins loaded by IdeA. A plugin ships an idea-plugin.json manifest plus an ESM entrypoint that exports activate(ctx).

Start Here

Manifest: required fields, capabilities and contribution ids.
Activation And Context: activate(ctx), lifecycle, logging, storage and subscriptions.
Menus: top-level menus, native menu insertion and command registration.
Commands And Feedback: command return values, skipped work and background tasks.
Layouts With React: React/JSX/hooks layout authoring with host-provided React.
Windows: opening plugin layouts in detached OS windows.
Services: workspace, tasks, tooling, events, config, terminal and windows facades.
Packaging And Distribution: build output, archive layout, hot reload and dependency rules.
Codex Skills And IdeA Plugins: separate IdeA-native plugin skills from Codex plugin discovery.
Project Plugin Assignments: enable plugins per project and assign skills and MCP tools to agents.

The installable example lives in examples/hello-plugin. It demonstrates a menu command, storage, background-task feedback, a React layout component and services.windows.open(...).

Install

npm install

Build

npm run build

Validate The Example

npm run typecheck:examples
npm run package:hello-plugin

The example archive is written to:

examples/hello-plugin/build/hello-plugin-0.1.0.zip