@ductape/sdk 0.0.4 → 0.0.6

package/dist/agents/types/agents.types.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Agent Types
+ *
+ * Type definitions for the Ductape Agentic Workflows API.
+ * Enables AI-driven, autonomous multi-step processes where an LLM
+ * dynamically decides the next action based on observations and reasoning.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+// Note: For resilience types (IHealthcheckSchema, IQuotaSchema, IFallbackSchema),
+// import directly from '../../resilience/types' when defining product-level configs
+//# sourceMappingURL=agents.types.js.map

package/dist/agents/types/agents.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.types.js","sourceRoot":"","sources":["../../../src/agents/types/agents.types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAi5CH,kFAAkF;AAClF,oFAAoF"}

package/dist/agents/types/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Agent Types Index
+ *
+ * Export all agent-related types
+ */
+export * from './agents.types';

package/dist/agents/types/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Agent Types Index
+ *
+ * Export all agent-related types
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./agents.types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/agents/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/types/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,iDAA+B"}

package/dist/agents/vector-store-adapter.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Vector Store Adapter
+ *
+ * Bridges the VectorService to the MemoryManager's IVectorStoreAdapter interface.
+ * Enables agents to use any supported vector database for long-term memory.
+ */
+import { IVectorStoreAdapter } from './memory-manager';
+import { VectorService, IVectorServiceOptions } from '../vector';
+/**
+ * Configuration for the VectorService-based adapter
+ */
+export interface IVectorStoreAdapterConfig {
+    /** Vector service options */
+    vectorService?: VectorService;
+    /** Or provide config to create a new service */
+    vectorConfig?: IVectorServiceOptions;
+    /** Namespace for this adapter's vectors */
+    namespace?: string;
+}
+/**
+ * Adapter that wraps VectorService for use with MemoryManager
+ */
+export declare class VectorServiceAdapter implements IVectorStoreAdapter {
+    private vectorService;
+    private namespace?;
+    private initialized;
+    constructor(config: IVectorStoreAdapterConfig);
+    /**
+     * Ensure the vector service is connected
+     */
+    private ensureConnected;
+    /**
+     * Store embeddings with content and metadata
+     */
+    upsert(vectors: Array<{
+        id: string;
+        content: string;
+        embedding: number[];
+        metadata?: Record<string, unknown>;
+    }>): Promise<void>;
+    /**
+     * Query similar vectors
+     */
+    query(embedding: number[], topK: number, filter?: Record<string, unknown>): Promise<Array<{
+        content: string;
+        metadata?: Record<string, unknown>;
+        score: number;
+    }>>;
+    /**
+     * Delete vectors by IDs
+     */
+    delete(ids: string[]): Promise<void>;
+    /**
+     * Clear namespace
+     */
+    clear(namespace?: string): Promise<void>;
+    /**
+     * Get the underlying vector service
+     */
+    getVectorService(): VectorService;
+    /**
+     * Disconnect from the vector service
+     */
+    disconnect(): Promise<void>;
+}
+/**
+ * Create a vector store adapter with default configuration
+ */
+export declare function createVectorStoreAdapter(config?: Partial<IVectorStoreAdapterConfig>): VectorServiceAdapter;
+/**
+ * Create a vector store adapter using Pinecone
+ */
+export declare function createPineconeAdapter(options: {
+    apiKey: string;
+    endpoint: string;
+    index: string;
+    dimensions: number;
+    namespace?: string;
+}): VectorServiceAdapter;
+/**
+ * Create a vector store adapter using Qdrant
+ */
+export declare function createQdrantAdapter(options: {
+    endpoint: string;
+    apiKey?: string;
+    collection: string;
+    dimensions: number;
+    namespace?: string;
+}): VectorServiceAdapter;
+/**
+ * Create a vector store adapter using Weaviate
+ */
+export declare function createWeaviateAdapter(options: {
+    endpoint: string;
+    apiKey?: string;
+    className: string;
+    dimensions: number;
+    namespace?: string;
+}): VectorServiceAdapter;
+/**
+ * Create an in-memory vector store adapter
+ */
+export declare function createMemoryAdapter(options?: {
+    index?: string;
+    dimensions?: number;
+    namespace?: string;
+}): VectorServiceAdapter;
+export default VectorServiceAdapter;

