@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/dashboard-rpc/modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../src/dashboard-rpc/modules.ts"],"names":[],"mappings":"AACA,OAAO,EAAyE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAGvI,OAAO,EAA8B,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAI/F,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChE,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAEnE,6FAA6F;AAC7F,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAA;IACX,kFAAkF;IAClF,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAW5D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,UAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAUnJ;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAUxH"}

package/dist/dashboard-rpc/modules.js

@@ -0,0 +1,77 @@
+import { contextProjects, resolveProjectPath } from './context.js';
+import { findProjectModule, readProjectModules, runModuleCommand as runCommand } from '../project-modules.js';
+import { moduleUrl } from '../dashboard/module-serve.js';
+import { providedDataChanged } from '../store/provided.js';
+import { callModuleRead, serverHost } from '../dashboard/module-host.js';
+import { relayOr } from './relay-agent.js';
+import { DATA_BRANCH, pullFileBranch } from '@openagt/agent-data';
+/**
+ * Every module any registered project brings (#1774), one per package: the sidebar and the pages
+ * are cross-project, like the Overview. A package several projects install is loaded once, from
+ * the first of them in the registry's order; its page then reads each project through that
+ * project's own command. A project that cannot be read contributes nothing.
+ */
+export async function onModules() {
+    const byPackage = new Map();
+    for (const project of await contextProjects().list()) {
+        const modules = await readProjectModules(project.path).catch(() => []);
+        for (const module of modules) {
+            const known = byPackage.get(module.package);
+            if (known)
+                known.projects.push(project.id);
+            else
+                byPackage.set(module.package, { package: module.package, url: moduleUrl(project.id, module), projects: [project.id] });
+        }
+    }
+    return [...byPackage.values()];
+}
+/**
+ * Run one of a module package's commands in one project and answer its JSON output: how a module
+ * reads (and changes) its own data. Refused for an unknown project and for a package that is not a
+ * module of that project, so a page can run only its own package's commands, never an arbitrary
+ * program. Once the command has run, the framework forgets what it had read of that project's
+ * provided data (its queue, its runs): the command may have written it, and the next read sees
+ * that at once instead of a cached copy.
+ *
+ * `acts` says the command is a module's action on the project (a link action), not a page's read:
+ * the framework then also converges the project's data branch with origin, as its clock does
+ * every minute, before forgetting — a package's command writes as a remote writer, straight to
+ * origin, and this machine's copy would otherwise show the write only at the next sync.
+ */
+export async function runModuleCommand(projectId, pkg, args, command, acts = false) {
+    const root = await resolveProjectPath(projectId);
+    if (!root)
+        return { ok: false, error: 'unknown project' };
+    if (!Array.isArray(args))
+        return { ok: false, error: 'arguments must be a list' };
+    const module = await findProjectModule(root, pkg);
+    if (!module)
+        return { ok: false, error: `${pkg} brings no module to this project` };
+    const result = await runCommand(root, module, args, command);
+    if (acts)
+        await pullFileBranch(root, DATA_BRANCH, { log: () => { } }).catch(() => { });
+    providedDataChanged(root);
+    return result;
+}
+/**
+ * Call read `name` of a module's server part in one project: how a module's browser part reads
+ * what a command cannot answer fast enough. Refused for an unknown project, a package that is not
+ * a module of that project, and a module with no server part. A read whose input names a run this
+ * daemon relays to a connected device (`input.agentId`) is read over there, by that device's own
+ * copy of the module, since the run's checkout is there.
+ */
+export async function readModule(projectId, pkg, name, input) {
+    const agentId = input && typeof input === 'object' && typeof input.agentId === 'string' ? input.agentId : undefined;
+    return relayOr(agentId, 'readModule', [projectId, pkg, name, input], async () => {
+        const root = await resolveProjectPath(projectId);
+        if (!root)
+            return { ok: false, error: 'unknown project' };
+        const module = await findProjectModule(root, pkg).catch(() => undefined);
+        if (!module)
+            return { ok: false, error: `${pkg} is no module of this project` };
+        if (!module.server)
+            return { ok: false, error: `${pkg} has no server part` };
+        return callModuleRead(module.server, name, serverHost(root), input);
+    }, { ok: false, error: 'the device this run works on did not answer' });
+}
+//# sourceMappingURL=modules.js.map

