@tooldeck/sdk-node 1.1.0

package/dist/commands.d.ts

@@ -0,0 +1,10 @@
+import type { CommandResult } from "@tooldeck/protocol";
+import type { JsonObject, MaybePromise } from "@tooldeck/shared";
+import type { Disposable } from "./disposable";
+export type CommandInput = JsonObject;
+export type CommandInputMap = object;
+export type CommandHandler<TInput = CommandInput> = (input: TInput) => MaybePromise<CommandResult>;
+export interface CommandRegistry<TCommandInputs extends CommandInputMap = Record<string, CommandInput>> {
+    register<TCommandId extends keyof TCommandInputs & string>(commandId: TCommandId, handler: CommandHandler<TCommandInputs[TCommandId]>): Disposable;
+}
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC;AACtC,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAErC,MAAM,MAAM,cAAc,CAAC,MAAM,GAAG,YAAY,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,YAAY,CAAC,aAAa,CAAC,CAAC;AAEnG,MAAM,WAAW,eAAe,CAC9B,cAAc,SAAS,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAErE,QAAQ,CAAC,UAAU,SAAS,MAAM,cAAc,GAAG,MAAM,EACvD,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,cAAc,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,GAClD,UAAU,CAAC;CACf"}

package/dist/context.d.ts

@@ -0,0 +1,15 @@
+import type { CommandInput, CommandInputMap, CommandRegistry } from "./commands";
+import type { Disposable } from "./disposable";
+export interface PluginStorage {
+    get(key: string): Promise<unknown>;
+    set(key: string, value: unknown): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+export interface PluginContextV1<TCommandInputs extends CommandInputMap = Record<string, CommandInput>> {
+    pluginId: string;
+    subscriptions: Disposable[];
+    commands: CommandRegistry<TCommandInputs>;
+    storage: PluginStorage;
+}
+export type PluginContext<TCommandInputs extends CommandInputMap = Record<string, CommandInput>> = PluginContextV1<TCommandInputs>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe,CAC9B,cAAc,SAAS,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAErE,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,UAAU,EAAE,CAAC;IAC5B,QAAQ,EAAE,eAAe,CAAC,cAAc,CAAC,CAAC;IAC1C,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,CAAC,cAAc,SAAS,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,IAC7F,eAAe,CAAC,cAAc,CAAC,CAAC"}

package/dist/disposable.d.ts

@@ -0,0 +1,6 @@
+import type { MaybePromise } from "@tooldeck/shared";
+export interface Disposable {
+    dispose(): MaybePromise<void>;
+}
+export declare function toDisposable(dispose: () => MaybePromise<void>): Disposable;
+//# sourceMappingURL=disposable.d.ts.map

package/dist/disposable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposable.d.ts","sourceRoot":"","sources":["../src/disposable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,GAAG,UAAU,CAE1E"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./commands";
+export * from "./context";
+export * from "./disposable";
+export * from "./plugin";
+export * from "./results";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,125 @@
+//#region src/disposable.ts
+function toDisposable(dispose) {
+	return { dispose };
+}
+//#endregion
+//#region src/plugin.ts
+function definePlugin(input) {
+	if (typeof input === "function") return defineBuilderPlugin(input);
+	if ("activate" in input && typeof input.activate === "function") return input;
+	return defineObjectPlugin(input);
+}
+function defineBuilderPlugin(setup) {
+	let definition;
+	return {
+		async activate(ctx) {
+			definition = createNormalizedPluginDefinition();
+			await setup(createPluginBuilder(definition));
+			await activateDefinition(ctx, definition);
+		},
+		async deactivate(ctx) {
+			if (!definition) return;
+			await deactivateDefinition(ctx, definition);
+		}
+	};
+}
+function defineObjectPlugin(definition) {
+	const normalizedDefinition = createNormalizedPluginDefinition(definition);
+	return {
+		async activate(ctx) {
+			await activateDefinition(ctx, normalizedDefinition);
+		},
+		async deactivate(ctx) {
+			await deactivateDefinition(ctx, normalizedDefinition);
+		}
+	};
+}
+function createPluginBuilder(definition) {
+	return {
+		command(commandId, handler) {
+			definition.commands.push({
+				commandId,
+				handler
+			});
+		},
+		onActivate(handler) {
+			definition.onActivate.push(handler);
+		},
+		onDeactivate(handler) {
+			definition.onDeactivate.push(handler);
+		}
+	};
+}
+function createNormalizedPluginDefinition(definition) {
+	return {
+		commands: definition?.commands ? normalizeCommands(definition.commands) : [],
+		onActivate: definition?.onActivate ? [definition.onActivate] : [],
+		onDeactivate: definition?.onDeactivate ? [definition.onDeactivate] : []
+	};
+}
+function normalizeCommands(commands) {
+	return Object.entries(commands).map(([commandId, handler]) => ({
+		commandId,
+		handler
+	}));
+}
+async function activateDefinition(ctx, definition) {
+	for (const onActivate of definition.onActivate) await onActivate(ctx);
+	for (const command of definition.commands) ctx.subscriptions.push(ctx.commands.register(command.commandId, command.handler));
+}
+async function deactivateDefinition(ctx, definition) {
+	for (const onDeactivate of definition.onDeactivate.toReversed()) await onDeactivate(ctx);
+}
+//#endregion
+//#region src/results.ts
+function textBlock(text) {
+	return {
+		type: "text",
+		text
+	};
+}
+function codeBlock(text, language) {
+	return {
+		type: "code",
+		text,
+		...language === void 0 ? {} : { language }
+	};
+}
+function jsonBlock(value) {
+	return {
+		type: "json",
+		value
+	};
+}
+function propertiesBlock(items) {
+	return {
+		type: "properties",
+		items
+	};
+}
+function ok(blocks) {
+	return {
+		status: "success",
+		blocks
+	};
+}
+function okText(text) {
+	return ok([textBlock(text)]);
+}
+function fail(code, message, blocks = []) {
+	return {
+		status: "error",
+		blocks,
+		error: {
+			code,
+			message
+		}
+	};
+}
+function failText(code, message, text) {
+	return fail(code, message, text === void 0 ? [] : [textBlock(text)]);
+}
+//#endregion
+export { codeBlock, definePlugin, fail, failText, jsonBlock, ok, okText, propertiesBlock, textBlock, toDisposable };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/disposable.ts","../src/plugin.ts","../src/results.ts"],"sourcesContent":["import type { MaybePromise } from \"@tooldeck/shared\";\n\nexport interface Disposable {\n  dispose(): MaybePromise<void>;\n}\n\nexport function toDisposable(dispose: () => MaybePromise<void>): Disposable {\n  return { dispose };\n}\n","import type { MaybePromise } from \"@tooldeck/shared\";\n\nimport type { CommandHandler, CommandInput, CommandInputMap } from \"./commands\";\nimport type { PluginContextV1 } from \"./context\";\nimport type { Disposable } from \"./disposable\";\n\nexport interface ToolboxPluginV1<\n  TCommandInputs extends CommandInputMap = Record<string, CommandInput>,\n> {\n  activate(ctx: PluginContextV1<TCommandInputs>): MaybePromise<void>;\n  deactivate?(ctx: PluginContextV1<TCommandInputs>): MaybePromise<void>;\n}\n\nexport type ToolboxPlugin<TCommandInputs extends CommandInputMap = Record<string, CommandInput>> =\n  ToolboxPluginV1<TCommandInputs>;\n\nexport type PluginLifecycleHandler<\n  TCommandInputs extends CommandInputMap = Record<string, CommandInput>,\n> = (ctx: PluginContextV1<TCommandInputs>) => MaybePromise<void>;\n\nexport type PluginCommandHandlers<\n  TCommandInputs extends CommandInputMap = Record<string, CommandInput>,\n> = Partial<{\n  [TCommandId in keyof TCommandInputs & string]: CommandHandler<TCommandInputs[TCommandId]>;\n}>;\n\nexport interface PluginDefinition<\n  TCommandInputs extends CommandInputMap = Record<string, CommandInput>,\n> {\n  commands?: PluginCommandHandlers<TCommandInputs>;\n  onActivate?: PluginLifecycleHandler<TCommandInputs>;\n  onDeactivate?: PluginLifecycleHandler<TCommandInputs>;\n}\n\nexport interface PluginBuilder<\n  TCommandInputs extends CommandInputMap = Record<string, CommandInput>,\n> {\n  command<TCommandId extends keyof TCommandInputs & string>(\n    commandId: TCommandId,\n    handler: CommandHandler<TCommandInputs[TCommandId]>,\n  ): void;\n  onActivate(handler: PluginLifecycleHandler<TCommandInputs>): void;\n  onDeactivate(handler: PluginLifecycleHandler<TCommandInputs>): void;\n}\n\nexport type PluginSetup<TCommandInputs extends CommandInputMap = Record<string, CommandInput>> = (\n  plugin: PluginBuilder<TCommandInputs>,\n) => MaybePromise<void>;\n\ntype RegisteredCommand = {\n  commandId: string;\n  handler: CommandHandler<CommandInput>;\n};\n\ntype RuntimeCommandRegistry = {\n  register(commandId: string, handler: CommandHandler<CommandInput>): Disposable;\n};\n\ntype NormalizedPluginDefinition<\n  TCommandInputs extends CommandInputMap = Record<string, CommandInput>,\n> = {\n  commands: RegisteredCommand[];\n  onActivate: PluginLifecycleHandler<TCommandInputs>[];\n  onDeactivate: PluginLifecycleHandler<TCommandInputs>[];\n};\n\nexport function definePlugin<TCommandInputs extends CommandInputMap = Record<string, CommandInput>>(\n  setup: PluginSetup<TCommandInputs>,\n): ToolboxPluginV1<TCommandInputs>;\nexport function definePlugin<TCommandInputs extends CommandInputMap = Record<string, CommandInput>>(\n  definition: PluginDefinition<TCommandInputs>,\n): ToolboxPluginV1<TCommandInputs>;\nexport function definePlugin<TCommandInputs extends CommandInputMap = Record<string, CommandInput>>(\n  plugin: ToolboxPluginV1<TCommandInputs>,\n): ToolboxPluginV1<TCommandInputs>;\nexport function definePlugin<TCommandInputs extends CommandInputMap = Record<string, CommandInput>>(\n  input:\n    | PluginSetup<TCommandInputs>\n    | PluginDefinition<TCommandInputs>\n    | ToolboxPluginV1<TCommandInputs>,\n): ToolboxPluginV1<TCommandInputs> {\n  if (typeof input === \"function\") {\n    return defineBuilderPlugin(input);\n  }\n\n  if (\"activate\" in input && typeof input.activate === \"function\") {\n    return input;\n  }\n\n  return defineObjectPlugin(input as PluginDefinition<TCommandInputs>);\n}\n\nfunction defineBuilderPlugin<TCommandInputs extends CommandInputMap = Record<string, CommandInput>>(\n  setup: PluginSetup<TCommandInputs>,\n): ToolboxPluginV1<TCommandInputs> {\n  let definition: NormalizedPluginDefinition<TCommandInputs> | undefined;\n\n  return {\n    async activate(ctx) {\n      definition = createNormalizedPluginDefinition<TCommandInputs>();\n      await setup(createPluginBuilder(definition));\n      await activateDefinition(ctx, definition);\n    },\n    async deactivate(ctx) {\n      if (!definition) {\n        return;\n      }\n\n      await deactivateDefinition(ctx, definition);\n    },\n  };\n}\n\nfunction defineObjectPlugin<TCommandInputs extends CommandInputMap = Record<string, CommandInput>>(\n  definition: PluginDefinition<TCommandInputs>,\n): ToolboxPluginV1<TCommandInputs> {\n  const normalizedDefinition = createNormalizedPluginDefinition(definition);\n\n  return {\n    async activate(ctx) {\n      await activateDefinition(ctx, normalizedDefinition);\n    },\n    async deactivate(ctx) {\n      await deactivateDefinition(ctx, normalizedDefinition);\n    },\n  };\n}\n\nfunction createPluginBuilder<TCommandInputs extends CommandInputMap = Record<string, CommandInput>>(\n  definition: NormalizedPluginDefinition<TCommandInputs>,\n): PluginBuilder<TCommandInputs> {\n  return {\n    command(commandId, handler) {\n      definition.commands.push({\n        commandId,\n        handler: handler as CommandHandler<CommandInput>,\n      });\n    },\n    onActivate(handler) {\n      definition.onActivate.push(handler);\n    },\n    onDeactivate(handler) {\n      definition.onDeactivate.push(handler);\n    },\n  };\n}\n\nfunction createNormalizedPluginDefinition<\n  TCommandInputs extends CommandInputMap = Record<string, CommandInput>,\n>(definition?: PluginDefinition<TCommandInputs>): NormalizedPluginDefinition<TCommandInputs> {\n  return {\n    commands: definition?.commands ? normalizeCommands(definition.commands) : [],\n    onActivate: definition?.onActivate ? [definition.onActivate] : [],\n    onDeactivate: definition?.onDeactivate ? [definition.onDeactivate] : [],\n  };\n}\n\nfunction normalizeCommands<TCommandInputs extends CommandInputMap = Record<string, CommandInput>>(\n  commands: PluginCommandHandlers<TCommandInputs>,\n): RegisteredCommand[] {\n  return Object.entries(commands).map(([commandId, handler]) => ({\n    commandId,\n    handler: handler as CommandHandler<CommandInput>,\n  }));\n}\n\nasync function activateDefinition<\n  TCommandInputs extends CommandInputMap = Record<string, CommandInput>,\n>(\n  ctx: PluginContextV1<TCommandInputs>,\n  definition: NormalizedPluginDefinition<TCommandInputs>,\n): Promise<void> {\n  for (const onActivate of definition.onActivate) {\n    await onActivate(ctx);\n  }\n\n  for (const command of definition.commands) {\n    ctx.subscriptions.push(\n      (ctx.commands as RuntimeCommandRegistry).register(command.commandId, command.handler),\n    );\n  }\n}\n\nasync function deactivateDefinition<\n  TCommandInputs extends CommandInputMap = Record<string, CommandInput>,\n>(\n  ctx: PluginContextV1<TCommandInputs>,\n  definition: NormalizedPluginDefinition<TCommandInputs>,\n): Promise<void> {\n  for (const onDeactivate of definition.onDeactivate.toReversed()) {\n    await onDeactivate(ctx);\n  }\n}\n","import type {\n  CodeContentBlock,\n  CommandResult,\n  ContentBlock,\n  JsonContentBlock,\n  PropertiesContentBlock,\n  PropertyItem,\n  TextContentBlock,\n} from \"@tooldeck/protocol\";\nimport type { JsonValue } from \"@tooldeck/shared\";\n\nexport function textBlock(text: string): TextContentBlock {\n  return {\n    type: \"text\",\n    text,\n  };\n}\n\nexport function codeBlock(text: string, language?: string): CodeContentBlock {\n  return {\n    type: \"code\",\n    text,\n    ...(language === undefined ? {} : { language }),\n  };\n}\n\nexport function jsonBlock(value: JsonValue): JsonContentBlock {\n  return {\n    type: \"json\",\n    value,\n  };\n}\n\nexport function propertiesBlock(items: PropertyItem[]): PropertiesContentBlock {\n  return {\n    type: \"properties\",\n    items,\n  };\n}\n\nexport function ok(blocks: ContentBlock[]): CommandResult {\n  return {\n    status: \"success\",\n    blocks,\n  };\n}\n\nexport function okText(text: string): CommandResult {\n  return ok([textBlock(text)]);\n}\n\nexport function fail(code: string, message: string, blocks: ContentBlock[] = []): CommandResult {\n  return {\n    status: \"error\",\n    blocks,\n    error: {\n      code,\n      message,\n    },\n  };\n}\n\nexport function failText(code: string, message: string, text?: string): CommandResult {\n  return fail(code, message, text === undefined ? [] : [textBlock(text)]);\n}\n"],"mappings":";AAMA,SAAgB,aAAa,SAA+C;CAC1E,OAAO,EAAE,QAAQ;AACnB;;;ACmEA,SAAgB,aACd,OAIiC;CACjC,IAAI,OAAO,UAAU,YACnB,OAAO,oBAAoB,KAAK;CAGlC,IAAI,cAAc,SAAS,OAAO,MAAM,aAAa,YACnD,OAAO;CAGT,OAAO,mBAAmB,KAAyC;AACrE;AAEA,SAAS,oBACP,OACiC;CACjC,IAAI;CAEJ,OAAO;EACL,MAAM,SAAS,KAAK;GAClB,aAAa,iCAAiD;GAC9D,MAAM,MAAM,oBAAoB,UAAU,CAAC;GAC3C,MAAM,mBAAmB,KAAK,UAAU;EAC1C;EACA,MAAM,WAAW,KAAK;GACpB,IAAI,CAAC,YACH;GAGF,MAAM,qBAAqB,KAAK,UAAU;EAC5C;CACF;AACF;AAEA,SAAS,mBACP,YACiC;CACjC,MAAM,uBAAuB,iCAAiC,UAAU;CAExE,OAAO;EACL,MAAM,SAAS,KAAK;GAClB,MAAM,mBAAmB,KAAK,oBAAoB;EACpD;EACA,MAAM,WAAW,KAAK;GACpB,MAAM,qBAAqB,KAAK,oBAAoB;EACtD;CACF;AACF;AAEA,SAAS,oBACP,YAC+B;CAC/B,OAAO;EACL,QAAQ,WAAW,SAAS;GAC1B,WAAW,SAAS,KAAK;IACvB;IACS;GACX,CAAC;EACH;EACA,WAAW,SAAS;GAClB,WAAW,WAAW,KAAK,OAAO;EACpC;EACA,aAAa,SAAS;GACpB,WAAW,aAAa,KAAK,OAAO;EACtC;CACF;AACF;AAEA,SAAS,iCAEP,YAA2F;CAC3F,OAAO;EACL,UAAU,YAAY,WAAW,kBAAkB,WAAW,QAAQ,IAAI,CAAC;EAC3E,YAAY,YAAY,aAAa,CAAC,WAAW,UAAU,IAAI,CAAC;EAChE,cAAc,YAAY,eAAe,CAAC,WAAW,YAAY,IAAI,CAAC;CACxE;AACF;AAEA,SAAS,kBACP,UACqB;CACrB,OAAO,OAAO,QAAQ,QAAQ,EAAE,KAAK,CAAC,WAAW,cAAc;EAC7D;EACS;CACX,EAAE;AACJ;AAEA,eAAe,mBAGb,KACA,YACe;CACf,KAAK,MAAM,cAAc,WAAW,YAClC,MAAM,WAAW,GAAG;CAGtB,KAAK,MAAM,WAAW,WAAW,UAC/B,IAAI,cAAc,KACf,IAAI,SAAoC,SAAS,QAAQ,WAAW,QAAQ,OAAO,CACtF;AAEJ;AAEA,eAAe,qBAGb,KACA,YACe;CACf,KAAK,MAAM,gBAAgB,WAAW,aAAa,WAAW,GAC5D,MAAM,aAAa,GAAG;AAE1B;;;ACrLA,SAAgB,UAAU,MAAgC;CACxD,OAAO;EACL,MAAM;EACN;CACF;AACF;AAEA,SAAgB,UAAU,MAAc,UAAqC;CAC3E,OAAO;EACL,MAAM;EACN;EACA,GAAI,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS;CAC/C;AACF;AAEA,SAAgB,UAAU,OAAoC;CAC5D,OAAO;EACL,MAAM;EACN;CACF;AACF;AAEA,SAAgB,gBAAgB,OAA+C;CAC7E,OAAO;EACL,MAAM;EACN;CACF;AACF;AAEA,SAAgB,GAAG,QAAuC;CACxD,OAAO;EACL,QAAQ;EACR;CACF;AACF;AAEA,SAAgB,OAAO,MAA6B;CAClD,OAAO,GAAG,CAAC,UAAU,IAAI,CAAC,CAAC;AAC7B;AAEA,SAAgB,KAAK,MAAc,SAAiB,SAAyB,CAAC,GAAkB;CAC9F,OAAO;EACL,QAAQ;EACR;EACA,OAAO;GACL;GACA;EACF;CACF;AACF;AAEA,SAAgB,SAAS,MAAc,SAAiB,MAA8B;CACpF,OAAO,KAAK,MAAM,SAAS,SAAS,KAAA,IAAY,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;AACxE"}

