@proveanything/smartlinks 1.4.5 → 1.4.6

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.4.5  |  Generated: 2026-02-21T09:35:56.076Z
+Version: 1.4.6  |  Generated: 2026-02-21T09:47:56.138Z
 
 This is a concise summary of all available API functions and types.
 
@@ -869,28 +869,14 @@ interface AppContainerComponent {
 }
 ```
 
-**AppManifest** (interface)
+**AppAdminConfig** (interface)
 ```typescript
-interface AppManifest {
+interface AppAdminConfig {
   $schema?: string;
-  meta?: {
-  name: string;
-  description?: string;
-  version: string;
-  platformRevision?: string;
-  appId: string;
-  };
-  * Filename of the admin configuration JSON (e.g. "app.admin.json").
-  * Present when the app ships an admin UI config.
-  admin?: string;
-  widgets?: {
-  files: AppManifestFiles;
-  components: AppWidgetComponent[];
-  };
-  containers?: {
-  files: AppManifestFiles;
-  components: AppContainerComponent[];
-  };
+  * Path (relative to the app's public root) to an AI guide markdown file.
+  * Provides natural-language context for AI-assisted configuration.
+  * @example "ai-guide.md"
+  aiGuide?: string;
   setup?: {
   description?: string;
   questions?: Array<{
@@ -944,6 +930,33 @@ interface AppManifest {
   interactions?: Array<{ id: string; description?: string }>;
   kpis?: Array<{ name: string; compute?: string }>;
   };
+}
+```
+
+**AppManifest** (interface)
+```typescript
+interface AppManifest {
+  $schema?: string;
+  meta?: {
+  name: string;
+  description?: string;
+  version: string;
+  platformRevision?: string;
+  appId: string;
+  };
+  * Relative path to the admin configuration file (e.g. `"app.admin.json"`).
+  * When present, fetch this file to get the full {@link AppAdminConfig}
+  * (setup questions, import schema, tunable fields, metrics definitions).
+  * Absent when the app has no admin UI.
+  admin?: string;
+  widgets?: {
+  files: AppManifestFiles;
+  components: AppWidgetComponent[];
+  };
+  containers?: {
+  files: AppManifestFiles;
+  components: AppContainerComponent[];
+  };
   [key: string]: any;
 }
 ```

package/dist/types/appManifest.d.ts

@@ -6,15 +6,15 @@
  * for inline content first and fall back to loading the URL.
  *
  *   if (bundle.source) {
- *     // inline JS � create a Blob URL or inject directly
+ *     // inline JS -- create a Blob URL or inject directly
  *   } else if (bundle.js) {
  *     // load from URL
  *   }
  */
 export interface AppBundle {
-    /** URL to the JavaScript file � load if `source` is absent */
+    /** URL to the JavaScript file -- load if `source` is absent */
     js: string | null;
-    /** URL to the CSS file � load if `styles` is absent */
+    /** URL to the CSS file -- load if `styles` is absent */
     css: string | null;
     /** Inlined JavaScript source (present when server bundles it inline) */
     source?: string;
@@ -26,12 +26,12 @@ export interface AppBundle {
  */
 export interface AppManifestFiles {
     js: {
-        /** UMD bundle � used for script-tag / dynamic loading */
+        /** UMD bundle -- used for script-tag / dynamic loading */
         umd: string;
-        /** ESM bundle � used for native ES module loading */
+        /** ESM bundle -- used for native ES module loading */
         esm?: string;
     };
-    /** CSS file � absent if the bundle ships no styles */
+    /** CSS file -- absent if the bundle ships no styles */
     css?: string;
 }
 /** A single widget component defined in the manifest */
@@ -56,32 +56,22 @@ export interface AppContainerComponent {
     };
 }
 /**
- * SmartLinks App Manifest � the app.manifest.json structure.
+ * Shape of `app.admin.json` -- the separate admin configuration file pointed to
+ * by `AppManifest.admin`. Fetch this file yourself when you need setup / import /
+ * tunable / metrics details; it is not inlined in the manifest.
+ *
+ * @example
+ *   const adminUrl = new URL(manifest.admin!, appBaseUrl);
+ *   const adminConfig: AppAdminConfig = await fetch(adminUrl).then(r => r.json());
  */
-export interface AppManifest {
+export interface AppAdminConfig {
     $schema?: string;
-    meta?: {
-        name: string;
-        description?: string;
-        version: string;
-        platformRevision?: string;
-        appId: string;
-    };
     /**
-     * Filename of the admin configuration JSON (e.g. "app.admin.json").
-     * Present when the app ships an admin UI config.
+     * Path (relative to the app's public root) to an AI guide markdown file.
+     * Provides natural-language context for AI-assisted configuration.
+     * @example "ai-guide.md"
      */
-    admin?: string;
-    /** Widget bundle definition. Presence means a widget bundle exists for this app. */
-    widgets?: {
-        files: AppManifestFiles;
-        components: AppWidgetComponent[];
-    };
-    /** Container bundle definition. Presence means a container bundle exists. */
-    containers?: {
-        files: AppManifestFiles;
-        components: AppContainerComponent[];
-    };
+    aiGuide?: string;
     setup?: {
         description?: string;
         questions?: Array<{
@@ -144,6 +134,39 @@ export interface AppManifest {
             compute?: string;
         }>;
     };
+}
+/**
+ * SmartLinks App Manifest -- the app.manifest.json structure.
+ *
+ * Setup, import, tunable, and metrics configuration lives in a separate
+ * `app.admin.json` file. Use the `admin` field to locate and fetch it.
+ */
+export interface AppManifest {
+    $schema?: string;
+    meta?: {
+        name: string;
+        description?: string;
+        version: string;
+        platformRevision?: string;
+        appId: string;
+    };
+    /**
+     * Relative path to the admin configuration file (e.g. `"app.admin.json"`).
+     * When present, fetch this file to get the full {@link AppAdminConfig}
+     * (setup questions, import schema, tunable fields, metrics definitions).
+     * Absent when the app has no admin UI.
+     */
+    admin?: string;
+    /** Widget bundle definition. Presence means a widget bundle exists for this app. */
+    widgets?: {
+        files: AppManifestFiles;
+        components: AppWidgetComponent[];
+    };
+    /** Container bundle definition. Presence means a container bundle exists. */
+    containers?: {
+        files: AppManifestFiles;
+        components: AppContainerComponent[];
+    };
     [key: string]: any;
 }
 /**
@@ -152,11 +175,11 @@ export interface AppManifest {
 export interface CollectionAppWidget {
     appId: string;
     manifest: AppManifest;
-    /** Widget bundle � always present (apps without widgets are excluded from the response) */
+    /** Widget bundle -- always present (apps without widgets are excluded from the response) */
     widget: AppBundle;
-    /** Container bundle � null when the app has no containers */
+    /** Container bundle -- null when the app has no containers */
     container: AppBundle | null;
-    /** URL to the admin configuration JSON � null when the app has no admin config */
+    /** URL to the admin configuration JSON -- null when the app has no admin config */
     admin: string | null;
 }
 /**

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.4.5  |  Generated: 2026-02-21T09:35:56.076Z
+Version: 1.4.6  |  Generated: 2026-02-21T09:47:56.138Z
 
 This is a concise summary of all available API functions and types.
 
@@ -869,28 +869,14 @@ interface AppContainerComponent {
 }
 ```
 
-**AppManifest** (interface)
+**AppAdminConfig** (interface)
 ```typescript
-interface AppManifest {
+interface AppAdminConfig {
   $schema?: string;
-  meta?: {
-  name: string;
-  description?: string;
-  version: string;
-  platformRevision?: string;
-  appId: string;
-  };
-  * Filename of the admin configuration JSON (e.g. "app.admin.json").
-  * Present when the app ships an admin UI config.
-  admin?: string;
-  widgets?: {
-  files: AppManifestFiles;
-  components: AppWidgetComponent[];
-  };
-  containers?: {
-  files: AppManifestFiles;
-  components: AppContainerComponent[];
-  };
+  * Path (relative to the app's public root) to an AI guide markdown file.
+  * Provides natural-language context for AI-assisted configuration.
+  * @example "ai-guide.md"
+  aiGuide?: string;
   setup?: {
   description?: string;
   questions?: Array<{
@@ -944,6 +930,33 @@ interface AppManifest {
   interactions?: Array<{ id: string; description?: string }>;
   kpis?: Array<{ name: string; compute?: string }>;
   };
+}
+```
+
+**AppManifest** (interface)
+```typescript
+interface AppManifest {
+  $schema?: string;
+  meta?: {
+  name: string;
+  description?: string;
+  version: string;
+  platformRevision?: string;
+  appId: string;
+  };
+  * Relative path to the admin configuration file (e.g. `"app.admin.json"`).
+  * When present, fetch this file to get the full {@link AppAdminConfig}
+  * (setup questions, import schema, tunable fields, metrics definitions).
+  * Absent when the app has no admin UI.
+  admin?: string;
+  widgets?: {
+  files: AppManifestFiles;
+  components: AppWidgetComponent[];
+  };
+  containers?: {
+  files: AppManifestFiles;
+  components: AppContainerComponent[];
+  };
   [key: string]: any;
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "1.4.5",
+  "version": "1.4.6",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",