package/dist/dashboard-rpc/modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.js","sourceRoot":"","sources":["../../src/dashboard-rpc/modules.ts"],"names":[],"mappings":"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"}

package/dist/dashboard-rpc/preferences.d.ts

@@ -0,0 +1,41 @@
+import { type EditorInfo } from '../dashboard/open-in-app.js';
+import type { CustomPreset, Preferences } from '../registry.js';
+/** The outcome of a {@link savePreferences} write. */
+export type SavePreferencesResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/** The user's stored dashboard preferences, or `{}` when the read fails. */
+export declare function onPreferences(): Promise<Preferences>;
+/** Persist the dashboard preferences (sanitized in the store). */
+export declare function savePreferences(preferences: Preferences): Promise<SavePreferencesResult>;
+/** The outcome of a patch write (#1148): the stored result, so the caller can adopt it. */
+export type PatchPreferencesResult<T> = {
+    ok: true;
+    preferences: T;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Merge the keys the caller changed into the stored preferences (#1148), and hand back what is
+ * now stored. The write half of the fix for a stale tab reverting settings it never touched:
+ * {@link savePreferences} replaces the whole block, so a client's snapshot overwrote whatever
+ * anyone else had changed since it loaded. Returning the merged result also lets the caller
+ * adopt the truth it just wrote against, so a tab converges instead of staying stale.
+ */
+export declare function patchPreferences(patch: Preferences): Promise<PatchPreferencesResult<Preferences>>;
+/**
+ * A project's shared custom presets (#1025), committed into its `.the-framework/` so they travel
+ * with the repo — the team-shared counterpart to the user-tier {@link onPreferences} presets. Read
+ * from the project's own checkout, so this resolves the project id to its workspace path rather than
+ * touching the home registry. `[]` for an unknown project.
+ */
+export declare function onProjectPresets(projectId: string): Promise<CustomPreset[]>;
+/** Persist a project's shared custom presets into its `.the-framework/` (#1025). */
+export declare function saveProjectPresets(projectId: string, presets: CustomPreset[]): Promise<SavePreferencesResult>;
+/** The editors installed on this server (#727), for the "Preferred editor" picker. */
+export declare function onEditors(): Promise<EditorInfo[]>;
+//# sourceMappingURL=preferences.d.ts.map

package/dist/dashboard-rpc/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../src/dashboard-rpc/preferences.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE5E,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAQ/D,sDAAsD;AACtD,MAAM,MAAM,qBAAqB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/E,4EAA4E;AAC5E,wBAAsB,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC,CAE1D;AAED,kEAAkE;AAClE,wBAAsB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAS9F;AAED,2FAA2F;AAC3F,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnG;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC,CAOvG;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAIjF;AAED,oFAAoF;AACpF,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAShC;AAED,sFAAsF;AACtF,wBAAsB,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAEvD"}

package/dist/dashboard-rpc/preferences.js

@@ -0,0 +1,65 @@
+import { contextPreferences, resolveProjectPath } from './context.js';
+import { detectEditors } from '../dashboard/open-in-app.js';
+import { readProjectPresets, writeProjectPresets } from '../project-presets.js';
+/** The user's stored dashboard preferences, or `{}` when the read fails. */
+export async function onPreferences() {
+    return contextPreferences().read().catch(() => ({}));
+}
+/** Persist the dashboard preferences (sanitized in the store). */
+export async function savePreferences(preferences) {
+    // A failed write returns the advertised typed error rather than rejecting the RPC, so the
+    // client renders it instead of losing the save to an exception it cannot read.
+    try {
+        await contextPreferences().save(preferences);
+        return { ok: true };
+    }
+    catch {
+        return { ok: false, error: 'failed to save preferences' };
+    }
+}
+/**
+ * Merge the keys the caller changed into the stored preferences (#1148), and hand back what is
+ * now stored. The write half of the fix for a stale tab reverting settings it never touched:
+ * {@link savePreferences} replaces the whole block, so a client's snapshot overwrote whatever
+ * anyone else had changed since it loaded. Returning the merged result also lets the caller
+ * adopt the truth it just wrote against, so a tab converges instead of staying stale.
+ */
+export async function patchPreferences(patch) {
+    // Typed error rather than a rejection, like `savePreferences` — one shape for every failure.
+    try {
+        return { ok: true, preferences: await contextPreferences().patch(patch) };
+    }
+    catch {
+        return { ok: false, error: 'failed to save preferences' };
+    }
+}
+/**
+ * A project's shared custom presets (#1025), committed into its `.the-framework/` so they travel
+ * with the repo — the team-shared counterpart to the user-tier {@link onPreferences} presets. Read
+ * from the project's own checkout, so this resolves the project id to its workspace path rather than
+ * touching the home registry. `[]` for an unknown project.
+ */
+export async function onProjectPresets(projectId) {
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return [];
+    return readProjectPresets(cwd).catch(() => []);
+}
+/** Persist a project's shared custom presets into its `.the-framework/` (#1025). */
+export async function saveProjectPresets(projectId, presets) {
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return { ok: false, error: 'unknown project' };
+    try {
+        await writeProjectPresets(cwd, presets);
+        return { ok: true };
+    }
+    catch {
+        return { ok: false, error: 'failed to save presets' };
+    }
+}
+/** The editors installed on this server (#727), for the "Preferred editor" picker. */
+export async function onEditors() {
+    return detectEditors().catch(() => []);
+}
+//# sourceMappingURL=preferences.js.map

package/dist/dashboard-rpc/preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.js","sourceRoot":"","sources":["../../src/dashboard-rpc/preferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACrE,OAAO,EAAE,aAAa,EAAmB,MAAM,6BAA6B,CAAA;AAC5E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAY/E,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,OAAO,kBAAkB,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AACtD,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAwB;IAC5D,0FAA0F;IAC1F,+EAA+E;IAC/E,IAAI,CAAC;QACH,MAAM,kBAAkB,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAC5C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAA;IAC3D,CAAC;AACH,CAAC;AAKD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAkB;IACvD,6FAA6F;IAC7F,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,kBAAkB,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAA;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAA;IAC3D,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,SAAiB;IACtD,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,SAAS,CAAC,CAAA;IAC/C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAA;IACnB,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;AAChD,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,OAAuB;IAEvB,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,SAAS,CAAC,CAAA;IAC/C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAA;IACxD,IAAI,CAAC;QACH,MAAM,mBAAmB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACvC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAA;IACvD,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,OAAO,aAAa,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;AACxC,CAAC"}

package/dist/dashboard-rpc/preferences.telefunc.d.ts

@@ -0,0 +1,97 @@
+import type { DiscordCredentialStatus, DiscordCredentialsPatch } from '../discord-credentials.js';
+import { type EditorInfo } from '../dashboard/open-in-app.js';
+import type { CustomPreset, Preferences, ProjectPreferences } from '../registry.js';
+/** The outcome of a {@link savePreferences} write. */
+export type SavePreferencesResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/** The user's stored dashboard preferences, or `{}` on a host that has none / does not store them. */
+export declare function onPreferences(): Promise<Preferences>;
+/** Persist the dashboard preferences (sanitized in the store). No-op-safe on a public host. */
+export declare function savePreferences(preferences: Preferences): Promise<SavePreferencesResult>;
+/** The outcome of a patch write (#1148): the stored result, so the caller can adopt it. */
+export type PatchPreferencesResult<T> = {
+    ok: true;
+    preferences: T;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Merge the keys the caller changed into the stored preferences (#1148), and hand back what is
+ * now stored. The write half of the fix for a stale tab reverting settings it never touched:
+ * {@link savePreferences} replaces the whole block, so a client's snapshot overwrote whatever
+ * anyone else had changed since it loaded. Returning the merged result also lets the caller
+ * adopt the truth it just wrote against, so a tab converges instead of staying stale.
+ */
+export declare function patchPreferences(patch: Preferences): Promise<PatchPreferencesResult<Preferences>>;
+/**
+ * One project's own run options (#840), or `{}` when it overrides nothing / the host stores
+ * none. Separate from {@link onPreferences} rather than folded into it: the client needs the
+ * two tiers apart to know which one a toggle should write to.
+ */
+export declare function onProjectPreferences(projectId: string): Promise<ProjectPreferences>;
+/** Persist one project's run options (#840), sanitized in the store. No-op-safe on a public host. */
+export declare function saveProjectPreferences(projectId: string, preferences: ProjectPreferences): Promise<SavePreferencesResult>;
+/** {@link patchPreferences} for one project's run options (#1148). */
+export declare function patchProjectPreferences(projectId: string, patch: ProjectPreferences): Promise<PatchPreferencesResult<ProjectPreferences>>;
+/**
+ * A project's shared custom presets (#1025), committed into its `.the-framework/` so they travel
+ * with the repo — the team-shared counterpart to the user-tier {@link onPreferences} presets. Read
+ * from the project's own checkout, so this resolves the project id to its workspace path rather than
+ * touching the home registry. `[]` on a public host (no local checkout) or an unknown project.
+ */
+export declare function onProjectPresets(projectId: string): Promise<CustomPreset[]>;
+/** Persist a project's shared custom presets into its `.the-framework/` (#1025). No-op-safe on a public host. */
+export declare function saveProjectPresets(projectId: string, presets: CustomPreset[]): Promise<SavePreferencesResult>;
+/**
+ * The editors installed on this server (#727), for the "Preferred editor" picker. Detection reads
+ * the daemon's own PATH, so it is gated on the same store presence as the other preference RPCs:
+ * a public host (the relay) has no local checkout to open anyway, so it returns `[]`.
+ */
+export declare function onEditors(): Promise<EditorInfo[]>;
+/** Which notification channels the daemon can actually deliver on (#948). */
+export interface NotifyChannels {
+    /** A webhook is set, so Discord delivery can fire. */
+    discordWebhook: boolean;
+    /** A bot token is set, so the Discord chatbot can answer. */
+    discordBot: boolean;
+    /**
+     * Where each credential came from (#1095), so the UI can offer an edit for one it stores and
+     * say "set on the daemon" for one it cannot touch. An absent key means that credential is
+     * not set. Still presence, never a value — nothing here can be turned back into a credential.
+     */
+    sources: DiscordCredentialStatus;
+    /** Whether this host can store a credential at all. False on a public host, which wires no store. */
+    editable: boolean;
+}
+/**
+ * Whether the daemon has the Discord credentials (#948/#1095). The toggles are per-user
+ * preferences, but delivery needs a webhook / a bot token on the daemon — without this read the
+ * dashboard let you switch on a channel that delivers nothing and lit the bell for it.
+ *
+ * Only presence is reported, never the values, and that is the whole contract: a credential set
+ * from the dashboard (#1095) lives daemon-side and is never read back to a browser, so this stays
+ * booleans plus where each came from. Gated like the other preference RPCs, so a public host
+ * reports both absent.
+ */
+export declare function onNotifyChannels(): Promise<NotifyChannels>;
+/**
+ * Store (or clear) the Discord credentials from the dashboard (#1095) — the step that used to
+ * need an edit to the daemon's environment and a restart, which made it the one onboarding step
+ * you could not finish in-product.
+ *
+ * Write-only on purpose: there is no companion read. The value goes daemon-side, and the browser
+ * only ever learns that it is there ({@link onNotifyChannels}). The store applies it live, so the
+ * bot connects and the watchers start on the save rather than at the next daemon start.
+ *
+ * The exposure is bounded by the guard the rest of this surface already sits behind: on a
+ * non-loopback bind every route requires the shared token (#1051), and anyone through that guard
+ * can start runs — strictly more than setting a webhook URL. A public host wires no store, so
+ * this refuses there.
+ */
+export declare function saveDiscordCredentials(patch: DiscordCredentialsPatch): Promise<SavePreferencesResult>;
+//# sourceMappingURL=preferences.telefunc.d.ts.map

package/dist/dashboard-rpc/preferences.telefunc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.telefunc.d.ts","sourceRoot":"","sources":["../../src/dashboard-rpc/preferences.telefunc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AACjG,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE5E,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AASnF,sDAAsD;AACtD,MAAM,MAAM,qBAAqB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/E,sGAAsG;AACtG,wBAAsB,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC,CAI1D;AAED,+FAA+F;AAC/F,wBAAsB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAW9F;AAED,2FAA2F;AAC3F,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnG;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC,CASvG;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAIzF;AAED,qGAAqG;AACrG,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,kBAAkB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAShC;AAED,sEAAsE;AACtE,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,sBAAsB,CAAC,kBAAkB,CAAC,CAAC,CAQrD;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAKjF;AAED,iHAAiH;AACjH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAUhC;AAED;;;;GAIG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvD;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,cAAc,EAAE,OAAO,CAAA;IACvB,6DAA6D;IAC7D,UAAU,EAAE,OAAO,CAAA;IACnB;;;;OAIG;IACH,OAAO,EAAE,uBAAuB,CAAA;IAChC,qGAAqG;IACrG,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,cAAc,CAAC,CAKhE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAI3G"}

package/dist/dashboard-rpc/preferences.telefunc.js

@@ -0,0 +1,157 @@
+import { contextDiscord, contextPreferences, resolveProjectPath } from './context.js';
+import { detectEditors } from '../dashboard/open-in-app.js';
+import { readProjectPresets, writeProjectPresets } from '../project-presets.js';
+/** The user's stored dashboard preferences, or `{}` on a host that has none / does not store them. */
+export async function onPreferences() {
+    const store = contextPreferences();
+    if (!store)
+        return {};
+    return store.read().catch(() => ({}));
+}
+/** Persist the dashboard preferences (sanitized in the store). No-op-safe on a public host. */
+export async function savePreferences(preferences) {
+    const store = contextPreferences();
+    if (!store)
+        return { ok: false, error: 'preferences are not enabled on this server' };
+    // A failed write returns the advertised typed error rather than rejecting the RPC,
+    // so the client handles it the same as the not-enabled case (both `{ ok: false }`).
+    try {
+        await store.save(preferences);
+        return { ok: true };
+    }
+    catch {
+        return { ok: false, error: 'failed to save preferences' };
+    }
+}
+/**
+ * Merge the keys the caller changed into the stored preferences (#1148), and hand back what is
+ * now stored. The write half of the fix for a stale tab reverting settings it never touched:
+ * {@link savePreferences} replaces the whole block, so a client's snapshot overwrote whatever
+ * anyone else had changed since it loaded. Returning the merged result also lets the caller
+ * adopt the truth it just wrote against, so a tab converges instead of staying stale.
+ */
+export async function patchPreferences(patch) {
+    const store = contextPreferences();
+    if (!store?.patch)
+        return { ok: false, error: 'preferences are not enabled on this server' };
+    // Typed error rather than a rejection, like `savePreferences` — one shape for both failures.
+    try {
+        return { ok: true, preferences: await store.patch(patch) };
+    }
+    catch {
+        return { ok: false, error: 'failed to save preferences' };
+    }
+}
+/**
+ * One project's own run options (#840), or `{}` when it overrides nothing / the host stores
+ * none. Separate from {@link onPreferences} rather than folded into it: the client needs the
+ * two tiers apart to know which one a toggle should write to.
+ */
+export async function onProjectPreferences(projectId) {
+    const store = contextPreferences();
+    if (!store?.readProject)
+        return {};
+    return store.readProject(projectId).catch(() => ({}));
+}
+/** Persist one project's run options (#840), sanitized in the store. No-op-safe on a public host. */
+export async function saveProjectPreferences(projectId, preferences) {
+    const store = contextPreferences();
+    if (!store?.saveProject)
+        return { ok: false, error: 'preferences are not enabled on this server' };
+    try {
+        await store.saveProject(projectId, preferences);
+        return { ok: true };
+    }
+    catch {
+        return { ok: false, error: 'failed to save preferences' };
+    }
+}
+/** {@link patchPreferences} for one project's run options (#1148). */
+export async function patchProjectPreferences(projectId, patch) {
+    const store = contextPreferences();
+    if (!store?.patchProject)
+        return { ok: false, error: 'preferences are not enabled on this server' };
+    try {
+        return { ok: true, preferences: await store.patchProject(projectId, patch) };
+    }
+    catch {
+        return { ok: false, error: 'failed to save preferences' };
+    }
+}
+/**
+ * A project's shared custom presets (#1025), committed into its `.the-framework/` so they travel
+ * with the repo — the team-shared counterpart to the user-tier {@link onPreferences} presets. Read
+ * from the project's own checkout, so this resolves the project id to its workspace path rather than
+ * touching the home registry. `[]` on a public host (no local checkout) or an unknown project.
+ */
+export async function onProjectPresets(projectId) {
+    if (!contextPreferences())
+        return [];
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return [];
+    return readProjectPresets(cwd).catch(() => []);
+}
+/** Persist a project's shared custom presets into its `.the-framework/` (#1025). No-op-safe on a public host. */
+export async function saveProjectPresets(projectId, presets) {
+    if (!contextPreferences())
+        return { ok: false, error: 'preferences are not enabled on this server' };
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return { ok: false, error: 'unknown project' };
+    try {
+        await writeProjectPresets(cwd, presets);
+        return { ok: true };
+    }
+    catch {
+        return { ok: false, error: 'failed to save presets' };
+    }
+}
+/**
+ * The editors installed on this server (#727), for the "Preferred editor" picker. Detection reads
+ * the daemon's own PATH, so it is gated on the same store presence as the other preference RPCs:
+ * a public host (the relay) has no local checkout to open anyway, so it returns `[]`.
+ */
+export async function onEditors() {
+    if (!contextPreferences())
+        return [];
+    return detectEditors().catch(() => []);
+}
+/**
+ * Whether the daemon has the Discord credentials (#948/#1095). The toggles are per-user
+ * preferences, but delivery needs a webhook / a bot token on the daemon — without this read the
+ * dashboard let you switch on a channel that delivers nothing and lit the bell for it.
+ *
+ * Only presence is reported, never the values, and that is the whole contract: a credential set
+ * from the dashboard (#1095) lives daemon-side and is never read back to a browser, so this stays
+ * booleans plus where each came from. Gated like the other preference RPCs, so a public host
+ * reports both absent.
+ */
+export async function onNotifyChannels() {
+    const discord = contextDiscord();
+    if (!contextPreferences() || !discord)
+        return { discordWebhook: false, discordBot: false, sources: {}, editable: false };
+    const sources = await discord.status().catch(() => ({}));
+    return { discordWebhook: sources.webhook !== undefined, discordBot: sources.botToken !== undefined, sources, editable: true };
+}
+/**
+ * Store (or clear) the Discord credentials from the dashboard (#1095) — the step that used to
+ * need an edit to the daemon's environment and a restart, which made it the one onboarding step
+ * you could not finish in-product.
+ *
+ * Write-only on purpose: there is no companion read. The value goes daemon-side, and the browser
+ * only ever learns that it is there ({@link onNotifyChannels}). The store applies it live, so the
+ * bot connects and the watchers start on the save rather than at the next daemon start.
+ *
+ * The exposure is bounded by the guard the rest of this surface already sits behind: on a
+ * non-loopback bind every route requires the shared token (#1051), and anyone through that guard
+ * can start runs — strictly more than setting a webhook URL. A public host wires no store, so
+ * this refuses there.
+ */
+export async function saveDiscordCredentials(patch) {
+    const discord = contextDiscord();
+    if (!discord)
+        return { ok: false, error: 'Discord cannot be configured on this server.' };
+    return discord.save(patch).catch(() => ({ ok: false, error: 'failed to save' }));
+}
+//# sourceMappingURL=preferences.telefunc.js.map

package/dist/dashboard-rpc/preferences.telefunc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.telefunc.js","sourceRoot":"","sources":["../../src/dashboard-rpc/preferences.telefunc.ts"],"names":[],"mappings":"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"}

package/dist/dashboard-rpc/projects.d.ts

@@ -0,0 +1,59 @@
+import { type ProjectCommand } from '../project-commands.js';
+import { type StartReadiness } from '../project-hooks.js';
+import { type PickDirectoryResult } from '../pick-directory.js';
+import type { ProjectSummary } from '../dashboard/projects.js';
+import type { AddProjectResult, OnboardingSuggestion } from '../dashboard/types.js';
+export declare function onProjects(): Promise<ProjectSummary[]>;
+/**
+ * Add a project from the dashboard (#396/#433): install the repo and register it so it joins the
+ * Projects list. Like `sendStart` this needs the daemon (it spawns git + writes the shared
+ * registry), so it calls the daemon's own `addProject` closure off the wired dashboard context.
+ * Returns the daemon's {@link AddProjectResult}.
+ */
+export declare function sendAddProject(path: string): Promise<AddProjectResult>;
+/**
+ * Open the OS folder picker on the daemon's machine and wait for the user's choice (#1150). The
+ * browser cannot learn an absolute path from any picker of its own, and the daemon — which runs on
+ * the machine the user is sitting at — can, so the dialog is the daemon's. A dismissed dialog
+ * comes back as `path: null`.
+ */
+export declare function sendPickProjectDirectory(): Promise<PickDirectoryResult>;
+/**
+ * The Onboarding checklist's one server-side fact (#958): the directory this server runs in,
+ * so the first step can offer "Add {cwd} as project" without the user typing a path.
+ */
+export declare function onOnboarding(): Promise<OnboardingSuggestion>;
+/** What the launcher offers for a project: its commands, and whether a run can be started here at all. */
+export interface ProjectLauncher {
+    commands: ProjectCommand[];
+    /** Whether the project's `.the-framework/hooks.yml` has a `start` line; without one Start is off. */
+    startHook: boolean;
+    /** Whether one of the project's packages provides a git host; without one no pull request can be opened, so the publish menu stops at the branch. */
+    gitHost: boolean;
+    /** Whether the project's repository has an `origin` remote; without one nothing can be published, so the publish menu stops at the commit. */
+    remote: boolean;
+    /**
+     * The two branches an agent can start from here, for the launcher's "start from" chip: `main`,
+     * the name of origin's default branch, and `local`, the branch the project's folder is on now.
+     * Absent where the pick could not be obeyed or has nothing to pick between: the start line does
+     * not pass `BASE` on, the repository has no remote, or the folder is on no branch.
+     */
+    startFrom?: {
+        main: string;
+        local: string;
+    };
+}
+/**
+ * The project's commands (#1774), read off its skills folders, whether it has a start hook, whether
+ * it has a git host, and the branches an agent can start from. `null` when the project is unknown here.
+ */
+export declare function onCommands(projectId: string): Promise<ProjectLauncher | null>;
+/**
+ * What would stop a run in this project before it spends a checkout, said in the launcher before
+ * the Start: the project's `check` hook, given the coding agent picked. A missing CLI or a
+ * logged-out one is a problem the run itself would refuse on; a warning is said and blocks nothing.
+ * A check line that fails is said as a warning: it is a broken check, not a reason to stop.
+ * `null` for an unknown project or one without a check hook: nothing to say.
+ */
+export declare function onStartCheck(projectId: string, driver?: string): Promise<StartReadiness | null>;
+//# sourceMappingURL=projects.d.ts.map

package/dist/dashboard-rpc/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/dashboard-rpc/projects.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAEjF,OAAO,EAAsD,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAI7G,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAYnF,wBAAsB,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAM5D;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAM5E;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAE7E;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAIlE;AAED,0GAA0G;AAC1G,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,qGAAqG;IACrG,SAAS,EAAE,OAAO,CAAA;IAClB,qJAAqJ;IACrJ,OAAO,EAAE,OAAO,CAAA;IAChB,8IAA8I;IAC9I,MAAM,EAAE,OAAO,CAAA;IACf;;;;;OAKG;IACH,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAC5C;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAOnF;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAMrG"}

package/dist/dashboard-rpc/projects.js

@@ -0,0 +1,87 @@
+import { contextAddProject, contextProjectErrors, contextProjects, resolveProjectPath } from './context.js';
+import { readProjectCommands } from '../project-commands.js';
+import { originDefaultBranch } from '@openagt/agent-data';
+import { readProjectHooks, runCheckHook, startLineTakesBase } from '../project-hooks.js';
+import { hasRemote } from '../has-remote.js';
+import { currentBranch } from '../dashboard/git-status.js';
+import { pickDirectory } from '../pick-directory.js';
+import { projectGitHost } from '../store/git-host.js';
+// The Projects sidebar behind the new dashboard (#405): the global registry (#390) the
+// daemon and CLI write — id, path, name, activated, last activity. The per-agent
+// foreground dashboard (#427) scopes this to a single project via the request context.
+// The live event stream is its own endpoint rather than a call (`GET /_rpc/events`).
+//
+// Each project also carries what the daemon's background jobs found wrong with it (#1500) —
+// a data branch that cannot reach origin, say (#1599) — and whether its repository has no remote.
+// Both ride this list rather than a read of their own because the list is what every project
+// surface already polls, so an error reaches the sidebar dot and the project's banner with
+// nothing new to subscribe to.
+export async function onProjects() {
+    const state = contextProjectErrors();
+    return (await contextProjects().list()).map(project => {
+        const { errors, localOnly } = state(project.path);
+        return { ...project, ...(errors.length > 0 ? { errors } : {}), ...(localOnly ? { localOnly: true } : {}) };
+    });
+}
+/**
+ * Add a project from the dashboard (#396/#433): install the repo and register it so it joins the
+ * Projects list. Like `sendStart` this needs the daemon (it spawns git + writes the shared
+ * registry), so it calls the daemon's own `addProject` closure off the wired dashboard context.
+ * Returns the daemon's {@link AddProjectResult}.
+ */
+export async function sendAddProject(path) {
+    // Throws on an unwired context (D3), like `sendStart`: a missing capability is a wiring bug.
+    const addProject = contextAddProject();
+    const trimmed = path.trim();
+    if (!trimmed)
+        return { ok: false, error: 'a project path is required' };
+    return addProject(trimmed);
+}
+/**
+ * Open the OS folder picker on the daemon's machine and wait for the user's choice (#1150). The
+ * browser cannot learn an absolute path from any picker of its own, and the daemon — which runs on
+ * the machine the user is sitting at — can, so the dialog is the daemon's. A dismissed dialog
+ * comes back as `path: null`.
+ */
+export async function sendPickProjectDirectory() {
+    return pickDirectory();
+}
+/**
+ * The Onboarding checklist's one server-side fact (#958): the directory this server runs in,
+ * so the first step can offer "Add {cwd} as project" without the user typing a path.
+ */
+export async function onOnboarding() {
+    const cwd = process.cwd();
+    const registered = await contextProjects().list();
+    return { cwd, cwdProjectId: registered.find(p => p.path === cwd)?.id ?? null };
+}
+/**
+ * The project's commands (#1774), read off its skills folders, whether it has a start hook, whether
+ * it has a git host, and the branches an agent can start from. `null` when the project is unknown here.
+ */
+export async function onCommands(projectId) {
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return null;
+    const [commands, hooks, gitHost, remote, main, local] = await Promise.all([readProjectCommands(cwd), readProjectHooks(cwd), projectGitHost(cwd).catch(() => undefined), hasRemote(cwd), originDefaultBranch(cwd), currentBranch(cwd)]);
+    // Both read locally, never fetched. `HEAD` is a folder on no branch: there is no local branch to start from.
+    const startFrom = hooks.start !== undefined && startLineTakesBase(hooks.start) && remote && main !== undefined && local !== undefined && local !== 'HEAD' ? { main: main.slice('origin/'.length), local } : undefined;
+    return { commands, startHook: hooks.start !== undefined, gitHost: gitHost !== undefined, remote, ...(startFrom ? { startFrom } : {}) };
+}
+/**
+ * What would stop a run in this project before it spends a checkout, said in the launcher before
+ * the Start: the project's `check` hook, given the coding agent picked. A missing CLI or a
+ * logged-out one is a problem the run itself would refuse on; a warning is said and blocks nothing.
+ * A check line that fails is said as a warning: it is a broken check, not a reason to stop.
+ * `null` for an unknown project or one without a check hook: nothing to say.
+ */
+export async function onStartCheck(projectId, driver) {
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return null;
+    const checked = await runCheckHook(cwd, driver !== undefined ? { driver } : {});
+    if (checked.ok)
+        return { problems: checked.problems, warnings: checked.warnings };
+    return checked.noHook ? null : { problems: [], warnings: [checked.error] };
+}
+//# sourceMappingURL=projects.js.map

package/dist/dashboard-rpc/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/dashboard-rpc/projects.ts"],"names":[],"mappings":"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"}