@yuva-devlab/sdk 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Yuva Devlab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,202 @@
+'use strict';
+
+var agentCore = require('@yuva-devlab/agent-core');
+var aiClient = require('@yuva-devlab/ai-client');
+var billing = require('@yuva-devlab/billing');
+var events = require('@yuva-devlab/events');
+var logger$1 = require('@yuva-devlab/logger');
+var rag = require('@yuva-devlab/rag');
+var semanticCache = require('@yuva-devlab/semantic-cache');
+var errors = require('@yuva-devlab/errors');
+var resilience = require('@yuva-devlab/resilience');
+
+// src/constants/sdk.constants.ts
+var DEFAULT_CLIENT_TIMEOUT_MS = 3e4;
+var DEFAULT_GATEWAY_URL = "http://localhost:3000";
+var SDK_VERSION = "0.1.0";
+var logger = logger$1.loggerWithConfig(new logger$1.Logger("DevLabClient"));
+var DevLabClient = class {
+  ai;
+  embedder;
+  cache;
+  tools;
+  vectorStore;
+  chunker;
+  events;
+  billing;
+  gatewayUrl;
+  tenantId;
+  timeoutMs;
+  /**
+   * Initializes the unified DevLab platform client.
+   *
+   * @param config - Platform client options
+   */
+  constructor(config = {}) {
+    this.gatewayUrl = config.gatewayUrl ?? DEFAULT_GATEWAY_URL;
+    this.tenantId = config.tenantId;
+    this.timeoutMs = config.timeoutMs ?? DEFAULT_CLIENT_TIMEOUT_MS;
+    this.ai = config.aiProvider ?? aiClient.createDefaultProvider();
+    this.embedder = config.embeddingProvider ?? new rag.MockEmbeddingProvider();
+    this.chunker = new rag.TextChunker();
+    this.vectorStore = new rag.InMemoryVectorStore(this.embedder);
+    this.cache = new semanticCache.SemanticCache(this.embedder);
+    this.tools = new agentCore.ToolRegistry();
+    const pricing = new billing.DynamicPricingResolver({
+      loader: config.pricingLoader
+    });
+    const ledger = new billing.CostLedger();
+    const enforcer = new billing.BudgetEnforcer(ledger);
+    const counter = new billing.TokenCounter({ pricingResolver: pricing });
+    this.billing = { counter, ledger, enforcer, pricing };
+    this.events = config.eventBus ?? new events.InMemoryEventBus();
+    logger.debug("[constructor] DevLabClient initialized", {
+      gatewayUrl: this.gatewayUrl,
+      tenantId: this.tenantId
+    });
+  }
+  /**
+   * Completes an LLM prompt request.
+   *
+   * @param request - LLM completion request
+   * @returns Model response
+   */
+  async complete(request) {
+    logger.debug("[complete] Executing AI completion via unified client", {
+      model: request.model
+    });
+    return this.ai.complete(request);
+  }
+  /**
+   * Streams token chunks incrementally.
+   *
+   * @param request - LLM completion request
+   * @returns Async iterable yielding token deltas
+   */
+  async *stream(request) {
+    yield* this.ai.stream(request);
+  }
+  /**
+   * Executes a vector similarity search across ingested document chunks.
+   *
+   * @param query - Search parameters
+   * @returns Scored document chunks
+   */
+  async search(query) {
+    logger.debug("[search] Executing RAG search via unified client", {
+      query: query.query
+    });
+    return this.vectorStore.search(query);
+  }
+  /**
+   * Executes a registered agent tool by name.
+   *
+   * @param toolName - Registered tool slug
+   * @param input - Tool input arguments
+   * @param ctx - Tool execution context
+   * @returns Tool execution result
+   */
+  async executeTool(toolName, input, ctx) {
+    logger.debug("[executeTool] Executing registered tool", { toolName });
+    const tool = this.tools.getOrThrow(toolName);
+    return tool.execute(input, {
+      executionId: ctx.executionId,
+      tenantId: ctx.tenantId ?? this.tenantId
+    });
+  }
+  /**
+   * Helper to compile a system prompt with tool documentation.
+   */
+  compilePrompt(template, variables = {}) {
+    return agentCore.compilePrompt({
+      template,
+      variables,
+      tools: this.tools.listAll()
+    });
+  }
+};
+
+Object.defineProperty(exports, "CreateChunkInputSchema", {
+  enumerable: true,
+  get: function () { return rag.CreateChunkInputSchema; }
+});
+Object.defineProperty(exports, "CreateDocumentInputSchema", {
+  enumerable: true,
+  get: function () { return rag.CreateDocumentInputSchema; }
+});
+Object.defineProperty(exports, "DocumentChunkSchema", {
+  enumerable: true,
+  get: function () { return rag.DocumentChunkSchema; }
+});
+Object.defineProperty(exports, "DocumentSchema", {
+  enumerable: true,
+  get: function () { return rag.DocumentSchema; }
+});
+Object.defineProperty(exports, "InMemoryVectorStore", {
+  enumerable: true,
+  get: function () { return rag.InMemoryVectorStore; }
+});
+Object.defineProperty(exports, "MockEmbeddingProvider", {
+  enumerable: true,
+  get: function () { return rag.MockEmbeddingProvider; }
+});
+Object.defineProperty(exports, "RagQuerySchema", {
+  enumerable: true,
+  get: function () { return rag.RagQuerySchema; }
+});
+Object.defineProperty(exports, "TextChunker", {
+  enumerable: true,
+  get: function () { return rag.TextChunker; }
+});
+Object.defineProperty(exports, "estimateTokenCount", {
+  enumerable: true,
+  get: function () { return rag.estimateTokenCount; }
+});
+exports.DEFAULT_CLIENT_TIMEOUT_MS = DEFAULT_CLIENT_TIMEOUT_MS;
+exports.DEFAULT_GATEWAY_URL = DEFAULT_GATEWAY_URL;
+exports.DevLabClient = DevLabClient;
+exports.SDK_VERSION = SDK_VERSION;
+Object.keys(agentCore).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return agentCore[k]; }
+  });
+});
+Object.keys(aiClient).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return aiClient[k]; }
+  });
+});
+Object.keys(billing).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return billing[k]; }
+  });
+});
+Object.keys(events).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return events[k]; }
+  });
+});
+Object.keys(semanticCache).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return semanticCache[k]; }
+  });
+});
+Object.keys(errors).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return errors[k]; }
+  });
+});
+Object.keys(resilience).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return resilience[k]; }
+  });
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants/sdk.constants.ts","../src/client/devlab-client.ts"],"names":["loggerWithConfig","Logger","createDefaultProvider","MockEmbeddingProvider","TextChunker","InMemoryVectorStore","SemanticCache","ToolRegistry","DynamicPricingResolver","CostLedger","BudgetEnforcer","TokenCounter","InMemoryEventBus","compilePrompt"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @file packages/sdk/src/constants/sdk.constants.ts\n * @description Operational constants and default endpoints for the master DevLab client.\n * @module @yuva-devlab/sdk\n */\n\n/** Default client request timeout in milliseconds (30 seconds) */\nexport const DEFAULT_CLIENT_TIMEOUT_MS = 30_000;\n\n/** Default local gateway API base URL */\nexport const DEFAULT_GATEWAY_URL = \"http://localhost:3000\";\n\n/** Current SDK distribution version */\nexport const SDK_VERSION = \"0.1.0\";\n","/**\n * @file packages/sdk/src/client/devlab-client.ts\n * @description Master DevLab platform client unifying AI, RAG, swarms, billing, caching, and events.\n * @module @yuva-devlab/sdk\n */\n\nimport {\n  ToolRegistry,\n  compilePrompt,\n  type UniversalTool,\n} from \"@yuva-devlab/agent-core\";\nimport {\n  createDefaultProvider,\n  type ILLMProvider,\n  type LLMRequest,\n  type LLMResponse,\n  type LLMStreamChunk,\n} from \"@yuva-devlab/ai-client\";\nimport {\n  BudgetEnforcer,\n  CostLedger,\n  DynamicPricingResolver,\n  TokenCounter,\n} from \"@yuva-devlab/billing\";\nimport { InMemoryEventBus, type IEventBus } from \"@yuva-devlab/events\";\nimport { Logger, loggerWithConfig } from \"@yuva-devlab/logger\";\nimport {\n  InMemoryVectorStore,\n  MockEmbeddingProvider,\n  TextChunker,\n  type IEmbeddingProvider,\n  type RagQuery,\n  type RagSearchResult,\n} from \"@yuva-devlab/rag\";\nimport { SemanticCache } from \"@yuva-devlab/semantic-cache\";\nimport { DEFAULT_CLIENT_TIMEOUT_MS, DEFAULT_GATEWAY_URL } from \"../constants\";\nimport type { DevLabClientConfig } from \"../types\";\n\nconst logger = loggerWithConfig(new Logger(\"DevLabClient\"));\n\n/**\n * Master client providing unified access to the complete DevLab platform capabilities.\n *\n * @example\n * ```typescript\n * import { DevLabClient } from \"@yuva-devlab/sdk\";\n *\n * const client = new DevLabClient({ apiKey: \"dlk_...\" });\n * const response = await client.complete({\n *   model: \"gemini-2.5-flash\",\n *   messages: [{ role: \"user\", content: \"Hello!\" }],\n * });\n * ```\n */\nexport class DevLabClient {\n  public readonly ai: ILLMProvider;\n  public readonly embedder: IEmbeddingProvider;\n  public readonly cache: SemanticCache;\n  public readonly tools: ToolRegistry;\n  public readonly vectorStore: InMemoryVectorStore;\n  public readonly chunker: TextChunker;\n  public readonly events: IEventBus;\n  public readonly billing: {\n    readonly counter: TokenCounter;\n    readonly ledger: CostLedger;\n    readonly enforcer: BudgetEnforcer;\n    readonly pricing: DynamicPricingResolver;\n  };\n\n  public readonly gatewayUrl: string;\n  public readonly tenantId?: string;\n  public readonly timeoutMs: number;\n\n  /**\n   * Initializes the unified DevLab platform client.\n   *\n   * @param config - Platform client options\n   */\n  public constructor(config: DevLabClientConfig = {}) {\n    this.gatewayUrl = config.gatewayUrl ?? DEFAULT_GATEWAY_URL;\n    this.tenantId = config.tenantId;\n    this.timeoutMs = config.timeoutMs ?? DEFAULT_CLIENT_TIMEOUT_MS;\n\n    // 1. Initialize AI inference\n    this.ai = config.aiProvider ?? createDefaultProvider();\n\n    // 2. Initialize Embeddings & Vector RAG\n    this.embedder = config.embeddingProvider ?? new MockEmbeddingProvider();\n    this.chunker = new TextChunker();\n    this.vectorStore = new InMemoryVectorStore(this.embedder);\n\n    // 3. Initialize Semantic Caching\n    this.cache = new SemanticCache(this.embedder);\n\n    // 4. Initialize Agent Tool Registry\n    this.tools = new ToolRegistry();\n\n    // 5. Initialize Server-Driven Billing & Metering\n    const pricing = new DynamicPricingResolver({\n      loader: config.pricingLoader,\n    });\n    const ledger = new CostLedger();\n    const enforcer = new BudgetEnforcer(ledger);\n    const counter = new TokenCounter({ pricingResolver: pricing });\n    this.billing = { counter, ledger, enforcer, pricing };\n\n    // 6. Initialize Distributed Event Bus\n    this.events = config.eventBus ?? new InMemoryEventBus();\n\n    logger.debug(\"[constructor] DevLabClient initialized\", {\n      gatewayUrl: this.gatewayUrl,\n      tenantId: this.tenantId,\n    });\n  }\n\n  /**\n   * Completes an LLM prompt request.\n   *\n   * @param request - LLM completion request\n   * @returns Model response\n   */\n  public async complete(request: LLMRequest): Promise<LLMResponse> {\n    logger.debug(\"[complete] Executing AI completion via unified client\", {\n      model: request.model,\n    });\n    return this.ai.complete(request);\n  }\n\n  /**\n   * Streams token chunks incrementally.\n   *\n   * @param request - LLM completion request\n   * @returns Async iterable yielding token deltas\n   */\n  public async *stream(request: LLMRequest): AsyncIterable<LLMStreamChunk> {\n    yield* this.ai.stream(request);\n  }\n\n  /**\n   * Executes a vector similarity search across ingested document chunks.\n   *\n   * @param query - Search parameters\n   * @returns Scored document chunks\n   */\n  public async search(query: RagQuery): Promise<RagSearchResult> {\n    logger.debug(\"[search] Executing RAG search via unified client\", {\n      query: query.query,\n    });\n    return this.vectorStore.search(query);\n  }\n\n  /**\n   * Executes a registered agent tool by name.\n   *\n   * @param toolName - Registered tool slug\n   * @param input - Tool input arguments\n   * @param ctx - Tool execution context\n   * @returns Tool execution result\n   */\n  public async executeTool<TInput = unknown, TOutput = unknown>(\n    toolName: string,\n    input: TInput,\n    ctx: { executionId: string; tenantId?: string },\n  ): Promise<TOutput> {\n    logger.debug(\"[executeTool] Executing registered tool\", { toolName });\n    const tool = this.tools.getOrThrow(toolName) as UniversalTool<\n      TInput,\n      TOutput\n    >;\n    return tool.execute(input, {\n      executionId: ctx.executionId,\n      tenantId: ctx.tenantId ?? this.tenantId,\n    });\n  }\n\n  /**\n   * Helper to compile a system prompt with tool documentation.\n   */\n  public compilePrompt(\n    template: string,\n    variables: Record<string, unknown> = {},\n  ): string {\n    return compilePrompt({\n      template,\n      variables,\n      tools: this.tools.listAll(),\n    });\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,140 @@
+import { ILLMProvider, LLMRequest, LLMResponse, LLMStreamChunk } from '@yuva-devlab/ai-client';
+export * from '@yuva-devlab/ai-client';
+import { PricingLoaderFn, TokenCounter, CostLedger, BudgetEnforcer, DynamicPricingResolver } from '@yuva-devlab/billing';
+export * from '@yuva-devlab/billing';
+import { IEventBus } from '@yuva-devlab/events';
+export * from '@yuva-devlab/events';
+import { IEmbeddingProvider, InMemoryVectorStore, TextChunker, RagQuery, RagSearchResult } from '@yuva-devlab/rag';
+export { ChunkingOptions, CreateChunkInput, CreateChunkInputSchema, CreateDocumentInput, CreateDocumentInputSchema, Document, DocumentChunk, DocumentChunkSchema, DocumentSchema, ITextChunker, InMemoryVectorStore, MockEmbeddingProvider, RagQuery, RagQuerySchema, RagSearchResult, ScoredDocumentChunk, TextChunker, estimateTokenCount } from '@yuva-devlab/rag';
+import { ToolRegistry } from '@yuva-devlab/agent-core';
+export * from '@yuva-devlab/agent-core';
+import { SemanticCache } from '@yuva-devlab/semantic-cache';
+export * from '@yuva-devlab/semantic-cache';
+export * from '@yuva-devlab/errors';
+export * from '@yuva-devlab/resilience';
+
+/**
+ * @file packages/sdk/src/constants/sdk.constants.ts
+ * @description Operational constants and default endpoints for the master DevLab client.
+ * @module @yuva-devlab/sdk
+ */
+/** Default client request timeout in milliseconds (30 seconds) */
+declare const DEFAULT_CLIENT_TIMEOUT_MS = 30000;
+/** Default local gateway API base URL */
+declare const DEFAULT_GATEWAY_URL = "http://localhost:3000";
+/** Current SDK distribution version */
+declare const SDK_VERSION = "0.1.0";
+
+/**
+ * @file packages/sdk/src/types/client.types.ts
+ * @description Configuration and options for the unified DevLabClient platform SDK.
+ * @module @yuva-devlab/sdk
+ */
+
+/**
+ * Configuration options for initializing the master DevLabClient.
+ */
+interface DevLabClientConfig {
+    /** Optional machine API key for authenticating with the DevLab Gateway */
+    readonly apiKey?: string;
+    /** Optional gateway base URL (defaults to DEFAULT_GATEWAY_URL) */
+    readonly gatewayUrl?: string;
+    /** Unique platform application slug (e.g. "finai", "orchestrai") */
+    readonly appId?: string;
+    /** Tenant isolation partition ID */
+    readonly tenantId?: string;
+    /** Custom LLM provider adapter override */
+    readonly aiProvider?: ILLMProvider;
+    /** Custom vector embedding provider override */
+    readonly embeddingProvider?: IEmbeddingProvider;
+    /** Custom domain event bus instance */
+    readonly eventBus?: IEventBus;
+    /** Remote pricing loader callback */
+    readonly pricingLoader?: PricingLoaderFn;
+    /** Global request timeout in milliseconds */
+    readonly timeoutMs?: number;
+}
+
+/**
+ * @file packages/sdk/src/client/devlab-client.ts
+ * @description Master DevLab platform client unifying AI, RAG, swarms, billing, caching, and events.
+ * @module @yuva-devlab/sdk
+ */
+
+/**
+ * Master client providing unified access to the complete DevLab platform capabilities.
+ *
+ * @example
+ * ```typescript
+ * import { DevLabClient } from "@yuva-devlab/sdk";
+ *
+ * const client = new DevLabClient({ apiKey: "dlk_..." });
+ * const response = await client.complete({
+ *   model: "gemini-2.5-flash",
+ *   messages: [{ role: "user", content: "Hello!" }],
+ * });
+ * ```
+ */
+declare class DevLabClient {
+    readonly ai: ILLMProvider;
+    readonly embedder: IEmbeddingProvider;
+    readonly cache: SemanticCache;
+    readonly tools: ToolRegistry;
+    readonly vectorStore: InMemoryVectorStore;
+    readonly chunker: TextChunker;
+    readonly events: IEventBus;
+    readonly billing: {
+        readonly counter: TokenCounter;
+        readonly ledger: CostLedger;
+        readonly enforcer: BudgetEnforcer;
+        readonly pricing: DynamicPricingResolver;
+    };
+    readonly gatewayUrl: string;
+    readonly tenantId?: string;
+    readonly timeoutMs: number;
+    /**
+     * Initializes the unified DevLab platform client.
+     *
+     * @param config - Platform client options
+     */
+    constructor(config?: DevLabClientConfig);
+    /**
+     * Completes an LLM prompt request.
+     *
+     * @param request - LLM completion request
+     * @returns Model response
+     */
+    complete(request: LLMRequest): Promise<LLMResponse>;
+    /**
+     * Streams token chunks incrementally.
+     *
+     * @param request - LLM completion request
+     * @returns Async iterable yielding token deltas
+     */
+    stream(request: LLMRequest): AsyncIterable<LLMStreamChunk>;
+    /**
+     * Executes a vector similarity search across ingested document chunks.
+     *
+     * @param query - Search parameters
+     * @returns Scored document chunks
+     */
+    search(query: RagQuery): Promise<RagSearchResult>;
+    /**
+     * Executes a registered agent tool by name.
+     *
+     * @param toolName - Registered tool slug
+     * @param input - Tool input arguments
+     * @param ctx - Tool execution context
+     * @returns Tool execution result
+     */
+    executeTool<TInput = unknown, TOutput = unknown>(toolName: string, input: TInput, ctx: {
+        executionId: string;
+        tenantId?: string;
+    }): Promise<TOutput>;
+    /**
+     * Helper to compile a system prompt with tool documentation.
+     */
+    compilePrompt(template: string, variables?: Record<string, unknown>): string;
+}
+
+export { DEFAULT_CLIENT_TIMEOUT_MS, DEFAULT_GATEWAY_URL, DevLabClient, type DevLabClientConfig, SDK_VERSION };