package/dist/agents/vector-store-adapter.js

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * Vector Store Adapter
+ *
+ * Bridges the VectorService to the MemoryManager's IVectorStoreAdapter interface.
+ * Enables agents to use any supported vector database for long-term memory.
+ */
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectorServiceAdapter = void 0;
+exports.createVectorStoreAdapter = createVectorStoreAdapter;
+exports.createPineconeAdapter = createPineconeAdapter;
+exports.createQdrantAdapter = createQdrantAdapter;
+exports.createWeaviateAdapter = createWeaviateAdapter;
+exports.createMemoryAdapter = createMemoryAdapter;
+const vector_1 = require("../vector");
+/**
+ * Adapter that wraps VectorService for use with MemoryManager
+ */
+class VectorServiceAdapter {
+    constructor(config) {
+        this.initialized = false;
+        if (config.vectorService) {
+            this.vectorService = config.vectorService;
+        }
+        else if (config.vectorConfig) {
+            this.vectorService = new vector_1.VectorService(config.vectorConfig);
+        }
+        else {
+            // Default to in-memory vector store
+            this.vectorService = new vector_1.VectorService({
+                type: vector_1.VectorDBType.MEMORY,
+                index: 'agent-memory',
+                dimensions: 1536,
+                metric: vector_1.DistanceMetric.COSINE,
+            });
+        }
+        this.namespace = config.namespace;
+    }
+    /**
+     * Ensure the vector service is connected
+     */
+    async ensureConnected() {
+        if (!this.initialized) {
+            if (!this.vectorService.connected) {
+                await this.vectorService.connect();
+            }
+            this.initialized = true;
+        }
+    }
+    /**
+     * Store embeddings with content and metadata
+     */
+    async upsert(vectors) {
+        await this.ensureConnected();
+        await this.vectorService.upsert({
+            vectors: vectors.map((v) => ({
+                id: v.id,
+                values: v.embedding,
+                metadata: Object.assign(Object.assign({}, v.metadata), { content: v.content }),
+            })),
+            namespace: this.namespace,
+        });
+    }
+    /**
+     * Query similar vectors
+     */
+    async query(embedding, topK, filter) {
+        await this.ensureConnected();
+        // Convert simple filter to IMetadataFilter format if needed
+        let metadataFilter;
+        if (filter) {
+            const filterConditions = Object.entries(filter).map(([field, value]) => ({
+                field,
+                operator: '$eq',
+                value,
+            }));
+            if (filterConditions.length === 1) {
+                metadataFilter = filterConditions[0];
+            }
+            else if (filterConditions.length > 1) {
+                metadataFilter = { $and: filterConditions };
+            }
+        }
+        const results = await this.vectorService.query({
+            vector: embedding,
+            topK,
+            filter: metadataFilter,
+            includeMetadata: true,
+            namespace: this.namespace,
+        });
+        return results.matches.map((m) => {
+            const _a = (m.metadata || {}), { content } = _a, restMetadata = __rest(_a, ["content"]);
+            return {
+                content: content || '',
+                metadata: restMetadata,
+                score: m.score,
+            };
+        });
+    }
+    /**
+     * Delete vectors by IDs
+     */
+    async delete(ids) {
+        await this.ensureConnected();
+        await this.vectorService.deleteByIds(ids, this.namespace);
+    }
+    /**
+     * Clear namespace
+     */
+    async clear(namespace) {
+        await this.ensureConnected();
+        const ns = namespace || this.namespace;
+        if (ns) {
+            await this.vectorService.deleteNamespace(ns);
+        }
+        else {
+            await this.vectorService.deleteAll();
+        }
+    }
+    /**
+     * Get the underlying vector service
+     */
+    getVectorService() {
+        return this.vectorService;
+    }
+    /**
+     * Disconnect from the vector service
+     */
+    async disconnect() {
+        if (this.initialized && this.vectorService.connected) {
+            await this.vectorService.disconnect();
+            this.initialized = false;
+        }
+    }
+}
+exports.VectorServiceAdapter = VectorServiceAdapter;
+/**
+ * Create a vector store adapter with default configuration
+ */
+function createVectorStoreAdapter(config) {
+    return new VectorServiceAdapter(config || {});
+}
+/**
+ * Create a vector store adapter using Pinecone
+ */
+function createPineconeAdapter(options) {
+    return new VectorServiceAdapter({
+        vectorConfig: {
+            type: vector_1.VectorDBType.PINECONE,
+            apiKey: options.apiKey,
+            endpoint: options.endpoint,
+            index: options.index,
+            dimensions: options.dimensions,
+        },
+        namespace: options.namespace,
+    });
+}
+/**
+ * Create a vector store adapter using Qdrant
+ */
+function createQdrantAdapter(options) {
+    return new VectorServiceAdapter({
+        vectorConfig: {
+            type: vector_1.VectorDBType.QDRANT,
+            apiKey: options.apiKey,
+            endpoint: options.endpoint,
+            index: options.collection,
+            dimensions: options.dimensions,
+        },
+        namespace: options.namespace,
+    });
+}
+/**
+ * Create a vector store adapter using Weaviate
+ */
+function createWeaviateAdapter(options) {
+    return new VectorServiceAdapter({
+        vectorConfig: {
+            type: vector_1.VectorDBType.WEAVIATE,
+            apiKey: options.apiKey,
+            endpoint: options.endpoint,
+            index: options.className,
+            dimensions: options.dimensions,
+        },
+        namespace: options.namespace,
+    });
+}
+/**
+ * Create an in-memory vector store adapter
+ */
+function createMemoryAdapter(options) {
+    return new VectorServiceAdapter({
+        vectorConfig: {
+            type: vector_1.VectorDBType.MEMORY,
+            index: (options === null || options === void 0 ? void 0 : options.index) || 'agent-memory',
+            dimensions: (options === null || options === void 0 ? void 0 : options.dimensions) || 1536,
+        },
+        namespace: options === null || options === void 0 ? void 0 : options.namespace,
+    });
+}
+exports.default = VectorServiceAdapter;
+//# sourceMappingURL=vector-store-adapter.js.map

