@rackbops/ac-plugin-contract 2.0.0-alpha.37 → 2.0.0-alpha.38

package/AUTHORING.md

@@ -192,6 +192,11 @@ export const createPlugin: CreatePlugin = (host) => ({
   agent's text with a storage error of your own.
 - **Setting** — read/write with `host.settings.get(key)` / `host.settings.set(key, value)`. Both are async;
   `get` returns the manifest `default` when unset.
+- **Console settings** (#506) — `host.consoleSettings?.get(key)`, read-only, optional. Unlike `Setting`
+  above (per-plugin), this reads the console-WIDE settings an operator edits in Admin's Settings card
+  (`repo_owners`, `layout_file`, `tab_order`, `plan_default_machine`, `repo_pins`) -- but only a key on
+  that editable-settings whitelist; anything else resolves to `undefined`. `plugins/provider-github`
+  is the reference consumer (`repo_owners`/`repo_pins`, its own repo-set resolution).
 
 `createPlugin` must import from `@ac/contract` **type-only** (`import type`), so the compiled `dist/server.js`
 has no runtime imports — see §6.

package/dist/host-api.d.ts

@@ -14,6 +14,16 @@ export interface SettingsService {
     get<T = unknown>(key: string): Promise<T | undefined>;
     set(key: string, value: unknown): Promise<void>;
 }
+/**
+ * Read-only view of the console-WIDE settings an operator edits in Admin's Settings card (#506) --
+ * distinct from `SettingsService` above, which is per-plugin. Only a key on the editable-settings
+ * whitelist (`settings-schema.ts`) is readable here; any other key resolves to `undefined`, so a
+ * plugin can never reach an arbitrary host-global key through this surface. The value returned is
+ * the EFFECTIVE one (an `AC_<KEY>` env override included), the same value the Settings card shows.
+ */
+export interface ConsoleSettingsService {
+    get<T = unknown>(key: string): Promise<T | undefined>;
+}
 /** Per-plugin durable storage: a SQLite table scoped to the plugin, with atomic JSON helpers. */
 export interface StorageService {
     get<T = unknown>(key: string): Promise<T | undefined>;
@@ -203,6 +213,9 @@ export interface HostApi {
     plugins?: PluginJobsService;
     /** #84: see `SlotRegistry`. */
     slots: SlotRegistry;
+    /** #506: see `ConsoleSettingsService`. Optional so an out-of-repo plugin's own test fake still
+     *  compiles. */
+    consoleSettings?: ConsoleSettingsService;
 }
 /**
  * The context the host passes to `Plugin.runJob` for one job run (#31). `jobId` selects which

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rackbops/ac-plugin-contract",
-  "version": "2.0.0-alpha.37",
+  "version": "2.0.0-alpha.38",
   "private": false,
   "type": "module",
   "description": "The artifact-console plugin ABI for out-of-repo plugin authors: HostApi, the acPlugin manifest contribution points, the generated manifest JSON Schema, and the @ac/host ambient browser declaration.",