package/dist/index.d.ts

@@ -0,0 +1,140 @@
+import { ILLMProvider, LLMRequest, LLMResponse, LLMStreamChunk } from '@yuva-devlab/ai-client';
+export * from '@yuva-devlab/ai-client';
+import { PricingLoaderFn, TokenCounter, CostLedger, BudgetEnforcer, DynamicPricingResolver } from '@yuva-devlab/billing';
+export * from '@yuva-devlab/billing';
+import { IEventBus } from '@yuva-devlab/events';
+export * from '@yuva-devlab/events';
+import { IEmbeddingProvider, InMemoryVectorStore, TextChunker, RagQuery, RagSearchResult } from '@yuva-devlab/rag';
+export { ChunkingOptions, CreateChunkInput, CreateChunkInputSchema, CreateDocumentInput, CreateDocumentInputSchema, Document, DocumentChunk, DocumentChunkSchema, DocumentSchema, ITextChunker, InMemoryVectorStore, MockEmbeddingProvider, RagQuery, RagQuerySchema, RagSearchResult, ScoredDocumentChunk, TextChunker, estimateTokenCount } from '@yuva-devlab/rag';
+import { ToolRegistry } from '@yuva-devlab/agent-core';
+export * from '@yuva-devlab/agent-core';
+import { SemanticCache } from '@yuva-devlab/semantic-cache';
+export * from '@yuva-devlab/semantic-cache';
+export * from '@yuva-devlab/errors';
+export * from '@yuva-devlab/resilience';
+
+/**
+ * @file packages/sdk/src/constants/sdk.constants.ts
+ * @description Operational constants and default endpoints for the master DevLab client.
+ * @module @yuva-devlab/sdk
+ */
+/** Default client request timeout in milliseconds (30 seconds) */
+declare const DEFAULT_CLIENT_TIMEOUT_MS = 30000;
+/** Default local gateway API base URL */
+declare const DEFAULT_GATEWAY_URL = "http://localhost:3000";
+/** Current SDK distribution version */
+declare const SDK_VERSION = "0.1.0";
+
+/**
+ * @file packages/sdk/src/types/client.types.ts
+ * @description Configuration and options for the unified DevLabClient platform SDK.
+ * @module @yuva-devlab/sdk
+ */
+
+/**
+ * Configuration options for initializing the master DevLabClient.
+ */
+interface DevLabClientConfig {
+    /** Optional machine API key for authenticating with the DevLab Gateway */
+    readonly apiKey?: string;
+    /** Optional gateway base URL (defaults to DEFAULT_GATEWAY_URL) */
+    readonly gatewayUrl?: string;
+    /** Unique platform application slug (e.g. "finai", "orchestrai") */
+    readonly appId?: string;
+    /** Tenant isolation partition ID */
+    readonly tenantId?: string;
+    /** Custom LLM provider adapter override */
+    readonly aiProvider?: ILLMProvider;
+    /** Custom vector embedding provider override */
+    readonly embeddingProvider?: IEmbeddingProvider;
+    /** Custom domain event bus instance */
+    readonly eventBus?: IEventBus;
+    /** Remote pricing loader callback */
+    readonly pricingLoader?: PricingLoaderFn;
+    /** Global request timeout in milliseconds */
+    readonly timeoutMs?: number;
+}
+
+/**
+ * @file packages/sdk/src/client/devlab-client.ts
+ * @description Master DevLab platform client unifying AI, RAG, swarms, billing, caching, and events.
+ * @module @yuva-devlab/sdk
+ */
+
+/**
+ * Master client providing unified access to the complete DevLab platform capabilities.
+ *
+ * @example
+ * ```typescript
+ * import { DevLabClient } from "@yuva-devlab/sdk";
+ *
+ * const client = new DevLabClient({ apiKey: "dlk_..." });
+ * const response = await client.complete({
+ *   model: "gemini-2.5-flash",
+ *   messages: [{ role: "user", content: "Hello!" }],
+ * });
+ * ```
+ */
+declare class DevLabClient {
+    readonly ai: ILLMProvider;
+    readonly embedder: IEmbeddingProvider;
+    readonly cache: SemanticCache;
+    readonly tools: ToolRegistry;
+    readonly vectorStore: InMemoryVectorStore;
+    readonly chunker: TextChunker;
+    readonly events: IEventBus;
+    readonly billing: {
+        readonly counter: TokenCounter;
+        readonly ledger: CostLedger;
+        readonly enforcer: BudgetEnforcer;
+        readonly pricing: DynamicPricingResolver;
+    };
+    readonly gatewayUrl: string;
+    readonly tenantId?: string;
+    readonly timeoutMs: number;
+    /**
+     * Initializes the unified DevLab platform client.
+     *
+     * @param config - Platform client options
+     */
+    constructor(config?: DevLabClientConfig);
+    /**
+     * Completes an LLM prompt request.
+     *
+     * @param request - LLM completion request
+     * @returns Model response
+     */
+    complete(request: LLMRequest): Promise<LLMResponse>;
+    /**
+     * Streams token chunks incrementally.
+     *
+     * @param request - LLM completion request
+     * @returns Async iterable yielding token deltas
+     */
+    stream(request: LLMRequest): AsyncIterable<LLMStreamChunk>;
+    /**
+     * Executes a vector similarity search across ingested document chunks.
+     *
+     * @param query - Search parameters
+     * @returns Scored document chunks
+     */
+    search(query: RagQuery): Promise<RagSearchResult>;
+    /**
+     * Executes a registered agent tool by name.
+     *
+     * @param toolName - Registered tool slug
+     * @param input - Tool input arguments
+     * @param ctx - Tool execution context
+     * @returns Tool execution result
+     */
+    executeTool<TInput = unknown, TOutput = unknown>(toolName: string, input: TInput, ctx: {
+        executionId: string;
+        tenantId?: string;
+    }): Promise<TOutput>;
+    /**
+     * Helper to compile a system prompt with tool documentation.
+     */
+    compilePrompt(template: string, variables?: Record<string, unknown>): string;
+}
+
+export { DEFAULT_CLIENT_TIMEOUT_MS, DEFAULT_GATEWAY_URL, DevLabClient, type DevLabClientConfig, SDK_VERSION };