package/dist/agents/vector-store-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store-adapter.js","sourceRoot":"","sources":["../../src/agents/vector-store-adapter.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;AA2KH,4DAIC;AAKD,sDAiBC;AAKD,kDAiBC;AAKD,sDAiBC;AAKD,kDAaC;AAhQD,sCAKmB;AAcnB;;GAEG;AACH,MAAa,oBAAoB;IAK/B,YAAY,MAAiC;QAFrC,gBAAW,GAAY,KAAK,CAAC;QAGnC,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;QAC5C,CAAC;aAAM,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YAC/B,IAAI,CAAC,aAAa,GAAG,IAAI,sBAAa,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,oCAAoC;YACpC,IAAI,CAAC,aAAa,GAAG,IAAI,sBAAa,CAAC;gBACrC,IAAI,EAAE,qBAAY,CAAC,MAAM;gBACzB,KAAK,EAAE,cAAc;gBACrB,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,uBAAc,CAAC,MAAM;aAC9B,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACpC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe;QAC3B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC;gBAClC,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YACrC,CAAC;YACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAKE;QAEF,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAE7B,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;YAC9B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3B,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,MAAM,EAAE,CAAC,CAAC,SAAS;gBACnB,QAAQ,kCACH,CAAC,CAAC,QAAQ,KACb,OAAO,EAAE,CAAC,CAAC,OAAO,GACnB;aACF,CAAC,CAAC;YACH,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CACT,SAAmB,EACnB,IAAY,EACZ,MAAgC;QAEhC,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAE7B,4DAA4D;QAC5D,IAAI,cAAc,CAAC;QACnB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;gBACvE,KAAK;gBACL,QAAQ,EAAE,KAAc;gBACxB,KAAK;aACN,CAAC,CAAC,CAAC;YAEJ,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,cAAc,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;YACvC,CAAC;iBAAM,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvC,cAAc,GAAG,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;YAC9C,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;YAC7C,MAAM,EAAE,SAAS;YACjB,IAAI;YACJ,MAAM,EAAE,cAAc;YACtB,eAAe,EAAE,IAAI;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC/B,MAAM,KAA+B,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAA4B,EAA5E,EAAE,OAAO,OAAmE,EAA9D,YAAY,cAA1B,WAA4B,CAAgD,CAAC;YACnF,OAAO;gBACL,OAAO,EAAG,OAAkB,IAAI,EAAE;gBAClC,QAAQ,EAAE,YAAY;gBACtB,KAAK,EAAE,CAAC,CAAC,KAAK;aACf,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,GAAa;QACxB,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC7B,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,SAAkB;QAC5B,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC;QACvC,IAAI,EAAE,EAAE,CAAC;YACP,MAAM,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC;YACrD,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;YACtC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;CACF;AA7ID,oDA6IC;AAED;;GAEG;AACH,SAAgB,wBAAwB,CACtC,MAA2C;IAE3C,OAAO,IAAI,oBAAoB,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,OAMrC;IACC,OAAO,IAAI,oBAAoB,CAAC;QAC9B,YAAY,EAAE;YACZ,IAAI,EAAE,qBAAY,CAAC,QAAQ;YAC3B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B;QACD,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,OAMnC;IACC,OAAO,IAAI,oBAAoB,CAAC;QAC9B,YAAY,EAAE;YACZ,IAAI,EAAE,qBAAY,CAAC,MAAM;YACzB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,UAAU;YACzB,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B;QACD,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,OAMrC;IACC,OAAO,IAAI,oBAAoB,CAAC;QAC9B,YAAY,EAAE;YACZ,IAAI,EAAE,qBAAY,CAAC,QAAQ;YAC3B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,SAAS;YACxB,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B;QACD,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,OAInC;IACC,OAAO,IAAI,oBAAoB,CAAC;QAC9B,YAAY,EAAE;YACZ,IAAI,EAAE,qBAAY,CAAC,MAAM;YACzB,KAAK,EAAE,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,KAAI,cAAc;YACvC,UAAU,EAAE,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,UAAU,KAAI,IAAI;SACxC;QACD,SAAS,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,kBAAe,oBAAoB,CAAC"}

