@ubiquity-os/plugin-sdk 3.6.0 → 3.6.3

package/dist/llm.d.mts

@@ -1,5 +1,6 @@
-import { ChatCompletionMessageParam, ChatCompletion, ChatCompletionChunk } from 'openai/resources/chat/completions';
+import { ChatCompletionMessageParam, ChatCompletionCreateParamsNonStreaming, ChatCompletion, ChatCompletionChunk } from 'openai/resources/chat/completions';
 import { C as Context } from './context-sqbr2o6i.mjs';
+import { PluginInput } from './signature.mjs';
 import '@octokit/webhooks';
 import '@ubiquity-os/ubiquity-os-logger';
 import '@octokit/plugin-rest-endpoint-methods';
@@ -7,54 +8,16 @@ import './octokit.mjs';
 import '@octokit/core/types';
 import '@octokit/plugin-paginate-graphql';
 import '@octokit/plugin-paginate-rest';
-import '@octokit/webhooks/node_modules/@octokit/request-error';
+import '@octokit/request-error';
 import '@octokit/core';
+import '@sinclair/typebox';
 
-type LlmResponseFormat = {
-    type: "json_object" | "text";
-} | {
-    type: string;
-    [key: string]: unknown;
-};
-type LlmPayload = {
-    repository?: {
-        owner?: {
-            login?: string;
-        };
-        name?: string;
-    };
-    installation?: {
-        id?: number;
-    };
-};
-type LlmAuthContext = {
-    authToken?: string;
-    ubiquityKernelToken?: string;
-    payload?: LlmPayload;
-    eventPayload?: LlmPayload;
-};
 type LlmCallOptions = {
     baseUrl?: string;
     model?: string;
     stream?: boolean;
     messages: ChatCompletionMessageParam[];
-    max_tokens?: number;
-    max_completion_tokens?: number;
-    temperature?: number;
-    top_p?: number;
-    frequency_penalty?: number;
-    presence_penalty?: number;
-    response_format?: LlmResponseFormat;
-    stop?: string | string[];
-    n?: number;
-    logit_bias?: Record<string, number>;
-    seed?: number;
-    user?: string;
-    metadata?: Record<string, unknown>;
-    tools?: unknown[];
-    tool_choice?: string | Record<string, unknown>;
-    [key: string]: unknown;
-};
-declare function callLlm(options: LlmCallOptions, input: Context | LlmAuthContext): Promise<ChatCompletion | AsyncIterable<ChatCompletionChunk>>;
+} & Partial<Omit<ChatCompletionCreateParamsNonStreaming, "model" | "messages" | "stream">>;
+declare function callLlm(options: LlmCallOptions, input: PluginInput | Context): Promise<ChatCompletion | AsyncIterable<ChatCompletionChunk>>;
 
 export { type LlmCallOptions, callLlm };

package/dist/llm.d.ts

@@ -1,5 +1,6 @@
-import { ChatCompletionMessageParam, ChatCompletion, ChatCompletionChunk } from 'openai/resources/chat/completions';
+import { ChatCompletionMessageParam, ChatCompletionCreateParamsNonStreaming, ChatCompletion, ChatCompletionChunk } from 'openai/resources/chat/completions';
 import { C as Context } from './context-BbEmsEct.js';
+import { PluginInput } from './signature.js';
 import '@octokit/webhooks';
 import '@ubiquity-os/ubiquity-os-logger';
 import '@octokit/plugin-rest-endpoint-methods';
@@ -7,54 +8,16 @@ import './octokit.js';
 import '@octokit/core/types';
 import '@octokit/plugin-paginate-graphql';
 import '@octokit/plugin-paginate-rest';
-import '@octokit/webhooks/node_modules/@octokit/request-error';
+import '@octokit/request-error';
 import '@octokit/core';
+import '@sinclair/typebox';
 
