@paperclipai_dld/server 2026.319.0-canary.3
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/LICENSE +21 -0
- package/dist/adapters/codex-models.d.ts +4 -0
- package/dist/adapters/codex-models.d.ts.map +1 -0
- package/dist/adapters/codex-models.js +98 -0
- package/dist/adapters/codex-models.js.map +1 -0
- package/dist/adapters/cursor-models.d.ts +13 -0
- package/dist/adapters/cursor-models.d.ts.map +1 -0
- package/dist/adapters/cursor-models.js +148 -0
- package/dist/adapters/cursor-models.js.map +1 -0
- package/dist/adapters/http/execute.d.ts +3 -0
- package/dist/adapters/http/execute.d.ts.map +1 -0
- package/dist/adapters/http/execute.js +39 -0
- package/dist/adapters/http/execute.js.map +1 -0
- package/dist/adapters/http/index.d.ts +3 -0
- package/dist/adapters/http/index.d.ts.map +1 -0
- package/dist/adapters/http/index.js +20 -0
- package/dist/adapters/http/index.js.map +1 -0
- package/dist/adapters/http/test.d.ts +3 -0
- package/dist/adapters/http/test.d.ts.map +1 -0
- package/dist/adapters/http/test.js +106 -0
- package/dist/adapters/http/test.js.map +1 -0
- package/dist/adapters/index.d.ts +4 -0
- package/dist/adapters/index.d.ts.map +1 -0
- package/dist/adapters/index.js +3 -0
- package/dist/adapters/index.js.map +1 -0
- package/dist/adapters/process/execute.d.ts +3 -0
- package/dist/adapters/process/execute.d.ts.map +1 -0
- package/dist/adapters/process/execute.js +63 -0
- package/dist/adapters/process/execute.js.map +1 -0
- package/dist/adapters/process/index.d.ts +3 -0
- package/dist/adapters/process/index.d.ts.map +1 -0
- package/dist/adapters/process/index.js +23 -0
- package/dist/adapters/process/index.js.map +1 -0
- package/dist/adapters/process/test.d.ts +3 -0
- package/dist/adapters/process/test.d.ts.map +1 -0
- package/dist/adapters/process/test.js +77 -0
- package/dist/adapters/process/test.js.map +1 -0
- package/dist/adapters/registry.d.ts +9 -0
- package/dist/adapters/registry.d.ts.map +1 -0
- package/dist/adapters/registry.js +142 -0
- package/dist/adapters/registry.js.map +1 -0
- package/dist/adapters/types.d.ts +2 -0
- package/dist/adapters/types.d.ts.map +1 -0
- package/dist/adapters/types.js +2 -0
- package/dist/adapters/types.js.map +1 -0
- package/dist/adapters/utils.d.ts +10 -0
- package/dist/adapters/utils.d.ts.map +1 -0
- package/dist/adapters/utils.js +14 -0
- package/dist/adapters/utils.js.map +1 -0
- package/dist/agent-auth-jwt.d.ts +14 -0
- package/dist/agent-auth-jwt.d.ts.map +1 -0
- package/dist/agent-auth-jwt.js +117 -0
- package/dist/agent-auth-jwt.js.map +1 -0
- package/dist/app.d.ts +25 -0
- package/dist/app.d.ts.map +1 -0
- package/dist/app.js +259 -0
- package/dist/app.js.map +1 -0
- package/dist/attachment-types.d.ts +33 -0
- package/dist/attachment-types.d.ts.map +1 -0
- package/dist/attachment-types.js +67 -0
- package/dist/attachment-types.js.map +1 -0
- package/dist/auth/better-auth.d.ts +24 -0
- package/dist/auth/better-auth.d.ts.map +1 -0
- package/dist/auth/better-auth.js +108 -0
- package/dist/auth/better-auth.js.map +1 -0
- package/dist/board-claim.d.ts +23 -0
- package/dist/board-claim.d.ts.map +1 -0
- package/dist/board-claim.js +115 -0
- package/dist/board-claim.js.map +1 -0
- package/dist/config-file.d.ts +3 -0
- package/dist/config-file.d.ts.map +1 -0
- package/dist/config-file.js +16 -0
- package/dist/config-file.js.map +1 -0
- package/dist/config.d.ts +38 -0
- package/dist/config.d.ts.map +1 -0
- package/dist/config.js +162 -0
- package/dist/config.js.map +1 -0
- package/dist/errors.d.ts +12 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +28 -0
- package/dist/errors.js.map +1 -0
- package/dist/home-paths.d.ts +17 -0
- package/dist/home-paths.d.ts.map +1 -0
- package/dist/home-paths.js +75 -0
- package/dist/home-paths.js.map +1 -0
- package/dist/index.d.ts +10 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +581 -0
- package/dist/index.js.map +1 -0
- package/dist/log-redaction.d.ts +10 -0
- package/dist/log-redaction.d.ts.map +1 -0
- package/dist/log-redaction.js +110 -0
- package/dist/log-redaction.js.map +1 -0
- package/dist/middleware/auth.d.ts +12 -0
- package/dist/middleware/auth.d.ts.map +1 -0
- package/dist/middleware/auth.js +124 -0
- package/dist/middleware/auth.js.map +1 -0
- package/dist/middleware/board-mutation-guard.d.ts +3 -0
- package/dist/middleware/board-mutation-guard.d.ts.map +1 -0
- package/dist/middleware/board-mutation-guard.js +60 -0
- package/dist/middleware/board-mutation-guard.js.map +1 -0
- package/dist/middleware/error-handler.d.ts +17 -0
- package/dist/middleware/error-handler.d.ts.map +1 -0
- package/dist/middleware/error-handler.js +37 -0
- package/dist/middleware/error-handler.js.map +1 -0
- package/dist/middleware/index.d.ts +4 -0
- package/dist/middleware/index.d.ts.map +1 -0
- package/dist/middleware/index.js +4 -0
- package/dist/middleware/index.js.map +1 -0
- package/dist/middleware/logger.d.ts +4 -0
- package/dist/middleware/logger.d.ts.map +1 -0
- package/dist/middleware/logger.js +87 -0
- package/dist/middleware/logger.js.map +1 -0
- package/dist/middleware/private-hostname-guard.d.ts +11 -0
- package/dist/middleware/private-hostname-guard.d.ts.map +1 -0
- package/dist/middleware/private-hostname-guard.js +78 -0
- package/dist/middleware/private-hostname-guard.js.map +1 -0
- package/dist/middleware/validate.d.ts +4 -0
- package/dist/middleware/validate.d.ts.map +1 -0
- package/dist/middleware/validate.js +7 -0
- package/dist/middleware/validate.js.map +1 -0
- package/dist/paths.d.ts +3 -0
- package/dist/paths.d.ts.map +1 -0
- package/dist/paths.js +31 -0
- package/dist/paths.js.map +1 -0
- package/dist/realtime/live-events-ws.d.ts +28 -0
- package/dist/realtime/live-events-ws.d.ts.map +1 -0
- package/dist/realtime/live-events-ws.js +187 -0
- package/dist/realtime/live-events-ws.js.map +1 -0
- package/dist/redaction.d.ts +4 -0
- package/dist/redaction.d.ts.map +1 -0
- package/dist/redaction.js +63 -0
- package/dist/redaction.js.map +1 -0
- package/dist/routes/access.d.ts +56 -0
- package/dist/routes/access.d.ts.map +1 -0
- package/dist/routes/access.js +2124 -0
- package/dist/routes/access.js.map +1 -0
- package/dist/routes/activity.d.ts +3 -0
- package/dist/routes/activity.d.ts.map +1 -0
- package/dist/routes/activity.js +78 -0
- package/dist/routes/activity.js.map +1 -0
- package/dist/routes/agents.d.ts +4 -0
- package/dist/routes/agents.d.ts.map +1 -0
- package/dist/routes/agents.js +1390 -0
- package/dist/routes/agents.js.map +1 -0
- package/dist/routes/approvals.d.ts +3 -0
- package/dist/routes/approvals.d.ts.map +1 -0
- package/dist/routes/approvals.js +275 -0
- package/dist/routes/approvals.js.map +1 -0
- package/dist/routes/assets.d.ts +4 -0
- package/dist/routes/assets.d.ts.map +1 -0
- package/dist/routes/assets.js +309 -0
- package/dist/routes/assets.js.map +1 -0
- package/dist/routes/authz.d.ts +15 -0
- package/dist/routes/authz.d.ts.map +1 -0
- package/dist/routes/authz.js +40 -0
- package/dist/routes/authz.js.map +1 -0
- package/dist/routes/companies.d.ts +3 -0
- package/dist/routes/companies.d.ts.map +1 -0
- package/dist/routes/companies.js +174 -0
- package/dist/routes/companies.js.map +1 -0
- package/dist/routes/costs.d.ts +3 -0
- package/dist/routes/costs.d.ts.map +1 -0
- package/dist/routes/costs.js +268 -0
- package/dist/routes/costs.js.map +1 -0
- package/dist/routes/dashboard.d.ts +3 -0
- package/dist/routes/dashboard.d.ts.map +1 -0
- package/dist/routes/dashboard.js +15 -0
- package/dist/routes/dashboard.js.map +1 -0
- package/dist/routes/execution-workspaces.d.ts +3 -0
- package/dist/routes/execution-workspaces.d.ts.map +1 -0
- package/dist/routes/execution-workspaces.js +165 -0
- package/dist/routes/execution-workspaces.js.map +1 -0
- package/dist/routes/goals.d.ts +3 -0
- package/dist/routes/goals.d.ts.map +1 -0
- package/dist/routes/goals.js +95 -0
- package/dist/routes/goals.js.map +1 -0
- package/dist/routes/health.d.ts +9 -0
- package/dist/routes/health.d.ts.map +1 -0
- package/dist/routes/health.js +51 -0
- package/dist/routes/health.js.map +1 -0
- package/dist/routes/index.d.ts +16 -0
- package/dist/routes/index.d.ts.map +1 -0
- package/dist/routes/index.js +16 -0
- package/dist/routes/index.js.map +1 -0
- package/dist/routes/instance-settings.d.ts +3 -0
- package/dist/routes/instance-settings.d.ts.map +1 -0
- package/dist/routes/instance-settings.js +46 -0
- package/dist/routes/instance-settings.js.map +1 -0
- package/dist/routes/issues-checkout-wakeup.d.ts +9 -0
- package/dist/routes/issues-checkout-wakeup.d.ts.map +1 -0
- package/dist/routes/issues-checkout-wakeup.js +12 -0
- package/dist/routes/issues-checkout-wakeup.js.map +1 -0
- package/dist/routes/issues.d.ts +4 -0
- package/dist/routes/issues.d.ts.map +1 -0
- package/dist/routes/issues.js +1431 -0
- package/dist/routes/issues.js.map +1 -0
- package/dist/routes/llms.d.ts +3 -0
- package/dist/routes/llms.d.ts.map +1 -0
- package/dist/routes/llms.js +78 -0
- package/dist/routes/llms.js.map +1 -0
- package/dist/routes/plugin-ui-static.d.ts +69 -0
- package/dist/routes/plugin-ui-static.d.ts.map +1 -0
- package/dist/routes/plugin-ui-static.js +411 -0
- package/dist/routes/plugin-ui-static.js.map +1 -0
- package/dist/routes/plugins.d.ts +120 -0
- package/dist/routes/plugins.d.ts.map +1 -0
- package/dist/routes/plugins.js +1784 -0
- package/dist/routes/plugins.js.map +1 -0
- package/dist/routes/projects.d.ts +3 -0
- package/dist/routes/projects.d.ts.map +1 -0
- package/dist/routes/projects.js +257 -0
- package/dist/routes/projects.js.map +1 -0
- package/dist/routes/secrets.d.ts +3 -0
- package/dist/routes/secrets.d.ts.map +1 -0
- package/dist/routes/secrets.js +128 -0
- package/dist/routes/secrets.js.map +1 -0
- package/dist/routes/sidebar-badges.d.ts +3 -0
- package/dist/routes/sidebar-badges.d.ts.map +1 -0
- package/dist/routes/sidebar-badges.js +45 -0
- package/dist/routes/sidebar-badges.js.map +1 -0
- package/dist/secrets/external-stub-providers.d.ts +5 -0
- package/dist/secrets/external-stub-providers.d.ts.map +1 -0
- package/dist/secrets/external-stub-providers.js +21 -0
- package/dist/secrets/external-stub-providers.js.map +1 -0
- package/dist/secrets/local-encrypted-provider.d.ts +3 -0
- package/dist/secrets/local-encrypted-provider.d.ts.map +1 -0
- package/dist/secrets/local-encrypted-provider.js +116 -0
- package/dist/secrets/local-encrypted-provider.js.map +1 -0
- package/dist/secrets/provider-registry.d.ts +5 -0
- package/dist/secrets/provider-registry.d.ts.map +1 -0
- package/dist/secrets/provider-registry.js +20 -0
- package/dist/secrets/provider-registry.js.map +1 -0
- package/dist/secrets/types.d.ts +21 -0
- package/dist/secrets/types.d.ts.map +1 -0
- package/dist/secrets/types.js +2 -0
- package/dist/secrets/types.js.map +1 -0
- package/dist/services/access.d.ts +81 -0
- package/dist/services/access.d.ts.map +1 -0
- package/dist/services/access.js +187 -0
- package/dist/services/access.js.map +1 -0
- package/dist/services/activity-log.d.ts +17 -0
- package/dist/services/activity-log.d.ts.map +1 -0
- package/dist/services/activity-log.js +68 -0
- package/dist/services/activity-log.js.map +1 -0
- package/dist/services/activity.d.ts +764 -0
- package/dist/services/activity.d.ts.map +1 -0
- package/dist/services/activity.js +105 -0
- package/dist/services/activity.js.map +1 -0
- package/dist/services/agent-permissions.d.ts +6 -0
- package/dist/services/agent-permissions.d.ts.map +1 -0
- package/dist/services/agent-permissions.js +18 -0
- package/dist/services/agent-permissions.js.map +1 -0
- package/dist/services/agents.d.ts +1530 -0
- package/dist/services/agents.d.ts.map +1 -0
- package/dist/services/agents.js +566 -0
- package/dist/services/agents.js.map +1 -0
- package/dist/services/approvals.d.ts +546 -0
- package/dist/services/approvals.d.ts.map +1 -0
- package/dist/services/approvals.js +206 -0
- package/dist/services/approvals.js.map +1 -0
- package/dist/services/assets.d.ts +33 -0
- package/dist/services/assets.d.ts.map +1 -0
- package/dist/services/assets.js +17 -0
- package/dist/services/assets.js.map +1 -0
- package/dist/services/budgets.d.ts +38 -0
- package/dist/services/budgets.d.ts.map +1 -0
- package/dist/services/budgets.js +784 -0
- package/dist/services/budgets.js.map +1 -0
- package/dist/services/companies.d.ts +124 -0
- package/dist/services/companies.d.ts.map +1 -0
- package/dist/services/companies.js +256 -0
- package/dist/services/companies.js.map +1 -0
- package/dist/services/company-portability.d.ts +8 -0
- package/dist/services/company-portability.d.ts.map +1 -0
- package/dist/services/company-portability.js +867 -0
- package/dist/services/company-portability.js.map +1 -0
- package/dist/services/costs.d.ts +114 -0
- package/dist/services/costs.d.ts.map +1 -0
- package/dist/services/costs.js +294 -0
- package/dist/services/costs.js.map +1 -0
- package/dist/services/cron.d.ts +80 -0
- package/dist/services/cron.d.ts.map +1 -0
- package/dist/services/cron.js +300 -0
- package/dist/services/cron.js.map +1 -0
- package/dist/services/dashboard.d.ts +26 -0
- package/dist/services/dashboard.d.ts.map +1 -0
- package/dist/services/dashboard.js +98 -0
- package/dist/services/dashboard.js.map +1 -0
- package/dist/services/documents.d.ts +164 -0
- package/dist/services/documents.d.ts.map +1 -0
- package/dist/services/documents.js +382 -0
- package/dist/services/documents.js.map +1 -0
- package/dist/services/execution-workspace-policy.d.ts +20 -0
- package/dist/services/execution-workspace-policy.d.ts.map +1 -0
- package/dist/services/execution-workspace-policy.js +165 -0
- package/dist/services/execution-workspace-policy.js.map +1 -0
- package/dist/services/execution-workspaces.d.ts +19 -0
- package/dist/services/execution-workspaces.d.ts.map +1 -0
- package/dist/services/execution-workspaces.js +87 -0
- package/dist/services/execution-workspaces.js.map +1 -0
- package/dist/services/finance.d.ts +93 -0
- package/dist/services/finance.d.ts.map +1 -0
- package/dist/services/finance.js +120 -0
- package/dist/services/finance.js.map +1 -0
- package/dist/services/goals.d.ts +433 -0
- package/dist/services/goals.d.ts.map +1 -0
- package/dist/services/goals.js +54 -0
- package/dist/services/goals.js.map +1 -0
- package/dist/services/heartbeat-run-summary.d.ts +2 -0
- package/dist/services/heartbeat-run-summary.d.ts.map +1 -0
- package/dist/services/heartbeat-run-summary.js +30 -0
- package/dist/services/heartbeat-run-summary.js.map +1 -0
- package/dist/services/heartbeat.d.ts +766 -0
- package/dist/services/heartbeat.d.ts.map +1 -0
- package/dist/services/heartbeat.js +3024 -0
- package/dist/services/heartbeat.js.map +1 -0
- package/dist/services/hire-hook.d.ts +14 -0
- package/dist/services/hire-hook.d.ts.map +1 -0
- package/dist/services/hire-hook.js +85 -0
- package/dist/services/hire-hook.js.map +1 -0
- package/dist/services/index.d.ts +29 -0
- package/dist/services/index.d.ts.map +1 -0
- package/dist/services/index.js +29 -0
- package/dist/services/index.js.map +1 -0
- package/dist/services/instance-settings.d.ts +9 -0
- package/dist/services/instance-settings.d.ts.map +1 -0
- package/dist/services/instance-settings.js +80 -0
- package/dist/services/instance-settings.js.map +1 -0
- package/dist/services/issue-approvals.d.ts +56 -0
- package/dist/services/issue-approvals.d.ts.map +1 -0
- package/dist/services/issue-approvals.js +153 -0
- package/dist/services/issue-approvals.js.map +1 -0
- package/dist/services/issue-goal-fallback.d.ts +15 -0
- package/dist/services/issue-goal-fallback.d.ts.map +1 -0
- package/dist/services/issue-goal-fallback.js +15 -0
- package/dist/services/issue-goal-fallback.js.map +1 -0
- package/dist/services/issues.d.ts +532 -0
- package/dist/services/issues.d.ts.map +1 -0
- package/dist/services/issues.js +1308 -0
- package/dist/services/issues.js.map +1 -0
- package/dist/services/live-events.d.ts +17 -0
- package/dist/services/live-events.d.ts.map +1 -0
- package/dist/services/live-events.js +33 -0
- package/dist/services/live-events.js.map +1 -0
- package/dist/services/plugin-capability-validator.d.ts +108 -0
- package/dist/services/plugin-capability-validator.d.ts.map +1 -0
- package/dist/services/plugin-capability-validator.js +268 -0
- package/dist/services/plugin-capability-validator.js.map +1 -0
- package/dist/services/plugin-config-validator.d.ts +26 -0
- package/dist/services/plugin-config-validator.d.ts.map +1 -0
- package/dist/services/plugin-config-validator.js +41 -0
- package/dist/services/plugin-config-validator.js.map +1 -0
- package/dist/services/plugin-dev-watcher.d.ts +30 -0
- package/dist/services/plugin-dev-watcher.d.ts.map +1 -0
- package/dist/services/plugin-dev-watcher.js +241 -0
- package/dist/services/plugin-dev-watcher.js.map +1 -0
- package/dist/services/plugin-event-bus.d.ts +149 -0
- package/dist/services/plugin-event-bus.d.ts.map +1 -0
- package/dist/services/plugin-event-bus.js +258 -0
- package/dist/services/plugin-event-bus.js.map +1 -0
- package/dist/services/plugin-host-service-cleanup.d.ts +14 -0
- package/dist/services/plugin-host-service-cleanup.d.ts.map +1 -0
- package/dist/services/plugin-host-service-cleanup.js +37 -0
- package/dist/services/plugin-host-service-cleanup.js.map +1 -0
- package/dist/services/plugin-host-services.d.ts +13 -0
- package/dist/services/plugin-host-services.d.ts.map +1 -0
- package/dist/services/plugin-host-services.js +969 -0
- package/dist/services/plugin-host-services.js.map +1 -0
- package/dist/services/plugin-job-coordinator.d.ts +81 -0
- package/dist/services/plugin-job-coordinator.d.ts.map +1 -0
- package/dist/services/plugin-job-coordinator.js +172 -0
- package/dist/services/plugin-job-coordinator.js.map +1 -0
- package/dist/services/plugin-job-scheduler.d.ts +163 -0
- package/dist/services/plugin-job-scheduler.d.ts.map +1 -0
- package/dist/services/plugin-job-scheduler.js +454 -0
- package/dist/services/plugin-job-scheduler.js.map +1 -0
- package/dist/services/plugin-job-store.d.ts +208 -0
- package/dist/services/plugin-job-store.d.ts.map +1 -0
- package/dist/services/plugin-job-store.js +350 -0
- package/dist/services/plugin-job-store.js.map +1 -0
- package/dist/services/plugin-lifecycle.d.ts +203 -0
- package/dist/services/plugin-lifecycle.d.ts.map +1 -0
- package/dist/services/plugin-lifecycle.js +476 -0
- package/dist/services/plugin-lifecycle.js.map +1 -0
- package/dist/services/plugin-loader.d.ts +441 -0
- package/dist/services/plugin-loader.d.ts.map +1 -0
- package/dist/services/plugin-loader.js +1192 -0
- package/dist/services/plugin-loader.js.map +1 -0
- package/dist/services/plugin-log-retention.d.ts +20 -0
- package/dist/services/plugin-log-retention.d.ts.map +1 -0
- package/dist/services/plugin-log-retention.js +63 -0
- package/dist/services/plugin-log-retention.js.map +1 -0
- package/dist/services/plugin-manifest-validator.d.ts +79 -0
- package/dist/services/plugin-manifest-validator.d.ts.map +1 -0
- package/dist/services/plugin-manifest-validator.js +84 -0
- package/dist/services/plugin-manifest-validator.js.map +1 -0
- package/dist/services/plugin-registry.d.ts +2542 -0
- package/dist/services/plugin-registry.d.ts.map +1 -0
- package/dist/services/plugin-registry.js +539 -0
- package/dist/services/plugin-registry.js.map +1 -0
- package/dist/services/plugin-runtime-sandbox.d.ts +40 -0
- package/dist/services/plugin-runtime-sandbox.d.ts.map +1 -0
- package/dist/services/plugin-runtime-sandbox.js +154 -0
- package/dist/services/plugin-runtime-sandbox.js.map +1 -0
- package/dist/services/plugin-secrets-handler.d.ts +81 -0
- package/dist/services/plugin-secrets-handler.d.ts.map +1 -0
- package/dist/services/plugin-secrets-handler.js +275 -0
- package/dist/services/plugin-secrets-handler.js.map +1 -0
- package/dist/services/plugin-state-store.d.ts +92 -0
- package/dist/services/plugin-state-store.d.ts.map +1 -0
- package/dist/services/plugin-state-store.js +190 -0
- package/dist/services/plugin-state-store.js.map +1 -0
- package/dist/services/plugin-stream-bus.d.ts +29 -0
- package/dist/services/plugin-stream-bus.d.ts.map +1 -0
- package/dist/services/plugin-stream-bus.js +48 -0
- package/dist/services/plugin-stream-bus.js.map +1 -0
- package/dist/services/plugin-tool-dispatcher.d.ts +180 -0
- package/dist/services/plugin-tool-dispatcher.d.ts.map +1 -0
- package/dist/services/plugin-tool-dispatcher.js +224 -0
- package/dist/services/plugin-tool-dispatcher.js.map +1 -0
- package/dist/services/plugin-tool-registry.d.ts +192 -0
- package/dist/services/plugin-tool-registry.d.ts.map +1 -0
- package/dist/services/plugin-tool-registry.js +224 -0
- package/dist/services/plugin-tool-registry.js.map +1 -0
- package/dist/services/plugin-worker-manager.d.ts +260 -0
- package/dist/services/plugin-worker-manager.d.ts.map +1 -0
- package/dist/services/plugin-worker-manager.js +835 -0
- package/dist/services/plugin-worker-manager.js.map +1 -0
- package/dist/services/projects.d.ts +87 -0
- package/dist/services/projects.d.ts.map +1 -0
- package/dist/services/projects.js +656 -0
- package/dist/services/projects.js.map +1 -0
- package/dist/services/quota-windows.d.ts +9 -0
- package/dist/services/quota-windows.d.ts.map +1 -0
- package/dist/services/quota-windows.js +56 -0
- package/dist/services/quota-windows.js.map +1 -0
- package/dist/services/run-log-store.d.ts +34 -0
- package/dist/services/run-log-store.d.ts.map +1 -0
- package/dist/services/run-log-store.js +109 -0
- package/dist/services/run-log-store.js.map +1 -0
- package/dist/services/secrets.d.ts +510 -0
- package/dist/services/secrets.d.ts.map +1 -0
- package/dist/services/secrets.js +288 -0
- package/dist/services/secrets.js.map +1 -0
- package/dist/services/sidebar-badges.d.ts +9 -0
- package/dist/services/sidebar-badges.d.ts.map +1 -0
- package/dist/services/sidebar-badges.js +33 -0
- package/dist/services/sidebar-badges.js.map +1 -0
- package/dist/services/work-products.d.ts +14 -0
- package/dist/services/work-products.d.ts.map +1 -0
- package/dist/services/work-products.js +100 -0
- package/dist/services/work-products.js.map +1 -0
- package/dist/services/workspace-operation-log-store.d.ts +33 -0
- package/dist/services/workspace-operation-log-store.d.ts.map +1 -0
- package/dist/services/workspace-operation-log-store.js +110 -0
- package/dist/services/workspace-operation-log-store.js.map +1 -0
- package/dist/services/workspace-operations.d.ts +44 -0
- package/dist/services/workspace-operations.d.ts.map +1 -0
- package/dist/services/workspace-operations.js +204 -0
- package/dist/services/workspace-operations.js.map +1 -0
- package/dist/services/workspace-runtime.d.ts +164 -0
- package/dist/services/workspace-runtime.d.ts.map +1 -0
- package/dist/services/workspace-runtime.js +1235 -0
- package/dist/services/workspace-runtime.js.map +1 -0
- package/dist/startup-banner.d.ts +31 -0
- package/dist/startup-banner.d.ts.map +1 -0
- package/dist/startup-banner.js +117 -0
- package/dist/startup-banner.js.map +1 -0
- package/dist/storage/index.d.ts +6 -0
- package/dist/storage/index.d.ts.map +1 -0
- package/dist/storage/index.js +29 -0
- package/dist/storage/index.js.map +1 -0
- package/dist/storage/local-disk-provider.d.ts +3 -0
- package/dist/storage/local-disk-provider.d.ts.map +1 -0
- package/dist/storage/local-disk-provider.js +79 -0
- package/dist/storage/local-disk-provider.js.map +1 -0
- package/dist/storage/provider-registry.d.ts +4 -0
- package/dist/storage/provider-registry.d.ts.map +1 -0
- package/dist/storage/provider-registry.js +15 -0
- package/dist/storage/provider-registry.js.map +1 -0
- package/dist/storage/s3-provider.d.ts +11 -0
- package/dist/storage/s3-provider.d.ts.map +1 -0
- package/dist/storage/s3-provider.js +123 -0
- package/dist/storage/s3-provider.js.map +1 -0
- package/dist/storage/service.d.ts +3 -0
- package/dist/storage/service.d.ts.map +1 -0
- package/dist/storage/service.js +120 -0
- package/dist/storage/service.js.map +1 -0
- package/dist/storage/types.d.ts +55 -0
- package/dist/storage/types.d.ts.map +1 -0
- package/dist/storage/types.js +2 -0
- package/dist/storage/types.js.map +1 -0
- package/dist/ui-branding.d.ts +13 -0
- package/dist/ui-branding.d.ts.map +1 -0
- package/dist/ui-branding.js +187 -0
- package/dist/ui-branding.js.map +1 -0
- package/dist/version.d.ts +2 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +5 -0
- package/dist/version.js.map +1 -0
- package/dist/wallet/connie-wallet.d.ts +8 -0
- package/dist/wallet/connie-wallet.d.ts.map +1 -0
- package/dist/wallet/connie-wallet.js +28 -0
- package/dist/wallet/connie-wallet.js.map +1 -0
- package/dist/wallet/signer-service.d.ts +46 -0
- package/dist/wallet/signer-service.d.ts.map +1 -0
- package/dist/wallet/signer-service.js +51 -0
- package/dist/wallet/signer-service.js.map +1 -0
- package/package.json +89 -0
- package/skills/paperclip/SKILL.md +310 -0
- package/skills/paperclip/references/api-reference.md +561 -0
- package/skills/paperclip-create-agent/SKILL.md +139 -0
- package/skills/paperclip-create-agent/references/api-reference.md +95 -0
- package/skills/paperclip-create-plugin/SKILL.md +101 -0
- package/skills/para-memory-files/SKILL.md +104 -0
- package/skills/para-memory-files/references/schemas.md +35 -0
- package/ui-dist/android-chrome-192x192.png +0 -0
- package/ui-dist/android-chrome-512x512.png +0 -0
- package/ui-dist/apple-touch-icon.png +0 -0
- package/ui-dist/assets/_basePickBy-C3SapTV-.js +1 -0
- package/ui-dist/assets/_baseUniq-tAa_W7wz.js +1 -0
- package/ui-dist/assets/apl-B4CMkyY2.js +1 -0
- package/ui-dist/assets/arc-1aKL9N1m.js +1 -0
- package/ui-dist/assets/architectureDiagram-VXUJARFQ-C-BWMHir.js +36 -0
- package/ui-dist/assets/asciiarmor-Df11BRmG.js +1 -0
- package/ui-dist/assets/asn1-EdZsLKOL.js +1 -0
- package/ui-dist/assets/asterisk-B-8jnY81.js +1 -0
- package/ui-dist/assets/blockDiagram-VD42YOAC-DiZzNyCp.js +122 -0
- package/ui-dist/assets/brainfuck-C4LP7Hcl.js +1 -0
- package/ui-dist/assets/c4Diagram-YG6GDRKO-BxkN6K8Z.js +10 -0
- package/ui-dist/assets/channel-g6sWbOF_.js +1 -0
- package/ui-dist/assets/chunk-4BX2VUAB-dEQLWXMP.js +1 -0
- package/ui-dist/assets/chunk-55IACEB6-DOlf6bGB.js +1 -0
- package/ui-dist/assets/chunk-B4BG7PRW-D82iJIh4.js +165 -0
- package/ui-dist/assets/chunk-DI55MBZ5-Dvu2BjZt.js +220 -0
- package/ui-dist/assets/chunk-FMBD7UC4-zLtBDqIV.js +15 -0
- package/ui-dist/assets/chunk-QN33PNHL-BsDTCIez.js +1 -0
- package/ui-dist/assets/chunk-QZHKN3VN-CVk0cJt0.js +1 -0
- package/ui-dist/assets/chunk-TZMSLE5B-BkF4gaW2.js +1 -0
- package/ui-dist/assets/classDiagram-2ON5EDUG-D_SGf4i1.js +1 -0
- package/ui-dist/assets/classDiagram-v2-WZHVMYZB-D_SGf4i1.js +1 -0
- package/ui-dist/assets/clike-B9uivgTg.js +1 -0
- package/ui-dist/assets/clojure-BMjYHr_A.js +1 -0
- package/ui-dist/assets/clone-CvdGFEjL.js +1 -0
- package/ui-dist/assets/cmake-BQqOBYOt.js +1 -0
- package/ui-dist/assets/cobol-CWcv1MsR.js +1 -0
- package/ui-dist/assets/coffeescript-S37ZYGWr.js +1 -0
- package/ui-dist/assets/commonlisp-DBKNyK5s.js +1 -0
- package/ui-dist/assets/cose-bilkent-S5V4N54A-DhXJS1Wr.js +1 -0
- package/ui-dist/assets/crystal-SjHAIU92.js +1 -0
- package/ui-dist/assets/css-BnMrqG3P.js +1 -0
- package/ui-dist/assets/cypher-C_CwsFkJ.js +1 -0
- package/ui-dist/assets/cytoscape.esm-BQaXIfA_.js +331 -0
- package/ui-dist/assets/d-pRatUO7H.js +1 -0
- package/ui-dist/assets/dagre-6UL2VRFP-BgSr9M5y.js +4 -0
- package/ui-dist/assets/defaultLocale-DX6XiGOO.js +1 -0
- package/ui-dist/assets/diagram-PSM6KHXK-RVw3ElKR.js +24 -0
- package/ui-dist/assets/diagram-QEK2KX5R-C3K5KNnR.js +43 -0
- package/ui-dist/assets/diagram-S2PKOQOG-L2G5bc-i.js +24 -0
- package/ui-dist/assets/diff-DbItnlRl.js +1 -0
- package/ui-dist/assets/dockerfile-BKs6k2Af.js +1 -0
- package/ui-dist/assets/dtd-DF_7sFjM.js +1 -0
- package/ui-dist/assets/dylan-DwRh75JA.js +1 -0
- package/ui-dist/assets/ebnf-CDyGwa7X.js +1 -0
- package/ui-dist/assets/ecl-Cabwm37j.js +1 -0
- package/ui-dist/assets/eiffel-CnydiIhH.js +1 -0
- package/ui-dist/assets/elm-vLlmbW-K.js +1 -0
- package/ui-dist/assets/erDiagram-Q2GNP2WA-B-fEopEW.js +60 -0
- package/ui-dist/assets/erlang-BNw1qcRV.js +1 -0
- package/ui-dist/assets/factor-kuTfRLto.js +1 -0
- package/ui-dist/assets/fcl-Kvtd6kyn.js +1 -0
- package/ui-dist/assets/flowDiagram-NV44I4VS-B67TmiaU.js +162 -0
- package/ui-dist/assets/forth-Ffai-XNe.js +1 -0
- package/ui-dist/assets/fortran-DYz_wnZ1.js +1 -0
- package/ui-dist/assets/ganttDiagram-JELNMOA3-DyPUX6hg.js +267 -0
- package/ui-dist/assets/gas-Bneqetm1.js +1 -0
- package/ui-dist/assets/gherkin-heZmZLOM.js +1 -0
- package/ui-dist/assets/gitGraphDiagram-V2S2FVAM--OZSHgOs.js +65 -0
- package/ui-dist/assets/graph-BuZXpro8.js +1 -0
- package/ui-dist/assets/groovy-D9Dt4D0W.js +1 -0
- package/ui-dist/assets/haskell-Cw1EW3IL.js +1 -0
- package/ui-dist/assets/haxe-H-WmDvRZ.js +1 -0
- package/ui-dist/assets/http-DBlCnlav.js +1 -0
- package/ui-dist/assets/idl-BEugSyMb.js +1 -0
- package/ui-dist/assets/index-1BDMTcZo.css +1 -0
- package/ui-dist/assets/index-5qKrPxpA.js +1 -0
- package/ui-dist/assets/index-64g9Tgj8.js +1 -0
- package/ui-dist/assets/index-B2BWcxI3.js +1 -0
- package/ui-dist/assets/index-BBnLF7s9.js +1 -0
- package/ui-dist/assets/index-BcGr-t2T.js +3 -0
- package/ui-dist/assets/index-BvFjgW1S.js +1 -0
- package/ui-dist/assets/index-Bwu5E0tU.js +1120 -0
- package/ui-dist/assets/index-CWdVcwY-.js +7 -0
- package/ui-dist/assets/index-CcZ3jKyu.js +1 -0
- package/ui-dist/assets/index-CftQkMtr.js +1 -0
- package/ui-dist/assets/index-CiuvxTr1.js +13 -0
- package/ui-dist/assets/index-CvJFaRY-.js +1 -0
- package/ui-dist/assets/index-D2Vi4KQ1.js +1 -0
- package/ui-dist/assets/index-D9ei6U88.js +6 -0
- package/ui-dist/assets/index-DJHKsR5g.js +1 -0
- package/ui-dist/assets/index-DSGN-qDr.js +1 -0
- package/ui-dist/assets/index-DVPlvZkH.js +1 -0
- package/ui-dist/assets/index-DowQVAaY.js +1 -0
- package/ui-dist/assets/index-Dr_PpBCY.js +1 -0
- package/ui-dist/assets/index-Ivk3iEUq.js +2 -0
- package/ui-dist/assets/index-OVXAhlMW.js +1 -0
- package/ui-dist/assets/index-ff_wE0-y.js +1 -0
- package/ui-dist/assets/index-tIsOsmOg.js +1 -0
- package/ui-dist/assets/infoDiagram-HS3SLOUP-CorcfaW7.js +2 -0
- package/ui-dist/assets/init-Gi6I4Gst.js +1 -0
- package/ui-dist/assets/javascript-iXu5QeM3.js +1 -0
- package/ui-dist/assets/journeyDiagram-XKPGCS4Q-D3K55-qo.js +139 -0
- package/ui-dist/assets/julia-DuME0IfC.js +1 -0
- package/ui-dist/assets/kanban-definition-3W4ZIXB7-47soc494.js +89 -0
- package/ui-dist/assets/katex-O9d3_IXG.js +261 -0
- package/ui-dist/assets/layout-mxhxSLBl.js +1 -0
- package/ui-dist/assets/linear-D5Y7uAaH.js +1 -0
- package/ui-dist/assets/livescript-BwQOo05w.js +1 -0
- package/ui-dist/assets/lua-BgMRiT3U.js +1 -0
- package/ui-dist/assets/mathematica-DTrFuWx2.js +1 -0
- package/ui-dist/assets/mbox-CNhZ1qSd.js +1 -0
- package/ui-dist/assets/mermaid.core-7SNUCoBq.js +256 -0
- package/ui-dist/assets/mindmap-definition-VGOIOE7T-C37ba4sG.js +68 -0
- package/ui-dist/assets/mirc-CjQqDB4T.js +1 -0
- package/ui-dist/assets/mllike-CXdrOF99.js +1 -0
- package/ui-dist/assets/modelica-Dc1JOy9r.js +1 -0
- package/ui-dist/assets/mscgen-BA5vi2Kp.js +1 -0
- package/ui-dist/assets/mumps-BT43cFF4.js +1 -0
- package/ui-dist/assets/nginx-DdIZxoE0.js +1 -0
- package/ui-dist/assets/nsis-LdVXkNf5.js +1 -0
- package/ui-dist/assets/ntriples-BfvgReVJ.js +1 -0
- package/ui-dist/assets/octave-Ck1zUtKM.js +1 -0
- package/ui-dist/assets/ordinal-Cboi1Yqb.js +1 -0
- package/ui-dist/assets/oz-BzwKVEFT.js +1 -0
- package/ui-dist/assets/pascal--L3eBynH.js +1 -0
- package/ui-dist/assets/perl-CdXCOZ3F.js +1 -0
- package/ui-dist/assets/pieDiagram-ADFJNKIX-D78e-tVE.js +30 -0
- package/ui-dist/assets/pig-CevX1Tat.js +1 -0
- package/ui-dist/assets/powershell-CFHJl5sT.js +1 -0
- package/ui-dist/assets/properties-C78fOPTZ.js +1 -0
- package/ui-dist/assets/protobuf-ChK-085T.js +1 -0
- package/ui-dist/assets/pug-DeIclll2.js +1 -0
- package/ui-dist/assets/puppet-DMA9R1ak.js +1 -0
- package/ui-dist/assets/python-BuPzkPfP.js +1 -0
- package/ui-dist/assets/q-pXgVlZs6.js +1 -0
- package/ui-dist/assets/quadrantDiagram-AYHSOK5B-CGERMcfi.js +7 -0
- package/ui-dist/assets/r-B6wPVr8A.js +1 -0
- package/ui-dist/assets/requirementDiagram-UZGBJVZJ-vZWAyhU1.js +64 -0
- package/ui-dist/assets/rpm-CTu-6PCP.js +1 -0
- package/ui-dist/assets/ruby-B2Rjki9n.js +1 -0
- package/ui-dist/assets/sankeyDiagram-TZEHDZUN-C51wCQX7.js +10 -0
- package/ui-dist/assets/sas-B4kiWyti.js +1 -0
- package/ui-dist/assets/scheme-C41bIUwD.js +1 -0
- package/ui-dist/assets/sequenceDiagram-WL72ISMW-eCSbKUaE.js +145 -0
- package/ui-dist/assets/shell-CjFT_Tl9.js +1 -0
- package/ui-dist/assets/sieve-C3Gn_uJK.js +1 -0
- package/ui-dist/assets/simple-mode-GW_nhZxv.js +1 -0
- package/ui-dist/assets/smalltalk-CnHTOXQT.js +1 -0
- package/ui-dist/assets/solr-DehyRSwq.js +1 -0
- package/ui-dist/assets/sparql-DkYu6x3z.js +1 -0
- package/ui-dist/assets/spreadsheet-BCZA_wO0.js +1 -0
- package/ui-dist/assets/sql-D0XecflT.js +1 -0
- package/ui-dist/assets/stateDiagram-FKZM4ZOC-H3lI51qU.js +1 -0
- package/ui-dist/assets/stateDiagram-v2-4FDKWEC3--Q50auwn.js +1 -0
- package/ui-dist/assets/stex-C3f8Ysf7.js +1 -0
- package/ui-dist/assets/stylus-B533Al4x.js +1 -0
- package/ui-dist/assets/swift-BzpIVaGY.js +1 -0
- package/ui-dist/assets/tcl-DVfN8rqt.js +1 -0
- package/ui-dist/assets/textile-CnDTJFAw.js +1 -0
- package/ui-dist/assets/tiddlywiki-DO-Gjzrf.js +1 -0
- package/ui-dist/assets/tiki-DGYXhP31.js +1 -0
- package/ui-dist/assets/timeline-definition-IT6M3QCI-CP9CNQLU.js +61 -0
- package/ui-dist/assets/toml-Bm5Em-hy.js +1 -0
- package/ui-dist/assets/treemap-GDKQZRPO-BfRhErz4.js +162 -0
- package/ui-dist/assets/troff-wAsdV37c.js +1 -0
- package/ui-dist/assets/ttcn-CfJYG6tj.js +1 -0
- package/ui-dist/assets/ttcn-cfg-B9xdYoR4.js +1 -0
- package/ui-dist/assets/turtle-B1tBg_DP.js +1 -0
- package/ui-dist/assets/vb-CmGdzxic.js +1 -0
- package/ui-dist/assets/vbscript-BuJXcnF6.js +1 -0
- package/ui-dist/assets/velocity-D8B20fx6.js +1 -0
- package/ui-dist/assets/verilog-C6RDOZhf.js +1 -0
- package/ui-dist/assets/vhdl-lSbBsy5d.js +1 -0
- package/ui-dist/assets/webidl-ZXfAyPTL.js +1 -0
- package/ui-dist/assets/xquery-DzFWVndE.js +1 -0
- package/ui-dist/assets/xychartDiagram-PRI3JC2R-BSy7gZ_Q.js +7 -0
- package/ui-dist/assets/yacas-BJ4BC0dw.js +1 -0
- package/ui-dist/assets/z80-Hz9HOZM7.js +1 -0
- package/ui-dist/brands/opencode-logo-dark-square.svg +18 -0
- package/ui-dist/brands/opencode-logo-light-square.svg +18 -0
- package/ui-dist/favicon-16x16.png +0 -0
- package/ui-dist/favicon-32x32.png +0 -0
- package/ui-dist/favicon.ico +0 -0
- package/ui-dist/favicon.svg +9 -0
- package/ui-dist/index.html +48 -0
- package/ui-dist/site.webmanifest +30 -0
- package/ui-dist/sw.js +42 -0
- package/ui-dist/worktree-favicon-16x16.png +0 -0
- package/ui-dist/worktree-favicon-32x32.png +0 -0
- package/ui-dist/worktree-favicon.ico +0 -0
- package/ui-dist/worktree-favicon.svg +9 -0
|
@@ -0,0 +1,411 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Plugin UI static file serving route
|
|
3
|
+
*
|
|
4
|
+
* Serves plugin UI bundles from the plugin's dist/ui/ directory under the
|
|
5
|
+
* `/_plugins/:pluginId/ui/*` namespace. This is specified in PLUGIN_SPEC.md
|
|
6
|
+
* §19.0.3 (Bundle Serving).
|
|
7
|
+
*
|
|
8
|
+
* Plugin UI bundles are pre-built ESM that the host serves as static assets.
|
|
9
|
+
* The host dynamically imports the plugin's UI entry module from this path,
|
|
10
|
+
* resolves the named export declared in `ui.slots[].exportName`, and mounts
|
|
11
|
+
* it into the extension slot.
|
|
12
|
+
*
|
|
13
|
+
* Security:
|
|
14
|
+
* - Path traversal is prevented by resolving the requested path and verifying
|
|
15
|
+
* it stays within the plugin's UI directory.
|
|
16
|
+
* - Only plugins in 'ready' status have their UI served.
|
|
17
|
+
* - Only plugins that declare `entrypoints.ui` serve UI bundles.
|
|
18
|
+
*
|
|
19
|
+
* Cache Headers:
|
|
20
|
+
* - Files with content-hash patterns in their name (e.g., `index-a1b2c3d4.js`)
|
|
21
|
+
* receive `Cache-Control: public, max-age=31536000, immutable`.
|
|
22
|
+
* - Other files receive `Cache-Control: public, max-age=0, must-revalidate`
|
|
23
|
+
* with ETag-based conditional request support.
|
|
24
|
+
*
|
|
25
|
+
* @module server/routes/plugin-ui-static
|
|
26
|
+
* @see doc/plugins/PLUGIN_SPEC.md §19.0.3 — Bundle Serving
|
|
27
|
+
* @see doc/plugins/PLUGIN_SPEC.md §25.4.5 — Frontend Cache Invalidation
|
|
28
|
+
*/
|
|
29
|
+
import { Router } from "express";
|
|
30
|
+
import path from "node:path";
|
|
31
|
+
import fs from "node:fs";
|
|
32
|
+
import crypto from "node:crypto";
|
|
33
|
+
import { pluginRegistryService } from "../services/plugin-registry.js";
|
|
34
|
+
import { logger } from "../middleware/logger.js";
|
|
35
|
+
// ---------------------------------------------------------------------------
|
|
36
|
+
// Constants
|
|
37
|
+
// ---------------------------------------------------------------------------
|
|
38
|
+
/**
|
|
39
|
+
* Regex to detect content-hashed filenames.
|
|
40
|
+
*
|
|
41
|
+
* Matches patterns like:
|
|
42
|
+
* - `index-a1b2c3d4.js`
|
|
43
|
+
* - `styles.abc123def.css`
|
|
44
|
+
* - `chunk-ABCDEF01.mjs`
|
|
45
|
+
*
|
|
46
|
+
* The hash portion must be at least 8 hex characters to avoid false positives.
|
|
47
|
+
*/
|
|
48
|
+
const CONTENT_HASH_PATTERN = /[.-][a-fA-F0-9]{8,}\.\w+$/;
|
|
49
|
+
/**
|
|
50
|
+
* Cache-Control header for content-hashed files.
|
|
51
|
+
* These files are immutable by definition (the hash changes when content changes).
|
|
52
|
+
*/
|
|
53
|
+
/** 1 year in seconds — standard for content-hashed immutable resources. */
|
|
54
|
+
const ONE_YEAR_SECONDS = 365 * 24 * 60 * 60; // 31_536_000
|
|
55
|
+
const CACHE_CONTROL_IMMUTABLE = `public, max-age=${ONE_YEAR_SECONDS}, immutable`;
|
|
56
|
+
/**
|
|
57
|
+
* Cache-Control header for non-hashed files.
|
|
58
|
+
* These files must be revalidated on each request (ETag-based).
|
|
59
|
+
*/
|
|
60
|
+
const CACHE_CONTROL_REVALIDATE = "public, max-age=0, must-revalidate";
|
|
61
|
+
/**
|
|
62
|
+
* MIME types for common plugin UI bundle file extensions.
|
|
63
|
+
*/
|
|
64
|
+
const MIME_TYPES = {
|
|
65
|
+
".js": "application/javascript; charset=utf-8",
|
|
66
|
+
".mjs": "application/javascript; charset=utf-8",
|
|
67
|
+
".css": "text/css; charset=utf-8",
|
|
68
|
+
".json": "application/json; charset=utf-8",
|
|
69
|
+
".map": "application/json; charset=utf-8",
|
|
70
|
+
".html": "text/html; charset=utf-8",
|
|
71
|
+
".svg": "image/svg+xml",
|
|
72
|
+
".png": "image/png",
|
|
73
|
+
".jpg": "image/jpeg",
|
|
74
|
+
".jpeg": "image/jpeg",
|
|
75
|
+
".gif": "image/gif",
|
|
76
|
+
".webp": "image/webp",
|
|
77
|
+
".woff": "font/woff",
|
|
78
|
+
".woff2": "font/woff2",
|
|
79
|
+
".ttf": "font/ttf",
|
|
80
|
+
".eot": "application/vnd.ms-fontobject",
|
|
81
|
+
".ico": "image/x-icon",
|
|
82
|
+
".txt": "text/plain; charset=utf-8",
|
|
83
|
+
};
|
|
84
|
+
// ---------------------------------------------------------------------------
|
|
85
|
+
// Helper
|
|
86
|
+
// ---------------------------------------------------------------------------
|
|
87
|
+
/**
|
|
88
|
+
* Resolve a plugin's UI directory from its package location.
|
|
89
|
+
*
|
|
90
|
+
* The plugin's `packageName` is stored in the DB. We resolve the package path
|
|
91
|
+
* from the local plugin directory (DEFAULT_LOCAL_PLUGIN_DIR) by looking in
|
|
92
|
+
* `node_modules`. If the plugin was installed from a local path, the manifest
|
|
93
|
+
* `entrypoints.ui` path is resolved relative to the package directory.
|
|
94
|
+
*
|
|
95
|
+
* @param localPluginDir - The plugin installation directory
|
|
96
|
+
* @param packageName - The npm package name
|
|
97
|
+
* @param entrypointsUi - The UI entrypoint path from the manifest (e.g., "./dist/ui/")
|
|
98
|
+
* @returns Absolute path to the UI directory, or null if not found
|
|
99
|
+
*/
|
|
100
|
+
export function resolvePluginUiDir(localPluginDir, packageName, entrypointsUi, packagePath) {
|
|
101
|
+
// For local-path installs, prefer the persisted package path.
|
|
102
|
+
if (packagePath) {
|
|
103
|
+
const resolvedPackagePath = path.resolve(packagePath);
|
|
104
|
+
if (fs.existsSync(resolvedPackagePath)) {
|
|
105
|
+
const uiDirFromPackagePath = path.resolve(resolvedPackagePath, entrypointsUi);
|
|
106
|
+
if (uiDirFromPackagePath.startsWith(resolvedPackagePath)
|
|
107
|
+
&& fs.existsSync(uiDirFromPackagePath)) {
|
|
108
|
+
return uiDirFromPackagePath;
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
// Resolve the package root within the local plugin directory's node_modules.
|
|
113
|
+
// npm installs go to <localPluginDir>/node_modules/<packageName>/
|
|
114
|
+
let packageRoot;
|
|
115
|
+
if (packageName.startsWith("@")) {
|
|
116
|
+
// Scoped package: @scope/name -> node_modules/@scope/name
|
|
117
|
+
packageRoot = path.join(localPluginDir, "node_modules", ...packageName.split("/"));
|
|
118
|
+
}
|
|
119
|
+
else {
|
|
120
|
+
packageRoot = path.join(localPluginDir, "node_modules", packageName);
|
|
121
|
+
}
|
|
122
|
+
// If the standard location doesn't exist, the plugin may have been installed
|
|
123
|
+
// from a local path. Try to check if the package.json is accessible at the
|
|
124
|
+
// computed path or if the package is found elsewhere.
|
|
125
|
+
if (!fs.existsSync(packageRoot)) {
|
|
126
|
+
// For local-path installs, the packageName may be a directory that doesn't
|
|
127
|
+
// live inside node_modules. Check if the package exists directly at the
|
|
128
|
+
// localPluginDir level.
|
|
129
|
+
const directPath = path.join(localPluginDir, packageName);
|
|
130
|
+
if (fs.existsSync(directPath)) {
|
|
131
|
+
packageRoot = directPath;
|
|
132
|
+
}
|
|
133
|
+
else {
|
|
134
|
+
return null;
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
// Resolve the UI directory relative to the package root
|
|
138
|
+
const uiDir = path.resolve(packageRoot, entrypointsUi);
|
|
139
|
+
// Verify the resolved UI directory exists and is actually inside the package
|
|
140
|
+
if (!fs.existsSync(uiDir)) {
|
|
141
|
+
return null;
|
|
142
|
+
}
|
|
143
|
+
return uiDir;
|
|
144
|
+
}
|
|
145
|
+
/**
|
|
146
|
+
* Compute an ETag from file stat (size + mtime).
|
|
147
|
+
* This is a lightweight approach that avoids reading the file content.
|
|
148
|
+
*/
|
|
149
|
+
function computeETag(size, mtimeMs) {
|
|
150
|
+
const ETAG_VERSION = "v2";
|
|
151
|
+
const hash = crypto
|
|
152
|
+
.createHash("md5")
|
|
153
|
+
.update(`${ETAG_VERSION}:${size}-${mtimeMs}`)
|
|
154
|
+
.digest("hex")
|
|
155
|
+
.slice(0, 16);
|
|
156
|
+
return `"${hash}"`;
|
|
157
|
+
}
|
|
158
|
+
/**
|
|
159
|
+
* Create an Express router that serves plugin UI static files.
|
|
160
|
+
*
|
|
161
|
+
* This route handles `GET /_plugins/:pluginId/ui/*` requests by:
|
|
162
|
+
* 1. Looking up the plugin in the registry by ID or key
|
|
163
|
+
* 2. Verifying the plugin is in 'ready' status with UI declared
|
|
164
|
+
* 3. Resolving the file path within the plugin's dist/ui/ directory
|
|
165
|
+
* 4. Serving the file with appropriate cache headers
|
|
166
|
+
*
|
|
167
|
+
* @param db - Database connection for plugin registry lookups
|
|
168
|
+
* @param options - Configuration options
|
|
169
|
+
* @returns Express router
|
|
170
|
+
*/
|
|
171
|
+
export function pluginUiStaticRoutes(db, options) {
|
|
172
|
+
const router = Router();
|
|
173
|
+
const registry = pluginRegistryService(db);
|
|
174
|
+
const log = logger.child({ service: "plugin-ui-static" });
|
|
175
|
+
/**
|
|
176
|
+
* GET /_plugins/:pluginId/ui/*
|
|
177
|
+
*
|
|
178
|
+
* Serve a static file from a plugin's UI bundle directory.
|
|
179
|
+
*
|
|
180
|
+
* The :pluginId parameter accepts either:
|
|
181
|
+
* - Database UUID
|
|
182
|
+
* - Plugin key (e.g., "acme.linear")
|
|
183
|
+
*
|
|
184
|
+
* The wildcard captures the relative file path within the UI directory.
|
|
185
|
+
*
|
|
186
|
+
* Cache strategy:
|
|
187
|
+
* - Content-hashed filenames → immutable, 1-year max-age
|
|
188
|
+
* - Other files → must-revalidate with ETag
|
|
189
|
+
*/
|
|
190
|
+
router.get("/_plugins/:pluginId/ui/*filePath", async (req, res) => {
|
|
191
|
+
const { pluginId } = req.params;
|
|
192
|
+
// Extract the relative file path from the named wildcard.
|
|
193
|
+
// In Express 5 with path-to-regexp v8, named wildcards may return
|
|
194
|
+
// an array of path segments or a single string.
|
|
195
|
+
const rawParam = req.params.filePath;
|
|
196
|
+
const rawFilePath = Array.isArray(rawParam)
|
|
197
|
+
? rawParam.join("/")
|
|
198
|
+
: rawParam;
|
|
199
|
+
if (!rawFilePath || rawFilePath.length === 0) {
|
|
200
|
+
res.status(400).json({ error: "File path is required" });
|
|
201
|
+
return;
|
|
202
|
+
}
|
|
203
|
+
// Step 1: Look up the plugin
|
|
204
|
+
let plugin = null;
|
|
205
|
+
try {
|
|
206
|
+
plugin = await registry.getById(pluginId);
|
|
207
|
+
}
|
|
208
|
+
catch (error) {
|
|
209
|
+
const maybeCode = typeof error === "object" && error !== null && "code" in error
|
|
210
|
+
? error.code
|
|
211
|
+
: undefined;
|
|
212
|
+
if (maybeCode !== "22P02") {
|
|
213
|
+
throw error;
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
if (!plugin) {
|
|
217
|
+
plugin = await registry.getByKey(pluginId);
|
|
218
|
+
}
|
|
219
|
+
if (!plugin) {
|
|
220
|
+
res.status(404).json({ error: "Plugin not found" });
|
|
221
|
+
return;
|
|
222
|
+
}
|
|
223
|
+
// Step 2: Verify the plugin is ready and has UI declared
|
|
224
|
+
if (plugin.status !== "ready") {
|
|
225
|
+
res.status(403).json({
|
|
226
|
+
error: `Plugin UI is not available (status: ${plugin.status})`,
|
|
227
|
+
});
|
|
228
|
+
return;
|
|
229
|
+
}
|
|
230
|
+
const manifest = plugin.manifestJson;
|
|
231
|
+
if (!manifest?.entrypoints?.ui) {
|
|
232
|
+
res.status(404).json({ error: "Plugin does not declare a UI bundle" });
|
|
233
|
+
return;
|
|
234
|
+
}
|
|
235
|
+
// Step 2b: Check for devUiUrl in plugin config — proxy to local dev server
|
|
236
|
+
// when a plugin author has configured a dev server URL for hot-reload.
|
|
237
|
+
// See PLUGIN_SPEC.md §27.2 — Local Development Workflow
|
|
238
|
+
try {
|
|
239
|
+
const configRow = await registry.getConfig(plugin.id);
|
|
240
|
+
const devUiUrl = configRow &&
|
|
241
|
+
typeof configRow === "object" &&
|
|
242
|
+
"configJson" in configRow &&
|
|
243
|
+
configRow.configJson?.devUiUrl;
|
|
244
|
+
if (typeof devUiUrl === "string" && devUiUrl.length > 0) {
|
|
245
|
+
// Dev proxy is only available in development mode
|
|
246
|
+
if (process.env.NODE_ENV === "production") {
|
|
247
|
+
log.warn({ pluginId: plugin.id }, "plugin-ui-static: devUiUrl ignored in production");
|
|
248
|
+
// Fall through to static file serving below
|
|
249
|
+
}
|
|
250
|
+
else {
|
|
251
|
+
// Guard against rawFilePath overriding the base URL via protocol
|
|
252
|
+
// scheme (e.g. "https://evil.com/x") or protocol-relative paths
|
|
253
|
+
// (e.g. "//evil.com/x") which cause `new URL(path, base)` to
|
|
254
|
+
// ignore the base entirely.
|
|
255
|
+
// Normalize percent-encoding so encoded slashes (%2F) can't bypass
|
|
256
|
+
// the protocol/path checks below.
|
|
257
|
+
let decodedPath;
|
|
258
|
+
try {
|
|
259
|
+
decodedPath = decodeURIComponent(rawFilePath);
|
|
260
|
+
}
|
|
261
|
+
catch {
|
|
262
|
+
res.status(400).json({ error: "Invalid file path" });
|
|
263
|
+
return;
|
|
264
|
+
}
|
|
265
|
+
if (decodedPath.includes("://") ||
|
|
266
|
+
decodedPath.startsWith("//") ||
|
|
267
|
+
decodedPath.startsWith("\\\\")) {
|
|
268
|
+
res.status(400).json({ error: "Invalid file path" });
|
|
269
|
+
return;
|
|
270
|
+
}
|
|
271
|
+
// Proxy the request to the dev server
|
|
272
|
+
const targetUrl = new URL(rawFilePath, devUiUrl.endsWith("/") ? devUiUrl : devUiUrl + "/");
|
|
273
|
+
// SSRF protection: only allow http/https and localhost targets for dev proxy
|
|
274
|
+
if (targetUrl.protocol !== "http:" && targetUrl.protocol !== "https:") {
|
|
275
|
+
res.status(400).json({ error: "devUiUrl must use http or https protocol" });
|
|
276
|
+
return;
|
|
277
|
+
}
|
|
278
|
+
// Dev proxy is restricted to loopback addresses only.
|
|
279
|
+
// Validate the *constructed* targetUrl hostname (not the base) to
|
|
280
|
+
// catch any path-based override that slipped past the checks above.
|
|
281
|
+
const devHost = targetUrl.hostname;
|
|
282
|
+
const isLoopback = devHost === "localhost" ||
|
|
283
|
+
devHost === "127.0.0.1" ||
|
|
284
|
+
devHost === "::1" ||
|
|
285
|
+
devHost === "[::1]";
|
|
286
|
+
if (!isLoopback) {
|
|
287
|
+
log.warn({ pluginId: plugin.id, devUiUrl, host: devHost }, "plugin-ui-static: devUiUrl must target localhost, rejecting proxy");
|
|
288
|
+
res.status(400).json({ error: "devUiUrl must target localhost" });
|
|
289
|
+
return;
|
|
290
|
+
}
|
|
291
|
+
log.debug({ pluginId: plugin.id, devUiUrl, targetUrl: targetUrl.href }, "plugin-ui-static: proxying to devUiUrl");
|
|
292
|
+
try {
|
|
293
|
+
const controller = new AbortController();
|
|
294
|
+
const timeout = setTimeout(() => controller.abort(), 10_000);
|
|
295
|
+
try {
|
|
296
|
+
const upstream = await fetch(targetUrl.href, { signal: controller.signal });
|
|
297
|
+
if (!upstream.ok) {
|
|
298
|
+
res.status(upstream.status).json({
|
|
299
|
+
error: `Dev server returned ${upstream.status}`,
|
|
300
|
+
});
|
|
301
|
+
return;
|
|
302
|
+
}
|
|
303
|
+
const contentType = upstream.headers.get("content-type");
|
|
304
|
+
if (contentType)
|
|
305
|
+
res.set("Content-Type", contentType);
|
|
306
|
+
res.set("Cache-Control", "no-cache, no-store, must-revalidate");
|
|
307
|
+
const body = await upstream.arrayBuffer();
|
|
308
|
+
res.send(Buffer.from(body));
|
|
309
|
+
return;
|
|
310
|
+
}
|
|
311
|
+
finally {
|
|
312
|
+
clearTimeout(timeout);
|
|
313
|
+
}
|
|
314
|
+
}
|
|
315
|
+
catch (proxyErr) {
|
|
316
|
+
log.warn({
|
|
317
|
+
pluginId: plugin.id,
|
|
318
|
+
devUiUrl,
|
|
319
|
+
err: proxyErr instanceof Error ? proxyErr.message : String(proxyErr),
|
|
320
|
+
}, "plugin-ui-static: failed to proxy to devUiUrl, falling back to static");
|
|
321
|
+
// Fall through to static serving below
|
|
322
|
+
}
|
|
323
|
+
}
|
|
324
|
+
}
|
|
325
|
+
}
|
|
326
|
+
catch {
|
|
327
|
+
// Config lookup failure is non-fatal — fall through to static serving
|
|
328
|
+
}
|
|
329
|
+
// Step 3: Resolve the plugin's UI directory
|
|
330
|
+
const uiDir = resolvePluginUiDir(options.localPluginDir, plugin.packageName, manifest.entrypoints.ui, plugin.packagePath);
|
|
331
|
+
if (!uiDir) {
|
|
332
|
+
log.warn({ pluginId: plugin.id, pluginKey: plugin.pluginKey, packageName: plugin.packageName }, "plugin-ui-static: UI directory not found on disk");
|
|
333
|
+
res.status(404).json({ error: "Plugin UI directory not found" });
|
|
334
|
+
return;
|
|
335
|
+
}
|
|
336
|
+
// Step 4: Resolve the requested file path and prevent traversal (including symlinks)
|
|
337
|
+
const resolvedFilePath = path.resolve(uiDir, rawFilePath);
|
|
338
|
+
// Step 5: Check that the file exists and is a regular file
|
|
339
|
+
let fileStat;
|
|
340
|
+
try {
|
|
341
|
+
fileStat = fs.statSync(resolvedFilePath);
|
|
342
|
+
}
|
|
343
|
+
catch {
|
|
344
|
+
res.status(404).json({ error: "File not found" });
|
|
345
|
+
return;
|
|
346
|
+
}
|
|
347
|
+
// Security: resolve symlinks via realpathSync and verify containment.
|
|
348
|
+
// This prevents symlink-based traversal that string-based startsWith misses.
|
|
349
|
+
let realFilePath;
|
|
350
|
+
let realUiDir;
|
|
351
|
+
try {
|
|
352
|
+
realFilePath = fs.realpathSync(resolvedFilePath);
|
|
353
|
+
realUiDir = fs.realpathSync(uiDir);
|
|
354
|
+
}
|
|
355
|
+
catch {
|
|
356
|
+
res.status(404).json({ error: "File not found" });
|
|
357
|
+
return;
|
|
358
|
+
}
|
|
359
|
+
const relative = path.relative(realUiDir, realFilePath);
|
|
360
|
+
if (relative.startsWith("..") || path.isAbsolute(relative)) {
|
|
361
|
+
res.status(403).json({ error: "Access denied" });
|
|
362
|
+
return;
|
|
363
|
+
}
|
|
364
|
+
if (!fileStat.isFile()) {
|
|
365
|
+
res.status(404).json({ error: "File not found" });
|
|
366
|
+
return;
|
|
367
|
+
}
|
|
368
|
+
// Step 6: Determine cache strategy based on filename
|
|
369
|
+
const basename = path.basename(resolvedFilePath);
|
|
370
|
+
const isContentHashed = CONTENT_HASH_PATTERN.test(basename);
|
|
371
|
+
// Step 7: Set cache headers
|
|
372
|
+
if (isContentHashed) {
|
|
373
|
+
res.set("Cache-Control", CACHE_CONTROL_IMMUTABLE);
|
|
374
|
+
}
|
|
375
|
+
else {
|
|
376
|
+
res.set("Cache-Control", CACHE_CONTROL_REVALIDATE);
|
|
377
|
+
// Compute and set ETag for conditional request support
|
|
378
|
+
const etag = computeETag(fileStat.size, fileStat.mtimeMs);
|
|
379
|
+
res.set("ETag", etag);
|
|
380
|
+
// Check If-None-Match for 304 Not Modified
|
|
381
|
+
const ifNoneMatch = req.headers["if-none-match"];
|
|
382
|
+
if (ifNoneMatch === etag) {
|
|
383
|
+
res.status(304).end();
|
|
384
|
+
return;
|
|
385
|
+
}
|
|
386
|
+
}
|
|
387
|
+
// Step 8: Set Content-Type
|
|
388
|
+
const ext = path.extname(resolvedFilePath).toLowerCase();
|
|
389
|
+
const contentType = MIME_TYPES[ext];
|
|
390
|
+
if (contentType) {
|
|
391
|
+
res.set("Content-Type", contentType);
|
|
392
|
+
}
|
|
393
|
+
// Step 9: Set CORS headers (plugin UI may be loaded from different origin in dev)
|
|
394
|
+
res.set("Access-Control-Allow-Origin", "*");
|
|
395
|
+
// Step 10: Send the file
|
|
396
|
+
// The plugin source can live in Git worktrees (e.g. ".worktrees/...").
|
|
397
|
+
// `send` defaults to dotfiles:"ignore", which treats dot-directories as
|
|
398
|
+
// not found. We already enforce traversal safety above, so allow dot paths.
|
|
399
|
+
res.sendFile(resolvedFilePath, { dotfiles: "allow" }, (err) => {
|
|
400
|
+
if (err) {
|
|
401
|
+
log.error({ err, pluginId: plugin.id, filePath: resolvedFilePath }, "plugin-ui-static: error sending file");
|
|
402
|
+
// Only send error if headers haven't been sent yet
|
|
403
|
+
if (!res.headersSent) {
|
|
404
|
+
res.status(500).json({ error: "Failed to serve file" });
|
|
405
|
+
}
|
|
406
|
+
}
|
|
407
|
+
});
|
|
408
|
+
});
|
|
409
|
+
return router;
|
|
410
|
+
}
|
|
411
|
+
//# sourceMappingURL=plugin-ui-static.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"plugin-ui-static.js","sourceRoot":"","sources":["../../src/routes/plugin-ui-static.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Plugin management REST API routes
|
|
3
|
+
*
|
|
4
|
+
* This module provides Express routes for managing the complete plugin lifecycle:
|
|
5
|
+
* - Listing and filtering plugins by status
|
|
6
|
+
* - Installing plugins from npm or local paths
|
|
7
|
+
* - Uninstalling plugins (soft delete or hard purge)
|
|
8
|
+
* - Enabling/disabling plugins
|
|
9
|
+
* - Running health diagnostics
|
|
10
|
+
* - Upgrading plugins
|
|
11
|
+
* - Retrieving UI slot contributions for frontend rendering
|
|
12
|
+
* - Discovering and executing plugin-contributed agent tools
|
|
13
|
+
*
|
|
14
|
+
* All routes require board-level authentication (assertBoard middleware).
|
|
15
|
+
*
|
|
16
|
+
* @module server/routes/plugins
|
|
17
|
+
* @see doc/plugins/PLUGIN_SPEC.md for the full plugin specification
|
|
18
|
+
*/
|
|
19
|
+
import type { Db } from "@paperclipai_dld/db";
|
|
20
|
+
import { pluginLoader } from "../services/plugin-loader.js";
|
|
21
|
+
import type { PluginJobScheduler } from "../services/plugin-job-scheduler.js";
|
|
22
|
+
import type { PluginJobStore } from "../services/plugin-job-store.js";
|
|
23
|
+
import type { PluginWorkerManager } from "../services/plugin-worker-manager.js";
|
|
24
|
+
import type { PluginStreamBus } from "../services/plugin-stream-bus.js";
|
|
25
|
+
import type { PluginToolDispatcher } from "../services/plugin-tool-dispatcher.js";
|
|
26
|
+
/**
|
|
27
|
+
* Optional dependencies for plugin job scheduling routes.
|
|
28
|
+
*
|
|
29
|
+
* When provided, job-related routes (list jobs, list runs, trigger job) are
|
|
30
|
+
* mounted. When omitted, the routes return 501 Not Implemented.
|
|
31
|
+
*/
|
|
32
|
+
export interface PluginRouteJobDeps {
|
|
33
|
+
/** The job scheduler instance. */
|
|
34
|
+
scheduler: PluginJobScheduler;
|
|
35
|
+
/** The job persistence store. */
|
|
36
|
+
jobStore: PluginJobStore;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Optional dependencies for plugin webhook routes.
|
|
40
|
+
*
|
|
41
|
+
* When provided, the webhook ingestion route is enabled. When omitted,
|
|
42
|
+
* webhook POST requests return 501 Not Implemented.
|
|
43
|
+
*/
|
|
44
|
+
export interface PluginRouteWebhookDeps {
|
|
45
|
+
/** The worker manager for dispatching handleWebhook RPC calls. */
|
|
46
|
+
workerManager: PluginWorkerManager;
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* Optional dependencies for plugin tool routes.
|
|
50
|
+
*
|
|
51
|
+
* When provided, tool discovery and execution routes are enabled.
|
|
52
|
+
* When omitted, the tool routes return 501 Not Implemented.
|
|
53
|
+
*/
|
|
54
|
+
export interface PluginRouteToolDeps {
|
|
55
|
+
/** The tool dispatcher for listing and executing plugin tools. */
|
|
56
|
+
toolDispatcher: PluginToolDispatcher;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Optional dependencies for plugin UI bridge routes.
|
|
60
|
+
*
|
|
61
|
+
* When provided, the getData and performAction bridge proxy routes are enabled,
|
|
62
|
+
* allowing plugin UI components to communicate with their worker backend via
|
|
63
|
+
* `usePluginData()` and `usePluginAction()` hooks.
|
|
64
|
+
*
|
|
65
|
+
* @see PLUGIN_SPEC.md §13.8 — `getData`
|
|
66
|
+
* @see PLUGIN_SPEC.md §13.9 — `performAction`
|
|
67
|
+
* @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
|
|
68
|
+
*/
|
|
69
|
+
export interface PluginRouteBridgeDeps {
|
|
70
|
+
/** The worker manager for dispatching getData/performAction RPC calls. */
|
|
71
|
+
workerManager: PluginWorkerManager;
|
|
72
|
+
/** Optional stream bus for SSE push from worker to UI. */
|
|
73
|
+
streamBus?: PluginStreamBus;
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* Create Express router for plugin management API.
|
|
77
|
+
*
|
|
78
|
+
* Routes provided:
|
|
79
|
+
*
|
|
80
|
+
* | Method | Path | Description |
|
|
81
|
+
* |--------|------|-------------|
|
|
82
|
+
* | GET | /plugins | List all plugins (optional ?status= filter) |
|
|
83
|
+
* | GET | /plugins/ui-contributions | Get UI slots from ready plugins |
|
|
84
|
+
* | GET | /plugins/:pluginId | Get single plugin by ID or key |
|
|
85
|
+
* | POST | /plugins/install | Install from npm or local path |
|
|
86
|
+
* | DELETE | /plugins/:pluginId | Uninstall (optional ?purge=true) |
|
|
87
|
+
* | POST | /plugins/:pluginId/enable | Enable a plugin |
|
|
88
|
+
* | POST | /plugins/:pluginId/disable | Disable a plugin |
|
|
89
|
+
* | GET | /plugins/:pluginId/health | Run health diagnostics |
|
|
90
|
+
* | POST | /plugins/:pluginId/upgrade | Upgrade to newer version |
|
|
91
|
+
* | GET | /plugins/:pluginId/jobs | List jobs for a plugin |
|
|
92
|
+
* | GET | /plugins/:pluginId/jobs/:jobId/runs | List runs for a job |
|
|
93
|
+
* | POST | /plugins/:pluginId/jobs/:jobId/trigger | Manually trigger a job |
|
|
94
|
+
* | POST | /plugins/:pluginId/webhooks/:endpointKey | Receive inbound webhook |
|
|
95
|
+
* | GET | /plugins/tools | List all available plugin tools |
|
|
96
|
+
* | GET | /plugins/tools?pluginId=... | List tools for a specific plugin |
|
|
97
|
+
* | POST | /plugins/tools/execute | Execute a plugin tool |
|
|
98
|
+
* | GET | /plugins/:pluginId/config | Get current plugin config |
|
|
99
|
+
* | POST | /plugins/:pluginId/config | Save (upsert) plugin config |
|
|
100
|
+
* | POST | /plugins/:pluginId/config/test | Test config via validateConfig RPC |
|
|
101
|
+
* | POST | /plugins/:pluginId/bridge/data | Proxy getData to plugin worker |
|
|
102
|
+
* | POST | /plugins/:pluginId/bridge/action | Proxy performAction to plugin worker |
|
|
103
|
+
* | POST | /plugins/:pluginId/data/:key | Proxy getData to plugin worker (key in URL) |
|
|
104
|
+
* | POST | /plugins/:pluginId/actions/:key | Proxy performAction to plugin worker (key in URL) |
|
|
105
|
+
* | GET | /plugins/:pluginId/bridge/stream/:channel | SSE stream from worker to UI |
|
|
106
|
+
* | GET | /plugins/:pluginId/dashboard | Aggregated health dashboard data |
|
|
107
|
+
*
|
|
108
|
+
* **Route Ordering Note:** Static routes (like /ui-contributions, /tools) must be
|
|
109
|
+
* registered before parameterized routes (like /:pluginId) to prevent Express from
|
|
110
|
+
* matching them as a plugin ID.
|
|
111
|
+
*
|
|
112
|
+
* @param db - Database connection instance
|
|
113
|
+
* @param jobDeps - Optional job scheduling dependencies
|
|
114
|
+
* @param webhookDeps - Optional webhook ingestion dependencies
|
|
115
|
+
* @param toolDeps - Optional tool dispatcher dependencies
|
|
116
|
+
* @param bridgeDeps - Optional bridge proxy dependencies for getData/performAction
|
|
117
|
+
* @returns Express router with plugin routes mounted
|
|
118
|
+
*/
|
|
119
|
+
export declare function pluginRoutes(db: Db, loader: ReturnType<typeof pluginLoader>, jobDeps?: PluginRouteJobDeps, webhookDeps?: PluginRouteWebhookDeps, toolDeps?: PluginRouteToolDeps, bridgeDeps?: PluginRouteBridgeDeps): import("express-serve-static-core").Router;
|
|
120
|
+
//# sourceMappingURL=plugins.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/routes/plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAa9C,OAAO,EAAmC,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAG7F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAoJlF;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,iCAAiC;IACjC,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,aAAa,EAAE,mBAAmB,CAAC;CACpC;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,cAAc,EAAE,oBAAoB,CAAC;CACtC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,aAAa,EAAE,mBAAmB,CAAC;IACnC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,EAAE,EACN,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,EACvC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,WAAW,CAAC,EAAE,sBAAsB,EACpC,QAAQ,CAAC,EAAE,mBAAmB,EAC9B,UAAU,CAAC,EAAE,qBAAqB,8CAu3DnC"}
|