package/dist/plugin.d.ts

@@ -0,0 +1,27 @@
+import type { MaybePromise } from "@tooldeck/shared";
+import type { CommandHandler, CommandInput, CommandInputMap } from "./commands";
+import type { PluginContextV1 } from "./context";
+export interface ToolboxPluginV1<TCommandInputs extends CommandInputMap = Record<string, CommandInput>> {
+    activate(ctx: PluginContextV1<TCommandInputs>): MaybePromise<void>;
+    deactivate?(ctx: PluginContextV1<TCommandInputs>): MaybePromise<void>;
+}
+export type ToolboxPlugin<TCommandInputs extends CommandInputMap = Record<string, CommandInput>> = ToolboxPluginV1<TCommandInputs>;
+export type PluginLifecycleHandler<TCommandInputs extends CommandInputMap = Record<string, CommandInput>> = (ctx: PluginContextV1<TCommandInputs>) => MaybePromise<void>;
+export type PluginCommandHandlers<TCommandInputs extends CommandInputMap = Record<string, CommandInput>> = Partial<{
+    [TCommandId in keyof TCommandInputs & string]: CommandHandler<TCommandInputs[TCommandId]>;
+}>;
+export interface PluginDefinition<TCommandInputs extends CommandInputMap = Record<string, CommandInput>> {
+    commands?: PluginCommandHandlers<TCommandInputs>;
+    onActivate?: PluginLifecycleHandler<TCommandInputs>;
+    onDeactivate?: PluginLifecycleHandler<TCommandInputs>;
+}
+export interface PluginBuilder<TCommandInputs extends CommandInputMap = Record<string, CommandInput>> {
+    command<TCommandId extends keyof TCommandInputs & string>(commandId: TCommandId, handler: CommandHandler<TCommandInputs[TCommandId]>): void;
+    onActivate(handler: PluginLifecycleHandler<TCommandInputs>): void;
+    onDeactivate(handler: PluginLifecycleHandler<TCommandInputs>): void;
+}
+export type PluginSetup<TCommandInputs extends CommandInputMap = Record<string, CommandInput>> = (plugin: PluginBuilder<TCommandInputs>) => MaybePromise<void>;
+export declare function definePlugin<TCommandInputs extends CommandInputMap = Record<string, CommandInput>>(setup: PluginSetup<TCommandInputs>): ToolboxPluginV1<TCommandInputs>;
+export declare function definePlugin<TCommandInputs extends CommandInputMap = Record<string, CommandInput>>(definition: PluginDefinition<TCommandInputs>): ToolboxPluginV1<TCommandInputs>;
+export declare function definePlugin<TCommandInputs extends CommandInputMap = Record<string, CommandInput>>(plugin: ToolboxPluginV1<TCommandInputs>): ToolboxPluginV1<TCommandInputs>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGjD,MAAM,WAAW,eAAe,CAC9B,cAAc,SAAS,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAErE,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC,cAAc,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACnE,UAAU,CAAC,CAAC,GAAG,EAAE,eAAe,CAAC,cAAc,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,MAAM,MAAM,aAAa,CAAC,cAAc,SAAS,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,IAC7F,eAAe,CAAC,cAAc,CAAC,CAAC;AAElC,MAAM,MAAM,sBAAsB,CAChC,cAAc,SAAS,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,IACnE,CAAC,GAAG,EAAE,eAAe,CAAC,cAAc,CAAC,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;AAEjE,MAAM,MAAM,qBAAqB,CAC/B,cAAc,SAAS,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,IACnE,OAAO,CAAC;KACT,UAAU,IAAI,MAAM,cAAc,GAAG,MAAM,GAAG,cAAc,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;CAC1F,CAAC,CAAC;AAEH,MAAM,WAAW,gBAAgB,CAC/B,cAAc,SAAS,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAErE,QAAQ,CAAC,EAAE,qBAAqB,CAAC,cAAc,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC;IACpD,YAAY,CAAC,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,aAAa,CAC5B,cAAc,SAAS,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAErE,OAAO,CAAC,UAAU,SAAS,MAAM,cAAc,GAAG,MAAM,EACtD,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,cAAc,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,GAClD,IAAI,CAAC;IACR,UAAU,CAAC,OAAO,EAAE,sBAAsB,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IAClE,YAAY,CAAC,OAAO,EAAE,sBAAsB,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;CACrE;AAED,MAAM,MAAM,WAAW,CAAC,cAAc,SAAS,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,IAAI,CAC/F,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,KAClC,YAAY,CAAC,IAAI,CAAC,CAAC;AAmBxB,wBAAgB,YAAY,CAAC,cAAc,SAAS,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAChG,KAAK,EAAE,WAAW,CAAC,cAAc,CAAC,GACjC,eAAe,CAAC,cAAc,CAAC,CAAC;AACnC,wBAAgB,YAAY,CAAC,cAAc,SAAS,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAChG,UAAU,EAAE,gBAAgB,CAAC,cAAc,CAAC,GAC3C,eAAe,CAAC,cAAc,CAAC,CAAC;AACnC,wBAAgB,YAAY,CAAC,cAAc,SAAS,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAChG,MAAM,EAAE,eAAe,CAAC,cAAc,CAAC,GACtC,eAAe,CAAC,cAAc,CAAC,CAAC"}

