@ubiquity-os/plugin-sdk 3.5.4 → 3.6.0

package/README.md

@@ -17,6 +17,10 @@ The `createActionsPlugin` function allows users to create plugins that will be a
 
 The `createPlugin` function enables users to create a plugin that will run on Cloudflare Workers environment.
 
+### `callLlm`
+
+The `callLlm` function sends chat completion requests to `ai.ubq.fi` using the auth token and repository context supplied by the kernel.
+
 ### `postComment`
 
 The `postComment` function enables users to easily post a comment to an issue, a pull-request, or a pull request review thread.
@@ -59,6 +63,19 @@ To start Jest tests, run:
 bun run test
 ```
 
+## LLM Utility
+
+```ts
+import { callLlm } from "@ubiquity-os/plugin-sdk";
+
+const result = await callLlm(
+  {
+    messages: [{ role: "user", content: "Summarize this issue." }],
+  },
+  context
+);
+```
+
 ## Markdown Cleaning Utility
 
 `cleanMarkdown` removes top-level HTML comments and configured HTML tags while preserving content inside fenced/indented code blocks, inline code spans, and blockquotes.

package/dist/configuration.d.mts

@@ -2,7 +2,7 @@ import { Value } from '@sinclair/typebox/value';
 import YAML from 'js-yaml';
 import * as _sinclair_typebox from '@sinclair/typebox';
 import { StaticDecode, TLiteral } from '@sinclair/typebox';
-import { C as Context } from './context-3Ck9sBZI.mjs';
+import { C as Context } from './context-sqbr2o6i.mjs';
 import { Manifest } from './manifest.mjs';
 import '@octokit/webhooks';
 import '@ubiquity-os/ubiquity-os-logger';
@@ -143,6 +143,7 @@ declare class ConfigurationHandler {
             [x: string]: any;
         } | undefined;
         skipBotEvents?: boolean | undefined;
+        homepage_url?: string | undefined;
         name: string;
         short_name: string;
     } | null>;

package/dist/configuration.d.ts

@@ -2,7 +2,7 @@ import { Value } from '@sinclair/typebox/value';
 import YAML from 'js-yaml';
 import * as _sinclair_typebox from '@sinclair/typebox';
 import { StaticDecode, TLiteral } from '@sinclair/typebox';
-import { C as Context } from './context-DOUnUNNN.js';
+import { C as Context } from './context-BbEmsEct.js';
 import { Manifest } from './manifest.js';
 import '@octokit/webhooks';
 import '@ubiquity-os/ubiquity-os-logger';
@@ -143,6 +143,7 @@ declare class ConfigurationHandler {
             [x: string]: any;
         } | undefined;
         skipBotEvents?: boolean | undefined;
+        homepage_url?: string | undefined;
         name: string;
         short_name: string;
     } | null>;

package/dist/configuration.js

@@ -110,7 +110,8 @@ var manifestSchema = import_typebox2.Type.Object({
   commands: import_typebox2.Type.Optional(import_typebox2.Type.Record(import_typebox2.Type.String({ pattern: "^[A-Za-z-_]+$" }), commandSchema, { default: {} })),
   "ubiquity:listeners": import_typebox2.Type.Optional(import_typebox2.Type.Array(runEvent, { default: [] })),
   configuration: import_typebox2.Type.Optional(import_typebox2.Type.Record(import_typebox2.Type.String(), import_typebox2.Type.Any(), { default: {} })),
-  skipBotEvents: import_typebox2.Type.Optional(import_typebox2.Type.Boolean({ default: true }))
+  skipBotEvents: import_typebox2.Type.Optional(import_typebox2.Type.Boolean({ default: true })),
+  homepage_url: import_typebox2.Type.Optional(import_typebox2.Type.String())
 });
 
 // src/configuration.ts

package/dist/configuration.mjs

@@ -73,7 +73,8 @@ var manifestSchema = T2.Object({
   commands: T2.Optional(T2.Record(T2.String({ pattern: "^[A-Za-z-_]+$" }), commandSchema, { default: {} })),
   "ubiquity:listeners": T2.Optional(T2.Array(runEvent, { default: [] })),
   configuration: T2.Optional(T2.Record(T2.String(), T2.Any(), { default: {} })),
-  skipBotEvents: T2.Optional(T2.Boolean({ default: true }))
+  skipBotEvents: T2.Optional(T2.Boolean({ default: true })),
+  homepage_url: T2.Optional(T2.String())
 });
 
 // src/configuration.ts

package/dist/{context-DOUnUNNN.d.ts → context-BbEmsEct.d.ts}

@@ -97,6 +97,8 @@ interface Context<TConfig = unknown, TEnv = unknown, TCommand = unknown, TSuppor
         [K in TSupportedEvents]: K extends EmitterWebhookEventName ? EmitterWebhookEvent<K> : never;
     }[TSupportedEvents]["payload"];
     command: TCommand | null;
+    authToken: string;
+    ubiquityKernelToken?: string;
     octokit: InstanceType<typeof customOctokit>;
     config: TConfig;
     env: TEnv;

package/dist/{context-3Ck9sBZI.d.mts → context-sqbr2o6i.d.mts}

@@ -97,6 +97,8 @@ interface Context<TConfig = unknown, TEnv = unknown, TCommand = unknown, TSuppor
         [K in TSupportedEvents]: K extends EmitterWebhookEventName ? EmitterWebhookEvent<K> : never;
     }[TSupportedEvents]["payload"];
     command: TCommand | null;
+    authToken: string;
+    ubiquityKernelToken?: string;
     octokit: InstanceType<typeof customOctokit>;
     config: TConfig;
     env: TEnv;

package/dist/index.d.mts

@@ -1,8 +1,9 @@
 import { EmitterWebhookEventName } from '@octokit/webhooks';
-import { C as Context } from './context-3Ck9sBZI.mjs';
-export { a as CommentHandler } from './context-3Ck9sBZI.mjs';
+import { C as Context } from './context-sqbr2o6i.mjs';
+export { a as CommentHandler } from './context-sqbr2o6i.mjs';
 import { TSchema, TAnySchema } from '@sinclair/typebox';
 import { LogLevel } from '@ubiquity-os/ubiquity-os-logger';
+export { LlmCallOptions, callLlm } from './llm.mjs';
 import * as hono_types from 'hono/types';
 import { Hono } from 'hono';
 import { Manifest } from './manifest.mjs';
@@ -13,6 +14,7 @@ import '@octokit/plugin-paginate-graphql';
 import '@octokit/plugin-paginate-rest';
 import '@octokit/webhooks/node_modules/@octokit/request-error';
 import '@octokit/core';
+import 'openai/resources/chat/completions';
 
 type Return = Record<string, unknown> | undefined | void;
 type HandlerReturn = Promise<Return> | Return;

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import { EmitterWebhookEventName } from '@octokit/webhooks';
-import { C as Context } from './context-DOUnUNNN.js';
-export { a as CommentHandler } from './context-DOUnUNNN.js';
+import { C as Context } from './context-BbEmsEct.js';
+export { a as CommentHandler } from './context-BbEmsEct.js';
 import { TSchema, TAnySchema } from '@sinclair/typebox';
 import { LogLevel } from '@ubiquity-os/ubiquity-os-logger';
+export { LlmCallOptions, callLlm } from './llm.js';
 import * as hono_types from 'hono/types';
 import { Hono } from 'hono';
 import { Manifest } from './manifest.js';
@@ -13,6 +14,7 @@ import '@octokit/plugin-paginate-graphql';
 import '@octokit/plugin-paginate-rest';
 import '@octokit/webhooks/node_modules/@octokit/request-error';
 import '@octokit/core';
+import 'openai/resources/chat/completions';
 
 type Return = Record<string, unknown> | undefined | void;
 type HandlerReturn = Promise<Return> | Return;

package/dist/index.js

@@ -31,6 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   CommentHandler: () => CommentHandler,
+  callLlm: () => callLlm,
   cleanMarkdown: () => cleanMarkdown,
   createActionsPlugin: () => createActionsPlugin,
   createPlugin: () => createPlugin,
@@ -427,6 +428,7 @@ async function verifySignature(publicKeyPem, inputs, signature) {
       eventPayload: inputs.eventPayload,
       settings: inputs.settings,
       authToken: inputs.authToken,
+      ubiquityKernelToken: inputs.ubiquityKernelToken,
       ref: inputs.ref,
       command: inputs.command
     };
@@ -475,6 +477,7 @@ var inputSchema = import_typebox3.Type.Object({
   eventPayload: jsonType(import_typebox3.Type.Record(import_typebox3.Type.String(), import_typebox3.Type.Any()), true),
   command: jsonType(commandCallSchema),
   authToken: import_typebox3.Type.String(),
+  ubiquityKernelToken: import_typebox3.Type.Optional(import_typebox3.Type.String()),
   settings: jsonType(import_typebox3.Type.Record(import_typebox3.Type.String(), import_typebox3.Type.Any())),
   ref: import_typebox3.Type.String(),
   signature: import_typebox3.Type.String()
@@ -543,6 +546,8 @@ async function createActionsPlugin(handler, options) {
     eventName: inputs.eventName,
     payload: inputs.eventPayload,
     command,
+    authToken: inputs.authToken,
+    ubiquityKernelToken: inputs.ubiquityKernelToken,
     octokit: new customOctokit({ auth: inputs.authToken }),
     config: config2,
     env,
@@ -625,6 +630,96 @@ function processSegment(segment, extraTags, shouldCollapseEmptyLines) {
   return s;
 }
 
+// src/llm/index.ts
+function normalizeBaseUrl(baseUrl) {
+  let normalized = baseUrl.trim();
+  while (normalized.endsWith("/")) {
+    normalized = normalized.slice(0, -1);
+  }
+  return normalized;
+}
+function getEnvString(name) {
+  if (typeof process === "undefined" || !process?.env) return "";
+  return String(process.env[name] ?? "").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");
+  if (envBaseUrl) return normalizeBaseUrl(envBaseUrl);
+  return "https://ai.ubq.fi";
+}
+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 { baseUrl, model, stream: isStream, messages, ...rest } = options;
+  const url = `${getAiBaseUrl({ ...options, baseUrl })}/v1/chat/completions`;
+  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 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}`);
+  }
+  if (isStream) {
+    if (!response.body) {
+      throw new Error("LLM API error: missing response body for streaming request");
+    }
+    return parseSseStream(response.body);
+  }
+  return response.json();
+}
+async function* parseSseStream(body) {
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  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() || "";
+      for (const event of events) {
+        if (event.startsWith("data: ")) {
+          const data = event.slice(6);
+          if (data === "[DONE]") return;
+          yield JSON.parse(data);
+        }
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
+
 // src/server.ts
 var import_value4 = require("@sinclair/typebox/value");
 var import_ubiquity_os_logger4 = require("@ubiquity-os/ubiquity-os-logger");
@@ -690,6 +785,8 @@ function createPlugin(handler, manifest, options) {
       eventName: inputs.eventName,
       payload: inputs.eventPayload,
       command,
+      authToken: inputs.authToken,
+      ubiquityKernelToken: inputs.ubiquityKernelToken,
       octokit: new customOctokit({ auth: inputs.authToken }),
       config: config2,
       env,
@@ -708,6 +805,7 @@ function createPlugin(handler, manifest, options) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CommentHandler,
+  callLlm,
   cleanMarkdown,
   createActionsPlugin,
   createPlugin,

package/dist/index.mjs

@@ -387,6 +387,7 @@ async function verifySignature(publicKeyPem, inputs, signature) {
       eventPayload: inputs.eventPayload,
       settings: inputs.settings,
       authToken: inputs.authToken,
+      ubiquityKernelToken: inputs.ubiquityKernelToken,
       ref: inputs.ref,
       command: inputs.command
     };
@@ -435,6 +436,7 @@ var inputSchema = T2.Object({
   eventPayload: jsonType(T2.Record(T2.String(), T2.Any()), true),
   command: jsonType(commandCallSchema),
   authToken: T2.String(),
+  ubiquityKernelToken: T2.Optional(T2.String()),
   settings: jsonType(T2.Record(T2.String(), T2.Any())),
   ref: T2.String(),
   signature: T2.String()
@@ -503,6 +505,8 @@ async function createActionsPlugin(handler, options) {
     eventName: inputs.eventName,
     payload: inputs.eventPayload,
     command,
+    authToken: inputs.authToken,
+    ubiquityKernelToken: inputs.ubiquityKernelToken,
     octokit: new customOctokit({ auth: inputs.authToken }),
     config: config2,
     env,
@@ -585,6 +589,96 @@ function processSegment(segment, extraTags, shouldCollapseEmptyLines) {
   return s;
 }
 
+// src/llm/index.ts
+function normalizeBaseUrl(baseUrl) {
+  let normalized = baseUrl.trim();
+  while (normalized.endsWith("/")) {
+    normalized = normalized.slice(0, -1);
+  }
+  return normalized;
+}
+function getEnvString(name) {
+  if (typeof process === "undefined" || !process?.env) return "";
+  return String(process.env[name] ?? "").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");
+  if (envBaseUrl) return normalizeBaseUrl(envBaseUrl);
+  return "https://ai.ubq.fi";
+}
+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 { baseUrl, model, stream: isStream, messages, ...rest } = options;
+  const url = `${getAiBaseUrl({ ...options, baseUrl })}/v1/chat/completions`;
+  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 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}`);
+  }
+  if (isStream) {
+    if (!response.body) {
+      throw new Error("LLM API error: missing response body for streaming request");
+    }
+    return parseSseStream(response.body);
+  }
+  return response.json();
+}
+async function* parseSseStream(body) {
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  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() || "";
+      for (const event of events) {
+        if (event.startsWith("data: ")) {
+          const data = event.slice(6);
+          if (data === "[DONE]") return;
+          yield JSON.parse(data);
+        }
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
+
 // src/server.ts
 import { Value as Value4 } from "@sinclair/typebox/value";
 import { Logs as Logs2 } from "@ubiquity-os/ubiquity-os-logger";
@@ -650,6 +744,8 @@ function createPlugin(handler, manifest, options) {
       eventName: inputs.eventName,
       payload: inputs.eventPayload,
       command,
+      authToken: inputs.authToken,
+      ubiquityKernelToken: inputs.ubiquityKernelToken,
       octokit: new customOctokit({ auth: inputs.authToken }),
       config: config2,
       env,
@@ -667,6 +763,7 @@ function createPlugin(handler, manifest, options) {
 }
 export {
   CommentHandler,
+  callLlm,
   cleanMarkdown,
   createActionsPlugin,
   createPlugin,

package/dist/llm.d.mts

@@ -0,0 +1,60 @@
+import { ChatCompletionMessageParam, ChatCompletion, ChatCompletionChunk } from 'openai/resources/chat/completions';
+import { C as Context } from './context-sqbr2o6i.mjs';
+import '@octokit/webhooks';
+import '@ubiquity-os/ubiquity-os-logger';
+import '@octokit/plugin-rest-endpoint-methods';
+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/core';
+
+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>>;
+
+export { type LlmCallOptions, callLlm };

package/dist/llm.d.ts

@@ -0,0 +1,60 @@
+import { ChatCompletionMessageParam, ChatCompletion, ChatCompletionChunk } from 'openai/resources/chat/completions';
+import { C as Context } from './context-BbEmsEct.js';
+import '@octokit/webhooks';
+import '@ubiquity-os/ubiquity-os-logger';
+import '@octokit/plugin-rest-endpoint-methods';
+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/core';
+
+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>>;
+
+export { type LlmCallOptions, callLlm };

package/dist/llm.js

@@ -0,0 +1,117 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/llm/index.ts
+var llm_exports = {};
+__export(llm_exports, {
+  callLlm: () => callLlm
+});
+module.exports = __toCommonJS(llm_exports);
+function normalizeBaseUrl(baseUrl) {
+  let normalized = baseUrl.trim();
+  while (normalized.endsWith("/")) {
+    normalized = normalized.slice(0, -1);
+  }
+  return normalized;
+}
+function getEnvString(name) {
+  if (typeof process === "undefined" || !process?.env) return "";
+  return String(process.env[name] ?? "").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");
+  if (envBaseUrl) return normalizeBaseUrl(envBaseUrl);
+  return "https://ai.ubq.fi";
+}
+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 { baseUrl, model, stream: isStream, messages, ...rest } = options;
+  const url = `${getAiBaseUrl({ ...options, baseUrl })}/v1/chat/completions`;
+  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 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}`);
+  }
+  if (isStream) {
+    if (!response.body) {
+      throw new Error("LLM API error: missing response body for streaming request");
+    }
+    return parseSseStream(response.body);
+  }
+  return response.json();
+}
+async function* parseSseStream(body) {
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  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() || "";
+      for (const event of events) {
+        if (event.startsWith("data: ")) {
+          const data = event.slice(6);
+          if (data === "[DONE]") return;
+          yield JSON.parse(data);
+        }
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  callLlm
+});

package/dist/llm.mjs

@@ -0,0 +1,92 @@
+// src/llm/index.ts
+function normalizeBaseUrl(baseUrl) {
+  let normalized = baseUrl.trim();
+  while (normalized.endsWith("/")) {
+    normalized = normalized.slice(0, -1);
+  }
+  return normalized;
+}
+function getEnvString(name) {
+  if (typeof process === "undefined" || !process?.env) return "";
+  return String(process.env[name] ?? "").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");
+  if (envBaseUrl) return normalizeBaseUrl(envBaseUrl);
+  return "https://ai.ubq.fi";
+}
+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 { baseUrl, model, stream: isStream, messages, ...rest } = options;
+  const url = `${getAiBaseUrl({ ...options, baseUrl })}/v1/chat/completions`;
+  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 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}`);
+  }
+  if (isStream) {
+    if (!response.body) {
+      throw new Error("LLM API error: missing response body for streaming request");
+    }
+    return parseSseStream(response.body);
+  }
+  return response.json();
+}
+async function* parseSseStream(body) {
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  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() || "";
+      for (const event of events) {
+        if (event.startsWith("data: ")) {
+          const data = event.slice(6);
+          if (data === "[DONE]") return;
+          yield JSON.parse(data);
+        }
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
+export {
+  callLlm
+};

package/dist/manifest.d.mts

@@ -43,6 +43,7 @@ declare const manifestSchema: _sinclair_typebox.TObject<{
     "ubiquity:listeners": _sinclair_typebox.TOptional<_sinclair_typebox.TArray<_sinclair_typebox.TUnion<_sinclair_typebox.TLiteral<"branch_protection_configuration" | "branch_protection_configuration.disabled" | "branch_protection_configuration.enabled" | "branch_protection_rule" | "branch_protection_rule.created" | "branch_protection_rule.deleted" | "branch_protection_rule.edited" | "check_run" | "check_run.completed" | "check_run.created" | "check_run.requested_action" | "check_run.rerequested" | "check_suite" | "check_suite.completed" | "check_suite.requested" | "check_suite.rerequested" | "code_scanning_alert" | "code_scanning_alert.appeared_in_branch" | "code_scanning_alert.closed_by_user" | "code_scanning_alert.created" | "code_scanning_alert.fixed" | "code_scanning_alert.reopened" | "code_scanning_alert.reopened_by_user" | "commit_comment" | "commit_comment.created" | "create" | "custom_property" | "custom_property.created" | "custom_property.deleted" | "custom_property.promote_to_enterprise" | "custom_property.updated" | "custom_property_values" | "custom_property_values.updated" | "delete" | "dependabot_alert" | "dependabot_alert.auto_dismissed" | "dependabot_alert.auto_reopened" | "dependabot_alert.created" | "dependabot_alert.dismissed" | "dependabot_alert.fixed" | "dependabot_alert.reintroduced" | "dependabot_alert.reopened" | "deploy_key" | "deploy_key.created" | "deploy_key.deleted" | "deployment" | "deployment.created" | "deployment_protection_rule" | "deployment_protection_rule.requested" | "deployment_review" | "deployment_review.approved" | "deployment_review.rejected" | "deployment_review.requested" | "deployment_status" | "deployment_status.created" | "discussion" | "discussion.answered" | "discussion.category_changed" | "discussion.closed" | "discussion.created" | "discussion.deleted" | "discussion.edited" | "discussion.labeled" | "discussion.locked" | "discussion.pinned" | "discussion.reopened" | "discussion.transferred" | "discussion.unanswered" | "discussion.unlabeled" | "discussion.unlocked" | "discussion.unpinned" | "discussion_comment" | "discussion_comment.created" | "discussion_comment.deleted" | "discussion_comment.edited" | "fork" | "github_app_authorization" | "github_app_authorization.revoked" | "gollum" | "installation" | "installation.created" | "installation.deleted" | "installation.new_permissions_accepted" | "installation.suspend" | "installation.unsuspend" | "installation_repositories" | "installation_repositories.added" | "installation_repositories.removed" | "installation_target" | "installation_target.renamed" | "issue_comment" | "issue_comment.created" | "issue_comment.deleted" | "issue_comment.edited" | "issues" | "issues.assigned" | "issues.closed" | "issues.deleted" | "issues.demilestoned" | "issues.edited" | "issues.labeled" | "issues.locked" | "issues.milestoned" | "issues.opened" | "issues.pinned" | "issues.reopened" | "issues.transferred" | "issues.typed" | "issues.unassigned" | "issues.unlabeled" | "issues.unlocked" | "issues.unpinned" | "issues.untyped" | "label" | "label.created" | "label.deleted" | "label.edited" | "marketplace_purchase" | "marketplace_purchase.cancelled" | "marketplace_purchase.changed" | "marketplace_purchase.pending_change" | "marketplace_purchase.pending_change_cancelled" | "marketplace_purchase.purchased" | "member" | "member.added" | "member.edited" | "member.removed" | "membership" | "membership.added" | "membership.removed" | "merge_group" | "merge_group.checks_requested" | "merge_group.destroyed" | "meta" | "meta.deleted" | "milestone" | "milestone.closed" | "milestone.created" | "milestone.deleted" | "milestone.edited" | "milestone.opened" | "org_block" | "org_block.blocked" | "org_block.unblocked" | "organization" | "organization.deleted" | "organization.member_added" | "organization.member_invited" | "organization.member_removed" | "organization.renamed" | "package" | "package.published" | "package.updated" | "page_build" | "personal_access_token_request" | "personal_access_token_request.approved" | "personal_access_token_request.cancelled" | "personal_access_token_request.created" | "personal_access_token_request.denied" | "ping" | "project" | "project.closed" | "project.created" | "project.deleted" | "project.edited" | "project.reopened" | "project_card" | "project_card.converted" | "project_card.created" | "project_card.deleted" | "project_card.edited" | "project_card.moved" | "project_column" | "project_column.created" | "project_column.deleted" | "project_column.edited" | "project_column.moved" | "projects_v2" | "projects_v2.closed" | "projects_v2.created" | "projects_v2.deleted" | "projects_v2.edited" | "projects_v2.reopened" | "projects_v2_item" | "projects_v2_item.archived" | "projects_v2_item.converted" | "projects_v2_item.created" | "projects_v2_item.deleted" | "projects_v2_item.edited" | "projects_v2_item.reordered" | "projects_v2_item.restored" | "projects_v2_status_update" | "projects_v2_status_update.created" | "projects_v2_status_update.deleted" | "projects_v2_status_update.edited" | "public" | "pull_request" | "pull_request.assigned" | "pull_request.auto_merge_disabled" | "pull_request.auto_merge_enabled" | "pull_request.closed" | "pull_request.converted_to_draft" | "pull_request.demilestoned" | "pull_request.dequeued" | "pull_request.edited" | "pull_request.enqueued" | "pull_request.labeled" | "pull_request.locked" | "pull_request.milestoned" | "pull_request.opened" | "pull_request.ready_for_review" | "pull_request.reopened" | "pull_request.review_request_removed" | "pull_request.review_requested" | "pull_request.synchronize" | "pull_request.unassigned" | "pull_request.unlabeled" | "pull_request.unlocked" | "pull_request_review" | "pull_request_review.dismissed" | "pull_request_review.edited" | "pull_request_review.submitted" | "pull_request_review_comment" | "pull_request_review_comment.created" | "pull_request_review_comment.deleted" | "pull_request_review_comment.edited" | "pull_request_review_thread" | "pull_request_review_thread.resolved" | "pull_request_review_thread.unresolved" | "push" | "registry_package" | "registry_package.published" | "registry_package.updated" | "release" | "release.created" | "release.deleted" | "release.edited" | "release.prereleased" | "release.published" | "release.released" | "release.unpublished" | "repository" | "repository.archived" | "repository.created" | "repository.deleted" | "repository.edited" | "repository.privatized" | "repository.publicized" | "repository.renamed" | "repository.transferred" | "repository.unarchived" | "repository_advisory" | "repository_advisory.published" | "repository_advisory.reported" | "repository_dispatch" | "repository_dispatch.sample.collected" | "repository_import" | "repository_ruleset" | "repository_ruleset.created" | "repository_ruleset.deleted" | "repository_ruleset.edited" | "repository_vulnerability_alert" | "repository_vulnerability_alert.create" | "repository_vulnerability_alert.dismiss" | "repository_vulnerability_alert.reopen" | "repository_vulnerability_alert.resolve" | "secret_scanning_alert" | "secret_scanning_alert.created" | "secret_scanning_alert.publicly_leaked" | "secret_scanning_alert.reopened" | "secret_scanning_alert.resolved" | "secret_scanning_alert.validated" | "secret_scanning_alert_location" | "secret_scanning_alert_location.created" | "secret_scanning_scan" | "secret_scanning_scan.completed" | "security_advisory" | "security_advisory.published" | "security_advisory.updated" | "security_advisory.withdrawn" | "security_and_analysis" | "sponsorship" | "sponsorship.cancelled" | "sponsorship.created" | "sponsorship.edited" | "sponsorship.pending_cancellation" | "sponsorship.pending_tier_change" | "sponsorship.tier_changed" | "star" | "star.created" | "star.deleted" | "status" | "sub_issues" | "sub_issues.parent_issue_added" | "sub_issues.parent_issue_removed" | "sub_issues.sub_issue_added" | "sub_issues.sub_issue_removed" | "team" | "team.added_to_repository" | "team.created" | "team.deleted" | "team.edited" | "team.removed_from_repository" | "team_add" | "watch" | "watch.started" | "workflow_dispatch" | "workflow_job" | "workflow_job.completed" | "workflow_job.in_progress" | "workflow_job.queued" | "workflow_job.waiting" | "workflow_run" | "workflow_run.completed" | "workflow_run.in_progress" | "workflow_run.requested">[]>>>;
     configuration: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TAny>>;
     skipBotEvents: _sinclair_typebox.TOptional<_sinclair_typebox.TBoolean>;
+    homepage_url: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
 }>;
 type Manifest = Static<typeof manifestSchema>;
 

package/dist/manifest.d.ts

@@ -43,6 +43,7 @@ declare const manifestSchema: _sinclair_typebox.TObject<{
     "ubiquity:listeners": _sinclair_typebox.TOptional<_sinclair_typebox.TArray<_sinclair_typebox.TUnion<_sinclair_typebox.TLiteral<"branch_protection_configuration" | "branch_protection_configuration.disabled" | "branch_protection_configuration.enabled" | "branch_protection_rule" | "branch_protection_rule.created" | "branch_protection_rule.deleted" | "branch_protection_rule.edited" | "check_run" | "check_run.completed" | "check_run.created" | "check_run.requested_action" | "check_run.rerequested" | "check_suite" | "check_suite.completed" | "check_suite.requested" | "check_suite.rerequested" | "code_scanning_alert" | "code_scanning_alert.appeared_in_branch" | "code_scanning_alert.closed_by_user" | "code_scanning_alert.created" | "code_scanning_alert.fixed" | "code_scanning_alert.reopened" | "code_scanning_alert.reopened_by_user" | "commit_comment" | "commit_comment.created" | "create" | "custom_property" | "custom_property.created" | "custom_property.deleted" | "custom_property.promote_to_enterprise" | "custom_property.updated" | "custom_property_values" | "custom_property_values.updated" | "delete" | "dependabot_alert" | "dependabot_alert.auto_dismissed" | "dependabot_alert.auto_reopened" | "dependabot_alert.created" | "dependabot_alert.dismissed" | "dependabot_alert.fixed" | "dependabot_alert.reintroduced" | "dependabot_alert.reopened" | "deploy_key" | "deploy_key.created" | "deploy_key.deleted" | "deployment" | "deployment.created" | "deployment_protection_rule" | "deployment_protection_rule.requested" | "deployment_review" | "deployment_review.approved" | "deployment_review.rejected" | "deployment_review.requested" | "deployment_status" | "deployment_status.created" | "discussion" | "discussion.answered" | "discussion.category_changed" | "discussion.closed" | "discussion.created" | "discussion.deleted" | "discussion.edited" | "discussion.labeled" | "discussion.locked" | "discussion.pinned" | "discussion.reopened" | "discussion.transferred" | "discussion.unanswered" | "discussion.unlabeled" | "discussion.unlocked" | "discussion.unpinned" | "discussion_comment" | "discussion_comment.created" | "discussion_comment.deleted" | "discussion_comment.edited" | "fork" | "github_app_authorization" | "github_app_authorization.revoked" | "gollum" | "installation" | "installation.created" | "installation.deleted" | "installation.new_permissions_accepted" | "installation.suspend" | "installation.unsuspend" | "installation_repositories" | "installation_repositories.added" | "installation_repositories.removed" | "installation_target" | "installation_target.renamed" | "issue_comment" | "issue_comment.created" | "issue_comment.deleted" | "issue_comment.edited" | "issues" | "issues.assigned" | "issues.closed" | "issues.deleted" | "issues.demilestoned" | "issues.edited" | "issues.labeled" | "issues.locked" | "issues.milestoned" | "issues.opened" | "issues.pinned" | "issues.reopened" | "issues.transferred" | "issues.typed" | "issues.unassigned" | "issues.unlabeled" | "issues.unlocked" | "issues.unpinned" | "issues.untyped" | "label" | "label.created" | "label.deleted" | "label.edited" | "marketplace_purchase" | "marketplace_purchase.cancelled" | "marketplace_purchase.changed" | "marketplace_purchase.pending_change" | "marketplace_purchase.pending_change_cancelled" | "marketplace_purchase.purchased" | "member" | "member.added" | "member.edited" | "member.removed" | "membership" | "membership.added" | "membership.removed" | "merge_group" | "merge_group.checks_requested" | "merge_group.destroyed" | "meta" | "meta.deleted" | "milestone" | "milestone.closed" | "milestone.created" | "milestone.deleted" | "milestone.edited" | "milestone.opened" | "org_block" | "org_block.blocked" | "org_block.unblocked" | "organization" | "organization.deleted" | "organization.member_added" | "organization.member_invited" | "organization.member_removed" | "organization.renamed" | "package" | "package.published" | "package.updated" | "page_build" | "personal_access_token_request" | "personal_access_token_request.approved" | "personal_access_token_request.cancelled" | "personal_access_token_request.created" | "personal_access_token_request.denied" | "ping" | "project" | "project.closed" | "project.created" | "project.deleted" | "project.edited" | "project.reopened" | "project_card" | "project_card.converted" | "project_card.created" | "project_card.deleted" | "project_card.edited" | "project_card.moved" | "project_column" | "project_column.created" | "project_column.deleted" | "project_column.edited" | "project_column.moved" | "projects_v2" | "projects_v2.closed" | "projects_v2.created" | "projects_v2.deleted" | "projects_v2.edited" | "projects_v2.reopened" | "projects_v2_item" | "projects_v2_item.archived" | "projects_v2_item.converted" | "projects_v2_item.created" | "projects_v2_item.deleted" | "projects_v2_item.edited" | "projects_v2_item.reordered" | "projects_v2_item.restored" | "projects_v2_status_update" | "projects_v2_status_update.created" | "projects_v2_status_update.deleted" | "projects_v2_status_update.edited" | "public" | "pull_request" | "pull_request.assigned" | "pull_request.auto_merge_disabled" | "pull_request.auto_merge_enabled" | "pull_request.closed" | "pull_request.converted_to_draft" | "pull_request.demilestoned" | "pull_request.dequeued" | "pull_request.edited" | "pull_request.enqueued" | "pull_request.labeled" | "pull_request.locked" | "pull_request.milestoned" | "pull_request.opened" | "pull_request.ready_for_review" | "pull_request.reopened" | "pull_request.review_request_removed" | "pull_request.review_requested" | "pull_request.synchronize" | "pull_request.unassigned" | "pull_request.unlabeled" | "pull_request.unlocked" | "pull_request_review" | "pull_request_review.dismissed" | "pull_request_review.edited" | "pull_request_review.submitted" | "pull_request_review_comment" | "pull_request_review_comment.created" | "pull_request_review_comment.deleted" | "pull_request_review_comment.edited" | "pull_request_review_thread" | "pull_request_review_thread.resolved" | "pull_request_review_thread.unresolved" | "push" | "registry_package" | "registry_package.published" | "registry_package.updated" | "release" | "release.created" | "release.deleted" | "release.edited" | "release.prereleased" | "release.published" | "release.released" | "release.unpublished" | "repository" | "repository.archived" | "repository.created" | "repository.deleted" | "repository.edited" | "repository.privatized" | "repository.publicized" | "repository.renamed" | "repository.transferred" | "repository.unarchived" | "repository_advisory" | "repository_advisory.published" | "repository_advisory.reported" | "repository_dispatch" | "repository_dispatch.sample.collected" | "repository_import" | "repository_ruleset" | "repository_ruleset.created" | "repository_ruleset.deleted" | "repository_ruleset.edited" | "repository_vulnerability_alert" | "repository_vulnerability_alert.create" | "repository_vulnerability_alert.dismiss" | "repository_vulnerability_alert.reopen" | "repository_vulnerability_alert.resolve" | "secret_scanning_alert" | "secret_scanning_alert.created" | "secret_scanning_alert.publicly_leaked" | "secret_scanning_alert.reopened" | "secret_scanning_alert.resolved" | "secret_scanning_alert.validated" | "secret_scanning_alert_location" | "secret_scanning_alert_location.created" | "secret_scanning_scan" | "secret_scanning_scan.completed" | "security_advisory" | "security_advisory.published" | "security_advisory.updated" | "security_advisory.withdrawn" | "security_and_analysis" | "sponsorship" | "sponsorship.cancelled" | "sponsorship.created" | "sponsorship.edited" | "sponsorship.pending_cancellation" | "sponsorship.pending_tier_change" | "sponsorship.tier_changed" | "star" | "star.created" | "star.deleted" | "status" | "sub_issues" | "sub_issues.parent_issue_added" | "sub_issues.parent_issue_removed" | "sub_issues.sub_issue_added" | "sub_issues.sub_issue_removed" | "team" | "team.added_to_repository" | "team.created" | "team.deleted" | "team.edited" | "team.removed_from_repository" | "team_add" | "watch" | "watch.started" | "workflow_dispatch" | "workflow_job" | "workflow_job.completed" | "workflow_job.in_progress" | "workflow_job.queued" | "workflow_job.waiting" | "workflow_run" | "workflow_run.completed" | "workflow_run.in_progress" | "workflow_run.requested">[]>>>;
     configuration: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TAny>>;
     skipBotEvents: _sinclair_typebox.TOptional<_sinclair_typebox.TBoolean>;
+    homepage_url: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
 }>;
 type Manifest = Static<typeof manifestSchema>;
 

package/dist/manifest.js

@@ -50,7 +50,8 @@ var manifestSchema = import_typebox.Type.Object({
   commands: import_typebox.Type.Optional(import_typebox.Type.Record(import_typebox.Type.String({ pattern: "^[A-Za-z-_]+$" }), commandSchema, { default: {} })),
   "ubiquity:listeners": import_typebox.Type.Optional(import_typebox.Type.Array(runEvent, { default: [] })),
   configuration: import_typebox.Type.Optional(import_typebox.Type.Record(import_typebox.Type.String(), import_typebox.Type.Any(), { default: {} })),
-  skipBotEvents: import_typebox.Type.Optional(import_typebox.Type.Boolean({ default: true }))
+  skipBotEvents: import_typebox.Type.Optional(import_typebox.Type.Boolean({ default: true })),
+  homepage_url: import_typebox.Type.Optional(import_typebox.Type.String())
 });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/manifest.mjs

@@ -23,7 +23,8 @@ var manifestSchema = T.Object({
   commands: T.Optional(T.Record(T.String({ pattern: "^[A-Za-z-_]+$" }), commandSchema, { default: {} })),
   "ubiquity:listeners": T.Optional(T.Array(runEvent, { default: [] })),
   configuration: T.Optional(T.Record(T.String(), T.Any(), { default: {} })),
-  skipBotEvents: T.Optional(T.Boolean({ default: true }))
+  skipBotEvents: T.Optional(T.Boolean({ default: true })),
+  homepage_url: T.Optional(T.String())
 });
 export {
   commandSchema,

package/dist/signature.d.mts

@@ -15,9 +15,10 @@ declare class PluginInput<T extends EmitterWebhookEventName = EmitterWebhookEven
     eventPayload: EmitterWebhookEvent<T>["payload"];
     settings: unknown;
     authToken: string;
+    ubiquityKernelToken?: string;
     ref: string;
     command: CommandCall;
-    constructor(privateKey: string, stateId: string, eventName: T, eventPayload: EmitterWebhookEvent<T>["payload"], settings: unknown, authToken: string, ref: string, command: CommandCall);
+    constructor(privateKey: string, stateId: string, eventName: T, eventPayload: EmitterWebhookEvent<T>["payload"], settings: unknown, authToken: string, ref: string, command: CommandCall, ubiquityKernelToken?: string);
     getInputs(): Promise<{
         signature: string;
         stateId: string;
@@ -25,6 +26,7 @@ declare class PluginInput<T extends EmitterWebhookEventName = EmitterWebhookEven
         eventPayload: string;
         settings: string;
         authToken: string;
+        ubiquityKernelToken: string | undefined;
         ref: string;
         command: string;
     }>;
@@ -34,6 +36,7 @@ interface Inputs {
     eventName: unknown;
     eventPayload: unknown;
     authToken: unknown;
+    ubiquityKernelToken?: unknown;
     settings: unknown;
     ref: unknown;
     command: unknown;

package/dist/signature.d.ts

@@ -15,9 +15,10 @@ declare class PluginInput<T extends EmitterWebhookEventName = EmitterWebhookEven
     eventPayload: EmitterWebhookEvent<T>["payload"];
     settings: unknown;
     authToken: string;
+    ubiquityKernelToken?: string;
     ref: string;
     command: CommandCall;
-    constructor(privateKey: string, stateId: string, eventName: T, eventPayload: EmitterWebhookEvent<T>["payload"], settings: unknown, authToken: string, ref: string, command: CommandCall);
+    constructor(privateKey: string, stateId: string, eventName: T, eventPayload: EmitterWebhookEvent<T>["payload"], settings: unknown, authToken: string, ref: string, command: CommandCall, ubiquityKernelToken?: string);
     getInputs(): Promise<{
         signature: string;
         stateId: string;
@@ -25,6 +26,7 @@ declare class PluginInput<T extends EmitterWebhookEventName = EmitterWebhookEven
         eventPayload: string;
         settings: string;
         authToken: string;
+        ubiquityKernelToken: string | undefined;
         ref: string;
         command: string;
     }>;
@@ -34,6 +36,7 @@ interface Inputs {
     eventName: unknown;
     eventPayload: unknown;
     authToken: unknown;
+    ubiquityKernelToken?: unknown;
     settings: unknown;
     ref: unknown;
     command: unknown;

package/dist/signature.js

@@ -42,9 +42,10 @@ var PluginInput = class {
   eventPayload;
   settings;
   authToken;
+  ubiquityKernelToken;
   ref;
   command;
-  constructor(privateKey, stateId, eventName, eventPayload, settings, authToken, ref, command) {
+  constructor(privateKey, stateId, eventName, eventPayload, settings, authToken, ref, command, ubiquityKernelToken) {
     this._privateKey = privateKey;
     this.stateId = stateId;
     this.eventName = eventName;
@@ -53,6 +54,7 @@ var PluginInput = class {
     this.authToken = authToken;
     this.ref = ref;
     this.command = command;
+    this.ubiquityKernelToken = ubiquityKernelToken;
   }
   async getInputs() {
     const inputs = {
@@ -61,6 +63,7 @@ var PluginInput = class {
       eventPayload: compressString(JSON.stringify(this.eventPayload)),
       settings: JSON.stringify(this.settings),
       authToken: this.authToken,
+      ubiquityKernelToken: this.ubiquityKernelToken,
       ref: this.ref,
       command: JSON.stringify(this.command)
     };
@@ -79,6 +82,7 @@ async function verifySignature(publicKeyPem, inputs, signature) {
       eventPayload: inputs.eventPayload,
       settings: inputs.settings,
       authToken: inputs.authToken,
+      ubiquityKernelToken: inputs.ubiquityKernelToken,
       ref: inputs.ref,
       command: inputs.command
     };

package/dist/signature.mjs

@@ -14,9 +14,10 @@ var PluginInput = class {
   eventPayload;
   settings;
   authToken;
+  ubiquityKernelToken;
   ref;
   command;
-  constructor(privateKey, stateId, eventName, eventPayload, settings, authToken, ref, command) {
+  constructor(privateKey, stateId, eventName, eventPayload, settings, authToken, ref, command, ubiquityKernelToken) {
     this._privateKey = privateKey;
     this.stateId = stateId;
     this.eventName = eventName;
@@ -25,6 +26,7 @@ var PluginInput = class {
     this.authToken = authToken;
     this.ref = ref;
     this.command = command;
+    this.ubiquityKernelToken = ubiquityKernelToken;
   }
   async getInputs() {
     const inputs = {
@@ -33,6 +35,7 @@ var PluginInput = class {
       eventPayload: compressString(JSON.stringify(this.eventPayload)),
       settings: JSON.stringify(this.settings),
       authToken: this.authToken,
+      ubiquityKernelToken: this.ubiquityKernelToken,
       ref: this.ref,
       command: JSON.stringify(this.command)
     };
@@ -51,6 +54,7 @@ async function verifySignature(publicKeyPem, inputs, signature) {
       eventPayload: inputs.eventPayload,
       settings: inputs.settings,
       authToken: inputs.authToken,
+      ubiquityKernelToken: inputs.ubiquityKernelToken,
       ref: inputs.ref,
       command: inputs.command
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubiquity-os/plugin-sdk",
-  "version": "3.5.4",
+  "version": "3.6.0",
   "description": "SDK for plugin support.",
   "author": "Ubiquity DAO",
   "license": "MIT",
@@ -33,6 +33,9 @@
       ],
       "configuration": [
         "dist/configuration.d.ts"
+      ],
+      "llm": [
+        "dist/llm.d.ts"
       ]
     }
   },
@@ -76,6 +79,11 @@
       "types": "./dist/configuration.d.ts",
       "import": "./dist/configuration.mjs",
       "require": "./dist/configuration.js"
+    },
+    "./llm": {
+      "types": "./dist/llm.d.ts",
+      "import": "./dist/llm.mjs",
+      "require": "./dist/llm.js"
     }
   },
   "files": [
@@ -113,7 +121,8 @@
     "@ubiquity-os/ubiquity-os-logger": "^1.4.0",
     "dotenv": "^17.2.3",
     "hono": "^4.10.6",
-    "js-yaml": "^4.1.1"
+    "js-yaml": "^4.1.1",
+    "openai": "^4.70.2"
   },
   "peerDependencies": {
     "@sinclair/typebox": "0.34.41"