@pooder/core 2.0.0 → 2.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pooder/core",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "description": "Core logic for Pooder editor",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/command.ts

@@ -1,10 +1,10 @@
-export interface CommandArgSchema {}
-
-export interface Command {
-  id: string;
-  handler: (...args: any[]) => any;
-  title?: string;
-  category?: string;
-  description?: string;
-  schema?: Record<string, CommandArgSchema>;
-}
+export interface CommandArgSchema {}
+
+export interface Command {
+  id: string;
+  handler: (...args: any[]) => any;
+  title?: string;
+  category?: string;
+  description?: string;
+  schema?: Record<string, CommandArgSchema>;
+}

package/src/context.ts

@@ -1,17 +1,22 @@
-import EventBus from "./event";
-import { Contribution } from "./contribution";
-import { Service } from "./service";
-import Disposable from "./disposable";
-
-interface ExtensionContext {
-  readonly eventBus: EventBus;
-  readonly services: {
-    get<T extends Service>(serviceName: string): T | undefined;
-  };
-  readonly contributions: {
-    get<T>(pointId: string): Contribution<T>[];
-    register<T>(pointId: string, contribution: Contribution<T>): Disposable;
-  };
-}
-
-export { ExtensionContext };
+import EventBus from "./event";
+import { Contribution } from "./contribution";
+import { Service, ServiceIdentifier } from "./service";
+import Disposable from "./disposable";
+
+interface ExtensionContext {
+  readonly eventBus: EventBus;
+  readonly services: {
+    get<T extends Service>(identifier: ServiceIdentifier<T>): T | undefined;
+    getOrThrow<T extends Service>(
+      identifier: ServiceIdentifier<T>,
+      errorMessage?: string,
+    ): T;
+    has(identifier: ServiceIdentifier<Service>): boolean;
+  };
+  readonly contributions: {
+    get<T>(pointId: string): Contribution<T>[];
+    register<T>(pointId: string, contribution: Contribution<T>): Disposable;
+  };
+}
+
+export { ExtensionContext };

package/src/contribution/index.ts

@@ -1,12 +1,12 @@
-export * from "./points";
-export * from "./registry";
-
-export interface ContributionMetadata {
-  name: string;
-  extensionId: string;
-}
-export interface Contribution<T = any> {
-  id: string;
-  data: T;
-  metadata?: Partial<ContributionMetadata>;
-}
+export * from "./points";
+export * from "./registry";
+
+export interface ContributionMetadata {
+  name: string;
+  extensionId: string;
+}
+export interface Contribution<T = any> {
+  id: string;
+  data: T;
+  metadata?: Partial<ContributionMetadata>;
+}

package/src/contribution/points.ts