package/dist/api/services/appApi.service.d.ts

@@ -1,25 +1,37 @@
 import { RedisClientType } from 'redis';
-import { ImportDocsTypes, IApp, IAppAccess, IBuilderSession, IBuilderSessionCreatePayload, ICreateApp, ICreateAppBuilder, IPrivKeyLoginPayload, PublicStates, IAccess, IRequestExtension, EnvType } from '../../types';
+import { ImportDocsTypes, IApp, IAppAccess, IBuilderSession, IBuilderSessionCreatePayload, ICreateApp, ICreateAppBuilder, IFetchSessionPayload, PublicStates, IAccess, IRequestExtension, EnvType } from '../../types';
 export interface IAppApiService {
-    fetchAppBuilderSession(payload: Omit<IPrivKeyLoginPayload, 'private_key'>): Promise<IBuilderSession>;
+    fetchAppBuilderSession(payload: IFetchSessionPayload): Promise<IBuilderSession>;
     createAppBuilderSession(payload: IBuilderSessionCreatePayload): Promise<IBuilderSession>;
     checkAppNameExists(name: string, payload: IRequestExtension): Promise<IApp | false>;
     fetchApp(app_id: string, auth: IRequestExtension): Promise<IApp>;
-    importApp(app_id: string, type: ImportDocsTypes, file: Buffer, version: string, update: boolean, auth: IRequestExtension): Promise<boolean>;
+    importApp(app_id: string, type: ImportDocsTypes, file: Buffer, version: string, update: boolean, auth: IRequestExtension, isAdminImport: boolean): Promise<boolean>;
     createApp(payload: ICreateApp, auth: IRequestExtension): Promise<IApp>;
     updateApp(app_id: string, payload: Record<string, unknown>, auth: IRequestExtension): Promise<void>;
     fetchWorkspaceApps(status: PublicStates, payload: IRequestExtension): Promise<Array<IApp>>;
     fetchAccessByTag(access_tag: string, payload: IRequestExtension): Promise<IAccess>;
     fetchAppByTag(app_tag: string, payload: IRequestExtension): Promise<IApp>;
     createAppAccess(app_id: string, integration_id: string, access_tag: string, payload: IRequestExtension): Promise<IAppAccess>;
+    fetchAppComponents(app_id: string, component_type: string, auth: IRequestExtension, version?: string): Promise<any[]>;
+    fetchAppComponentByTag(app_id: string, component_type: string, tag: string, auth: IRequestExtension, version?: string): Promise<any>;
+    initApp(id: string, auth: IRequestExtension): Promise<{
+        _id: string;
+        tag: string;
+        private_key: string;
+        versions: Array<{
+            tag: string;
+            latest: boolean;
+            active: boolean;
+        }>;
+    }>;
 }
 export declare class AppApiService implements IAppApiService {
     private environment;
     private redisClient;
     constructor(environment: EnvType, redis_client?: RedisClientType);
-    fetchAppBuilderSession(payload: Omit<IPrivKeyLoginPayload, 'private_key'>): Promise<IBuilderSession>;
+    fetchAppBuilderSession(payload: IFetchSessionPayload): Promise<IBuilderSession>;
     updateAppBuilderSession(): Promise<void>;
-    importApp(app_id: string, type: ImportDocsTypes, file: Buffer, version: string, update: boolean, auth: IRequestExtension): Promise<any>;
+    importApp(app_id: string, type: ImportDocsTypes, file: Buffer, version: string, update: boolean, auth: IRequestExtension, isAdminImport: boolean): Promise<any>;
     createAppBuilderSession(payload: IBuilderSessionCreatePayload): Promise<IBuilderSession>;
     checkAppNameExists(app_name: string, auth: IRequestExtension): Promise<IApp | false>;
     fetchApp(app_id: string, auth: IRequestExtension): Promise<IApp>;
@@ -29,4 +41,38 @@ export declare class AppApiService implements IAppApiService {
     fetchAccessByTag(access_tag: string, payload: IRequestExtension): Promise<IAccess>;
     fetchAppByTag(app_tag: string, payload: IRequestExtension): Promise<IApp>;
     createAppAccess(app_id: string, integration_id: string, access_tag: string, payload: IRequestExtension): Promise<IAppAccess>;
+    /**
+     * Fetch all components of a specific type for an app
+     * @param app_id - The app ID
+     * @param component_type - The type of component (action, auth, env, etc.)
+     * @param version - Optional version tag. If not provided, fetches from latest version
+     * @returns Array of components
+     */
+    fetchAppComponents(app_id: string, component_type: string, auth: IRequestExtension, version?: string): Promise<any[]>;
+    /**
+     * Fetch a specific component by tag
+     * @param app_id - The app ID
+     * @param component_type - The type of component (action, auth, env, etc.)
+     * @param tag - The component tag
+     * @param version - Optional version tag. If not provided, fetches from latest version
+     * @returns The component object
+     */
+    fetchAppComponentByTag(app_id: string, component_type: string, tag: string, auth: IRequestExtension, version?: string): Promise<any>;
+    /**
+     * Initialize app - fetch minimal app data (optimized for speed)
+     * Returns _id, tag, private_key, and versions array with minimal fields
+     * @param id - Either the app tag or _id
+     * @param auth - Optional authentication credentials
+     * @returns Object with _id, tag, private_key, and versions array
+     */
+    initApp(id: string, auth: IRequestExtension): Promise<{
+        _id: string;
+        tag: string;
+        private_key: string;
+        versions: Array<{
+            tag: string;
+            latest: boolean;
+            active: boolean;
+        }>;
+    }>;
 }

package/dist/api/services/appApi.service.js

@@ -39,10 +39,9 @@ class AppApiService {
         }
     }
     async updateAppBuilderSession() { }
