@pylonsync/functions 0.9.1 → 0.10.0

package/dist/types.d.ts

@@ -435,6 +435,12 @@ export interface Llm {
      * `PROVIDER_HTTP_<code>`, `PROVIDER_UNREACHABLE`,
      * `INVALID_REQUEST`.
      */
+    /**
+     * Embeds text. The model is required unless
+     * `PYLON_EMBEDDINGS_MODEL` is set; there is no built-in default,
+     * because the embedding model fixes the vector space and swapping
+     * it silently would leave a stored index unqueryable.
+     */
     embed(input: string[], opts?: {
         model?: string;
     }): Promise<number[][]>;
@@ -544,8 +550,13 @@ export interface LlmTool {
     input_schema: Record<string, unknown>;
 }
 export interface LlmCompleteRequest {
-    /** Override the server's default model. Subject to
-     *  PYLON_AI_MODELS_ALLOWED gating for non-admin callers. */
+    /**
+     * The model to run. Required unless the app declares one in the
+     * manifest with `llm({ defaultModel })`. There is no built-in
+     * fallback: a hardcoded model name goes stale as soon as the
+     * provider ships a new generation. Subject to
+     * `PYLON_AI_MODELS_ALLOWED` gating for non-admin callers.
+     */
     model?: string;
     messages: LlmMessage[];
     system?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pylonsync/functions",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "TypeScript function runtime for pylon — defines server-side queries, mutations, and actions.",
   "type": "module",
   "main": "src/index.ts",

package/src/types.ts

@@ -522,6 +522,12 @@ export interface Llm {
    * `PROVIDER_HTTP_<code>`, `PROVIDER_UNREACHABLE`,
    * `INVALID_REQUEST`.
    */
+  /**
+   * Embeds text. The model is required unless
+   * `PYLON_EMBEDDINGS_MODEL` is set; there is no built-in default,
+   * because the embedding model fixes the vector space and swapping
+   * it silently would leave a stored index unqueryable.
+   */
   embed(input: string[], opts?: { model?: string }): Promise<number[][]>;
 }
 
@@ -629,8 +635,13 @@ export interface LlmTool {
 }
 
 export interface LlmCompleteRequest {
-  /** Override the server's default model. Subject to
-   *  PYLON_AI_MODELS_ALLOWED gating for non-admin callers. */
+  /**
+   * The model to run. Required unless the app declares one in the
+   * manifest with `llm({ defaultModel })`. There is no built-in
+   * fallback: a hardcoded model name goes stale as soon as the
+   * provider ships a new generation. Subject to
+   * `PYLON_AI_MODELS_ALLOWED` gating for non-admin callers.
+   */
   model?: string;
   messages: LlmMessage[];
   system?: string;