@@ -17,12 +17,36 @@ export interface CommandContribution {
 /**
  * Tool Contribution Data Definition
  */
+export type ToolInteraction = "instant" | "session" | "hybrid";
+
+export type ToolSessionLeavePolicy = "block" | "commit" | "rollback";
+
+export interface ToolCommandBindings {
+  execute?: string;
+  begin?: string;
+  validate?: string;
+  commit?: string;
+  rollback?: string;
+  reset?: string;
+}
+
 export interface ToolContribution {
   id: string;
   name: string;
-  description: string;
-  parameters?: Record<string, any>; // JSON Schema for parameters
-  execute: (...args: any[]) => Promise<any>;
+  description?: string;
+  icon?: string;
+  interaction: ToolInteraction;
+  parameters?: Record<string, any>;
+  commands?: ToolCommandBindings;
+  view?: {
+    id?: string;
+    type?: "sidebar" | "panel" | "editor" | "dialog";
+    location?: string;
+  };
+  session?: {
+    autoBegin?: boolean;
+    leavePolicy?: ToolSessionLeavePolicy;
+  };
 }
 
 /**

package/src/contribution/registry.ts

@@ -1,118 +1,118 @@
-import { Contribution, ContributionPoint, ContributionPointIds } from "./index";
-import Disposable from "../disposable";
-
-export class ContributionRegistry {
-  private points: Map<string, ContributionPoint> = new Map();
-  private contributions = {
-    byId: new Map<string, Contribution>(),
-    byPointId: new Map<string, Contribution[]>(),
-  };
-
-  /**
-   * Register a new contribution point
-   */
-  registerPoint<T>(point: ContributionPoint<T>): void {
-    if (this.points.has(point.id)) {
-      console.warn(
-        `Contribution point ${point.id} already exists. Overwriting definitions may cause issues.`,
-      );
-    }
-    this.points.set(point.id, point);
-    if (!this.contributions.byPointId.has(point.id)) {
-      this.contributions.byPointId.set(point.id, []);
-    }
-  }
-
-  /**
-   * Register a contribution to a specific point
-   * @returns Disposable to unregister the contribution
-   */
-  register<T>(pointId: string, contribution: Contribution<T>): Disposable {
-    if (this.contributions.byId.has(contribution.id)) {
-      console.warn(
-        `Contribution with ID "${contribution.id}" is already registered. Overwriting.`,
-      );
-      // We could choose to throw, or overwrite. Let's overwrite for now but warn.
-      // If we overwrite, we should probably remove the old one from the list first to avoid duplicates.
-      this.unregister(pointId, contribution.id);
-    }
-
-    if (!this.points.has(pointId)) {
-      console.warn(
-        `Contribution point ${pointId} does not exist. The contribution ${contribution.id} will be queued but may not be valid.`,
-      );
-      if (!this.contributions.byPointId.has(pointId)) {
-        this.contributions.byPointId.set(pointId, []);
-      }
-    }
-
-    const point = this.points.get(pointId);
-    if (point?.validate) {
-      try {
-        if (!point.validate(contribution.data)) {
-          console.error(
-            `Contribution ${contribution.id} failed validation for point ${pointId}.`,
-          );
-          return { dispose: () => {} };
-        }
-      } catch (e) {
-        console.error(
-          `Validation error for contribution ${contribution.id}:`,
-          e,
-        );
-        return { dispose: () => {} };
-      }
-    }
-
-    const arr = this.contributions.byPointId.get(pointId)!;
-
-    arr.push(contribution);
-    this.contributions.byId.set(contribution.id, contribution);
-
-    // Auto-register if this is a contribution point contribution
-    if (pointId === ContributionPointIds.CONTRIBUTIONS) {
-      this.registerPoint(contribution.data as ContributionPoint);
-    }
-
-    return {
-      dispose: () => {
-        this.unregister(pointId, contribution.id);
-      },
-    };
-  }
-
-  /**
-   * Get all contributions for a given point
-   */
-  get<T>(pointId: string): Contribution<T>[] {
-    return Array.from(
-      this.contributions.byPointId.get(pointId)?.values() || [],
-    ) as Contribution<T>[];
-  }
-
-  /**
-   * Get a specific contribution by ID
-   */
-  getById<T>(id: string): Contribution<T> | undefined {
-    return this.contributions.byId.get(id) as Contribution<T> | undefined;
-  }
-
-  /**
-   * Get the contribution point definition
-   */
-  getPoint(pointId: string): ContributionPoint | undefined {
-    return this.points.get(pointId);
-  }
-
-  /**
-   * Unregister a contribution
-   */
-  private unregister(pointId: string, contributionId: string): void {
-    const arr = this.contributions.byPointId.get(pointId);
-    arr?.splice(
-      arr.findIndex((c) => c.id === contributionId),
-      1,
-    );
-    this.contributions.byId.delete(contributionId);
-  }
-}
+import { Contribution, ContributionPoint, ContributionPointIds } from "./index";
+import Disposable from "../disposable";
+
+export class ContributionRegistry {
+  private points: Map<string, ContributionPoint> = new Map();
+  private contributions = {
+    byId: new Map<string, Contribution>(),
+    byPointId: new Map<string, Contribution[]>(),
+  };
+
+  /**
+   * Register a new contribution point
+   */
+  registerPoint<T>(point: ContributionPoint<T>): void {
+    if (this.points.has(point.id)) {
+      console.warn(
+        `Contribution point ${point.id} already exists. Overwriting definitions may cause issues.`,
+      );
+    }
+    this.points.set(point.id, point);
+    if (!this.contributions.byPointId.has(point.id)) {
+      this.contributions.byPointId.set(point.id, []);
+    }
+  }
+
+  /**
+   * Register a contribution to a specific point
+   * @returns Disposable to unregister the contribution
+   */
+  register<T>(pointId: string, contribution: Contribution<T>): Disposable {
+    if (this.contributions.byId.has(contribution.id)) {
+      console.warn(
+        `Contribution with ID "${contribution.id}" is already registered. Overwriting.`,
+      );
+      // We could choose to throw, or overwrite. Let's overwrite for now but warn.
+      // If we overwrite, we should probably remove the old one from the list first to avoid duplicates.
+      this.unregister(pointId, contribution.id);
+    }
+
+    if (!this.points.has(pointId)) {
+      console.warn(
+        `Contribution point ${pointId} does not exist. The contribution ${contribution.id} will be queued but may not be valid.`,
+      );
+      if (!this.contributions.byPointId.has(pointId)) {
+        this.contributions.byPointId.set(pointId, []);
+      }
+    }
+
+    const point = this.points.get(pointId);
+    if (point?.validate) {
+      try {
+        if (!point.validate(contribution.data)) {
+          console.error(
+            `Contribution ${contribution.id} failed validation for point ${pointId}.`,
+          );
+          return { dispose: () => {} };
+        }
+      } catch (e) {
+        console.error(
+          `Validation error for contribution ${contribution.id}:`,
+          e,
+        );
+        return { dispose: () => {} };
+      }
+    }
+
+    const arr = this.contributions.byPointId.get(pointId)!;
+
+    arr.push(contribution);
+    this.contributions.byId.set(contribution.id, contribution);
+
+    // Auto-register if this is a contribution point contribution
+    if (pointId === ContributionPointIds.CONTRIBUTIONS) {
+      this.registerPoint(contribution.data as ContributionPoint);
+    }
+
+    return {
+      dispose: () => {
+        this.unregister(pointId, contribution.id);
+      },
+    };
+  }
+
+  /**
+   * Get all contributions for a given point
+   */
+  get<T>(pointId: string): Contribution<T>[] {
+    return Array.from(
+      this.contributions.byPointId.get(pointId)?.values() || [],
+    ) as Contribution<T>[];
+  }
+
+  /**
+   * Get a specific contribution by ID
+   */
+  getById<T>(id: string): Contribution<T> | undefined {
+    return this.contributions.byId.get(id) as Contribution<T> | undefined;
+  }
+
+  /**
+   * Get the contribution point definition
+   */
+  getPoint(pointId: string): ContributionPoint | undefined {
+    return this.points.get(pointId);
+  }
+
+  /**
+   * Unregister a contribution
+   */
+  private unregister(pointId: string, contributionId: string): void {
+    const arr = this.contributions.byPointId.get(pointId);
+    arr?.splice(
+      arr.findIndex((c) => c.id === contributionId),
+      1,
+    );
+    this.contributions.byId.delete(contributionId);
+  }
+}

package/src/disposable.ts

@@ -1,3 +1,3 @@
-export default interface Disposable {
-  dispose(): void;
-}
+export default interface Disposable {
+  dispose(): void;
+}