package/dist/index.js

@@ -0,0 +1,125 @@
+import { ToolRegistry, compilePrompt } from '@yuva-devlab/agent-core';
+export * from '@yuva-devlab/agent-core';
+import { createDefaultProvider } from '@yuva-devlab/ai-client';
+export * from '@yuva-devlab/ai-client';
+import { DynamicPricingResolver, CostLedger, BudgetEnforcer, TokenCounter } from '@yuva-devlab/billing';
+export * from '@yuva-devlab/billing';
+import { InMemoryEventBus } from '@yuva-devlab/events';
+export * from '@yuva-devlab/events';
+import { loggerWithConfig, Logger } from '@yuva-devlab/logger';
+import { MockEmbeddingProvider, TextChunker, InMemoryVectorStore } from '@yuva-devlab/rag';
+export { CreateChunkInputSchema, CreateDocumentInputSchema, DocumentChunkSchema, DocumentSchema, InMemoryVectorStore, MockEmbeddingProvider, RagQuerySchema, TextChunker, estimateTokenCount } from '@yuva-devlab/rag';
+import { SemanticCache } from '@yuva-devlab/semantic-cache';
+export * from '@yuva-devlab/semantic-cache';
+export * from '@yuva-devlab/errors';
+export * from '@yuva-devlab/resilience';
+
+// src/constants/sdk.constants.ts
+var DEFAULT_CLIENT_TIMEOUT_MS = 3e4;
+var DEFAULT_GATEWAY_URL = "http://localhost:3000";
+var SDK_VERSION = "0.1.0";
+var logger = loggerWithConfig(new Logger("DevLabClient"));
+var DevLabClient = class {
+  ai;
+  embedder;
+  cache;
+  tools;
+  vectorStore;
+  chunker;
+  events;
+  billing;
+  gatewayUrl;
+  tenantId;
+  timeoutMs;
+  /**
+   * Initializes the unified DevLab platform client.
+   *
+   * @param config - Platform client options
+   */
+  constructor(config = {}) {
+    this.gatewayUrl = config.gatewayUrl ?? DEFAULT_GATEWAY_URL;
+    this.tenantId = config.tenantId;
+    this.timeoutMs = config.timeoutMs ?? DEFAULT_CLIENT_TIMEOUT_MS;
+    this.ai = config.aiProvider ?? createDefaultProvider();
+    this.embedder = config.embeddingProvider ?? new MockEmbeddingProvider();
+    this.chunker = new TextChunker();
+    this.vectorStore = new InMemoryVectorStore(this.embedder);
+    this.cache = new SemanticCache(this.embedder);
+    this.tools = new ToolRegistry();
+    const pricing = new DynamicPricingResolver({
+      loader: config.pricingLoader
+    });
+    const ledger = new CostLedger();
+    const enforcer = new BudgetEnforcer(ledger);
+    const counter = new TokenCounter({ pricingResolver: pricing });
+    this.billing = { counter, ledger, enforcer, pricing };
+    this.events = config.eventBus ?? new InMemoryEventBus();
+    logger.debug("[constructor] DevLabClient initialized", {
+      gatewayUrl: this.gatewayUrl,
+      tenantId: this.tenantId
+    });
+  }
+  /**
+   * Completes an LLM prompt request.
+   *
+   * @param request - LLM completion request
+   * @returns Model response
+   */
+  async complete(request) {
+    logger.debug("[complete] Executing AI completion via unified client", {
+      model: request.model
+    });
+    return this.ai.complete(request);
+  }
+  /**
+   * Streams token chunks incrementally.
+   *
+   * @param request - LLM completion request
+   * @returns Async iterable yielding token deltas
+   */
+  async *stream(request) {
+    yield* this.ai.stream(request);
+  }
+  /**
+   * Executes a vector similarity search across ingested document chunks.
+   *
+   * @param query - Search parameters
+   * @returns Scored document chunks
+   */
+  async search(query) {
+    logger.debug("[search] Executing RAG search via unified client", {
+      query: query.query
+    });
+    return this.vectorStore.search(query);
+  }
+  /**
+   * Executes a registered agent tool by name.
+   *
+   * @param toolName - Registered tool slug
+   * @param input - Tool input arguments
+   * @param ctx - Tool execution context
+   * @returns Tool execution result
+   */
+  async executeTool(toolName, input, ctx) {
+    logger.debug("[executeTool] Executing registered tool", { toolName });
+    const tool = this.tools.getOrThrow(toolName);
+    return tool.execute(input, {
+      executionId: ctx.executionId,
+      tenantId: ctx.tenantId ?? this.tenantId
+    });
+  }
+  /**
+   * Helper to compile a system prompt with tool documentation.
+   */
+  compilePrompt(template, variables = {}) {
+    return compilePrompt({
+      template,
+      variables,
+      tools: this.tools.listAll()
+    });
+  }
+};
+
+export { DEFAULT_CLIENT_TIMEOUT_MS, DEFAULT_GATEWAY_URL, DevLabClient, SDK_VERSION };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants/sdk.constants.ts","../src/client/devlab-client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @file packages/sdk/src/constants/sdk.constants.ts\n * @description Operational constants and default endpoints for the master DevLab client.\n * @module @yuva-devlab/sdk\n */\n\n/** Default client request timeout in milliseconds (30 seconds) */\nexport const DEFAULT_CLIENT_TIMEOUT_MS = 30_000;\n\n/** Default local gateway API base URL */\nexport const DEFAULT_GATEWAY_URL = \"http://localhost:3000\";\n\n/** Current SDK distribution version */\nexport const SDK_VERSION = \"0.1.0\";\n","/**\n * @file packages/sdk/src/client/devlab-client.ts\n * @description Master DevLab platform client unifying AI, RAG, swarms, billing, caching, and events.\n * @module @yuva-devlab/sdk\n */\n\nimport {\n  ToolRegistry,\n  compilePrompt,\n  type UniversalTool,\n} from \"@yuva-devlab/agent-core\";\nimport {\n  createDefaultProvider,\n  type ILLMProvider,\n  type LLMRequest,\n  type LLMResponse,\n  type LLMStreamChunk,\n} from \"@yuva-devlab/ai-client\";\nimport {\n  BudgetEnforcer,\n  CostLedger,\n  DynamicPricingResolver,\n  TokenCounter,\n} from \"@yuva-devlab/billing\";\nimport { InMemoryEventBus, type IEventBus } from \"@yuva-devlab/events\";\nimport { Logger, loggerWithConfig } from \"@yuva-devlab/logger\";\nimport {\n  InMemoryVectorStore,\n  MockEmbeddingProvider,\n  TextChunker,\n  type IEmbeddingProvider,\n  type RagQuery,\n  type RagSearchResult,\n} from \"@yuva-devlab/rag\";\nimport { SemanticCache } from \"@yuva-devlab/semantic-cache\";\nimport { DEFAULT_CLIENT_TIMEOUT_MS, DEFAULT_GATEWAY_URL } from \"../constants\";\nimport type { DevLabClientConfig } from \"../types\";\n\nconst logger = loggerWithConfig(new Logger(\"DevLabClient\"));\n\n/**\n * Master client providing unified access to the complete DevLab platform capabilities.\n *\n * @example\n * ```typescript\n * import { DevLabClient } from \"@yuva-devlab/sdk\";\n *\n * const client = new DevLabClient({ apiKey: \"dlk_...\" });\n * const response = await client.complete({\n *   model: \"gemini-2.5-flash\",\n *   messages: [{ role: \"user\", content: \"Hello!\" }],\n * });\n * ```\n */\nexport class DevLabClient {\n  public readonly ai: ILLMProvider;\n  public readonly embedder: IEmbeddingProvider;\n  public readonly cache: SemanticCache;\n  public readonly tools: ToolRegistry;\n  public readonly vectorStore: InMemoryVectorStore;\n  public readonly chunker: TextChunker;\n  public readonly events: IEventBus;\n  public readonly billing: {\n    readonly counter: TokenCounter;\n    readonly ledger: CostLedger;\n    readonly enforcer: BudgetEnforcer;\n    readonly pricing: DynamicPricingResolver;\n  };\n\n  public readonly gatewayUrl: string;\n  public readonly tenantId?: string;\n  public readonly timeoutMs: number;\n\n  /**\n   * Initializes the unified DevLab platform client.\n   *\n   * @param config - Platform client options\n   */\n  public constructor(config: DevLabClientConfig = {}) {\n    this.gatewayUrl = config.gatewayUrl ?? DEFAULT_GATEWAY_URL;\n    this.tenantId = config.tenantId;\n    this.timeoutMs = config.timeoutMs ?? DEFAULT_CLIENT_TIMEOUT_MS;\n\n    // 1. Initialize AI inference\n    this.ai = config.aiProvider ?? createDefaultProvider();\n\n    // 2. Initialize Embeddings & Vector RAG\n    this.embedder = config.embeddingProvider ?? new MockEmbeddingProvider();\n    this.chunker = new TextChunker();\n    this.vectorStore = new InMemoryVectorStore(this.embedder);\n\n    // 3. Initialize Semantic Caching\n    this.cache = new SemanticCache(this.embedder);\n\n    // 4. Initialize Agent Tool Registry\n    this.tools = new ToolRegistry();\n\n    // 5. Initialize Server-Driven Billing & Metering\n    const pricing = new DynamicPricingResolver({\n      loader: config.pricingLoader,\n    });\n    const ledger = new CostLedger();\n    const enforcer = new BudgetEnforcer(ledger);\n    const counter = new TokenCounter({ pricingResolver: pricing });\n    this.billing = { counter, ledger, enforcer, pricing };\n\n    // 6. Initialize Distributed Event Bus\n    this.events = config.eventBus ?? new InMemoryEventBus();\n\n    logger.debug(\"[constructor] DevLabClient initialized\", {\n      gatewayUrl: this.gatewayUrl,\n      tenantId: this.tenantId,\n    });\n  }\n\n  /**\n   * Completes an LLM prompt request.\n   *\n   * @param request - LLM completion request\n   * @returns Model response\n   */\n  public async complete(request: LLMRequest): Promise<LLMResponse> {\n    logger.debug(\"[complete] Executing AI completion via unified client\", {\n      model: request.model,\n    });\n    return this.ai.complete(request);\n  }\n\n  /**\n   * Streams token chunks incrementally.\n   *\n   * @param request - LLM completion request\n   * @returns Async iterable yielding token deltas\n   */\n  public async *stream(request: LLMRequest): AsyncIterable<LLMStreamChunk> {\n    yield* this.ai.stream(request);\n  }\n\n  /**\n   * Executes a vector similarity search across ingested document chunks.\n   *\n   * @param query - Search parameters\n   * @returns Scored document chunks\n   */\n  public async search(query: RagQuery): Promise<RagSearchResult> {\n    logger.debug(\"[search] Executing RAG search via unified client\", {\n      query: query.query,\n    });\n    return this.vectorStore.search(query);\n  }\n\n  /**\n   * Executes a registered agent tool by name.\n   *\n   * @param toolName - Registered tool slug\n   * @param input - Tool input arguments\n   * @param ctx - Tool execution context\n   * @returns Tool execution result\n   */\n  public async executeTool<TInput = unknown, TOutput = unknown>(\n    toolName: string,\n    input: TInput,\n    ctx: { executionId: string; tenantId?: string },\n  ): Promise<TOutput> {\n    logger.debug(\"[executeTool] Executing registered tool\", { toolName });\n    const tool = this.tools.getOrThrow(toolName) as UniversalTool<\n      TInput,\n      TOutput\n    >;\n    return tool.execute(input, {\n      executionId: ctx.executionId,\n      tenantId: ctx.tenantId ?? this.tenantId,\n    });\n  }\n\n  /**\n   * Helper to compile a system prompt with tool documentation.\n   */\n  public compilePrompt(\n    template: string,\n    variables: Record<string, unknown> = {},\n  ): string {\n    return compilePrompt({\n      template,\n      variables,\n      tools: this.tools.listAll(),\n    });\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@yuva-devlab/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Unified Master DevLab Platform Client combining AI inference, RAG, swarms, billing, caching, and events",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./dist/index.d.ts",
+        "require": "./dist/index.d.cts"
+      },
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "zod": "^3.25.76",
+    "@yuva-devlab/agent-core": "0.2.0",
+    "@yuva-devlab/ai-client": "0.2.0",
+    "@yuva-devlab/auth-server": "0.2.0",
+    "@yuva-devlab/billing": "0.2.0",
+    "@yuva-devlab/errors": "0.2.0",
+    "@yuva-devlab/events": "0.2.0",
+    "@yuva-devlab/logger": "1.2.0",
+    "@yuva-devlab/rag": "0.2.0",
+    "@yuva-devlab/resilience": "0.2.0",
+    "@yuva-devlab/semantic-cache": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "eslint": "^9.39.1",
+    "prettier": "^3.9.8",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "@yuva-devlab/eslint-config": "0.1.1",
+    "@yuva-devlab/prettier-config": "0.1.1",
+    "@yuva-devlab/typescript-config": "0.1.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist node_modules .turbo"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.