@picteus/extension-sdk 0.18.0 → 0.19.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export * from "./intents.js";
-export * from "./picteusExtension.js";
 export * from "./picteus-ws-client/index.js";
+export * from "./generated/backEndIntents.js";
+export * from "./generated/frontEndIntents.js";
 export * from "./generated/viewKit.js";
+export * from "./picteusExtension.js";

package/dist/index.js

@@ -1,4 +1,5 @@
-export * from "./intents.js";
-export * from "./picteusExtension.js";
 export * from "./picteus-ws-client/index.js";
+export * from "./generated/backEndIntents.js";
+export * from "./generated/frontEndIntents.js";
 export * from "./generated/viewKit.js";
+export * from "./picteusExtension.js";

package/dist/picteusExtension.d.ts

@@ -1,6 +1,6 @@
 import { Socket } from "socket.io-client";
-import { ApiSecretApi, CollectionApi, Configuration, ExtensionApi, ImageApi, ImageAttachmentApi, Manifest, MiscellaneousApi, RepositoryApi } from "./index.js";
-import { Intent } from "./intents.js";
+import { ApiSecretApi, BackIntent, CollectionApi, Configuration, ExtensionApi, FrontIntent, ImageApi, ImageAttachmentApi, Manifest, MiscellaneousApi, RepositoryApi } from "./index.js";
+export type Intent = FrontIntent | BackIntent;
 export type EventValue = Record<string, any>;
 export declare const InstructionReturnedErrorCause: {
     readonly Cancel: 0;
@@ -30,6 +30,10 @@ export declare const EventName: {
     readonly TextComputeEmbeddings: "text.computeEmbeddings";
 };
 export type EventName = (typeof EventName)[keyof typeof EventName];
+export type Entity = {
+    type: "image" | "repository" | "collection";
+    id: string | number;
+};
 export declare class Helper {
     static readonly GENERATION_RECIPE_SCHEMA_VERSION = 2;
 }
@@ -73,8 +77,10 @@ declare class MessageSender {
 export declare class Communicator {
     private readonly logger;
     private readonly sender;
-    constructor(logger: Logger, sender: MessageSender);
-    sendLog(message: string, level: "debug" | "info" | "warn" | "error"): void;
+    private entity;
+    constructor(logger: Logger, sender: MessageSender, entity?: Entity);
+    forEntity(entity: Entity): this;
+    sendLog(message: string, level: "debug" | "info" | "warn" | "error", entity?: Entity): void;
     sendNotification(value: Record<string, any>): void;
     launchIntent<T>(intent: Intent): Promise<T>;
     private sendMessage;
@@ -130,5 +136,8 @@ export declare class PicteusExtension {
     private disconnectSocket;
     private exit;
     private getApiConfiguration;
+    private computeEventEntity;
+    private extractEventValueId;
+    private extractEventCommandId;
 }
 export {};

package/dist/picteusExtension.js

@@ -136,13 +136,21 @@ const instructionsEvent = "instructions";
 export class Communicator {
     logger;
     sender;
-    constructor(logger, sender) {
+    entity;
+    constructor(logger, sender, entity) {
         this.logger = logger;
         this.sender = sender;
+        this.entity = entity;
     }
-    sendLog(message, level) {
+    forEntity(entity) {
+        this.entity = entity;
+        return this;
+    }
+    sendLog(message, level, entity) {
         this.logger[level](message);
-        this.sendMessage(instructionsEvent, { log: { message, level } });
+        const actualEntity = entity ?? this.entity;
+        const log = actualEntity === undefined ? { message, level } : { message, level, entity: actualEntity };
+        this.sendMessage(instructionsEvent, { log });
     }
     // noinspection JSUnusedGlobalSymbols
     sendNotification(value) {
@@ -246,47 +254,37 @@ export class PicteusExtension {
     }
     async onEvent(communicator, event, value) {
         if (event === EventName.ImageCreated) {
-            const imageId = value["id"];
-            return await this.onImageCreated(communicator, imageId);
+            return await this.onImageCreated(communicator, this.extractEventValueId(value));
         }
         else if (event === EventName.ImageUpdated) {
-            const imageId = value["id"];
-            return await this.onImageUpdated(communicator, imageId);
+            return await this.onImageUpdated(communicator, this.extractEventValueId(value));
         }
         else if (event === EventName.ImageDeleted) {
-            const imageId = value["id"];
-            return await this.onImageDeleted(communicator, imageId);
+            return await this.onImageDeleted(communicator, this.extractEventValueId(value));
         }
         else if (event === EventName.ImageTagsUpdated) {
-            const imageId = value["id"];
-            return await this.onImageTagsUpdated(communicator, imageId);
+            return await this.onImageTagsUpdated(communicator, this.extractEventValueId(value));
         }
         else if (event === EventName.ImageFeaturesUpdated) {
-            const imageId = value["id"];
-            return await this.onImageFeaturesUpdated(communicator, imageId);
+            return await this.onImageFeaturesUpdated(communicator, this.extractEventValueId(value));
         }
         else if (event === EventName.ImageComputeTags) {
-            const imageId = value["id"];
-            return await this.onComputeImageTags(communicator, imageId);
+            return await this.onComputeImageTags(communicator, this.extractEventValueId(value));
         }
         else if (event === EventName.ImageComputeFeatures) {
-            const imageId = value["id"];
-            return await this.onComputeImageFeatures(communicator, imageId);
+            return await this.onComputeImageFeatures(communicator, this.extractEventValueId(value));
         }
         else if (event === EventName.ImageComputeEmbeddings) {
-            const imageId = value["id"];
-            return await this.onComputeImageEmbeddings(communicator, imageId);
+            return await this.onComputeImageEmbeddings(communicator, this.extractEventValueId(value));
         }
         else if (event === EventName.ImageRunCommand) {
-            const commandId = value["commandId"];
             const imageIds = value["imageIds"];
             const parameters = value["parameters"] ?? {};
-            return await this.onImagesCommand(communicator, commandId, imageIds, parameters);
+            return await this.onImagesCommand(communicator, this.extractEventCommandId(value), imageIds, parameters);
         }
         else if (event === EventName.ProcessRunCommand) {
-            const commandId = value["commandId"];
             const parameters = value["parameters"] ?? {};
-            return await this.onProcessCommand(communicator, commandId, parameters);
+            return await this.onProcessCommand(communicator, this.extractEventCommandId(value), parameters);
         }
         else if (event === EventName.TextComputeEmbeddings) {
             const text = value["text"];
@@ -386,7 +384,8 @@ export class PicteusExtension {
                 return this.toString();
             }, contextId);
             sender.maximumPayloadSizeInBytes = globalSender.maximumPayloadSizeInBytes;
-            const communicator = new Communicator(this.logger, sender);
+            const entity = this.computeEventEntity(channel, value);
+            const communicator = new Communicator(this.logger, sender, entity);
             const requiresResult = channel !== extensionSettingsChannel;
             let result;
             let success = false;
@@ -486,4 +485,26 @@ export class PicteusExtension {
             ]
         });
     }
+    computeEventEntity(channel, value) {
+        const imageComputationEvents = new Set([
+            EventName.ImageCreated,
+            EventName.ImageUpdated,
+            EventName.ImageTagsUpdated,
+            EventName.ImageFeaturesUpdated,
+            EventName.ImageDeleted,
+            EventName.ImageComputeTags,
+            EventName.ImageComputeFeatures,
+            EventName.ImageComputeEmbeddings
+        ]);
+        if (imageComputationEvents.has(channel) === false) {
+            return undefined;
+        }
+        return { type: "image", id: this.extractEventValueId(value) };
+    }
+    extractEventValueId(value) {
+        return value["id"];
+    }
+    extractEventCommandId(value) {
+        return value["commandId"];
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picteus/extension-sdk",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "productName": "Picteus TypeScript SDK",
   "description": "The Picteus extension TypeScript SDK.",
   "keywords": [
@@ -38,14 +38,12 @@
     "./dist"
   ],
   "scripts": {
-    "compile": "tsc && tsc-alias --resolve-full-paths",
-    "compileWithTsup": "tsup src/index.ts --tsconfig tsconfig.json --format cjs,esm --dts --clean --minify-whitespace --minify-identifiers --minify-syntax"
+    "compile": "tsc && tsc-alias --resolve-full-paths"
   },
   "devDependencies": {
     "typescript": "5.9.2",
-    "@types/node": "20.19.0",
-    "tsc-alias": "1.8.17",
-    "tsup": "8.5.1"
+    "@types/node": "22.17.1",
+    "tsc-alias": "1.8.17"
   },
   "dependencies": {
     "socket.io-client": "4.8.3"