@ziggs-ai/api-client 0.1.5 → 0.1.7

package/package.json

@@ -1,13 +1,26 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "type": "module",
-  "main": "src/index.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./http": "./src/http/index.ts",
-    "./websocket": "./src/websocket/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./http": {
+      "types": "./dist/http/index.d.ts",
+      "import": "./dist/http/index.js",
+      "default": "./dist/http/index.js"
+    },
+    "./websocket": {
+      "types": "./dist/websocket/index.d.ts",
+      "import": "./dist/websocket/index.js",
+      "default": "./dist/websocket/index.js"
+    }
   },
   "engines": {
     "node": ">=18"
@@ -24,16 +37,9 @@
   },
   "keywords": ["ziggs", "api", "client", "websocket"],
   "license": "MIT",
-  "files": ["dist", "src", "README.md"],
+  "files": ["dist", "README.md"],
   "publishConfig": {
     "access": "public",
-    "registry": "https://registry.npmjs.org/",
-    "main": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "exports": {
-      ".": "./dist/index.js",
-      "./http": "./dist/http/index.js",
-      "./websocket": "./dist/websocket/index.js"
-    }
+    "registry": "https://registry.npmjs.org/"
   }
 }

package/src/ConnectionManager.ts

@@ -1,172 +0,0 @@
-import { createControlSocket, type ControlSocketOptions, type ControlSocketHandle } from './websocket/ControlSocket.js';
-import { runtimeLog } from './shared/runtimeLog.js';
-
-type OpenFn = () => Promise<unknown>;
-type CloseFn = (handle: unknown) => Promise<void>;
-
-interface Entry {
-  openFn: OpenFn;
-  closeFn: CloseFn;
-}
-
-interface ActiveEntry {
-  handle: unknown;
-  timer: ReturnType<typeof setTimeout> | null;
-  lastActive: number;
-}
-
-export interface ConnectionManagerMeta {
-  domain?: string;
-  expertise?: string[];
-  tags?: string[];
-  [key: string]: unknown;
-}
-
-export interface ConnectionManagerOptions {
-  maxActive?: number;
-  idleTimeoutMs?: number;
-  control?: Pick<ControlSocketOptions, 'wsUrl' | 'operatorKey'>;
-}
-
-export interface QueryFilter {
-  domain?: string;
-  expertise?: string[];
-  tags?: string[];
-}
-
-export class ConnectionManager {
-  private maxActive: number;
-  private idleTimeoutMs: number;
-  private _controlOpts: Pick<ControlSocketOptions, 'wsUrl' | 'operatorKey'> | null;
-  private _controlHandle: ControlSocketHandle | null;
-  private _entries: Map<string, Entry>;
-  private _active: Map<string, ActiveEntry>;
-  private _meta: Map<string, ConnectionManagerMeta>;
-  private _waking: Map<string, Promise<unknown>>;
-
-  constructor({ maxActive = 50, idleTimeoutMs = 60_000, control }: ConnectionManagerOptions = {}) {
-    this.maxActive = maxActive;
-    this.idleTimeoutMs = idleTimeoutMs;
-    this._controlOpts = control ?? null;
-    this._controlHandle = null;
-    this._entries = new Map();
-    this._active = new Map();
-    this._meta = new Map();
-    this._waking = new Map();
-  }
-
-  register(id: string, openFn: OpenFn, closeFn: CloseFn, meta?: ConnectionManagerMeta): void {
-    if (!id) throw new Error('[ConnectionManager] id is required');
-    if (typeof openFn !== 'function') throw new Error('[ConnectionManager] openFn must be a function');
-    if (typeof closeFn !== 'function') throw new Error('[ConnectionManager] closeFn must be a function');
-    this._entries.set(id, { openFn, closeFn });
-    if (meta) this._meta.set(id, meta);
-  }
-
-  start(): void {
-    if (this._controlHandle || !this._controlOpts) return;
-    this._controlHandle = createControlSocket({
-      ...this._controlOpts,
-      agentIds: () => this.list(),
-      onWake: (id) =>
-        this.wake(id).catch(err =>
-          runtimeLog.warn('ConnectionManager', `wake("${id}") failed: ${(err as Error).message}`),
-        ),
-    });
-  }
-
-  async stop(): Promise<void> {
-    this._controlHandle?.close();
-    this._controlHandle = null;
-    await this.sleepAll();
-  }
-
-  async wake(id: string): Promise<unknown> {
-    const existing = this._active.get(id);
-    if (existing) {
-      this._resetTimer(id);
-      return existing.handle;
-    }
-
-    const pending = this._waking.get(id);
-    if (pending) return pending;
-
-    const entry = this._entries.get(id);
-    if (!entry) throw new Error(`[ConnectionManager] unknown id: "${id}"`);
-
-    if (this._active.size >= this.maxActive) await this._evictLRU();
-
-    const wakePromise = (async () => {
-      try {
-        const handle = await entry.openFn();
-        this._active.set(id, { handle, timer: null, lastActive: Date.now() });
-        this._scheduleIdle(id);
-        return handle;
-      } finally {
-        this._waking.delete(id);
-      }
-    })();
-
-    this._waking.set(id, wakePromise);
-    return wakePromise;
-  }
-
-  async sleep(id: string): Promise<void> {
-    const entry = this._active.get(id);
-    if (!entry) return;
-    clearTimeout(entry.timer!);
-    this._active.delete(id);
-    const reg = this._entries.get(id);
-    if (reg) await reg.closeFn(entry.handle);
-  }
-
-  async sleepAll(): Promise<void> {
-    await Promise.all([...this._active.keys()].map(id => this.sleep(id)));
-  }
-
-  touch(id: string): void { this._resetTimer(id); }
-
-  list(): string[] { return [...this._entries.keys()]; }
-  listActive(): string[] { return [...this._active.keys()]; }
-  get size(): number { return this._entries.size; }
-
-  query({ domain, expertise, tags }: QueryFilter = {}): string[] {
-    const results: string[] = [];
-    for (const [id, meta] of this._meta) {
-      if (domain && meta.domain !== domain) continue;
-      if (expertise?.length && !expertise.some(e => meta.expertise?.includes(e))) continue;
-      if (tags?.length && !tags.some(t => meta.tags?.includes(t))) continue;
-      results.push(id);
-    }
-    return results;
-  }
-
-  getMeta(id: string): ConnectionManagerMeta | undefined { return this._meta.get(id); }
-
-  private _scheduleIdle(id: string): void {
-    const entry = this._active.get(id);
-    if (!entry) return;
-    clearTimeout(entry.timer!);
-    entry.timer = setTimeout(() => {
-      this.sleep(id).catch(err =>
-        runtimeLog.warn('ConnectionManager', `idle sleep("${id}") failed: ${(err as Error).message}`),
-      );
-    }, this.idleTimeoutMs);
-  }
-
-  private _resetTimer(id: string): void {
-    const entry = this._active.get(id);
-    if (!entry) return;
-    entry.lastActive = Date.now();
-    this._scheduleIdle(id);
-  }
-
-  private async _evictLRU(): Promise<void> {
-    let oldest: string | null = null;
-    for (const [id, entry] of this._active) {
-      const oldestEntry = oldest ? this._active.get(oldest) : null;
-      if (!oldest || !oldestEntry || entry.lastActive < oldestEntry.lastActive) oldest = id;
-    }
-    if (oldest) await this.sleep(oldest);
-  }
-}

