@skaile/forge-settings 1.3.0 → 1.3.1

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 1.3.1
+
+- `<ForgeProvidersPanel>` takes an optional `note` prop: a string replaces the line above the provider list, `false` hides it (Add provider stays, right-aligned). Absent keeps today's text, so existing hosts see no change.
+
 ## 1.3.0
 
 - Model roles (`/server` and `/vue`, browser-safe): `MODEL_ROLE_KINDS` (`chat`, `decision`, `image`, `tts`, `stt`), `ModelRoleDefinition`, `STANDARD_MODEL_ROLES` (`decision`, `image`, `tts`, `stt`), `validateModelRoleAssignments` (issues keyed by role id), `resolveModelRole` and `modelRoleAliases` (feeds `resolveRegistryLanguageModel({ roles })`). A dangling assignment throws `ModelResolutionError` (`unknown_selector`). omp naming: `decision` = `judge`, `tts` = `speech`, `stt` = `dictation`.

package/README.md

@@ -86,6 +86,8 @@ The panel (`PUT|DELETE <writeUrl>/:id`, `GET <writeUrl>/detected`, `GET <provide
 
 Without URLs, pass `:client` (a `ProvidersPanelClient`: `list`, `detected`, `presets`, `upsert`, `remove`, `environment`, `updateEnvironment`, `models`, `test`) and the panel talks through it; the URL props then become optional. A passed client also turns on the per-provider Test button. `urlProvidersClient({ providersUrl, providersWriteUrl, … })` is the client the URL props build; its `models(id)` and `test(id)` call `GET|POST <writeUrl>/:id/models|test`, routes only a host that wants those features serves.
 
+`note` sets the line above the list: absent keeps the panel's text for `layer`, a string replaces it, `false` hides it (the Add provider button stays, right-aligned).
+
 ## Model roles
 
 A *model role* is a named purpose a host picks a model for. The host declares roles and stores the assignments (role id to selector); this package supplies the vocabulary, validation, resolution and a picker.

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@skaile/forge-settings",
   "configKey": "forgeSettings",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "builder": {
     "@nuxt/module-builder": "1.0.3",
     "unbuild": "3.6.1"

package/dist/runtime/components/ForgeProvidersPanel.d.vue.ts

@@ -20,6 +20,8 @@ type __VLS_Props = {
     layer: ProvidersPanelLayer;
     /** Disables add, edit and delete. */
     readOnly?: boolean;
+    /** The line above the list. Absent: the default text for `layer`; a string replaces it; `false` hides it. */
+    note?: string | false;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     changed: () => any;
@@ -27,5 +29,6 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {
     onChanged?: (() => any) | undefined;
 }>, {
     environmentEnabled: boolean;
+    note: string | false;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/runtime/components/ForgeProvidersPanel.vue

@@ -29,10 +29,9 @@
       <p v-if="detectedError" class="text-xs text-error-500">{{ detectedError }}</p>
     </div>
 
-    <div class="flex items-center gap-2">
-      <p class="text-xs text-foreground-muted leading-relaxed flex-1">
-        {{ props.layer === "workspace" ? "Entries of this workspace's providers.yml can be changed here; instance entries are inherited." : "The instance registry, $FORGE_HOME/.skaile/providers.yml." }}
-        Keys stay in the environment; an entry only references them.
+    <div class="flex items-center gap-2" :class="{ 'justify-end': noteText === null }">
+      <p v-if="noteText !== null" class="text-xs text-foreground-muted leading-relaxed flex-1">
+        {{ noteText }}
       </p>
       <UButton
         v-if="!props.readOnly"
@@ -390,6 +389,8 @@
 </template>
 
 <script setup>
+import { computed } from "vue";
+import { providersPanelNote } from "../vue/providers-panel-model";
 import { useProvidersPanel } from "../vue/useProvidersPanel";
 const props = defineProps({
   client: { type: Object, required: false },
@@ -399,8 +400,10 @@ const props = defineProps({
   environmentUrl: { type: String, required: false },
   environmentEnabled: { type: Boolean, required: false, default: void 0 },
   layer: { type: String, required: true },
-  readOnly: { type: Boolean, required: false }
+  readOnly: { type: Boolean, required: false },
+  note: { type: [String, Boolean], required: false, default: void 0 }
 });
+const noteText = computed(() => providersPanelNote(props.note, props.layer));
 const emit = defineEmits(["changed"]);
 const {
   rows,

package/dist/runtime/components/ForgeProvidersPanel.vue.d.ts

@@ -20,6 +20,8 @@ type __VLS_Props = {
     layer: ProvidersPanelLayer;
     /** Disables add, edit and delete. */
     readOnly?: boolean;
+    /** The line above the list. Absent: the default text for `layer`; a string replaces it; `false` hides it. */
+    note?: string | false;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     changed: () => any;
@@ -27,5 +29,6 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {
     onChanged?: (() => any) | undefined;
 }>, {
     environmentEnabled: boolean;
+    note: string | false;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/runtime/vue/providers-panel-model.d.ts

@@ -38,6 +38,11 @@ export interface ProvidersPanelProps {
     layer: ProvidersPanelLayer;
     /** Disables every write (non-admin at instance scope; provider lock). */
     readOnly?: boolean;
+    /**
+     * The line above the provider list. Absent: the panel's own text for
+     * `layer`; a string replaces it; `false` hides it (Add provider stays).
+     */
+    note?: string | false;
 }
 /** Emits both variants declare. */
 export type ProvidersPanelEmit = (event: "changed") => void;
@@ -142,6 +147,8 @@ export declare const CREDENTIAL_OTHER_REF = "__other_ref__";
 /** Registry ids the write routes accept (`isSafeProviderId` upstream). */
 export declare const PROVIDER_ID_PATTERN: RegExp;
 export declare const DEFAULT_PRESETS_URL = "/api/providers/presets";
+/** The line `ForgeProvidersPanel` shows above its list; `null` = none. */
+export declare function providersPanelNote(note: string | false | undefined, layer: ProvidersPanelLayer): string | null;
 /** An `env:NAME` credential reference; group 1 is the variable name. */
 export declare const ENV_REF_PATTERN: RegExp;
 /** The credential kind a written reference gets when the row states none. */

package/dist/runtime/vue/providers-panel-model.js

@@ -3,6 +3,11 @@ export const CREDENTIAL_ENTER_KEY = "__enter_key__";
 export const CREDENTIAL_OTHER_REF = "__other_ref__";
 export const PROVIDER_ID_PATTERN = /^[a-z0-9][a-z0-9_-]*$/;
 export const DEFAULT_PRESETS_URL = "/api/providers/presets";
+export function providersPanelNote(note, layer) {
+  if (note === false) return null;
+  if (note !== void 0) return note;
+  return layer === "workspace" ? "Entries of this workspace's providers.yml can be changed here; instance entries are inherited. Keys stay in the environment; an entry only references them." : "The instance registry, $FORGE_HOME/.skaile/providers.yml. Keys stay in the environment; an entry only references them.";
+}
 export const ENV_REF_PATTERN = /^env:(.+)$/;
 export const FALLBACK_CREDENTIAL_KIND = "api_key_header";
 export const ENV_SOURCE_LABEL = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skaile/forge-settings",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Provider and settings operations for Skaile forge apps: provider registry layers, credential store, env layers, model discovery, the providers panel, and editor / AI SDK model adapters.",
   "type": "module",
   "packageManager": "bun@1.3.9",

package/src/runtime/components/ForgeProvidersPanel.vue

@@ -29,12 +29,9 @@
       <p v-if="detectedError" class="text-xs text-error-500">{{ detectedError }}</p>
     </div>
 
-    <div class="flex items-center gap-2">
-      <p class="text-xs text-foreground-muted leading-relaxed flex-1">
-        {{ props.layer === 'workspace'
-          ? 'Entries of this workspace\'s providers.yml can be changed here; instance entries are inherited.'
-          : 'The instance registry, $FORGE_HOME/.skaile/providers.yml.' }}
-        Keys stay in the environment; an entry only references them.
+    <div class="flex items-center gap-2" :class="{ 'justify-end': noteText === null }">
+      <p v-if="noteText !== null" class="text-xs text-foreground-muted leading-relaxed flex-1">
+        {{ noteText }}
       </p>
       <UButton
         v-if="!props.readOnly"
@@ -392,7 +389,9 @@
 </template>
 
 <script setup lang="ts">
+import { computed } from "vue";
 import type { ProvidersPanelClient } from "../vue/providers-client";
+import { providersPanelNote } from "../vue/providers-panel-model";
 import { type ProvidersPanelLayer, useProvidersPanel } from "../vue/useProvidersPanel";
 
 const props = withDefaults(
@@ -416,11 +415,15 @@ const props = withDefaults(
     layer: ProvidersPanelLayer;
     /** Disables add, edit and delete. */
     readOnly?: boolean;
+    /** The line above the list. Absent: the default text for `layer`; a string replaces it; `false` hides it. */
+    note?: string | false;
   }>(),
   // Without a default Vue casts an absent boolean to `false`; the panel tells absent from `false`.
-  { environmentEnabled: undefined },
+  { environmentEnabled: undefined, note: undefined },
 );
 
+const noteText = computed(() => providersPanelNote(props.note, props.layer));
+
 const emit = defineEmits<{
   /** After every successful `PUT`/`DELETE`. */
   (event: "changed"): void;

package/src/runtime/vue/providers-panel-model.ts

@@ -45,6 +45,11 @@ export interface ProvidersPanelProps {
   layer: ProvidersPanelLayer;
   /** Disables every write (non-admin at instance scope; provider lock). */
   readOnly?: boolean;
+  /**
+   * The line above the provider list. Absent: the panel's own text for
+   * `layer`; a string replaces it; `false` hides it (Add provider stays).
+   */
+  note?: string | false;
 }
 
 /** Emits both variants declare. */
@@ -161,6 +166,18 @@ export const PROVIDER_ID_PATTERN = /^[a-z0-9][a-z0-9_-]*$/;
 
 export const DEFAULT_PRESETS_URL = "/api/providers/presets";
 
+/** The line `ForgeProvidersPanel` shows above its list; `null` = none. */
+export function providersPanelNote(
+  note: string | false | undefined,
+  layer: ProvidersPanelLayer,
+): string | null {
+  if (note === false) return null;
+  if (note !== undefined) return note;
+  return layer === "workspace"
+    ? "Entries of this workspace's providers.yml can be changed here; instance entries are inherited. Keys stay in the environment; an entry only references them."
+    : "The instance registry, $FORGE_HOME/.skaile/providers.yml. Keys stay in the environment; an entry only references them.";
+}
+
 /** An `env:NAME` credential reference; group 1 is the variable name. */
 export const ENV_REF_PATTERN = /^env:(.+)$/;