package/dist/results.d.ts

@@ -0,0 +1,11 @@
+import type { CodeContentBlock, CommandResult, ContentBlock, JsonContentBlock, PropertiesContentBlock, PropertyItem, TextContentBlock } from "@tooldeck/protocol";
+import type { JsonValue } from "@tooldeck/shared";
+export declare function textBlock(text: string): TextContentBlock;
+export declare function codeBlock(text: string, language?: string): CodeContentBlock;
+export declare function jsonBlock(value: JsonValue): JsonContentBlock;
+export declare function propertiesBlock(items: PropertyItem[]): PropertiesContentBlock;
+export declare function ok(blocks: ContentBlock[]): CommandResult;
+export declare function okText(text: string): CommandResult;
+export declare function fail(code: string, message: string, blocks?: ContentBlock[]): CommandResult;
+export declare function failText(code: string, message: string, text?: string): CommandResult;
+//# sourceMappingURL=results.d.ts.map

package/dist/results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../src/results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAKxD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAM3E;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB,CAK5D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,sBAAsB,CAK7E;AAED,wBAAgB,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,aAAa,CAKxD;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAElD;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,YAAY,EAAO,GAAG,aAAa,CAS9F;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAEpF"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@tooldeck/sdk-node",
+  "version": "1.1.0",
+  "description": "SDK types and helpers for Tooldeck plugins.",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@tooldeck/protocol": "1.1.0"
+  },
+  "devDependencies": {
+    "@tooldeck/shared": "1.1.0"
+  },
+  "scripts": {
+    "build": "vite build --configLoader runner && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}