@rudderhq/plugin-sdk 0.3.6-canary.9 → 0.4.1

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/README.md CHANGED
@@ -8,7 +8,7 @@ Official TypeScript SDK for Rudder plugin authors.
8
8
  - **Bundlers:** `@rudderhq/plugin-sdk/bundlers` — esbuild/rollup presets
9
9
  - **Dev server:** `@rudderhq/plugin-sdk/dev-server` — static UI server + SSE reload
10
10
 
11
- Reference: `doc/plugins/PLUGIN_SPEC.md`
11
+ Reference: `../../../doc/engineering/PLUGIN_RUNTIME_CONTRACT.md`
12
12
 
13
13
  ## Package surface
14
14
 
@@ -102,7 +102,7 @@ runWorker(plugin, import.meta.url);
102
102
 
103
103
  **Context (`ctx`) in setup:** `config`, `events`, `jobs`, `launchers`, `http`, `secrets`, `activity`, `state`, `entities`, `projects`, `companies`, `issues`, `agents`, `goals`, `data`, `actions`, `streams`, `tools`, `metrics`, `logger`, `manifest`. Worker-side host APIs are capability-gated; declare capabilities in the manifest.
104
104
 
105
- **Agents:** `ctx.agents.invoke(agentId, companyId, opts)` for one-shot invocation. `ctx.agents.sessions` for two-way chat: `create`, `list`, `sendMessage` (with streaming `onEvent` callback), `close`. See the [Plugin Authoring Guide](../../doc/plugins/PLUGIN_AUTHORING_GUIDE.md#agent-sessions-two-way-chat) for details.
105
+ **Agents:** `ctx.agents.invoke(agentId, companyId, opts)` for one-shot invocation. `ctx.agents.sessions` for two-way chat: `create`, `list`, `sendMessage` (with streaming `onEvent` callback), `close`. See the [Plugin Authoring Guide](../../../doc/engineering/PLUGIN_AUTHORING_GUIDE.md#agent-sessions-two-way-chat) for details.
106
106
 
107
107
  **Jobs:** Declare in `manifest.jobs` with `jobKey`, `displayName`, `schedule` (cron). Register handler with `ctx.jobs.register(jobKey, fn)`. **Webhooks:** Declare in `manifest.webhooks` with `endpointKey`; handle in `onWebhook(input)`. **State:** `ctx.state.get/set/delete(scopeKey)`; scope kinds: `instance`, `company`, `project`, `project_workspace`, `agent`, `issue`, `goal`, `run`.
108
108
 
@@ -583,7 +583,7 @@ Plugins can add a link under each project in the sidebar via the `projectSidebar
583
583
  }
584
584
  ```
585
585
 
586
- Minimal React component that links to the project’s plugin tab (see project detail tabs in the spec):
586
+ Minimal React component that links to the project’s plugin tab:
587
587
 
588
588
  ```tsx
589
589
  import type { PluginProjectSidebarItemProps } from "@rudderhq/plugin-sdk/ui";
@@ -600,7 +600,7 @@ export function FilesLink({ context }: PluginProjectSidebarItemProps) {
600
600
  }
601
601
  ```
602
602
 
603
- Use optional `order` in the slot to sort among other project sidebar items. See §19.5.1 in the plugin spec and project detail plugin tabs (§19.3) for the full flow.
603
+ Use optional `order` in the slot to sort among other project sidebar items. Project sidebar items and project detail plugin tabs are covered in the current plugin runtime contract.
604
604
 
605
605
  ## Toolbar launcher with a local modal
606
606
 
@@ -6,7 +6,7 @@
6
6
  * calls `setup()` with a `PluginContext`, and from that point the plugin
7
7
  * responds to events, jobs, webhooks, and UI requests through the context.
8
8
  *
9
- * @see PLUGIN_SPEC.md §14.1 — Example SDK Shape
9
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Example SDK Shape
10
10
  *
11
11
  * @example
12
12
  * ```ts
@@ -50,7 +50,7 @@ import type { PluginContext } from "./types.js";
50
50
  /**
51
51
  * Optional plugin-reported diagnostics returned from the `health()` RPC method.
52
52
  *
53
- * @see PLUGIN_SPEC.md §13.2 — `health`
53
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `health`
54
54
  */
55
55
  export interface PluginHealthDiagnostics {
56
56
  /** Machine-readable status: `"ok"` | `"degraded"` | `"error"`. */
@@ -63,7 +63,7 @@ export interface PluginHealthDiagnostics {
63
63
  /**
64
64
  * Result returned from the `validateConfig()` RPC method.
65
65
  *
66
- * @see PLUGIN_SPEC.md §13.3 — `validateConfig`
66
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `validateConfig`
67
67
  */
68
68
  export interface PluginConfigValidationResult {
69
69
  /** Whether the config is valid. */
@@ -76,7 +76,7 @@ export interface PluginConfigValidationResult {
76
76
  /**
77
77
  * Input received by the plugin worker's `handleWebhook` handler.
78
78
  *
79
- * @see PLUGIN_SPEC.md §13.7 — `handleWebhook`
79
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `handleWebhook`
80
80
  */
81
81
  export interface PluginWebhookInput {
82
82
  /** Endpoint key matching the manifest declaration. */
@@ -101,7 +101,7 @@ export interface PluginWebhookInput {
101
101
  * host applies default behaviour (e.g. restarting the worker on config change
102
102
  * instead of calling `onConfigChanged`).
103
103
  *
104
- * @see PLUGIN_SPEC.md §13 — Host-Worker Protocol
104
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Host-Worker Protocol
105
105
  */
106
106
  export interface PluginDefinition {
107
107
  /**
@@ -122,7 +122,7 @@ export interface PluginDefinition {
122
122
  * plugin health dashboard. If not implemented, the host infers health from
123
123
  * worker process liveness.
124
124
  *
125
- * @see PLUGIN_SPEC.md §13.2 — `health`
125
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `health`
126
126
  */
127
127
  onHealth?(): Promise<PluginHealthDiagnostics>;
128
128
  /**
@@ -132,7 +132,7 @@ export interface PluginDefinition {
132
132
  * If not implemented, the host restarts the worker to apply the new config.
133
133
  *
134
134
  * @param newConfig - The newly resolved configuration
135
- * @see PLUGIN_SPEC.md §13.4 — `configChanged`
135
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `configChanged`
136
136
  */
137
137
  onConfigChanged?(newConfig: Record<string, unknown>): Promise<void>;
138
138
  /**
@@ -142,7 +142,7 @@ export interface PluginDefinition {
142
142
  * finish in-flight work and resolve this promise. After the deadline the
143
143
  * host sends SIGTERM, then SIGKILL.
144
144
  *
145
- * @see PLUGIN_SPEC.md §12.5 — Graceful Shutdown Policy
145
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Graceful Shutdown Policy
146
146
  */
147
147
  onShutdown?(): Promise<void>;
148
148
  /**
@@ -154,7 +154,7 @@ export interface PluginDefinition {
154
154
  * - via the "Test Connection" button in the settings UI
155
155
  *
156
156
  * @param config - The configuration to validate
157
- * @see PLUGIN_SPEC.md §13.3 — `validateConfig`
157
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `validateConfig`
158
158
  */
159
159
  onValidateConfig?(config: Record<string, unknown>): Promise<PluginConfigValidationResult>;
160
160
  /**
@@ -168,7 +168,7 @@ export interface PluginDefinition {
168
168
  * returns HTTP 501 for webhook deliveries.
169
169
  *
170
170
  * @param input - Webhook delivery metadata and payload
171
- * @see PLUGIN_SPEC.md §13.7 — `handleWebhook`
171
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `handleWebhook`
172
172
  */
173
173
  onWebhook?(input: PluginWebhookInput): Promise<void>;
174
174
  }
@@ -178,7 +178,7 @@ export interface PluginDefinition {
178
178
  * Plugin authors export this as the default export from their worker
179
179
  * entrypoint. The host imports it and calls the lifecycle methods.
180
180
  *
181
- * @see PLUGIN_SPEC.md §14 — SDK Surface
181
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — SDK Surface
182
182
  */
183
183
  export interface PaperclipPlugin {
184
184
  /** The original plugin definition passed to `definePlugin()`. */
@@ -212,7 +212,7 @@ export interface PaperclipPlugin {
212
212
  * });
213
213
  * ```
214
214
  *
215
- * @see PLUGIN_SPEC.md §14.1 — Example SDK Shape
215
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Example SDK Shape
216
216
  */
217
217
  export declare function definePlugin(definition: PluginDefinition): PaperclipPlugin;
218
218
  //# sourceMappingURL=define-plugin.d.ts.map
@@ -6,7 +6,7 @@
6
6
  * calls `setup()` with a `PluginContext`, and from that point the plugin
7
7
  * responds to events, jobs, webhooks, and UI requests through the context.
8
8
  *
9
- * @see PLUGIN_SPEC.md §14.1 — Example SDK Shape
9
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Example SDK Shape
10
10
  *
11
11
  * @example
12
12
  * ```ts
@@ -77,7 +77,7 @@
77
77
  * });
78
78
  * ```
79
79
  *
80
- * @see PLUGIN_SPEC.md §14.1 — Example SDK Shape
80
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Example SDK Shape
81
81
  */
82
82
  export function definePlugin(definition) {
83
83
  return Object.freeze({ definition });
@@ -44,8 +44,8 @@
44
44
  * });
45
45
  * ```
46
46
  *
47
- * @see PLUGIN_SPEC.md §13 — Host-Worker Protocol
48
- * @see PLUGIN_SPEC.md §15 — Capability Model
47
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Host-Worker Protocol
48
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Capability Model
49
49
  */
50
50
  import type { PluginCapability } from "@rudderhq/shared";
51
51
  import type { WorkerToHostMethodName, WorkerToHostMethods } from "./protocol.js";
@@ -44,8 +44,8 @@
44
44
  * });
45
45
  * ```
46
46
  *
47
- * @see PLUGIN_SPEC.md §13 — Host-Worker Protocol
48
- * @see PLUGIN_SPEC.md §15 — Capability Model
47
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Host-Worker Protocol
48
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Capability Model
49
49
  */
50
50
  import { PLUGIN_RPC_ERROR_CODES } from "./protocol.js";
51
51
  // ---------------------------------------------------------------------------
@@ -72,7 +72,7 @@ export class CapabilityDeniedError extends Error {
72
72
  * Methods without a capability requirement (e.g. `config.get`, `log`) are
73
73
  * mapped to `null`.
74
74
  *
75
- * @see PLUGIN_SPEC.md §15 — Capability Model
75
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Capability Model
76
76
  */
77
77
  const METHOD_CAPABILITY_MAP = {
78
78
  // Config — always allowed
package/dist/index.d.ts CHANGED
@@ -41,8 +41,8 @@
41
41
  * runWorker(plugin, import.meta.url);
42
42
  * ```
43
43
  *
44
- * @see PLUGIN_SPEC.md §14 — SDK Surface
45
- * @see PLUGIN_SPEC.md §29.2 — SDK Versioning
44
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — SDK Surface
45
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — SDK Versioning
46
46
  */
47
47
  export { createPluginBundlerPresets } from "./bundlers.js";
48
48
  export { definePlugin } from "./define-plugin.js";
@@ -67,7 +67,7 @@ export type { JsonSchema, PaperclipPluginManifestV1, PluginBridgeErrorCode, Plug
67
67
  *
68
68
  * Plugin authors do not need to add a separate `zod` dependency.
69
69
  *
70
- * @see PLUGIN_SPEC.md §14.1 — Example SDK Shape
70
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Example SDK Shape
71
71
  *
72
72
  * @example
73
73
  * ```ts
package/dist/index.js CHANGED
@@ -41,8 +41,8 @@
41
41
  * runWorker(plugin, import.meta.url);
42
42
  * ```
43
43
  *
44
- * @see PLUGIN_SPEC.md §14 — SDK Surface
45
- * @see PLUGIN_SPEC.md §29.2 — SDK Versioning
44
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — SDK Surface
45
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — SDK Versioning
46
46
  */
47
47
  // ---------------------------------------------------------------------------
48
48
  // Main factory
@@ -64,7 +64,7 @@ export { HOST_TO_WORKER_OPTIONAL_METHODS, HOST_TO_WORKER_REQUIRED_METHODS, JSONR
64
64
  *
65
65
  * Plugin authors do not need to add a separate `zod` dependency.
66
66
  *
67
- * @see PLUGIN_SPEC.md §14.1 — Example SDK Shape
67
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Example SDK Shape
68
68
  *
69
69
  * @example
70
70
  * ```ts
@@ -10,8 +10,8 @@
10
10
  * - Typed method maps for host→worker and worker→host calls
11
11
  * - Helper functions for creating well-formed messages
12
12
  *
13
- * @see PLUGIN_SPEC.md §12.1 — Process Model
14
- * @see PLUGIN_SPEC.md §13 — Host-Worker Protocol
13
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Process Model
14
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Host-Worker Protocol
15
15
  * @see https://www.jsonrpc.org/specification
16
16
  */
17
17
  import type { Agent, Goal, Issue, IssueComment, Organization, PaperclipPluginManifestV1, PluginLauncherBounds, PluginLauncherRenderContextSnapshot, PluginStateScopeKind, Project } from "@rudderhq/shared";
@@ -118,7 +118,7 @@ export type JsonRpcErrorCode = (typeof JSONRPC_ERROR_CODES)[keyof typeof JSONRPC
118
118
  * These live in the JSON-RPC "server error" reserved range (-32000 to -32099)
119
119
  * as specified by JSON-RPC 2.0 for implementation-defined server errors.
120
120
  *
121
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
121
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Error Propagation Through The Bridge
122
122
  */
123
123
  export declare const PLUGIN_RPC_ERROR_CODES: {
124
124
  /** The worker process is not running or not reachable. */
@@ -138,7 +138,7 @@ export type PluginRpcErrorCode = (typeof PLUGIN_RPC_ERROR_CODES)[keyof typeof PL
138
138
  /**
139
139
  * Input for the `initialize` RPC method.
140
140
  *
141
- * @see PLUGIN_SPEC.md §13.1 — `initialize`
141
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `initialize`
142
142
  */
143
143
  export interface InitializeParams {
144
144
  /** Full plugin manifest snapshot. */
@@ -167,7 +167,7 @@ export interface InitializeResult {
167
167
  /**
168
168
  * Input for the `configChanged` RPC method.
169
169
  *
170
- * @see PLUGIN_SPEC.md §13.4 — `configChanged`
170
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `configChanged`
171
171
  */
172
172
  export interface ConfigChangedParams {
173
173
  /** The newly resolved configuration. */
@@ -176,7 +176,7 @@ export interface ConfigChangedParams {
176
176
  /**
177
177
  * Input for the `validateConfig` RPC method.
178
178
  *
179
- * @see PLUGIN_SPEC.md §13.3 — `validateConfig`
179
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `validateConfig`
180
180
  */
181
181
  export interface ValidateConfigParams {
182
182
  /** The configuration to validate. */
@@ -185,7 +185,7 @@ export interface ValidateConfigParams {
185
185
  /**
186
186
  * Input for the `onEvent` RPC method.
187
187
  *
188
- * @see PLUGIN_SPEC.md §13.5 — `onEvent`
188
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `onEvent`
189
189
  */
190
190
  export interface OnEventParams {
191
191
  /** The domain event to deliver. */
@@ -194,7 +194,7 @@ export interface OnEventParams {
194
194
  /**
195
195
  * Input for the `runJob` RPC method.
196
196
  *
197
- * @see PLUGIN_SPEC.md §13.6 — `runJob`
197
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `runJob`
198
198
  */
199
199
  export interface RunJobParams {
200
200
  /** Job execution context. */
@@ -203,7 +203,7 @@ export interface RunJobParams {
203
203
  /**
204
204
  * Input for the `getData` RPC method.
205
205
  *
206
- * @see PLUGIN_SPEC.md §13.8 — `getData`
206
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `getData`
207
207
  */
208
208
  export interface GetDataParams {
209
209
  /** Plugin-defined data key (e.g. `"sync-health"`). */
@@ -216,7 +216,7 @@ export interface GetDataParams {
216
216
  /**
217
217
  * Input for the `performAction` RPC method.
218
218
  *
219
- * @see PLUGIN_SPEC.md §13.9 — `performAction`
219
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `performAction`
220
220
  */
221
221
  export interface PerformActionParams {
222
222
  /** Plugin-defined action key (e.g. `"resync"`). */
@@ -229,7 +229,7 @@ export interface PerformActionParams {
229
229
  /**
230
230
  * Input for the `executeTool` RPC method.
231
231
  *
232
- * @see PLUGIN_SPEC.md §13.10 — `executeTool`
232
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `executeTool`
233
233
  */
234
234
  export interface ExecuteToolParams {
235
235
  /** Tool name (without plugin namespace prefix). */
@@ -272,27 +272,27 @@ export interface PluginRenderCloseEvent {
272
272
  * ensure type safety across the IPC boundary.
273
273
  */
274
274
  export interface HostToWorkerMethods {
275
- /** @see PLUGIN_SPEC.md §13.1 */
275
+ /** @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md */
276
276
  initialize: [params: InitializeParams, result: InitializeResult];
277
- /** @see PLUGIN_SPEC.md §13.2 */
277
+ /** @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md */
278
278
  health: [params: Record<string, never>, result: PluginHealthDiagnostics];
279
- /** @see PLUGIN_SPEC.md §12.5 */
279
+ /** @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md */
280
280
  shutdown: [params: Record<string, never>, result: void];
281
- /** @see PLUGIN_SPEC.md §13.3 */
281
+ /** @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md */
282
282
  validateConfig: [params: ValidateConfigParams, result: PluginConfigValidationResult];
283
- /** @see PLUGIN_SPEC.md §13.4 */
283
+ /** @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md */
284
284
  configChanged: [params: ConfigChangedParams, result: void];
285
- /** @see PLUGIN_SPEC.md §13.5 */
285
+ /** @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md */
286
286
  onEvent: [params: OnEventParams, result: void];
287
- /** @see PLUGIN_SPEC.md §13.6 */
287
+ /** @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md */
288
288
  runJob: [params: RunJobParams, result: void];
289
- /** @see PLUGIN_SPEC.md §13.7 */
289
+ /** @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md */
290
290
  handleWebhook: [params: PluginWebhookInput, result: void];
291
- /** @see PLUGIN_SPEC.md §13.8 */
291
+ /** @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md */
292
292
  getData: [params: GetDataParams, result: unknown];
293
- /** @see PLUGIN_SPEC.md §13.9 */
293
+ /** @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md */
294
294
  performAction: [params: PerformActionParams, result: unknown];
295
- /** @see PLUGIN_SPEC.md §13.10 */
295
+ /** @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md */
296
296
  executeTool: [params: ExecuteToolParams, result: ToolResult];
297
297
  }
298
298
  /** Union of all host→worker method names. */
@@ -1 +1 @@
1
- {"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}
package/dist/protocol.js CHANGED
@@ -10,8 +10,8 @@
10
10
  * - Typed method maps for host→worker and worker→host calls
11
11
  * - Helper functions for creating well-formed messages
12
12
  *
13
- * @see PLUGIN_SPEC.md §12.1 — Process Model
14
- * @see PLUGIN_SPEC.md §13 — Host-Worker Protocol
13
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Process Model
14
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Host-Worker Protocol
15
15
  * @see https://www.jsonrpc.org/specification
16
16
  */
17
17
  // ---------------------------------------------------------------------------
@@ -45,7 +45,7 @@ export const JSONRPC_ERROR_CODES = {
45
45
  * These live in the JSON-RPC "server error" reserved range (-32000 to -32099)
46
46
  * as specified by JSON-RPC 2.0 for implementation-defined server errors.
47
47
  *
48
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
48
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Error Propagation Through The Bridge
49
49
  */
50
50
  export const PLUGIN_RPC_ERROR_CODES = {
51
51
  /** The worker process is not running or not reachable. */
package/dist/types.d.ts CHANGED
@@ -5,8 +5,8 @@
5
5
  * from `@rudderhq/plugin-sdk`. The host provides a concrete implementation
6
6
  * of `PluginContext` to the plugin at initialisation time.
7
7
  *
8
- * @see PLUGIN_SPEC.md §14 — SDK Surface
9
- * @see PLUGIN_SPEC.md §29.2 — SDK Versioning
8
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — SDK Surface
9
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — SDK Versioning
10
10
  */
11
11
  import type { Agent, Goal, Issue, IssueComment, Organization, PaperclipPluginManifestV1, PluginEventType, PluginLauncherDeclaration, PluginStateScopeKind, PluginToolDeclaration, Project } from "@rudderhq/shared";
12
12
  export type { Agent, Goal, Issue, IssueComment, JsonSchema, Organization, PaperclipPluginManifestV1, PluginBridgeErrorCode, PluginCapability, PluginCategory, PluginConfig, PluginEventType, PluginJobDeclaration, PluginJobRunStatus, PluginJobRunTrigger, PluginJobStatus, PluginLauncherAction, PluginLauncherActionDeclaration, PluginLauncherBounds, PluginLauncherDeclaration, PluginLauncherPlacementZone, PluginLauncherRenderDeclaration, PluginLauncherRenderEnvironment, PluginMinimumHostVersion, PluginRecord, PluginStateScopeKind, PluginStatus, PluginToolDeclaration, PluginUiDeclaration, PluginUiSlotDeclaration, PluginUiSlotEntityType, PluginUiSlotType, PluginWebhookDeclaration, PluginWebhookDeliveryStatus, Project } from "@rudderhq/shared";
@@ -19,7 +19,7 @@ export type { Agent, Goal, Issue, IssueComment, JsonSchema, Organization, Paperc
19
19
  * - `{ scopeKind: "project", scopeId: "proj-uuid" }` — per-project state
20
20
  * - `{ scopeKind: "issue", scopeId: "iss-uuid" }` — per-issue state
21
21
  *
22
- * @see PLUGIN_SPEC.md §21.3 `plugin_state`
22
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md `plugin_state`
23
23
  */
24
24
  export interface ScopeKey {
25
25
  /** What kind of Rudder object this state is scoped to. */
@@ -38,7 +38,7 @@ export interface ScopeKey {
38
38
  * All filter fields are optional. If omitted the plugin receives every event
39
39
  * of the subscribed type.
40
40
  *
41
- * @see PLUGIN_SPEC.md §16.1 — Event Filtering
41
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Event Filtering
42
42
  */
43
43
  export interface EventFilter {
44
44
  /** Only receive events for this project. */
@@ -53,7 +53,7 @@ export interface EventFilter {
53
53
  /**
54
54
  * Envelope wrapping every domain event delivered to a plugin worker.
55
55
  *
56
- * @see PLUGIN_SPEC.md §16 — Event System
56
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Event System
57
57
  */
58
58
  export interface PluginEvent<TPayload = unknown> {
59
59
  /** Unique event identifier (UUID). */
@@ -78,7 +78,7 @@ export interface PluginEvent<TPayload = unknown> {
78
78
  /**
79
79
  * Context passed to a plugin job handler when the host triggers a scheduled run.
80
80
  *
81
- * @see PLUGIN_SPEC.md §13.6 — `runJob`
81
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `runJob`
82
82
  */
83
83
  export interface PluginJobContext {
84
84
  /** Stable job key matching the declaration in the manifest. */
@@ -93,7 +93,7 @@ export interface PluginJobContext {
93
93
  /**
94
94
  * Run context passed to a plugin tool handler when an agent invokes the tool.
95
95
  *
96
- * @see PLUGIN_SPEC.md §13.10 — `executeTool`
96
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `executeTool`
97
97
  */
98
98
  export interface ToolRunContext {
99
99
  /** UUID of the agent invoking the tool. */
@@ -108,7 +108,7 @@ export interface ToolRunContext {
108
108
  /**
109
109
  * Result returned from a plugin tool handler.
110
110
  *
111
- * @see PLUGIN_SPEC.md §13.10 — `executeTool`
111
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `executeTool`
112
112
  */
113
113
  export interface ToolResult {
114
114
  /** String content returned to the agent. Required for success responses. */
@@ -121,7 +121,7 @@ export interface ToolResult {
121
121
  /**
122
122
  * Input for creating or updating a plugin-owned entity.
123
123
  *
124
- * @see PLUGIN_SPEC.md §21.3 `plugin_entities`
124
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md `plugin_entities`
125
125
  */
126
126
  export interface PluginEntityUpsert {
127
127
  /** Plugin-defined entity type (e.g. `"linear-issue"`, `"github-pr"`). */
@@ -142,7 +142,7 @@ export interface PluginEntityUpsert {
142
142
  /**
143
143
  * A plugin-owned entity record as returned by `ctx.entities.list()`.
144
144
  *
145
- * @see PLUGIN_SPEC.md §21.3 `plugin_entities`
145
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md `plugin_entities`
146
146
  */
147
147
  export interface PluginEntityRecord {
148
148
  /** UUID primary key. */
@@ -187,8 +187,8 @@ export interface PluginEntityQuery {
187
187
  * Workspace metadata provided by the host. Plugins use this to resolve local
188
188
  * filesystem paths for file browsing, git, terminal, and process operations.
189
189
  *
190
- * @see PLUGIN_SPEC.md §7 — Project Workspaces
191
- * @see PLUGIN_SPEC.md §20 — Local Tooling
190
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Project Workspaces
191
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Local Tooling
192
192
  */
193
193
  export interface PluginWorkspace {
194
194
  /** UUID primary key. */
@@ -213,8 +213,8 @@ export interface PluginWorkspace {
213
213
  * to access the current configuration at any time. The host calls
214
214
  * `configChanged` on the worker when the operator updates config at runtime.
215
215
  *
216
- * @see PLUGIN_SPEC.md §13.3 — `validateConfig`
217
- * @see PLUGIN_SPEC.md §13.4 — `configChanged`
216
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `validateConfig`
217
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `configChanged`
218
218
  */
219
219
  export interface PluginConfigClient {
220
220
  /**
@@ -230,7 +230,7 @@ export interface PluginConfigClient {
230
230
  * Requires `events.subscribe` capability for `on()`.
231
231
  * Requires `events.emit` capability for `emit()`.
232
232
  *
233
- * @see PLUGIN_SPEC.md §16 — Event System
233
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Event System
234
234
  */
235
235
  export interface PluginEventsClient {
236
236
  /**
@@ -259,7 +259,7 @@ export interface PluginEventsClient {
259
259
  * `"acme.linear"` and the event name is `"sync-done"`, the full event type
260
260
  * becomes `"plugin.acme.linear.sync-done"`.
261
261
  *
262
- * @see PLUGIN_SPEC.md §16.2 — Plugin-to-Plugin Events
262
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Plugin-to-Plugin Events
263
263
  *
264
264
  * @param name - Bare event name (e.g. `"sync-done"`)
265
265
  * @param orgId - UUID of the company this event belongs to
@@ -272,7 +272,7 @@ export interface PluginEventsClient {
272
272
  *
273
273
  * Requires `jobs.schedule` capability.
274
274
  *
275
- * @see PLUGIN_SPEC.md §17 — Scheduled Jobs
275
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Scheduled Jobs
276
276
  */
277
277
  export interface PluginJobsClient {
278
278
  /**
@@ -308,7 +308,7 @@ export interface PluginLaunchersClient {
308
308
  *
309
309
  * Requires `http.outbound` capability.
310
310
  *
311
- * @see PLUGIN_SPEC.md §15.1 — Capabilities: Runtime/Integration
311
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Capabilities: Runtime/Integration
312
312
  */
313
313
  export interface PluginHttpClient {
314
314
  /**
@@ -333,7 +333,7 @@ export interface PluginHttpClient {
333
333
  * This client resolves the reference through the Rudder secret provider
334
334
  * system and returns the resolved value at execution time.
335
335
  *
336
- * @see PLUGIN_SPEC.md §22 — Secrets
336
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Secrets
337
337
  */
338
338
  export interface PluginSecretsClient {
339
339
  /**
@@ -353,7 +353,7 @@ export interface PluginSecretsClient {
353
353
  /**
354
354
  * Input for writing a plugin activity log entry.
355
355
  *
356
- * @see PLUGIN_SPEC.md §21.4 — Activity Log Changes
356
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Activity Log Changes
357
357
  */
358
358
  export interface PluginActivityLogEntry {
359
359
  /** UUID of the company this activity belongs to. Required for auditing. */
@@ -372,7 +372,7 @@ export interface PluginActivityLogEntry {
372
372
  *
373
373
  * Requires `activity.log.write` capability.
374
374
  *
375
- * @see PLUGIN_SPEC.md §21.4 — Activity Log Changes
375
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Activity Log Changes
376
376
  */
377
377
  export interface PluginActivityClient {
378
378
  /**
@@ -436,7 +436,7 @@ export interface PluginActivityClient {
436
436
  * `plugin.state.read` capability required for `get()`.
437
437
  * `plugin.state.write` capability required for `set()` and `delete()`.
438
438
  *
439
- * @see PLUGIN_SPEC.md §21.3 `plugin_state`
439
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md `plugin_state`
440
440
  */
441
441
  export interface PluginStateClient {
442
442
  /**
@@ -472,7 +472,7 @@ export interface PluginStateClient {
472
472
  /**
473
473
  * `ctx.entities` — create and query plugin-owned entity records.
474
474
  *
475
- * @see PLUGIN_SPEC.md §21.3 `plugin_entities`
475
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md `plugin_entities`
476
476
  */
477
477
  export interface PluginEntitiesClient {
478
478
  /**
@@ -496,7 +496,7 @@ export interface PluginEntitiesClient {
496
496
  * Requires `projects.read` capability.
497
497
  * Requires `project.workspaces.read` capability for workspace operations.
498
498
  *
499
- * @see PLUGIN_SPEC.md §7 — Project Workspaces
499
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Project Workspaces
500
500
  */
501
501
  export interface PluginProjectsClient {
502
502
  /**
@@ -543,7 +543,7 @@ export interface PluginProjectsClient {
543
543
  * @returns The primary workspace for the issue's project, or `null` if
544
544
  * the issue has no project or the project has no workspace
545
545
  *
546
- * @see PLUGIN_SPEC.md §20 — Local Tooling
546
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Local Tooling
547
547
  */
548
548
  getWorkspaceForIssue(issueId: string, orgId: string): Promise<PluginWorkspace | null>;
549
549
  }
@@ -554,7 +554,7 @@ export interface PluginProjectsClient {
554
554
  * The plugin's UI calls `usePluginData(key, params)` which routes through the
555
555
  * host bridge to the worker's registered handler.
556
556
  *
557
- * @see PLUGIN_SPEC.md §13.8 — `getData`
557
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `getData`
558
558
  */
559
559
  export interface PluginDataClient {
560
560
  /**
@@ -569,7 +569,7 @@ export interface PluginDataClient {
569
569
  * `ctx.actions` — register `performAction` handlers that back
570
570
  * `usePluginAction()` in the plugin's frontend components.
571
571
  *
572
- * @see PLUGIN_SPEC.md §13.9 — `performAction`
572
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `performAction`
573
573
  */
574
574
  export interface PluginActionsClient {
575
575
  /**
@@ -587,7 +587,7 @@ export interface PluginActionsClient {
587
587
  *
588
588
  * Tool names are automatically namespaced by plugin ID at runtime.
589
589
  *
590
- * @see PLUGIN_SPEC.md §11 — Agent Tools
590
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Agent Tools
591
591
  */
592
592
  export interface PluginToolsClient {
593
593
  /**
@@ -605,7 +605,7 @@ export interface PluginToolsClient {
605
605
  * Log output is captured by the host, stored, and surfaced in the plugin
606
606
  * health dashboard.
607
607
  *
608
- * @see PLUGIN_SPEC.md §26.1 — Logging
608
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Logging
609
609
  */
610
610
  export interface PluginLogger {
611
611
  /** Log an informational message. */
@@ -622,7 +622,7 @@ export interface PluginLogger {
622
622
  *
623
623
  * Requires `metrics.write` capability.
624
624
  *
625
- * @see PLUGIN_SPEC.md §15.1 — Capabilities: Data Write
625
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Capabilities: Data Write
626
626
  */
627
627
  export interface PluginMetricsClient {
628
628
  /**
@@ -871,7 +871,7 @@ export interface PluginStreamsClient {
871
871
  * });
872
872
  * ```
873
873
  *
874
- * @see PLUGIN_SPEC.md §14 — SDK Surface
874
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — SDK Surface
875
875
  */
876
876
  export interface PluginContext {
877
877
  /** The plugin's manifest as validated at install time. */
package/dist/types.js CHANGED
@@ -5,8 +5,8 @@
5
5
  * from `@rudderhq/plugin-sdk`. The host provides a concrete implementation
6
6
  * of `PluginContext` to the plugin at initialisation time.
7
7
  *
8
- * @see PLUGIN_SPEC.md §14 — SDK Surface
9
- * @see PLUGIN_SPEC.md §29.2 — SDK Versioning
8
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — SDK Surface
9
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — SDK Versioning
10
10
  */
11
11
  export {};
12
12
  //# sourceMappingURL=types.js.map
@@ -13,7 +13,7 @@
13
13
  * only the type declarations; the runtime implementations are injected via the
14
14
  * host module registry.
15
15
  *
16
- * @see PLUGIN_SPEC.md §19.6 — Shared Components In `@rudderhq/plugin-sdk/ui`
16
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components In `@rudderhq/plugin-sdk/ui`
17
17
  */
18
18
  import type React from "react";
19
19
  /**
@@ -196,62 +196,62 @@ export declare const MetricCard: React.ComponentType<MetricCardProps>;
196
196
  /**
197
197
  * Displays an inline status badge (ok / warning / error / info / pending).
198
198
  *
199
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
199
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
200
200
  */
201
201
  export declare const StatusBadge: React.ComponentType<StatusBadgeProps>;
202
202
  /**
203
203
  * Sortable, paginated data table.
204
204
  *
205
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
205
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
206
206
  */
207
207
  export declare const DataTable: React.ComponentType<DataTableProps<Record<string, unknown>>>;
208
208
  /**
209
209
  * Line or bar chart for time-series data.
210
210
  *
211
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
211
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
212
212
  */
213
213
  export declare const TimeseriesChart: React.ComponentType<TimeseriesChartProps>;
214
214
  /**
215
215
  * Renders Markdown text as HTML.
216
216
  *
217
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
217
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
218
218
  */
219
219
  export declare const MarkdownBlock: React.ComponentType<MarkdownBlockProps>;
220
220
  /**
221
221
  * Renders a definition-list of label/value pairs.
222
222
  *
223
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
223
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
224
224
  */
225
225
  export declare const KeyValueList: React.ComponentType<KeyValueListProps>;
226
226
  /**
227
227
  * Row of action buttons wired to the plugin bridge's `performAction` handlers.
228
228
  *
229
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
229
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
230
230
  */
231
231
  export declare const ActionBar: React.ComponentType<ActionBarProps>;
232
232
  /**
233
233
  * Scrollable, timestamped log output viewer.
234
234
  *
235
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
235
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
236
236
  */
237
237
  export declare const LogView: React.ComponentType<LogViewProps>;
238
238
  /**
239
239
  * Collapsible JSON tree for debugging or raw data inspection.
240
240
  *
241
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
241
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
242
242
  */
243
243
  export declare const JsonTree: React.ComponentType<JsonTreeProps>;
244
244
  /**
245
245
  * Loading indicator.
246
246
  *
247
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
247
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
248
248
  */
249
249
  export declare const Spinner: React.ComponentType<SpinnerProps>;
250
250
  /**
251
251
  * React error boundary that prevents plugin rendering errors from crashing
252
252
  * the host page.
253
253
  *
254
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
254
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Error Propagation Through The Bridge
255
255
  */
256
256
  export declare const ErrorBoundary: React.ComponentType<ErrorBoundaryProps>;
257
257
  //# sourceMappingURL=components.d.ts.map
@@ -13,7 +13,7 @@
13
13
  * only the type declarations; the runtime implementations are injected via the
14
14
  * host module registry.
15
15
  *
16
- * @see PLUGIN_SPEC.md §19.6 — Shared Components In `@rudderhq/plugin-sdk/ui`
16
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components In `@rudderhq/plugin-sdk/ui`
17
17
  */
18
18
  import { renderSdkUiComponent } from "./runtime.js";
19
19
  // ---------------------------------------------------------------------------
@@ -25,7 +25,7 @@ import { renderSdkUiComponent } from "./runtime.js";
25
25
  /**
26
26
  * Displays a single metric with an optional trend indicator and sparkline.
27
27
  *
28
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
28
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
29
29
  */
30
30
  function createSdkUiComponent(name) {
31
31
  return function PaperclipSdkUiComponent(props) {
@@ -36,62 +36,62 @@ export const MetricCard = createSdkUiComponent("MetricCard");
36
36
  /**
37
37
  * Displays an inline status badge (ok / warning / error / info / pending).
38
38
  *
39
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
39
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
40
40
  */
41
41
  export const StatusBadge = createSdkUiComponent("StatusBadge");
42
42
  /**
43
43
  * Sortable, paginated data table.
44
44
  *
45
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
45
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
46
46
  */
47
47
  export const DataTable = createSdkUiComponent("DataTable");
48
48
  /**
49
49
  * Line or bar chart for time-series data.
50
50
  *
51
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
51
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
52
52
  */
53
53
  export const TimeseriesChart = createSdkUiComponent("TimeseriesChart");
54
54
  /**
55
55
  * Renders Markdown text as HTML.
56
56
  *
57
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
57
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
58
58
  */
59
59
  export const MarkdownBlock = createSdkUiComponent("MarkdownBlock");
60
60
  /**
61
61
  * Renders a definition-list of label/value pairs.
62
62
  *
63
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
63
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
64
64
  */
65
65
  export const KeyValueList = createSdkUiComponent("KeyValueList");
66
66
  /**
67
67
  * Row of action buttons wired to the plugin bridge's `performAction` handlers.
68
68
  *
69
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
69
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
70
70
  */
71
71
  export const ActionBar = createSdkUiComponent("ActionBar");
72
72
  /**
73
73
  * Scrollable, timestamped log output viewer.
74
74
  *
75
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
75
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
76
76
  */
77
77
  export const LogView = createSdkUiComponent("LogView");
78
78
  /**
79
79
  * Collapsible JSON tree for debugging or raw data inspection.
80
80
  *
81
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
81
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
82
82
  */
83
83
  export const JsonTree = createSdkUiComponent("JsonTree");
84
84
  /**
85
85
  * Loading indicator.
86
86
  *
87
- * @see PLUGIN_SPEC.md §19.6 — Shared Components
87
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Shared Components
88
88
  */
89
89
  export const Spinner = createSdkUiComponent("Spinner");
90
90
  /**
91
91
  * React error boundary that prevents plugin rendering errors from crashing
92
92
  * the host page.
93
93
  *
94
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
94
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Error Propagation Through The Bridge
95
95
  */
96
96
  export const ErrorBoundary = createSdkUiComponent("ErrorBoundary");
97
97
  //# sourceMappingURL=components.js.map
@@ -23,8 +23,8 @@ import type { PluginActionFn, PluginDataResult, PluginHostContext, PluginStreamR
23
23
  * }
24
24
  * ```
25
25
  *
26
- * @see PLUGIN_SPEC.md §13.8 — `getData`
27
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
26
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `getData`
27
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Error Propagation Through The Bridge
28
28
  */
29
29
  export declare function usePluginData<T = unknown>(key: string, params?: Record<string, unknown>): PluginDataResult<T>;
30
30
  /**
@@ -54,8 +54,8 @@ export declare function usePluginData<T = unknown>(key: string, params?: Record<
54
54
  * }
55
55
  * ```
56
56
  *
57
- * @see PLUGIN_SPEC.md §13.9 — `performAction`
58
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
57
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `performAction`
58
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Error Propagation Through The Bridge
59
59
  */
60
60
  export declare function usePluginAction(key: string): PluginActionFn;
61
61
  /**
@@ -75,7 +75,7 @@ export declare function usePluginAction(key: string): PluginActionFn;
75
75
  * }
76
76
  * ```
77
77
  *
78
- * @see PLUGIN_SPEC.md §19 — UI Extension Model
78
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — UI Extension Model
79
79
  */
80
80
  export declare function useHostContext(): PluginHostContext;
81
81
  /**
@@ -105,7 +105,7 @@ export declare function useHostContext(): PluginHostContext;
105
105
  * }
106
106
  * ```
107
107
  *
108
- * @see PLUGIN_SPEC.md §19.8 — Real-Time Streaming
108
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Real-Time Streaming
109
109
  */
110
110
  export declare function usePluginStream<T = unknown>(channel: string, options?: {
111
111
  orgId?: string;
package/dist/ui/hooks.js CHANGED
@@ -26,8 +26,8 @@ import { getSdkUiRuntimeValue } from "./runtime.js";
26
26
  * }
27
27
  * ```
28
28
  *
29
- * @see PLUGIN_SPEC.md §13.8 — `getData`
30
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
29
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `getData`
30
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Error Propagation Through The Bridge
31
31
  */
32
32
  export function usePluginData(key, params) {
33
33
  const impl = getSdkUiRuntimeValue("usePluginData");
@@ -63,8 +63,8 @@ export function usePluginData(key, params) {
63
63
  * }
64
64
  * ```
65
65
  *
66
- * @see PLUGIN_SPEC.md §13.9 — `performAction`
67
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
66
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — `performAction`
67
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Error Propagation Through The Bridge
68
68
  */
69
69
  export function usePluginAction(key) {
70
70
  const impl = getSdkUiRuntimeValue("usePluginAction");
@@ -90,7 +90,7 @@ export function usePluginAction(key) {
90
90
  * }
91
91
  * ```
92
92
  *
93
- * @see PLUGIN_SPEC.md §19 — UI Extension Model
93
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — UI Extension Model
94
94
  */
95
95
  export function useHostContext() {
96
96
  const impl = getSdkUiRuntimeValue("useHostContext");
@@ -126,7 +126,7 @@ export function useHostContext() {
126
126
  * }
127
127
  * ```
128
128
  *
129
- * @see PLUGIN_SPEC.md §19.8 — Real-Time Streaming
129
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Real-Time Streaming
130
130
  */
131
131
  export function usePluginStream(channel, options) {
132
132
  const impl = getSdkUiRuntimeValue("usePluginStream");
@@ -6,8 +6,8 @@
6
6
  *
7
7
  * The worker-side SDK is available from `@rudderhq/plugin-sdk` (root).
8
8
  *
9
- * @see PLUGIN_SPEC.md §19.0.1 — Plugin UI SDK
10
- * @see PLUGIN_SPEC.md §29.2 — SDK Versioning
9
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Plugin UI SDK
10
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — SDK Versioning
11
11
  *
12
12
  * @example
13
13
  * ```tsx
package/dist/ui/index.js CHANGED
@@ -6,8 +6,8 @@
6
6
  *
7
7
  * The worker-side SDK is available from `@rudderhq/plugin-sdk` (root).
8
8
  *
9
- * @see PLUGIN_SPEC.md §19.0.1 — Plugin UI SDK
10
- * @see PLUGIN_SPEC.md §29.2 — SDK Versioning
9
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Plugin UI SDK
10
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — SDK Versioning
11
11
  *
12
12
  * @example
13
13
  * ```tsx
@@ -9,9 +9,9 @@
9
9
  * All communication with the plugin worker goes through the host bridge — plugin
10
10
  * components must NOT access host internals or call host APIs directly.
11
11
  *
12
- * @see PLUGIN_SPEC.md §19 — UI Extension Model
13
- * @see PLUGIN_SPEC.md §19.0.1 — Plugin UI SDK
14
- * @see PLUGIN_SPEC.md §29.2 — SDK Versioning
12
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — UI Extension Model
13
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Plugin UI SDK
14
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — SDK Versioning
15
15
  */
16
16
  import type { PluginBridgeErrorCode } from "@rudderhq/shared";
17
17
  import type { PluginLauncherRenderContextSnapshot, PluginModalBoundsRequest, PluginRenderCloseEvent } from "../protocol.js";
@@ -30,7 +30,7 @@ export type { PluginLauncherRenderContextSnapshot, PluginModalBoundsRequest, Plu
30
30
  * - `TIMEOUT` — worker did not respond within the configured timeout
31
31
  * - `UNKNOWN` — unexpected bridge-level failure
32
32
  *
33
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
33
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Error Propagation Through The Bridge
34
34
  */
35
35
  export interface PluginBridgeError {
36
36
  /** Machine-readable error code. */
@@ -49,7 +49,7 @@ export interface PluginBridgeError {
49
49
  * Plugin components use this to know which company, project, or entity is
50
50
  * currently active so they can scope their data requests accordingly.
51
51
  *
52
- * @see PLUGIN_SPEC.md §19 — UI Extension Model
52
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — UI Extension Model
53
53
  */
54
54
  export interface PluginHostContext {
55
55
  /** UUID of the currently active company, if any. */
@@ -100,8 +100,8 @@ export interface PluginRenderEnvironmentContext extends PluginLauncherRenderCont
100
100
  *
101
101
  * A page is a full-page extension at `/plugins/:pluginId` or `/:company/plugins/:pluginId`.
102
102
  *
103
- * @see PLUGIN_SPEC.md §19.1 — Global Operator Routes
104
- * @see PLUGIN_SPEC.md §19.2 — Organization-Context Routes
103
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Global Operator Routes
104
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Organization-Context Routes
105
105
  */
106
106
  export interface PluginPageProps {
107
107
  /** The current host context. */
@@ -112,7 +112,7 @@ export interface PluginPageProps {
112
112
  *
113
113
  * A dashboard widget is rendered as a card or section on the main dashboard.
114
114
  *
115
- * @see PLUGIN_SPEC.md §19.4 — Dashboard Widgets
115
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Dashboard Widgets
116
116
  */
117
117
  export interface PluginWidgetProps {
118
118
  /** The current host context. */
@@ -124,7 +124,7 @@ export interface PluginWidgetProps {
124
124
  * A detail tab is rendered as an additional tab on a project, issue, agent,
125
125
  * goal, or run detail page.
126
126
  *
127
- * @see PLUGIN_SPEC.md §19.3 — Detail Tabs
127
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Detail Tabs
128
128
  */
129
129
  export interface PluginDetailTabProps {
130
130
  /** The current host context, always including `entityId` and `entityType`. */
@@ -138,7 +138,7 @@ export interface PluginDetailTabProps {
138
138
  *
139
139
  * A sidebar entry adds a link or section to the application sidebar.
140
140
  *
141
- * @see PLUGIN_SPEC.md §19.5 — Sidebar Entries
141
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Sidebar Entries
142
142
  */
143
143
  export interface PluginSidebarProps {
144
144
  /** The current host context. */
@@ -154,7 +154,7 @@ export interface PluginSidebarProps {
154
154
  * Use this slot to add a link (e.g. "Files", "Linear Sync") that navigates to
155
155
  * the project detail with a plugin tab selected: `/projects/:projectRef?tab=plugin:key:slotId`.
156
156
  *
157
- * @see PLUGIN_SPEC.md §19.5.1 — Project sidebar items
157
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Project sidebar items
158
158
  */
159
159
  export interface PluginProjectSidebarItemProps {
160
160
  /** Host context plus entityId (project id) and entityType "project". */
@@ -174,7 +174,7 @@ export interface PluginProjectSidebarItemProps {
174
174
  * Use this slot to augment comments with parsed file links, sentiment
175
175
  * badges, inline actions, or any per-comment metadata.
176
176
  *
177
- * @see PLUGIN_SPEC.md §19.6 — Comment Annotations
177
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Comment Annotations
178
178
  */
179
179
  export interface PluginCommentAnnotationProps {
180
180
  /** Host context with comment and parent issue identifiers. */
@@ -198,7 +198,7 @@ export interface PluginCommentAnnotationProps {
198
198
  * Use this slot to add per-comment actions such as "Create sub-issue from
199
199
  * comment", "Translate", "Flag for review", or any custom plugin action.
200
200
  *
201
- * @see PLUGIN_SPEC.md §19.7 — Comment Context Menu Items
201
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Comment Context Menu Items
202
202
  */
203
203
  export interface PluginCommentContextMenuItemProps {
204
204
  /** Host context with comment and parent issue identifiers. */
@@ -218,7 +218,7 @@ export interface PluginCommentContextMenuItemProps {
218
218
  * a `settingsPage` UI slot. The component is responsible for reading and
219
219
  * writing config through the bridge.
220
220
  *
221
- * @see PLUGIN_SPEC.md §19.8 — Plugin Settings UI
221
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Plugin Settings UI
222
222
  */
223
223
  export interface PluginSettingsPageProps {
224
224
  /** The current host context. */
@@ -232,7 +232,7 @@ export interface PluginSettingsPageProps {
232
232
  *
233
233
  * @template T The type of the data returned by the worker handler
234
234
  *
235
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
235
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Error Propagation Through The Bridge
236
236
  */
237
237
  export interface PluginDataResult<T = unknown> {
238
238
  /** The data returned by the worker's `getData` handler. `null` while loading or on error. */
@@ -271,7 +271,7 @@ export type PluginToastFn = (input: PluginToastInput) => string | null;
271
271
  *
272
272
  * @template T The type of each event emitted by the worker
273
273
  *
274
- * @see PLUGIN_SPEC.md §19.8 — Real-Time Streaming
274
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Real-Time Streaming
275
275
  */
276
276
  export interface PluginStreamResult<T = unknown> {
277
277
  /** All events received so far, in arrival order. */
@@ -295,7 +295,7 @@ export interface PluginStreamResult<T = unknown> {
295
295
  *
296
296
  * On failure, the async function throws a `PluginBridgeError`.
297
297
  *
298
- * @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
298
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Error Propagation Through The Bridge
299
299
  *
300
300
  * @example
301
301
  * ```tsx
package/dist/ui/types.js CHANGED
@@ -9,9 +9,9 @@
9
9
  * All communication with the plugin worker goes through the host bridge — plugin
10
10
  * components must NOT access host internals or call host APIs directly.
11
11
  *
12
- * @see PLUGIN_SPEC.md §19 — UI Extension Model
13
- * @see PLUGIN_SPEC.md §19.0.1 — Plugin UI SDK
14
- * @see PLUGIN_SPEC.md §29.2 — SDK Versioning
12
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — UI Extension Model
13
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Plugin UI SDK
14
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — SDK Versioning
15
15
  */
16
16
  export {};
17
17
  //# sourceMappingURL=types.js.map
@@ -29,9 +29,9 @@
29
29
  * | (process exits)
30
30
  * ```
31
31
  *
32
- * @see PLUGIN_SPEC.md §12 — Process Model
33
- * @see PLUGIN_SPEC.md §13 — Host-Worker Protocol
34
- * @see PLUGIN_SPEC.md §14 — SDK Surface
32
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Process Model
33
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Host-Worker Protocol
34
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — SDK Surface
35
35
  */
36
36
  import type { PaperclipPlugin } from "./define-plugin.js";
37
37
  /**
@@ -29,9 +29,9 @@
29
29
  * | (process exits)
30
30
  * ```
31
31
  *
32
- * @see PLUGIN_SPEC.md §12 — Process Model
33
- * @see PLUGIN_SPEC.md §13 — Host-Worker Protocol
34
- * @see PLUGIN_SPEC.md §14 — SDK Surface
32
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Process Model
33
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — Host-Worker Protocol
34
+ * @see doc/engineering/PLUGIN_RUNTIME_CONTRACT.md — SDK Surface
35
35
  */
36
36
  import path from "node:path";
37
37
  import { createInterface } from "node:readline";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rudderhq/plugin-sdk",
3
- "version": "0.3.6-canary.9",
3
+ "version": "0.4.1",
4
4
  "description": "Stable public API for Rudder plugins — worker-side context and UI bridge hooks",
5
5
  "license": "SEE LICENSE IN LICENSE",
6
6
  "homepage": "https://github.com/Undertone0809/rudder",
@@ -116,7 +116,7 @@
116
116
  "dev:server": "tsx src/dev-cli.ts"
117
117
  },
118
118
  "dependencies": {
119
- "@rudderhq/shared": "0.3.6-canary.9",
119
+ "@rudderhq/shared": "0.4.1",
120
120
  "zod": "^3.25.76"
121
121
  },
122
122
  "devDependencies": {