-type LlmResponseFormat = {
-    type: "json_object" | "text";
-} | {
-    type: string;
-    [key: string]: unknown;
-};
-type LlmPayload = {
-    repository?: {
-        owner?: {
-            login?: string;
-        };
-        name?: string;
-    };
-    installation?: {
-        id?: number;
-    };
-};
-type LlmAuthContext = {
-    authToken?: string;
-    ubiquityKernelToken?: string;
-    payload?: LlmPayload;
-    eventPayload?: LlmPayload;
-};
 type LlmCallOptions = {
     baseUrl?: string;
     model?: string;
     stream?: boolean;
     messages: ChatCompletionMessageParam[];
-    max_tokens?: number;
-    max_completion_tokens?: number;
-    temperature?: number;
-    top_p?: number;
-    frequency_penalty?: number;
-    presence_penalty?: number;
-    response_format?: LlmResponseFormat;
-    stop?: string | string[];
-    n?: number;
-    logit_bias?: Record<string, number>;
-    seed?: number;
-    user?: string;
-    metadata?: Record<string, unknown>;
-    tools?: unknown[];
-    tool_choice?: string | Record<string, unknown>;
-    [key: string]: unknown;
-};
-declare function callLlm(options: LlmCallOptions, input: Context | LlmAuthContext): Promise<ChatCompletion | AsyncIterable<ChatCompletionChunk>>;
+} & Partial<Omit<ChatCompletionCreateParamsNonStreaming, "model" | "messages" | "stream">>;
+declare function callLlm(options: LlmCallOptions, input: PluginInput | Context): Promise<ChatCompletion | AsyncIterable<ChatCompletionChunk>>;
 
 export { type LlmCallOptions, callLlm };

package/dist/llm.js

@@ -23,6 +23,7 @@ __export(llm_exports, {
   callLlm: () => callLlm
 });
 module.exports = __toCommonJS(llm_exports);