package/src/http/AgentSearchClient.ts

@@ -1,115 +0,0 @@
-import 'dotenv/config';
-import { runtimeLog } from '../shared/runtimeLog.js';
-import { getBackendUrl } from '../utils/urlUtils.js';
-
-export interface AgentSearchOptions {
-  limit?: number;
-  minScore?: number;
-}
-
-export interface AgentSearchResult {
-  success: boolean;
-  agents?: AgentProfile[];
-  error?: string;
-  message?: string;
-}
-
-export interface AgentProfile {
-  agentId: string;
-  name: string;
-  description?: string;
-  tags?: string[];
-  matchScore?: number;
-  reliability?: {
-    sampleSize: number;
-    band: string;
-    medianResponseMs: number;
-    lastActivityDaysAgo: number;
-  };
-  category?: string;
-  version?: string;
-  recentTaskSamples?: unknown[];
-}
-
-export class AgentSearchClient {
-  private readonly operatorKey: string;
-  private readonly agentId: string;
-  private readonly baseUrl: string;
-
-  constructor(operatorKey: string, agentId: string) {
-    if (!operatorKey) throw new Error('AgentSearchClient: operatorKey is required');
-    if (!agentId) throw new Error('AgentSearchClient: agentId is required (operator-token impersonation)');
-    this.operatorKey = operatorKey;
-    this.agentId = agentId;
-    this.baseUrl = getBackendUrl();
-  }
-
-  async searchAgents(query: string, options: AgentSearchOptions = {}): Promise<AgentSearchResult> {
-    if (!query || typeof query !== 'string') {
-      return { success: false, error: 'query is required' };
-    }
-    const params = new URLSearchParams({ q: query });
-    if (typeof options.limit === 'number') params.set('limit', String(options.limit));
-    if (typeof options.minScore === 'number') params.set('minScore', String(options.minScore));
-
-    const url = `${this.baseUrl}/agent-api/v1/agents/search?${params}`;
-    try {
-      const response = await fetch(url, { method: 'GET', headers: this._buildHeaders() });
-      if (!response.ok) {
-        const errorText = await response.text().catch(() => '');
-        runtimeLog.warn(
-          'AgentSearchClient',
-          `⚠️ searchAgents failed agent=${this.agentId} ${response.status} ${response.statusText} url=${url} body=${errorText.slice(0, 200)}`,
-        );
-        return { success: false, error: `Search failed: ${response.status}`, message: errorText };
-      }
-      const { results = [] } = await response.json() as { results: AgentProfile[] };
-      return { success: true, agents: results };
-    } catch (error) {
-      runtimeLog.warn(
-        'AgentSearchClient',
-        `⚠️ searchAgents error agent=${this.agentId} url=${url} message=${(error as Error).message}`,
-      );
-      return { success: false, error: (error as Error).message || 'Failed to search agents' };
-    }
-  }
-
-  async getAgentById(agentId: string): Promise<AgentSearchResult & Partial<AgentProfile>> {
-    if (!agentId) return { success: false, error: 'agentId is required' };
-    const url = `${this.baseUrl}/agent-api/v1/agents/${encodeURIComponent(agentId)}`;
-    try {
-      const response = await fetch(url, { method: 'GET', headers: this._buildHeaders() });
-      if (response.status === 404) {
-        runtimeLog.warn(
-          'AgentSearchClient',
-          `⚠️ getAgentById 404 agent=${this.agentId} target=${agentId} url=${url}`,
-        );
-        return { success: false, error: 'agent not found' };
-      }
-      if (!response.ok) {
-        const body = await response.text().catch(() => '');
-        runtimeLog.warn(
-          'AgentSearchClient',
-          `⚠️ getAgentById failed agent=${this.agentId} target=${agentId} ${response.status} ${response.statusText} body=${body.slice(0, 200)}`,
-        );
-        return { success: false, error: `Failed to get agent details: ${response.status}` };
-      }
-      const agent = await response.json() as AgentProfile;
-      return { success: true, ...agent };
-    } catch (error) {
-      runtimeLog.warn(
-        'AgentSearchClient',
-        `⚠️ getAgentById error agent=${this.agentId} target=${agentId} url=${url} message=${(error as Error).message}`,
-      );
-      return { success: false, error: (error as Error).message || 'Failed to get agent details' };
-    }
-  }
-
-  private _buildHeaders(): Record<string, string> {
-    return {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${this.operatorKey}`,
-      'X-Agent-Id': this.agentId,
-    };
-  }
-}