-    async importApp(app_id, type, file, version, update, auth) {
+    async importApp(app_id, type, file, version, update, auth, isAdminImport) {
         try {
             const form = new FormData();
-            // Append file and other fields to FormData
             form.append('file', file, { filename: `upload-${app_id}.json` }); // Add the file from the file system
             if (app_id) {
                 form.append('app_id', app_id);
@@ -77,15 +76,17 @@ class AppApiService {
                 if (res)
                     return res;
             }
-            const { token } = auth, user_access = __rest(auth, ["token"]);
-            const res = await (0, apps_client_1.default)(this.environment).post(urls_1.CHECK_APP_EXISTS, Object.assign(Object.assign({}, user_access), { app_name }), (0, auth_utils_1.generateAxiosConfig)(token, types_1.DataFormats.JSON));
+            const { token, access_key } = auth, user_access = __rest(auth, ["token", "access_key"]);
+            const config = (0, auth_utils_1.generateAxiosConfig)(token, types_1.DataFormats.JSON);
+            if (access_key)
+                config.headers['x-access-key'] = access_key;
+            const res = await (0, apps_client_1.default)(this.environment).post(urls_1.CHECK_APP_EXISTS, Object.assign(Object.assign({}, user_access), { app_name }), config);
             if (this.redisClient) {
                 (0, cache_utils_1.WriteApiCache)(key, res.data.data, this.redisClient);
             }
             return res.data.data;
         }
         catch (e) {
-            console.log(e);
             return false;
         }
     }
@@ -110,8 +111,11 @@ class AppApiService {
     }
     async createApp(payload, auth) {
         try {
-            const { token } = auth, user_access = __rest(auth, ["token"]);
-            const res = await (0, apps_client_1.default)(this.environment).post(urls_1.APPS_CREATE_URL, Object.assign(Object.assign({}, user_access), payload), (0, auth_utils_1.generateAxiosConfig)(token, types_1.DataFormats.JSON));
+            const { token, access_key } = auth, user_access = __rest(auth, ["token", "access_key"]);
+            const config = (0, auth_utils_1.generateAxiosConfig)(token, types_1.DataFormats.JSON);
+            if (access_key)
+                config.headers['x-access-key'] = access_key;
+            const res = await (0, apps_client_1.default)(this.environment).post(urls_1.APPS_CREATE_URL, Object.assign(Object.assign({}, user_access), payload), config);
             return res.data.data;
         }
         catch (e) {
@@ -120,9 +124,12 @@ class AppApiService {
     }
     async updateApp(app_id, payload, auth) {
         try {
-            const { token } = auth, user_access = __rest(auth, ["token"]);
+            const { token, access_key } = auth, user_access = __rest(auth, ["token", "access_key"]);
+            const config = (0, auth_utils_1.generateAxiosConfig)(token, types_1.DataFormats.JSON);
+            if (access_key)
+                config.headers['x-access-key'] = access_key;
             const URL = (0, strings_utils_1.Parameterize)(urls_1.APP_CRUD_URL, ':app_id', app_id);
-            await (0, apps_client_1.default)(this.environment).put(URL, Object.assign(Object.assign({}, payload), user_access), (0, auth_utils_1.generateAxiosConfig)(token, types_1.DataFormats.JSON));
+            await (0, apps_client_1.default)(this.environment).put(URL, Object.assign(Object.assign({}, payload), user_access), config);
         }
         catch (e) {
             throw e;
@@ -191,6 +198,106 @@ class AppApiService {
             throw e;
         }
     }
+    /**
+     * Fetch all components of a specific type for an app
+     * @param app_id - The app ID
+     * @param component_type - The type of component (action, auth, env, etc.)
+     * @param version - Optional version tag. If not provided, fetches from latest version
+     * @returns Array of components
+     */
+    async fetchAppComponents(app_id, component_type, auth, version) {
+        try {
+            const { public_key, user_id } = auth;
+            const key = version
+                ? `app-components-${app_id}-${component_type}-${version}`
+                : `app-components-${app_id}-${component_type}-latest`;
+            if (this.redisClient) {
+                const res = await (0, cache_utils_1.FetchApiCache)(key, this.redisClient);
+                if (res)
+                    return res;
+            }
+            let URL = `/apps/v1/components/${app_id}/${component_type}`;
+            if (version) {
+                URL += `?version=${version}&user_id=${user_id}&public_key=${public_key}`;
+            }
+            else {
+                URL += `?user_id=${user_id}&public_key=${public_key}`;
+            }
+            const res = await (0, apps_client_1.default)(this.environment).get(URL);
+            if (this.redisClient) {
+                (0, cache_utils_1.WriteApiCache)(key, res.data.data, this.redisClient, 300); // Cache for 5 minutes
+            }
+            return res.data.data;
+        }
+        catch (e) {
+            throw e;
+        }
+    }
+    /**
+     * Fetch a specific component by tag
+     * @param app_id - The app ID
+     * @param component_type - The type of component (action, auth, env, etc.)
+     * @param tag - The component tag
+     * @param version - Optional version tag. If not provided, fetches from latest version
+     * @returns The component object
+     */
+    async fetchAppComponentByTag(app_id, component_type, tag, auth, version) {
+        try {
+            const { public_key, user_id } = auth;
+            const key = version
+                ? `app-component-${app_id}-${component_type}-${tag}-${version}`
+                : `app-component-${app_id}-${component_type}-${tag}-latest`;
+            if (this.redisClient) {
+                const res = await (0, cache_utils_1.FetchApiCache)(key, this.redisClient);
+                if (res)
+                    return res;
+            }
+            let URL = `/components/${app_id}/${component_type}/${tag}`;
+            if (version) {
+                URL += `?version=${version}&user_id=${user_id}&public_key=${public_key}`;
+            }
+            else {
+                URL += `?user_id=${user_id}&public_key=${public_key}`;
+            }
+            const res = await (0, apps_client_1.default)(this.environment).get(URL);
+            if (this.redisClient) {
+                (0, cache_utils_1.WriteApiCache)(key, res.data.data, this.redisClient, 300); // Cache for 5 minutes
+            }
+            return res.data.data;
+        }
+        catch (e) {
+            throw e;
+        }
+    }
+    /**
+     * Initialize app - fetch minimal app data (optimized for speed)
+     * Returns _id, tag, private_key, and versions array with minimal fields
+     * @param id - Either the app tag or _id
+     * @param auth - Optional authentication credentials
+     * @returns Object with _id, tag, private_key, and versions array
+     */
+    async initApp(id, auth) {
+        try {
+            const key = auth
+                ? `app-init-${id}-${auth.workspace_id}`
+                : `app-init-${id}`;
+            if (this.redisClient) {
+                const res = await (0, cache_utils_1.FetchApiCache)(key, this.redisClient);
+                if (res)
+                    return res;
+            }
+            const URL = `/apps/v1/init/${id}`;
+            const config = auth ? (0, auth_utils_1.generateAxiosConfig)(auth.token, types_1.DataFormats.JSON) : undefined;
+            const res = await (0, apps_client_1.default)(this.environment).get(URL, config);
+            if (this.redisClient) {
+                (0, cache_utils_1.WriteApiCache)(key, res.data.data, this.redisClient, 300); // Cache for 5 minutes
+            }
+            return res.data.data;
+        }
+        catch (e) {
+            throw e;
+        }
+    }
 }
 exports.AppApiService = AppApiService;
 //# sourceMappingURL=appApi.service.js.map