@holokai/holo-sdk 1.4.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Holokai
+
+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/README.md

@@ -0,0 +1,264 @@
+# @holokai/holo-sdk
+
+SDK for the Holo platform. Provides base classes for building provider plugins and a client SDK for consuming the Holo API.
+
+## Installation
+
+```bash
+npm install @holokai/holo-sdk
+```
+
+Plugins also need the types package:
+
+```bash
+npm install @holokai/holo-types
+```
+
+## Overview
+
+The SDK provides:
+
+- `BasePlugin` — lifecycle management (initialize, destroy, state machine)
+- `BaseProvider` — provider request processing and auditing
+- `BaseAuditor` — request/response audit record construction
+- `BaseTranslator` — Holo universal format translation
+- `BaseWireAdapter` — provider events to HTTP wire chunks
+- Core utilities (`ClassLogger`, `pickDefined`, `AsyncEventQueue`, etc.)
+- Notification factories and stores
+
+## Package Exports
+
+```typescript
+// Plugin development
+import {BasePlugin} from '@holokai/holo-sdk/plugin';
+import {BaseProvider, BaseAuditor, BaseTranslator, BaseWireAdapter} from '@holokai/holo-sdk/provider';
+import {ClassLogger, pickDefined, stringifyError} from '@holokai/holo-sdk';
+import {HoloRequestDefaults} from '@holokai/holo-sdk/holo';
+import {NotificationServiceToken, NotificationEventFactory} from '@holokai/holo-sdk/notification';
+
+// Client SDK
+import {HoloClient, HoloRequestBuilder, HoloStream, HoloToolRunner} from '@holokai/holo-sdk/client';
+```
+
+| Subpath | Description |
+|---------|-------------|
+| `@holokai/holo-sdk` | Core utilities: `pickDefined`, `ClassLogger`, `AsyncEventQueue`, logging |
+| `@holokai/holo-sdk/plugin` | `BasePlugin`, plugin loader, discovery |
+| `@holokai/holo-sdk/provider` | `BaseProvider`, `BaseAuditor`, `BaseTranslator`, `BaseWireAdapter`, event processor |
+| `@holokai/holo-sdk/holo` | Holo format helpers, content type guards, request factories |
+| `@holokai/holo-sdk/core` | Low-level utilities |
+| `@holokai/holo-sdk/notification` | Notification service, event factory |
+| `@holokai/holo-sdk/client` | `HoloClient`, `HoloRequestBuilder`, streaming, tool runner |
+
+## Building a Provider Plugin
+
+### Directory Structure
+
+```
+plugins/holo-provider-{name}/
+├── src/
+│   ├── index.ts              # Default export of plugin instance
+│   ├── manifest.ts           # Plugin manifest definition
+│   ├── plugin.ts             # IProviderPlugin implementation
+│   ├── {name}.provider.ts    # IProvider implementation
+│   ├── {name}.auditor.ts     # IAuditor implementation
+│   ├── {name}.translator.ts  # IProviderTranslator implementation
+│   ├── {name}.wire.adapter.ts # IWireAdapter implementation
+│   └── types.ts              # Provider-specific types
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+### Plugin Implementation
+
+```typescript
+// plugin.ts
+import {BasePlugin} from '@holokai/holo-sdk/plugin';
+import type {IProviderPlugin, PluginContext} from '@holokai/holo-types/plugin';
+import type {IProvider, IWireAdapter, ProviderCapabilities, WireAdapterParams} from '@holokai/holo-types/provider';
+import type {RouteTree} from '@holokai/holo-types/routing';
+import {RouteHandler} from '@holokai/holo-types/routing';
+import {ProtocolCapability} from '@holokai/holo-types/entities';
+import {manifest} from './manifest';
+import {MyProvider} from './my.provider';
+import {MyWireAdapter} from './my.wire.adapter';
+import {MyTranslator} from './my.translator';
+
+export const MyProtocols = {
+    CHAT: 'my.chat',
+    MODELS: 'my.models'
+} as const;
+
+export class MyProviderPlugin extends BasePlugin implements IProviderPlugin {
+    manifest = manifest;
+    translator = MyTranslator.instance();
+    protocols = MyProtocols;
+    defaultProtocol = MyProtocols.CHAT;
+
+    async createProvider(id: string, name: string, config: any): Promise<IProvider> {
+        return new MyProvider(this, config);
+    }
+
+    async createWireAdapter(params: WireAdapterParams): Promise<IWireAdapter> {
+        return new MyWireAdapter(params.requestId, params.isStreaming);
+    }
+
+    getCapabilities(): ProviderCapabilities {
+        return {streaming: true, tools: true, vision: false, functionCalling: true, maxTokens: 128000};
+    }
+
+    getRoutes(): RouteTree {
+        return {
+            v1: {
+                chat: {
+                    method: 'POST',
+                    handler: RouteHandler.REQUEST,
+                    protocol: {name: MyProtocols.CHAT, capability: ProtocolCapability.CHAT}
+                },
+                models: {
+                    method: 'GET',
+                    handler: RouteHandler.MODELS,
+                    protocol: {name: MyProtocols.MODELS, capability: ProtocolCapability.MODELS}
+                }
+            }
+        };
+    }
+
+    protected onInitialize(_context: PluginContext): Promise<void> {
+        return Promise.resolve();
+    }
+
+    protected onDestroy(): Promise<void> {
+        return Promise.resolve();
+    }
+}
+```
+
+### Protocols and Capabilities
+
+Each route declares a **protocol** (wire format identifier) and **capability** (what kind of request it handles):
+
+| Capability                    | Description                 |
+|-------------------------------|-----------------------------|
+| `ProtocolCapability.CHAT`     | Conversational LLM requests |
+| `ProtocolCapability.GENERATE` | Text generation (non-chat)  |
+| `ProtocolCapability.EMBED`    | Embedding generation        |
+| `ProtocolCapability.MODELS`   | Model listing               |
+
+Protocols are registered in the database at startup. Each protocol is tied to a specific plugin version.
+
+### Auditor Implementation
+
+The auditor transforms worker requests/responses into `ProviderRequest`/`ProviderResponse` audit records:
+
+```typescript
+import {BaseAuditor} from '@holokai/holo-sdk/provider';
+import type {HoloWorkerRequest} from '@holokai/holo-types/worker';
+import type {ProviderRequest} from '@holokai/holo-types/entities';
+
+export class MyAuditor extends BaseAuditor {
+    readonly provider = 'my-provider';
+
+    protected toHoloRequest(workerRequest: HoloWorkerRequest, req: Omit<ProviderRequest, 'id'>): void {
+        req.access_model = workerRequest.payload.model;
+        req.metadata.user_prompt = workerRequest.payload.messages?.at(-1)?.content;
+    }
+
+    protected mapProviderPayload(workerRequest: HoloWorkerRequest, req: Omit<ProviderRequest, 'id'>): void {
+        const {temperature, max_tokens} = workerRequest.payload;
+        req.metadata.options = {temperature, max_tokens};
+    }
+
+    protected async createProviderEnvelope(payload: any) {
+        return {access_model: payload.model || 'unknown'};
+    }
+}
+```
+
+Audit records use:
+
+- **Real columns** for queryable fields: `access_model`, `application_id`, `provider_id`, `protocol_id`, `user_id`,
+  `client_identifier`, `thread_id`, token counts, timing, cost
+- **`metadata` JSONB** for extensible data: `user_prompt`, `system_prompt`, `options`, `raw_request`, `headers`,
+  `response_raw`, `usage_raw`, etc.
+
+### Manifest
+
+```typescript
+// manifest.ts
+import type {PluginManifest} from '@holokai/holo-types/plugin';
+import {PluginType} from '@holokai/holo-types/plugin';
+
+export const manifest: PluginManifest = {
+    name: '@holokai/holo-provider-my',
+    version: '1.0.0',
+    pluginType: PluginType.PROVIDER,
+    family: 'MY_PROVIDER',
+    description: 'My custom provider plugin'
+};
+```
+
+### Default Export
+
+```typescript
+// index.ts
+import {MyProviderPlugin} from './plugin';
+
+export default new MyProviderPlugin();
+```
+
+## Client SDK
+
+The `@holokai/holo-sdk/client` subpath provides a typed client for consuming the Holo API:
+
+```typescript
+import {HoloClient} from '@holokai/holo-sdk/client';
+
+const client = new HoloClient({baseUrl: 'http://localhost:3000', token: 'your-token'});
+
+// Simple chat
+const response = await client.chat.send({
+    model: 'gpt-4o',
+    messages: [{role: 'user', content: 'Hello'}],
+});
+
+// Fluent builder
+const response = await client.chat.builder()
+    .model('gpt-4o')
+    .system('You are helpful.')
+    .user('Hello')
+    .temperature(0.7)
+    .send();
+
+// Streaming
+const stream = await client.chat.builder()
+    .model('gpt-4o')
+    .user('Write a poem')
+    .stream();
+
+for await (const event of stream) {
+    process.stdout.write(event.text ?? '');
+}
+
+// Tool calling
+import {HoloToolRunner} from '@holokai/holo-sdk/client';
+
+const runner = new HoloToolRunner(client, tools, handlers);
+const result = await runner.run({model: 'gpt-4o', messages});
+```
+
+See [docs/README.md](docs/README.md) for the full client SDK reference.
+
+## Reference Implementations
+
+| Plugin                            | Key Features                                                                   |
+|-----------------------------------|--------------------------------------------------------------------------------|
+| [OpenAI](../holo-provider-openai) | Dual protocols (completions + responses), dual wire adapters, tool calling     |
+| [Claude](../holo-provider-claude) | 6-event streaming lifecycle, content blocks, extended thinking, prompt caching |
+| [Ollama](../holo-provider-ollama) | Chat + generate protocols, local deployment, passthrough default handler       |
+| [Gemini](../holo-provider-gemini) | Dual protocols (generate + stream), embedding, vision, 1M token context        |
+
+## License
+
+MIT

package/dist/client/builder.d.ts

@@ -0,0 +1,82 @@
+import type { HoloContent, HoloContentToolResult, HoloMessage, HoloRequest, HoloRequestMetadata, HoloResponse, HoloResponseFormat, HoloTool, HoloToolChoice } from '@holokai/holo-types/holo';
+import type { HoloStream } from './stream';
+export type SendFn = (request: HoloRequest) => Promise<HoloResponse>;
+export type StreamFn = (request: HoloRequest) => Promise<HoloStream>;
+/**
+ * Fluent builder for constructing and sending {@link HoloRequest} objects.
+ *
+ * @remarks Create via {@link ChatNamespace.builder} rather than constructing directly.
+ *
+ * @example
+ * ```ts
+ * const response = await client.chat.builder()
+ *   .model('gpt-4o')
+ *   .user('Summarize this article')
+ *   .temperature(0.3)
+ *   .send();
+ * ```
+ *
+ * @see {@link HoloRequest} for the underlying request shape.
+ */
+export declare class HoloRequestBuilder {
+    private readonly sendFn;
+    private readonly streamFn;
+    private _model?;
+    private _application?;
+    private _messages;
+    private _temperature?;
+    private _maxTokens?;
+    private _topP?;
+    private _topK?;
+    private _frequencyPenalty?;
+    private _presencePenalty?;
+    private _seed?;
+    private _stopSequences?;
+    private _tools?;
+    private _toolChoice?;
+    private _responseFormat?;
+    private _metadata?;
+    private _serviceTier?;
+    private _provider?;
+    private _threadId?;
+    private _branch?;
+    constructor(sendFn: SendFn, streamFn: StreamFn, defaults?: {
+        model?: string;
+        application?: string;
+    });
+    model(name: string): this;
+    application(slug: string): this;
+    system(content: string): this;
+    user(content: string | HoloContent[]): this;
+    assistant(content: string | HoloContent[]): this;
+    /** Append a tool result message. Use this to feed tool outputs back into the conversation. */
+    tool(result: HoloContentToolResult): this;
+    messages(msgs: HoloMessage[]): this;
+    temperature(v: number): this;
+    maxTokens(v: number): this;
+    topP(v: number): this;
+    topK(v: number): this;
+    frequencyPenalty(v: number): this;
+    presencePenalty(v: number): this;
+    seed(v: number): this;
+    stopSequences(s: string[]): this;
+    tools(t: HoloTool[]): this;
+    toolChoice(c: HoloToolChoice): this;
+    responseFormat(f: HoloResponseFormat): this;
+    /** Shorthand to set `response_format` to `json_object` (valid JSON, no schema). */
+    json(): this;
+    /** Shorthand to set `response_format` to `json_schema` with strict validation. */
+    jsonSchema(schema: Record<string, unknown>): this;
+    metadata(m: HoloRequestMetadata | null): this;
+    serviceTier(tier: 'auto' | 'default' | 'standard_only'): this;
+    provider(nameOrId: string): this;
+    threadId(id: string): this;
+    branch(id: string): this;
+    /** Assemble the current builder state into a {@link HoloRequest} without sending it. */
+    build(): HoloRequest;
+    /** Build and send the request, returning the complete {@link HoloResponse}. */
+    send(): Promise<HoloResponse>;
+    /** Build and send the request as a streaming call, returning a {@link HoloStream}. */
+    stream(): Promise<HoloStream>;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/client/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/client/builder.ts"],"names":[],"mappings":"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"}

package/dist/client/builder.js

@@ -0,0 +1,207 @@
+/**
+ * Fluent builder for constructing and sending {@link HoloRequest} objects.
+ *
+ * @remarks Create via {@link ChatNamespace.builder} rather than constructing directly.
+ *
+ * @example
+ * ```ts
+ * const response = await client.chat.builder()
+ *   .model('gpt-4o')
+ *   .user('Summarize this article')
+ *   .temperature(0.3)
+ *   .send();
+ * ```
+ *
+ * @see {@link HoloRequest} for the underlying request shape.
+ */
+export class HoloRequestBuilder {
+    sendFn;
+    streamFn;
+    _model;
+    _application;
+    _messages = [];
+    _temperature;
+    _maxTokens;
+    _topP;
+    _topK;
+    _frequencyPenalty;
+    _presencePenalty;
+    _seed;
+    _stopSequences;
+    _tools;
+    _toolChoice;
+    _responseFormat;
+    _metadata;
+    _serviceTier;
+    _provider;
+    _threadId;
+    _branch;
+    constructor(sendFn, streamFn, defaults) {
+        this.sendFn = sendFn;
+        this.streamFn = streamFn;
+        if (defaults?.model)
+            this._model = defaults.model;
+        if (defaults?.application)
+            this._application = defaults.application;
+    }
+    model(name) {
+        this._model = name;
+        return this;
+    }
+    application(slug) {
+        this._application = slug;
+        return this;
+    }
+    system(content) {
+        this._messages.push({ role: 'system', content });
+        return this;
+    }
+    user(content) {
+        this._messages.push({ role: 'user', content });
+        return this;
+    }
+    assistant(content) {
+        this._messages.push({ role: 'assistant', content });
+        return this;
+    }
+    /** Append a tool result message. Use this to feed tool outputs back into the conversation. */
+    tool(result) {
+        this._messages.push({ role: 'tool', content: result.content, tool_call_id: result.tool_call_id });
+        return this;
+    }
+    messages(msgs) {
+        this._messages.push(...msgs);
+        return this;
+    }
+    temperature(v) {
+        this._temperature = v;
+        return this;
+    }
+    maxTokens(v) {
+        this._maxTokens = v;
+        return this;
+    }
+    topP(v) {
+        this._topP = v;
+        return this;
+    }
+    topK(v) {
+        this._topK = v;
+        return this;
+    }
+    frequencyPenalty(v) {
+        this._frequencyPenalty = v;
+        return this;
+    }
+    presencePenalty(v) {
+        this._presencePenalty = v;
+        return this;
+    }
+    seed(v) {
+        this._seed = v;
+        return this;
+    }
+    stopSequences(s) {
+        this._stopSequences = s;
+        return this;
+    }
+    tools(t) {
+        this._tools = t;
+        return this;
+    }
+    toolChoice(c) {
+        this._toolChoice = c;
+        return this;
+    }
+    responseFormat(f) {
+        this._responseFormat = f;
+        return this;
+    }
+    /** Shorthand to set `response_format` to `json_object` (valid JSON, no schema). */
+    json() {
+        this._responseFormat = { type: 'json_object' };
+        return this;
+    }
+    /** Shorthand to set `response_format` to `json_schema` with strict validation. */
+    jsonSchema(schema) {
+        this._responseFormat = { type: 'json_schema', schema, strict: true };
+        return this;
+    }
+    metadata(m) {
+        this._metadata = m;
+        return this;
+    }
+    serviceTier(tier) {
+        this._serviceTier = tier;
+        return this;
+    }
+    provider(nameOrId) {
+        this._provider = nameOrId;
+        return this;
+    }
+    threadId(id) {
+        this._threadId = id;
+        return this;
+    }
+    branch(id) {
+        this._branch = id;
+        return this;
+    }
+    /** Assemble the current builder state into a {@link HoloRequest} without sending it. */
+    build() {
+        const model = this._model;
+        if (!model) {
+            throw new Error('No model specified. Set a model via .model() or provide a defaultModel in HoloClientOptions.');
+        }
+        const request = {
+            model,
+            messages: this._messages,
+        };
+        if (this._application)
+            request.application = this._application;
+        if (this._provider)
+            request.provider = this._provider;
+        if (this._temperature !== undefined)
+            request.temperature = this._temperature;
+        if (this._maxTokens !== undefined)
+            request.max_tokens = this._maxTokens;
+        if (this._topP !== undefined)
+            request.top_p = this._topP;
+        if (this._topK !== undefined)
+            request.top_k = this._topK;
+        if (this._frequencyPenalty !== undefined)
+            request.frequency_penalty = this._frequencyPenalty;
+        if (this._presencePenalty !== undefined)
+            request.presence_penalty = this._presencePenalty;
+        if (this._seed !== undefined)
+            request.seed = this._seed;
+        if (this._stopSequences)
+            request.stop_sequences = this._stopSequences;
+        if (this._tools)
+            request.tools = this._tools;
+        if (this._toolChoice)
+            request.tool_choice = this._toolChoice;
+        if (this._responseFormat)
+            request.response_format = this._responseFormat;
+        if (this._metadata !== undefined)
+            request.metadata = this._metadata;
+        if (this._serviceTier)
+            request.service_tier = this._serviceTier;
+        if (this._threadId)
+            request.thread_id = this._threadId;
+        if (this._branch)
+            request.branch = this._branch;
+        return request;
+    }
+    /** Build and send the request, returning the complete {@link HoloResponse}. */
+    async send() {
+        return this.sendFn(this.build());
+    }
+    /** Build and send the request as a streaming call, returning a {@link HoloStream}. */
+    async stream() {
+        const request = this.build();
+        request.stream = true;
+        return this.streamFn(request);
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/client/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/client/builder.ts"],"names":[],"mappings":"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"}