@objectstack/service-ai 6.8.1 → 6.9.0

package/dist/index.d.cts

@@ -308,6 +308,20 @@ declare class AIService implements IAIService {
     private readonly pendingDispatchers;
     /** Data engine for `ai_pending_actions` persistence. */
     private readonly dataEngine?;
+    /**
+     * Auto-title configuration. When `enabled`, the first `chatWithTools` /
+     * `streamChatWithTools` call against a still-untitled conversation
+     * triggers a one-shot LLM call (fire-and-forget) that summarises the
+     * exchange into a short title and PATCHes it onto the conversation row.
+     *
+     * Defaults to disabled — `AIServicePlugin` flips this on (with values
+     * read from the `ai` settings namespace) once the kernel is ready.
+     * Keeping the default off means unit tests don't accidentally make
+     * extra adapter calls.
+     */
+    private titleGeneration;
+    /** Tracks conversations we've already attempted to title to avoid duplicate LLM calls. */
+    private readonly titledConversations;
     constructor(config?: AIServiceConfig);
     /** The name of the active LLM adapter. */
     get adapterName(): string;
@@ -318,6 +332,36 @@ declare class AIService implements IAIService {
      * subsequent calls go through the new adapter.
      */
     setAdapter(next: LLMAdapter): void;
+    /**
+     * Configure conversation auto-titling. Called by `AIServicePlugin`
+     * when the `ai` settings namespace is bound (so admins can toggle
+     * the feature live from the Setup app without a restart).
+     *
+     * - `enabled=false` is the safe default for unit tests and the
+     *   memory adapter (which would just echo the prompt back as a title).
+     * - `maxLength` is enforced both in the prompt and as a hard server-side
+     *   `slice()` so a misbehaving model can't write a 4 KB "title".
+     */
+    setTitleGenerationConfig(config: {
+        enabled: boolean;
+        maxLength?: number;
+    }): void;
+    /**
+     * Best-effort title generation for a conversation. Idempotent per
+     * `AIService` instance — once attempted, the id is recorded in
+     * `titledConversations` so subsequent chats don't burn extra tokens
+     * re-summarising the same thread.
+     *
+     * Skips when:
+     * - feature disabled
+     * - conversation already has a non-empty title
+     * - conversation has fewer than 2 messages (no exchange to summarise)
+     * - conversation has no user message
+     *
+     * Failures are logged at debug level and swallowed — title generation
+     * is purely cosmetic and must never break chat.
+     */
+    summarizeConversation(conversationId: string): Promise<void>;
     /**
      * Best-effort auto-creation of a conversation when the caller did not
      * supply one but did supply an actor we can attribute the chat to.
@@ -2258,6 +2302,14 @@ declare const AiConversationObject: Omit<{
     } | undefined;
     recordTypes?: string[] | undefined;
     sharingModel?: "private" | "read" | "full" | "read_write" | undefined;
+    publicSharing?: {
+        enabled: boolean;
+        allowedAudiences?: ("email" | "public" | "link_only" | "signed_in")[] | undefined;
+        allowedPermissions?: ("edit" | "view" | "comment")[] | undefined;
+        maxExpiryDays?: number | undefined;
+        redactFields?: string[] | undefined;
+        eligibility?: string | undefined;
+    } | undefined;
     keyPrefix?: string | undefined;
     detail?: {
         [x: string]: unknown;
@@ -2348,6 +2400,13 @@ declare const AiConversationObject: Omit<{
     readonly icon: "message-square";
     readonly isSystem: true;
     readonly description: "Persistent AI conversation metadata";
+    readonly publicSharing: {
+        readonly enabled: true;
+        readonly allowedAudiences: ["link_only", "signed_in"];
+        readonly allowedPermissions: ["view"];
+        readonly maxExpiryDays: 90;
+        readonly redactFields: ["metadata"];
+    };
     readonly fields: {
         readonly id: {
             readonly readonly?: boolean | undefined;
@@ -4187,6 +4246,14 @@ declare const AiMessageObject: Omit<{
     } | undefined;
     recordTypes?: string[] | undefined;
     sharingModel?: "private" | "read" | "full" | "read_write" | undefined;
+    publicSharing?: {
+        enabled: boolean;
+        allowedAudiences?: ("email" | "public" | "link_only" | "signed_in")[] | undefined;
+        allowedPermissions?: ("edit" | "view" | "comment")[] | undefined;
+        maxExpiryDays?: number | undefined;
+        redactFields?: string[] | undefined;
+        eligibility?: string | undefined;
+    } | undefined;
     keyPrefix?: string | undefined;
     detail?: {
         [x: string]: unknown;
@@ -6118,6 +6185,14 @@ declare const AiTraceObject: Omit<{
     } | undefined;
     recordTypes?: string[] | undefined;
     sharingModel?: "private" | "read" | "full" | "read_write" | undefined;
+    publicSharing?: {
+        enabled: boolean;
+        allowedAudiences?: ("email" | "public" | "link_only" | "signed_in")[] | undefined;
+        allowedPermissions?: ("edit" | "view" | "comment")[] | undefined;
+        maxExpiryDays?: number | undefined;
+        redactFields?: string[] | undefined;
+        eligibility?: string | undefined;
+    } | undefined;
     keyPrefix?: string | undefined;
     detail?: {
         [x: string]: unknown;

package/dist/index.d.ts

@@ -308,6 +308,20 @@ declare class AIService implements IAIService {
     private readonly pendingDispatchers;
     /** Data engine for `ai_pending_actions` persistence. */
     private readonly dataEngine?;
+    /**
+     * Auto-title configuration. When `enabled`, the first `chatWithTools` /
+     * `streamChatWithTools` call against a still-untitled conversation
+     * triggers a one-shot LLM call (fire-and-forget) that summarises the
+     * exchange into a short title and PATCHes it onto the conversation row.
+     *
+     * Defaults to disabled — `AIServicePlugin` flips this on (with values
+     * read from the `ai` settings namespace) once the kernel is ready.
+     * Keeping the default off means unit tests don't accidentally make
+     * extra adapter calls.
+     */
+    private titleGeneration;
+    /** Tracks conversations we've already attempted to title to avoid duplicate LLM calls. */
+    private readonly titledConversations;
     constructor(config?: AIServiceConfig);
     /** The name of the active LLM adapter. */
     get adapterName(): string;
@@ -318,6 +332,36 @@ declare class AIService implements IAIService {
      * subsequent calls go through the new adapter.
      */
     setAdapter(next: LLMAdapter): void;
+    /**
+     * Configure conversation auto-titling. Called by `AIServicePlugin`
+     * when the `ai` settings namespace is bound (so admins can toggle
+     * the feature live from the Setup app without a restart).
+     *
+     * - `enabled=false` is the safe default for unit tests and the
+     *   memory adapter (which would just echo the prompt back as a title).
+     * - `maxLength` is enforced both in the prompt and as a hard server-side
+     *   `slice()` so a misbehaving model can't write a 4 KB "title".
+     */
+    setTitleGenerationConfig(config: {
+        enabled: boolean;
+        maxLength?: number;
+    }): void;
+    /**
+     * Best-effort title generation for a conversation. Idempotent per
+     * `AIService` instance — once attempted, the id is recorded in
+     * `titledConversations` so subsequent chats don't burn extra tokens
+     * re-summarising the same thread.
+     *
+     * Skips when:
+     * - feature disabled
+     * - conversation already has a non-empty title
+     * - conversation has fewer than 2 messages (no exchange to summarise)
+     * - conversation has no user message
+     *
+     * Failures are logged at debug level and swallowed — title generation
+     * is purely cosmetic and must never break chat.
+     */
+    summarizeConversation(conversationId: string): Promise<void>;
     /**
      * Best-effort auto-creation of a conversation when the caller did not
      * supply one but did supply an actor we can attribute the chat to.
@@ -2258,6 +2302,14 @@ declare const AiConversationObject: Omit<{
     } | undefined;
     recordTypes?: string[] | undefined;
     sharingModel?: "private" | "read" | "full" | "read_write" | undefined;
+    publicSharing?: {
+        enabled: boolean;
+        allowedAudiences?: ("email" | "public" | "link_only" | "signed_in")[] | undefined;
+        allowedPermissions?: ("edit" | "view" | "comment")[] | undefined;
+        maxExpiryDays?: number | undefined;
+        redactFields?: string[] | undefined;
+        eligibility?: string | undefined;
+    } | undefined;
     keyPrefix?: string | undefined;
     detail?: {
         [x: string]: unknown;
@@ -2348,6 +2400,13 @@ declare const AiConversationObject: Omit<{
     readonly icon: "message-square";
     readonly isSystem: true;
     readonly description: "Persistent AI conversation metadata";
+    readonly publicSharing: {
+        readonly enabled: true;
+        readonly allowedAudiences: ["link_only", "signed_in"];
+        readonly allowedPermissions: ["view"];
+        readonly maxExpiryDays: 90;
+        readonly redactFields: ["metadata"];
+    };
     readonly fields: {
         readonly id: {
             readonly readonly?: boolean | undefined;
@@ -4187,6 +4246,14 @@ declare const AiMessageObject: Omit<{
     } | undefined;
     recordTypes?: string[] | undefined;
     sharingModel?: "private" | "read" | "full" | "read_write" | undefined;
+    publicSharing?: {
+        enabled: boolean;
+        allowedAudiences?: ("email" | "public" | "link_only" | "signed_in")[] | undefined;
+        allowedPermissions?: ("edit" | "view" | "comment")[] | undefined;
+        maxExpiryDays?: number | undefined;
+        redactFields?: string[] | undefined;
+        eligibility?: string | undefined;
+    } | undefined;
     keyPrefix?: string | undefined;
     detail?: {
         [x: string]: unknown;
@@ -6118,6 +6185,14 @@ declare const AiTraceObject: Omit<{
     } | undefined;
     recordTypes?: string[] | undefined;
     sharingModel?: "private" | "read" | "full" | "read_write" | undefined;
+    publicSharing?: {
+        enabled: boolean;
+        allowedAudiences?: ("email" | "public" | "link_only" | "signed_in")[] | undefined;
+        allowedPermissions?: ("edit" | "view" | "comment")[] | undefined;
+        maxExpiryDays?: number | undefined;
+        redactFields?: string[] | undefined;
+        eligibility?: string | undefined;
+    } | undefined;
     keyPrefix?: string | undefined;
     detail?: {
         [x: string]: unknown;

package/dist/index.js

@@ -1450,6 +1450,36 @@ function finishPart(result) {
     rawFinishReason: "stop"
   };
 }
+function extractMessageText(message) {
+  const c = message.content;
+  if (typeof c === "string") return c;
+  if (!Array.isArray(c)) return "";
+  const parts = [];
+  for (const part of c) {
+    if (typeof part === "string") {
+      parts.push(part);
+    } else if (part && typeof part === "object") {
+      const p = part;
+      if (p.type === "text" && typeof p.text === "string") parts.push(p.text);
+    }
+  }
+  return parts.join(" ").trim();
+}
+function cleanTitle(raw, maxLen) {
+  let s = raw.replace(/\s+/g, " ").trim();
+  s = s.replace(/^[\s"'“”‘’`「『（(\[【]+/, "").replace(/[\s"'“”‘’`」』）)\]】]+$/, "");
+  s = s.replace(/^(title|标题|主题)\s*[:：]\s*/i, "");
+  s = s.replace(/^[\s"'“”‘’`「『（(\[【]+/, "").replace(/[\s"'“”‘’`」』）)\]】]+$/, "");
+  s = s.replace(/[.。!！?？,，;；:：]+$/, "").trim();
+  if (!s) return "";
+  if (s.length <= maxLen) return s;
+  if (/^[\x00-\x7F]+$/.test(s)) {
+    const cut = s.slice(0, maxLen);
+    const lastSpace = cut.lastIndexOf(" ");
+    return lastSpace > maxLen / 2 ? cut.slice(0, lastSpace) : cut;
+  }
+  return s.slice(0, maxLen);
+}
 var _AIService = class _AIService {
   constructor(config = {}) {
     /**
@@ -1459,6 +1489,23 @@ var _AIService = class _AIService {
      * through `approvePendingAction()`.
      */
     this.pendingDispatchers = /* @__PURE__ */ new Map();
+    /**
+     * Auto-title configuration. When `enabled`, the first `chatWithTools` /
+     * `streamChatWithTools` call against a still-untitled conversation
+     * triggers a one-shot LLM call (fire-and-forget) that summarises the
+     * exchange into a short title and PATCHes it onto the conversation row.
+     *
+     * Defaults to disabled — `AIServicePlugin` flips this on (with values
+     * read from the `ai` settings namespace) once the kernel is ready.
+     * Keeping the default off means unit tests don't accidentally make
+     * extra adapter calls.
+     */
+    this.titleGeneration = {
+      enabled: false,
+      maxLength: 16
+    };
+    /** Tracks conversations we've already attempted to title to avoid duplicate LLM calls. */
+    this.titledConversations = /* @__PURE__ */ new Set();
     this.adapter = config.adapter ?? new MemoryLLMAdapter();
     this.logger = config.logger ?? createLogger({ level: "info", format: "pretty" });
     this.toolRegistry = config.toolRegistry ?? new ToolRegistry();
@@ -1487,6 +1534,89 @@ var _AIService = class _AIService {
       this.logger.info(`[AI] LLM adapter swapped: ${prev} \u2192 ${next.name}`);
     }
   }
+  /**
+   * Configure conversation auto-titling. Called by `AIServicePlugin`
+   * when the `ai` settings namespace is bound (so admins can toggle
+   * the feature live from the Setup app without a restart).
+   *
+   * - `enabled=false` is the safe default for unit tests and the
+   *   memory adapter (which would just echo the prompt back as a title).
+   * - `maxLength` is enforced both in the prompt and as a hard server-side
+   *   `slice()` so a misbehaving model can't write a 4 KB "title".
+   */
+  setTitleGenerationConfig(config) {
+    this.titleGeneration = {
+      enabled: config.enabled,
+      maxLength: Math.max(8, Math.min(80, config.maxLength ?? 16))
+    };
+    this.logger.debug("[AI] title generation config", this.titleGeneration);
+  }
+  /**
+   * Best-effort title generation for a conversation. Idempotent per
+   * `AIService` instance — once attempted, the id is recorded in
+   * `titledConversations` so subsequent chats don't burn extra tokens
+   * re-summarising the same thread.
+   *
+   * Skips when:
+   * - feature disabled
+   * - conversation already has a non-empty title
+   * - conversation has fewer than 2 messages (no exchange to summarise)
+   * - conversation has no user message
+   *
+   * Failures are logged at debug level and swallowed — title generation
+   * is purely cosmetic and must never break chat.
+   */
+  async summarizeConversation(conversationId) {
+    if (!this.titleGeneration.enabled) return;
+    if (this.titledConversations.has(conversationId)) return;
+    this.titledConversations.add(conversationId);
+    try {
+      const conv = await this.conversationService.get(conversationId);
+      if (!conv) return;
+      if (conv.title && conv.title.trim().length > 0) return;
+      if (!conv.messages || conv.messages.length < 2) return;
+      const userMsg = conv.messages.find((m) => m.role === "user");
+      const assistantMsg = conv.messages.find((m) => m.role === "assistant");
+      if (!userMsg) return;
+      const userText = extractMessageText(userMsg);
+      const assistantText = assistantMsg ? extractMessageText(assistantMsg) : "";
+      if (!userText) return;
+      const maxLen = this.titleGeneration.maxLength;
+      const prompt = [
+        {
+          role: "system",
+          content: `You are a title generator. Produce a SHORT (<=${maxLen} characters), noun-phrase title that captures the topic of the conversation below. Reply with the title ONLY \u2014 no quotes, no punctuation, no preamble, no trailing period. Match the language of the user's message.`
+        },
+        {
+          role: "user",
+          content: `User said:
+${userText.slice(0, 800)}` + (assistantText ? `
+
+Assistant replied:
+${assistantText.slice(0, 800)}` : "")
+        }
+      ];
+      const result = await this.adapter.chat(prompt, {
+        temperature: 0.3,
+        maxTokens: 32
+      });
+      const raw = (result.content ?? "").trim();
+      if (!raw) return;
+      const cleaned = cleanTitle(raw, maxLen);
+      if (!cleaned) return;
+      await this.conversationService.update(conversationId, { title: cleaned });
+      this.logger.debug("[AI] auto-titled conversation", {
+        conversationId,
+        title: cleaned
+      });
+    } catch (err) {
+      this.titledConversations.delete(conversationId);
+      this.logger.debug("[AI] summarizeConversation failed", {
+        conversationId,
+        error: err instanceof Error ? err.message : String(err)
+      });
+    }
+  }
   /**
    * Best-effort auto-creation of a conversation when the caller did not
    * supply one but did supply an actor we can attribute the chat to.
@@ -1687,6 +1817,7 @@ var _AIService = class _AIService {
             role: "assistant",
             content: result.content
           });
+          void this.summarizeConversation(conversationId);
         }
         return autoCreatedConversationId ? { ...result, conversationId: autoCreatedConversationId } : result;
       }
@@ -1754,6 +1885,7 @@ var _AIService = class _AIService {
         role: "assistant",
         content: finalResult.content
       });
+      void this.summarizeConversation(conversationId);
     }
     return autoCreatedConversationId ? { ...finalResult, conversationId: autoCreatedConversationId } : finalResult;
   }
@@ -1812,6 +1944,7 @@ var _AIService = class _AIService {
             role: "assistant",
             content: result2.content
           });
+          void this.summarizeConversation(conversationId);
         }
         yield textDeltaPart("stream", result2.content);
         yield finishPart(result2);
@@ -1877,6 +2010,7 @@ var _AIService = class _AIService {
         role: "assistant",
         content: result.content
       });
+      void this.summarizeConversation(conversationId);
     }
     yield textDeltaPart("stream", result.content);
     yield finishPart(result);
@@ -3363,6 +3497,19 @@ var AiConversationObject = ObjectSchema.create({
   icon: "message-square",
   isSystem: true,
   description: "Persistent AI conversation metadata",
+  // Enable Notion / Figma-style "anyone with the link" sharing.
+  // The platform's plugin-sharing service exposes the share-link UI
+  // and REST surface as soon as this flag is set; no further wiring
+  // is needed in service-ai. `metadata` is redacted so internal
+  // tracking payloads (model token counts, source app context) do not
+  // leak into public shares.
+  publicSharing: {
+    enabled: true,
+    allowedAudiences: ["link_only", "signed_in"],
+    allowedPermissions: ["view"],
+    maxExpiryDays: 90,
+    redactFields: ["metadata"]
+  },
   fields: {
     id: Field.text({
       label: "Conversation ID",
@@ -5552,9 +5699,9 @@ var AIServicePlugin = class {
       }
     }
     const providerSpecs = {
-      openai: { pkg: "@ai-sdk/openai", factory: "openai", defaultModel: "gpt-4o", displayName: "OpenAI" },
-      anthropic: { pkg: "@ai-sdk/anthropic", factory: "anthropic", defaultModel: "claude-sonnet-4-20250514", displayName: "Anthropic" },
-      google: { pkg: "@ai-sdk/google", factory: "google", defaultModel: "gemini-2.0-flash", displayName: "Google" }
+      openai: { pkg: "@ai-sdk/openai", factory: "openai", createFactory: "createOpenAI", defaultModel: "gpt-4o", displayName: "OpenAI" },
+      anthropic: { pkg: "@ai-sdk/anthropic", factory: "anthropic", createFactory: "createAnthropic", defaultModel: "claude-sonnet-4-20250514", displayName: "Anthropic" },
+      google: { pkg: "@ai-sdk/google", factory: "google", createFactory: "createGoogleGenerativeAI", defaultModel: "gemini-2.0-flash", displayName: "Google" }
     };
     const spec = providerSpecs[provider];
     if (!spec) return null;
@@ -5567,20 +5714,30 @@ var AIServicePlugin = class {
     if (!apiKey) return null;
     const envKey = provider === "openai" ? "OPENAI_API_KEY" : provider === "anthropic" ? "ANTHROPIC_API_KEY" : "GOOGLE_GENERATIVE_AI_API_KEY";
     process.env[envKey] = apiKey;
+    const baseUrl = String(values[`${provider}_base_url`] ?? "").trim() || void 0;
     try {
       const mod = await import(
         /* webpackIgnore: true */
         spec.pkg
       );
-      const factory = mod[spec.factory] ?? mod.default;
+      let factory = mod[spec.factory] ?? mod.default;
+      if (baseUrl) {
+        const createFn = mod[spec.createFactory];
+        if (typeof createFn === "function") {
+          factory = createFn({ apiKey, baseURL: baseUrl });
+        } else {
+          ctx.logger.warn(`[AI] ${spec.pkg} has no ${spec.createFactory}; baseURL override ignored.`);
+        }
+      }
       if (typeof factory !== "function") return null;
       const modelId = String(values[`${provider}_model`] ?? "").trim() || spec.defaultModel;
       const useChatApi = provider === "openai" && typeof factory.chat === "function";
       const model = useChatApi ? factory.chat(modelId) : factory(modelId);
       const apiSuffix = useChatApi ? " [chat-completions]" : "";
+      const baseSuffix = baseUrl ? ` @ ${baseUrl}` : "";
       return {
         adapter: new VercelLLMAdapter({ model }),
-        description: `${spec.displayName} (model: ${modelId})${apiSuffix}`
+        description: `${spec.displayName} (model: ${modelId})${apiSuffix}${baseSuffix}`
       };
     } catch (err) {
       ctx.logger.warn(
@@ -6109,7 +6266,14 @@ var AIServicePlugin = class {
         for (const [k, v] of Object.entries(payload.values)) {
           values[k] = v?.value;
         }
-        const provider = String(values.provider ?? "memory");
+        const providerForTitles = String(values.provider ?? "memory");
+        const titleEnabled = providerForTitles !== "memory" && values.title_generation_enabled !== false;
+        const titleMaxLen = typeof values.title_max_length === "number" ? values.title_max_length : 16;
+        this.service.setTitleGenerationConfig({
+          enabled: titleEnabled,
+          maxLength: titleMaxLen
+        });
+        const provider = providerForTitles;
         if (provider === "memory") return;
         const built = await this.buildAdapterFromValues(ctx, values);
         if (!built) {