+var EMPTY_STRING = "";
 function normalizeBaseUrl(baseUrl) {
   let normalized = baseUrl.trim();
   while (normalized.endsWith("/")) {
@@ -31,54 +32,45 @@ function normalizeBaseUrl(baseUrl) {
   return normalized;
 }
 function getEnvString(name) {
-  if (typeof process === "undefined" || !process?.env) return "";
-  return String(process.env[name] ?? "").trim();
+  if (typeof process === "undefined" || !process?.env) return EMPTY_STRING;
+  return String(process.env[name] ?? EMPTY_STRING).trim();
 }
 function getAiBaseUrl(options) {
   if (typeof options.baseUrl === "string" && options.baseUrl.trim()) {
     return normalizeBaseUrl(options.baseUrl);
   }
-  const envBaseUrl = getEnvString("UBQ_AI_BASE_URL") || getEnvString("UBQ_AI_URL");
+  const envBaseUrl = getEnvString("UOS_AI_URL") || getEnvString("UOS_AI_BASE_URL");
   if (envBaseUrl) return normalizeBaseUrl(envBaseUrl);
-  return "https://ai.ubq.fi";
+  return "https://ai-ubq-fi.deno.dev";
 }
 async function callLlm(options, input) {
-  const inputPayload = input;
-  const authToken = inputPayload.authToken;
-  const ubiquityKernelToken = inputPayload.ubiquityKernelToken;
-  const payload = inputPayload.payload ?? inputPayload.eventPayload;
-  const owner = payload?.repository?.owner?.login ?? "";
-  const repo = payload?.repository?.name ?? "";
-  const installationId = payload?.installation?.id;
-  if (!authToken) throw new Error("Missing authToken in inputs");
-  const isKernelTokenRequired = authToken.trim().startsWith("gh");
-  if (isKernelTokenRequired && !ubiquityKernelToken) {
-    throw new Error("Missing ubiquityKernelToken in inputs (kernel attestation is required for GitHub auth)");
-  }
+  const authToken = String(input.authToken ?? EMPTY_STRING).trim();
+  if (!authToken) throw new Error("Missing authToken in input");
+  const kernelToken = "ubiquityKernelToken" in input ? input.ubiquityKernelToken : void 0;
+  const payload = getPayload(input);
+  const { owner, repo, installationId } = getRepoMetadata(payload);
+  ensureKernelToken(authToken, kernelToken);
   const { baseUrl, model, stream: isStream, messages, ...rest } = options;
-  const url = `${getAiBaseUrl({ ...options, baseUrl })}/v1/chat/completions`;
+  ensureMessages(messages);
+  const url = buildAiUrl(options, baseUrl);
   const body = JSON.stringify({
     ...rest,
     ...model ? { model } : {},
     messages,
     stream: isStream ?? false
   });
-  const headers = {
-    Authorization: `Bearer ${authToken}`,
-    "Content-Type": "application/json"
-  };
-  if (owner) headers["X-GitHub-Owner"] = owner;
-  if (repo) headers["X-GitHub-Repo"] = repo;
-  if (typeof installationId === "number" && Number.isFinite(installationId)) {
-    headers["X-GitHub-Installation-Id"] = String(installationId);
-  }
-  if (ubiquityKernelToken) {
-    headers["X-Ubiquity-Kernel-Token"] = ubiquityKernelToken;
-  }
+  const headers = buildHeaders(authToken, {
+    owner,
+    repo,
+    installationId,
+    ubiquityKernelToken: kernelToken
+  });
   const response = await fetch(url, { method: "POST", headers, body });
   if (!response.ok) {
     const err = await response.text();
-    throw new Error(`LLM API error: ${response.status} - ${err}`);
+    const error = new Error(`LLM API error: ${response.status} - ${err}`);
+    error.status = response.status;
+    throw error;
   }
   if (isStream) {
     if (!response.body) {
@@ -88,29 +80,93 @@ async function callLlm(options, input) {
   }
   return response.json();
 }
+function ensureKernelToken(authToken, kernelToken) {
+  const isKernelTokenRequired = authToken.startsWith("gh");
+  if (isKernelTokenRequired && !kernelToken) {
+    throw new Error("Missing ubiquityKernelToken in input (kernel attestation is required for GitHub auth)");
+  }
+}
+function ensureMessages(messages) {
+  if (!Array.isArray(messages) || messages.length === 0) {
+    throw new Error("messages must be a non-empty array");
+  }
+}
+function buildAiUrl(options, baseUrl) {
+  return `${getAiBaseUrl({ ...options, baseUrl })}/v1/chat/completions`;
+}
+function getPayload(input) {
+  if ("payload" in input) {
+    return input.payload;
+  }
+  return input.eventPayload;
+}
+function getRepoMetadata(payload) {
+  const repoPayload = payload;
+  return {
+    owner: repoPayload?.repository?.owner?.login ?? EMPTY_STRING,
+    repo: repoPayload?.repository?.name ?? EMPTY_STRING,
+    installationId: repoPayload?.installation?.id
+  };
+}
+function buildHeaders(authToken, options) {
+  const headers = {
+    Authorization: `Bearer ${authToken}`,
+    "Content-Type": "application/json"
+  };
+  if (options.owner) headers["X-GitHub-Owner"] = options.owner;
+  if (options.repo) headers["X-GitHub-Repo"] = options.repo;
+  if (typeof options.installationId === "number" && Number.isFinite(options.installationId)) {
+    headers["X-GitHub-Installation-Id"] = String(options.installationId);
+  }
+  if (options.ubiquityKernelToken) {
+    headers["X-Ubiquity-Kernel-Token"] = options.ubiquityKernelToken;
+  }
+  return headers;
+}
 async function* parseSseStream(body) {
   const reader = body.getReader();
   const decoder = new TextDecoder();
-  let buffer = "";
+  let buffer = EMPTY_STRING;
   try {
     while (true) {
       const { value, done: isDone } = await reader.read();
       if (isDone) break;
       buffer += decoder.decode(value, { stream: true });
-      const events = buffer.split("\n\n");
-      buffer = events.pop() || "";
+      const { events, remainder } = splitSseEvents(buffer);
+      buffer = remainder;
       for (const event of events) {
-        if (event.startsWith("data: ")) {
-          const data = event.slice(6);
-          if (data === "[DONE]") return;
-          yield JSON.parse(data);
-        }
+        const data = getEventData(event);
+        if (!data) continue;
+        if (data.trim() === "[DONE]") return;
+        yield parseEventData(data);
       }
     }
   } finally {
     reader.releaseLock();
   }
 }
+function splitSseEvents(buffer) {
+  const normalized = buffer.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+  const parts = normalized.split("\n\n");
+  const remainder = parts.pop() ?? EMPTY_STRING;
+  return { events: parts, remainder };
+}
+function getEventData(event) {
+  if (!event.trim()) return null;
+  const dataLines = event.split("\n").filter((line) => line.startsWith("data:"));
+  if (!dataLines.length) return null;
+  const data = dataLines.map((line) => line.startsWith("data: ") ? line.slice(6) : line.slice(5).replace(/^ /, "")).join("\n");
+  return data || null;
+}
+function parseEventData(data) {
+  try {
+    return JSON.parse(data);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const preview = data.length > 200 ? `${data.slice(0, 200)}...` : data;
+    throw new Error(`LLM stream parse error: ${message}. Data: ${preview}`);
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   callLlm

package/dist/llm.mjs

@@ -1,4 +1,5 @@
 // src/llm/index.ts
+var EMPTY_STRING = "";
 function normalizeBaseUrl(baseUrl) {
   let normalized = baseUrl.trim();
   while (normalized.endsWith("/")) {
@@ -7,54 +8,45 @@ function normalizeBaseUrl(baseUrl) {
   return normalized;
 }
 function getEnvString(name) {
-  if (typeof process === "undefined" || !process?.env) return "";
-  return String(process.env[name] ?? "").trim();
+  if (typeof process === "undefined" || !process?.env) return EMPTY_STRING;
+  return String(process.env[name] ?? EMPTY_STRING).trim();
 }
 function getAiBaseUrl(options) {
   if (typeof options.baseUrl === "string" && options.baseUrl.trim()) {
     return normalizeBaseUrl(options.baseUrl);
   }
-  const envBaseUrl = getEnvString("UBQ_AI_BASE_URL") || getEnvString("UBQ_AI_URL");
+  const envBaseUrl = getEnvString("UOS_AI_URL") || getEnvString("UOS_AI_BASE_URL");
   if (envBaseUrl) return normalizeBaseUrl(envBaseUrl);
-  return "https://ai.ubq.fi";
+  return "https://ai-ubq-fi.deno.dev";
 }
 async function callLlm(options, input) {
-  const inputPayload = input;
-  const authToken = inputPayload.authToken;
-  const ubiquityKernelToken = inputPayload.ubiquityKernelToken;
-  const payload = inputPayload.payload ?? inputPayload.eventPayload;
-  const owner = payload?.repository?.owner?.login ?? "";
-  const repo = payload?.repository?.name ?? "";
-  const installationId = payload?.installation?.id;
-  if (!authToken) throw new Error("Missing authToken in inputs");
-  const isKernelTokenRequired = authToken.trim().startsWith("gh");
-  if (isKernelTokenRequired && !ubiquityKernelToken) {
-    throw new Error("Missing ubiquityKernelToken in inputs (kernel attestation is required for GitHub auth)");
-  }
+  const authToken = String(input.authToken ?? EMPTY_STRING).trim();
+  if (!authToken) throw new Error("Missing authToken in input");
+  const kernelToken = "ubiquityKernelToken" in input ? input.ubiquityKernelToken : void 0;
+  const payload = getPayload(input);
+  const { owner, repo, installationId } = getRepoMetadata(payload);
+  ensureKernelToken(authToken, kernelToken);
   const { baseUrl, model, stream: isStream, messages, ...rest } = options;
-  const url = `${getAiBaseUrl({ ...options, baseUrl })}/v1/chat/completions`;
+  ensureMessages(messages);
+  const url = buildAiUrl(options, baseUrl);
   const body = JSON.stringify({
     ...rest,
     ...model ? { model } : {},
     messages,
     stream: isStream ?? false
   });
-  const headers = {
-    Authorization: `Bearer ${authToken}`,
-    "Content-Type": "application/json"
-  };
-  if (owner) headers["X-GitHub-Owner"] = owner;
-  if (repo) headers["X-GitHub-Repo"] = repo;
-  if (typeof installationId === "number" && Number.isFinite(installationId)) {
-    headers["X-GitHub-Installation-Id"] = String(installationId);
-  }
-  if (ubiquityKernelToken) {
-    headers["X-Ubiquity-Kernel-Token"] = ubiquityKernelToken;
-  }
+  const headers = buildHeaders(authToken, {
+    owner,
+    repo,
+    installationId,
+    ubiquityKernelToken: kernelToken
+  });
   const response = await fetch(url, { method: "POST", headers, body });
   if (!response.ok) {
     const err = await response.text();
-    throw new Error(`LLM API error: ${response.status} - ${err}`);
+    const error = new Error(`LLM API error: ${response.status} - ${err}`);
+    error.status = response.status;
+    throw error;
   }
   if (isStream) {
     if (!response.body) {
@@ -64,29 +56,93 @@ async function callLlm(options, input) {
   }
   return response.json();
 }
+function ensureKernelToken(authToken, kernelToken) {
+  const isKernelTokenRequired = authToken.startsWith("gh");
+  if (isKernelTokenRequired && !kernelToken) {
+    throw new Error("Missing ubiquityKernelToken in input (kernel attestation is required for GitHub auth)");
+  }
+}
+function ensureMessages(messages) {
+  if (!Array.isArray(messages) || messages.length === 0) {
+    throw new Error("messages must be a non-empty array");
+  }
+}
+function buildAiUrl(options, baseUrl) {
+  return `${getAiBaseUrl({ ...options, baseUrl })}/v1/chat/completions`;
+}
+function getPayload(input) {
+  if ("payload" in input) {
+    return input.payload;
+  }
+  return input.eventPayload;
+}
+function getRepoMetadata(payload) {
+  const repoPayload = payload;
+  return {
+    owner: repoPayload?.repository?.owner?.login ?? EMPTY_STRING,
+    repo: repoPayload?.repository?.name ?? EMPTY_STRING,
+    installationId: repoPayload?.installation?.id
+  };
+}
+function buildHeaders(authToken, options) {
+  const headers = {
+    Authorization: `Bearer ${authToken}`,
+    "Content-Type": "application/json"
+  };
+  if (options.owner) headers["X-GitHub-Owner"] = options.owner;
+  if (options.repo) headers["X-GitHub-Repo"] = options.repo;
+  if (typeof options.installationId === "number" && Number.isFinite(options.installationId)) {
+    headers["X-GitHub-Installation-Id"] = String(options.installationId);
+  }
+  if (options.ubiquityKernelToken) {
+    headers["X-Ubiquity-Kernel-Token"] = options.ubiquityKernelToken;
+  }
+  return headers;
+}
 async function* parseSseStream(body) {
   const reader = body.getReader();
   const decoder = new TextDecoder();
-  let buffer = "";
+  let buffer = EMPTY_STRING;
   try {
     while (true) {
       const { value, done: isDone } = await reader.read();
       if (isDone) break;
       buffer += decoder.decode(value, { stream: true });
-      const events = buffer.split("\n\n");
-      buffer = events.pop() || "";
+      const { events, remainder } = splitSseEvents(buffer);
+      buffer = remainder;
       for (const event of events) {
-        if (event.startsWith("data: ")) {
-          const data = event.slice(6);
-          if (data === "[DONE]") return;
-          yield JSON.parse(data);
-        }
+        const data = getEventData(event);
+        if (!data) continue;
+        if (data.trim() === "[DONE]") return;
+        yield parseEventData(data);
       }
     }
   } finally {
     reader.releaseLock();
   }
 }
+function splitSseEvents(buffer) {
+  const normalized = buffer.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+  const parts = normalized.split("\n\n");
+  const remainder = parts.pop() ?? EMPTY_STRING;
+  return { events: parts, remainder };
+}
+function getEventData(event) {
+  if (!event.trim()) return null;
+  const dataLines = event.split("\n").filter((line) => line.startsWith("data:"));
+  if (!dataLines.length) return null;
+  const data = dataLines.map((line) => line.startsWith("data: ") ? line.slice(6) : line.slice(5).replace(/^ /, "")).join("\n");
+  return data || null;
+}
+function parseEventData(data) {
+  try {
+    return JSON.parse(data);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const preview = data.length > 200 ? `${data.slice(0, 200)}...` : data;
+    throw new Error(`LLM stream parse error: ${message}. Data: ${preview}`);
+  }
+}
 export {
   callLlm
 };

package/dist/octokit.d.mts

@@ -3,12 +3,12 @@ import * as _octokit_plugin_paginate_graphql from '@octokit/plugin-paginate-grap
 import * as _octokit_plugin_rest_endpoint_methods from '@octokit/plugin-rest-endpoint-methods';
 export { RestEndpointMethodTypes } from '@octokit/plugin-rest-endpoint-methods';
 import * as _octokit_plugin_paginate_rest from '@octokit/plugin-paginate-rest';
-import * as _octokit_webhooks_node_modules__octokit_request_error from '@octokit/webhooks/node_modules/@octokit/request-error';
+import * as _octokit_request_error from '@octokit/request-error';
 import { Octokit } from '@octokit/core';
 
 declare const customOctokit: typeof Octokit & _octokit_core_types.Constructor<{
     retry: {
-        retryRequest: (error: _octokit_webhooks_node_modules__octokit_request_error.RequestError, retries: number, retryAfter: number) => _octokit_webhooks_node_modules__octokit_request_error.RequestError;
+        retryRequest: (error: _octokit_request_error.RequestError, retries: number, retryAfter: number) => _octokit_request_error.RequestError;
     };
 } & {
     paginate: _octokit_plugin_paginate_rest.PaginateInterface;

package/dist/octokit.d.ts

@@ -3,12 +3,12 @@ import * as _octokit_plugin_paginate_graphql from '@octokit/plugin-paginate-grap
 import * as _octokit_plugin_rest_endpoint_methods from '@octokit/plugin-rest-endpoint-methods';
 export { RestEndpointMethodTypes } from '@octokit/plugin-rest-endpoint-methods';
 import * as _octokit_plugin_paginate_rest from '@octokit/plugin-paginate-rest';
-import * as _octokit_webhooks_node_modules__octokit_request_error from '@octokit/webhooks/node_modules/@octokit/request-error';
+import * as _octokit_request_error from '@octokit/request-error';
 import { Octokit } from '@octokit/core';
 
 declare const customOctokit: typeof Octokit & _octokit_core_types.Constructor<{
     retry: {
-        retryRequest: (error: _octokit_webhooks_node_modules__octokit_request_error.RequestError, retries: number, retryAfter: number) => _octokit_webhooks_node_modules__octokit_request_error.RequestError;
+        retryRequest: (error: _octokit_request_error.RequestError, retries: number, retryAfter: number) => _octokit_request_error.RequestError;
     };
 } & {
     paginate: _octokit_plugin_paginate_rest.PaginateInterface;